> ## 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. # Приватное состояние и UTXO > Узнайте, как UTXO хранят токены и приватное состояние. Приватный баланс хранится в UTXO (неизрасходованных выходах транзакций). UTXO можно рассматривать как приватные аккаунты токенов SPL с двумя основными отличиями: 1. UTXO не является аккаунтом Solana, поэтому ему не требуется освобождение от ренты. 2. Его баланс зашифрован в блокчейне. Структура данных UTXO похожа на структуру аккаунтов токенов SPL: * **Владелец** — пара ключей Solana, PDA или ключ P-256. * **Актив** — минт (SOL, SPL или Token-2022). * **Количество** — число единиц `asset` в минимальном номинале. * **Данные** — UTXO может хранить произвольные данные, например владельца токенов, переданных на условное депонирование. * **Данные программы и политики** — необязательные настроенные параметры соответствия требованиям Ring. Приватный аккаунт токенов Solana. Программа конфиденциальности Solana владеет приватным аккаунтом токенов, который разворачивается в поля UTXO: владелец, актив, количество, данные, данные политики и идентификатор программы политики.

Приватный аккаунт токенов Solana. Программа конфиденциальности Solana владеет приватным аккаунтом токенов, который разворачивается в поля UTXO: владелец, актив, количество, данные, данные политики и идентификатор программы политики.

Полная запись, хранящаяся для каждого приватного аккаунта токенов Solana, представляет собой плоский UTXO: ```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

, } ``` Исходный код: [Спецификация](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) Аккаунт токенов Solana.

```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, } ``` ## Приватный баланс Приватный баланс — это сумма всех UTXO одного актива, принадлежащих приватному кошельку. Кошелек отображает единый баланс независимо от того, состоит ли приватный баланс из одного или нескольких UTXO. В одной приватной передаче можно израсходовать несколько UTXO. Приватный кошелек соединен пунктирными линиями с несколькими UTXO, каждый из которых содержит определенное количество одного актива. Баланс кошелька равен сумме UTXO.

Приватный кошелек соединен пунктирными линиями с несколькими UTXO, каждый из которых содержит определенное количество одного актива. Баланс кошелька равен сумме UTXO.

## Приватная передача Приватные передачи с UTXO работают иначе, чем публичные передачи с аккаунтами токенов SPL: * Передача из аккаунта токенов SPL обновляет `amount`. * Приватная передача с UTXO не обновляет `amount` UTXO. Вместо этого приватные передачи расходуют существующие UTXO и создают новые UTXO для получателя и оставшегося баланса отправителя. При этом с точки зрения пользователя публичные передачи с аккаунтами токенов Solana и приватные передачи с UTXO выглядят одинаково. Например, у Алисы есть 50 USDC, и она отправляет Бобу 35 USDC. * При использовании аккаунтов токенов SPL значение `amount` Алисы уменьшается с 50 до 15, а значение Боба увеличивается на 35. * При использовании UTXO Алисе принадлежит один UTXO на 50 USDC. Транзакция расходует существующий UTXO и создает два новых: один на 35 USDC для Боба и один на 15 USDC для Алисы. Расходование одного UTXO

| | Аккаунт токенов Solana | Приватный аккаунт токенов Solana (UTXO) | | - | - | - | | Баланс | Значение `amount` в аккаунте | Сумма всех неизрасходованных UTXO, каждый из которых содержит фиксированное количество одного актива | | Расходование | Обновляет поле `amount` | Делает израсходованные UTXO недействительными и создает новый UTXO | | Видимость | Публично доступен в блокчейне | Зашифрован в блокчейне | ### Выбор UTXO Для приватных передач SDK выбирает неизрасходованные UTXO, покрывающие сумму, которую вы хотите передать. Алгоритм выбора UTXO расходует минимально возможное количество UTXO на одну передачу: 1. SDK фильтрует ваши UTXO по отправляемому активу и сортирует их по количеству. 2. SDK выбирает столько UTXO, сколько необходимо для покрытия суммы передачи. Сначала он выбирает самые крупные UTXO, пока сумма передачи не будет покрыта. Например, Алиса отправляет Бобу 80 USDC. Трех ее крупнейших UTXO достаточно для покрытия передачи: Алиса отправляет 80 USDC. Ее UTXO отсортированы от крупнейшего к наименьшему: 40, 25, 20, 10 и 5 USDC. SDK выбирает UTXO на 40, 25 и 20 USDC, которые покрывают 80 USDC, а UTXO на 10 и 5 USDC остаются невыбранными.

Алиса отправляет 80 USDC. Ее UTXO отсортированы от крупнейшего к наименьшему: 40, 25, 20, 10 и 5 USDC. SDK выбирает UTXO на 40, 25 и 20 USDC, которые покрывают 80 USDC, а UTXO на 10 и 5 USDC остаются невыбранными.

