@nory/sdk

Lightning-fast x402 payment integration for JavaScript/TypeScript applications.

Installation

npm install @nory/sdk
# or
yarn add @nory/sdk
# or
pnpm add @nory/sdk

Quick Start

import { Nory } from '@nory/sdk';

const nory = new Nory({
  merchantWallet: 'YOUR_WALLET_ADDRESS',
  network: 'solana-mainnet',
});

// Create payment requirement
const requirement = nory.createRequirement({
  amount: '1.00', // $1.00 USDC
  currency: 'USDC',
  resource: '/api/premium',
  description: 'Access to premium content',
});

// Verify and settle payment
const result = await nory.verifyAndSettle(paymentPayload);

if (result.success) {
  console.log('Payment settled!', result.transactionId);
}

Express.js Middleware

import { Nory, noryMiddleware } from '@nory/sdk';

const nory = new Nory({
  merchantWallet: process.env.MERCHANT_WALLET!,
  network: 'solana-mainnet',
});

// Protect routes with payment
app.use('/api/premium', noryMiddleware(nory, {
  amount: '0.10',
  currency: 'USDC',
}));

app.get('/api/premium/data', (req, res) => {
  res.json({ data: 'Premium content!' });
});

Supported Networks

• Solana (Mainnet & Devnet)
• Base (Mainnet & Sepolia)
• Polygon (Mainnet & Amoy)
• Avalanche (Mainnet & Fuji)
• Sei
• IoTeX
• Arbitrum
• Optimism

Testing with Echo

Test payments for free with 100% refund:

const result = await nory.echo(paymentPayload);
console.log('Refund TX:', result.refundTxId);

Documentation

Full documentation: https://noryx402.com/docs

License

MIT