WaaS 配置

提供者配置

传递一个 HeliusWalletConfig 对象到提供者的 config 属性 — 请参见设置。

apiKey

string

必填

您的 Helius API 密钥。用于验证 RPC、交易发送和 WaaS 引导。

cluster

string

要连接的 Solana 集群："mainnet-beta" 或 "devnet"。

authMethods

object

在客户端选择是否启用登录方法的可选覆盖。通常，您可以在控制台下的 WaaS → Configuration 中为每个项目设置这些选项 — 请参见配置登录方法。

您无需传递 projectId 或 RPC URL — SDK 在引导时根据您的 API 密钥推导出项目 ID 和无密钥的安全 RPC URL。

theme

object

自定义钱包 UI：darkMode, primaryColor, borderRadius, logoLight, logoDark。

onError

function

SDK 遇到错误时调用的回调：(error: Error) => void。

在控制台下的 WaaS → Configuration 选项中选择用户可见的方法 — 打开或关闭每个选项并保存。更改将在用户下次登录时应用；无需重新部署。SDK 在引导时会读取项目的配置，因此可以在一个地方进行管理，而不是在代码中。

密码密钥、邮件、短信和外部钱包今天在控制台中自助服务。社交登录（谷歌、苹果、Discord、X）即将推出。至少保持一种方法启用，否则用户将无法创建钱包。如需从代码中覆盖项目设置（例如每个环境），请传递 authMethods 到提供者 config。

外部钱包是一种登录方法。 它将用户验证到其嵌入的 Helius 钱包中 — 始终使用嵌入的钱包进行签名，而不是外部钱包。参见从 Privy 迁移。