Hướng dẫn dài với mã hoạt động.
Tám hướng dẫn chính. Mỗi hướng dẫn dẫn bạn từ các yêu cầu trước đến triển khai, với mã sao chép và dán trong TypeScript và Python và những cạm bẫy phổ biến được chỉ ra rõ ràng.
Mỗi hướng dẫn đều có cùng một hình dạng.
Chúng tôi đã chọn một mẫu nghiêm ngặt vì hình dạng không đồng nhất của các hướng dẫn đối thủ là điều làm cho chúng khó sử dụng. Mỗi hướng dẫn Blockchain0x bắt đầu với một đoạn văn trả lời 60 từ (những gì các công cụ tìm kiếm AI trích xuất để trích dẫn), sau đó là các yêu cầu tiên quyết, sau đó là các bước được đánh số với mã, sau đó là những cạm bẫy phổ biến, và sau đó là một phần các bước tiếp theo liên kết đến các mục từ điển liên quan và trang sản phẩm.
Mục tiêu số từ cho mỗi hướng dẫn là 1800+. Điều này nằm ở phần dài của những gì hầu hết người đọc thực sự lướt qua, nhưng điều đó là có chủ đích: các hướng dẫn nông khiến bạn phải gỡ lỗi qua các chi tiết thiếu sót. Các hướng dẫn của chúng tôi chỉ ra các trường hợp đặc biệt để bạn không phải làm điều đó.
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.
Chọn cái phù hợp với nhiệm vụ hôm nay.
Cách thêm thanh toán vào đại lý AI của bạn
Hướng dẫn end-to-end. Tạo ví của bạn, cài SDK, yêu cầu khoản thanh toán USDC đầu tiên, xử lý webhook. Hoạt động với LangChain, CrewAI, AutoGen, LlamaIndex, OpenAI Agents SDK, MCP servers.
Kiếm tiền từ máy chủ MCP của bạn trong 10 phút
Biến một MCP server có lưu lượng miễn phí thành dịch vụ trả phí. Dùng requirePayment để tạo x402 challenge, chặn tool của bạn bằng paid-state riêng, xác minh webhook. Bao gồm mẫu paid-window (TTL trên Redis hoặc Postgres) cho production.
Thiết lập các kiểm soát chi tiêu của agent mà vẫn tồn tại sau khi bị tiêm nhắc
Giới hạn theo từng giao dịch và hạn mức theo từng kỳ, được thiết lập trong dashboard và thực thi ở lớp API. Vì sao thực thi ở lớp API tốt hơn các quy tắc trong code của agent. Ví dụ minh họa agent chạm ngưỡng giới hạn.
Kiếm huy hiệu xác minh GitHub và miền
Đi qua cả hai luồng xác minh. Thiết lập GitHub OAuth, định dạng bản ghi DNS TXT, hành vi kiểm tra lại hàng tháng. Cho thấy đối tác nhìn thấy gì khi rê chuột lên huy hiệu trên trang công khai của agent bạn.
Các mẫu webhook mà các nhà phát triển thường hỏi nhất
Xác minh chữ ký (HMAC-SHA256 constant time), tính idempotent khi retry, tác vụ quét theo lịch cho các khoản thanh toán không bao giờ đến, tiếp tục sau thanh toán qua hàng đợi job. Bao gồm các mẫu cho Celery, arq và Bull.
Thử nghiệm thanh toán đại lý mà không cần tiền thật
Sử dụng test key và Base Sepolia testnet. Cách nạp tiền cho ví thử từ faucet, chạy toàn bộ vòng đời thanh toán và xác thực việc nhận webhook trước khi lên production. Kèm theo các khác biệt giữa hành vi thử nghiệm và thực tế.
Chuyển từ Stripe sang Blockchain0x để truy cập API do tác nhân điều khiển
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.
Bảo mật ví agent của bạn trước khi ra mắt
Danh sách kiểm tra bảo mật trước khi triển khai. Lựa chọn nhà cung cấp ví (smart wallet vs EOA), xác định phạm vi quyền chi tiêu, tần suất xoay vòng API key, quản lý bí mật webhook, rà soát audit và thiết lập runbook ứng phó sự cố.
Các hướng dẫn được xuất bản hàng tuần, ưu tiên theo những gì khách hàng hỏi trong hỗ trợ. Nếu một chủ đề bạn cần bị thiếu, con đường nhanh nhất là bắt đầu sử dụng Blockchain0x và cho chúng tôi biết điều gì đã làm bạn bối rối - điều đó sẽ trở thành hướng dẫn tiếp theo.
Hướng dẫn nào trước.
- 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.
Các hướng dẫn liên kết chéo một cách hào phóng: hầu hết chúng tham chiếu ít nhất một mục từ điển (cho từ vựng), một trang sản phẩm (cho chi tiết tính năng), và ít nhất một hướng dẫn khác (cho bước tiếp theo hợp lý). Bạn có thể đọc qua 2-3 hướng dẫn như một con đường đồng nhất thay vì coi mỗi cái là riêng biệt.
Từ vựng trước, sau đó là hướng dẫn, rồi đến so sánh.
Nếu một thuật ngữ trong hướng dẫn không quen thuộc, từ điển định nghĩa nó một cách chính xác. Nếu bạn đang chọn Blockchain0x so với các lựa chọn thay thế, các so sánh sẽ đi qua các đánh đổi một cách trung thực.