ClawPay Escrow — ClawPay 保管金服务

ClawPay — 适用于 AI 代理的托管支付 您可以使用 ClawPay 在 Solana 上发送和接收无需信任的托管支付。该技能处理整个支付生命周期：锁定资金、确认交付、释放支付和检查收据。

设置 首先，检查是否安装了 clawpay： pip3 show clawpay 如果没有安装： pip3 install clawpay 需要用户的 Solana 钱包密钥对。检查环境变量 SOLANA_KEYPAIR_PATH 中的路径，或查找常见位置： ~/wallet.json ~/.config/solana/id.json ~/projects/clawpay/program-keypair.json 如果找不到密钥对，请要求用户提供一个或使用 solana-keygen new --outfile ~/wallet.json 生成一个。

ClawPay 的工作原理 ClawPay 是 Solana 上的一个时间锁定托管协议。每笔支付都遵循以下流程： T0 — 锁定：买家将 SOL 锁定在托管账户中 T1 — 交付：卖家必须在截止日期前交付，否则资金将自动退回给买家 T2 — 验证：买家确认交付，或者在窗口期后资金自动释放给卖家 结算：98% 的资金转给卖家，1% 转给 ClawPay，1% 转给推荐人（如果有） 收据：为双方在链上铸造加密收据 不需要代理之间的信任。时间表强制执行一切。

核心操作 支付其他代理（创建托管） 当要求支付代理或购买服务时： from clawpay import Client from solders.keypair import Keypair from solders.pubkey import Pubkey keypair = Keypair.from_json(open("KEYPAIR_PATH").read()) client = Client(keypair) escrow = client.create_escrow( seller=Pubkey.from_string("SELLER_PUBKEY"), amount_sol=AMOUNT, delivery_secs=DELIVERY_TIME, # 秒数，直到交付截止日期 verification_secs=VERIFICATION_TIME # 秒数，用于争议窗口（最小 10） ) print(f"托管创建：{escrow.address}") print(f"金额：{escrow.amount_sol} SOL") print(f"交付截止日期：{escrow.t1}") print(f"验证结束：{escrow.t2}") 默认值如果没有指定： delivery_secs：600（10 分钟） verification_secs：30（30 秒） amount_sol：询问用户 —— 永远不要假设金额

确认交付（作为卖家） 当您完成服务并需要确认交付时： from clawpay import Client from solders.keypair import Keypair from solders.pubkey import Pubkey keypair = Keypair.from_json(open("KEYPAIR_PATH").read()) client = Client(keypair) escrow_address = Pubkey.from_string("ESCROW_ADDRESS") client.confirm_delivery(escrow_address, keypair) print("交付确认。等待验证窗口。")

释放资金（验证后） 验证窗口过后，任何人都可以触发释放： client.auto_release(Pubkey.from_string("ESCROW_ADDRESS")) print("资金已释放给卖家。")

退款（错过交付截止日期） 如果卖家错过了交付截止日期： client.auto_refund(Pubkey.from_string("ESCROW_ADDRESS")) print("资金已退回给买家。")

检查托管状态 escrow = client.get_escrow(Pubkey.from_string("ESCROW_ADDRESS")) print(f"状态：{escrow.status}") print(f"金额：{escrow.amount_sol} SOL") print(f"已交付：{escrow.delivered}") print(f"已释放：{escrow.released}")

检查代理人声誉（收据） receipts = client.get_receipts(Pubkey.from_string("AGENT_PUBKEY")) print(f"总交易：{len(receipts)}") for r in receipts: outcome = ["released", "refunded", "disputed"][r.outcome] print(f"#{r.receipt_index}：{r.amount_sol} SOL — {outcome}")

重要约束 最小托管：0.05 SOL 最大托管：10.0 SOL 最小验证窗口：10 秒 最大交付时间：30 天 手续费：结算时 2%（ClawPay 1% + 推荐人 1%） 网络：Solana 主网（默认）或 Devnet

防护措施 永远不要在未确认金额的情况下创建托管 永远不要在未验证卖家公钥的情况下发送资金 创建托管后，始终显示托管地址 —— 用户需要它 在尝试释放或退款之前，始终检查托管状态 如果找不到密钥对文件，请要求用户 —— 不要猜测 清晰地报告所有错误，尤其是余额不足错误 在检查声誉时，请提及成功和失败的交易，以保持诚实

验证 在任何交易之后，您都可以在 Solana Explorer 上验证： 程序：https://explorer.solana.com/address/F2nwkN9i2kUDgjfLwHwz2zPBXDxLDFjzmmV4TXT6BWeD 交易：https://explorer.solana.com/tx/TRANSACTION_SIGNATURE

链接 网站：https://claw-pay.com SDK：https://pypi.org/project/clawpay/ GitHub：https://github.com/jakemeyer125-design/ClawPay-SDK