SDK / TypeScript Client
Coming SoonA typed Node.js client for integrating Graveyard Protocol into your own apps and bots.
Browser Extension
Coming SoonOne-click wallet cleanup directly from your browser toolbar — no dApp tab required.
gp-cli
v1.2.2A Node.js command-line tool for humans and AI agents to close empty Solana SPL token accounts, reclaim locked SOL rent, earn Ghost Points, and claim SOUL rewards — all without touching a browser.
Multi-wallet Management
Add and manage multiple Solana wallets locally. Private Keys are encrypted using AES-256-GCM with PBKDF2 key derivation (SHA-256, 100,000 iterations).
Batch Account Closure
Scans for empty SPL token accounts, builds optimised instruction batches, signs locally, and relay to RPC via the protocol backend.
Epoch & Lifetime Stats
Track SOL reclaimed, Ghost Points and SOUL allocated for the current and previous epochs. Export CSV reports instantly.
One-command SOUL Claim
Claim your weekly SOUL allocation without any local signing — the protocol Community Wallet handles the on-chain transfer.
Non-custodial & Secure
Private keys never leave your machine and are never logged. The CLI only hands signed transactions to the backend API.
Agent / CI Ready
Every command supports --json and --yes flags for fully non-interactive, machine-readable pipelines and AI agent workflows.
Installation
Install globally via npm. Requires Node.js ≥ 20.
npm install -g @graveyardprotocol/gp-cliOr run directly from the repo:
git clone https://github.com/GraveyardProtocol/gp-cli
cd gp-cli
npm install
npm linkQuick Start
Add a wallet, scan for empty accounts, and close them in three commands.
# 1. Initialize gp-cli configuration (Run-Once)
gp init
# 2. Add a wallet
gp add-wallet --keypair-file <filePath> --name "My Wallet"
# 3. Preview how much SOL you'll reclaim (dry run)
gp close-empty --wallet <your-address> --dry-run --yes
# 4. Close the accounts and reclaim SOL
gp close-empty --wallet <your-address> --yesCommand Reference
Machine-readable Output (--json)
Every command emits structured JSON when the --json flag is set — perfect for CI pipelines, AI agents, and custom dashboards.
// gp close-empty --wallet <addr> --yes --json
{
"success": true,
"wallet": "4xG7...Rk9m",
"dryRun": false,
"totalBatches": 2,
"transactionsSucceeded": 2,
"transactionsFailed": 0,
"accountsClosed": 38,
"solReclaimed": 0.077520,
"results": [
{
"intentID": "intent_abc123",
"txSignature": "5Gf8...Mw2k",
"batchAccountsClosed": 20,
"batchRentSol": 0.040800,
"success": true
},
{
"intentID": "intent_def456",
"txSignature": "3Hj9...Kx5p",
"batchAccountsClosed": 18,
"batchRentSol": 0.036720,
"success": true
}
]
}Agent / CI Pipeline
Use --wallet, --all, --yes and --json command options for fully non-interactive automation.
# Full end-to-end automated pipeline
# Step 1 — Add wallet (once, for every new wallet)
gp add-wallet --keypair-file <filePath> \
--name "Bot Wallet" --json
# Step 2 — Daily / scheduled: close and reclaim
gp close-empty --all --yes --json
# Step 3 — Check current epoch stats
gp stats --wallet <address> --json
# Step 4 — Claim SOUL at epoch end (auto-confirms in JSON mode)
gp claim-soul --wallet <address> --jsonAI Agent note: gp-cli ships with a Claude Code / OpenClaw skill manifest at skills/gp-cli-skill/SKILL.md. Install via:
npx skills add graveyardprotocol/gp-cliSecurity Model
Wallet Private keys are stored locally in ~/.gp-cli/wallets.json. Keys are encrypted using AES-256-GCM with PBKDF2 key derivation (SHA-256, 100,000 iterations). The CLI signs transactions locally and never broadcasts to Solana directly — only signed bytes are sent to the Graveyard Protocol backend. For SOUL claims, the Community Wallet signs the transfer, so your keypair is not required at claim time.