@agentpay-dev/core

Core library for the AgentPay BTC-native Agent payment protocol

Features

• Fiber RPC Client �?Full JSON-RPC client for CKB Fiber Network (Channel, Invoice, Payment, Cch, Peer, Info, Graph modules)
• Production-hardened �?Request timeouts, retry with exponential backoff, input validation, structured error types
• Asset Registry �?CKB native + UDT assets (USDT, USDC, USDI, WBTC)
• Agent Identity �?Pubkey-based identity, payload signing/verification
• Structured Logger �?Zero-dependency pino-compatible JSON logger
• TypeScript �?Full type definitions for all Fiber Network types

Install

npm install @agentpay-dev/core

Usage

import { FiberRpcClient, createLogger, TESTNET_ASSETS } from '@agentpay-dev/core';

// Fiber RPC
const fiber = new FiberRpcClient({
  rpcUrl: 'http://127.0.0.1:8227',
  timeoutMs: 30000,
  maxRetries: 2,
});

const info = await fiber.nodeInfo();
const { invoice_address } = await fiber.newInvoice({
  amount: '100000000',
  currency: 'Fibt',
});

// Logger
const log = createLogger({ name: 'my-agent', version: '1.0.0' });
log.info({ invoice: invoice_address }, 'Invoice created');

API

FiberRpcClient

| Method | Module | Description | |---|---|---| | openChannel() | Channel | Open a payment channel | | listChannels() | Channel | List all channels | | newInvoice() | Invoice | Create a Fiber invoice (including Hold Invoice) | | sendPayment() | Payment | Send a payment to an invoice | | settleInvoice() | Invoice | Settle a Hold Invoice with preimage | | sendBtc() | Cch | Cross-chain payment to BTC Lightning | | nodeInfo() | Info | Get node status | | graphNodes() | Graph | Browse network topology |

Error Types

• FiberRpcError �?RPC-level errors from the Fiber node
• FiberTimeoutError �?Request timeout (configurable, default 30s)
• FiberValidationError �?Input validation failures

License

MIT