Convert XNO Units

XNO单位转换

Convert between different XNO cryptocurrency units with BigInt precision. XNO uses 30 decimal places, making floating-point arithmetic unsafe. Always use this skill for accurate conversions.

在不同的XNO加密货币单位之间进行转换，确保BigInt级别的精度。XNO采用30位小数，这使得浮点运算存在精度风险。请始终使用此工具进行精确转换。

Unit Reference

单位参考

Unit	Raw Value	Decimal Places	Description
raw	1	0	Smallest unit (base unit)
mnano	10^24	24	Mega-nano (0.000001 XNO)
knano	10^27	27	Kilonano (0.001 XNO)
XNO	10^30	30	Base unit (1 XNO)

单位	Raw值	小数位数	说明
raw	1	0	最小单位（基础单位）
mnano	10^24	24	Mega-nano（0.000001 XNO）
knano	10^27	27	Kilonano（0.001 XNO）
XNO	10^30	30	基础单位（1 XNO）

Conversion Factors

转换系数

1 XNO    = 1,000 knano = 1,000,000 mnano = 10^30 raw
1 knano  = 1,000 mnano = 10^27 raw
1 mnano  = 10^24 raw

1 XNO    = 1,000 knano = 1,000,000 mnano = 10^30 raw
1 knano  = 1,000 mnano = 10^27 raw
1 mnano  = 10^24 raw

CLI Usage

CLI使用方法

Basic Syntax

基本语法

bash

npx xno-skills convert <amount> <from-unit> --to <to-unit>

bash

npx xno-skills convert <amount> <from-unit> --to <to-unit>

Examples

示例

Convert XNO to raw

将XNO转换为raw

bash

npx xno-skills convert 1 XNO --to raw

bash

npx xno-skills convert 1 XNO --to raw

Output: 1000000000000000000000000000000

输出: 1000000000000000000000000000000

npx xno-skills convert 0.5 XNO --to raw

Output: 500000000000000000000000000000

输出: 500000000000000000000000000000

undefined

undefined

Convert raw to XNO

将raw转换为XNO

bash

npx xno-skills convert 1000000000000000000000000000000 raw --to XNO

bash

npx xno-skills convert 1000000000000000000000000000000 raw --to XNO

Output: 1

输出: 1

npx xno-skills convert 500000000000000000000000000000 raw --to XNO

Output: 0.5

输出: 0.5

undefined

undefined

Convert XNO to knano

将XNO转换为knano

bash

npx xno-skills convert 1 XNO --to knano

bash

npx xno-skills convert 1 XNO --to knano

Output: 1000

输出: 1000

npx xno-skills convert 0.001 XNO --to knano

Output: 1

输出: 1

undefined

undefined

Convert knano to XNO

将knano转换为XNO

bash

npx xno-skills convert 1000 knano --to XNO

bash

npx xno-skills convert 1000 knano --to XNO

Output: 1

输出: 1

npx xno-skills convert 1 knano --to XNO

Output: 0.001

输出: 0.001

undefined

undefined

Convert XNO to mnano

将XNO转换为mnano

bash

npx xno-skills convert 1 XNO --to mnano

bash

npx xno-skills convert 1 XNO --to mnano

Output: 1000000

输出: 1000000

npx xno-skills convert 0.000001 XNO --to mnano

Output: 1

输出: 1

undefined

undefined

Convert mnano to XNO

将mnano转换为XNO

bash

npx xno-skills convert 1000000 mnano --to XNO

bash

npx xno-skills convert 1000000 mnano --to XNO

Output: 1

输出: 1

npx xno-skills convert 1 mnano --to XNO

Output: 0.000001

输出: 0.000001

undefined

undefined

Convert between knano and mnano

在knano和mnano之间转换

bash

npx xno-skills convert 1000 knano --to mnano

bash

npx xno-skills convert 1000 knano --to mnano

Output: 1000000

输出: 1000000

npx xno-skills convert 1 mnano --to knano

Output: 0.001

输出: 0.001

undefined

undefined

Precision Handling

精度处理

Why BigInt?

为什么使用BigInt？

XNO uses 30 decimal places, which exceeds JavaScript's safe integer limit (15-17 digits). Floating-point arithmetic causes precision loss:

javascript

// WRONG - Floating point loses precision
const wrong = 0.1 + 0.2; // 0.30000000000000004

// RIGHT - BigInt maintains precision
const correct = BigInt("1000000000000000000000000000000");

XNO采用30位小数，这超出了JavaScript的安全整数范围（15-17位）。浮点运算会导致精度丢失：

javascript

// 错误示例 - 浮点数丢失精度
const wrong = 0.1 + 0.2; // 0.30000000000000004

// 正确示例 - BigInt保持精度
const correct = BigInt("1000000000000000000000000000000");

Implementation Notes

实现说明

All conversions use BigInt internally - No floating-point operations
Input parsing - Decimal strings converted to BigInt raw units
Output formatting - BigInt raw units converted to requested unit
No precision loss - Exact conversions for any amount

所有转换内部均使用BigInt - 无浮点运算
输入解析 - 将十进制字符串转换为BigInt格式的raw单位
输出格式化 - 将BigInt格式的raw单位转换为目标单位
无精度丢失 - 任何金额都能实现精确转换

Common Precision Pitfalls

常见精度陷阱

javascript

// DON'T use Number for XNO amounts
const wrong = 1.5; // Loses precision at 30 decimals

// DO use string input for CLI
// npx xno-skills convert "1.5" XNO --to raw

javascript

// 不要使用Number类型存储XNO金额
const wrong = 1.5; // 在30位小数场景下会丢失精度

