跳转到主要内容

安装

从 npm 安装 helius-wallet-kit(Node.js 18+):
所需的对等依赖:
  • react >= 18
  • react-dom >= 18
  • @solana/web3.js ^1.98
next >= 14可选的 对等项 — 如果使用服务器路由处理程序,请安装。

设置

1

将您的应用程序包装在提供者中

在应用程序的根附近的客户端组件中添加 HeliusWalletProvider,并传递您的 Helius API 密钥。这是唯一需要的配置 — SDK 会自动解析您的项目 ID 和无密钥的 Secure RPC URLs。
app/providers.tsx
您可以选择用户在仪表板中看到哪些登录方式 — 请参阅配置登录方式。由于客户端密钥在浏览器中暴露,请通过 RPC 访问控制 使用锁定到您的域的密钥。
2

导入样式

在根布局中导入 SDK 样式表一次:
app/layout.tsx
3

(可选)添加服务器路由处理程序

默认情况下,SDK 直接从浏览器使用您的项目的无密钥 Secure RPC URLs 与 Helius 通信 — 无需服务器路由。要通过自己的服务器路由您的 RPC、发送和交易历史调用(并使用发送器优化着陆和交易历史),将捕获所有的路由处理程序挂载到 /api/helius/[...path]
app/api/helius/[...path]/route.ts
HELIUS_API_KEY 设置为服务器环境变量;处理程序会在这些转发请求中注入它。
钱包 引导程序 仍然在客户端使用您的 apiKey — 它被传递 到提供者 config 并从浏览器发送到 /waas/config — 因此 即使有路由处理程序,密钥仍然存在于浏览器中。请使用 域限制密钥(在仪表板中为密钥设置允许的来源)限定到应用程序的来源,并在需要时轮换密钥。完全 服务器端密钥处理在规划中。

下一步

配置

配置选项和仪表板登录方式。

使用钱包

读取认证状态、签名、发送和读取历史。