Epoch Lite
Epoch Lite is a Mezo testnet proof of rights separation: a seller escrows a simulated BTC-position NFT, sells one future simulated reward claim for a fixed ERC-20 price, and later recovers that same mock principal NFT. The claim is transferable, and its current holder receives only the amount actually funded into the onchain mock reward source. See LITE_SCOPE.md for the scope and SPEC.md for the longer-term idea.
Nothing here escrows actual BTC, controls a real veBTC position, or collects real Mezo fees. The 0.10 BTC position, two-minute epoch, 8-token sale, and 12-token reward are demonstration fixtures. The buyer can receive zero and lose the full purchase price. No return is promised.
Verified Mezo testnet deployment
Chain ID 31611. The four Epoch contracts have deployed code, the claim and mock reward source are linked to the market, and the market references the official testnet MEZO token. Verified on 26 October 2026. The mock trade lifecycle still needs an onchain purchase and settlement trace.
Live app · Draft pitch deck · Machine-readable deployment manifest
Current progress (26 October 2026)
| Area | Status |
|---|
| Market, claim NFT, mock position NFT, funded mock reward source | Implemented and compiling |
| Local lifecycle and adverse-path tests | 13 Foundry tests pass, including 256 fuzz cases for funded reward accounting |
| Local multi-account Anvil scenario | Passed: separate seller, buyer, operator, and claim recipient; funded payout and original NFT return |
| Next.js + wagmi/viem frontend | Production build passes; MetaMask deployment screen added at /deploy |
| Mezo testnet deployment | Four Epoch contracts deployed and wired; addresses in deployments/mezo-testnet.json |
| Live wallet-to-wallet MUSD transaction trace | Not done |
| Pitch deck | Local HTML draft at /pitch.html; labeled with mock and deployment limits, not published |
| Public GitHub repository | Published |
| Public site and draft deck | Frontend and deck returned HTTP 200 on 26 October; contracts remain unconfigured |
| Two-minute video and AKINDO submission | Not done |
The frontend uses live RPC reads and signed wallet transactions once deployment addresses are supplied. It does not use a database to declare settlement. Until deployment, it shows an explicit unconfigured state.
Local commands
Requires Node 20+, Foundry (forge, anvil, cast), and an EVM wallet for a browser demo.
npm ci
forge test -vvv
npm run contracts:build
npm run build
npm run dev
Open http://localhost:3000. npm run contracts:build exports compiled ABIs and bytecode to lib/abis.json and lib/deploy-artifacts.json for the web client. The old read-only wallet starter remains under public/ and can be run with npm run starter, but the main application is the Next.js frontend.
For a disposable local-only transaction run, start Anvil on 127.0.0.1:8545, deploy with Deploy.s.sol using Anvil's unlocked first account as ADMIN_ADDRESS, its third account as OPERATOR_ADDRESS, and USE_DEMO_TOKEN=true. Then run npm run demo:local. The script checks chain ID 31337, uses five Anvil accounts, advances local time, verifies the final NFT and token balances, and prints its local transaction hashes. These hashes are not Mezo testnet evidence.
Contracts and rights
MockVeBTC: minter-controlled test NFT, fixed illustrative principal of 10,000,000 sats (0.10 BTC), configurable mock unlock time. No BTC backing.EpochMarket: escrows only the mock NFT, lists one active offer per escrow, transfers the fixed ERC-20 price to the seller, finalizes a funded reward, restricts redemption to the current claim owner, and returns the original NFT only to the original seller after settlement/redemption or cancellation and lock expiry.EpochClaim: transferable ERC-721 claim, minted on purchase and burned on redemption. It confers no principal rights.MockRewardSource: designated operator deposits actual configured ERC-20 tokens per sold offer. The market can consume the recorded amount once after the mock epoch. Donated tokens do not increase the recognized reward.EpochDemoUSD: test-only fallback, clearly named NOT MUSD. This fallback does not by itself meet the Buildathon's MUSD/MEZO integration requirement.
The market and source use one configured ERC-20 as both quote and payout token. The intended Buildathon mode is the official testnet MUSD at 0x118917a40FAF1CD7a13dB0Ef56C86De7973Ac503. On 26 October the official Mezo testnet RPC showed token code and 18 decimals at that address. Revalidate at deployment.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
