Skip to main content

Running Transeptor

Features​

  • Metrics - Transeptor bundler can be configured to store metrics using a push(InfluxDB) and pull(Prometheus) metrics system. Grafana is used to visualize all the metrics. Use --metrics flag to enable.
  • Entity Reputation System - When staked(i.e., with an entrypoint contract), an entity can also use its own associated storage and senders' associated storage as ETH. Transeptor can be pre-configured to blacklist(computing) and whitelist(computing) entities on startup.
  • Geth ERC-7562 Tracer - Supports native tracer to enforce ERC-7562: Account Abstraction Validation Scope Rules. accountabstraction/geth-with-erc7562-tracer node.
  • Entrypoint contract - Supports Entrypoint contract releases/v0.8.
  • EIP-7702 authorizations - On networks with EIP-7702 enabled, the eth_sendUserOperation method accepts an extra eip7702Auth parameter. Transeptor include all UserOperations that require eip7702Auth in a bundle to the authorizationList and execute the bundle using a transaction type 4.
  • p2p mempool - Coming soon.

To run Transeptor with ERC-7562: Account Abstraction Validation Rules, a fully synced geth node node must be running alongside the bundler. Both options require the node to be enabled with debug_traceCall.

Modes​

It is recommended not to run Transeptor with --unsafe in production. This flag is disabled by default and is only intended for experimental and development purposes. Running Transeptor with --unsafe will disable all storage access rules, opcode banning, and code rule validation.

FeatureBase Mode (ERC-7562 tracer)Searcher Mode (ERC-7562 tracer)
Mempool SupportPrivate mempoolPrivate mempool
EVM NetworksEthereum and SepoliaEthereum and Sepolia
Bundle Sending StrategyUses eth_sendRawTransaction RPCUses Flashbots eth_sendPrivateTransaction
Ethereum Network Provideraccountabstraction/geth-with-erc7562-traceraccountabstraction/geth-with-erc7562-tracer
Ethereum Network Provider RequirementsMust support debug_traceCall with 'erc7562Tracer' tracerMust support debug_traceCall with 'erc7562Tracer' tracer
EIP-7702 supportyesyes

Command line arguments​

List of all command line arguments supported by the Transeptor.

docker run -p 4337:4337 --env-file .env transeptorlabs/bundler:latest --help
Options:
  -V, --version                  output the version number
  --unsafe                       UNSAFE mode: Enable no storage or opcode checks during userOp simulation. SAFE mode(default).
  --eip7702Support               On networks with EIP-7702 enabled, the eth_sendUserOperation
                                 method accepts an extra eip7702Auth parameter. (default:
                                 true)
  --network <string>             Ethereum network provider. (default: "http://localhost:8545")
  --httpApi <string>             ERC4337 rpc method namespaces to enable. (default: "web3,eth")
  --port <number>                Bundler node listening port. (default: "4337")
  --numberOfSigners <number>     Number of signers HD paths to use from mnemonic (default: "3")
  --minBalance <string>          Minimum ETH balance needed for signer address. (default: "1")
  --mistake <string>            Minimum stake an entity has to have to pass the reputation system. (default: "1")
  --minUnstakeDelay <number>     Time paymaster has to wait to unlock the stake(seconds). (default: "0")
  --bundleSize <number>          Maximum number of pending mempool entities to start auto bundler. (default: "10")
  --maxBundleGas <number>        Max gas the bundler will use in transactions. (default: "5000000")
  --auto                         Automatic bundling. (default: false)
  --autoBundleInterval <number>  Auto bundler interval in (ms). (default: "12000")
  --txMode <string>              Bundler transaction mode (base, searcher).
 (base mode): Sends bundles using eth_sendRawTransaction RPC(does not protect against front running).
 (searcher mode): Sends bundles  using Flashbots Auction to protect the transaction against front running (only available on Mainnet) (default: "base")
  --metrics                      Bundler node metrics tracking enabled. (default: false)
  --influxdbUrl <string>         Url influxdb is running on (requires --metrics to be enabled). (default: "http://localhost:8086")
  --influxdbOrg <string>         Influxdb org (requires --metrics to be enabled). (default: "transeptor-labs")
  --influxdbBucket <string>      Influxdb bucket (requires --metrics to be enabled). (default: "transeptor_metrics")
  --p2p                          p2p mode enabled (default: false)
  --findPeers                    Search for peers when p2p is enabled. (default: false)
  -h, --help                     display help for command

Environment variables​

List of all environment variables supported by the node.

# Required for production
TRANSEPTOR_ENTRYPOINT_ADDRESS=0x
TRANSEPTOR_BENEFICIARY=<address_to_receive_funds>
TRANSEPTOR_MNEMONIC=<your-mnemonic>

# Optional
TRANSEPTOR_INFLUX_TOKEN=DEV_TOKEN
TRANSEPTOR_WHITE_LIST=<address_to_whitelist_SEPARATED_BY_COMMA>
TRANSEPTOR_BLACK_LIST=<address_to_blacklist_SEPARATED_BY_COMMA>

Legacy Entrypoint support​

⚠️ If you are using an older version of EntryPoint, please refer to the links below. We only provide support for the most recent release of our software. We strongly recommend updating your smart contract to use Entrypoint releases/v0.8. For more information, see our Security Policy.

Legacy Transeptor releases: