OpenParable
Skip to content
← Back to skills

Aa Bundler

Development
aa-bundler

Aa Bundler is an Agent Skill for development published in the Nethereum/Nethereum repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Help users run an ERC-4337 bundler using Nethereum — set up in-process or standalone bundlers with mempool, validation, reputation, and JSON-RPC server. Use when the user mentions running a bundler, ERC-4337 bundler setup, BundlerService, BundlerConfig, bundler RPC server, mempool configuration, UserOperation validation, or bundler presets (AppChain, Standard, Production) in .NET/C#.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/Nethereum/Nethereum/blob/HEAD/plugins/nethereum-skills/skills/aa-bundler/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/aa-bundler, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Run an ERC-4337 Bundler

Nethereum includes a full ERC-4337 bundler — collects UserOperations, validates them, manages a mempool with reputation tracking, and submits bundles to the EntryPoint.

When to Use This

  • User wants to run their own bundler instead of using a third-party service
  • User is building an application chain that needs an integrated bundler
  • User needs to configure bundler settings (validation, mempool, reputation)
  • User wants a JSON-RPC endpoint for the bundler

Packages

dotnet add package Nethereum.AccountAbstraction.Bundler
dotnet add package Nethereum.AccountAbstraction.Bundler.RpcServer  # for JSON-RPC endpoint

Quick Start

using Nethereum.AccountAbstraction.Bundler;
using Nethereum.Web3;
using Nethereum.Web3.Accounts;

var web3 = new Web3(new Account(privateKey), "http://localhost:8545");

var config = BundlerConfig.CreateAppChainConfig(
    entryPoint: EntryPointAddresses.Latest,
    beneficiary: "0xBeneficiaryAddress");

var bundlerService = new BundlerService(web3, config);

// Submit a UserOperation
string userOpHash = await bundlerService.SendUserOperationAsync(
    packedUserOp, EntryPointAddresses.Latest);

// Trigger immediate bundling
BundleResult result = await bundlerService.ExecuteBundleAsync();

// Check receipt
var receipt = await bundlerService.GetUserOperationReceiptAsync(userOpHash);

Configuration Presets

PresetUse CaseStrictValidationERC-7562AutoBundle
CreateAppChainConfigPrivate chainsfalsefalse1s
CreateStandardConfigPublic testnetstruetrue10s
CreateProductionConfigMainnettruetrue10s + staking
var appConfig = BundlerConfig.CreateAppChainConfig(entryPoint, beneficiary);
var stdConfig = BundlerConfig.CreateStandardConfig(entryPoint, beneficiary);
var prodConfig = BundlerConfig.CreateProductionConfig(entryPoint, beneficiary);

Key Config Properties

PropertyDefaultDescription
MaxBundleSize10Max UserOperations per bundle
MaxMempoolSize1000Max UserOperations in mempool
AutoBundleIntervalMs10000Bundle interval (0 = manual)
StrictValidationtrueEnforce ERC-4337 rules
EnableERC7562ValidationfalseTrace-based opcode validation
UnsafeModefalseSkip all validation (testing only)
MinStake1 ETHMin stake for reputation
WhitelistedAddressesemptyExempt from reputation checks
BlacklistedAddressesemptyPermanently rejected

JSON-RPC Server

using Nethereum.AccountAbstraction.Bundler.RpcServer;

var rpcServer = new RpcServer();
rpcServer.AddBundlerHandlers(bundlerService);

// Or create bundler from config:
rpcServer.AddBundlerHandlers(web3, config);

Standard RPC Methods

MethodDescription
eth_sendUserOperationSubmit UserOperation
eth_estimateUserOperationGasEstimate gas
eth_getUserOperationByHashLook up by hash
eth_getUserOperationReceiptGet receipt
eth_supportedEntryPointsList EntryPoints
eth_chainIdReturn chain ID

Debug Methods

MethodDescription
debug_bundler_sendBundleNowForce immediate bundle
debug_bundler_dumpMempoolDump mempool contents
debug_bundler_dumpReputationDump reputation scores
debug_bundler_setReputationSet reputation manually

Reputation and Staking

var config = BundlerConfig.CreateProductionConfig(entryPoint, beneficiary);
config.WhitelistedAddresses.Add("0xYourPaymaster");  // trust your paymaster
config.BlacklistedAddresses.Add("0xBadFactory");      // block bad actors

Common Mistakes

  • No beneficiary — required, receives bundler fees
  • Wrong EntryPoint — bundler only accepts ops targeting SupportedEntryPoints
  • AutoBundle=0 without manual bundling — ops pile up, never submitted
  • UnsafeMode in production — skips all validation, wastes gas on bad ops

For full documentation, see: https://docs.nethereum.com/docs/account-abstraction/guide-run-bundler