rpc_modules - Mantle RPC Method
Inspect which JSON-RPC namespaces are enabled on your Mantle endpoint. Useful for capability checks, client diagnostics, and RPC feature discovery.
Mantle RPC endpoint: endpoint URLs, plans and pricing.
Returns the enabled JSON-RPC namespaces exposed by the connected Mantle endpoint together with their version strings.
Non-standard method.
rpc_modulesis a client-introspection RPC that is commonly available on Geth-compatible stacks, but it is not part of the core Ethereum Execution API method set. Availability varies by client and operator policy.
Why Mantle? Build on the world's largest ZK rollup by TVL with $2.5B+ secured and deep Bybit integration with near-instant ZK finality via OP Succinct, $6.2B treasury backing, mETH liquid staking, and 25% Bybit trading fee discounts.
When to Use This Method
rpc_modules is useful for DeFi developers, liquid staking builders, and teams seeking institutional exchange integration:
- Capability Discovery - Detect whether namespaces like
debug,trace,txpool, orerigonare exposed before attempting those calls - Client Diagnostics - Verify what the serving node has enabled when debugging environment-specific issues
- Infrastructure Audits - Compare public and private endpoints to confirm which RPC surfaces are intentionally exposed
- Runtime Feature Gating - Adjust tooling behavior dynamically based on the actual namespaces available on a node
Best Practices
- Call at startup to determine which features are available on a node
- Module availability varies by node client and provider configuration
- Use to gate feature access in applications before attempting unsupported calls
- This is a non-standard method; some endpoints may not expose it
{
"jsonrpc": "2.0",
"method": "rpc_modules",
"params": [],
"id": 1
}Code Examples
Error Handling
| Error Code | Message | Description |
|---|---|---|
| -32601 | Method not found | The client or endpoint does not expose rpc_modules |
| -32603 | Internal error | The node rejected or failed to process the request |
Related Methods
web3_clientVersion- Inspect the client software version stringdebug_traceTransaction- Debug namespace exampletrace_transaction- Trace namespace example
eth_protocolVersion
Get the current Ethereum protocol version on Mantle. Useful for client compatibility checks and identifying version-gated features.
txpool_status
Inspect pending and queued transaction counts in the Mantle transaction pool. Useful for mempool monitoring, congestion analysis, and node health checks.