viem

monad-ts

TypeScript library for Monad-specific protocol features. Provides Viem actions for interacting with the staking precompile and WMON token on Monad.

Installation

bun add @monad-crypto/viem

npm install @monad-crypto/viem

Quick Start

import { createPublicClient, http } from "viem";
import { monad } from "viem/chains";
import { monadActions } from "@monad-crypto/viem";

const client = createPublicClient({
  transport: http("https://rpc.monad.xyz"),
  chain: monad,
}).extend(monadActions());

const validator = await client.staking.getValidator({ args: [10] });
console.log(validator);

const epoch = await client.staking.getEpoch();
console.log(epoch);

const balance = await client.wmon.getBalanceOf({ args: ["0x..."] });
console.log(balance);

API Reference

Staking

All actions query the staking precompile at Staking.ADDRESS (0x0000000000000000000000000000000000001000).

Action	Description
getValidator	Get details for a validator by ID
getDelegator	Get delegator information
getDelegations	Get all delegations for an address
getDelegators	Get all delegators for a validator
getConsensusValidatorSet	Get the current consensus validator set
getExecutionValidatorSet	Get the current execution validator set
getSnapshotValidatorSet	Get the snapshot validator set
getEpoch	Get the current epoch info
getProposerValId	Get the current block proposer's validator ID
getWithdrawalRequest	Get withdrawal request details

Constants: Staking.ADDRESS, Staking.abi

WMON

All actions query the wrapped Monad token at Wmon.ADDRESS (0x3bd359C1119dA7Da1D913D1C4D2B7c461115433A).

Action	Description
getBalanceOf	Get the WMON balance of an address
getAllowance	Get the WMON allowance for a spender

Constants: Wmon.ADDRESS, Wmon.DECIMALS, Wmon.NAME, Wmon.SYMBOL, Wmon.abi

Links

• Monad Staking Precompile Docs

Please submit security reports through the Monad.xyz UI Bug Bounty Program: https://cantina.xyz/bounties/a3806410-4f70-4023-8b29-103ddbd5b8a3