Apply a Multiplier

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.

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.

Apply and Verify the Split Multiplier

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;
}

    function splitStock(address token, address holder) public returns (uint256 scaledBalance) {
        IB20Asset(token).updateMultiplier(2e18);
        require(IB20Asset(token).multiplier() == 2e18, "multiplier not updated");
        scaledBalance = IB20Asset(token).scaledBalanceOf(holder);
    }

base-cast send "$TOKEN_ADDRESS" "updateMultiplier(uint256)" 2000000000000000000 \
  --rpc-url "$RPC_URL" --private-key "$PRIVATE_KEY"
base-cast call "$TOKEN_ADDRESS" "scaledBalanceOf(address)(uint256)" "$HOLDER" --rpc-url "$RPC_URL"

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

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.

Announce a Stock Dividend

Record an onchain distribution announcement.

Pause Transfers

Halt transfers in an emergency.

Overview

Integrate DeFi

Tokenize Assets

Issue Stablecoins

Accept Payments

Demo

Apply and Verify the Split Multiplier

See Also

Announce a Stock Dividend

Pause Transfers

​Demo

​Apply and Verify the Split Multiplier

​See Also

Announce a Stock Dividend

Pause Transfers

Demo

Apply and Verify the Split Multiplier

See Also