x402의 V2 버전

저자:YQ,<...>< span text="">편집:블록 유니콘

x402 프로토콜의 v2 릴리즈는 프로덕션 배포의 경험을 기반으로 하며 근본적인 아키텍처 변화를 나타냅니다(관심이 있는 분들은 x402의 재단에서 직접 확인하실 수 있습니다: https://www.x402.org/writing/x402-v2-launch). 1억 건이 넘는 트랜잭션을 처리한 후, 팀은 주요 마찰 지점을 파악하고 명확한 계층 분리, 블록체인에 구애받지 않는 확장성, 웹 표준 준수라는 세 가지 목표를 중심으로 프로토콜을 재설계했습니다.

v2의 변경 사항

기존 에이전트 결제와 x402 에이전트 결제 비교

기존 결제 프로세스에는 여러 수동 단계와 사람의 개입이 필요합니다. x402는 자기 주도적인 즉각적인 결제를 가능하게 하여 마찰을 제거합니다.

v2의 구조적 개선 사항

통합 결제 인터페이스

v2는 기본적으로 멀티체인 결제를 지원합니다. 단일 API로 코드 변경 없이 베이스, 솔라나 또는 지원되는 모든 블록체인에서 USDC 결제를 수락할 수 있습니다.

네트워크 식별자: CAIP-2 사용

Version 1. 은 "base-sepolia" 및 "base"와 같은 사용자 정의 네트워크 식별자를 사용합니다. v2는 "네임스페이스: 참조" 형식의 CAIP-2(체인 독립 개선 제안 2)를 채택합니다. 참조". 이를 통해 모든 블록체인, 심지어 비블록체인 결제 시스템까지 지원할 수 있습니다.

< span leaf="">결제 요건 리팩토링

버전 1은 각 결제 옵션의 리소스 메타데이터를 복제했습니다. 서버가 3개의 토큰을 수락하면 URL, 설명, 콘텐츠 유형이 세 번 반복되었습니다. 버전 2에서는 이를 공유 리소스 개체로 추출하여 메시지 크기를 줄이고 불일치를 제거합니다.

확장

버전 v2에는 공식 확장 시스템이 도입되었습니다. 핵심 결제 메커니즘과 독립적으로 작동하는 선택적 기능을 위해. 각 확장 기능에는 확장 기능 관련 데이터가 포함된 정보 객체와 JSON 스키마를 통해 구조를 정의하는 스키마 객체가 있습니다.

명시적 결제 선택

버전 v1은 필드 매칭을 사용하는 휴리스틱을 사용하여 클라이언트가 선택한 결제 옵션을 확인합니다. 버전 2에서는 선택한 전체 결제 요건을 포함하는 '수락됨' 필드를 사용하여 선택 프로세스를 더욱 명확하게 만듭니다.

< span leaf="">HTTP 전송 업데이트

RFC 6648 준수

실험적 헤더가 사실상 표준이 되는 경향이 있었지만 지속적으로 실험적이라는 라벨이 붙었기 때문에 IETF는 HTTP 헤더의 "X-" 접두사를 더 이상 사용하지 않았습니다. v2는 "X-" 접두사로 전환했습니다. v2에서는 이러한 접두사를 제거하고 결제 요구 사항을 응답 본문에서 헤더로 이동했습니다. 헤더로 이동하는 이유는 무엇인가요? 프로토콜 메타데이터를 애플리케이션 콘텐츠에서 분리하면 서버가 헤더에서 기계가 읽을 수 있는 결제 요건을 유지하면서 브라우저용 사용자 지정 HTML 페이월을 반환할 수 있습니다. 이렇게 하면 미들웨어 호환성 및 프레임워크 통합이 향상됩니다.

SDK 리팩토링

하드코딩에서 모듈성으로

하드코딩에서 모듈성으로

1 버전 SDK는 중첩된 if/else 체인에 블록체인 전용 로직을 내장합니다. 새로운 블록체인을 추가하려면 핵심 파일을 변경하고 새로운 SDK를 릴리스해야 합니다. v2는 플러그 앤 플레이 블록체인 지원을 가능하게 하는 세 가지 인터페이스를 도입합니다.

빌더 모드 등록

개발자가 CAIP-2를 사용하여 블록체인 구현을 등록하는 경우 와일드카드를 사용하여 블록체인 구현을 등록하면 SDK가 네트워크 패턴에 따라 작업을 올바른 구현으로 라우팅합니다. 와일드카드 패턴 매칭:eip155:* 모든 EVM 체인 일치 - solana:*& 모든 솔라나 네트워크와 일치- eip155:8453& 특히 기본 메인넷

람다 기반 정책 엔진

지갑 유형과 결제 방식은 v1에서 하드코딩되었습니다. v2에서는 런타임 결제 승인을 위한 구성 가능한 정책 함수를 도입했습니다.

후크 시스템

검증 후 결제 전 v1 버전 은 비즈니스 로직을 실행합니다. 결제가 실패하면 서버가 이미 되돌릴 수 없는 작업(파일 전송, API 호출, 데이터베이스 쓰기)을 수행한 것입니다. v2에는 6개의 수명 주기 훅이 도입되었습니다.

구성

v2 버전의 미들웨어는 경로 기반 구성을 지원하며 런타임 의사결정을 위한 콜백 기능을 제공합니다.

퍼실리테이터 API 향상기능

기능 공지

/지원 엔드포인트는 이제 프로토콜 버전별로 그룹화된 지원 결제 유형, 결제 작업을 위한 서명 주소, 구현된 확장 기능의 세 가지 주요 기능을 알립니다.

자동 검색

검색 확장을 통해 서비스는 자동 색인을 위해 구조화된 메타데이터를 노출할 수 있습니다. 퍼실리테이터는 x402 프로토콜을 지원하는 엔드포인트를 크롤링하고 수동 제출 없이도 최신 가격 카탈로그를 유지합니다.

마이그레이션 정책

v2는 네임스페이스 격리를 통해 이전 버전과의 호환성을 유지합니다. 네임스페이스 격리를 통해 이전 버전과의 호환성을 유지합니다. 퍼실리테이터 및 서버는 두 버전을 모두 지원할 수 있습니다. 클라이언트는 x402Version 필드를 통해 버전 기본 설정을 지정하고 구현은 일치하는 프로토콜 버전으로 응답합니다.