Issue Units to Holders

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.

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.

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 B20 token standard for the complete interface, roles, and policies.

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.

Restrict Eligible Holders

Gate who can hold with policies.

Announce a Stock Dividend

Record an onchain distribution announcement.

Overview

Integrate DeFi

Tokenize Assets

Issue Stablecoins

Accept Payments

Demo

Issue and Verify the Shares

See Also

Restrict Eligible Holders

Announce a Stock Dividend

​Demo

​Issue and Verify the Shares

​See Also

Restrict Eligible Holders

Announce a Stock Dividend

Demo

Issue and Verify the Shares

See Also