> ## Documentation Index
> Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# WaaS 配置

> 配置 Helius wallet-kit 提供者，并从控制台选择登录方法

## 提供者配置

传递一个 `HeliusWalletConfig` 对象到提供者的 `config` 属性 — 请参见[设置](/zh/waas/quickstart#setup)。

<ParamField path="apiKey" type="string" required>
  您的 Helius API 密钥。用于验证 RPC、交易发送和 WaaS 引导。
</ParamField>

<ParamField path="cluster" type="string">
  要连接的 Solana 集群：`"mainnet-beta"` 或 `"devnet"`。
</ParamField>

<ParamField path="authMethods" type="object">
  在客户端选择是否启用登录方法的可选覆盖。通常，您可以在[控制台](https://dashboard.helius.dev)下的 **WaaS → Configuration** 中为每个项目设置这些选项 — 请参见[配置登录方法](#configure-sign-in-methods)。
</ParamField>

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

<ParamField path="theme" type="object">
  自定义钱包 UI：`darkMode`, `primaryColor`, `borderRadius`,
  `logoLight`, `logoDark`。
</ParamField>

<ParamField path="onError" type="function">
  SDK 遇到错误时调用的回调：`(error: Error) => void`。
</ParamField>

## 配置登录方法

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

| 方法        | 键         | 默认值  |
| --------- | --------- | ---- |
| 密码密钥      | `passkey` | 开启   |
| 邮件（一次性代码） | `email`   | 开启   |
| 短信        | `sms`     | 关闭   |
| 连接外部钱包    | `wallet`  | 关闭   |
| 谷歌        | `google`  | 即将推出 |
| 苹果        | `apple`   | 即将推出 |
| Discord   | `discord` | 即将推出 |
| X         | `x`       | 即将推出 |

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

<Note>
  **外部钱包是一种登录方法。** 它将用户验证到其嵌入的 Helius 钱包中 — 始终使用嵌入的钱包进行签名，而不是外部钱包。参见[从 Privy 迁移](/zh/waas/migrating-from-privy#your-users-wallets-and-funds)。
</Note>

## 下一步

<CardGroup cols={2}>
  <Card title="使用钱包" icon="wallet" href="/zh/waas/using-the-wallet">
    阅读认证状态、签名、发送和阅读历史
  </Card>

  <Card title="从 Privy 迁移" icon="arrow-right-arrow-left" href="/zh/waas/migrating-from-privy">
    将现有的 Privy 钱包迁移到 Helius WaaS
  </Card>
</CardGroup>