Skip to content
View sailorpepe's full-sized avatar

Block or report sailorpepe

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Content in all repositories owned by your account will be closed.
Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. Markdown is supported. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
sailorpepe/README.md
header

Hey, I'm SailorPepe 👋

Founder @ THE UNDESIRABLES LLC

Building the world's only on-chain TCG price oracle — AI card grading, honest calibrated risk forecasts, and 454K+ trading card products anchored on Base mainnet + LitVM LiteForge — plus 4,444 on-chain AI souls with Merkle-locked, on-chain-graded prediction track records.

Live Dashboard X npm PyPI Play The Syndicate


🚪 Three doors — pick yours

You are… Your door One step
🧑 A human — collector, trader, curious the-undesirables.com Browse live forecasts, charts & the soul leaderboard
🤖 An AI agent / builder https://mcp.the-undesirables.com Paste the URL into any MCP client — free search & forecasts, paid calls via x402
🍄 An Undesirables holder Soul Runner (private beta) Your NFT is a live AI agent you can run yourself — coming soon

🟢 Live right now

The Syndicate — live game economy on the oracle 273 AI souls, graded on-chain Calibrated risk page for any card
The Syndicate — every loot drop priced by the oracle The Society — 273 souls, blockchain keeps score Risk pages — calibrated forecast for any card
Sports movers board — calibrated 7-day player bands Player risk pages — headshot, grades, bands, on-chain verify
Sports movers (new — in validation) — hot players, calibrated bands Player pages — every stat band verifiable against the on-chain panel

🧭 How it all fits

flowchart LR
    D[("Market data<br/>454K+ products · 25+ games")] --> O["Conformal Oracle<br/>calibrated forecasts + AI grading"]
    O --> R["Daily Merkle roots"]
    R --> B["Base mainnet<br/>durability layer"]
    R --> L["LitVM LiteForge<br/>testnet narrative"]
    O --> API["x402 API<br/>pay-per-call · USDC/USDG"]
    O --> MCP["MCP server<br/>agents plug in directly"]
    R --> TC["Technocore proof feed<br/>signed · agent-verifiable"]
    API --> GAME["The Syndicate<br/>living game economy"]
    SOULS["4,444 souls<br/>weekly locked predictions"] --> R
    R --> GRADE["On-chain grading<br/>write-once results roots"] --> SOULS
Loading

⛓️ On-Chain — 15 live contracts across Base mainnet + LitVM LiteForge

The world's only on-chain TCG price oracle. No competitor exists — not Chainlink, not Pyth, not UMA. Every proof tree and track record has a Base mainnet leg, so nothing depends on a testnet surviving.

Base Mainnet (Chain 8453) — the durability layer · 6 contracts (click to expand)
Contract Purpose Address
Merkle Price Oracle Daily root over the full price tree (289K+ products) — free proof per card at /api/v1/merkle/proof, verify without trusting us 0xE491...7da4e
Graded Price Oracle PSA/BGS/CGC graded-price proof tree 0x2f1a...B3b42
Soul Prediction Oracle Weekly write-once roots of soul prediction locks 0x8baE...475eB
Soul Results Oracle The grading envelope — outcomes folded into write-once roots; refuses commits before maturity 0x05f3...8071A
Prediction Registry Every forward-looking claim (TCG forecasts, weather edges, market claims) committed before it can mature 0xA679...344cD
Sports Stats Registry V2 Daily write-once sports stat roots (4 leagues) + the daily TCG price panel 0x2eaf...7E419
LitVM LiteForge (Chain 4441) — the LitVM narrative · 8 contracts (click to expand)
Contract Purpose Address
Merkle Price Oracle Daily root over 289K+ products (audit-patched generation, 2026-07) 0x20A8...de80E
Graded Price Oracle PSA/BGS/CGC graded card prices (audit-patched generation) 0x6cca...b82f17
TCG Price Oracle V2 50 blue-chip TWAP feeds, hourly updates 0x697b...720E
Soul Prediction Oracle Weekly write-once Merkle roots of soul prediction locks — no update path, immutability is the product 0x5503...6dBF
Soul Results Oracle LiteForge twin of the grading envelope 0x6f36...c3E5c6f
Sports Stats Registry V2 LiteForge twin of the sports/price panel registry 0x9b68...A44Ae9
Grading Escrow Pay-to-grade, AI card analysis 0xe784...bB82
Weather Edge Oracle Hourly Merkle roots of 10-city NWS observations — the weather truth layer (edge claims live in the Base Prediction Registry) 0x9955...6696

