一次性学习 XRP Ledger。无需账户，无需真实货币，只需您和账本。

大多数区块链教程都是讲解概念。XRPL Camp 让你_实际操作_——创建一个钱包，为其充值，向公共账本写入永久备忘录，独立验证，然后带着一份任何人都可以对照账本进行验证的记录离开。整个过程大约需要十分钟。

专为研讨会、课堂和自学而设计。引导流程会从你上次停止的地方继续，如果某个环节失败，它会停止运行，而不是假装一切正常，并且不会声称发生了实际上没有发生的事情。

为什么选择这个，而不是通用的教程？

• 真实的交易，而不是幻灯片。 你将写入实际的账本。当第五课说“自己验证”时，它会给你一个哈希值和一个浏览器链接，任何人都可以进行验证。
• 你的付款会创建一个账户。 第四课不是一个简单的转账——它会为之前不存在的第二个账户充值，并且该账户的密钥也是你的。
• 失败也是课程的一部分。 xrpl-camp try 会故意在实时网络上破坏某些功能，然后向你展示哪些失败会导致损失，哪些是免费的——在你按下发送按钮之前。
• 你可以实际验证的证据。 证据包会列出真实的交易，并且 proof verify --online 会询问账本这些交易是否真的发生。没有人可以伪造这一部分。
• 从设计上来说是安全的。 仅限测试网。测试 XRP 没有价值。你的密钥永远不会离开你的设备。没有遥测数据，没有分析数据，没有账户。

安装

不需要 Python（下载预编译的二进制文件）：

npx @mcptoolshop/xrpl-camp start

使用 Python：

pipx install xrpl-camp

在 Docker 中——用于研讨会，其中安装东西是最困难的部分：

docker run --rm -it -v "$PWD:/work" ghcr.io/mcp-tool-shop-org/xrpl-camp start

挂载一个卷。你创建的所有内容——钱包、证书、证据包——都会被写入 /work，并且未挂载的容器会在退出时删除这些内容。该镜像会告诉你是否忘记了挂载。

快速开始

xrpl-camp start

六个课程，按顺序进行，如果重新启动，会从上次停止的地方继续：

1. 思维模型——XRPL 是什么，通过询问实时网络而不是断言来解释。
2. 创建钱包——生成一个测试网密钥对；密钥保存在你的设备上。
3. 充值钱包——从测试水龙头获取免费的测试 XRP，以及为什么其中一部分不能被使用。
4. 发送付款——将你的备忘录写入账本，以创建一个账户的付款。
5. 验证交易——查找你写入的内容，并将其与你输入的内容进行比较。
6. 证书——你保存的记录，可以用来证明。

命令

| 命令 | 作用 | |---------|-------------| | xrpl-camp start | 引导完成所有 6 个课程（自动恢复） | | xrpl-camp start --memo "..." | 预先提供第四课的消息，用于脚本化或非交互式运行 | | xrpl-camp read | 你的输入，从账本上读取——而不是从这台机器上读取 | | xrpl-camp read <address> | 其他人写入的内容。无需密钥、无需登录、无需权限 | | xrpl-camp read <hash> | 一笔完整的交易 | | xrpl-camp try | 故意在实时网络上破坏某些功能。不签名，不产生任何费用 | | xrpl-camp status | 进度检查表，带有时间戳 | | xrpl-camp status --detail | 指导者视图：钱包、端点、状态目录、下一步 | | xrpl-camp wallet create / show | 创建或显示你的测试网钱包 | | xrpl-camp fund | 通过测试网水龙头为你的钱包充值 | | xrpl-camp send --memo "hello" | 向你的邮箱发送备忘录付款 | | xrpl-camp verify --tx <hash> | 验证你发送的交易 | | xrpl-camp certificate | 生成证书 + 证据包 | | xrpl-camp proof verify <file> | 检查证据包的哈希值。完全离线 | | xrpl-camp proof verify <file> --online | 同时询问账本这些交易是否真的发生 | | xrpl-camp proof verify <folder> | 验证文件夹中的每个包——供指导者使用 | | xrpl-camp reset | 清除所有状态（需要输入 RESET） | | xrpl-camp self-check | 诊断你的环境以及你与账本的连接 | | xrpl-camp support-bundle | 为错误报告编写诊断压缩包 |

全局标志：--version、--dry-run、--yes（非交互式）、--verbose（有关错误的详细技术信息）。

你最终会得到什么

• 一个已充值的测试网钱包，本地存储并被 git 忽略
• 一个在你付款之前不存在的第二个账户——并且该账户的密钥也是你的
• 你选择的备忘录，永久记录且可以独立读取
• 一个证书（xrpl_camp_certificate.json）——可以安全地共享，不包含私钥
• 一个证据包（xrpl_camp_proof_pack.json）——列出真实的交易，任何人都可以验证

