Langsung ke konten utama
API Solana Privacy Rings mengueri pengindeks privasi. API ini mengembalikan status terenkripsi dan metadata transaksi publik. Dompet Anda mendekripsi payload untuk membaca saldo dan riwayat privat. Lihat ikhtisar privasi untuk memahami konsepnya dan SDK untuk alur penyetoran, transfer, dan penarikan.

Saldo Publik dan Privat

Saldo privat disimpan dalam UTXO (output transaksi yang belum dibelanjakan). UTXO bukan akun Solana. Lihat Status Privat dan UTXO untuk memahami cara saldo privat disimpan dan dibelanjakan.

Endpoint dan Autentikasi

Kirim permintaan JSON-RPC 2.0 ke jalur metode dengan kunci API Helius Anda:
method harus cocok dengan segmen terakhir jalur URL. Jalur metode menerima satu permintaan; batch, bidang method duplikat, dan ketidakcocokan jalur/isi mengembalikan HTTP 400 sebelum eksekusi. Untuk pengembangan lokal, gunakan http://127.0.0.1:8784/{method} setelah memulai stack lokal.

Metode

getEncryptedUtxosByTags

Temukan output terenkripsi berdasarkan tag tampilan atau ring.

getShieldedTransactionsByTags

Kueri riwayat transaksi terlindung berdasarkan tag tampilan atau ring.

getShieldedTransactionsBySignature

Ambil peristiwa terlindung untuk satu transaksi Solana.

getShieldedTransactionsByNullifiers

Temukan transaksi yang membelanjakan nullifier yang diberikan.

getMerkleProofs

Ambil bukti penyertaan untuk komitmen pohon status.

getNonInclusionProofs

Ambil bukti nonpenyertaan untuk nilai nullifier.

getNullifierQueueElements

Baca nullifier yang diantrekan berdasarkan urutan sekuens.

getUserRecords

Cari pendaftaran alamat terlindung publik.

Paginasi

getEncryptedUtxosByTags, getShieldedTransactionsByTags, dan getShieldedTransactionsByNullifiers mengembalikan halaman dalam result:
  • data mengelompokkan hasil berdasarkan transaksi Solana, yang diurutkan menurut slot dan tanda tangan secara menaik. Metode UTXO terenkripsi menggunakan array outputs dalam setiap grup; metode riwayat transaksi menggunakan array events.
  • limit menghitung transaksi Solana, dari 1 hingga 1.000, dan nilai bawaannya adalah 1.000. Output atau peristiwa yang cocok dari suatu transaksi tetap berada bersama dalam satu halaman.
  • Kirim kembali paginationToken yang bukan null tanpa perubahan dengan tag atau nullifier, ring, dan filter slot yang sama. Lanjutkan hingga token respons adalah null.
  • filters.slot menerima batas gt, gte, lt, dan lte. Batas yang diberikan digabungkan dengan AND. Setelah pembacaan tanpa batas mencapai token null, simpan context.slot halaman tersebut dan lanjutkan nanti dengan mengatur filters.slot.gt ke nilai itu. Pembacaan yang dibatasi oleh lt atau lte hanya mencakup slot hingga batas tersebut; lanjutkan dari batas itu, bukan dari context.slot.
  • Atur minContextSlot untuk mewajibkan slot pengindeks persisten minimum. Pengindeks juga memerlukan slot dari paginationToken Anda dan dari setiap filter gt atau gte. Jika pengindeks tertinggal dari salah satunya, pengindeks mengembalikan kesalahan -32016 dengan error.data.contextSlot; coba lagi setelah pengindeks menyusul.
Respons riwayat juga dapat menyertakan outputTreeId, yaitu ID pohon status terbaru yang tidak dijeda. Nilai ini dihilangkan jika tidak tersedia. Setiap output mengidentifikasi pohonnya sendiri dengan outputContext.treeId. getNullifierQueueElements menggunakan paginasi berbasis sekuens; lihat halaman metodenya.

Pengodean Data

Kesalahan

Periksa bidang error JSON-RPC sebelum membaca result, termasuk saat status HTTP adalah 200. HTTP 429 menunjukkan pembatasan laju; lihat batas laju. Lihat autentikasi untuk menyiapkan kunci API.