Solana RpcX

A Cloudflare worker that extends Solana RPC with account parsing capabilities through rpcX methods. It enables automatic parsing for any accounts with an on-chain IDL (accounts that Solana Explorer can parse).

Available Methods

• getParsedAccountData - Parse a single account
• getParsedAccountsData - Parse multiple accounts in batch
• subscribeParsedAccount - Subscribe to parsed account updates

Development

Start local development server:

wrangler dev

Deploy

Deploy to Cloudflare to parse on the edge:

wrangler deploy

Set the RPC_ENDPOINT environment variable to the URL of the base rpc endpoint.

Usage Examples

1. Fetch a Single Parsed Account

curl "https://rpcx.magicblock.app" \
	-X POST \
	-H "Content-Type: application/json" \
	-d '{"jsonrpc":"2.0","id":1,"method":"getParsedAccountData","params":["FPxc7bcafdCQqHS8S1KX4ENCPP3vncxsKK3yRZ3mMzGn", {"encoding": "base64"}]}'

Example response:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "context": {
      "slot": 322677507,
      "apiVersion": "2.1.9"
    },
    "value": {
      "lamports": 6876480,
      "data": {
        "text": "You are an AI agent ..."
      },
      "owner": "LLMrieZMpbJFwN52WgmBNMxYojrpRVYXdC1RCweEbab",
      "executable": false,
      "rentEpoch": 18446744073709552000,
      "space": 860
    }
  }
}

2. Fetch Multiple Parsed Accounts

curl -s "https://rpcx.magicblock.app" \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":"0","method":"getParsedAccountsData","params":{"pubkeys":["GFg67j2Yq7wcW8ikRgtiRpVCEmYUw9BjteRehjNwnQrt","FPxc7bcafdCQqHS8S1KX4ENCPP3vncxsKK3yRZ3mMzGn"]}}' | jq .

3. Use Custom RPC Endpoint

Add the Rpc header to specify a custom RPC endpoint:

curl -s "https://rpcx.magicblock.app" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Rpc: https://api.mainnet-beta.solana.com/" \
  -d '{"jsonrpc":"2.0","id":1,"method":"getParsedAccountData","params":["FPxc7bcafdCQqHS8S1KX4ENCPP3vncxsKK3yRZ3mMzGn"]}' | jq .

4. Subscribe to Parsed Account Updates

Connect:

wscat -c "wss://rpcx.magicblock.app"

Subscribe to updates:

{"jsonrpc":"2.0","id":1,"method":"subscribeParsedAccount","params":["5RgeA5P8bRaynJovch3zQURfJxXL3QK2JYg1YamSvyLb",{"encoding":"jsonParsed","commitment":"confirmed"}]}