SuperAPI AI 工具集

quicknode-sdk-patterns

通用与其它

查看项目

更新于 10-15 23:28

技能介绍

用途:指导把现有 QuickNode 相关代码迁移到统一 SDK 架构,用一个配置好的 QuicknodeSdk 实例及其具名产品客户端,而不是把它与链特定的 ethers 或 viem 提供者混为一谈,也不应把旧的仅 Core 示例当成新的多产品服务架构。

主要能力与分工:账户资源走 admin,Tooling Access RPC 走 rpc,数据管道走 streams,模板订阅走 webhooks,游标状态走 kvstore,索引查询走 sql;链特定端点 RPC 应放在独立适配器后面。典型流程包括用 Read、Grep 审计既有的 @quicknode/sdk、Core、直接调用 api.quicknode.com、超时重试和重复 API Key 配置,并把链 RPC 提供者与产品客户端分开归类。

使用方式:先确认当前 SDK 平台矩阵,再安装经审查且固定版本的 @quicknode/sdk,保留 lockfile 变更,不要在生产自动化中使用不设上限的 latest。构造一次配置边界并注入应用模块:

import { QuicknodeSdk } from '@quicknode/sdk';

export const quicknode = QuicknodeSdk.fromEnv();

同时设置有限的 HTTP 超时,基础 URL 覆盖仅限本地测试或已批准的分级代理。密钥使用 QN_SDK__API_KEY 的 secret 引用。在适配器边缘 mock SDK,并在受保护环境中添加一个只读集成测试,校验类型化错误处理,禁止日志包含 API Key 或完整端点 URL。

限制与注意:浏览器及不受支持的原生目标需要服务端边界或直接使用有文档的 API,不能假定某台开发机上能安装的包在所有运行时都能加载。无明确操作授权时不要执行破坏性的 Admin、Stream、Webhook 方法。原生模块加载失败时重新核对平台矩阵和部署目标;返回 401 时检查 QN_SDK__API_KEY 与账户角色;产品基础 URL 错误时移除误配的生产覆盖;旧 Core API 冲突时隔离旧链调用并通过适配器迁移。其余细节暂未提供。