Create a Stock Token

Create a six-decimal B20 Asset token with issuer roles, a technical supply ceiling, and issuer-defined security metadata.

Use the B20 Asset variant to represent a class of tokenized shares with configurable precision, issuer roles, supply controls, and metadata. This example creates Example Corp Class A (EXM) with six decimals.

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.

Create and verify the stock token

TypeScript

import { encodeAbiParameters, encodeFunctionData, keccak256, parseAbiParameters, parseEventLogs, stringToBytes } from "viem";
import { account } from "../../shared/clients.js";
import { B20_FACTORY, b20Abi, factoryAbi, role } from "../abi.js";
import { sendContract } from "../write.js";

export async function createStockToken() {
  const salt = keccak256(stringToBytes("example-class-a-v1"));
  const params = encodeAbiParameters(
    parseAbiParameters("(uint8 version,string name,string symbol,address initialAdmin,uint8 decimals)"),
    [{ version: 1, name: "Example Corp Class A", symbol: "EXM", initialAdmin: account.address, decimals: 6 }],
  );
  const initCalls = ["MINT_ROLE", "BURN_BLOCKED_ROLE", "PAUSE_ROLE", "UNPAUSE_ROLE", "OPERATOR_ROLE"].map(
    (name) => encodeFunctionData({ abi: b20Abi, functionName: "grantRole", args: [role(name), account.address] }),
  );
  const receipt = await sendContract({ address: B20_FACTORY, abi: factoryAbi, functionName: "createB20", args: [0, salt, params, initCalls] });
  const [created] = parseEventLogs({ abi: factoryAbi, logs: receipt.logs, eventName: "B20Created" });
  return created.args.token;
}

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

The factory emits B20Created for the Asset variant and returns the deterministic token address.

The supply cap is a technical ceiling, not a representation of authorized or outstanding shares.

See also

• Issue shares · Restrict eligible holders
• Asset variant, Factory, and Supply cap in the B20 standard