dbis-thirdweb/packages/x402/README.md

@dbis-thirdweb/x402

x402 payment primitives and pay-to-access flows for Chain 138.

Usage

Pay-to-Access Flow

import { PayToAccessFlow, InMemoryReplayProtectionStore } from '@dbis-thirdweb/x402';
import { ThirdwebSDK } from '@thirdweb-dev/sdk';
import { chain138 } from '@dbis-thirdweb/chain';

// Server-side: Create request
const sdk = new ThirdwebSDK(chain138);
const provider = sdk.getProvider();
const replayStore = new InMemoryReplayProtectionStore();

const flow = new PayToAccessFlow(provider, replayStore);

const request = await flow.createRequest({
  amount: ethers.utils.parseEther('0.01'),
  recipient: '0x...',
  expiresInSeconds: 3600,
});

const challenge = flow.generateChallenge(request);

// Client-side: Fulfill payment
const signer = await wallet.getSigner();
const receipt = await flow.fulfillPayment(challenge, signer);

// Server-side: Verify payment
const isValid = await flow.verifyPayment(receipt, request);

Features

• Payment request creation and validation
• Replay protection via request ID tracking
• Receipt verification on-chain
• Pay-to-access flow implementation
• Expiration handling