Supported Networks

The SDK ships with a built-in map of EVM chain IDs to display names. When you pass a chainId, the widget shows the corresponding name in its approval screens.

Built-in chains

Chain	Chain ID
Ethereum	1
Goerli (testnet)	5
Optimism	10
BNB Chain	56
Gnosis	100
Polygon	137
Fantom	250
zkSync Era	324
Metis	1088
Moonbeam	1284
Base	8453
Arbitrum One	42161
Arbitrum Nova	42170
Avalanche	43114
Linea	59144
Scroll	534352
Sepolia (testnet)	11155111
Mumbai (testnet)	80001
Base Goerli (testnet)	84531
Arbitrum Goerli (testnet)	421613

Using a chain ID

const auth = new OxGasAuth({
  apiKey:  'your-api-key',
  chainId: 8453,            // → widget shows "Base"
});

For OxGasClient, the same chainId also selects the chain the smart account will be created on, and is included in the bundler/paymaster URLs you pass separately.

Custom or unsupported chains

If your chain isn’t in the list, pass a display name directly via network:

const auth = new OxGasAuth({
  apiKey:  'your-api-key',
  network: 'Blast',         // shown as-is in the widget
});

network takes precedence over chainId. If you pass both, network wins for display purposes — but chainId still drives the on-chain signing payload.

For chains not in the built-in registry, the widget falls back to Chain {id} (e.g. Chain 80094) if you supply only chainId. Pass network explicitly to give it a real name.

Accessing the map directly

import { NETWORK_NAMES } from '@0xgasless/core';

const name = NETWORK_NAMES[42161];   // "Arbitrum One"
const name = NETWORK_NAMES[99999];   // undefined

Useful when you want to mirror the SDK’s name lookup in your own UI.

SDK version

import { VERSION } from '@0xgasless/core';

console.log('Using @0xgasless/core', VERSION);

Handy for bug reports and analytics. The constant tracks the current package version.