Run a Stock Split

Apply a B20 Asset multiplier to update displayed share balances for a stock split without migrating holders.

Run a 2-for-1 stock split by setting the B20 Asset multiplier to 2e18. Raw balances stay unchanged, while scaledBalanceOf and conversion helpers expose the post-split share amounts.

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.

Apply and verify the split multiplier

TypeScript

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

export async function runTwoForOneSplit(token: Address, holder: Address) {
  await sendContract({ address: token, abi: assetAbi, functionName: "updateMultiplier", args: [2n * 10n ** 18n] });
  const multiplier = await publicClient.readContract({ address: token, abi: assetAbi, functionName: "multiplier" });
  const scaled = await publicClient.readContract({ address: token, abi: assetAbi, functionName: "scaledBalanceOf", args: [holder] });
  if (multiplier !== 2n * 10n ** 18n) throw new Error("Multiplier was not updated");
  return scaled;
}

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

multiplier() returns 2e18; raw balances remain unchanged while scaled balances double.

This guide targets Beryl base-std@v1.0.0. Integrations must distinguish raw ERC-20 units from scaled display balances.

See also

• Announce a stock dividend · Pause transfers
• Multiplier in the B20 standard