用途:在本地为 QuickNode 或 JSON-RPC 适配器建立确定性的开发与测试循环。默认通过可注入的传输层模拟 QuickNode 协议契约,无需真实令牌即可运行测试,再用一次显式的沙箱只读请求捕捉集成漂移。
主要能力:定位直接端点调用、SDK 构造、全局环境读取、重试、定时器和响应解析,选定一个适配器接缝进行注入;定义成功、HTTP 错误、JSON-RPC 错误、超时、限流、畸形响应和分页等夹具契约,保留请求 ID 与嵌套原因;注入传输、基础 URL、时钟和 sleeper;对真实响应做脱敏,替换端点 URL、令牌、API 密钥、地址和业务载荷,并加入泄漏断言;运行仓库固定的单元与契约测试,默认禁用网络;将沙箱读取置于显式变量或命令之后,校验链身份与形状,限制超时和调用次数,凭据缺失时干净跳过。
使用方式:用 Read/Grep 发现适配器,用 Write/Edit 完成注入与夹具,用 Bash(npm:*) 运行仓库定义的测试。SDK 基础 URL 覆盖仅用于本地桩或已批准的分级端点。
适用场景:需要离线、快速、可重复的 QuickNode 集成测试,同时保留一条受控的真实读取路径。
限制:不得使用生产端点、有资金的签名者或实时写入;单元测试若触网应阻断出站并修复接缝;夹具含令牌需移除并在真实情况下轮换;重试测试不应真实休眠;沙箱与生产的差异需记录并在受保护 CI 中覆盖。前置条件包括现有适配器、仓库测试运行器与夹具约定,以及可选的本地密钥管理器中的非生产只读凭据。