# x402scan

**Repository Path**: uesoft/x402scan

## Basic Information

- **Project Name**: x402scan
- **Description**: No description available
- **Primary Language**: TypeScript
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-25
- **Last Updated**: 2026-02-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align="center">

# x402scan

</div>

<div align="center">
    
  [![Discord](https://img.shields.io/discord/1382120201713352836?style=flat&logo=discord&logoColor=white&label=Discord)](https://discord.gg/JuKt7tPnNc) 
  ![X (formerly Twitter) Follow](https://img.shields.io/twitter/follow/merit_systems) 
  [![GitHub Repo stars](https://img.shields.io/github/stars/Merit-Systems/x402scan?style=social)](https://github.com/Merit-Systems/x402scan) 
  [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)

</div>

[x402scan](https://x402scan.com) is an ecosystem explorer for [x402](https://www.x402.org/), a new standard for digital payments. It's live at [x402scan.com](https://x402scan.com).

![x402scan screenshot](./preview.png)

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:

```bash
# Install dependencies
pnpm install

# Run the frontend
pnpm dev

# Run the sync service
pnpm dev:sync
```

## Documentation

- **[x402 Discovery Document Guide](./docs/DISCOVERY.md)** - 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](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`](https://github.com/Merit-Systems/x402scan/blob/main/facilitators/config.ts) and the dashboard will automatically update.

To add a new facilitator:

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

```typescript
{
  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,
      },
    ],
  },
}
```

3. Run `pnpm check:facilitators` to validate your changes