BeraChain Validator Tools & Infrastructure Documentation

Learn how to interact with berachain nodes using different endpoint types.

#Available Endpoints

#🔑 Common Response Codes

#⚡ JSON-RPC Examples

#Check Node Sync Status

curl -X POST \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: your-api-key-uuid" \
  --data '{"jsonrpc":"2.0","method":"eth_syncing","params":[],"id":1}' \
  True
Copy

Expected response when node is synced:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": false
}
Copy

#Wagmi Configuration

import { http, fallback } from 'wagmi'
import { defineChain } from 'viem'

// Define your chain if not using a predefined one
const myChain = defineChain({
  id: 1,
  name: '{{ network_name }}', // Check WAGMI database if this network exists
  network: 'berachain',
  nativeCurrency: {
    decimals: 18,
    name: 'Native Token',
    symbol: 'TOKEN',
  },
  rpcUrls: {
    default: { http: ['True'] },
  },
})

// Configure transport with API key
const transport = fallback([
  http('True', {
    fetchOptions: { 
      headers: {
        'Content-Type': 'application/json',
        'X-Api-Key': 'your-api-key-uuid'
      }
    },
  }),
  // Add fallback RPC endpoints if available
  http('https://alternate-rpc-endpoint'),
])

// Use in your Wagmi config
const config = {
  chains: [myChain],
  transports: {
    [myChain.id]: transport,
  },
}
Copy