solana-foundation/pay

해결하는 문제

사용자와 AI 에이전트가 Solana 블록체인의 스테이블코인을 사용하여 API 액세스 비용을 지불할 수 있는 HTTP용 결제 레이어를 제공합니다. 특히 "402 Payment Required" HTTP 응답 처리 문제를 해결하여 결제 챌린지-응답 주기를 자동화함으로써, 모든 API에 대해 수동으로 결제를 설정할 필요 없이 요청을 진행할 수 있게 합니다.

작동 방식

pay는 CLI 도구(curl 등)나 AI 에이전트(Claude Code 또는 Codex 등)의 래퍼 역할을 합니다. API가 402 오류를 반환하면 도구가 결제 프로토콜(MPP 또는 x402)을 감지하고 스테이블코인 트랜잭션을 준비한 뒤 로컬 지갑에 승인을 요청합니다. 사용자가 생체 인식(Touch ID, Windows Hello 등)이나 백엔드 지갑을 통해 트랜잭션에 서명하면 결제 증명이 API로 전송되어 요청이 완료됩니다.

대상 사용자

• 개발자: 유료 API를 CLI 워크플로우에 통합하려는 개발자.
• AI 에이전트 운영자: 개인 키를 공유하거나 무제한 지출 권한을 부여하지 않고도 에이전트가 유료 API 호출을 수행하도록 하려는 운영자.
• API 제공자: 표준화된 기계 간 결제 프로토콜을 구현하려는 제공자.

주요 특징

• AI 네이티브 통합: Model Context Protocol (MCP) 서버가 내장되어 있어 AI 어시스턴트가 유료 API 호출을 요청할 수 있습니다.
• 생체 인식 보안: 로컬 OS 인증(Touch ID, Windows Hello, GNOME Keyring)을 사용하여 결제를 승인합니다.
• 프로토콜 지원: Machine Payments Protocol (MPP) 및 x402 Payment Protocol을 모두 지원합니다.
• 권한 제어: 무인 에이전트가 YAML로 정의된 엄격한 결제 권한(예: 최대 결제 한도 및 허용된 오리진) 내에서 작동하도록 허용합니다.
• 디버깅 도구: 결제 챌린지-응답 주기를 시퀀스 다이어그램으로 시각화하는 내장 로컬 웹 UI를 제공합니다.