QELT区块链技能

QELT是基于Hyperledger Besu 25.12.0构建的企业级EVM兼容Layer-1，采用QBFT共识机制。5秒出块即时最终性。零基础费用（约$0.002/笔交易）。

主网： 链ID 770 · RPC https://mainnet.qelt.ai
测试网： 链ID 771 · RPC https://testnet.qelt.ai
归档节点（历史数据+TRACE）： https://archivem.qelt.ai

安全须知

• - 切勿请求、存储、打印或传输私钥或助记词。
• 写入操作仅接受预签名原始交易（以0x开头的十六进制字符串）。
• 查询历史/TRACE数据请使用https://archivem.qelt.ai。
• 提交交易前需与用户确认主网或测试网。
• 不要虚构区块号、哈希值或余额——始终获取实时数据。

端点

用途	URL
主网主RPC	https://mainnet.qelt.ai
主网归档+TRACE

https://archivem.qelt.ai | | 测试网RPC | https://testnet.qelt.ai | | 测试网归档 | https://archive.qelt.ai | | 区块浏览器 | https://qeltscan.ai | | 索引器API | https://mnindexer.qelt.ai |

JSON-RPC调用

所有调用均为标准以太坊JSON-RPC 2.0 POST请求。

获取最新区块号

bash
curl -fsSL -X POST https://mainnet.qelt.ai \
-H Content-Type: application/json \
-d {jsonrpc:2.0,method:eth_blockNumber,params:[],id:1}

解析result十六进制 → printf %d\n 。

获取区块

bash

按编号（十六进制）：区块1000 = 0x3e8

curl -fsSL -X POST https://mainnet.qelt.ai \
-H Content-Type: application/json \
-d {jsonrpc:2.0,method:eth_getBlockByNumber,params:[0x3e8,true],id:1}

按哈希值

curl -fsSL -X POST https://mainnet.qelt.ai \ -H Content-Type: application/json \ -d {jsonrpc:2.0,method:eth_getBlockByHash,params:[0xHASH,true],id:1}

获取余额

bash
curl -fsSL -X POST https://mainnet.qelt.ai \
-H Content-Type: application/json \
-d {jsonrpc:2.0,method:eth_getBalance,params:[0xADDRESS,latest],id:1}

将result（wei，十六进制）除以10^18得到QELT数量。

获取交易

bash
curl -fsSL -X POST https://mainnet.qelt.ai \
-H Content-Type: application/json \
-d {jsonrpc:2.0,method:ethgetTransactionByHash,params:[0xTXHASH],id:1}

获取交易收据

bash
curl -fsSL -X POST https://mainnet.qelt.ai \
-H Content-Type: application/json \
-d {jsonrpc:2.0,method:ethgetTransactionReceipt,params:[0xTXHASH],id:1}

status: 0x1 = 成功 · status: 0x0 = 回滚。

调用智能合约（只读）

bash
curl -fsSL -X POST https://mainnet.qelt.ai \
-H Content-Type: application/json \
-d {jsonrpc:2.0,method:eth_call,params:[{to:0xCONTRACT,data:0xCALLDATA},latest],id:1}

估算Gas

bash
curl -fsSL -X POST https://mainnet.qelt.ai \
-H Content-Type: application/json \
-d {jsonrpc:2.0,method:eth_estimateGas,params:[{from:0xFROM,to:0xTO,data:0xDATA,value:0x0}],id:1}

获取事件日志

始终限定区块范围——从创世区块（0x0）开始查询会扫描整个链，通常会被限速或超时。使用近期窗口（例如最近1,000个区块），如需更多历史数据则向前翻页。

bash

首先获取当前区块号

LATEST=$(curl -fsSL -X POST https://mainnet.qelt.ai \
-H Content-Type: application/json \
-d {jsonrpc:2.0,method:eth_blockNumber,params:[],id:1} | python3 -c import sys,json; print(json.load(sys.stdin)[result]))

然后查询限定的近期范围（最近~1000个区块，在QELT上约83分钟）

限制最小值为0，确保起始区块在低高度链上不会为负（例如新测试网）

FROM_HEX=$(python3 -c latest=int($LATEST,16); print(hex(max(0, latest - 1000))))

curl -fsSL -X POST https://mainnet.qelt.ai \
-H Content-Type: application/json \
-d {\jsonrpc\:\2.0\,\method\:\ethgetLogs\,\params\:[{\fromBlock\:\$FROMHEX\,\toBlock\:\latest\,\address\:\0xCONTRACT\,\topics\:[\0xTOPIC\]}],\id\:1}

如需完整历史日志扫描，请使用https://archivem.qelt.ai，并以≤10,000个区块为分页单位，避免超时。

获取合约代码

bash
curl -fsSL -X POST https://mainnet.qelt.ai \
-H Content-Type: application/json \
-d {jsonrpc:2.0,method:eth_getCode,params:[0xCONTRACT,latest],id:1}

0x = 外部账户 · 更长的内容 = 已部署的合约。

获取Nonce

bash
curl -fsSL -X POST https://mainnet.qelt.ai \
-H Content-Type: application/json \
-d {jsonrpc:2.0,method:eth_getTransactionCount,params:[0xADDRESS,latest],id:1}

发送预签名交易

⚠️ 写入操作 — 执行前需与用户确认。

bash
curl -fsSL -X POST https://mainnet.qelt.ai \
-H Content-Type: application/json \
-d {jsonrpc:2.0,method:ethsendRawTransaction,params:[0xSIGNEDTX_HEX],id:1}

成功时返回交易哈希值。

链信息

bash

链ID

curl -fsSL -X POST https://mainnet.qelt.ai \
-H Content-Type: application/json \
-d {jsonrpc:2.0,method:eth_chainId,params:[],id:1}

Gas价格

curl -fsSL -X POST https://mainnet.qelt.ai \ -H Content-Type: application/json \ -d {jsonrpc:2.0,method:eth_gasPrice,params:[],id:1}

网络参考

参数	主网	测试网
链ID	770 (0x302)	771 (0x303)
RPC

https://mainnet.qelt.ai | https://testnet.qelt.ai | | 归档节点 | https://archivem.qelt.ai | https://archive.qelt.ai | | 索引器 | https://mnindexer.qelt.ai | https://tnindexer.qelt.ai | | 出块时间 | 5秒 | 5秒 | | Gas上限 | 50,000,000 | 50,000,000 | | 基础费用 | 0 | 0 | | EVM | Cancun | Cancun | | 测试网水龙头 | — | https://testnet.qeltscan.ai/faucet |

##