5분 가이드
빠른 시작 가이드
x402를 프로젝트에 통합하여 AI 에이전트로부터 수익을 창출하세요.
참고: 이 가이드의 코드는 개념적 구현 예시입니다. 실제 프로젝트에서는 공식 SDK를 사용하세요.
사전 준비
- 1
문서 사이트
Next.js, Docusaurus, 또는 유사한 프레임워크로 만든 사이트
- 2
암호화폐 지갑 주소
USDC를 받을 Base 네트워크 지갑 (MetaMask, Coinbase Wallet 등)
- 3
Node.js 18+
최신 LTS 버전 권장
Step 1
패키지 설치
npm install x402-nextStep 2
설정 파일 생성
프로젝트 루트에 x402.config.ts 생성:
// x402.config.ts
// x402 설정 파일 - 가격과 결제 정책을 정의합니다.
export const x402Config = {
// 결제를 받을 지갑 주소 (Base 네트워크)
wallet: "0xYourWalletAddress",
// 사람(브라우저)은 무료 접근
humanAccess: "free",
// AI 에이전트 가격 (경로별 USDC)
aiPricing: {
"/docs/**": 0.01, // 일반 문서: $0.01
"/api-reference/**": 0.02, // API 레퍼런스: $0.02
},
};Step 3
미들웨어 추가
Next.js의 경우 middleware.ts 생성:
// middleware.ts
import { x402Middleware } from "x402-next";
import { x402Config } from "./x402.config";
// 미들웨어가 요청을 분석하여:
// - 브라우저(사람) → 무료 통과
// - AI 에이전트 → 402 응답 반환
export const middleware = x402Middleware(x402Config);
export const config = {
matcher: ["/docs/:path*"],
};Step 4
배포
vercel deploy설정 완료!
이제 문서 사이트에 x402가 적용되었습니다. 접근 방식에 따라 다르게 동작합니다:
사람 (브라우저)
JavaScript 검증 통과 → 무료 접근
AI 에이전트
402 응답 → USDC 결제 → 콘텐츠 접근