关于证据

证据包包含一个 SHA-256 哈希值。该哈希值可以检测到意外的编辑。它不是一个签名，并且本身并不能证明该包是真实的——任何人都可以更改一个字段，并使用此工具使用的相同的公共函数重新计算哈希值。

无法伪造的是账本：

xrpl-camp proof verify xrpl_camp_proof_pack.json --online

它会解析包中列出的每一笔交易，并检查该交易是否存在、是否由包的地址发送、是否包含包声明的备忘录，以及是否成功完成。一个包含已重写的地址的包，可以通过离线哈希检查，但会失败此检查。

有两个细节值得了解，因为两者都很容易出错：

• 验证始终查询公共测试网（或 --rpc-url），从不查询包中命名的端点。伪造的包可以命名一个由其作者控制的服务器。
• XRPL 测试网会定期重置。当发生这种情况时，真实的交易将停止解析。该包会记录每笔交易的账本索引，因此重置会报告为无法验证（退出代码 3），而不是作为欺诈（退出代码 1）。

离线验证仍然是默认设置，并且不会进行任何网络调用，因此即使在飞机上或锁定的课堂机器上，它仍然有效。

试运行模式

xrpl-camp start --dry-run

没有网络调用，没有磁盘写入，也没有误导性的输出——第六课明确拒绝生成工件。试运行可以读取现有的状态，但绝不会更改任何内容。

端点和状态

export XRPL_CAMP_RPC_URL="https://your-node:51234/"

该工具在签名之前会拒绝任何无法确认是测试网的端点。只有在您了解要指向的目标时，才设置 XRPL_CAMP_ALLOW_ANY_NETWORK=1。

默认情况下，状态存储在 ./.xrpl-camp 中——一个会话属于您运行它的文件夹。XRPL_CAMP_HOME 会覆盖此设置，而 xrpl-camp status --detail 会打印解析后的绝对路径。

安全性

您的种子密钥存储在 .xrpl-camp/wallet.json 中的本地文件（仅限 POSIX 系统上的所有者），并且绝不会包含在证书或证明包中——生成过程会拒绝写入包含种子密钥的任何文件。

此工具默认使用 XRPL 测试网，在该测试网中，测试用的 XRP 没有实际价值，并且除非您明确选择退出，否则会拒绝非测试网端点。没有遥测数据，没有分析数据，没有“回家”功能。

请参阅 SECURITY.md。

威胁模型

| 威胁 | 缓解措施 | |--------|-----------| | 种子密钥泄露到文件中 | Generation runs a seed check built on xrpl-py's own decode_seed and refuses to write the file if it trips | | 种子密钥提交到 Git | .xrpl-camp/ 在此仓库中被 Git 忽略；状态写入您的工作目录，因此请将其添加到您自己的 .gitignore 中。 | | 其他用户可以读取种子密钥 | 钱包文件权限设置为 0600，状态目录权限设置为 0700（仅限 POSIX 系统）。 | | 学习者将密钥粘贴到公共备忘录中 | 在提交之前，备忘录文本会扫描是否存在类似种子密钥的字符串，如果存在则拒绝。 | | 在主网上重复使用测试网种子密钥 | 在创建钱包时发出警告；该工具默认拒绝非测试网端点。 | | 篡改证明包 | SHA-256 可以检测到简单的编辑；--online 通过向账本询问来检测重新密封的伪造。 | | 针对攻击者的端点进行验证 | --online 绝不会使用正在测试的包中指定的端点。 | | 诊断信息泄露您的身份 | support-bundle 会隐藏主目录和帐户名称。 |

用于研讨会和课堂

• 每个学习者使用一个命令。 npx、pipx 或容器——没有共享设置。
• 失败是免费的。 xrpl-camp try 可以在不花费任何成本的情况下教授失败模式，因此，故意破坏某些内容的学习者比不破坏任何内容的人学得更多。
• 指导者进行分类。 status --detail 显示钱包、端点和状态目录。self-check 探测实际连接，而不是报告一个乐观的“OK”。
• 一次性验证整个房间。 proof verify <folder> --online 检查每个学习者的包是否与账本一致。
• 速率限制是真实的。 三十个人同时访问一个水龙头，将会达到限制；该工具会进行重试，并会告知您，而不是责怪您的 Wi-Fi。

开发

git clone https://github.com/mcp-tool-shop-org/xrpl-camp.git
cd xrpl-camp
uv sync --dev
bash scripts/verify.sh     # lint + tests + build + smoke

许可证

MIT

由 MCP Tool Shop 构建