Tools & Integrations

Extend the protocol beyond the browser. Power-user tools, agent integrations, and CI-ready automation for every wallet you manage.

SDK / TypeScript Client

Coming Soon

A typed Node.js client for integrating Graveyard Protocol into your own apps and bots.

Browser Extension

Coming Soon

One-click wallet cleanup directly from your browser toolbar — no dApp tab required.

gp-cli

v1.2.2

A 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.

bash
npm install -g @graveyardprotocol/gp-cli

Or run directly from the repo:

bash
git clone https://github.com/GraveyardProtocol/gp-cli
cd gp-cli
npm install
npm link

Quick Start

Add a wallet, scan for empty accounts, and close them in three commands.

bash
# 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> --yes

Command 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.

json
// 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.

bash
# 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> --json

AI Agent note: gp-cli ships with a Claude Code / OpenClaw skill manifest at skills/gp-cli-skill/SKILL.md. Install via:

bash
npx skills add graveyardprotocol/gp-cli

Security 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.

Ready to automate your cleanup?

Install gp-cli and start reclaiming SOL from your command line in minutes.