> ## 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. # getEncryptedUtxosByTags > Ambil keluaran UTXO terenkripsi yang cocok dengan tag tampilan atau ring tertentu. ## Keluaran Terenkripsi Gunakan metode ini untuk mendapatkan UTXO terenkripsi agar dapat didekripsi di sisi klien. Dompet Anda mendekripsi keluaran dan menjumlahkan nilai yang belum dibelanjakan untuk setiap aset guna menentukan saldo privatnya. Metode ini sebanding dengan [`getTokenAccountsByOwner`](https://solana.com/docs/rpc/http/gettokenaccountsbyowner) milik Solana, yang mengembalikan akun SPL Token yang dimiliki oleh suatu alamat. Saldo privat disimpan dalam UTXO, bukan akun Solana, sehingga memerlukan metode RPC khusus. Pelajari lebih lanjut tentang [Status Privat dan UTXO](https://www.helius.dev/docs/id/privacy/concepts/utxo.md). Metode ini mengembalikan keluaran yang cocok dalam `result.data`, yang dikelompokkan berdasarkan transaksi Solana. Setiap entri menyertakan `slot` dan `signature` transaksi. Keluaran mencakup teks sandi, tag tampilan, komitmen, ID pohon, dan indeks daun. Respons mencakup keluaran historis yang mungkin telah dibelanjakan. Dompet Anda harus melacak nullifier untuk menentukan saldo yang dapat dibelanjakan. Lihat [panduan saldo privat](https://www.helius.dev/docs/id/privacy/guides/read-balance.md). Array `tags` yang kosong memerlukan `ringProgramId` dan memilih keluaran dari ring tersebut. Jika keduanya disediakan, keluaran harus cocok dengan tag dan ring. Lihat [paginasi dan keterkinian](https://www.helius.dev/docs/id/api-reference/privacy.md#paginasi) untuk batas halaman, token kelanjutan, dan pembacaan inkremental. ## Parameter Permintaan **filters** `object` Batas slot. Lanjutkan pembacaan tanpa batas yang telah tersinkronisasi dengan mengatur `slot.gt` ke `context.slot` halaman terakhir. **filters.slot** `object` Batas slot untuk pembacaan. Batas yang diberikan digabungkan dengan AND. **filters.slot.gt** `number` Hanya sertakan transaksi setelah slot ini. **filters.slot.gte** `number` Hanya sertakan transaksi pada atau setelah slot ini. **filters.slot.lt** `number` Hanya sertakan transaksi sebelum slot ini. **filters.slot.lte** `number` Hanya sertakan transaksi pada atau sebelum slot ini. **limit** `number` (default: 1000) Jumlah maksimum transaksi Solana per halaman, dari 1 hingga 1.000. **minContextSlot** `number` Slot pengindeks persisten minimum yang diperlukan untuk pembacaan ini. Mengembalikan kesalahan JSON-RPC -32016 jika pengindeks tertinggal. **paginationToken** `string` Token kelanjutan dari respons sebelumnya. Kirimkan kembali tanpa perubahan dengan tag, ring, dan filter slot yang sama. **ringProgramId** `string` Batasi hasil pada ring yang diotorisasi oleh ID program ini. Wajib saat tags kosong. **tags** `array` *required* Tag tampilan 32 byte yang dienkode dengan Base58. Maksimal 1.000. Array kosong memerlukan ringProgramId dan memilih ring tersebut. ## OpenAPI ````yaml id/openapi/privacy/getEncryptedUtxosByTags.yaml POST /v1/spr/getEncryptedUtxosByTags openapi: 3.0.3 info: title: API Solana Privacy Rings version: 0.51.2 description: >- API JSON-RPC pengindeks privasi untuk status terenkripsi, riwayat, bukti, dan catatan registri publik. servers: - url: https://devnet.helius-rpc.com description: API Solana Privacy Rings Devnet security: [] paths: /v1/spr/getEncryptedUtxosByTags: post: summary: getEncryptedUtxosByTags description: >- Ambil output UTXO terenkripsi yang cocok dengan tag tampilan atau ring tertentu. operationId: getEncryptedUtxosByTags requestBody: content: application/json: schema: type: object required: - jsonrpc - id - method - params properties: id: type: string description: ID untuk mengidentifikasi permintaan. default: '1' jsonrpc: type: string description: Versi protokol JSON-RPC. enum: - '2.0' default: '2.0' method: type: string description: >- Metode yang akan dipanggil. Harus cocok dengan segmen terakhir jalur URL. enum: - getEncryptedUtxosByTags default: getEncryptedUtxosByTags params: type: object required: - tags properties: filters: allOf: - $ref: '#/components/schemas/HistoryFilters' description: >- Batas slot. Lanjutkan pembacaan tanpa batas yang telah menyusul dengan menetapkan `slot.gt` ke `context.slot` halaman terakhir. limit: type: integer format: uint64 maximum: 1000 minimum: 1 nullable: true default: 1000 description: >- Jumlah maksimum transaksi Solana per halaman, dari 1 hingga 1.000. minContextSlot: type: integer format: uint64 minimum: 0 nullable: true description: >- Slot minimum yang harus sudah dipertahankan oleh pengindeks untuk pembacaan ini. Mengembalikan galat JSON-RPC -32016 jika pengindeks tertinggal. paginationToken: type: string description: >- Token kelanjutan dari respons sebelumnya. Kirimkan kembali tanpa perubahan dengan tag, ring, dan filter slot yang sama. nullable: true ringProgramId: type: string description: >- Batasi hasil pada ring yang diotorisasi oleh ID program ini. Wajib jika tags kosong. nullable: true tags: type: array items: $ref: '#/components/schemas/Hash' description: >- Tag tampilan 32 bita yang dikodekan dengan base58. Maksimal 1.000. Array kosong memerlukan ringProgramId dan memilih ring tersebut. maxItems: 1000 additionalProperties: false example: tags: - '11111111111111111111111111111112' limit: 100 example: jsonrpc: '2.0' id: '1' method: getEncryptedUtxosByTags params: tags: - '11111111111111111111111111111112' limit: 100 required: true responses: '200': description: Respons JSON-RPC. Periksa error sebelum membaca result. content: application/json: schema: type: object required: - jsonrpc - id properties: error: type: object required: - code - message properties: code: type: integer message: type: string data: type: object additionalProperties: true id: type: string description: ID permintaan. jsonrpc: type: string description: Versi protokol JSON-RPC. enum: - '2.0' result: type: object description: >- Satu halaman terbatas dari pembacaan riwayat, dengan paginasi bergaya gTFA. required: - context - data - paginationToken properties: context: $ref: '#/components/schemas/Context' data: type: array items: type: object description: Semua output yang cocok dari satu transaksi Solana. required: - slot - signature - outputs properties: outputs: type: array items: $ref: '#/components/schemas/EncryptedUtxoMatch' signature: $ref: '#/components/schemas/SerializableSignature' slot: type: integer format: uint64 minimum: 0 additionalProperties: false outputTreeId: type: integer format: uint16 description: >- ID pohon status terbaru yang tidak dijeda. Dihilangkan jika tidak tersedia. minimum: 0 paginationToken: type: string description: >- Token untuk halaman berikutnya, null jika tidak ada lagi hasil yang cocok. Pembacaan yang telah menyusul tanpa batas `lt` atau `lte` dilanjutkan nanti dengan `filters.slot.gt` ditetapkan ke `context.slot` halaman ini; pembacaan dengan batas atas hanya mencakup slot hingga batas atasnya. nullable: true example: jsonrpc: '2.0' id: '1' result: context: slot: 4242 blockTime: 1730000000 data: [] paginationToken: null '400': description: >- Ditolak sebelum eksekusi. Ketidakcocokan metode/jalur, kolom metode duplikat, atau permintaan batch mengembalikan -32601. Isi yang tidak dapat dibaca atau terlalu besar mengembalikan -32600. content: application/json: schema: type: object required: - jsonrpc - id - error properties: jsonrpc: type: string enum: - '2.0' id: type: string nullable: true description: >- ID permintaan, atau null jika isi bukan satu panggilan JSON-RPC. error: type: object required: - code - message properties: code: type: integer message: type: string data: type: object additionalProperties: true '429': description: Batas laju terlampaui. content: application/json: schema: type: object required: - jsonrpc - id - error properties: jsonrpc: type: string enum: - '2.0' id: type: string nullable: true description: >- ID permintaan, atau null jika isi bukan satu panggilan JSON-RPC. error: type: object required: - code - message properties: code: type: integer message: type: string data: type: object additionalProperties: true '500': description: Galat server internal. content: application/json: schema: type: object required: - jsonrpc - id - error properties: jsonrpc: type: string enum: - '2.0' id: type: string nullable: true description: >- ID permintaan, atau null jika isi bukan satu panggilan JSON-RPC. error: type: object required: - code - message properties: code: type: integer message: type: string data: type: object additionalProperties: true security: - ApiKeyQuery: [] components: schemas: HistoryFilters: type: object description: Batas slot opsional untuk kueri riwayat. properties: slot: $ref: '#/components/schemas/SlotFilter' additionalProperties: false Hash: type: string description: Hash 32 bita yang dikodekan dengan base58. Context: type: object required: - blockTime - slot properties: blockTime: type: integer format: int64 slot: type: integer format: uint64 description: >- Slot tertinggi yang telah dipertahankan oleh pengindeks, untuk pemeriksaan keterkinian berbasis slot. minimum: 0 EncryptedUtxoMatch: type: object required: - slot - txSignature - txViewingPk - salt - outputSlot properties: outputSlot: $ref: '#/components/schemas/RingsOutputSlot' salt: type: string description: >- Salt AES tingkat transaksi yang digunakan bersama oleh setiap ciphertext output. nullable: true slot: type: integer format: uint64 minimum: 0 txSignature: $ref: '#/components/schemas/SerializableSignature' txViewingPk: type: string description: String bita yang dikodekan dengan base64. nullable: true SerializableSignature: type: string description: Tanda tangan transaksi Solana 64 bita yang dikodekan dengan base58. SlotFilter: type: object description: Batas slot untuk pembacaan. Batas yang diberikan digabungkan dengan AND. properties: gt: type: integer format: uint64 minimum: 0 nullable: true description: Hanya sertakan transaksi setelah slot ini. gte: type: integer format: uint64 minimum: 0 nullable: true description: Hanya sertakan transaksi pada atau setelah slot ini. lt: type: integer format: uint64 minimum: 0 nullable: true description: Hanya sertakan transaksi sebelum slot ini. lte: type: integer format: uint64 minimum: 0 nullable: true description: Hanya sertakan transaksi pada atau sebelum slot ini. additionalProperties: false RingsOutputSlot: type: object required: - viewTag - outputContext - payload properties: outputContext: $ref: '#/components/schemas/RingsOutputContext' payload: $ref: '#/components/schemas/Base64String' viewTag: $ref: '#/components/schemas/Hash' RingsOutputContext: type: object required: - hash - tree - treeId - leafIndex properties: hash: $ref: '#/components/schemas/Hash' leafIndex: type: integer format: uint64 minimum: 0 tree: allOf: - $ref: '#/components/schemas/SerializablePubkey' description: Akun pohon status. Utamakan treeId; akun pohon diturunkan darinya. deprecated: true treeId: type: integer format: uint16 description: ID pohon mentah yang menjadi dasar hash komitmen output. minimum: 0 Base64String: type: string description: String bita yang dikodekan dengan base64. SerializablePubkey: type: string description: Kunci publik Solana yang dikodekan dengan base58. securitySchemes: ApiKeyQuery: type: apiKey in: query name: api-key description: Kunci API Helius Anda. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.