Announce a Distribution

Bracket a holder-impacting action with an onchain description and supporting URI. This example announces a five-percent stock dividend and issues additional shares with batchMint in the same transaction.

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.

Announce and Distribute the Stock Dividend

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

export async function announceStockDividend(token: Address, holders: Address[]) {
  const mint = encodeFunctionData({
    abi: assetAbi,
    functionName: "batchMint",
    args: [holders, [parseUnits("30", 6), parseUnits("20", 6)]],
  });
  const id = `dividend-${Date.now()}`;
  await sendContract({
    address: token,
    abi: assetAbi,
    functionName: "announce",
    args: [[mint], id, "Five-percent stock dividend", "https://example.com/actions/dividend"],
  });
  const used = await publicClient.readContract({ address: token, abi: assetAbi, functionName: "isAnnouncementIdUsed", args: [id] });
  if (!used) throw new Error("Announcement was not recorded");
}

    function announceDividend(address token, address[] memory recipients, uint256[] memory amounts) public {
        bytes[] memory calls = new bytes[](1);
        calls[0] = abi.encodeCall(IB20Asset.batchMint, (recipients, amounts));
        IB20Asset(token).announce(
            calls,
            "2026-stock-dividend-01",
            "Five-percent stock dividend",
            "https://example.com/corporate-actions/2026-01"
        );
        require(IB20Asset(token).isAnnouncementIdUsed("2026-stock-dividend-01"), "announcement missing");
    }

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

The unique announcement ID is marked used and the batch mint executes between Announcement and EndAnnouncement.

This example issues additional shares. It does not distribute a cash dividend.

Issue Shares

Mint asset units to holders.

Run a Stock Split

Apply a UI multiplier for stock splits.

Overview

Integrate DeFi

Tokenize Assets

Issue Stablecoins

Accept Payments

Demo

Announce and Distribute the Stock Dividend

See Also

Issue Shares

Run a Stock Split

​Demo

​Announce and Distribute the Stock Dividend

​See Also

Issue Shares

Run a Stock Split

Demo

Announce and Distribute the Stock Dividend

See Also