@fhenixprotocol/cofhe-errors (英语)

解码固态智能合同错误并立即解决"执行还原"消息

为什么是这个包?

问题: “ 执行还原” 出错

在与"团结"智能合约合作时,你可能遇到了加密错误消息,如:

Error: execution reverted: 0x118cdaa7
Transaction reverted without a reason string
execution reverted

这些错误令人沮丧,因为:

• 不透明:您只获得一个4字节错误选择器(例如, 0x118cdaa7(中文(简体) )
• 难于调试: 没有可读错误信息
• 耗时: 合同代码或区块勘探者的人工查询
• 中断 AI 助手流: Claude Code, Cursor, GitHub 副驾驶等工具没有上下文无法帮助

解决方案:即时错误解码

此软件包提供 即时, 人类可读错误解码 为了你的团结合同。 它将选择者错误地映射到他们的全签名,名称和参数.

不需要安装! 使用 npx 以立即解码出错 :

npx cofhe-errors 0x118cdaa7
# Returns: OwnableUnauthorizedAccount(address)

里面有什么东西

此套件包含:

• 53个自定义错误 从 13份智能合同
• 带有参数类型的完整错误签名
• 原始合同资料
• 快速 CLI 搜索工具
• 程序化 JavaScript/ TypeScript API

覆盖错误

• ACL 阿拉伯法律联盟: 8 个错误
• 地址: 1 出错
• 常见: 2 个错误
• ECDSA 数据交换系统: 3 个错误
• ERC-1967UTIs (英语): 4个错误
• 错误: 4个错误
• 同性恋: 1 出错
• 可升级: 4个错误
• 纯文本图集: 1 出错
• 保险箱: 4个错误
• 字符串: 3 个错误
• 任务管理器: 16个错误
• UUPS 可升级: 2 个错误

QQ 快速启动

不需要安装! 使用 npx 立即运行 :

npx cofhe-errors 0x118cdaa7

可选: 安装供程序使用

只有在您需要导入代码中的错误数据库时才会安装 :

# NPM
npm install @fhenixprotocol/cofhe-errors

# Yarn
yarn add @fhenixprotocol/cofhe-errors

# PNPM
pnpm add @fhenixprotocol/cofhe-errors

QQ 如何使用

命令行接口( CLI)

解码出错选择器

当你看到"执行还原:0x..."

npx cofhe-errors 0x118cdaa7

输出 :

Name:      OwnableUnauthorizedAccount
Selector:  0x118cdaa7
Signature: OwnableUnauthorizedAccount(address)
Source:    ACL
Inputs:    address

按名称搜索错误

当您知道部分错误名称时有用 :

npx cofhe-errors --name Permission

输出 :

0x4c40eccb PermissionInvalid_IssuerSignature (ACL)
0x8e143bf7 PermissionInvalid_RecipientSignature (ACL)
0xcbd3a966 PermissionInvalid_Disabled (ACL)
0xed0764a1 PermissionInvalid_Expired (ACL)

列出所有已知错误

浏览完整错误数据库:

npx cofhe-errors --list

JSON 脚本输出

与您的工具和脚本整合 :

npx cofhe-errors --json 0x118cdaa7

输出 :

{
  "name": "OwnableUnauthorizedAccount",
  "selector": "0x118cdaa7",
  "signature": "OwnableUnauthorizedAccount(address)",
  "source": "ACL",
  "inputs": ["account"],
  "inputTypes": ["address"]
}

程序化 API( JavaScript/ TypeScript)

在应用程序代码中使用 :

const errors = require('@fhenixprotocol/cofhe-errors/errors.json');

// Find error by selector
const error = errors.find(e => e.selector === '0x118cdaa7');
console.log(`Error: ${error.name}`);
console.log(`Signature: ${error.signature}`);

// Search by name
const permissionErrors = errors.filter(e =>
  e.name.toLowerCase().includes('permission')
);

// Get all errors from a specific contract
const aclErrors = errors.filter(e => e.source === 'ACL');

类型脚本支持

错误. json 文件与 TypeScript 无缝:

import errors from '@fhenixprotocol/cofhe-errors/errors.json';

interface SolidityError {
  name: string;
  selector: string;
  signature: string;
  source: string;
  inputs: string[];
  inputTypes: string[];
}

const error = errors.find(e => e.selector === '0x118cdaa7') as SolidityError;

QQ 完整错误引用

错误数据库( 53 个错误)

常见案件

1. 调试失败交易

# Your transaction failed with:
# Error: execution reverted: 0x118cdaa7

# Decode it instantly:
npx cofhe-errors 0x118cdaa7

# Output shows:
# Name: OwnableUnauthorizedAccount
# This means: The caller doesn't have ownership permissions

2. 散装出错分析

# Get all errors from a specific contract
npx cofhe-errors --list | grep "ACL"

# Search for all permission-related errors
npx cofhe-errors --name Permission

3. 监测错误和记录错误

const errors = require('@fhenixprotocol/cofhe-errors/errors.json');

// Decode error from blockchain event
function decodeError(errorData) {
  const selector = errorData.slice(0, 10); // First 4 bytes
  const error = errors.find(e => e.selector === selector);

  if (error) {
    console.log(`Error: ${error.name}`);
    console.log(`Contract: ${error.source}`);
    console.log(`Signature: ${error.signature}`);
  }
}

4. 文档和错误目录

为您的智能合同生成错误文档 :

npx cofhe-errors --list > CONTRACT_ERRORS.md

AI 编码助理

此软件包包括 AI.md 包含AI助手(Claude Code, Cursor, GitHub Copilot等)的详细说明,说明调试工作流程中何时以及如何建议这个工具.

快速引用 : 当你看到 execution reverted: 0x...建议:

npx cofhe-errors <error-selector>

QQ 错误选择器格式

固态自定义错误使用4字节选择器计算为:

selector = keccak256("ErrorName(type1,type2,...)").slice(0, 4)

示例

error OwnableUnauthorizedAccount(address account);

成为:

• 签署: OwnableUnauthorizedAccount(address)
• 选择器 : keccak256("OwnableUnauthorizedAccount(address)") = 0x118cdaa7...
• 前4个字节 : 0x118cdaa7

有关资源

• 固态文档 - 自定义错误
• EIP-7930:自定义错误
• 固态- 过分识别- 行动 - GitHub 生成此软件包的动作

许可证

详情见LICENSE文件.

捐款

找到窃听器还是有什么建议? 请打开GitHub的一期!

软件包版本 : 1.0.2 联合国

产生者: 固态- 过分识别- 行动

SEO 标记 : 固态错误解码器 执行还原 智能合同出错 ethereum解码器 web3 错误处理 固态自定义出错 交易还原 错误选择器查询 区块链解码器 固态 ethereum 出错 智能合同 区块链 解码器 执行还原器 出错解码器 固态-errors,web3