기술 문서
개발 문서
x402 프로토콜을 프로젝트에 통합하기 위한 가이드와 레퍼런스입니다.
시작하기
빠른 시작
코드
코드 예제
서버 (Express)
import { paymentMiddleware } from "@x402/express";
// 경로별 결제 요구사항 정의
app.use(paymentMiddleware({
"GET /api/premium": {
price: "$0.01",
network: "base-sepolia",
payTo: "0x...",
description: "Premium API endpoint"
}
}));클라이언트
import { x402Client, wrapFetchWithPayment } from "@x402/fetch";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
// 클라이언트 설정 및 EVM 체인 등록
const client = new x402Client();
registerExactEvmScheme(client, { signer: evmWallet });
// fetch를 결제 기능으로 감싸기
const payFetch = wrapFetchWithPayment(fetch, client);
await payFetch("/api/premium");V2
SDK 패키지
코어 패키지
@x402/core@x402/evm@x402/svm@x402/paywallEVM 체인, Solana, 세션 기반 접근 지원
프레임워크 통합
@x402/express@x402/next@x402/hono@x402/fetch · @x402/axiosExpress, Next.js, Hono 미들웨어 및 클라이언트 래퍼
외부 리소스
자주 묻는 오해
"x402는 암호화폐 토큰이다"
x402는 오픈 프로토콜입니다. 자체 토큰 없이 USDC 같은 기존 스테이블코인을 결제 수단으로 사용합니다.
"복잡한 블록체인 인프라가 필요하다"
x402는 HTTP 미들웨어로 작동합니다. 퍼실리테이터가 블록체인 복잡성을 처리하므로 개발자는 npm 패키지 설치만으로 시작할 수 있습니다.
"모든 결제마다 온체인 트랜잭션이 발생한다"
x402는 메타 트랜잭션을 사용합니다. 클라이언트는 서명만 전달하고, 실제 온체인 정산은 퍼실리테이터가 배치 처리할 수 있습니다.
가격 정책 안내
사람: 모든 문서는 사람에게 무료입니다. 브라우저에서 JavaScript 검증을 통해 사람임을 확인합니다.
AI 에이전트: Claude, GPT, Cursor 등 AI 도구가 문서에 접근하면 402 Payment Required 응답을 받고 소액의 USDC를 결제해야 콘텐츠에 접근할 수 있습니다.