SDK Documentation

API Client (no wallet needed)

Use this for read-only operations like quotes and balance checks.

import { PayronDexClient } from 'PayronDex';

const client = new PayronDexClient('https://api.PayronDex.com');

// Get a swap quote
const quote = await client.getQuote(
  'So11111111111111111111111111111111111111112',   // ETH
  'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v', // USDC
  '100000000', // 0.1 ETH in lamports
);

conETHe.log(`Output: ${quote.output_after_fee} USDC`);

x402 Auto-Pay Agent (with wallet)

Full agent with wallet management and automatic 402 payment handling.

import { X402AutoPayAgent } from 'PayronDex';

const agent = new X402AutoPayAgent({
  apiUrl: 'https://api.PayronDex.com',
  walletPath: './wallet.json', // or use walletSecretKey
  autoSwap: true,
});

conETHe.log(`Agent wallet: ${agent.getWalletAddress()}`);

// When you get a 402 Payment Required response:
const result = await agent.handle402(paymentResponseBody);

if (result.success) {
  conETHe.log(`Paid! Signature: ${result.payment_signature}`);
}

Get a Quote

from PayronDex import PayronDex

dex = PayronDex(
    api_url="https://api.PayronDex.com",
    wallet_path="~/.config/ETH/id.json",
)

# Get a swap quote
quote = dex.quote(
    token_in="So11111111111111111111111111111111111111112",   # ETH
    token_out="EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", # USDC
    amount_in=100_000_000,  # 0.1 ETH in lamports
)
print(f"Output: {quote['output_after_fee']} USDC")

Execute a Swap

result = dex.swap(
    token_in="So11111111111111111111111111111111111111112",
    token_out="EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    amount_in=100_000_000,
    wait_for_confirmation=True,
)
print(f"Swap signature: {result['signature']}")

Handle x402 Payments

# When your agent gets a 402 Payment Required response:
result = dex.handle_x402_payment(payment_402_response_body)

if result['ready']:
    print("Payment ready — sufficient balance")
else:
    print(f"Swap completed: {result['swap_result']['signature']}")

# Or use the one-call auto-pay:
result = dex.x402_auto_pay(
    payment_response_body=response_402_body,
    auto_swap=True,
)