Primitive Types

Cambrian provides built-in primitives for booleans, integers, text, bytes, and addresses.

Boolean

Type	Values
`bool`	`true`, `false`

Unsigned integers

Type	Range	Typical use
`u8`	0…255	Flags, small counters
`u16`	0…65 535	Small IDs
`u32`	0…2³²−1	Medium IDs
`u64`	0…2⁶⁴−1	General counters
`u128`	0…2¹²⁸−1	Large counters
`usize`	Platform-sized	Collection indices

On EVM, narrow integers keep their declared Solidity widths (uint8, …) in structs and storage. Widened uint256 results from arithmetic / timestamps / msg::value are narrowed with casts only when the binding requires it.

Signed integers

i8, i16, i32, i64, i128 — available when negative values are needed.

Large integers

Type	Alias	Use
`U256`	`uint256`	Token amounts, balances, wide math

m_balance: U256 {
    in deposit(amount) => m_balance + amount
}

String and bytes

Type	Description
`String`	UTF-8 text
`bytes`	Raw byte sequence (`b"…"` literals)

String↔number conversion is never implicit — use std::str::parse_* / std::str::format (Standard Library).

Address

Type	Description
`address`	Party or entity address

Prefer Address<Entity> when sending named messages — see Generic Types.

`pubkey`

Type	Notes
`pubkey`	Still a language type (EVM storage maps it like a wide integer). It is not part of the everyday EVM message/system context — prefer `address` and `msg::sender` for access control.

Summary

Type	Common use
`bool`	Flags, conditions
`u8`…`u128`, `i8`…`i128`	Counters, IDs, offsets
`U256` / `uint256`	Balances and amounts
`String` / `bytes`	Text and payloads
`address`	Callers and destinations

Keyboard shortcuts

Cambrian Language Documentation