> ## 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.
# Estado privado e UTXOs
> Saiba como as UTXOs armazenam tokens e estado privado.
Um saldo privado é armazenado em UTXOs (saídas de transação não gastas).
Você pode considerar as UTXOs como contas privadas de tokens SPL, com duas diferenças principais:
1. Uma UTXO não é uma conta da Solana, portanto não precisa de isenção de aluguel.
2. Seu saldo é criptografado on-chain.
O layout de dados da UTXO é semelhante ao das contas de tokens SPL:
* **Proprietário** – par de chaves da Solana, PDA ou chave P-256.
* **Ativo** – o mint (SOL, SPL ou Token-2022).
* **Quantidade** – o número de unidades de `asset`, em sua menor unidade.
* **Dados** – uma UTXO pode armazenar dados arbitrários, por exemplo, o proprietário de tokens em custódia.
* **Dados do programa e da política** – conformidade opcional configurada do Ring.
O registro completo armazenado para cada conta privada de tokens da Solana é uma UTXO simples:
```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,
}
```
Veja o código-fonte: [Especificação](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 privado
O saldo privado é a soma de todas as UTXOs de um ativo pertencentes a uma carteira privada.
A carteira exibe um único saldo, independentemente de o saldo privado
consistir em uma ou várias UTXOs.
Uma transferência privada pode gastar várias UTXOs de uma só vez.
## Transferência privada
As transferências privadas com UTXOs funcionam de forma diferente das transferências públicas com contas de tokens SPL:
* Uma transferência de uma conta de tokens SPL atualiza o `amount`.
* Uma transferência privada com UTXOs não atualiza o `amount` de uma UTXO.
Em vez disso, as transferências privadas gastam UTXOs existentes
e criam novas UTXOs para o destinatário e para o saldo restante do remetente.
Ainda assim, para o usuário, as transferências públicas com contas de tokens da Solana
e as transferências privadas com UTXOs parecem semelhantes.
Por exemplo, Alice tem 50 USDC e envia 35 USDC para Bob.
* Com contas de tokens SPL, o `amount` de Alice diminui de 50 para 15, e o de Bob aumenta em 35.
* Com UTXOs, Alice possui uma UTXO de 50 USDC. A transação gasta a UTXO existente e cria duas novas UTXOs: uma com 35 USDC para Bob e outra com 15 USDC para Alice.
| | Conta de tokens da Solana | Conta privada de tokens da Solana (UTXO) |
| - | - | - |
| Saldo | O `amount` na conta | A soma de todas as UTXOs não gastas, cada uma com uma quantidade fixa de um ativo |
| Gasto | Atualiza o campo `amount` | Invalida as UTXOs gastas e cria uma nova UTXO |
| Visibilidade | Público on-chain | Criptografado on-chain |
### Seleção de UTXOs
Para transferências privadas, o SDK seleciona UTXOs não gastas que cobrem a quantidade que você deseja transferir.
O algoritmo de seleção de UTXOs gasta o menor número possível de UTXOs por transferência:
1. O SDK filtra suas UTXOs pelo ativo enviado e as ordena por quantidade.
2. O SDK seleciona quantas UTXOs forem necessárias para cobrir a quantidade da transferência.
Ele seleciona primeiro as maiores UTXOs até que a quantidade da transferência seja coberta.
Por exemplo, Alice envia 80 USDC para Bob. Suas três maiores UTXOs são suficientes para cobrir a transferência:
Menos UTXOs mantêm a transação pequena.
Cada UTXO gasta adiciona 66 bytes para uma conta anuladora, que marca a UTXO como gasta.
A conta impede que a UTXO seja gasta novamente.
Exemplos de transferências privadas sem dados adicionais ou outras instruções:
| UTXOs gastas | Tamanho da transação | Contas |
| - | - | - |
| 2 | 927 bytes | 6 |
| 5 | 1.125 bytes | 9 |
| 36 | 3.055 bytes | 40 |
### Variantes de transação
Toda transferência privada usa uma variante de transação: um número fixo de posições para UTXOs a serem gastas e novas UTXOs a serem criadas.
As variantes abrangem de 1 a 36 UTXOs gastas, e cada variante tem seu próprio circuito ZK.
O circuito comprova que as UTXOs gastas são válidas e que as novas UTXOs contêm a mesma quantidade total.
Se uma transferência precisar de mais de 36 UTXOs, [mescle-as primeiro](#mesclagem-de-utxos).
O SDK escolhe uma variante adequada à transferência e preenche as posições não utilizadas com UTXOs fictícias.
As UTXOs fictícias não têm valor e se parecem com UTXOs reais on-chain.
Alice envia 30 USDC para Bob. Sua maior UTXO cobre a transferência.
Alice envia 60 USDC para Bob. Suas duas maiores UTXOs cobrem a transferência.
Alice envia 80 USDC para Bob. Suas três maiores UTXOs cobrem a transferência. O SDK preenche a posição não utilizada com uma UTXO fictícia.
Alice envia 95 USDC para Bob. Suas quatro maiores UTXOs cobrem a transferência. O SDK preenche as duas posições não utilizadas com UTXOs fictícias.
| UTXOs gastas | Novas UTXOs |
| - | - |
| 1 | 1, 2 ou 8 |
| 2 | 2 ou 3 |
| 3 | 3 |
| 4 | 3 ou 4 |
| 5 | 3 ou 4 |
| 36 | 2 |
Veja o código-fonte: [Especificação](https://github.com/helius-labs/zolana/blob/a3ddedda42b40d4951ae8fcdde2500374c4f2125/docs/spec.md#circuit-variants) · [Variantes compatíveis](https://github.com/helius-labs/zolana/blob/a3ddedda42b40d4951ae8fcdde2500374c4f2125/program-libs/interface/src/shape.rs)
## Mesclagem de UTXOs
Receber muitas transferências sem gastar pode fragmentar o saldo privado entre várias UTXOs.
Se uma transferência precisar de mais de 36 UTXOs, mescle-as primeiro para que o usuário possa gastar todo o saldo em uma única transferência.
A maioria dos usuários raramente encontrará um saldo fragmentado, pois uma transferência pode gastar até 36 UTXOs.
* Uma mesclagem combina UTXOs do mesmo proprietário e ativo em uma única UTXO com o mesmo valor total.
* Uma mesclagem não pode gastar fundos nem alterar o proprietário.
* A mesclagem pode ser feita nos bastidores sem afetar a experiência dos usuários finais.
O número de mesclagens necessárias para gastar todo o saldo em uma única transferência depende de quantas UTXOs o contêm:
| UTXOs no saldo | Mesclagens antes da transferência | Transferência |
| - | - | - |
| 1 a 36 | Nenhuma | Uma transferência gasta todas as UTXOs |
| 37 | 1 mesclagem de 2 UTXOs | Uma transferência com 36 UTXOs |
| 100 | 2 mesclagens de 36 UTXOs, em paralelo | Uma transferência com 30 UTXOs |
| 1.296 | 36 mesclagens de 36 UTXOs, em paralelo | Uma transferência com 36 UTXOs |
Cada mesclagem é uma transação da Solana com uma prova ZK e transforma até 36 UTXOs em uma.
Como o resultado da mesclagem é determinístico, as provas de mesclagem e a prova da transferência são geradas em paralelo.
### Exemplo de uso da instrução de mesclagem
Seu aplicativo pode realizar a mesclagem em dois momentos:
* **Ao sincronizar o saldo privado:** no desbloqueio da carteira, na abertura da carteira privada, na retomada do aplicativo, na reconexão da rede, em uma lacuna no stream ou na restauração da carteira.
* **Antes de uma transferência:** quando a transferência precisar de mais de 36 UTXOs.
As mesclagens são executadas sem a assinatura do usuário. Rings personalizados definem suas próprias permissões de mesclagem.
Ao usar a carteira privada integrada, a mesclagem é feita para você nos bastidores.
Por exemplo, uma carteira privada contém 1.296 USDC em 1.296 UTXOs após receber 1.296 transferências privadas de 1 USDC.
Uma transferência gasta no máximo 36 UTXOs, portanto a carteira gasta o saldo em duas etapas:
1. 36 transações de mesclagem são executadas em paralelo e criam 36 UTXOs de 36 USDC cada.
2. Uma transferência com 36 entradas gasta todo o saldo de 1.296 USDC.
Veja o código de exemplo: [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)
## Concorrência de UTXOs
Os usuários podem gastar saldos privados assim que as transações forem finalizadas.
Um saldo privado pode ser gasto simultaneamente quando está dividido entre várias UTXOs. Cada UTXO pode ser gasta em uma transação separada ao mesmo tempo. Por exemplo, um saldo de três UTXOs de 100 USDC cada pode financiar simultaneamente três transferências de até 100 USDC. A carteira seleciona quais UTXOs gastar.
Uma única UTXO só pode ser gasta uma vez.
Para conhecer os limites de throughput do protocolo, consulte [Árvore de Merkle de estado e Forester](/docs/pt-BR/privacy/concepts/architecture#árvore-de-merkle-de-estado-e-forester).
## Saiba mais
Rings, garantias de privacidade e fluxo de transações.
Como carteiras, serviços RPC e programas da Solana interagem.
Como os ativos são criptografados e a função do par de chaves protegido.
Saiba como configurar um Ring personalizado.
## Não encontrou o que estava procurando?
Entre em contato! [Telegram](https://t.me/tilo_light) | [E-Mail](mailto:sales@helius.xyz) | [Typeform](https://form.typeform.com/to/LPFASU8a)
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.