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

# Pemecahan Masalah

> Solusi untuk masalah paling umum saat mengintegrasikan dompet tersemat Helius — penataan gaya, proses masuk, penandatanganan, pengiriman, dan akses kunci API.

Masalah umum saat mengintegrasikan SDK [`helius-wallet-kit`](https://www.npmjs.com/package/helius-wallet-kit), serta cara mengatasinya.

## Penyiapan

### Modal dompet tidak memiliki gaya atau tampilannya rusak

Stylesheet SDK tidak dimuat. Impor satu kali di tata letak root Anda:

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

### Nilai hook tidak pernah berubah (terhenti pada `loading`)

`useHeliusWallet()` hanya berfungsi di dalam `HeliusWalletProvider`, dan penyedia harus berupa komponen **klien**. Pastikan penyedia membungkus hierarki komponen Anda dari file yang memiliki `"use client"` di bagian atas — lihat [Penyiapan](/docs/id/waas/quickstart#penyiapan).

### `[HeliusWalletKit] WaaS bootstrap failed (…)` di konsol

Penyedia tidak dapat menemukan proyek Anda berdasarkan kunci API. Pastikan bahwa:

* `NEXT_PUBLIC_HELIUS_API_KEY` telah ditetapkan dan valid.
* Proyek menggunakan **paket berbayar** dengan dompet tersemat yang diaktifkan.
* Jika Anda membatasi kunci berdasarkan domain, origin Anda saat ini berada dalam daftar yang diizinkan — lihat [Mengamankan kunci Anda](/docs/id/waas/securing-your-key).

## Proses masuk

### Pengguna diarahkan ke layar "peningkatan paket", bukan ke dompet

Dompet tersemat memerlukan paket Helius **berbayar**. Jika paket yang ditemukan adalah paket gratis, penyedia akan menampilkan permintaan untuk meningkatkan paket (dan backend juga menolak permintaan di sisi server). Tingkatkan paket proyek di [dasbor](https://dashboard.helius.dev).

### Metode masuk yang salah ditampilkan (misalnya Google muncul, tetapi dompet eksternal tidak ada)

Metode masuk berasal dari konfigurasi proyek Anda di [dasbor](https://dashboard.helius.dev) pada bagian **WaaS → Configuration**. Jika tidak ada metode yang dikonfigurasi untuk suatu proyek, modal akan menggunakan pengaturan default seluruh organisasi. Tetapkan metode yang Anda inginkan di dasbor, atau teruskan `authMethods` ke `config` penyedia untuk menggantinya per lingkungan — lihat [Mengonfigurasi metode masuk](/docs/id/waas/configuration#konfigurasikan-metode-masuk).

### Proses masuk dengan passkey gagal atau menyatakan bahwa passkey belum terdaftar

Passkey terikat pada **domain dan autentikator** tempat passkey dibuat (ini merupakan batasan WebAuthn, bukan batasan Helius). Passkey atau kunci keamanan yang didaftarkan di situs atau perangkat lain tidak dapat mengautentikasi aplikasi Anda. Buat passkey di domain yang sedang Anda uji — perhatikan bahwa passkey yang dibuat di `localhost` terikat pada `localhost` dan tidak akan berlaku di domain deployment Anda.

## Penandatanganan dan pengiriman

### `No wallet available` saat menandatangani

Anda memanggil metode penandatanganan sebelum penyediaan dompet tersemat selesai. Batasi penandatanganan berdasarkan `status === "authenticated"` **dan** `address` yang tidak null:

```tsx theme={"system"}
const { status, address, signMessage } = useHeliusWallet();
const ready = status === "authenticated" && address;
```

### `… failed (HTTP 404). Set secureRpcUrl …, or mount the Helius route handler`

Permintaan **pengiriman** atau **biaya prioritas** ini tidak memiliki tujuan: penyedia tidak menemukan URL Secure RPC saat bootstrap (paket berbayar biasanya mendapatkannya secara otomatis), dan tidak ada handler rute server yang dipasang. Pasang handler rute di `/api/helius/[...path]` dan tetapkan `HELIUS_API_KEY`:

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

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

Lihat [handler rute server](/docs/id/waas/quickstart#penyiapan).

### `getTransactions needs the Helius route handler … it isn't available in direct/secure-URL mode`

Riwayat transaksi hanya tersedia melalui handler rute. Tambahkan handler tersebut seperti yang ditunjukkan di atas.

### `getPriorityFeeEstimate is not available`

Devnet tidak mendukung estimasi biaya prioritas — fitur ini hanya tersedia di mainnet. Lewati pencarian tersebut di devnet; pengiriman tetap berfungsi tanpa biaya prioritas.

```tsx theme={"system"}
if (cluster === "mainnet-beta") {
  const fees = await getPriorityFeeLevels([address]);
}
```

### Transaksi tidak masuk ke mainnet

Tanpa handler rute, pengiriman menggunakan RPC standar, bukan [Helius Sender](/docs/id/sending-transactions/sender), sehingga tidak memanfaatkan pengiriman optimal dari Sender. Pasang handler rute agar transaksi memiliki peluang terbaik untuk masuk ke mainnet. Jika pengiriman gagal sepenuhnya, perbarui blockhash — `recentBlockhash` yang sudah usang akan cepat kedaluwarsa.

## Kunci dan akses

### Panggilan RPC atau API ditolak (401 / 403) setelah kunci Anda dibatasi

Kunci yang dibatasi berdasarkan domain tidak menyertakan origin tempat panggilan dilakukan. Tambahkan setiap origin yang Anda gunakan — produksi, staging, deployment pratinjau, dan `localhost` untuk pengembangan — pada bagian **RPC Access Control**. Lihat [Mengamankan kunci Anda](/docs/id/waas/securing-your-key).

## Masih mengalami masalah?

<CardGroup cols={2}>
  <Card title="Discord" icon="discord" href="https://discord.com/invite/6GXdee3gBj">
    Tanyakan kepada komunitas dan tim Helius.
  </Card>

  <Card title="Support" icon="headset" href="/docs/id/support">
    Hubungi dukungan Helius.
  </Card>
</CardGroup>