Enable Bundler on your Chain

Installing the Conduit Bundler

General Information

Bundler URL & Supported RPC Methods

Once deployed, your bundler URL will be available at https://bundler-{YOUR_NETWORK_SLUG}.t.conduit.xyz/<APIKEY>. APIKEY might be not present or required depending on the configuration.

Our bundler supports all eth-namespaced RPC methods as specified in ERC-4337 including:

• eth_chainId
• eth_supportedEntryPoints
• eth_estimateUserOperationGas
• eth_sendUserOperation
• eth_getUserOperationByHash
• eth_getUserOperationReceipt

Contracts

Entrypoint

Conduit Bundler supports the following ERC-4337 EntryPoint versions:

EntryPoint 0.6.0 is not supported.

Safe Integration

The following two modules are compatible with Entrypoint 0.9.0 and are deployed with the Conduit bundler integration.

For turning your Safe wallet into a 4337-compatible smart account, see the Safe documentation on ERC-4337.

Other Contracts

EntryPoint Version Notes

If your stack previously used EntryPoint v0.7, newer versions introduce several improvements.

v0.8 Improvements

• UserOperation hashing uses EIP-712 typed data
• Native EIP-7702 authorizations support is added to the Entrypoint contract
• Improved unused gas penalty behavior
• senderCreator() helper for factory validation

v0.9 Improvements

• Parallelizable paymaster signatures via paymasterSignature
• Block-range validity windows using validAfter / validUntil (block ranges are signaled via a top-bit flag)
• Improved diagnostics via:
  • getCurrentUserOpHash()
  • IgnoredInitCode
  • EIP7702AccountInitialized

Important behavioral changes

Developers migrating from older versions should be aware of the following:

• UserOperation signing changed in v0.8 (EIP-712 typed data)
• Accounts must be created through UserOperation initCode. SimpleAccountFactory.createAccount() can’t be used directly and can only be called by SenderCreator
• Paymaster signature handling changed in v0.9 (paymasterSignature flow); malformed paymasterData / signature conventions may be rejected

Even though v0.9 maintains ABI compatibility, bundlers and mempools must understand the updated semantics for UserOperations to be accepted.

Sending UserOperations

Use this three-step flow to handle dynamic preVerificationGas (PVG) networks and reliably submit UserOperations.

$
curl -s -X POST -H "Content-Type: application/json" \
>
  --data '{
>
    "jsonrpc": "2.0",
>
    "id": 1,
>
    "method": "eth_estimateUserOperationGas",
>
    "params": [
>
      {
>
        "sender": "0x29657e08ba8c384c6e634149db8fb4e64ce29225",
>
        "nonce": "0x845adb2c711129d4f3966735ed98a9f09fc4ce5700000000000000000000",
>
        "callData": "0xe9ae5c53...",
>
        "callGasLimit": "0x238c",
>
        "verificationGasLimit": "0x462d8",
>
        "preVerificationGas": "0x0",
>
        "maxPriorityFeePerGas": "0xf4240",
>
        "maxFeePerGas": "0x1250f8",
>
        "factory": "0x2577507b78c2008ff367261cb6285d44ba5ef2e9",
>
        "factoryData": "0xea6d13ac...",
>
        "paymaster": "0xcb3871f1f320cd057a4170be2c15fee812919939",
>
        "paymasterVerificationGasLimit": "0x5033",
>
        "paymasterPostOpGasLimit": "0x0",
>
        "paymasterData": "0x00000000...",
>
        "signature": "0xc5c3ba33..."
>
      },
>
      "0x0000000071727De22E5E9d8BAf0edAc6f37da032"
>
    ]
>
  }' \
>
  "$RPC_URL"

1
{
2
  "jsonrpc": "2.0",
3
  "id": 1,
4
  "result": {
5
    "preVerificationGas": "0xd8f0",
6
    "verificationGasLimit": "0x...",
7
    "callGasLimit": "0x...",
8
    "paymasterVerificationGasLimit": "0x..."
9
  }
10
}

$
curl -s -X POST -H "Content-Type: application/json" \
>
  --data '{
>
    "jsonrpc": "2.0",
>
    "id": 1,
>
    "method": "eth_sendUserOperation",
>
    "params": [
>
      {
>
        "sender": "0x29657e08ba8c384c6e634149db8fb4e64ce29225",
>
        "nonce": "0x845adb2c711129d4f3966735ed98a9f09fc4ce5700000000000000000000",
>
        "callData": "0xe9ae5c53...",
>
        "callGasLimit": "0x238c",
>
        "verificationGasLimit": "0x462d8",
>
        "preVerificationGas": "0x101d0", // your updated pre verification with buffer
>
        "maxPriorityFeePerGas": "0xf4240",
>
        "maxFeePerGas": "0x1250f8",
>
        "factory": "0x2577507b78c2008ff367261cb6285d44ba5ef2e9",
>
        "factoryData": "0xea6d13ac...",
>
        "paymaster": "0xcb3871f1f320cd057a4170be2c15fee812919939",
>
        "paymasterVerificationGasLimit": "0x5033",
>
        "paymasterPostOpGasLimit": "0x0",
>
        "paymasterData": "0x00000000...",
>
        "signature": "0xc5c3ba33..."
>
      },
>
      "0x0000000071727De22E5E9d8BAf0edAc6f37da032"
>
    ]
>
  }' \
>
  "$RPC_URL"

Repository

You can find the Conduit Bundler repository here. This repository includes scripts to create a SimpleAccount, fund it, and send a test transaction.