> ## 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.
# State Privat dan UTXO
> Pelajari cara UTXO menyimpan token dan state privat.
Saldo privat disimpan dalam UTXO (output transaksi yang belum dibelanjakan).
Anda dapat menganggap UTXO sebagai akun token SPL privat, dengan dua perbedaan utama:
1. UTXO bukan akun Solana sehingga tidak memerlukan pembebasan biaya sewa.
2. Saldonya dienkripsi secara onchain.
Tata letak data UTXO serupa dengan akun token SPL:
* **Pemilik** – keypair Solana, PDA, atau kunci P-256.
* **Aset** – mint (SOL, SPL, atau Token-2022).
* **Jumlah** – jumlah unit `asset`, dalam unit terkecilnya.
* **Data** – UTXO dapat menyimpan data arbitrer, misalnya pemilik token yang ditempatkan dalam escrow.
* **Data program dan kebijakan** – kepatuhan Ring terkonfigurasi yang bersifat opsional.
Rekaman lengkap yang disimpan untuk setiap Akun Token Solana Privat adalah UTXO datar:
```rust theme={"system"}
struct Utxo {
/// Constant separating UTXOs from other Poseidon-hashed data.
domain: u16,
/// Recipient's `owner_hash` from their Shielded Address.
/// Senders write this value directly; the spender supplies the preimage
/// components as proof witness.
owner: [u8; 32],
/// Asset mint. SOL is Address::default().
asset: Address,
/// Amount in the smallest unit of `asset`.
amount: u64,
/// Random bytes ensuring distinct UTXO hashes for equal
/// `(owner, asset, amount)` triples.
blinding: [u8; 31],
/// Arbitrary program data.
program_data: Option>,
/// Arbitrary policy data.
policy_data: Option>,
/// The policy program that authorizes spends of this UTXO.
policy_program_id: Option,
}
```
Lihat kode sumber: [Spesifikasi](https://github.com/helius-labs/zolana/blob/680667f27cf9ba4203a0b69284f4c304b874092f/docs/spec.md#utxo) · [sdk-libs/transaction/src/utxo/note.rs](https://github.com/helius-labs/zolana/blob/680667f27cf9ba4203a0b69284f4c304b874092f/sdk-libs/transaction/src/utxo/note.rs#L16)
```rust theme={"system"}
pub struct Account {
/// The mint associated with this account
pub mint: Pubkey,
/// The owner of this account.
pub owner: Pubkey,
/// The amount of tokens this account holds.
pub amount: u64,
/// If `delegate` is `Some` then `delegated_amount` represents
/// the amount authorized by the delegate
pub delegate: COption,
/// The account's state
pub state: AccountState,
/// If is_native.is_some, this is a native token, and the value logs the
/// rent-exempt reserve. An Account is required to be rent-exempt, so
/// the value is used by the Processor to ensure that wrapped SOL
/// accounts do not drop below this threshold.
pub is_native: COption,
/// The amount delegated
pub delegated_amount: u64,
/// Optional authority to close the account.
pub close_authority: COption,
}
```
## Saldo Privat
Saldo privat adalah jumlah seluruh UTXO dari satu aset yang dimiliki oleh dompet privat.
Dompet menampilkan satu saldo, terlepas dari apakah saldo privat
terdiri dari satu atau beberapa UTXO.
Transfer privat dapat membelanjakan beberapa UTXO sekaligus.
## Transfer Privat
Transfer privat dengan UTXO bekerja secara berbeda dari transfer publik dengan akun token SPL:
* Transfer dari akun token SPL memperbarui `amount`.
* Transfer privat dengan UTXO tidak memperbarui `amount` milik UTXO.
Sebagai gantinya, transfer privat membelanjakan UTXO yang ada
dan membuat UTXO baru untuk penerima serta sisa saldo pengirim.
Namun, bagi pengguna, transfer publik dengan akun token Solana
dan transfer privat dengan UTXO terasa serupa.
Sebagai contoh, Alice memiliki 50 USDC dan mengirimkan 35 USDC kepada Bob.
* Dengan akun token SPL, `amount` milik Alice berkurang dari 50 menjadi 15, sedangkan milik Bob bertambah 35.
* Dengan UTXO, Alice memiliki satu UTXO senilai 50 USDC. Transaksi membelanjakan UTXO yang ada dan membuat dua UTXO baru: satu senilai 35 USDC untuk Bob dan satu senilai 15 USDC untuk Alice.
| | Akun token Solana | Akun token Solana privat (UTXO) |
| - | - | - |
| Saldo | `amount` dalam akun | Jumlah seluruh UTXO yang belum dibelanjakan, masing-masing dengan jumlah tetap dari satu aset |
| Pembelanjaan | Memperbarui bidang `amount` | Membatalkan UTXO yang telah dibelanjakan dan membuat UTXO baru |
| Visibilitas | Publik secara onchain | Dienkripsi secara onchain |
### Pemilihan UTXO
Untuk transfer privat, SDK memilih UTXO yang belum dibelanjakan dan mencukupi jumlah yang ingin Anda transfer.
Algoritma pemilihan UTXO membelanjakan sesedikit mungkin UTXO per transfer:
1. SDK memfilter UTXO Anda berdasarkan aset yang dikirim dan mengurutkannya berdasarkan jumlah.
2. SDK memilih UTXO sebanyak yang diperlukan untuk mencukupi jumlah transfer.
SDK memilih UTXO terbesar terlebih dahulu hingga jumlah transfer tercukupi.
Sebagai contoh, Alice mengirimkan 80 USDC kepada Bob. Tiga UTXO terbesarnya cukup untuk mencakup transfer tersebut:
Jumlah UTXO yang lebih sedikit menjaga ukuran transaksi tetap kecil.
Setiap UTXO yang dibelanjakan menambahkan 66 byte untuk akun nullifier, yang menandai UTXO sebagai telah dibelanjakan.
Akun tersebut mencegah UTXO dibelanjakan kembali.
Contoh transfer privat tanpa data tambahan atau instruksi lainnya:
| UTXO yang dibelanjakan | Ukuran transaksi | Akun |
| - | - | - |
| 2 | 927 byte | 6 |
| 5 | 1.125 byte | 9 |
| 36 | 3.055 byte | 40 |
### Varian Transaksi
Setiap transfer privat menggunakan varian transaksi: jumlah slot tetap untuk UTXO yang akan dibelanjakan dan UTXO baru yang akan dibuat.
Varian berkisar dari 1 hingga 36 UTXO yang dibelanjakan, dan setiap varian memiliki sirkuit ZK tersendiri.
Sirkuit tersebut membuktikan bahwa UTXO yang dibelanjakan valid dan UTXO baru menyimpan jumlah total yang sama.
Jika transfer memerlukan lebih dari 36 UTXO, [gabungkan terlebih dahulu](#menggabungkan-utxo).
SDK memilih varian yang sesuai dengan transfer dan mengisi slot yang tidak digunakan dengan UTXO dummy.
UTXO dummy tidak menyimpan nilai dan terlihat seperti UTXO asli secara onchain.
Alice mengirimkan 30 USDC kepada Bob. UTXO terbesarnya mencukupi transfer tersebut.
Alice mengirimkan 60 USDC kepada Bob. Dua UTXO terbesarnya mencukupi transfer tersebut.
Alice mengirimkan 80 USDC kepada Bob. Tiga UTXO terbesarnya mencukupi transfer tersebut. SDK mengisi slot yang tidak digunakan dengan UTXO dummy.
Alice mengirimkan 95 USDC kepada Bob. Empat UTXO terbesarnya mencukupi transfer tersebut. SDK mengisi dua slot yang tidak digunakan dengan UTXO dummy.
| UTXO yang dibelanjakan | UTXO baru |
| - | - |
| 1 | 1, 2, atau 8 |
| 2 | 2 atau 3 |
| 3 | 3 |
| 4 | 3 atau 4 |
| 5 | 3 atau 4 |
| 36 | 2 |
Lihat kode sumber: [Spesifikasi](https://github.com/helius-labs/zolana/blob/a3ddedda42b40d4951ae8fcdde2500374c4f2125/docs/spec.md#circuit-variants) · [Varian yang didukung](https://github.com/helius-labs/zolana/blob/a3ddedda42b40d4951ae8fcdde2500374c4f2125/program-libs/interface/src/shape.rs)
## Menggabungkan UTXO
Menerima banyak transfer tanpa melakukan pembelanjaan dapat memecah saldo privat ke banyak UTXO.
Jika transfer memerlukan lebih dari 36 UTXO, gabungkan terlebih dahulu agar pengguna dapat membelanjakan seluruh saldo dalam satu transfer.
Sebagian besar pengguna jarang menemui saldo yang terfragmentasi karena satu transfer dapat membelanjakan hingga 36 UTXO.
* Penggabungan menyatukan UTXO dengan pemilik dan aset yang sama menjadi satu UTXO dengan nilai total yang sama.
* Penggabungan tidak dapat membelanjakan dana atau mengubah pemilik.
* Penggabungan dapat dilakukan secara internal tanpa memengaruhi UX pengguna akhir.
Jumlah penggabungan yang diperlukan untuk membelanjakan seluruh saldo dalam satu transfer bergantung pada jumlah UTXO yang menyimpannya:
| UTXO dalam saldo | Penggabungan sebelum transfer | Transfer |
| - | - | - |
| 1 hingga 36 | Tidak ada | Satu transfer membelanjakan setiap UTXO |
| 37 | 1 penggabungan dari 2 UTXO | Satu transfer dengan 36 UTXO |
| 100 | 2 penggabungan dari 36 UTXO, secara paralel | Satu transfer dengan 30 UTXO |
| 1.296 | 36 penggabungan dari 36 UTXO, secara paralel | Satu transfer dengan 36 UTXO |
Setiap penggabungan merupakan satu transaksi Solana dengan bukti ZK dan mengubah hingga 36 UTXO menjadi satu.
Karena hasil penggabungan bersifat deterministik, bukti penggabungan dan bukti transfer dibuat secara paralel.
### Contoh Penggunaan Instruksi Penggabungan
Aplikasi Anda dapat melakukan penggabungan pada dua tahap:
* **Saat menyinkronkan saldo privat:** ketika dompet dibuka kuncinya, dompet privat dibuka, aplikasi dilanjutkan, jaringan tersambung kembali, terjadi celah stream, atau dompet dipulihkan.
* **Sebelum transfer:** ketika transfer memerlukan lebih dari 36 UTXO.
Penggabungan berjalan tanpa tanda tangan pengguna. Ring kustom menetapkan izin penggabungannya sendiri.
Saat menggunakan dompet privat tersemat, penggabungan dilakukan untuk Anda secara internal.
Sebagai contoh, dompet privat menyimpan 1.296 USDC dalam 1.296 UTXO setelah menerima 1.296 transfer privat yang masing-masing bernilai 1 USDC.
Satu transfer dapat membelanjakan maksimal 36 UTXO, sehingga dompet membelanjakan saldo dalam dua tahap:
1. Sebanyak 36 transaksi penggabungan berjalan secara paralel dan membuat 36 UTXO yang masing-masing bernilai 36 USDC.
2. Satu transfer dengan 36 input membelanjakan seluruh saldo 1.296 USDC.
Lihat kode contoh: [sdk-tests/client/rust/optimized\_merge\_transfer.rs](https://github.com/helius-labs/zolana/blob/1be5fe5c8865badd2852617d18a8f5ca06b592f1/sdk-tests/client/rust/optimized_merge_transfer.rs) · [sdk-tests/client/typescript/optimized-merge-transfer.test.ts](https://github.com/helius-labs/zolana/blob/1be5fe5c8865badd2852617d18a8f5ca06b592f1/sdk-tests/client/typescript/optimized-merge-transfer.test.ts)
## Konkurensi UTXO
Pengguna dapat membelanjakan saldo privat segera setelah transaksi berstatus final.
Saldo privat dapat dibelanjakan secara bersamaan ketika terbagi di beberapa UTXO. Setiap UTXO dapat dibelanjakan dalam transaksi terpisah pada saat yang sama. Sebagai contoh, saldo yang terdiri dari tiga UTXO senilai 100 USDC dapat mendanai tiga transfer hingga 100 USDC sekaligus. Dompet memilih UTXO yang akan dibelanjakan.
Satu UTXO hanya dapat dibelanjakan satu kali.
Untuk batas throughput protokol, lihat [State Merkle Tree dan Forester](/docs/id/privacy/concepts/architecture#pohon-merkle-status-dan-forester).
## Pelajari Lebih Lanjut
Ring, jaminan privasi, dan alur transaksi.
Cara dompet, layanan RPC, dan program Solana berinteraksi.
Cara aset dienkripsi dan peran keypair terlindung.
Pelajari cara mengonfigurasi Ring kustom.
## Tidak menemukan yang Anda cari?
Hubungi kami! [Telegram](https://t.me/tilo_light) | [Email](mailto:sales@helius.xyz) | [Kontak](https://www.helius.dev/contact)
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.