musd-kit

The typed SDK for MUSD on Mezo

The layer between connected and working, the Trove lifecycle, the insertion-hint dance, and the MUSD math, made correct, typed, and reusable.

Get started

API Reference ↗

GitHub

Correct by construction

Live position data is read from the contract's own getters (never recomputed client-side); previews are dual-validated against forked Mezo and the contract's pure helpers.

Framework-agnostic core + React hooks

@musd-kit/core has no UI runtime; @musd-kit/react adds wagmi-idiomatic hooks that consume Passport's context, no provider of its own.

Typed errors

Every protocol revert maps to a discriminated MusdError you can branch on, BelowMinimumDebt, ICRBelowMCR, RecoveryModeRestriction, and more.

⚠️ Community tooling, not official. musd-kit is independent, open-source, and not affiliated with or endorsed by Mezo. An unofficial community Mezo MUSD SDK. Status: pre-1.0, for testnet and evaluation. License: MIT.

Passport connects the wallet; musd-kit operates MUSD. Mezo ships @mezo-org/passport for connecting a wallet; musd-kit is the layer in between, how an app opens a Trove, reads a position's health, computes borrowing power, and manages a loan.

npm install @musd-kit/core viem
# React (pinned to the Passport ecosystem, wagmi 2.x / React 18):
npm install @musd-kit/react wagmi@^2 @tanstack/react-query@^5 react@^18