Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Skip to content

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

ExportNetworkChain IDUse
BNBBNB Smart Chain56Default wallet execution network with a standalone Keystore
ETHEREUMEthereum1Wallet execution network and L1 Keystore source for cross-chain proofs
CELOCelo42220Wallet execution network with a standalone Keystore
BASEBase8453L2 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:

ContractAddress
KeyStore0x6572427ED530BadcF7375Cf9A4709D8d2b0E7E0a
KeyStoreController0x0834Ee2C9BdC3E3efF0a2dC34393D4B0e546A555

Ethereum: ETHEREUM

  • Chain id: 1
  • Public RPC: https://ethereum-rpc.publicnode.com
  • Explorer: https://etherscan.io
  • Relay: https://relay.altana.network
ContractAddress
KeyStore0xb70fDa90C1d576Ba8399946a0c10ECD9d9Ea923b
KeyStoreController0x30a188Eecf14F4142B0d828ce838C9E1134e7FaA

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:

ContractAddress
KeyStore0x83b30935f36d6ccf9B1ec3b5E47F2866b97cd27c
KeyStoreController0x47bA5fc2A5b0CcB24BA3fAC9D4B59400eE9fd1D6

Fee tokens the relay accepts:

TokenAddress
CELONative token
USDC0xcebA9300f2b948710d2653dD7B07f33A8B32118C
USD₮0x48065fbBE25f71C9282ddf5e1cD6D6A887483D5e
USA₮0xD2ab3C9A02DBBAB236BfEC45D1d755DF4267F771
EURm0xD8763CBa276a3738E6DE85b4b3bF5FDed6D6cA73

ERC-8004 agent identity:

ContractAddress
AgentIdentity registry0x8004A169FB4a3325136EB29fA0ceB6D2e539a432

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.

ContractAddress
KeyStoreCache0x6572427ED530BadcF7375Cf9A4709D8d2b0E7E0a

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.