Skip to main content

Chain and Address Presets

Supported chain IDs​

  • BNB: 56
  • BNB Testnet: 97
  • Ethereum: 1
  • Ethereum Sepolia: 11155111
  • Avalanche: 43114
  • Avalanche Fuji: 43113
  • Base: 8453
  • Base Sepolia: 84532
  • Arbitrum One: 42161
  • Arbitrum Sepolia: 421614
  • Optimism: 10
  • Optimism Sepolia: 11155420
  • Monad Testnet: 10143

Built-in preset: bnbpay-testnets​

What this does: preloads known-good testnet network defaults, including BNB testnet contracts.

BNB testnet defaults:

  • router: 0xf14f56A54E0540768b7bC9877BDa7a3FB9e66E91
  • registry: 0xeF00A0C85F8D36A9E68B1b1808ef4286F0f836Cd
  • sessionStore: 0x4396ace32183FDd7812e62978a8FA0F7Ae11B775
  • permit2: 0x31c2F6fcFf4F8759b3Bd5Bf0e1084A055615c768

Expected result: testnet SDK initialization works with minimal configuration.

Override strategy​

You can override any preset value:

const sdk = createClient({
  mode: 'hybrid',
  preset: 'bnbpay-testnets',
  api: { baseUrl: 'https://api.bnbpay.org' },
  contracts: {
    defaultNetwork: 'eip155:97',
    networks: {
      'eip155:97': {
        rpc: {
          http: ['https://your-dedicated-bnb-testnet-rpc'],
          quality: 'recommended-production',
        },
        contracts: {
          router: '0xYourRouter',
          registry: '0xYourRegistry',
          sessionStore: '0xYourSessionStore',
          subscriptions: '0xYourSubscriptions',
        },
      },
    },
  },
});

Common errors and fixes​

  • Using bnb vs bnbTestnet incorrectly: verify chain target before execution.
  • Stale contract addresses: rotate addresses in config when deployments change.