QELT 智能合约验证技能

QELT主网索引器通过REST API提供生产级合约验证。支持500多个Solidity版本、构造函数参数、库链接、多文件合约（75个以上文件）、viaIR编译以及自动EVM版本检测。

API基础地址： https://mnindexer.qelt.ai
速率限制： 每个IP每小时10次验证提交
每个任务超时： 600秒（10分钟）
状态轮询： 无限制——可自由每3-5秒轮询一次

安全事项

• - 请勿提交包含私钥或机密的源代码。
• 验证是永久性的——一旦验证通过，源代码将公开。
• 在提交前务必先检查是否已验证（节省速率限制配额）。
• status: completed 并不表示验证通过——务必检查 result.verified === true。
• 状态轮询无限制——任务仍在处理中时请勿重新提交。

操作流程

1. 检查是否已验证（请先执行此步骤）

bash
curl -fsSL https://mnindexer.qelt.ai/api/v2/contracts/0xCONTRACT/verification

如果 verified: true → 向用户返回现有源代码/ABI，无需提交。

2. 提交单文件合约

bash
curl -fsSL -X POST https://mnindexer.qelt.ai/api/v1/verification/submit \
-H Content-Type: application/json \
-d {
address: 0xCONTRACT,
sourceCode: // SPDX-License-Identifier: MIT\npragma solidity ^0.8.20;\n...,
compilerVersion: 0.8.20,
contractName: MyContract,
optimizationUsed: true,
runs: 200,
evmVersion: shanghai,
constructorArguments: 0x000...,
libraries: {}
}

响应：{ success: true, jobId: uuid, statusUrl: /api/v1/verification/status/uuid }

3. 提交多文件合约（含导入）

适用于使用OpenZeppelin或任何 import 语句的合约：

bash
curl -fsSL -X POST https://mnindexer.qelt.ai/api/v1/verification/submit-multi \
-H Content-Type: application/json \
-d {
address: 0xCONTRACT,
compilerVersion: v0.8.17+commit.8df45f5f,
contractName: MyToken,
optimizationUsed: true,
runs: 200,
viaIR: true,
evmVersion: london,
mainFile: contracts/MyToken.sol,
sourceFiles: {
contracts/MyToken.sol: pragma solidity ^0.8.17; ...,
@openzeppelin/contracts/token/ERC20/ERC20.sol: ...
}
}

4. 轮询状态（无限制）

bash
curl -fsSL https://mnindexer.qelt.ai/api/v1/verification/status/JOB_ID

状态：pending → processing → completed / failed

⚠️ 在 completed 之后，务必验证 result.verified === true：

json
{
status: completed,
result: { verified: true, abi: [...] }
}

verified: false 且 status: completed = 字节码不匹配。

5. 获取编译器版本

bash
curl -fsSL https://mnindexer.qelt.ai/api/v2/verification/compiler-versions

6. 获取EVM版本

bash
curl -fsSL https://mnindexer.qelt.ai/api/v2/verification/evm-versions

EVM版本选择

QELT主网运行EVM Cancun——Solidity 0.8.24+请使用 cancun。

速率限制

速率限制头信息：X-RateLimit-Limit、X-RateLimit-Remaining、X-RateLimit-Reset、Retry-After。

常见错误

最佳实践

1. 1. 提交前先检查——首先使用 GET /api/v2/contracts/:address/verification
2. 任何包含 import 语句的合约使用 /submit-multi
3. 如果在hardhat配置中使用 viaIR: true 编译，请包含 viaIR: true
4. 每3-5秒轮询一次——不要重新提交正在处理的任务

开发者工具

Hardhat插件： npm install --save-dev @qelt/hardhat-verify@latest

bash
npx hardhat qelt:verify --network qelt 0xCONTRACT_ADDRESS

CLI工具： npm install -g qelt-verify → qelt-verify verify 0x... ./Contract.sol --compiler-version 0.8.20 --optimize