rpcedge-toolkit

Ship Solana trading bots and agents without wiring endpoints by hand.

Open-source SDK · CLI · MCP for rpc edge - JSON-RPC, priority fees, leader schedule, health probes, and the transaction sender. One env var. Keys never in prompts.

export RPCEDGE_KEY=your-uuid-from-app   # https://app.rpcedge.com/signup
npx rpcedge@latest doctor              # green in under a minute

Why this exists

Most Solana bots start the same way: paste a URL, forget the WebSocket, mis-auth gRPC, send txs to the public RPC, then debug auth at 2am.

This toolkit collapses that path:

rpc edge is co-located Solana infra (RPC, Yellowstone gRPC, sender) for trading bots - self-serve from $249/mo USDC, Frankfurt / FR13. This repo is the open DX layer on top. Measure claims yourself with solbench - we do not invent latency heroes here.

Related MCP server: Solana MCP Demo

Pick your path

1. Human - prove the endpoint (60s)

# Get a key: https://app.rpcedge.com/signup
export RPCEDGE_KEY=your-uuid-key

npx rpcedge@latest doctor
npx rpcedge@latest health --json
npx rpcedge@latest fee          # p50/p75/p90 micro-lamports/CU
npx rpcedge@latest grpc-sample  # time-boxed Yellowstone slot sample

Save the key for later sessions:

npx rpcedge@latest config set-key "$RPCEDGE_KEY"
npx rpcedge@latest whoami

CTA: no account yet? → Sign up · rpc edge dashboard

2. TypeScript bot - first getSlot

pnpm add rpcedge-sdk
# optional: pnpm add @solana/web3.js

import { RpcEdge } from "rpcedge-sdk";

const edge = await RpcEdge.fromEnv(); // RPCEDGE_KEY or config file
console.log(await edge.getSlot());    // commitment: processed by default
console.log((await edge.health()).summary);
console.log((await edge.priorityFees()).summary);

// Ecosystem Connection when you need it
const conn = await edge.connection();
// Yellowstone: edge.grpcHost + edge.grpcMetadata (x-api-key / Bearer)

3. Coding agent - MCP in one line

export RPCEDGE_KEY=your-uuid-key
claude mcp add rpcedge -- npx rpcedge-mcp@latest
# also works with Cursor / Codex / any stdio MCP host

Claude Code plugin (this repo ships .claude-plugin/ + skills/rpcedge):

# from Claude Code: add the marketplace / install the plugin, then set RPCEDGE_KEY
# skill teaches when to call doctor vs fees vs yellowstone_sample vs relay submit

Ask: "Check my RPC health and estimate priority fees."

Signing is always upstream. Submit accepts only fully signed transactions. Keys never appear in tool text.

Machine integration guide: rpcedge.com/skills.md · Agents

Packages

CLI reference

npx rpcedge@latest doctor
npx rpcedge@latest health --json
npx rpcedge@latest slot
npx rpcedge@latest fee
npx rpcedge@latest epoch
npx rpcedge@latest leaders --count 8
npx rpcedge@latest latency                  # this host's getSlot p50 - not landing
npx rpcedge@latest call getEpochInfo '[]'
npx rpcedge@latest send --raw <base64>      # relay by default; --via rpc
npx rpcedge@latest config set-key <uuid>
npx rpcedge@latest whoami
npx rpcedge@latest open signup

Global flags: --json · --key <uuid> · --url <rpcUrl>

Config (highest wins)

1. CLI --key / --url or SDK options

2. SOLANA_RPC_URL / SOLANA_WS_URL (any provider)

3. RPCEDGE_KEY → defaults to https://rpc.rpcedge.com

4. ~/.config/rpcedge/config.json (mode 0600)

5. Public mainnet-beta (demo only - not production)

Optional: RPCEDGE_RELAY_URL, YELLOWSTONE_GRPC_URL / RPCEDGE_GRPC_HOST

When to use rpc edge

Good fit: trading bots, copy-trading, DLMM, market-making, arb/liquidations, on-chain agents that need low-latency Solana RPC/gRPC/sender and self-serve USDC billing.

Not a fit: free hobby / learning only (public RPC is fine), multi-chain one-vendor needs, pure archive dumps.

Pricing: rpcedge.com/pricing · Docs: docs.rpcedge.com · Benchmarks: rpcedge.com/benchmarks

Security

• Never commit API keys or put them in model prompts

• Config file is written mode 0600

• Logs and MCP output redact ?key= and mask key material

• Submit tools are keyless for signing - sign upstream only

• Report security issues privately to the maintainers

Related OSS

Develop

pnpm install && pnpm build && pnpm test
pnpm e2e                    # CLI + SDK + MCP live + publish dry-run
RPCEDGE_KEY=… pnpm e2e      # production endpoint path
pnpm e2e:registry           # npm view + npx smoke

Node ≥ 20 · pnpm 11 · Publish: docs/PUBLISH.md · Listings: docs/DISTRIBUTION.md

License

MIT © 0xNyk · product by Polaris Labs / rpc edge

Next step: get a key → npx rpcedge@latest doctor