Bundler & Paymaster Infrastructure

The thirdweb SDK handles all the heavy lifting of bundling operations and covering gas fees with a turn-key infrastructure. The thirdweb paymaster and bundler services are stand alone and can be used with any smart account contract without using the thirdweb SDKs.

On testnets, the only requirement is to obtain a free client id to get started. Once you're ready to deploy on mainnets, you will require an active billing account. You can configure your client ID to restrict interactions only with your own contracts or with any contract.

Supported chains

With a thirdweb API key, you get access to bundler and paymaster infrastructure on the following chains:

  • 0G-Newton-Testnet (16600)
  • Abstract Testnet (11124)
  • Aleph Zero EVM (41455)
  • Aleph Zero Testnet (2039)
  • Amoy (80002)
  • Ancient8 (888888888)
  • Ancient8 Testnet (28122024)
  • ApeChain (33139)
  • Arbitrum Nova (42170)
  • Arbitrum One (42161)
  • Arbitrum Sepolia (421614)
  • Arena-Z-Testnet (9897)
  • Avalanche C-Chain (43114)
  • Avalanche Fuji Testnet (43113)
  • B3 (8333)
  • B3 Sepolia Testnet (1993)
  • Base (8453)
  • Base Sepolia Testnet (84532)
  • Blast (81457)
  • Blast Sepolia Testnet (168587773)
  • BNB Smart Chain Mainnet (56)
  • BNB Smart Chain Testnet (97)
  • Camp Network Testnet V2 (325000)
  • Celo Alfajores (44787)
  • Celo Mainnet (42220)
  • Creator Testnet (4654)
  • Curtis (33111)
  • Cyber Mainnet (7560)
  • Cyber Testnet (111557560)
  • Degen Chain (666666666)
  • DFK Chain (53935)
  • DFK Chain Test (335)
  • Donatuz (42026)
  • Donatuz Testnet (42019)
  • Ethereum Mainnet (1)
  • Etherlink Mainnet (42793)
  • Etherlink Testnet (128123)
  • Form Testnet (132902)
  • Fraxtal (252)
  • Fraxtal Testnet (2522)
  • Fuse Mainnet (122)
  • Fuse Sparknet (123)
  • Garnet Holesky (17069)
  • Geist Mainnet (63157)
  • Gemuchain Testnet (1903648807)
  • Gnosis (100)
  • Gnosis Chiado Testnet (10200)
  • GPT Mainnet (1511670449)
  • Hedera Mainnet (295)
  • Hedera Testnet (296)
  • Immutable zkEVM (13371)
  • Immutable zkEVM Testnet (13473)
  • Kaia Mainnet (8217)
  • Kaia Testnet Kairos (1001)
  • Kinto Mainnet (7887)
  • Lens Network Sepolia Testnet (37111)
  • Linea (59144)
  • Linea Sepolia (59141)
  • Lisk Sepolia Testnet (4202)
  • Lumia Prism (994873017)
  • Lumia Testnet (1952959480)
  • Lyra Chain (957)
  • Mantle (5000)
  • Mantle Sepolia Testnet (5003)
  • Metis Andromeda Mainnet (1088)
  • Metis Sepolia Testnet (59902)
  • Mode (34443)
  • Mode Testnet (919)
  • Nautilus Mainnet (22222)
  • onetest-network (10800)
  • OP Mainnet (10)
  • OP Sepolia Testnet (11155420)
  • opBNB Mainnet (204)
  • Ozean (7849306)
  • Pivotal Sepolia (16481)
  • Plume (98865)
  • Plume Testnet (161221135)
  • Polter Testnet (631571)
  • Polygon Mainnet (137)
  • Redstone (690)
  • Rootstock Mainnet (30)
  • Rootstock Testnet (31)
  • Scroll (534352)
  • Scroll Sepolia Testnet (534351)
  • Sepolia (11155111)
  • SKALE Calypso Hub Testnet (974399131)
  • SKALE Europa Hub Testnet (1444673419)
  • SKALE Nebula Hub Testnet (37084624)
  • SKALE Titan Hub Testnet (1020352220)
  • Skopje Testnet (476462898)
  • Soneium Minato (1946)
  • Sophon Testnet (531050104)
  • Superposition (55244)
  • Superposition Testnet (98985)
  • Superseed (5330)
  • Superseed Sepolia Testnet (53302)
  • Taiko Hekla L2 (167009)
  • Treasure Topaz (978658)
  • Unichain Sepolia Testnet (1301)
  • Vanar Mainnet (2040)
  • Vanguard (78600)
  • World Chain (480)
  • World Chain Sepolia (4801)
  • Xai Mainnet (660279)
  • Xai Testnet v2 (37714555429)
  • Xpla Mainnet (37)
  • Xpla Testnet (47)
  • ZERO Testnet (Sepolia) (4457845)
  • zkCandy Sepolia Testnet (302)
  • zkSync Mainnet (324)
  • zkSync Sepolia Testnet (300)
  • Zora (7777777)
  • Zora Sepolia Testnet (999999999)

To support a chain not listed, contact us.

Using a Custom Bundler

Smart accounts are free to use with your own account abstraction infrastructure. To use your own paymaster & bundler, pass the bundlerUrl the SmartWalletOptions overrides:

const config: SmartWalletOptions = {
chain,
sponsorGas: true,
overrides: {
bundlerUrl: "your-bundler-url",
},
};

Using a Custom Paymaster

You can also provide an entirely custom paymaster logic by providing a paymaster function to the SmartWalletOptions overrides.

const config: SmartWalletOptions = {
chain,
sponsorGas: true,
overrides: {
paymaster: async (userOp: UserOperation) => {
// your custom paymaster logic
return myPaymasterResultLogic(userOp);
},
},
};

Pricing & Billing

To use thirdweb's account abstraction infrastructure, you need to set up a billing account on the thirdweb dashboard Settings page.

Pricing:

  • Bundler: Transaction bundle calls (non-sponsored calls) are free to use.
  • Paymaster: 10% premium on top of network fee based on your usage.

Find more information on the different billing tiers by visiting thirdweb's pricing page.