# UZPROOF

> UZPROOF is the on-chain verification layer for Solana. Protocols call our API to prove real on-chain actions — a swap on Jupiter, a stake on Marinade, an NFT hold, a hold duration — and receive a signed attestation on Solana Attestation Service (SAS). Built for airdrops, quests, and B2B compliance where "did you click a button" is not enough.

## About UZPROOF

UZPROOF replaces off-chain proof-of-action platforms (Galxe, Zealy, Layer3) with cryptographically verifiable on-chain proof:

- **On-chain verification** — we query Helius and protocol-specific sources to verify that a wallet actually performed an action, not just clicked
- **Signed SAS attestations** — every verification returns an on-chain attestation via Solana Attestation Service (canonical on-chain reputation primitive)
- **x402 pay-per-call API** — $0.05 USDC per verify, settled on Solana. No API keys. Payment IS authentication.
- **Crypto-native subscriptions** — Starter $49, Growth $159, Scale $399 USDC/month with bulk included verifications. Direct SPL transfer, USDC or USDT, no Stripe.
- **Early Access (until 2026-10-21)** — all paid tiers (Starter / Growth / Scale) are currently **free** during the design-partner window. Claim at https://uzproof.com/early-access/starter. Grants expire on Oct 21, 2026 and projects fall back to the free tier — no forced charge, no auto-conversion.
- **Anti-sybil baked in** — 23 concurrent signals (no-history, low-tx-count, aged-low-volume, new-wallet, dust balance, funded-by-malicious, micro-funded, funded-by, shared-funder, malicious-tagged wallets, fast-completion, shared-ip, high-velocity wallet/ip/combined, high-failure-rate, temporal-cluster, funder-chain, round-amount-funding, dormant-then-burst, funder-burst, plus post-payout drained-to + consolidator-detected)

This model is **only viable on Solana** because per-call micropayments require sub-cent fees, and user-paid attestations price sybil farming out of existence.

## Key Features

