STATUS: ONLINE

LAST_UPDATED: 2025-12-11

TECHNICAL SPECIFICATION

Comprehensive documentation for the XED Screener infrastructure. This registry serves as the immutable source of truth for SPL token metadata mapping, providing high-availability access to asset information via decentralized storage endpoints.

01 // System Architecture

INFRA_V2


+----------------+       +-------------------+       +---------------------+
|  CLIENT LAYER  | ----> |  EDGE MIDDLEWARE  | ----> |  PERSISTENCE LAYER  |
+----------------+       +-------------------+       +---------------------+
|                |       |                   |       |                     |
|  React / UI    |       |  Next.js API      |       |  Supabase DB (PG)   |
|  (Start Page)  |       |  (Rate Limiting)  |       |  (Token Records)    |
|                |       |  (Validation)     |       |                     |
+-------+--------+       +---------+---------+       +----------+----------+
        |                          |                            |
        | Direct Upload            | Auth / Write               | Read / Query
        v                          v                            v
+-------+--------+       +---------+---------+       +----------+----------+
| OBJECT STORAGE |       |  SECURITY MODULE  |       |  PUBLIC ENDPOINTS   |
+----------------+       +-------------------+       +---------------------+
|                |       |                   |       |                     |
| Supabase Buckets|      |  Cooldown Logic   |       |  GET /api/token     |
| (Images/Assets)|       |  Admin Gate       |       |  (CDN Cached)       |
|                |       |                   |       |                     |
+----------------+       +-------------------+       +---------------------+

EXECUTION ENVIRONMENT

Runtime Node.js / Edge
Region Global / Distributed
Latency <50ms (p99)
Consistency Strong (Write) / Eventual (Read)

DEPENDENCIES

@supabase/js v2.39.0
next v16.0.7
react v19.0.0
tailwindcss v4.0.0

02 // Security & Validation

SEC_LEVEL_HIGH

Input Sanitization

All incoming payloads undergo strict type checking and sanitization. Base58 addresses are regex-validated before processing to prevent injection attacks.

Rate Limiting

Submissions are throttled via a sliding window algorithm keyed by `wallet` + `mint` pairs.

LIMIT: 1 REQ / 10800 SEC

Asset Verification

Image assets are isolated in a public storage bucket with strict CORS policies. Max file size constraints (5MB) are enforced at the upload edge.

03 // API Endpoints

REST_V1

POST/api/submit

Primary ingestion endpoint for metadata registration. Handles cooldown checks, validation, and database persistence.

Request Body

{
  "wallet": "So111...111",  // required, base58
  "mint": "EPjFW...e76",    // required, base58
  "name": "USD Coin",       // required, max 80
  "symbol": "USDC",         // required, max 10
  "description": "Stable...", // required
  "image": "https://...",   // required, url
  "socials": {              // optional
    "twitter": "@circle",
    "website": "circle.com"
  }
}

Success Response (200)

{
  "success": true,
  "id": "550e8400-e29b...",
  "timestamp": 1715421234,
  "status": "pending"
}

GET/api/token

Public resolution endpoint. Returns the latest approved metadata for a given mint address. Used by wallets and explorers.

Query Parameters

PARAM

TYPE

DESCRIPTION

mint

string

The Solana mint address to resolve.

04 // Data Models

PG_SCHEMA

Column Name	Data Type	Constraint	Description
id	uuid	PK, DEFAULT gen_random_uuid()	Unique record identifier
created_at	timestamptz	DEFAULT now()	Submission timestamp (used for cooldowns)
wallet	varchar(44)	NOT NULL	Submitter's public key
mint	varchar(44)	NOT NULL	Target token mint address
metadata_blob	jsonb		Flexible storage for name, symbol, description
status	enum	DEFAULT 'pending'	Lifecycle state (pending → approved/rejected)

XED_SCREENER_SYSTEM // END_OF_FILE

CONFIDENTIALITY_LEVEL: PUBLIC