rpc_modules - Berachain RPC Method
Inspect which JSON-RPC namespaces are enabled on your Berachain endpoint. Useful for capability checks, client diagnostics, and RPC feature discovery.
Returns the enabled JSON-RPC namespaces exposed by the connected Berachain 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 Berachain? Build on the Proof-of-Liquidity L1 with $3.2B+ TVL and innovative three-token economics with Proof-of-Liquidity consensus, three-token model (BERA/BGT/HONEY), $142M funding, and unified validator-DeFi incentive alignment.
When to Use This Method
rpc_modules is useful for DeFi protocol developers, liquidity providers, and teams building yield-optimized applications:
- 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
Request Parameters
This method accepts no parameters.
Response Body
Object whose keys are enabled namespaces and whose values are version strings
Error Responses
Code Examples
curl -X POST https://api-berachain-mainnet.n.dwellir.com/YOUR_API_KEY \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"method": "rpc_modules",
"params": [],
"id": 1
}'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 Berachain. Useful for client compatibility checks and identifying version-gated features.
txpool_status
Inspect pending and queued transaction counts in the Berachain transaction pool. Useful for mempool monitoring, congestion analysis, and node health checks.