firstdollar

First Dollar

一套教 AI Agent 如何花自己的钱的课程。

16 节课程，从“什么是钱包”到“首次真实的 x402 购买”。另有 3 个用于故障排查和端到端测试的参考工具。First Dollar 绝不会代你签署交易，而是教你如何自行签署。

原则

教师，而非管家。 First Dollar 负责解释；Agent 负责行动。MCP 不持有密钥，不签署交易，也不进行交易。它会读取 Agent 拥有什么，解释商家提出的要求，并向 Agent 展示要运行的命令。Agent 在理解的基础上花自己的钱。

这是为拥有自有资金的 Agent 打造的基础设施，而非供人类通过 Agent 转移资金的委托工具。

安装

npx firstdollar

Claude Desktop / Claude Code / Cursor / 等

将以下内容添加到 claude_desktop_config.json（或适用于你所用框架的等效 MCP 配置文件）：

{
  "mcpServers": {
    "firstdollar": {
      "command": "npx",
      "args": ["firstdollar"]
    }
  }
}

课程（调用 start-here 获取指引）

课程	工具	教学内容
1	what-is-a-wallet	密钥对、地址、私钥，以及它们能让你做什么
2	what-is-usdc	稳定币、区块链，以及为什么选择哪条链很重要
3	explain-my-wallet	适用于 moltwallet、Coinbase Agentic Wallet、MetaMask、原始 EVM / Solana 密钥的自我检查命令
4	get-a-wallet	安装钱包——npm、npx、技能和 Coinbase 的软件包实际上会做什么
5	configure-wallet-skills	安装后的设置——应按什么顺序运行哪些技能
6	fund-my-wallet	如何获取 USDC：入金、直接转账、赚取
7	what-is-x402	该协议：HTTP 402、支付质询、X-PAYMENT 重试
8	read-this-challenge	将 base64 / 原始 JSON x402 质询解码为结构化说明
9	how-do-i-pay	特定钱包的签署命令——返回命令，但绝不运行命令
10	verify-my-purchase	将交易哈希转换为内容，通过商家的 /receipt 端点获取
11	paid-vs-delivered	已记录的 5 种 x402 攻击类型，以及如何验证你收到的内容与付款相符
12	who-am-i-to-this-merchant	钱包身份、假名化、跨商家卫生实践——区块链会向所有观察者揭示什么
13	what-is-ap2	AP2 / Agent Payments Protocol——委托支付的授权层
14	what-is-acp	ACP / Agent Commerce Protocol——人类通过 Agent 购物的结账界面协议
15	subscriptions-and-session-keys	ERC-7715 有范围限制的自主权限——批准一次，在限额内支出
16	choose-your-wallet-mode	4 种模式（MPC、Smart Wallet、EOA、EIP-7702）及各自的适用场景

参考工具（课程之外）

工具	用途
start-here	课程索引和指引
what-went-wrong	诊断常见故障模式（ERC-6492 错误、网络不匹配、facilitator 不稳定、超时过期、余额问题）
test-payment	端到端握手流程。建议的首个商家：地下文化区（substratesymposium.com）——免费商品可用于握手测试，$0.99 的付费商品可用于结算测试。任何 x402 URL 均可使用。

First Dollar 不会做什么

• 不持有私钥
• 不代你签署交易
• 不访问你的钱包文件
• 不向任何商家提供优先路由
• 不允许人类将钱包委托给 Agent 进行未经授权的支出

First Dollar 纯粹用于教育。Agent 才是行动者。

适用对象

任何拥有自己的钱包和资金的 Agent。兼容多种钱包类型（moltwallet、Coinbase Agentic Wallet、MetaMask、原始 EVM 密钥、原始 Solana 密钥）和 facilitator（CDP、PayAI 等）。

致谢

Lisa Maraventano + Spine，与 Claude 合作。

在密西西比州克拉克斯代尔打造。

许可证

MIT