> ## 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 SDK 并与一个提供商连接嵌入钱包

## 安装

从 npm 安装 [`helius-wallet-kit`](https://www.npmjs.com/package/helius-wallet-kit)（Node.js 18+）：

```bash theme={"system"}
pnpm add helius-wallet-kit
```

所需的对等依赖：

* `react >= 18`
* `react-dom >= 18`
* `@solana/web3.js ^1.98`

`next >= 14` 是 **可选的** 对等项 — 如果使用服务器路由处理程序，请安装。

## 设置

<Steps>
  <Step title="将您的应用程序包装在提供者中">
    在应用程序的根附近的客户端组件中添加 `HeliusWalletProvider`，并传递您的 Helius API 密钥。这是唯一需要的配置 — SDK 会自动解析您的项目 ID 和无密钥的 Secure RPC URLs。

    ```tsx app/providers.tsx theme={"system"}
    "use client";

    import { HeliusWalletProvider } from "helius-wallet-kit";

    export function Providers({ children }: { children: React.ReactNode }) {
      return (
        <HeliusWalletProvider
          config={{
            apiKey: process.env.NEXT_PUBLIC_HELIUS_API_KEY!,
            cluster: "devnet",
          }}
        >
          {children}
        </HeliusWalletProvider>
      );
    }
    ```

    您可以选择用户在仪表板中看到哪些登录方式 — 请参阅[配置登录方式](/zh/waas/configuration#configure-sign-in-methods)。由于客户端密钥在浏览器中暴露，请通过 [RPC 访问控制](/zh/rpc/protect-your-keys) 使用锁定到您的域的密钥。
  </Step>

  <Step title="导入样式">
    在根布局中导入 SDK 样式表一次：

    ```tsx app/layout.tsx theme={"system"}
    import "helius-wallet-kit/ui/styles.css";
    ```
  </Step>

  <Step title="（可选）添加服务器路由处理程序">
    默认情况下，SDK 直接从浏览器使用您的项目的无密钥 Secure RPC URLs 与 Helius 通信 — 无需服务器路由。要通过自己的服务器路由您的 RPC、发送和交易历史调用（并使用[发送器优化着陆](/zh/sending-transactions/sender)和交易历史），将捕获所有的路由处理程序挂载到 `/api/helius/[...path]`：

    ```ts app/api/helius/[...path]/route.ts theme={"system"}
    import { createHeliusRouteHandler } from "helius-wallet-kit/next";

    export const { GET, POST } = createHeliusRouteHandler();
    ```

    将 `HELIUS_API_KEY` 设置为服务器环境变量；处理程序会在这些转发请求中注入它。

    <Note>
      钱包 **引导程序** 仍然在客户端使用您的 `apiKey` — 它被传递
      到提供者 `config` 并从浏览器发送到 `/waas/config` — 因此
      即使有路由处理程序，密钥仍然存在于浏览器中。请使用
      **域限制密钥**（在仪表板中为密钥设置允许的来源）限定到应用程序的来源，并在需要时轮换密钥。完全
      服务器端密钥处理在规划中。
    </Note>
  </Step>
</Steps>

## 下一步

<CardGroup cols={2}>
  <Card title="配置" icon="sliders" href="/zh/waas/configuration">
    配置选项和仪表板登录方式。
  </Card>

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