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 — a Japanese two-sided dealer board (bid and ask, 365K cards, daily, Merkle-rooted), graded-slab lending terms on a live value basis, calibrated sports movers, AI card grading, and 456K+ products anchored on Base mainnet + LitVM LiteForge — plus 4,444 on-chain AI souls with Merkle-locked, on-chain-graded prediction track records. The USD price panel froze 2026-09-07 when its upstream went away; everything USD is served as last-published and labelled, never as current.

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 the Japanese board, graded-slab loan terms, sports movers & the soul leaderboard
🤖 An AI agent / builder https://mcp.the-undesirables.com Paste the URL into any MCP client — 27 tools, free Japanese board summary / graded asks / loan universe / sports, paid quotes 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 — minted souls, blockchain keeps score Card pages — last-published USD forecast, labelled frozen since 2026-09-07
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[("Japanese dealer board · graded-slab census<br/>sports panels · 456K+ products")] --> O["Oracle<br/>loan terms (empirical VaR) · JP souls board<br/>sports bands · 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, sports forecasts, 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 updater; underlying USD prices frozen 2026-09-07, so the feed has not moved since 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 Merkle roots of 10-city NWS observations every 15 min — the weather truth layer stays live; the trading edge that sat on top of it is retired (closed at settlement) 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 / Casper Testnet: DoraHacks experiments, discontinued 2026-07-21 — not supported, kept only as history.


📈 What the oracle serves — live after the USD freeze

The USD price panel froze on 2026-09-07 (upstream withdrawn; no source permits republishing prices). Rather than sell a stale number as current, the USD-dependent calls are suspended (they answer {"status":"suspended"} and never charge) and the product stands on data that refreshes every day.

Live feed What it is
Japanese two-sided board 365K Japanese-print cards across 24 games, priced daily with a dealer bid and ask — 167K carry both sides. Published as aggregates (/api/v1/jp/summary), every day's board Merkle-rooted on-chain. The Card Souls call this board since 2026-09-14
Graded-slab loan terms v2 Max LTV, liquidation price, liquidity tier and APR premium for PSA/BGS/CGC slabs — value basis is live (realized sales › delisting-inferred sales › ask haircut), tail risk is an empirical VaR from 14 months of history, labelled as such. Free worked derivation for the daily free board
Sports movers (in validation) Calibrated 7-day player stat bands, validated out-of-sample daily; only validated stats are served; dormant / warming leagues say so instead of serving frozen numbers
AI card grading PSA/Beckett grade prediction from a photo, plus a grade-or-not ROI verdict
Forward-only track record Calls locked before outcomes, outcomes graded into write-once on-chain results roots — the USD-era cohorts void on schedule rather than being scored against a frozen price

🍄 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 calls weekly on the Japanese dealer board (since 2026-09-14), 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 — every minted soul 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 · live Japanese board + sports context · npm v2.7.2
x402 Oracle API 51 listed endpoints (41 free · 10 paid · 7 suspended while the USD panel is frozen) · graded-slab loan terms · Japanese board summary · sports movers · AI card grading · UNDSR mint-tx builder · settles in USDC (Base or Solana) or USDG (Robinhood Chain) · x402 Bazaar-listed
🛠️ MCP Server The TCG Oracle over stdio — 27 tools, the same ones the hosted endpoint serves, no keys · undesirables-agent-kit = the 34-tool local kit · PyPI
🏟️ 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 16-tool MCP for on-chain prices · Merkle-verified · hosted at litvm.the-undesirables.com/mcp · 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 — search, grading, Japanese board, sports board, graded loan preview · npm v2.0.2

🖥️ 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

456K+    Products indexed across 25+ TCG games
30M+     Price history data points
290K+    Products in the Merkle proof tree (USD frozen at 2026-09-07, roots on Base + LiteForge)
366,220  Japanese-print cards priced daily across 24 games
168,189  of those carrying BOTH an ask and a dealer buyback bid
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,170    Sealed souls making the same calls, records hidden until mint
50       Blue-chip cards on the TWAP feed (USD frozen at 2026-09-07; the updater skips rather than re-push stale prices)
51       API endpoints listed (41 free, 10 paid, 7 suspended while the USD panel is frozen)
27       MCP oracle tools (hosted endpoint + stdio package)
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-09-19


🛠️ Tech Stack

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

Ethereum Litecoin 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 3 1

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

    The Undesirables x402 Oracle — 48 endpoints (10 paid via x402/USDC; 7 suspended while the USD panel is frozen): graded-slab loan terms, sports + Japanese two-sided boards, souls, on-chain Merkle pr…

    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 2

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

    The first MCP server for the LitecoinVM ecosystem — 456K+ TCG products with on-chain Merkle proofs (USD prices frozen 2026-09-07; Japanese + graded panels refresh daily)

    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