带有可运行代码的长格式指南。
八个旗舰指南。每个指南都带您从先决条件到部署,提供TypeScript和Python中的复制粘贴代码,并明确指出常见陷阱。
每个指南都有相同的形状。
我们选择了严格的模板,因为竞争对手教程的不一致形状使其难以使用。每个 Blockchain0x 指南以 60 字的答案段落开始(AI 搜索引擎提取的引用内容),然后是前提条件,接着是带代码的编号步骤,然后是常见陷阱,最后是链接到相关词汇条目和产品页面的后续步骤部分。
每个指南的字数目标是 1800+。这在大多数读者实际浏览的内容中算是较长的,但这是故意的:浅显的教程让您在缺失的细节中进行调试。我们的指南详细说明了边缘案例,以免您自己去处理。
Every guide is code-tested against current Blockchain0x API behavior. When the API ships a breaking change, we update the guides in the same release. Each entry has a "last reviewed" date visible at the top.
选择与今天任务匹配的选项。
如何为您的AI代理添加支付功能
端到端指南。创建钱包、安装 SDK、请求你的第一笔 USDC payment、处理 webhook。适用于 LangChain、CrewAI、AutoGen、LlamaIndex、OpenAI Agents SDK 和 MCP servers。
在 10 分钟内为您的 MCP 服务器创收
将一个免费流量的 MCP server 变成付费服务。使用 requirePayment 构建 x402 challenge,用自己的 paid-state 对 tools 做门控,并验证 webhooks。包含适用于生产环境的 paid-window 模式(Redis 或 Postgres 上的 TTL)。
设置能够抵御提示注入的代理支出控制
按交易限额和按周期额度在仪表盘中设置,并在 API 层强制执行。为什么 API 层强制执行优于代理代码规则。代理触发限额的示例。
获得GitHub和域名验证徽章
逐步了解两种验证流程。GitHub OAuth 配置、DNS TXT record 格式、每月重新检查机制。展示交易对手在你的代理公开页面悬停徽章时会看到什么。
开发人员最常询问的Webhook模式
签名验证(HMAC-SHA256 constant time)、重试下的幂等性、对未到达支付的定时清理、通过 job queue 在支付后恢复。包含 Celery、arq 和 Bull 的模式。
测试代理支付,无需真实货币
使用测试 key 和 Base Sepolia testnet。如何从 faucet 为测试钱包充值、运行完整 payment lifecycle,并在上线前验证 webhook delivery。以及测试与正式环境行为的差异。
从 Stripe 迁移到 Blockchain0x 以获取代理驱动的 API 访问
Run Stripe alongside Blockchain0x: humans pay via Stripe Checkout; agents pay via 402 Payment Required. Includes the x402 adapter that bills agents on priced routes while humans keep their Stripe path.
在上线之前保护您的代理钱包
起飞前安全检查清单。钱包提供方选择(smart wallet vs EOA)、支出权限额度设定、API key 轮换频率、webhook secret 管理、审计复核和事件响应手册配置。
指南每周发布,优先考虑客户在支持中询问的问题。如果您需要的主题缺失,最快的路径是开始使用Blockchain0x并告诉我们您遇到的难题 - 这将成为下一个指南。
哪个指南优先。
- First time using Blockchain0x: "How to add payments to your AI agent" - the end-to-end flow.
- Running an MCP server: "Monetize your MCP server in 10 minutes" - the requirePayment flow.
- About to go to production: "Secure your agent wallet before going live" - the pre-flight checklist.
- Worried about safety: "Set up agent spend controls that survive prompt injection" - API-layer spend permissions.
- Migrating from Stripe: "Migrate from Stripe to Blockchain0x for agent-driven API access" - the dual-checkout pattern.
指南之间慷慨地交叉链接:它们大多数至少引用一个术语表条目(用于词汇)、一个产品页面(用于功能细节)和至少一个其他指南(用于下一个逻辑步骤)。您可以将2-3个指南作为一个连贯的路径阅读,而不是将每个指南视为孤立的。