Balances shows merchant-level and receiver-level balances derived from settled payments. These balances represent available funds in Meridian’s receiver ledger, not live on-chain wallet balances. Use this view to understand what is ready for withdrawal, what is pending, and how balances roll up across receiver wallets.Documentation Index
Fetch the complete documentation index at: https://docs.mrdn.finance/llms.txt
Use this file to discover all available pages before exploring further.

How balances are calculated
All balances are pulled directly from on-chain reads and contract events.Merchant revenue (by network)
- Source:
InstantSettlementevents from the Meridian contract. - Calculation: Sum of
netAmountfor allInstantSettlementevents whererecipient = your wallet, per network. - Networks: Base, Optimism, Polygon, Unichain, Ink, MegaETH, HyperEVM.
Ready-to-withdraw balance (protocol balance)
- Source:
balanceReadyToWithdrawal(recipient, usdcAddress)on the Meridian contract. - Calculation: Direct contract read returning the amount available to withdraw for the selected recipient and token.
Wallet balance (USDC on each network)
- Source: ERC-20
balanceOf(wallet)for the network’s USDC address. - Calculation: Direct token balance read on each supported network.
MRDN balances
- Current MRDN balance: ERC-20
balanceOf(wallet)on Base mainnet. - Total MRDN earned: Sum of
mrdnAmountfromCashbackPaidevents whererecipient = your wallet(Base mainnet).
Total revenue (top-line)
- Calculation: Sum of merchant revenue across mainnet networks, plus current MRDN balance. Testnet balances are excluded.
What you can monitor
- Available balance: Funds from settled payments that can be withdrawn.
- Pending balance: Payments not yet settled.
- Receiver wallet totals: Balance breakdown by receiver.
- Merchant rollups: Aggregate totals across all receivers in the org.