
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, 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.