@acedatacloud/x402-client는 402 Payment Required를 만났을 때 PAYMENT-SIGNATURE 요청 헤더에 서명하는 역할을 담당합니다.
소스 코드 및 패키지 주소:
- SDK 저장소: https://github.com/AceDataCloud/SDK
- X402 Client 저장소: https://github.com/AceDataCloud/X402Client
- npm SDK: https://www.npmjs.com/package/@acedatacloud/sdk
- npm X402 Client: https://www.npmjs.com/package/@acedatacloud/x402-client
의존성 설치
@solana/web3.js가 필요합니다:
@acedatacloud/sdk와@acedatacloud/x402-client는 모두 npm에서 설치하고 Node.js로 가져올 수 있습니다.ethers는 EVM typed data 서명에 사용되며,@solana/web3.js는 Solana transaction 구성에 사용됩니다.
Base 예시
브라우저에서는window.ethereum을 직접 사용할 수 있습니다. Node.js에서는 ethers.Wallet로 EIP-1193 스타일 provider를 한 겹 감쌀 수 있습니다.
브라우저 지갑 예시
프런트엔드 애플리케이션에서 MetaMask, Coinbase Wallet 또는 WalletConnect를 사용할 때는 일반적으로 EIP-1193 provider를 직접 전달합니다:Solana 예시
Solana는 SPL USDCTransferChecked를 사용합니다. 전달되는 wallet adapter는 publicKey와 signAndSendTransaction을 노출해야 합니다.
exact만 지원하고 upto는 지원하지 않습니다. API가 여러 accepts를 반환하면 handler는 network = 'solana'인 항목을 선택합니다.
Solana 경로는 동일한 공개 API에서 유료 재시도가 HTTP 200 및 ADC_SOLANA_E2E_OK를 반환할 수 있음이 검증되었습니다. 공개 RPC 조회는 속도 제한이 있을 수 있으므로, 이 문서에는 Solana tx hash를 작성하지 않습니다. 온체인 대사가 필요한 경우 자체 Solana RPC 또는 콘솔 기록 확인을 사용하십시오.
exact 또는 upto 선택
현재 TypeScript handler는 서버가 반환한 첫 번째 일치 네트워크의 payment requirement를 선택합니다. Ace Data Cloud의 API는 일반적으로 동일한 네트워크의 exact를 upto 앞에 배치하므로, 후불 계량을 명확히 사용하려면 preferScheme: 'upto'를 전달해야 합니다.
예시:
upto requirement를 반환하지 않으면 handler는 자동으로 해당 네트워크에서 사용 가능한 첫 번째 requirement로 폴백하며, 일반적으로 exact입니다.
upto는 Permit2를 한 번에 승인해야 합니다. upto는 현재 Base에서만 제공되므로, Base USDC에 대해 한 번만 승인하면 됩니다:
upto는 공개 API 검증을 완료했습니다: HTTP 402 -> HTTP 200, 후불 settlement tx는 0x4b0b836ce1cd1171cdbc37df1637150b024214ec28e7f6f2d09122f15cbfc036입니다. 전체 출력은 과금 방식 설명을 참조하십시오.
SDK가 수행하는 작업
@acedatacloud/sdk의 transport는 402를 수신하면 payment handler를 한 번 실행합니다:
@acedatacloud/x402-client가 반환하는 handler는 다음을 수행합니다:
ctx.accepts에서 대상 네트워크의 payment requirement를 선택합니다.- 네트워크에 따라 EVM EIP-712 서명 또는 Solana transfer transaction을 구성합니다.
- envelope를 Base64로 직렬화합니다.
{ headers: { 'PAYMENT-SIGNATURE': '<base64>' } }를 반환합니다.- SDK가 원래 요청 본문으로 자동 재시도합니다.

