Skip to main content

​
安装

从 npm 安装 helius-wallet-kit（Node.js 18+）：
所需的对等依赖：
  • react >= 18
  • react-dom >= 18
  • @solana/web3.js ^1.98
下面推荐的路由处理程序设置需要 next >= 14。

​
设置

推荐的设置将您的 Helius API 密钥保留在 服务器端——不会有 Helius 密钥发送到浏览器。只是在本地测试？跳转到原型快捷方式。
1

将应用程序包装在提供程序中

在您的应用程序靠近根部的客户端组件中添加 HeliusWalletProvider。省略 API 密钥——路由处理程序（下一步）在服务器端提供。SDK 会自动解析您的项目 ID 和无密钥的 Secure RPC URL。
app/providers.tsx
2

挂载路由处理程序

在 /api/helius/[...path] 添加全捕获路由处理程序。它在服务器端持有 HELIUS_API_KEY 并代理钱包引导、RPC、发送和注册——因此不会有 Helius 密钥到达浏览器。这也是您获得发送方优化着陆和交易历史的原因。
app/api/helius/[...path]/route.ts
将 HELIUS_API_KEY 设置为服务器环境变量（不是 NEXT_PUBLIC_）；处理程序将其注入转发请求中。
3

导入样式

在根布局中导入 SDK 样式表一次：
app/layout.tsx
您可以选择用户在仪表板中看到的登录方法——请参阅配置登录方法。

​
原型快捷方式

只是在本地尝试？跳过路由处理程序，并将您的 API 密钥直接传递给提供程序：
app/providers.tsx
这会将密钥发送至您的浏览器包，因此仅用于本地测试——在部署之前切换到上面的路由处理程序设置。同时限制密钥的域（参见保护您的密钥）：它无法接触钱包或资金，但公共密钥仍可用于花费您的积分。

​
下一步

配置

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

使用钱包

阅读认证状态、签名、发送和阅读历史记录。