Skip to main content
Helius TypeScript SDK (helius-sdk) 使在 TypeScript 中进行 Solana 开发变得更简单——可以在 Node.js、浏览器或任何其他运行时中使用。本页面介绍了如何安装和使用该 SDK、处理常见错误以及在哪里可以找到最新文档。 请注意,自版本 2.0.0 起,SDK 已被重写。这是为了使用 @solana/kit 并移除对版本高于 1.73.2 的 @solana/web3.js 的依赖。迁移到最新版本的用户,请参考我们的迁移指南

GitHub Repository

用于 Solana 开发的官方 Helius TypeScript SDK

安装

Helius TypeScript SDK 可以通过以下任一软件包管理器安装:

快速开始

下面是一个简单的示例,说明如何使用 TypeScript SDK 来获取给定地址所拥有的资产列表:

文档

示例目录 中包含了关于每种方法和基本用法的详细代码示例,按命名空间组织。有关 API 参考文档,请参阅我们的文档官方 Solana 文档以获取一般 Solana JSON RPC API 帮助。有关 Kit 的一般帮助,请参考Kit 的文档

错误处理

当 API 返回非成功(例如 4xx 或 5xx 状态代码)时,将抛出错误消息。 例如,下面是由于错误的 getAsset 调用而抛出的 401 错误:

常见错误代码

使用 Helius SDK 时,可能会遇到多个错误代码。下面的表格详细列出了一些常见的错误代码及附加信息,以帮助您进行故障排除:
请求参数无效时发生。
提供了无效的 API 密钥或由于 RPC 规则访问受限时发生。
表示用户在给定时间内超过请求限制或没有剩余积分。
这是服务器端问题的通用错误消息。请联系 Helius 支持以获得帮助。
如果遇到这些错误:
1

查看错误文档

请参阅 Kit 的错误 以获取可能遇到的错误列表
2

查看文档

请参阅 Helius 文档 以获取进一步指导
3

联系支持

请联系 Helius 支持团队以获取更详细的帮助

贡献

我们欢迎所有对我们的 SDK 的贡献!在开始 pull request 之前,请阅读贡献指南