Market reports you can verify.
Understand BTC liquidity and Mezo MUSD borrower risk. Liqvera turns public market and protocol snapshots into downloadable reports with the evidence behind every calculation.
Open the demo · Watch the demo · Documentation · Commit history
- Demo video (2:00): Watch on YouTube
- openTrove: Mezo Testnet transaction
- repayMUSD (Trove protection): Mezo Testnet transaction
- Paid Trove report (x402, MUSD): Mezo Testnet transaction
- Paid Market depth report (x402, MUSD): Mezo Testnet transaction
- BTC→MUSD sale via Mezo DEX Router (0.0001 BTC → 7.86 MUSD): Mezo Testnet transaction
- Trove actions from the report (addColl 0.0005 BTC, repayMUSD 0.5): addColl, repayMUSD
- LiqveraGuard (automatic Trove protection, testnet only, not audited): 0x61e12BDDFa62adF0Ffa89544153954a2420cF37a, deploy tx 0x8fb90b1f36…, block 16524690. See docs/guard.md.
- Full ledger: 29 more signed testnet transactions (11 paid reports, 8 BTC sales with approvals, 2 Trove actions) in docs/testnet-tx-ledger.md
Mezo Testnet · chain 31611. MUSD access, the DEX comparison, Trove risk and wallet-signed Trove/DEX actions are deployed on liqvera.site (PR #25). Wallet-free examples include fixed-block native calls and offline-reproducible evidence. Current deployment and verification. Transactions are prepared from fresh on-chain state and submitted only when the connected user signs in their wallet; Liqvera never accesses signing keys. The transaction links above document a Trove opening, a MUSD repayment and a paid Trove report.
| Contract | Testnet address | Use |
|---|---|---|
| MUSD | 0x118917a40FAF1CD7a13dB0Ef56C86De7973Ac503 | Pay: 0.01 test MUSD per report |
| Permit2 | 0x000000000022D473030F116dDEE9F6B43aC78BA3 | Wallet authorization |
| x402 exact proxy | 0x402085c248EeA27D92E8b30b2C58ed07f9E20001 | MUSD settlement |
| DEX Router | 0x9a1ff7FE3a0F69959A3fBa1F1e5ee18e1A9CD7E9 | Quotes and user-signed spot swaps |
| PoolFactory | 0x4947243CC818b627A5D06d14C4eCe7398A23Ce1A | Read: captured pool fee |
| MUSD/BTC pool | 0xd16A5Df82120ED8D626a1a15232bFcE2366d6AA9 | Read: reserves and quote cross-check |
| BTC token | 0x7b7C000000000000000000000000000000000000 | Pool identity; exact user-signed approvals |
| TroveManager | 0xE47c80e8c23f6B4A1aE41c34837a0599D5D16bb0 | Read: borrower debt, collateral and ratios |
| BorrowerOperations | 0xCdF7028ceAB81fA0C6971208e83fa7872994beE5 | Wallet-signed BTC deposit, MUSD repayment and guarded MUSD borrowing |
| HintHelpers | 0x4e4cBA3779d56386ED43631b4dCD6d8EacEcBCF6 | Read: fresh Trove insertion hints |
| SortedTroves | 0x722E4D24FD6Ff8b0AC679450F3D91294607268fA | Read: fresh insertion hints and redemption ordering |
| PriceFeed | 0x86bCF0841622a5dAC14A313a15f96A95421b9366 | Read: fixed-block BTC price |
Payment: browser → Permit2/EIP-2612 signature → facilitator → exact proxy → MUSD Transfer to the configured merchant → gateway checks canonical receipt and confirmations → report delivery. See the browser and gateway adapters. The public merchant is 0xd7F52d1Ddb5dC8678191f14E439Fc5DB67541535, supplied through LIQVERA_PAY_TO, with no built-in payment default.
| Historical successful 0.01 MUSD payment | UTC |
|---|---|
| 0x53808fff…117c | 2026-10-13 13:13:09 |
| 0x4a04dc72…8455 | 2026-10-01 01:37:33 |
| 0xc5344f48…cb6f | 2026-10-01 00:12:04 |
One-minute inspection:
- Open liqvera.site and its wallet-free preview.
- Open the DEX comparison, then the Trove risk tab → Show sealed Trove example. Follow the captured block and contract links in the explorer.
- Open a payment above and inspect the MUSD Transfer:
10000000000000000atomic units, or 0.01 MUSD. - Download the preview evidence ZIP, install the local packages, then run
liqvera-evidence-verify evidence.zip→INTEGRITY_REPRODUCED. - Inspect the Trove risk report and free CLI: borrower debt, collateral, ICR, MCR crossing and proven redemption position. Fresh web preparation and the x402 paywall are verified; historical transfers remain the payment proof. No registry contract is deployed.
Mezo quotes use exact arithmetic, the captured on-chain fee and no gas. Hyperliquid is a perpetual market; Mezo is spot. Testnet liquidity is not representative of executable Mainnet prices. ABI and source provenance.
A headline price tells you where the market is. Liqvera shows how a hypothetical buy or sell would fill against the available liquidity: the average price, filled quantity, worst price and price impact.
Built for analysts, researchers and developers, each report combines public Hyperliquid BTC perpetual market data with exact arithmetic and portable evidence. Explore the result in your browser, export it for analysis or reproduce the calculations independently.
| What you get | Why it matters |
|---|---|
| Market-depth analysis | See how order size changes the calculated fill and price impact |
| Timestamped source snapshot | Know which market data the report uses |
| Downloadable JSON | Bring structured results into your own tools |
| Evidence ZIP | Keep the source inputs, report and integrity hashes together |
| Offline verification | Check the evidence and reproduce the calculations locally |
| MUSD payments through x402 | Purchase access to an individual report with your wallet |
After preparing a report, check the selected wallet’s MUSD balance, exact shortfall and estimated purchase budget. Download a block-bound funding check or open the official Mezo Borrow application after reviewing its separate loan risks. Return to the same quote and check again before confirming payment. This extension is available on the public Testnet demo. See Wave 1 changes and evidence.
View the timestamped sample report without connecting a wallet. To request your own:
- Connect your wallet using a browser extension or WalletConnect on your phone.
- Choose buy or sell and a BTC quantity to prepare a fresh report and review its price.
- Confirm the purchase in your wallet on Mezo Testnet.
- Read, download and verify your report. Confirmed access lets you retrieve the same report again without another payment, within its retention period.
The public demo runs on Mezo Testnet (31611). Each report costs 0.01 test MUSD. WalletConnect supports mobile pairing and QR connections; you can manage or disconnect your session from the app.
Market reports describe a hypothetical sweep of available depth. Mezo pool fees are captured and applied; Hyperliquid fees, funding and gas are excluded. Optional Mezo spot swaps and Trove protection transactions are prepared in the browser and submitted only after the user signs in a wallet. Liqvera does not trade perpetuals or custody keys; risk output is not financial advice.
Liqvera connects market capture, report generation and MUSD payment in one web application. Payment access is bound to the exact report and evidence hashes. The offline verifier checks bundle integrity and recomputes results from the included inputs.
Stack: TypeScript · Python · PostgreSQL · Reown AppKit / WalletConnect · x402 · Docker Compose.
| Component | Source |
|---|---|
| Web application | apps/mezo-web |
| API and payment gateway | apps/mezo-gateway |
| Public market capture | services/evidence-capture |
| Report generation and verification | services/evidence-report |
| API contract | OpenAPI specification |
To run the project, clone the repository and follow the startup guide. The Testnet guide covers wallet checkout and deployment; the validation guide provides build and test commands.
Prepare dependencies as described in validation, then:
make test1116 Python tests + 85 subtests, 104 gateway tests and 177 browser tests. The command checks these totals against its completed results, including a new disposable PostgreSQL ledger. Native RPC tests remain opt-in; no wallet payment is part of this gate.
Published Trove verification includes native preparation, the unpaid x402 boundary, independent review and exact image/CI bindings.
Development is tracked publicly in Git. Use the links below to inspect changes, identify a version or review the evidence behind a build.
- Commit history — dated changes and exact commit identifiers.
- Releases — published release notes and assets.
- Version tags — named source versions.
- Compare revisions — review differences between commits, branches or tags.
- Earlier DEX deployment — source e80474e: 1021 Python tests + 85 subtests, 107 browser tests; gateway 74 local passes (13 database tests skipped in hosted CI).
- DEX deployment package refresh — pinned musl/nginx fixes and candidate validation.
- Current validation evidence — Getzilla 2.3.1 source audit of main: selected checks pass, production
packages/linted separately, one Low Bandit configuration gap. - Earlier validation evidence — passing Liqvera audit, failed tool self-check, exact deployment evidence and verification limits.
Product specification · Architecture · Security policy · Buildathon presentation
Built by Dimkox for the Mezo ecosystem.
Trove actions are signed only by the borrower wallet. Liqvera reads fresh state and hints, simulates the call and shows ICR after the action before signing. No MUSD approval is needed: BorrowerOperations burns the repaid MUSD from the caller.
The report panel supports BTC collateral deposits, bounded MUSD repayment and collapsed guarded borrowing. Rescue calculations target an editable ICR, default 1.8. Borrowing must preserve both the safe borrower ratio and the protocol system ratio, and is disabled in Recovery Mode. Every action requires a separate Sign in wallet click after reviewing its preview.
Pending actions survive reloads. Use Check confirmation for an unresolved transaction. Download separate browser action receipts from Actions log; they bind the original report SHA-256 without changing the signed report or evidence ZIP. Prepared before/after values are predictions. Receipt status and separately observed state describe subsequent chain observations. Browser records are local, not server-signed evidence. Implementation design.