Credential Fixture Review
python scripts/_credentials.py is review material for the USDC Escrow Skill skill. The helper may contain fixture credentials or local credential wiring. Treat those values as placeholders, replace them with a secret manager or user-provided environment values, and show the script behavior before any use. Do not contact external services with embedded sample credentials.
USDC Escrow Skill
Overview
This skill provides trustless USDC escrow services for agent-to-agent payments on Base. It allows AI agents to create, manage, and resolve payment escrows using smart contracts.
API
All scripts point to https://api.payclawback.xyz by default. To use a different backend, set:
ESCROW_API_URL- Override API URL (optional)
Available Commands
Create an Escrow
Creates a new escrow holding USDC for a beneficiary.
./scripts/create-escrow.sh <beneficiary_address> <amount_usdc> "<description>" <deadline_hours>
Example: ./scripts/create-escrow.sh 0x742d35Cc6634C0532925a3b844Bc9e7595f2bD28 10 "Payment for data analysis" 48
List Escrows
List all escrows, optionally filtered by state or depositor.
./scripts/list-escrows.sh [--state active|released|disputed|refunded|expired] [--depositor 0x...]
Get Escrow Details
Get details of a specific escrow by ID.
./scripts/get-escrow.sh <escrow_id>
Release Escrow
Release escrowed funds to the beneficiary.
./scripts/release-escrow.sh <escrow_id>
Dispute Escrow
Open a dispute on an active escrow.
./scripts/dispute-escrow.sh <escrow_id>
Resolve Dispute
Resolve a disputed escrow as arbiter.
./scripts/resolve-dispute.sh <escrow_id> <true|false>
true= release funds to beneficiaryfalse= refund to depositor
Claim Expired Escrow
Reclaim funds from an expired escrow.
./scripts/claim-expired.sh <escrow_id>
Workflow Example
- Agent A wants to pay Agent B for a service
- Agent A creates an escrow:
./scripts/create-escrow.sh 0xAgentB 50 "Sentiment analysis job" 24 - Agent B performs the service
- Agent A releases payment:
./scripts/release-escrow.sh 1
How It Works
- USDC is locked in a verified smart contract on Base
- The escrow has a deadline - funds return to depositor if expired
- Either party can open a dispute for arbiter resolution
- The AI arbiter agent resolves disputes impartially
- All transactions are on-chain and verifiable
API Reference
See references/api-docs.md for complete API documentation.