> ## 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.

# Cấu hình WaaS

> Cấu hình trình cung cấp Helius wallet-kit và chọn phương thức đăng nhập từ bảng điều khiển

## Cấu hình trình cung cấp

Truyền một đối tượng `HeliusWalletConfig` vào thuộc tính `config` của trình cung cấp — xem [Thiết lập](/docs/vi/waas/quickstart#thiết-lập).

<ParamField path="apiKey" type="string">
  Khóa API Helius của bạn. **Không cung cấp khóa này trong môi trường production** — hãy gắn [trình xử lý
  route](/docs/vi/waas/quickstart#thiết-lập) để khóa được giữ ở phía máy chủ. Chỉ truyền khóa
  để tạo nguyên mẫu nhanh (khi đó khóa sẽ được gửi tới trình duyệt; hãy giới hạn khóa theo tên miền).
</ParamField>

<ParamField path="cluster" type="string">
  Cụm Solana cần kết nối: `"mainnet-beta"` hoặc `"devnet"`.
</ParamField>

<ParamField path="authMethods" type="object">
  Tùy chọn ghi đè phía máy khách đối với các phương thức đăng nhập đang bật. Thông thường, bạn thiết lập
  các phương thức này cho từng dự án trong [bảng điều khiển](https://dashboard.helius.dev), tại **WaaS
  → Configuration** — xem [Cấu hình phương thức đăng nhập](#cấu-hình-phương-thức-đăng-nhập).
</ParamField>

<Note>
  Bạn không cần truyền `projectId` hoặc URL RPC — khi khởi tạo, SDK suy ra mã dự án và
  các URL Secure RPC không cần khóa từ khóa API của bạn.
</Note>

<ParamField path="theme" type="object">
  Tùy chỉnh giao diện người dùng của ví: `darkMode`, `primaryColor`, `borderRadius`,
  `logoLight`, `logoDark`.
</ParamField>

<ParamField path="onError" type="function">
  Hàm callback được gọi khi SDK gặp lỗi: `(error: Error) => void`.
</ParamField>

## Cấu hình phương thức đăng nhập

Chọn các phương thức mà người dùng sẽ thấy trong [bảng điều khiển](https://dashboard.helius.dev),
tại **WaaS → Configuration** — bật hoặc tắt từng phương thức rồi lưu. Các thay đổi sẽ có hiệu lực
vào lần đăng nhập tiếp theo của người dùng; không cần triển khai lại. SDK đọc cấu hình dự án
khi khởi tạo, vì vậy bạn có thể quản lý cấu hình tại một nơi thay vì trong mã.

| Phương thức             | Khóa      | Mặc định   |
| ----------------------- | --------- | ---------- |
| Passkey                 | `passkey` | Bật        |
| Email (mã dùng một lần) | `email`   | Bật        |
| SMS                     | `sms`     | Tắt        |
| Kết nối ví bên ngoài    | `wallet`  | Tắt        |
| Google                  | `google`  | Sắp ra mắt |
| Apple                   | `apple`   | Sắp ra mắt |
| Discord                 | `discord` | Sắp ra mắt |
| X                       | `x`       | Sắp ra mắt |

<Note>
  Hiện tại, bạn có thể tự quản lý passkey, email, SMS và ví bên ngoài trong bảng điều khiển.
  Tính năng đăng nhập qua mạng xã hội (Google, Apple, Discord, X) sẽ sớm ra mắt. Hãy bật ít nhất
  một phương thức, nếu không người dùng sẽ không thể tạo ví. Để ghi đè
  thiết lập của dự án từ mã (ví dụ: theo từng môi trường), hãy truyền `authMethods` vào
  `config` của trình cung cấp.
</Note>

<Note>
  **Ví bên ngoài là một phương thức đăng nhập.** Phương thức này xác thực người dùng vào
  ví Helius tích hợp của họ — việc ký luôn được thực hiện bằng ví tích hợp, không phải
  ví bên ngoài. Xem [Di chuyển từ Privy](/docs/vi/waas/migrating-from-privy#ví-và-tiền-của-người-dùng).
</Note>

## Các bước tiếp theo

<CardGroup cols={2}>
  <Card title="Using the wallet" icon="wallet" href="/docs/vi/waas/using-the-wallet">
    Đọc trạng thái xác thực, ký, gửi và xem lịch sử
  </Card>

  <Card title="Migrating from Privy" icon="arrow-right-arrow-left" href="/docs/vi/waas/migrating-from-privy">
    Di chuyển các ví Privy hiện có sang Helius WaaS
  </Card>
</CardGroup>