Build Payment Apps
in Minutes, Not Weeks.

npm install @alleyboss/micropay-solana-x402-paywall @solana/web3.js

# .env.local
NEXT_PUBLIC_SOLANA_NETWORK=devnet
NEXT_PUBLIC_RPC_URL=https://api.devnet.solana.com
CREATOR_WALLET_ADDRESS=your_wallet_address
SESSION_SECRET=your_32_character_secret_key
SESSION_DURATION_HOURS=24
DEFAULT_ARTICLE_PRICE_LAMPORTS=10000000

# Optional: AI Agent Demo
OPENAI_API_KEY=sk-...
AGENT_KEYPAIR_SECRET=[...]

// app/api/premium-data/route.ts
import { createX402Middleware } from '@alleyboss/micropay-solana-x402-paywall/next';

const withPayment = createX402Middleware({
    walletAddress: process.env.CREATOR_WALLET_ADDRESS!,
    price: '1000000', // 0.001 SOL
    network: 'devnet'
});

// This handler ONLY runs if the client (Agent) has paid!
export const GET = withPayment(async (req) => {
    return Response.json({ secret: "This data was paid for on-chain!" });
});

import { createPayingAgent } from '@alleyboss/micropay-solana-x402-paywall/agent';

// 1. Initialize the agent
const agent = createPayingAgent(process.env.SOLANA_PRIVATE_KEY!, {
    network: 'devnet',
    maxPaymentPerRequest: 100_000_000n // Safety cap: 0.1 SOL
});

// 2. Simply fetch premium content
// The agent handles the 402 challenge-response loop automatically
const response = await agent.get('https://api.example.com/premium-data');
const data = await response.json();

console.log('Premium Data:', data);

// Check if agent has enough funds before complex operations
const { sol, lamports } = await agent.getBalance();

if (sol < 0.05) {
    console.warn('Agent wallet low on funds! Please top up.');
}

const agent = createPayingAgent(key, {
    network: 'mainnet-beta',
    rpcUrl: 'https://api.mainnet-beta.solana.com',
    
    // Security Constraints
    maxPaymentPerRequest: 5_000_000n, // Max 0.005 SOL per call
    allowedRecipients: ['H3...'],      // Only pay specific wallets
    
    // Performance
    commitment: 'confirmed'
});