Burn Supply

Retire stablecoin supply on Base when a holder redeems for fiat, keeping circulating supply matched to reserves.

When a holder redeems for fiat, they return the tokens and you burn them, keeping circulating supply matched to reserves. Burning is gated by BURN_ROLE and burns from the caller’s own balance.

Demo

The demo uses a local browser-generated account to submit real transactions on Base Vibenet. If Vibenet or its B20 features are unavailable, it automatically switches to an illustrative offline version.

New to B20? See the B20 Token Standard for the concepts and a full launch walkthrough. These samples target base-std@v1.0.0, viem@2.55.11, and Base Foundry v1.1.1.

Burn and Verify Supply

TypeScript

import { parseUnits, type Address } from "viem";
import { publicClient } from "../../shared/clients.js";
import { b20Abi } from "../abi.js";
import { sendContract } from "../write.js";

export async function burnAndVerify(token: Address) {
  const before = await publicClient.readContract({ address: token, abi: b20Abi, functionName: "totalSupply" });
  const amount = parseUnits("400", 6);
  await sendContract({ address: token, abi: b20Abi, functionName: "burn", args: [amount] });
  const after = await publicClient.readContract({ address: token, abi: b20Abi, functionName: "totalSupply" });
  if (before - after !== amount) throw new Error("Unexpected supply change");
}

See the B20 token standard for the complete interface, roles, and policies.

totalSupply() decreases by exactly 400 MUSD.

burn removes tokens from the caller. Use an allowance and your redemption workflow to collect tokens into the burner account first.

See Also

Mint Supply

Increase circulating supply.

Burn (B20 Standard)

The burn operation in the B20 standard.