x402 Integration Guide

npm install irsb-x402 irsb

import { buildReceiptV2FromX402, postReceiptV2FromX402 } from 'irsb-x402';
import { IRSBClient } from 'irsb';

const irsbClient = new IRSBClient({
  chainId: 11155111,
  rpcUrl: process.env.RPC_URL,
});

app.post('/api/inference', async (req, res) => {
  // 1. Verify x402 payment (your existing logic)
  const payment = verifyX402Payment(req);

  // 2. Execute the service
  const startTime = Date.now();
  const result = await runInference(req.body);
  const endTime = Date.now();

  // 3. Build IRSB receipt from x402 context
  const receipt = buildReceiptV2FromX402({
    payload: {
      service: 'inference-api',
      payment: payment,
      request: req.body,
      response: result,
      timing: { startTime, endTime },
    },
    ciphertextPointer: resultCID, // IPFS CID of full response
    solverId: process.env.SOLVER_ID,
  });

  // 4. Post receipt on-chain
  await postReceiptV2FromX402(irsbClient, receipt, solverSigner);

  // 5. Return response with receipt reference
  res.json({
    result: result,
    receipt: receipt.receiptId,
  });
});

import { IRSBClient } from 'irsb';

// After receiving response with receipt ID
const client = new IRSBClient({ chainId: 11155111, rpcUrl });

const receipt = await client.getReceipt(receiptId);
const isValid = await client.verifyReceipt(receiptId);

console.log('Service delivery verified:', isValid);
console.log('Evidence hash:', receipt.evidenceHash);
console.log('Timestamp:', receipt.createdAt);