Debugging Guide

Troubleshooting Flow

Transaction sending failed?
├─ Yes → Check error code → Refer to Common Errors
└─ No (returned txid)
    ↓
Transaction confirmed on chain? (Check Solscan)
├─ No → Blockhash might be expired, retry
└─ Yes
    ↓
Found in Dashboard?
├─ No → Tip instruction might be incorrect, check checklist below
└─ Yes → Acceleration successful, check business logic

Tip Instruction Checklist

• Amount meets requirement? — Minimum 300,000 lamports (0.0003 SOL)
• Target address correct? — 7HkiWXe5deJvzn4D6kgMUFCADwX9Z4DMrdjNSSxN6bPp
• Using SystemProgram.transfer? — Tip must be standard SOL transfer instruction
• Tip instruction in transaction? — Confirm transaction.add() includes tip instruction
• Signature includes tip? — Tip instruction must be added before signing

Quick Test with curl

# 1. Check endpoint reachability
curl -v 'http://booster-sg.zan.top/node/v1/solana/mainnet/<YOUR_API_KEY>/tips' \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"getHealth"}'

# 2. Send test transaction
curl -X POST 'http://booster-sg.zan.top/node/v1/solana/mainnet/<YOUR_API_KEY>/tips' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "sendTransaction",
    "params": ["<YOUR_BASE64_TX>", {"encoding": "base64", "skipPreflight": true}]
  }'

Logging Recommendations

Add these key logging points to your integration code:

// 1. Log tip amount and target
console.log(`Tip: ${tipLamports} lamports → ${TIP_ACCOUNT.toBase58()}`);

// 2. Log endpoint used
console.log(`Endpoint: ${endpoint}`);

// 3. Log sending result
console.log(`TX sent: ${txid}`);

// 4. Log confirmation result
console.log(`Confirmed: ${!confirmation.value.err}`);

Common Pitfalls

Need Help?