Issue Shares - Base Documentation

Distribute shares to multiple holders in one all-or-nothing transaction with B20 Asset’s batchMint. Every recipient must pass the token’s mint-receiver policy, and the combined issuance must stay below its supply cap.

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.

Issue and verify the shares

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

export async function issueShares(token: Address, holders: [Address, Address]) {
  const amounts = [parseUnits("600", 6), parseUnits("400", 6)] as const;
  await sendContract({ address: token, abi: assetAbi, functionName: "batchMint", args: [holders, amounts] });
  const balances = await Promise.all(holders.map((holder) => publicClient.readContract({ address: token, abi: b20Abi, functionName: "balanceOf", args: [holder] })));
  if (balances[0] !== amounts[0] || balances[1] !== amounts[1]) throw new Error("Unexpected issuance balances");
}

    function issueShares(address token, address alice, address bob) public {
        address[] memory recipients = new address[](2);
        recipients[0] = alice;
        recipients[1] = bob;
        uint256[] memory amounts = new uint256[](2);
        amounts[0] = 600e6;
        amounts[1] = 400e6;
        IB20Asset(token).batchMint(recipients, amounts);
    }

base-cast send "$TOKEN_ADDRESS" "batchMint(address[],uint256[])" \
  "[$ALICE,$BOB]" "[600000000,400000000]" --rpc-url "$RPC_URL" --private-key "$PRIVATE_KEY"
base-cast call "$TOKEN_ADDRESS" "balanceOf(address)(uint256)" "$ALICE" --rpc-url "$RPC_URL"

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

Alice holds 600 EXM and Bob holds 400 EXM after the all-or-nothing batch.

The entire batch reverts if lengths differ, a recipient fails policy, or total supply would exceed the cap.

See also

Restrict eligible holders · Announce a stock dividend
Batch mint and Mint in the B20 standard

⌘I