Меньшее количество UTXO позволяет сократить размер транзакции. Каждый израсходованный UTXO добавляет 66 байт для аккаунта нуллификатора, который помечает UTXO как израсходованный. Этот аккаунт не позволяет повторно израсходовать UTXO. Примеры приватных передач без дополнительных данных или других инструкций: | Израсходовано UTXO | Размер транзакции | Аккаунты | | - | - | - | | 2 | 927 байт | 6 | | 5 | 1 125 байт | 9 | | 36 | 3 055 байт | 40 | ### Варианты транзакций Каждая приватная передача использует вариант транзакции: фиксированное количество слотов для расходуемых и создаваемых UTXO. Варианты предусматривают от 1 до 36 расходуемых UTXO, и у каждого варианта есть собственная ZK-схема. Схема доказывает, что расходуемые UTXO действительны, а новые UTXO содержат ту же общую сумму. Если для передачи требуется более 36 UTXO, [сначала объедините их](#объединение-utxo). SDK выбирает подходящий для передачи вариант и заполняет неиспользуемые слоты фиктивными UTXO. Фиктивные UTXO не содержат ценности и выглядят в блокчейне как настоящие UTXO. Алиса отправляет Бобу 30 USDC. Ее крупнейший UTXO покрывает передачу. UTXO Алисы на 40 USDC расходуется, а ее UTXO на 25, 20, 10 и 5 USDC остаются неизрасходованными. Транзакция создает 30 USDC для Боба и 10 USDC для Алисы.

UTXO Алисы на 40 USDC расходуется, а ее UTXO на 25, 20, 10 и 5 USDC остаются неизрасходованными. Транзакция создает 30 USDC для Боба и 10 USDC для Алисы.

Алиса отправляет Бобу 60 USDC. Два ее крупнейших UTXO покрывают передачу. UTXO Алисы на 40 и 25 USDC расходуются, а ее UTXO на 20, 10 и 5 USDC остаются неизрасходованными. Транзакция создает 60 USDC для Боба и 5 USDC для Алисы.

UTXO Алисы на 40 и 25 USDC расходуются, а ее UTXO на 20, 10 и 5 USDC остаются неизрасходованными. Транзакция создает 60 USDC для Боба и 5 USDC для Алисы.

Алиса отправляет Бобу 80 USDC. Три ее крупнейших UTXO покрывают передачу. SDK заполняет неиспользуемый слот фиктивным UTXO. UTXO Алисы на 40, 25 и 20 USDC расходуются, а ее UTXO на 10 и 5 USDC остаются неизрасходованными. Транзакция создает 80 USDC для Боба, 5 USDC для Алисы и один фиктивный UTXO на 0 USDC в неиспользуемом слоте.

UTXO Алисы на 40, 25 и 20 USDC расходуются, а ее UTXO на 10 и 5 USDC остаются неизрасходованными. Транзакция создает 80 USDC для Боба, 5 USDC для Алисы и один фиктивный UTXO на 0 USDC в неиспользуемом слоте.

Алиса отправляет Бобу 95 USDC. Четыре ее крупнейших UTXO покрывают передачу. SDK заполняет два неиспользуемых слота фиктивными UTXO. UTXO Алисы на 40, 25, 20 и 10 USDC расходуются, а ее UTXO на 5 USDC остается неизрасходованным. Транзакция создает 95 USDC для Боба и два фиктивных UTXO на 0 USDC в неиспользуемых слотах.

UTXO Алисы на 40, 25, 20 и 10 USDC расходуются, а ее UTXO на 5 USDC остается неизрасходованным. Транзакция создает 95 USDC для Боба и два фиктивных UTXO на 0 USDC в неиспользуемых слотах.

| Израсходовано UTXO | Новые UTXO | | - | - | | 1 | 1, 2 или 8 | | 2 | 2 или 3 | | 3 | 3 | | 4 | 3 или 4 | | 5 | 3 или 4 | | 36 | 2 | Исходный код: [Спецификация](https://github.com/helius-labs/zolana/blob/a3ddedda42b40d4951ae8fcdde2500374c4f2125/docs/spec.md#circuit-variants) · [Поддерживаемые варианты](https://github.com/helius-labs/zolana/blob/a3ddedda42b40d4951ae8fcdde2500374c4f2125/program-libs/interface/src/shape.rs) ## Объединение UTXO Получение множества переводов без расходования средств может фрагментировать приватный баланс между множеством UTXO. Если для передачи требуется более 36 UTXO, сначала объедините их, чтобы пользователь мог израсходовать весь баланс за одну передачу. Большинство пользователей редко сталкиваются с фрагментированным балансом, поскольку одна передача может израсходовать до 36 UTXO. * При объединении UTXO с одинаковыми владельцем и активом преобразуются в один UTXO с той же общей стоимостью. * При объединении нельзя расходовать средства или менять владельца. * Объединение может выполняться автоматически, не влияя на взаимодействие конечных пользователей с приложением. Операция объединения расходует пять UTXO Алисы по 1 USDC каждый и создает для Алисы один новый UTXO на 5 USDC.

Операция объединения расходует пять UTXO Алисы по 1 USDC каждый и создает для Алисы один новый UTXO на 5 USDC.

Три UTXO Алисы по 100 USDC одновременно финансируют три передачи — по одному UTXO на каждую передачу.

Один UTXO можно израсходовать только один раз. Ограничения пропускной способности протокола описаны в разделе [Дерево Меркла состояния и Forester](/docs/ru/privacy/concepts/architecture#дерево-меркла-состояния-и-forester). ## Подробнее Rings, гарантии конфиденциальности и поток транзакций. Как взаимодействуют кошельки, службы RPC и программы Solana. Как шифруются активы и какую роль играет защищенная пара ключей. Узнайте, как настроить пользовательский Ring. ## Не нашли то, что искали? Свяжитесь с нами! [Telegram](https://t.me/tilo_light) | [Электронная почта](mailto:sales@helius.xyz) | [Контакты](https://www.helius.dev/contact) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.