跳到主要内容

原生代币与计量单位

BLUAI 是 OXN 的原生代币。链上余额以"最小单位的无符号整数"存储，与以太坊上 ETH / wei 的约定完全一致。

测试网 vs 主网显示

钱包在测试网上显示代币为 TBLUAI，在主网上显示为 BLUAI。底层资产、小数位、单位换算都相同——只有显示符号不同。本页在描述代币概念时用 BLUAI；钱包连接到测试网时把它替换成 TBLUAI 即可。

单位​

单位对应 wei 值说明
1 wei1最小单位。链上所有数学都用它。
1 gwei1_000_000_000（10⁹）常用于表达 gasPrice。
1 BLUAI1_000_000_000_000_000_000（10¹⁸）钱包与 UI 的显示单位。

JavaScript 中换算​

import { ethers } from "ethers";

// 人类金额 -> wei（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 -> 人类字符串
ethers.formatUnits(oneToken, 18);                      // "1.0"
ethers.formatUnits(500_000_000_000_000_000n, 18);      // "0.5"

Solidity 中换算​

Solidity 有常用面额的字面量后缀：

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

ether 关键字指的是 Solidity 单位系统，不是以太坊代币——它只是 10¹⁸ 的别名。用在 BLUAI 上一样有效（同样是 18 位小数约定）。

显示规范​

在 UI 上显示 BLUAI 金额时：

  • 默认保留 4 位小数：1.2345 BLUAI。
  • 提供一个 "show more precision" 交互展示完整 18 位。
  • 不要截断到 2 位——某些工作流涉及小于 0.01 BLUAI 的金额。
  • 用 BLUAI 符号（不是 blu 或 bluAI 或其他大小写）。
  • 表格中金额左对齐；用等宽字体提高可读性。

零值交易​

value: 0 的交易常见且合法——携带 data 但不移动 BLUAI。gas 费用照付。

原生代币与 ERC-20 代币​

BLUAI 是原生代币——住在协议层、用于付 gas、不需要 ERC-20 合约。

在 OXN 上部署为 ERC-20 合约的自定义代币与 BLUAI 是分开的。ERC-20 代币可能有自己的小数位（通常是 18，但 6 位小数（USDC 风格）和 8 位小数（BTC 挂钩）也常见）。用 IERC20.decimals() 查询。

下一步​