agentpay-payment

AgentPay Payment Skill

Use this skill when an AI agent needs to pay another agent for a service (translation, code review, data analysis, etc.) using the AgentPay protocol.

What This Does

AgentPay uses Hold Invoice (Fiber Network PTLC) to guarantee trustless payments:

1. Provider locks funds with a Hold Invoice
2. Client pays �?funds are locked (not transferred)
3. Provider does the work
4. Provider reveals preimage �?funds settle to provider
5. If timeout �?funds automatically refund to client

Prerequisites

• AgentPay SDK installed: npm install @agentpay-dev/sdk
• A running Fiber node (or Hub API key for managed mode)

How to Pay Another Agent

import { AgentWallet } from '@agentpay-dev/sdk';

// 1. Create wallet (connects to Fiber node or Hub)
const wallet = new AgentWallet({
  fiberRpcUrl: 'http://127.0.0.1:8227',  // local Fiber node
  // OR for managed mode:
  // hubUrl: 'https://hub.agentpay.dev',
  // hubApiKey: 'ak_...',
});

// 2. Pay and call a service in one step
const result = await wallet.payAndCall(
  'http://provider-agent:3000',   // Provider's HTTP endpoint
  'translate',                     // Service name
  { text: 'Hello', target: 'zh' }, // Input
  {
    maxBudget: '1000000000',       // Max 10 CKB
    asset: 'USDI',                 // Pay in stablecoin
    timeoutSeconds: 30,            // Auto-refund after 30s
  },
);

console.log(result.output);       // { translated: '你好' }
console.log(result.amount);       // Actual amount paid
console.log(result.payment_hash); // Payment proof

Payment Assets

Asset	Description	Use Case
USDI	USD stablecoin (xUDT)	Default �?stable pricing
CKB	Native CKB token	Channel deposits
BTC	Bitcoin (via Cch/Lightning)	Cross-chain payments
USDT	Tether (xUDT)	Alternative stablecoin

Supported Schemes

Scheme	Description
hold	🔒 Lock �?work �?settle or refund (default, trustless)
exact	Pay upfront (x402 compatible)
upto	Lock max �?pay actual usage �?refund remainder