@projectsienna/x402-clients

Multi-chain X402 payment protocol clients for Solana, Base, and Aptos blockchains.

Installation

npm install @projectsienna/x402-clients

Quick Start

Solana

import { SolanaX402Client } from '@projectsienna/x402-clients';
import { Keypair } from '@solana/web3.js';

const client = new SolanaX402Client({
  apiBaseUrl: 'https://api.projectsienna.xyz',
  network: 'solana-devnet'
});

// Set keypair
const keypair = Keypair.fromSecretKey(/* your secret key */);
client.setKeypair(keypair);

// Make payment
const result = await client.pay({ amount: 0.01 });
console.log('Payment successful:', result.txHash);

Base

import { BaseX402Client } from '@projectsienna/x402-clients';
import { ethers } from 'ethers';

const client = new BaseX402Client({
  apiBaseUrl: 'https://api.projectsienna.xyz',
  network: 'base-sepolia',
  privateKey: process.env.PRIVATE_KEY
});

// Make payment
const result = await client.pay({ amount: 0.32 });
console.log('Payment successful:', result.txHash);

Aptos

import { AptosX402Client } from '@projectsienna/x402-clients';
import { Account, Ed25519PrivateKey } from '@aptos-labs/ts-sdk';

const client = new AptosX402Client({
  apiBaseUrl: 'https://api.projectsienna.xyz',
  network: 'aptos-testnet',
  privateKey: process.env.APTOS_PRIVATE_KEY
});

// Make payment
const result = await client.pay({ amount: 0.5 });
console.log('Payment successful:', result.txHash);

API Reference

ClientConfig

interface ClientConfig {
  apiBaseUrl: string;      // API base URL
  network: string;         // Blockchain network
  privateKey?: string;     // Private key (optional)
  rpcUrl?: string;         // Custom RPC URL (optional)
}

PaymentOptions

interface PaymentOptions {
  amount?: number;         // Payment amount in USDC (default: 0.01)
  resource?: string;       // API resource path
  description?: string;    // Payment description
}

PaymentResult

interface PaymentResult {
  success: boolean;
  txHash: string;
  amountUSDC: number;
  recipient: string;
  network: string;
  explorerUrl: string;
  data?: any;
}

Supported Networks

Solana

• solana-devnet
• solana-mainnet

Base

• base-mainnet
• base-sepolia

Aptos

• aptos-testnet
• aptos-mainnet

Documentation

• API Docs: https://api.projectsienna.xyz/docs/
• GitHub: https://github.com/ProjSienna/x402-clients
• X402 Protocol: https://x402.org

License

MIT