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:app/layout.tsx
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.
[HeliusWalletKit] WaaS bootstrap failed (…) di konsol
Penyedia tidak dapat menemukan proyek Anda berdasarkan kunci API. Pastikan bahwa:
NEXT_PUBLIC_HELIUS_API_KEYtelah 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.
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.Metode masuk yang salah ditampilkan (misalnya Google muncul, tetapi dompet eksternal tidak ada)
Metode masuk berasal dari konfigurasi proyek Anda di dasbor 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 teruskanauthMethods ke config penyedia untuk menggantinya per lingkungan — lihat Mengonfigurasi 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 dilocalhost 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:
… 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:
app/api/helius/[...path]/route.ts
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.
Transaksi tidak masuk ke mainnet
Tanpa handler rute, pengiriman menggunakan RPC standar, bukan Helius 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, danlocalhost untuk pengembangan — pada bagian RPC Access Control. Lihat Mengamankan kunci Anda.
Masih mengalami masalah?
Discord
Tanyakan kepada komunitas dan tim Helius.
Support
Hubungi dukungan Helius.