Graveyard Protocol CLI — Graveyard Protocol 命令行界面（CLI）

Graveyard Protocol CLI（gp-cli） gp-cli 是一个用于与 Solana 上的 Graveyard Protocol 交互的开源命令行工具。它扫描您的钱包以查找空的 SPL 代币账户，以批次关闭它们，并将锁定的租赁 SOL 返回到您的钱包。每个关闭的账户都会赚取 Ghost Points，这些点数会累积到每周的 SOUL 代币分配中。 源代码 gp-cli 工具是开源的，其实现可以公开查看。 仓库：https://github.com/graveyardprotocol/gp-cli CLI 在本地构建和签署交易，只提交已签署的交易到 Graveyard Protocol 后端。私钥永远不会通过网络传输。 [!重要] 本技能仅指示代理执行 gp-cli 命令行工具。gp-cli 工具具有 --json 模式，用于所有命令输出，以便于机器阅读。代理可以使用此选项以编程方式解析结果。 安装和设置要求 npm install -g @graveyardprotocol/gp-cli 如果全局安装，代理可以使用较短的 gp 命令： gp add-wallet --keypair-file id.json --name "主钱包" --json 需要 Node.js >= 20。 添加/删除钱包 您可以为租赁回收添加任意数量的钱包。任何钱包密钥对只需注册一次，CLI 将其使用 AES-256-GCM（PBKDF2 密钥派生，100 000 次迭代）加密，并将其存储在 ~/.gp-cli/wallets.json 中。 gp add-wallet --keypair-file ~/.config/solana/id.json --name "主钱包" --json gp list-wallets --json # 显示所有保存的钱包 gp remove-wallet --wallet

--json # 删除钱包 关闭空代币账户 扫描所有或指定钱包的空 SPL 代币账户，并关闭它们，返回锁定的租赁到各自的钱包。 -y 或 --yes 选项提供自动确认关闭空账户的交互式提示。 gp close-empty --wallet --yes --json # 目标特定钱包，跳过确认提示 gp close-empty --all -y --json # 所有保存的钱包，自动确认 gp close-empty --wallet --dry-run --yes --json # 预览 — 无交易发送 流程： 操作员或代理在配置设置期间为租赁回收添加任意数量的钱包。 代理运行 Close-empty 命令。 根据命令选项，后端在链上扫描钱包（或钱包）以查找空的代币账户 CLI 提供扫描摘要，如从后端接收（找到账户，回收 SOL，协议费用，赚取的 Ghost Points），并在未使用 -y 或 --yes 选项时请求确认。 如果确认，CLI 根据账户总数构建事务批次；CLI 在本地签署每个批次，并仅将已签署的字节发送到后端。 后端仅提交已签署的事务批次，并将结果返回给代理 协议经济学每批次： 项目 值 协议费用 回收租赁的 20% 您将获得总锁定 SOL 的 80% Ghost Points 每个关闭的账户 100 点 查看统计数据 显示特定钱包或所有保存的钱包的 Ghost Point 收入、SOL 回收和 SOUL 分配的当前和前一 epoch，以及生命周期总数。 gp stats --wallet --json # 特定钱包（保存或任何地址） gp stats --all --json # 所有保存的钱包的摘要 JSON gp stats --wallet --yes --json # 自动写入 CSV，无需提示 gp stats --wallet --csv-out ~/report.csv --json # 将 CSV 写入路径 统计输出包括： 生命周期：关闭的总账户，回收的总 SOL，索赔的总 SOUL 当前 epoch：关闭的账户，赚取的 SOL，Ghost Points，Ghost 分享 % 前一 epoch：相同的字段，以及 SOUL 分配和索赔状态 epoch 每周从周一 00:00 UTC 开始运行。 索赔 SOUL 代币 在每个周 epoch 结束时，SOUL 代币将根据每个钱包赚取的总 Ghost Point 数的比例进行分配。 使用 gp claim-soul 在链上索赔它们。 gp claim-soul --wallet --json # 特定钱包 gp claim-soul --all --json # 为所有保存的钱包索赔 gp claim-soul --wallet --dry-run --json # 预览金额 — 无事务发送 重要：SOUL 转账完全由项目的社区钱包密钥在 Graveyard Protocol 后端中签署和提交 — 无需本地密钥对签署。 在索赔之前，CLI 显示： epoch 期间 关闭的账户和赚取的 SOL Ghost Point 和 epoch 总数的分享 % 要索赔的 SOUL 金额 代理/CI 使用 将 --all、--wallet、--yes 和 --json 命令选项组合用于完全无人值守的代理/CI 流水线。 # 非交互式添加钱包 gp add-wallet --keypair-file ~/.config/solana/id.json --name "Bot" --json # 关闭空账户 — 自动确认，JSON 输出 gp close-empty --wallet --yes --json # 关闭所有钱包 gp close-empty --all --yes --json # 以 JSON 格式获取统计数据 gp stats --wallet --json gp stats --all --json # 索赔 SOUL（在 JSON 模式下自动确认） gp claim-soul --wallet --json gp claim-soul --all --json