Networks & Addresses
Altana is multi-chain. The SDK ships a config per network, importable from
@altananetwork/sdk. BNB Smart Chain is the default; Ethereum is
supported for wallet execution and L1 cross-chain proofs; Celo is supported for
wallet execution; Base is supported as the L2 Keystore cache for cross-chain
verification.
Building against testnet? See Testnet for BNB Smart Chain Testnet and Celo Sepolia.
To browse what these contracts have recorded, open the Keystore Explorer: explorer.altana.network for mainnet, testnet.altana.network for testnet.
Supported SDK exports
| Export | Network | Chain ID | Use |
|---|---|---|---|
BNB | BNB Smart Chain | 56 | Default wallet execution network with a standalone Keystore |
ETHEREUM | Ethereum | 1 | Wallet execution network and L1 Keystore source for cross-chain proofs |
CELO | Celo | 42220 | Wallet execution network with a standalone Keystore |
BASE | Base | 8453 | L2 Keystore cache for cross-chain session verification |
BNB Smart Chain: BNB
- Chain id: 56
- Public RPC:
https://bsc-rpc.publicnode.com - Explorer: https://bscscan.com
- Relay:
https://relay.altana.network
KeyStore contracts:
| Contract | Address |
|---|---|
| KeyStore | 0x6572427ED530BadcF7375Cf9A4709D8d2b0E7E0a |
| KeyStoreController | 0x0834Ee2C9BdC3E3efF0a2dC34393D4B0e546A555 |
Ethereum: ETHEREUM
- Chain id: 1
- Public RPC:
https://ethereum-rpc.publicnode.com - Explorer: https://etherscan.io
- Relay:
https://relay.altana.network
| Contract | Address |
|---|---|
| KeyStore | 0xb70fDa90C1d576Ba8399946a0c10ECD9d9Ea923b |
| KeyStoreController | 0x30a188Eecf14F4142B0d828ce838C9E1134e7FaA |
Celo: CELO
Altana on Celo is optimized for stablecoins. The relay on Celo takes its own
fee in CELO or in a stablecoin the wallet holds: USDC, USD₮, USA₮ or EURm,
priced live from Celo's FeeCurrencyDirectory. client.feeCurrencies() returns the current
list and rates.
- Chain id: 42220
- Public RPC:
https://celo-rpc.publicnode.com - Explorer: https://celoscan.io
- Relay:
https://relay.altana.network
KeyStore contracts:
| Contract | Address |
|---|---|
| KeyStore | 0x83b30935f36d6ccf9B1ec3b5E47F2866b97cd27c |
| KeyStoreController | 0x47bA5fc2A5b0CcB24BA3fAC9D4B59400eE9fd1D6 |
Fee tokens the relay accepts:
| Token | Address |
|---|---|
| CELO | Native token |
| USDC | 0xcebA9300f2b948710d2653dD7B07f33A8B32118C |
| USD₮ | 0x48065fbBE25f71C9282ddf5e1cD6D6A887483D5e |
| USA₮ | 0xD2ab3C9A02DBBAB236BfEC45D1d755DF4267F771 |
| EURm | 0xD8763CBa276a3738E6DE85b4b3bF5FDed6D6cA73 |
| Contract | Address |
|---|---|
| AgentIdentity registry | 0x8004A169FB4a3325136EB29fA0ceB6D2e539a432 |
Base: BASE
Used for cross-chain session-key verification when operating on Ethereum. Not used by BNB.
Base is a verification target, not an execution chain. It hosts a KeyStore cache and no relay, so BASE cannot be passed to createClient and you cannot send transactions there through the SDK. Use it with ensureKeyCached to read Ethereum-granted authority from Base.
| Contract | Address |
|---|---|
| KeyStoreCache | 0x6572427ED530BadcF7375Cf9A4709D8d2b0E7E0a |
Chain id 8453 · RPC https://base-rpc.publicnode.com.
Addresses are the source of truth in the SDK's
packages/wallet/src/config.ts. To verify independently, check the addresses above against the explorer-verified sources linked from Audit reports.