Skip to main content

Currency and Denominations

BLUAI is the native token of OXN. Balances are stored on-chain as unsigned integers of the smallest unit, exactly like ETH / wei on Ethereum.

Testnet vs mainnet display

Wallets display the token as TBLUAI on testnet and BLUAI on mainnet. The underlying asset, decimals, and unit conversions are identical — only the display symbol differs. This page uses BLUAI when describing the token concept; substitute TBLUAI when your wallet is connected to testnet.

Units​

UnitValue in weiNotes
1 wei1Smallest unit. All on-chain math uses this.
1 gwei1_000_000_000 (10⁹)Common for expressing gasPrice.
1 BLUAI1_000_000_000_000_000_000 (10¹⁸)Display unit for wallets and UIs.

Converting in JavaScript​

import { ethers } from "ethers";

// Human amount -> wei (as bigint)
const oneToken = ethers.parseUnits("1", 18);           // 1_000_000_000_000_000_000n
const halfToken = ethers.parseUnits("0.5", 18);        // 500_000_000_000_000_000n
const gasPrice = ethers.parseUnits("1", 9);            // 1_000_000_000n = 1 gwei

// Wei -> human string
ethers.formatUnits(oneToken, 18);                      // "1.0"
ethers.formatUnits(500_000_000_000_000_000n, 18);      // "0.5"

Converting in Solidity​

Solidity has literal suffixes for common denominations:

uint256 amount = 1 ether;    // 1e18 wei
uint256 gwei = 1 gwei;       // 1e9 wei
uint256 tiny = 1 wei;        // 1 wei

The ether keyword refers to Solidity's unit system, not the Ethereum token — it's just an alias for 10¹⁸. It works identically for BLUAI (which shares the same 18-decimal convention).

Display conventions​

When showing BLUAI amounts in a UI:

  • Default to 4 decimal places: 1.2345 BLUAI.
  • Provide a "show more precision" affordance for the full 18 decimals.
  • Do not truncate to 2 decimals — some workflows involve amounts smaller than 0.01 BLUAI.
  • Use the symbol BLUAI (not blu or bluAI or other casings).
  • Left-align amounts in tables; use monospace fonts for readability.

Zero-value transactions​

Transactions with value: 0 are common and legal — they carry data but move no BLUAI. Gas fees are still paid.

Native token vs ERC-20 tokens​

BLUAI is the native token — it lives at the protocol layer, is used for gas, and does not require an ERC-20 contract.

Custom tokens deployed as ERC-20 contracts on OXN are separate from BLUAI. An ERC-20 token might have its own decimal count (typically 18, but 6 and 8 are common for USDC-style and BTC-pegged tokens respectively). Use IERC20.decimals() to check.

Next steps​