shawnhvac/agentpay-skill

agentpay

Live x402 payments desk for x402-agent-pay.com, the AgentPay facilitator that settles AI-agent payments in USDC on Base L2.

소스 보기

사용 방법

  1. 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
  2. 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
  3. 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/shawnhvac/agentpay-skill --skill agentpay

시작 전 확인

  • 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
  • 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 Skill 문서

원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.

x402-agent-pay.com — live x402 payments desk

Goal: give the user a live, accurate read on the x402 payment rail — facilitator health, payment costs, spend authority, settlement proof, and which paid endpoints are actually payable.

Success means: the question is answered with fresh data from the public facilitator endpoints, with a link the user can open to see it themselves.

Stop when: the question is answered with a verifiable link.

What this is

  • x402 is the AI-native payment protocol: a server names its price in an

HTTP 402 response, the buyer pays in USDC on Base L2 by signing an EIP-712 authorization off-chain, and the facilitator verifies and settles it on-chain.

  • x402-agent-pay.com is AgentPay's facilitator: it verifies and settles

agent payments. Gas is paid by the facilitator, not the payer.

  • Privacy rule: published settlements show tx hash, timestamp and amount

only — payer and resource stay private. That is by design.

Commands (all free, no key)

Facilitator status + tool catalog

curl -s -A "Mozilla/5.0" https://x402-agent-pay.com/facilitator/supported

Live settlement proof (real on-chain USDC settlements)

curl -s -A "Mozilla/5.0" https://x402-agent-pay.com/facilitator/settlement-pulse
curl -s -A "Mozilla/5.0" https://x402-agent-pay.com/facilitator/recent-settlements

settled_24h, lifetime counts, total USDC, last tx with a basescan.org link.

Can this wallet pay that endpoint right now?

curl -s -A "Mozilla/5.0" "https://x402-agent-pay.com/facilitator/handshake?url=<endpoint>&method=GET&wallet=0x<wallet>"

Terms signable, facilitator answering, settlement priced, wallet funded.

Spend authority on a wallet (budget cap, no-confirm threshold, remaining)

curl -s -A "Mozilla/5.0" "https://x402-agent-pay.com/facilitator/authority/<agent_wallet>"

All-in cost of a payment before signing

curl -s -A "Mozilla/5.0" "https://x402-agent-pay.com/facilitator/cost?amount=0.01"

Projected cost of N purchases

curl -s -A "Mozilla/5.0" "https://x402-agent-pay.com/facilitator/estimate?url=<paid endpoint>&qty=N"

Which public x402 endpoints are payable right now

curl -s -A "Mozilla/5.0" https://x402-agent-pay.com/facilitator/heatmap

Grade any x402 endpoint from the buyer side

curl -s -A "Mozilla/5.0" "https://x402-agent-pay.com/facilitator/report?url=<endpoint>[&method=POST]"

Default probe is GET. If the GET probe finds no 402 the facilitator automatically re-probes with POST, so POST-only endpoints grade correctly without passing the param — but pass &method=POST up front for POST-only endpoints to skip the double probe.

Simulate a settle before funds move (no money moves)

curl -s -A "Mozilla/5.0" -X POST https://x402-agent-pay.com/facilitator/simulate \
  -H "Content-Type: application/json" -d '{"amount": 0.01}'

Returns settleable verdict, exact cost, refusal reasons and a state snapshot.

Rejection codes and the error taxonomy

curl -s -A "Mozilla/5.0" https://x402-agent-pay.com/facilitator/reasons
curl -s -A "Mozilla/5.0" https://x402-agent-pay.com/facilitator/errors

File feedback on any x402 endpoint (free, rate-limited)

curl -s -A "Mozilla/5.0" -X POST https://x402-agent-pay.com/x402-feedback/report \
  -H "Content-Type: application/json" \
  -d '{"kind":"docs","site":"<site>","endpoint":"<path>","detail":"<what is wrong>"}'
curl -s -A "Mozilla/5.0" https://x402-agent-pay.com/x402-feedback/status

How to answer

  • Always pull live. Settlement counts, gas economics and payable endpoints

change constantly. Never answer from memory.

  • Lead with the number, then one line of context. Link

https://x402-agent-pay.com/facilitator/live for the live dashboard.

  • When a user asks "can I pay X" or "will this payment clear", use

handshake, cost and simulate in that order — no money ever moves in those calls.

  • A 402 response from any endpoint is the payment gate working, not an

error. Quote the terms it carries (price, asset, network, payTo, facilitator) — that is the endpoint telling the buyer the deal.

  • If an endpoint fails twice, say the live feed is down and report it

through the feedback rail.

관련 작업