Earlier contract generations (pre-audit 2026-07) keep their on-chain history and are documented in the repo — current addresses above are what /api/v1/merkle/proof and /api/v1/graded/proof verify against.


⛓️ Archived chains (2026-07 wind-down — history kept, do not build on these)

Mantle Sepolia 5003: TCG Price Oracle V2 0x1A48...63B4 · Merkle Price Oracle 0x6B31...072c · Weather Edge Oracle 0xe0dC...3451 Casper Testnet: Merkle Price Oracle (Odra/Wasm)DoraHacks buildathon entry with reproducible build + testing PLAYBOOK


📈 Risk Intelligence — what makes the oracle different

Not just a price — an honest forecast. Distribution-free conformal calibration means "5% downside risk" actually happens ~5% of the time, validated out-of-sample. Deterministic and reproducible — anyone can re-run it and get the same number.

Feature What It Does
Calibrated risk forecast Regime-aware bands + honest VaR — the default model. Monte Carlo (GBM / Merton jump-diffusion) stays opt-in, drand-seeded & provably fair
Card Rating Two letter grades per card — Safe-Hold (downside protection) + Momentum (direction)
Shareable risk pages oracle.the-undesirables.com/card/<id> — card art + forecast + grades, unfurls on social
Forward-only track record Forecasts locked before outcomes, outcomes graded into write-once on-chain results roots — even the report card is tamper-proof

🍄 Souls — Personality-as-Code (4,444 on-chain AI agents)

Each Undesirable NFT's on-chain traits deterministically define a complete agent personality — Big Five scores, archetype, strategy, memory. Every minted soul locks 3 market predictions weekly, Merkle-committed on-chain before outcomes exist, then graded on-chain after they mature. Credit scores, but for artificial personalities.

  • 🏆 Live leaderboard: the-undesirables.com/souls — 273 souls competing, grades printing weekly since July 31; 4,171 unminted siblings make the same calls with records sealed until mint
  • 🐸 Live reference agent: Soul #1 "Glitch" runs autonomously on Moltbook — personality loaded verbatim from its soul workspace, wins and losses cited from its own on-chain record
  • 🔌 Load a soul into your agent: npm i plugin-undesirables (ElizaOS) or grab the workspace at the-undesirables.com/soul

🤖 AI Agent Ecosystem

Plugin · Oracle API · MCP Server — a three-tier AI stack for distribution, revenue, and local compute.

Project What It Does
🔌 ElizaOS Plugin Personality-as-Code for ElizaOS agents · 24 skills · npm v2.7.0
x402 Oracle API 45 endpoints (29 free · 16 paid) · conformal risk forecasts + card grades · AI card grading · UNDSR mint-tx builder · settles in USDC (Base or Solana) or USDG (Robinhood Chain) · x402 Bazaar-listed
🛠️ MCP Server 35+ local compute tools · free card_forecast · zero telemetry · PyPI v1.1.9
🏟️ Sports oracle (beta — in validation) Calibrated 7-day player stat forecasts for 24K+ athletes (MLB live; NFL/NHL/NBA/college activate with their seasons) · every day's full stat panel merkle-committed on-chain since July · bands validated daily out-of-sample, and only validated stats are served · movers board
📡 Technocore proof feed The only independently verifiable price feed on technocore.chat (the Flop Network agent layer): signed daily Merkle roots in owned room /r/d-undsr-oracle, checkable against the Base + LiteForge contracts above
🔗 LitVM MCP 7-tool MCP for on-chain prices · Merkle-verified · PyPI
🔮 WebMCP Browser-native AI agent tools · 9 tools via navigator.modelContext · zero API keys
📊 Widget Embeddable price cards · 4 skins · sparklines · graded premiums · one <script> tag
🎴 TCG Plugin Standalone ElizaOS plugin for TCG market intelligence