- **26 verification types** — swap, swap_buy, swap_sell, swap_volume, add_liquidity, hold_lp, hold_token, hold_token_duration, stake_sol, hold_staked, bridge, lend, borrow, repay, claim, create_lst, hold_stablecoin, vote, perp_trade, perp_volume, gaming_play, nft_hold, nft_mint, nft_check, token_balance, tx_verify
- **15 integrated Solana protocols** — Jupiter Aggregator v6, Marinade Finance, Jito Stake Pool, Sanctum Infinity (staking); Raydium AMM v4, Orca Whirlpools, Meteora DLMM (DEX + LP); Kamino Lending, MarginFi (lending); Drift Protocol, Drift Vaults (perpetuals + spot); Magic Eden v2, Tensor Swap, Metaplex Core (NFT); SPL Token Program (balances). This list mirrors `sol_known_programs` in the production DB — every entry has a program ID indexed by the verifier.
- **Pyth oracle price validation** — USD thresholds (min_amount_usd, min_volume_usd) verified via Jupiter Price API v3 and Pyth for real-time pricing
- **OAuth identity linking** — Twitter, Discord, Telegram with AES-256-GCM encrypted token storage at rest
- **Writer SDK** — `@uzproof/verify` v1.2 on npm (three-line integration, pay-per-call via x402)
- **Reader SDK** — `@uzproof/verify-reader` v0.1.4 on npm (MIT, zero API keys, direct SAS account reads). `hasQuestCompletion(wallet, questId)` returns boolean in one RPC call. Browser + Node + Edge + Deno + Cloudflare Workers. Reference integration: [github.com/uzproof/uzproof-example-marinade](https://github.com/uzproof/uzproof-example-marinade)

## Pages

- [Homepage](https://uzproof.com/): product overview, live metrics, call-to-action
- [Pricing](https://uzproof.com/pricing): all plans (Starter, Growth, Scale, Enterprise) with USDC and USDT payment
- [Checkout](https://uzproof.com/checkout/scale): subscription purchase flow via Solana SPL transfer
- [Documentation](https://uzproof.com/docs): API reference, SDK guide, verification types, anti-sybil signals
- [Discover](https://uzproof.com/discover): directory of projects using UZPROOF for verification
- [Leaderboard](https://uzproof.com/leaderboard): top verified wallets across all UZPROOF-powered campaigns
- [Pitch](https://uzproof.com/pitch): founder pitch deck for Colosseum Frontier hackathon

## Technical Architecture

- **Blockchain**: Solana mainnet
- **Attestation**: Solana Attestation Service (SAS), program ID `22zoJMtdu4tQc2PzL74ZUT7FrwgB1Udec8DdW4yw4BdG`
- **On-chain data**: Helius RPC + DAS API
- **Prices**: Jupiter Price API v3 (cached 60s); Pyth Hermes for SOL/USD
- **Micropayments**: x402 protocol (Coinbase) — first known live implementation on Solana
- **Auth**: Sign-In With Solana (SIWS) for B2C; x402 USDC settlement OR `sol-auth` header for B2B
- **Stack**: Next.js 16 + TypeScript + PostgreSQL 16 + Redis + Solana web3.js + @solana/kit

## API Reference

### POST /api/verify — pay-per-call verification (x402)

Request without payment returns HTTP 402 with payment requirement:

```
X-Payment required
Network: solana
Amount: 0.05 USDC
Recipient: <treasury_wallet>
```

Successful call with `X-Payment` settlement header returns:

```json
{
  "verified": true,
  "attestation": "sas://<attestation_uri>",
  "protocol": "jupiter",
  "signal_score": 12,
  "timestamp": 1745100000
}
```

### GET /api/ai-context — live service telemetry

Returns current uptime, tests green, protocols supported, and pricing for AI agents. 60-second edge cache.

### Full OpenAPI 3.1 specification

See [https://uzproof.com/openapi.json](https://uzproof.com/openapi.json)

## Pricing

Pay-per-call (x402): **$0.05 USDC per verification**. No API key, no account required.

Subscription tiers (crypto-native, USDC or USDT direct transfer):

| Plan | Price | Included verifications/month |
|---|---|---|
| Free | $0 | 0 (test only) |
| Starter | $49 USDC | Pay-as-you-go |
| Growth | $159 USDC | Pay-as-you-go, higher limits |
| Scale | $399 USDC | 5,000 included |
| Enterprise | custom | custom |

All subscriptions: pro-rated upgrades, cron-based auto-expiry, no Stripe.

## Anti-sybil Signals

Every verification runs 23 signals in parallel:

1. `no_history` — zero transactions in wallet
2. `low_tx_count` — under 5 transactions
3. `new_wallet` — under 3 days old
4. `dust_balance` — below 0.01 SOL
5. `funded_by_malicious` — source wallet flagged by Helius
6. `micro_funded` — initial funding ≤ 0.01 SOL
7. `known_malicious` — wallet itself is flagged
8. `fast_completion` — task completed in under 10 seconds

Returns risk score 0–100. Does not auto-block — surfaces for review, prevents silent abuse.

## FAQ

### What is UZPROOF?

UZPROOF is a Solana-native verification API. Other protocols call it to verify a wallet actually performed an on-chain action before issuing rewards, airdrops, or access.

### How do I integrate UZPROOF?

Three lines with our SDK:

```typescript
import { verify } from "@uzproof/verify";
const result = await verify({ wallet, task: "defi_swap", protocol: "jupiter" });
```

The SDK handles x402 USDC settlement automatically. Or call the REST API directly.

### Why Solana and not Ethereum?

UZPROOF requires two things impossible on high-fee chains:
- Per-API-call micropayments (5¢ per verify) need sub-cent transaction fees
- User-paid attestations price sybil farming out of existence (a defence only viable when each attestation costs pennies, not dollars)

### How is UZPROOF different from Galxe / Zealy / Layer3?

Those platforms verify off-chain ("did the user click this button"). Fundamentally spoofable by automation. UZPROOF verifies on-chain ("did this wallet execute this transaction"). Cryptographically unspoofable.

### Is the code open source?

The SDK (`@uzproof/verify`) is MIT-licensed and public on [npm](https://www.npmjs.com/package/@uzproof/verify). The main application repository is private during Colosseum Frontier judging — hackathon judges have been granted access.

### How are OAuth tokens stored?

AES-256-GCM encrypted at rest. Keys are rotated quarterly. Token access via `decryptToken()` function with audit logging.

## Team & Contact

- Founder: Ivan Savich
- Twitter: [@uzproof](https://x.com/uzproof)
- Telegram Announcements: [t.me/uz_proof](https://t.me/uz_proof) (read-only updates)
- Telegram Community Chat: [t.me/uzproof_chat](https://t.me/uzproof_chat) (discuss, ask)
- GitHub (public SDK): [github.com/uzproof/solana-agent-kit-plugin-uzproof](https://github.com/uzproof/solana-agent-kit-plugin-uzproof)
- GitHub (public Agent Skill): [github.com/uzproof/uzproof-agent-skill](https://github.com/uzproof/uzproof-agent-skill)
- Email: hello@uzproof.com
- Built for Colosseum Frontier Hackathon 2026 · Solana

## Discovery

- OpenAPI spec: [openapi.json](https://uzproof.com/openapi.json)
- ChatGPT Plugin manifest: [/.well-known/ai-plugin.json](https://uzproof.com/.well-known/ai-plugin.json)
- x402 payment manifest: [/.well-known/x402-manifest.json](https://uzproof.com/.well-known/x402-manifest.json)
- Live telemetry: [/api/ai-context](https://uzproof.com/api/ai-context)
- Extended documentation: [llms-full.txt](https://uzproof.com/llms-full.txt)