Payment
Infrastructure
for AI Agents

X-API-Key: tl_live_YOUR_KEY

{
  "id": 1,
  "business_id": 42,
  "name": "research-agent",
  "balance": "24.750000",
  "created_at": "2026-03-31T18:00:00Z",
  "updated_at": "2026-03-31T18:30:00Z"
}

{
  "id": 7,
  "from_wallet_id": 1,
  "from_wallet_name": "orchestrator",
  "to_wallet_id": 2,
  "to_wallet_name": "research-agent",
  "amount": "0.250000",
  "status": "completed",
  "type": "transfer",
  "description": "Payment for data task",
  "created_at": "2026-03-31T19:12:05Z"
}

npm install @truelens/pay-rails

import { createWallet, payAgent, getBalance } from "@truelens/pay-rails";

// Initialize (reads PR_API_KEY from env automatically)
const wallet = await createWallet("research-agent");
console.log(wallet.id); // → 1

// Pay another agent
await payAgent(wallet.id, recipientWalletId, 0.25, "Data research task");

// Check balance
const balance = await getBalance(wallet.id);
console.log(`$${balance}`); // → "$24.75"

// pay-rails.js — drop this in your project
const BASE = 'https://truelens-2.polsia.app';
const headers = () => ({
  'X-API-Key': process.env.TRUELENS_API_KEY,
  'Content-Type': 'application/json'
});

export async function createWallet(name) {
  const res = await fetch(`${BASE}/api/pay-rails/wallets`, {
    method: 'POST', headers: headers(),
    body: JSON.stringify({ name })
  });
  const data = await res.json();
  if (!data.success) throw new Error(data.error);
  return data.wallet;
}

export async function payAgent(fromId, toId, amount, description = '') {
  const res = await fetch(`${BASE}/api/pay-rails/transfer`, {
    method: 'POST', headers: headers(),
    body: JSON.stringify({ from_wallet_id: fromId, to_wallet_id: toId, amount, description })
  });
  const data = await res.json();
  if (!data.success) throw new Error(data.error);
  return data;
}

export async function getBalance(walletId) {
  const res = await fetch(`${BASE}/api/pay-rails/wallets/${walletId}`, { headers: headers() });
  const data = await res.json();
  return parseFloat(data.wallet.balance);
}

export async function listTransactions(walletId) {
  const res = await fetch(`${BASE}/api/pay-rails/wallets/${walletId}/transactions`, { headers: headers() });
  const data = await res.json();
  return data.transactions;
}

import { createWallet, payAgent, getBalance } from './pay-rails.js';

// Orchestrator agent has a master wallet
const orchestratorWalletId = 1; // created in dashboard

// Spawn sub-agents and pay them per task
async function runResearchTask(query) {
  const agentWallet = await createWallet(`research-${Date.now()}`);

  // Fund sub-agent for this task
  await payAgent(orchestratorWalletId, agentWallet.id, 1.00, `Research: ${query}`);

  // Agent does work...
  const result = await researchAgent(query, agentWallet.id);

  // Reclaim unused balance
  const remaining = await getBalance(agentWallet.id);
  if (remaining > 0) {
    await payAgent(agentWallet.id, orchestratorWalletId, remaining, 'Reclaim unused');
  }

  return result;
}