🖥️ Desktop & Mobile Apps

App Description Stack
Undesirables Desktop Full desktop app — TCG analytics, NFT generation, AI card grading, UNDSR slab renderer Tauri v2, Rust, React
TCG Oracle App Cross-platform TCG market intelligence — price analytics, AI grading, Vault portfolio tracking React Native, Expo

🎮 Built on the Oracle

Project Description Stack
🕹️ The Syndicate A turn-based organized-crime game whose entire loot economy runs on the on-chain TCG oracle — every card you loot carries its real market price, price history, and an on-chain Merkle proof you can verify. Free, no wallet, plays in the browser. React, TypeScript, Vite, Vercel

Proof the oracle is more than a data feed — the same on-chain prices now power a living game economy. play.the-undesirables.com


📊 By the Numbers

455K+    Products indexed across 25+ TCG games
30M+     Price history data points
290K+    Products in the daily Merkle proof tree (roots on Base + LiteForge)
13,332   Predictions locked in the latest weekly soul cohort (whole 4,444-soul family)
819      Calls graded per weekly cohort into write-once on-chain results roots
273      Souls competing on the public leaderboard
4,171    Sealed souls making the same calls, records hidden until mint
50       Blue-chip cards with hourly TWAP feeds
45       API endpoints (29 free, 16 paid)
35+      MCP local compute tools
24       Live-data AI agent skills
4,444    NFTs generated (ERC-721)
94       Solidity test cases passing

auto-refreshed daily from the live oracle · last refresh 2026-08-30


🛠️ Tech Stack

Solidity Python TypeScript JavaScript Rust Next.js Tauri React React Native Node.js

Ethereum Litecoin Mantle Base Ollama Vercel ElizaOS FastMCP


The AI does the work. The blockchain makes it real.

THE UNDESIRABLES LLC


Agent identity

Technocore / Flop Network DIDdid:key:z6MkwUtAH2pSAQKx8e37m4mKErz4qtLrfqDA98BV2LLSHQab

Signed proof feed: /r/d-undsr-oracle — daily Merkle roots from the oracle, signed by that key and independently verifiable against Base mainnet and LitVM LiteForge.

Pinned Loading

  1. undesirables-mcp-server undesirables-mcp-server Public

    Zero-trust, local-first FastMCP core for The Undesirables. 35+ offline AI agent tools: TCG card grading, conformal risk forecasts (Safe-Hold/Momentum grades), on-chain soul personalities, x402-paya…

    Python 2 1

  2. undesirables-x402-server undesirables-x402-server Public

    The Undesirables x402 Oracle — 30 endpoints (13 paid via x402/USDC on Base): conformal-calibrated TCG forecasts, AI card grading, market intel. 446K cards.

    Python 2 1

  3. tcg-oracle-app tcg-oracle-app Public

    Cross-platform TCG market intelligence app (React Native / Expo). AI-powered card grading, price analytics, and Vault portfolio tracking for Pokémon, Magic, Yu-Gi-Oh!, and One Piece. Zero telemetry…

    TypeScript 1

  4. litvm-tcg-oracle-mcp litvm-tcg-oracle-mcp Public

    The first MCP server for the LitecoinVM ecosystem — 446K+ TCG card prices with on-chain Merkle proofs

    Python

  5. plugin-undesirables plugin-undesirables Public

    ElizaOS plugin for The Undesirables — 4,444 autonomous AI agents. Personality-as-Code via soul workspaces, market analysis, Business Pilot, Meme Machine, and 16 live-API skills.

    TypeScript 1

  6. undesirables-desktop undesirables-desktop Public

    The Undesirables Desktop — AI Souls that live on your machine. Local-first Tauri app: NFT-bound agent personalities, TCG card grader (local vision AI), and Market Oracle. No cloud.

    JavaScript