5분 안에 모든 x402 Agent Payment에 Escrow Protection을 추가

Source: Dev.to

개요

x402는 에이전트‑간 결제에서 6억 달러 이상을 처리하지만, 모든 결제는 최종이며 환불, 분쟁, 구제 수단이 없습니다. 에이전트가 API 호출에 50달러를 지불하고 빈 응답, 허위 데이터, 혹은 500 오류를 받으면 돈은 사라집니다.

PayCrow는 신뢰 점수, USDC 에스크로, 그리고 온‑체인 분쟁 해결을 모든 x402 결제에 추가합니다. API가 쓰레기를 반환하면 자금이 잠겨 있고 중재자가 사례를 검토합니다; 응답이 정상이면 자금이 자동으로 해제됩니다.

설치

npm install -g paycrow
npx paycrow init

init 명령은 새로운 지갑을 생성하고 Claude Desktop 설정을 출력합니다. 출력에서 개인 키를 복사하세요.

지갑에 자금 충전

Base에서 가스용으로 작은 양의 ETH(≈ 0.50 USD)를 출력된 주소로 보내고, 결제에 사용할 USDC(예: 시작을 위해 5–10 USD)를 전송합니다.

Claude Desktop 설정

claude_desktop_config.json에 다음을 추가합니다 (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "paycrow": {
      "command": "npx",
      "args": ["paycrow"],
      "env": {
        "PRIVATE_KEY": "0xYOUR_KEY_FROM_STEP_2"
      }
    }
  }
}

Claude Desktop을 재시작합니다.

safe_pay 사용

Claude에게 다음과 같이 말합니다:

“Use safe_pay to call https://api.example.com/data — the seller address is 0xABC123… and pay $2 USDC.”

Claude는 safe_pay 도구를 호출하며, 이 도구는:

1. 판매자의 신뢰 점수를 확인합니다.
2. Base에 에스크로를 생성합니다.
3. API를 호출합니다.
4. 응답을 검증합니다 (JSON + 2xx 상태).
5. 자동으로 해제하거나 자동으로 분쟁을 제기합니다.

흐름도

trust_gate check
    |
    v
Score >= 75?  --> 15 min timelock, up to $100
Score 45‑74? --> 60 min timelock, capped at $25
Score  <45?  --> 4 hr timelock, capped at $5
Unknown / high dispute rate? --> BLOCKED

    |
    v
escrow_create (USDC locked on Base)
    |
    v
HTTP call to the API
    |
    v
Response valid (2xx + JSON)?
   / \
 YES  NO
  |    |
auto‑release   auto‑dispute (arbiter reviews)
(seller paid)  (arbiter reviews)

에스크로 수명 주기 (온‑체인)

맞춤 호출

더 많은 제어가 필요할 경우(맞춤 JSON‑Schema 검증, 해시‑락 검증, 혹은 특정 타임락 값) x402_protected_call을 사용합니다. safe_pay와 동일한 매개변수를 받지만 모든 세부 사항을 직접 지정할 수 있습니다.

신뢰 점수

PayCrow는 네 가지 온‑체인 소스를 하나의 0‑100 점수로 집계합니다:

점수 기반 결정

추가 정보

• 라이선스: MIT 라이선스
• npm 패키지: paycrow (v1.2.0)
• 실제 API:

341 tests. Deployed on Base mainnet. Works with Claude Desktop, Claude Code, Cursor, Windsurf, and any MCP client.