mantleproof
v0.1.3
Published
One-command CLI to verify MantleProof's live state on Mantle mainnet and audit any contract (Tier 1, free, no wallet).
Maintainers
Readme
mantleproof CLI
Two one-command surfaces over the live MantleProof oracle on Mantle mainnet (chainId 5000). Both are pure public reads — no wallet, no gas, no private key.
# Prove MantleProof is real and live (≈30s of green checks against mainnet)
npx mantleproof verify
# Audit any Mantle contract — free read, structured findings + honesty labels
npx mantleproof check 0x1892f77e335c133ce4a7b28555f13ba74cbb76famantleproof verify
Connects to Mantle mainnet and runs seven real reads (no hardcoded results):
- Registry deployed +
oracleSignermatches the expected immutable signer. - MantleProof registered in Mantle's ERC-8004 Identity Registry (tokenId #96).
- Demo audits anchored on the staking-free registry (gas-only anchors).
- Most-recent audit anchored on-chain (rootHash + age).
getAudit()returns a structured finding (severity + tier).- The disputes layer was exercised on mainnet (a dispute resolved RETRACTED; economic slashing is now roadmap).
- A paying customer left ERC-8004 reputation about MantleProof.
A bonus, soft check (Tier 2 engine reachable) runs only when ENGINE_URL is
set; it never counts toward the on-chain pass total.
The reads fail over across a built-in list of public RPCs (drpc → publicnode →
public-rpc → mantle.xyz) and are bounded by a wall-clock budget (~45s), so a
single slow or dead endpoint no longer stalls a run. If every endpoint is
unreachable, verify fails fast with a clear message rather than hanging — pin a
specific RPC with MANTLE_RPC_URL and re-run:
MANTLE_RPC_URL=https://mantle.drpc.org npx mantleproof verifymantleproof check <address>
Reads the latest anchored audit for the target, fetches the full report from
IPFS, re-derives the on-chain rootHash from the bytes (trustless integrity
— matches engine/.../pipeline.py::_canonical), and prints the findings with
their honesty labels. The deeper paid Tier 2 path (x402 / payForAudit) is
pointed to, never invoked — check never spends.
Environment
| Var | Default | Purpose |
|---|---|---|
| MANTLE_RPC_URL | (built-in fallback list) | use a single RPC instead of the built-in failover list (drpc → publicnode → public-rpc → mantle.xyz) |
| ENGINE_URL | (unset) | optional engine base URL for the Tier-2-reachable check |
| NO_COLOR | (unset) | disable ANSI colors |
Build (workspace)
pnpm --filter mantleproof build
node cli/build/index.js verify