@x1pay/sdk

Core SDK for X1Pays -- the payment and DeFi infrastructure for AI agents on X1 blockchain.

Features

• WalletManager -- Keypair management, balance queries, send tokens, full x402 payment flow
• SpendingPolicy -- Per-transaction limits, session budgets, daily budgets, asset/recipient whitelists
• AssetRegistry -- Resolve XNT, wXNT, USDC.x by symbol with full mint/decimals/type info
• PaymentBuilder -- Build and sign x402 payment transactions with facilitator fee

Install

npm install @x1pay/sdk

Usage

import { WalletManager } from '@x1pay/sdk'

const wallet = new WalletManager(process.env.AGENT_KEY, {
  network: 'x1-mainnet',
})

wallet.setPolicy({
  maxPerTransaction: 10_000_000n,
  sessionBudget: 100_000_000n,
})

const result = await wallet.payForResource('https://api.example.com/premium')
console.log(result.data)

const balances = await wallet.getBalances()

await wallet.send('RECIPIENT_ADDRESS', '5.0', 'USDX')

Supported Assets

| Symbol | Name | Type | |--------|------|------| | XNT | Native XNT | Native | | USDX / USDC.x | USD Coin (X1) | Token-2022 | | WXNT / wXNT | Wrapped XNT | SPL |

API

WalletManager

| Method | Description | |--------|-------------| | getBalances() | All token balances | | send(to, amount, asset) | Transfer tokens | | payForResource(url, opts?) | Full x402 payment flow | | probeResource(url) | Get payment requirements without paying | | setPolicy(policy) | Update spending limits | | checkPolicy(amount, asset, recipient?) | Check if payment is within policy | | stats | Session stats (spent, remaining, tx count) | | history | Transaction history |

resolveAsset(symbol)

Returns AssetInfo for any supported symbol or alias.

calculateFee(amount, basisPoints)

Calculates facilitator fee from amount and basis points.

Links

• X1Pays Website
• Full Documentation

License

MIT