SuperAPI AI 工具集

alchemy-common-errors

编程与开发

查看项目

更新于 10-15 22:42

技能介绍

用途:在 Alchemy 调用出现认证、JSON-RPC、Data API、吞吐量或部分响应失败时,先对错误分类,再执行有边界的恢复操作,并在产生实际副作用前产出可复核的证据与负路径结果。

主要能力:捕获时间戳、端点族、网络、方法、脱敏参数、HTTP 状态、JSON-RPC 错误码、响应头、请求 ID、尝试次数与受影响 SLO;将失败归类为本地校验、认证/策略、不支持的方法或网络、吞吐/配额、提供方瞬时故障、确定性 RPC 拒绝、部分响应或下游解析错误;用合成或公开夹具复现并比对当前服务状态与账户用量。

使用方式:先查阅所选产品、链、功能、客户端、认证方式与限额的第一方文档;仅收集凭据指纹或密钥标识,不复制密钥;对无效输入或路由错误直接修正而不重试;对瞬时或吞吐失败在幂等预算内按重试指引处理;对部分成功保留成功分区,仅按文档的新请求契约重试失败分区;验证恢复与耗尽路径,脱敏证据包,持续故障带请求 ID 升级。

适用场景:Alchemy 接口排障、429 与 5xx 处理、Portfolio 类 HTTP 200 内含 partialErrors 的降级判定、重试预算与降级行为设计。

限制:重试无法修复无效参数、不支持的功能或错误凭据类别;不得记录含 API 密钥的请求 URL 或完整用户负载;不得将 HTTP 200 视为可返回部分错误端点的完全成功;技能调用本身不授权网络访问、凭据、钱包地址、客户数据、套餐变更、支出、密钥创建或轮换、webhook 变更、部署、重放、交易构造、签名、广播或删除;吞吐提升、套餐变更、写重放或切换提供方需相应审批。当前限额与方法可用性随账户、产品、网络和时间变化,静态套餐表不具诊断权威性。