Cancel Blocked Units

Cancel shares from a holder who is already denied by the token’s transfer-sender policy. Removing the holder from an allowlist freezes outgoing transfers; burnBlocked then burns the specified shares and reduces total supply.

Real-world asset (RWA) tokenization is one of many use cases for the B20 Asset standard. The examples on this page use a stock token for illustration; the same flows apply to other asset types.Tokenized securities examples shown for illustration. Base is a general-purpose blockchain; issuance and compliance are the responsibility of the issuer under applicable law.

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.

Cancel and Verify Blocked Shares

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 cancelBlockedShares(token: Address, holder: Address) {
  const amount = parseUnits("100", 6);
  await sendContract({ address: token, abi: b20Abi, functionName: "burnBlocked", args: [holder, amount] });
  return publicClient.readContract({ address: token, abi: b20Abi, functionName: "balanceOf", args: [holder] });
}

    function cancelBlockedShares(address token, address holder) public {
        IB20(token).burnBlocked(holder, 100e6);
    }

base-cast send "$TOKEN_ADDRESS" "burnBlocked(address,uint256)" "$BLOCKED_HOLDER" 100000000 \
  --rpc-url "$RPC_URL" --private-key "$PRIVATE_KEY"
base-cast call "$TOKEN_ADDRESS" "balanceOf(address)(uint256)" "$BLOCKED_HOLDER" --rpc-url "$RPC_URL"

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

The holder balance and total supply each fall by 100 EXM.

burnBlocked destroys shares; it does not move them to the issuer. Block the holder under TRANSFER_SENDER_POLICY first.

Restrict Eligible Holders

Gate who can hold with policies.

Issue Shares

Mint asset units to holders.

Overview

Integrate DeFi

Tokenize Assets

Issue Stablecoins

Accept Payments

Demo

Cancel and Verify Blocked Shares

See Also

Restrict Eligible Holders

Issue Shares

​Demo

​Cancel and Verify Blocked Shares

​See Also

Restrict Eligible Holders

Issue Shares

Demo

Cancel and Verify Blocked Shares

See Also