README_account_index_converter.md
README_account_index_converter.md
🔄 Account Index 进制转换工具
简介
Lighter API 的 account_index 在不同场景可能使用不同进制:
- API 文档: 通常使用十进制(如:
0,1,123) - 前端界面: 可能显示十六进制(如:
0x0,0x1,0x7b) - 区块链浏览器: 通常使用十六进制
此工具帮助您快速转换这些格式。
🚀 快速开始
交互式模式(推荐)
python tools/convert_account_index.py
然后输入要转换的值即可。
命令行模式
单个转换:
python tools/convert_account_index.py 123456
批量转换:
python tools/convert_account_index.py 0 1 123 0x1e240
📋 使用示例
示例 1: 十进制 → 十六进制
$ python tools/convert_account_index.py 123456
======================================================================
🔄 Lighter Account Index 进制转换工具
======================================================================
📥 输入 (十进制): 123456
📤 输出 (十六进制): 0x1e240
✅ 转换完成!
======================================================================
示例 2: 十六进制 → 十进制
$ python tools/convert_account_index.py 0x1e240
======================================================================
🔄 Lighter Account Index 进制转换工具
======================================================================
📥 输入 (十六进制): 0x1e240
📤 输出 (十进制): 123456
✅ 转换完成!
======================================================================
示例 3: 十六进制(不带0x) → 十进制
$ python tools/convert_account_index.py 1e240
======================================================================
🔄 Lighter Account Index 进制转换工具
======================================================================
📥 输入 (十六进制): 0x1e240
📤 输出 (十进制): 123456
✅ 转换完成!
======================================================================
示例 4: 批量转换
$ python tools/convert_account_index.py 0 1 123 0x7b
======================================================================
🔄 Lighter Account Index 进制转换工具 (批量模式)
======================================================================
【1/4】
======================================================================
🔄 Lighter Account Index 进制转换工具
======================================================================
📥 输入 (十进制): 0
📤 输出 (十六进制): 0x0
✅ 转换完成!
======================================================================
【2/4】
...
示例 5: 交互式模式
$ python tools/convert_account_index.py
======================================================================
🔄 Lighter Account Index 进制转换工具 (交互模式)
======================================================================
💡 使用说明:
- 输入十进制数字(如:123456)
- 输入十六进制数字(如:0x1e240 或 1e240)
- 输入 'q' 或 'quit' 退出
======================================================================
请输入 account_index: 123
======================================================================
🔄 Lighter Account Index 进制转换工具
======================================================================
📥 输入 (十进制): 123
📤 输出 (十六进制): 0x7b
✅ 转换完成!
======================================================================
请输入 account_index: 0x7b
======================================================================
🔄 Lighter Account Index 进制转换工具
======================================================================
📥 输入 (十六进制): 0x7b
📤 输出 (十进制): 123
✅ 转换完成!
======================================================================
请输入 account_index: q
👋 再见!
🎯 实际应用场景
场景 1: Lighter 前端显示的是十六进制
前端显示: Account Index = 0x7b
需要转换为十进制用于 API:
$ python tools/convert_account_index.py 0x7b
输出: 123
在配置文件中使用:
account_index: 123 # 十进制
场景 2: API 文档使用十进制,想验证区块链数据
API 文档: account_index = 123
转换为十六进制查询区块链浏览器:
$ python tools/convert_account_index.py 123
输出: 0x7b
在区块链浏览器中搜索: 0x7b
场景 3: 批量转换配置文件中的值
# 转换多个账户索引
$ python tools/convert_account_index.py 0 1 2 10 100
# 快速获取对应关系
0 → 0x0
1 → 0x1
2 → 0x2
10 → 0xa
100 → 0x64
📚 支持的格式
| 输入格式 | 示例 | 输出格式 |
|---|---|---|
| 十进制 | 123456 |
十六进制 0x1e240 |
| 十六进制(带0x) | 0x1e240 |
十进制 123456 |
| 十六进制(不带0x) | 1e240 |
十进制 123456 |
| 十六进制(大写) | 0X1E240 |
十进制 123456 |
| 负数(十进制) | -123 |
十六进制 -0x7b |
🔧 高级用法
1. 直接在脚本中使用
# 快速转换并复制结果
python tools/convert_account_index.py 123 | grep "输出"
2. 集成到配置脚本
import subprocess
def convert_account_index(value):
result = subprocess.run(
['python', 'tools/convert_account_index.py', str(value)],
capture_output=True,
text=True
)
# 解析输出...
return parsed_value
3. 查看所有示例
python tools/convert_account_index.py --examples
4. 查看帮助
python tools/convert_account_index.py --help
⚠️ 注意事项
1. Lighter API 使用十进制
# ✅ 正确:lighter_config.yaml
account_index: 0 # 十进制
api_key_index: 0 # 十进制
# ❌ 错误:不要在配置文件中使用十六进制
account_index: 0x0 # 会导致 YAML 解析错误
2. 前端显示可能是十六进制
- Lighter 前端界面可能显示
0x0,0x1等 - 需要转换为十进制后填入配置文件
3. 区块链浏览器使用十六进制
- 在区块链浏览器中查询时,需要使用十六进制格式
- 例如:
https://explorer.lighter.xyz/account/0x7b
🛠️ 故障排除
问题 1: "无法识别的输入格式"
原因: 输入的字符串既不是有效的十进制也不是十六进制
解决:
- 确保十进制只包含数字:
0-9 - 确保十六进制只包含:
0-9,a-f,A-F
问题 2: YAML 解析错误
原因: 在 YAML 配置文件中使用了十六进制格式(如 0x0)
解决:
# ❌ 错误
account_index: 0x0
# ✅ 正确
account_index: 0
使用此工具转换为十进制:
$ python tools/convert_account_index.py 0x0
输出: 0
📖 相关文档
docs/lighter/LIGHTER_API_KEY_SETUP_GUIDE.md- API 密钥配置指南docs/lighter/如何获取account_index.md- 如何获取 account_indextools/query_account_simple.py- 查询账户索引工具
✨ 特性总结
- ✅ 自动识别输入格式(十进制/十六进制)
- ✅ 双向转换(十进制 ↔ 十六进制)
- ✅ 支持多种输入格式(带/不带 0x 前缀)
- ✅ 支持批量转换
- ✅ 支持交互式模式
- ✅ 清晰的输出格式
- ✅ 完善的错误处理
🎉 总结
这个工具帮助您:
- ✅ 快速转换
account_index的进制 - ✅ 在不同场景(API、前端、区块链)间切换
- ✅ 避免配置错误
- ✅ 提高配置效率
推荐使用交互式模式,方便快捷!
python tools/convert_account_index.py