▾ Documentation

Get started with Sender

Send your first transaction through Supanode Sender in 5 minutes: pick a regional endpoint, attach a tip, and submit via JSON-RPC.

// updated 2026-06-04

From zero to first landed transaction in 5 minutes.

NOTE

No API token, no IP allowlist. Sender is open access - the tip in your transaction is your authorization. Tip and Bundle subscription are independent: Sender doesn't share auth with RPC / gRPC / WebSocket.

What you'll need

  • A funded Solana wallet with enough SOL to cover the tip - minimum 1,000,000 lamports (0.001 SOL) per transaction. See Tips.
  • A signed transaction, base64-encoded.
  • An HTTP client - curl works, any language with HTTP support works.

Send your first transaction

  1. 1
    Pick the closest endpoint

    Connect to the region nearest your servers for lowest latency.

    For most workloads in EU: http://fra.landing.fast (Frankfurt).

    See Endpoints for Amsterdam and Tokyo.

  2. 2
    Construct your transaction with a tip

    Every transaction sent through Sender must include a System Program transfer to one of Supanode's tip accounts. Without a tip, the transaction is rejected at the gateway.

    Minimum tip is 1,000,000 lamports (0.001 SOL). See Tips for tip addresses and code samples.

Submit

Pick the submission method matching your latency requirement.

MethodLatencyBest for
JSON-RPCLowDrop-in replacement for existing RPC clients
HTTP PlaintextLowerQuick scripts, prototyping
HTTP BinaryLowestMicrosecond-critical workloads

Quick test using JSON-RPC:

curl -sS 'http://fra.landing.fast' \
  -H 'Content-Type: application/json' \
  --data '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "sendTransaction",
    "params": [
      "YOUR_BASE64_ENCODED_TX",
      {
        "encoding": "base64",
        "skipPreflight": true
      }
    ]
  }'

For Plaintext and Binary methods, see Submission methods.

Verify landing

WARNING

A 200 response means forwarded, not landed on-chain. Always verify with RPC getSignatureStatuses.

curl http://fra.supanode.xyz:8899 \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getSignatureStatuses",
    "params": [["YOUR_SIGNATURE"]]
  }'

Check that confirmationStatus is confirmed or finalized.

Best practices

TIP
  • Simulate before sending. Sender never runs preflight. Run simulateTransaction against RPC first.
  • Single endpoint per app instance. Pick the region closest to your servers, stick with it.
  • Track landing rate. Compare submitted transactions vs confirmed signatures.
  • Exponential backoff on 429 / 500. Start at 1 second, cap at 30.

Response codes

CodeMeaning
200Transaction accepted and forwarded
429Rate limited - back off and retry
500Server error - retry with backoff

Where to next

Submission methods

JSON-RPC, Plaintext, Binary.

Tips

Minimum tip and tip addresses.

Endpoints

Regional endpoints.

Sender overview

What it is and how it works.