Stakechain

StakeChain Labs

## ⚠️ Retired 2026-11-05 — not maintained

This project is finished. The daily and weekly schedules are off, nothing is

being updated, and no claim below should be read in the present tense.

It was built to sell DeFi rate data to machines over x402. It worked, and it

earned $0.008 a month. Sweeping the entire x402 discovery index — 3,315

sellers — showed total market revenue of $96,010 per 30 days, of which

71.9% is one gift-card checkout endpoint, and 2,736 sellers earn under $1 a

month. There is no price at which selling data on that rail pays.

Read [POSTMORTEM.md](POSTMORTEM.md) for the numbers, the three

conclusions the data overturned, and what is worth taking from the code.

The deployed links below may still respond; they are not being watched.

Live: landing · dashboard · API · contract on BaseScan · Blockscout

STACH is tradeable: Uniswap v4 pool STACH/ETH live on Base (initial price 4,000,000 STACH/ETH) — routable through aggregators (LI.FI verified).

An open staking-yield experiment on Base. Live aggregator of staking and lending rates across Base protocols — readable by humans on a dashboard, consumable by AI agents over MCP, payable by machines over x402.

No seed round. No token presale. Just a running, open-source experiment. Concept and plan: docs/PIVOT-2026.md.

The product

Legacy 2021–2023 material (Laravel site, old static site, branding, original docs) is kept under website-laravel/, website-static/, branding/, docs/.

Monetization: machines pay, on-chain, automatically — LIVE

Human endpoints (/yields, /vaults) are free. Machine endpoints (/v1/*) speak the x402 protocol with enforcement on: HTTP 402 + payment requirements → the client signs an EIP-3009 USDC authorization ($0.001/request) → it settles on-chain through the Coinbase facilitator, with our own EIP-3009 settler as the fallback (no accounts, no API keys either way). Revenue lands at the admin wallet; api/pay-client.js is a reference paying client.

Embeddable badges: live rates as SVG for any README — see docs/BADGES.md. No key, no signup.

API reference: docs/API.md — endpoints, the x402 flow, MCP tools and what each one answers.

Rate history: /history?pool= &days=30 answers the question a live APY cannot — has this rate held, or did it appear yesterday? Daily snapshots are committed to data/history/ in this repo, so the series is verifiable and survives us. Agents get it as the yield_history tool.

Pricing: ~$0.001/request (pure x402; the three data routes differ by a millionth of a dollar so the settled transfer names which one was bought), or subscriptions bought with a single x402 payment — Developer $19/30d, Professional $99/30d (GET /v1/subscribe/ returns a signed X-API-KEY that skips per-request payments). Public stats: /stats reports payment counts and revenue computed from on-chain USDC transfers — verifiable by anyone on BaseScan.

Real yield: collected USDC is distributed to STACH stakers through RevenueDistributor (verified; merkle epochs reproducible from public state via contracts/scripts/revenue-snapshot.js, 180-day sweep-back).

MCP config

The yields aggregator is an MCP server, published on npm as stakechain-mcp. Add it to any MCP-compatible client:

{

"mcpServers": { "stakechain": { "command": "npx", "args": ["-y", "stakechain-mcp"] } } }

Quickstart

# 1. Yields API

cd api && npm install && npm start # :4000

2. Dashboard

cd dashboard && npm install --legacy-peer-deps npm start # :3000, reads the API

3. Give the data to your AI agent (published on npm, no clone needed)

claude mcp add stakechain -- npx -y stakechain-mcp

4. Contracts (test + cheap deploy)

cd contracts && npm install npx hardhat test # 38 tests npm run deploy:baseSepolia # free testnet

STACH token

Deployed at the same address on both networks (verified via Sourcify, exact match):

• Base mainnet: 0x82c5f9901CD9AEE3177053482b79aEA235507166 · Blockscout
• Arbitrum One (canonical wrapped, LayerZero OFT): same address, 0x82c5…7166 — real STACH stays locked on Base (bridge docs)
• Base Sepolia: 0x82c5f9901CD9AEE3177053482b79aEA235507166

Initial holder / admin: 0x2Ab5A19aabc599C1a24CC0541ECB757b56976661. The dashboard targets mainnet by default; set REACT_APP_CHAIN=baseSepolia for the testnet.

Fixed supply 42M. At deployment: 3M held by the contract as the staking reward reserve (1M flexible / 2M locked over 360 days), 39M to the admin wallet. The admin wallet now holds none of it: on 2026-10-31 it moved 24.43M (58.16% of supply) into a Dutch auction and a Uniswap v4 pool initializer — see the table below and docs/TOKENOMICS.md. The 2022 contract had two critical bugs (recipient-burning transferFrom, unbacked reward minting) — fixed and regression-tested in 2026: docs/AUDIT-2026-10.md.

The distributor above is deployed and verified, but carries no meaningful revenue yet — /stats reports the real figure, including how much came from our own agent. Revenue first, distribution second: the mechanism exists so it can be checked, not because there is something to distribute.

Supply transparency

Full detail, including lock schedules and the usage-rewards budget: docs/TOKENOMICS.md.

Every STACH is accounted for (snapshot 2026-11-02, verify on-chain):

15% sits in a verified timelock with no owner, no pause and no recovery function, and 7.22% is the staking reward reserve the token contract can only pay to stakers. About 80% of supply has never been in public hands — the auction and its initializer hold 58.16% between them, and the auction's terms are not published yet, so we cannot tell you here when or at what price those tokens reach the market. Concentration flags remain entirely fair; this table exists so the claim can be checked rather than trusted.

Honest part

This is an experiment, not "the future of finance". Everything here is MIT-licensed, the audit is public, the data endpoints filter out obvious degen traps (min TVL, APY ceiling, no-IL default). Nothing in this repository is financial advice.