ERPC

x402로 RPC 요청마다 결제하기

x402.erpc.global은 16개 체인의 RPC를 요청 단위로 판매합니다. 요청을 보내고, 응답이 알려 주는 가격을 USDC 또는 EURC로 결제하면 결과를 받습니다. ERPC 계정, RPC 키, 요금제는 필요 없습니다.
유료 요청 보내기 요금 계산 방식 보기
bash
curl -i https://x402.erpc.global/v1/solana-mainnet \
  --header 'Content-Type: application/json' \
  --data '{"jsonrpc":"2.0","id":1,"method":"getSlot"}'

x402로 할 수 있는 일

  • 하나의 호스트에서 16개 체인을 각 체인의 경로로 호출하세요.
  • 모든 체인의 요금을 내 지갑의 같은 스테이블코인으로 결제하세요. Solana의 USDC, 또는 Base의 USDC나 EURC를 쓸 수 있습니다. 네트워크 수수료용 SOL이나 ETH는 필요 없습니다.
  • 결제하기 전에 가격을 확인하세요. 402 응답에 가격이 들어 있고, /pricing에서 경로별 메서드 가격을 무료로 볼 수 있습니다.
  • x402.erpc.global이 거부한 요청에는 요금을 내지 않습니다. x402.erpc.global은 결제를 요청하기 전에 메서드, 본문, 배치 크기를 확인합니다.
  • 정산 영수증을 보관하세요. 유료 응답에는 모두 X-Payment-Response 헤더에 영수증이 들어 있습니다.

유료 요청이 처리되는 방식

  1. 평소처럼 RPC 요청을 보냅니다. x402.erpc.global은 402 Payment Required와 함께 가격과 결제 옵션을 반환합니다.
  2. x402 클라이언트(402 응답을 지갑에서 서명한 결제로 바꿔 주는 소프트웨어)가 그 가격만큼의 결제에 서명합니다. Solana에서는 USDC 전송, Base에서는 USDC 또는 EURC 전송 승인입니다.
  3. 서명한 결제를 X-Payment 헤더에 넣어 같은 요청을 다시 보냅니다.
  4. 결제가 검증되고 정산되면 x402.erpc.global이 요청을 체인으로 전달하고, X-Payment-Response 헤더에 영수증을 담아 응답을 반환합니다.
어떤 체인을 호출하든 결제는 Solana 또는 Base에서 정산됩니다.

체인과 경로

모든 경로는 https://x402.erpc.global에서 HTTP POST를 받습니다. JSON-RPC 경로는 단일 호출이나 최대 100개 호출의 배치를 받습니다.
체인경로요청
Solana/v1/solana-mainnetJSON-RPC
Ethereum/v1/eth-mainnetJSON-RPC
Avalanche/v1/ava-mainnetJSON-RPC(배치에는 C-Chain 호출만 포함), 그리고 /v1/ava-mainnet/ext/…의 AvalancheGo API
Arbitrum/v1/arbitrum-mainnetJSON-RPC
Base/v1/base-mainnetJSON-RPC
Bitcoin/v1/bitcoin-mainnetJSON-RPC
Hyperliquid/v1/hyperliquid-mainnetJSON-RPC(/v1/hyperliquid-mainnet/evm과 …/nanoreth에서도 가능)
Kaia/v1/kaia-mainnetJSON-RPC
Monad/v1/monad-mainnetJSON-RPC
NEAR/v1/near-mainnetJSON-RPC
Optimism/v1/optimism-mainnetJSON-RPC
Polygon/v1/polygon-mainnetJSON-RPC
Robinhood Chain/v1/robinhood-mainnetJSON-RPC
Soneium/v1/soneium-mainnetJSON-RPC
Sui/v1/sui-mainnet/sui.rpc.v2.<Service>/<Method>unary gRPC-web 호출, 요청당 하나
TRON/v1/tron-mainnetJSON-RPC(/jsonrpc에서도 가능), 그리고 /wallet/<method>와 /walletsolidity/<method>의 HTTP API, 요청당 호출 하나
eth_subscribe 같은 WebSocket 구독은 판매하지 않습니다.

결제 옵션

스테이블코인네트워크컨트랙트 또는 민트 주소
USDCSolanaEPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
USDCBase0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
EURCBase0x60a3E35Cc302bFA44Cb288Bc5a4F316Fdb1adb42
각 402 응답에는 howToPay 블록도 들어 있습니다. 그 요청에 쓸 수 있는 스테이블코인과 컨트랙트 주소가 적혀 있어, 에이전트는 응답만 읽고 결제할 수 있습니다.

무료 엔드포인트

엔드포인트반환 내용
GET /pricing모든 경로의 메서드별 가격
GET /.well-known/x402x402 클라이언트용 경로와 결제 옵션
GET /doc모든 경로의 OpenAPI 문서
GET /scalar같은 문서를 브라우저에서 둘러볼 수 있게 한 참조

사용 범위

이 페이지의 유료 endpoint는 x402를 통해 ERPC RPC usage fees를 결제하기 위한 것입니다. 가상자산 거래, 중개, 수탁(커스터디), 지갑 서비스는 제공하지 않습니다.
이전Unlimited / Avalanche / Unlimited다음빠른 시작