// 请在CLI中使用字符串作为输入
// npx xno-skills convert "1.5" XNO --to raw

Common Use Cases

常见使用场景

Wallet Balance Display

钱包余额展示

bash

undefined

bash

undefined

Convert raw balance to human-readable XNO

将raw余额转换为易读的XNO格式

npx xno-skills convert 500000000000000000000000000000 raw --to XNO

Output: 0.5

输出: 0.5

Convert to knano for smaller display

转换为knano格式以展示更小的数值

npx xno-skills convert 500000000000000000000000000000 raw --to knano

Output: 500

输出: 500

undefined

undefined

Transaction Amounts

交易金额计算

bash

undefined

bash

undefined

Send 0.001 XNO

发送0.001 XNO

npx xno-skills convert 0.001 XNO --to raw

Output: 1000000000000000000000000000

输出: 1000000000000000000000000000

Send 1 knano

发送1 knano

npx xno-skills convert 1 knano --to raw

Output: 1000000000000000000000000000

输出: 1000000000000000000000000000

undefined

undefined

Fee Calculations

手续费计算

bash

undefined

bash

undefined

Calculate fee in raw (e.g., 0.000001 XNO fee)

计算raw格式的手续费（例如0.000001 XNO手续费）

npx xno-skills convert 0.000001 XNO --to raw

Output: 1000000000000000000000000

输出: 1000000000000000000000000

Convert fee to mnano

将手续费转换为mnano格式

npx xno-skills convert 0.000001 XNO --to mnano

Output: 1

输出: 1

undefined

undefined

Large Amounts

大额转换

bash

undefined

bash

undefined

Convert 1 million XNO to raw

将100万XNO转换为raw

npx xno-skills convert 1000000 XNO --to raw

Output: 1000000000000000000000000000000000000

输出: 1000000000000000000000000000000000000

Convert large raw amount to XNO

将大额raw金额转换为XNO

npx xno-skills convert 1000000000000000000000000000000000000 raw --to XNO

Output: 1000000

输出: 1000000

undefined

undefined

Validation

验证机制

Input Validation

输入验证

Amount must be a valid number (integer or decimal)
Unit must be one of:
```
raw
```
,
```
XNO
```
,
```
knano
```
,
```
mnano
```
Negative amounts are supported

金额必须是有效的数字（整数或小数）
单位必须是以下之一：
```
raw
```
,
```
XNO
```
,
```
knano
```
,
```
mnano
```
支持负数金额

Error Handling

错误处理

bash

undefined

bash

undefined

Invalid unit

无效单位

npx xno-skills convert 1 XNO --to bitcoin

Error: Unknown unit 'bitcoin'. Valid units: raw, XNO, knano, mnano

错误提示: 未知单位'bitcoin'。有效单位：raw, XNO, knano, mnano

Invalid amount

无效金额

npx xno-skills convert abc XNO --to raw

Error: Invalid amount 'abc'. Must be a valid number.

错误提示: 无效金额'abc'。必须是有效的数字。

undefined

undefined

Quick Reference

快速参考

bash

undefined

bash

undefined

Most common conversions

最常用的转换

npx xno-skills convert 1 XNO --to raw # 10^30 raw npx xno-skills convert 1 XNO --to knano # 1000 knano npx xno-skills convert 1 XNO --to mnano # 1000000 mnano npx xno-skills convert 1 knano --to XNO # 0.001 XNO npx xno-skills convert 1 mnano --to XNO # 0.000001 XNO npx xno-skills convert 1 raw --to XNO # 0.000000000000000000000000000001 XNO

undefined

npx xno-skills convert 1 XNO --to raw # 10^30 raw npx xno-skills convert 1 XNO --to knano # 1000 knano npx xno-skills convert 1 XNO --to mnano # 1000000 mnano npx xno-skills convert 1 knano --to XNO # 0.001 XNO npx xno-skills convert 1 mnano --to XNO # 0.000001 XNO npx xno-skills convert 1 raw --to XNO # 0.000000000000000000000000000001 XNO

undefined

convert-units

Original

Translation

Convert XNO Units

XNO单位转换

Unit Reference

单位参考

Conversion Factors

转换系数

CLI Usage

CLI使用方法

Basic Syntax

基本语法

Examples

示例

Convert XNO to raw

将XNO转换为raw

Output: 1000000000000000000000000000000

输出: 1000000000000000000000000000000

Output: 500000000000000000000000000000

输出: 500000000000000000000000000000

Convert raw to XNO

将raw转换为XNO

Output: 1

输出: 1

Output: 0.5

输出: 0.5

Convert XNO to knano

将XNO转换为knano

Output: 1000

输出: 1000

Output: 1

输出: 1

Convert knano to XNO

将knano转换为XNO

Output: 1

输出: 1

Output: 0.001

输出: 0.001

Convert XNO to mnano

将XNO转换为mnano

Output: 1000000

输出: 1000000

Output: 1

输出: 1

Convert mnano to XNO

将mnano转换为XNO

Output: 1

输出: 1

Output: 0.000001

输出: 0.000001

Convert between knano and mnano

在knano和mnano之间转换

Output: 1000000

输出: 1000000

Output: 0.001

输出: 0.001

Precision Handling

精度处理

Why BigInt?

为什么使用BigInt？

Implementation Notes

实现说明

Common Precision Pitfalls

常见精度陷阱

Common Use Cases

常见使用场景

Wallet Balance Display

钱包余额展示

Convert raw balance to human-readable XNO

将raw余额转换为易读的XNO格式

Output: 0.5

输出: 0.5

Convert to knano for smaller display

转换为knano格式以展示更小的数值

Output: 500

输出: 500

Transaction Amounts

交易金额计算

Send 0.001 XNO