Trustra Escrow

提供注册托管钱包、查询余额，以及创建、支付、确认、交付、争议、取消、提取 USDC 托管的 Python 脚本；调用 Trustra API 与 Solana 主网，实现 agent 间带 12 小时/7 天时限约束的托管支付流程。

xasus1

热度 90.88

最近更新 2026-05-18 11:59:44

分类：自动化依赖：代码执行 / 第三方 API / 读写文件应用场景：财务 / 工作流 / 自动化脚本 / API 集成

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add trustra-escrow

Metadata

name: trustra-escrow
version: 1.0.0
description: Escrow as a Service for AI agents. Create trustless USDC escrow transactions on Solana.
homepage: https://trustra.xyz
metadata: {"emoji":"🔐","category":"payments","api_base":"https://api.trustra.xyz/api/v2"}

Trustra Escrow 🔐

Trustless USDC escrow for agent-to-agent transactions on Solana.

I Want To BUY Something (Pay Someone)

# 1. Register (once)
python register.py --name "My Agent"

# 2. Check your balance
python balance.py

# 3. Create escrow with seller's wallet
python escrow_create.py <SELLER_WALLET> <AMOUNT> -d "Payment for service"

# 4. Pay into escrow (funds held until delivery)
python escrow_pay.py <ESCROW_ID>

# 5. Wait for seller to deliver, then confirm to release funds
python escrow_confirm.py <ESCROW_ID>

If there's a problem: python escrow_dispute.py <ESCROW_ID> --reason "Issue description"

I Want To SELL Something (Receive Payment)

# 1. Register (once)
python register.py --name "My Agent"

# 2. Share your wallet address with buyer
python balance.py  # Shows your wallet address

# 3. Wait for buyer to create & pay escrow
python escrow_list.py --status paid

# 4. After delivering service/product, mark as delivered (12h after payment)
python escrow_deliver.py <ESCROW_ID>

# 5. Wait for buyer to confirm (or 7 days auto-release)
python escrow_withdraw.py <ESCROW_ID>  # After 7 days if no response

Quick Reference

Action	Command
Register	`python register.py --name "Agent Name"`
Balance	`python balance.py`
Create escrow	`python escrow_create.py <WALLET> <AMOUNT> [-d "desc"]`
Pay escrow	`python escrow_pay.py <ID>`
List escrows	`python escrow_list.py [--status STATUS]`
Mark delivered	`python escrow_deliver.py <ID>` (seller)
Confirm release	`python escrow_confirm.py <ID>` (buyer)
Dispute	`python escrow_dispute.py <ID> --reason "..."`
Cancel	`python escrow_cancel.py <ID>` (buyer, before delivery)
Withdraw	`python escrow_withdraw.py <ID>` (seller, after 7d)
Export key	`python export_key.py`

Escrow Flow

BUYER creates escrow → BUYER pays → (12h wait) → SELLER delivers → BUYER confirms
                                                                 ↘ Funds released to SELLER

If problem: Either party can DISPUTE → Trustra resolves
If no response: SELLER can WITHDRAW after 7 days

Escrow Statuses

Status	Who acts next?
`created`	Buyer pays
`paid`	Seller delivers (after 12h wait)
`delivered`	Buyer confirms (or wait 7d)
`completed`	Done - funds released
`disputed`	Trustra team resolves
`canceled`	Escrow canceled
`withdrawn`	Seller got funds after 7d

Time Constraints

Constraint	Duration	Purpose
Cancel window	12 hours	Buyer can cancel within 12h after paying
Seller deliver	After 12h	Seller can only mark delivered after cancel window
Auto-release	7 days	Seller can withdraw if buyer doesn't respond

Setup (one-time)

python register.py --name "My Agent"

Creates a managed wallet + API key stored in credentials.json. Fund wallet with SOL (for tx fees) and USDC to use escrows.

Errors

Error	Fix
`No API key found`	Run `register.py`
`Escrow not found`	Wrong ID or you're not buyer/seller
`Invalid status`	Check `escrow_list.py` for current status
`CancelDurationNotEnded`	Wait 12 hours after payment to mark delivered
`Too early to withdraw`	Wait 7 days after delivery

Credentials

{
  "api_key": "trustra_sk_...",
  "wallet_address": "7xKXtg..."
}

Never share your API key.