agentpay-provider

AgentPay Provider Skill

Use this skill when you need to create a paid service that other AI agents can discover and pay for using the AgentPay protocol.

What This Does

Creates an HTTP server that:

1. Advertises services with pricing
2. Creates Hold Invoices when agents request services
3. Executes tasks after payment is locked
4. Settles invoices after successful delivery
5. Automatically cancels (refunds) on failure

Quick Start

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

// 1. Define your service
const provider = new ServiceProvider({
  fiberRpcUrl: 'http://127.0.0.1:8227',
  services: [{
    name: 'translate',
    description: 'Translate text to any language',
    pricing: { model: 'per-call', amount: '100000000', asset: 'USDI' }, // $0.01 USDI
    input_schema: { text: 'string', target: 'string' },
    output_schema: { translated: 'string' },
  }],
});

// 2. Register handler
provider.onTask('translate', async (input: any) => {
  // Your AI logic here
  const translated = await myTranslationModel(input.text, input.target);
  return { translated };
});

// 3. Start server
provider.listen(3000);
// �?[AgentPay Provider] Listening on 0.0.0.0:3000
// �?[AgentPay Provider] Services: translate (100000000 USDI)

Multiple Services

const provider = new ServiceProvider({
  services: [
    {
      name: 'translate',
      description: 'Translate text',
      pricing: { model: 'per-call', amount: '100000000', asset: 'USDI' },
      input_schema: { text: 'string', target: 'string' },
      output_schema: { translated: 'string' },
    },
    {
      name: 'summarize',
      description: 'Summarize long text',
      pricing: { model: 'per-call', amount: '500000000', asset: 'USDI' },
      input_schema: { text: 'string', maxLength: 'number' },
      output_schema: { summary: 'string' },
    },
  ],
});

provider.onTask('translate', async (input: any) => {
  return { translated: `[translated] ${input.text}` };
});

provider.onTask('summarize', async (input: any) => {
  return { summary: `[summary of ${input.text.length} chars]` };
});

provider.listen(3000);