RG Project Dump

x402scan is an ecosystem explorer for x402, a new standard for digital payments. It's live at x402scan.com.

x402 API resources can be be purchased just-in-time without a prior relationship with the seller using stablecoins. x402 is vision for an internet without ads or centralized intermediaries.

x402scan lets you explore the ecosystem of x402 servers, see their transaction volumes and directly access their resources through an embedded wallet.

Monorepo Structure

This is a pnpm monorepo with the following workspaces:

scan/ - Next.js web application (x402scan.com)
sync/ - Background sync service using Trigger.dev
facilitators/ - Shared facilitator configuration

Development

Note: We're working on making this easier to spin-up. If you have any trouble in the mean time, please reach out.

Fill out a .env.example with the variables in scan/.env.example.

Then install and run:


# Install dependencies
pnpm install

# Run the frontend
pnpm dev

# Run the sync service
pnpm dev:sync

Documentation

x402 Discovery Document Guide - Learn how to implement discovery for your x402 server to enable automatic resource registration

Contributing

We're actively seeking contributors to help build x402scan. We believe an ecosystem explorer will shed light on the activities happening over x402, build trust, and help standardize interaction patterns to grow the ecosystem massively.

Add Resources

If you know of a resource that is not yet listed, you can add it by visiting https://www.x402scan.com/resources/register and submitting the URL. If the URL returns a valid x402 schema, it will be added to the resources list automatically.

Add Facilitators

If you know of another facilitator that is not listed, you can add it to facilitators/config.ts and the dashboard will automatically update.

To add a new facilitator:

Add the facilitator logo to facilitators/images/
Add the facilitator configuration to the _FACILITATORS array in facilitators/config.ts:


{
  id: 'my-facilitator',
  name: 'My Facilitator',
  image: '/my-facilitator.png',
  link: 'https://my-facilitator.com',
  color: 'var(--color-blue-600)',
  addresses: {
    [Chain.BASE]: [
      {
        address: '0x...', // Your facilitator address
        token: USDC_BASE_TOKEN,
        syncStartDate: new Date('2025-01-01'),
        enabled: true,
      },
    ],
  },
}

Run pnpm check:facilitators to validate your changes

x402scan

Contents