Burn Supply - Base Documentation

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

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

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");
}

    function burnStablecoin(address token) public {
        uint256 supplyBefore = IB20(token).totalSupply();
        IB20(token).burn(400e6);
        require(supplyBefore - IB20(token).totalSupply() == 400e6, "wrong supply change");
    }

base-cast send "$TOKEN_ADDRESS" "burn(uint256)" 400000000 \
  --rpc-url "$RPC_URL" --private-key "$PRIVATE_KEY"
base-cast call "$TOKEN_ADDRESS" "totalSupply()(uint256)" --rpc-url "$RPC_URL"

See the complete verified B20 examples for imports, client construction, and runnable projects.

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
Burn in the B20 standard

⌘I