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

The demo above is mock only. If you want to see onchain demos on Vibenet, head to Base chain demos.

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