작동하는 코드가 포함된 장문 가이드.
여덟 개의 플래그십 가이드. 각 가이드는 필수 조건에서 배포까지 안내하며, 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 에이전트에 결제를 추가하는 방법
end-to-end 가이드입니다. 지갑을 만들고, SDK를 설치하고, 첫 USDC 결제를 요청하고, webhook을 처리하세요. LangChain, CrewAI, AutoGen, LlamaIndex, OpenAI Agents SDK, MCP servers와 함께 작동합니다.
10분 안에 MCP 서버 수익화
무료 트래픽 MCP server를 유료 서비스로 전환하세요. requirePayment를 사용해 x402 challenge를 만들고, 자체 paid-state로 tools를 게이트하고, webhook을 검증하세요. 프로덕션용 paid-window 패턴(Redis 또는 Postgres의 TTL)을 포함합니다.
프롬프트 주입을 견디는 에이전트 지출 제어 설정
대시보드에서 설정하고 API 레이어에서 강제되는 거래별 한도와 기간별 허용액. API 레이어 강제가 에이전트 코드 규칙보다 우수한 이유. 에이전트가 한도에 도달하는 실제 예시.
GitHub 및 도메인 검증 배지를 획득하세요
두 가지 verification 흐름을 모두 살펴봅니다. GitHub OAuth 설정, DNS TXT record 형식, 월간 재검증 동작을 다룹니다. 상대방이 에이전트의 공개 페이지에서 배지에 마우스를 올렸을 때 무엇을 보는지도 보여줍니다.
개발자들이 가장 많이 묻는 웹훅 패턴
서명 검증(HMAC-SHA256 상수 시간), 재시도 시 idempotency, 도착하지 않은 결제에 대한 예약 sweep, job queue를 통한 결제 후 재개. Celery, arq, Bull 패턴을 포함합니다.
실제 돈 없이 에이전트 결제 테스트하기
test key와 Base Sepolia testnet을 사용합니다. faucet에서 test wallet에 자금을 넣는 방법, 전체 payment lifecycle을 실행하는 방법, 프로덕션 전 webhook 전달을 검증하는 방법을 다룹니다. 또한 test와 live 동작의 차이도 설명합니다.
에이전트 주도의 API 접근을 위해 Stripe에서 Blockchain0x로 마이그레이션
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 키 교체 주기, webhook secret 관리, 감사 검토, 사고 대응 runbook 설정.
가이드는 매주 게시되며, 고객이 지원에서 질문하는 내용을 우선적으로 다룹니다. 필요한 주제가 누락된 경우, 가장 빠른 경로는 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개의 가이드를 일관된 경로로 읽을 수 있습니다.