> ## 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.

# Обзор

> Узнайте, как работает Helius Privacy, включая пользовательские сценарии, общедоступные и приватные данные при переводе, а также кольца с настраиваемыми политиками.

<span id="introduction-to-rings" />

## Введение

Все транзакции в Solana общедоступны: любой пользователь может просматривать адреса, балансы и историю переводов.
Для колец конфиденциальности Solana мы определяем два уровня приватности:

* **Конфиденциальность** — шифрует актив и сумму
* **Анонимность** — шифрует актив, сумму, отправителя и получателя

<img src="https://mintcdn.com/helius/ITnDOhn5GRfQ1FQW/images/privacy/transaction-visibility-cards.svg?fit=max&auto=format&n=ITnDOhn5GRfQ1FQW&q=85&s=2569051cac1c7cba10d4ffabf254577c" alt="Confidential transfers hide the asset and amount. Anonymous transfers also hide the sender and recipient. The transaction hash remains public." width="880" height="248" data-path="images/privacy/transaction-visibility-cards.svg" />

## Кольца конфиденциальности Solana

Кольца — это программируемые защищенные пулы с зашифрованными балансами и выполнением непосредственно в блокчейне Solana.
Одновременно могут существовать разные виды колец:

<CardGroup cols={2}>
  <Card title="Default Ring" icon="lock">
    * Конфиденциальное
    * С самостоятельным хранением средств
    * Не требующее разрешений
    * Без доступа для аудитора
  </Card>

  <Card title="Custom Enterprise Rings" icon="building" href="/docs/ru/privacy/integration/enterprise">
    * Конфиденциальное или анонимное
    * С самостоятельным хранением средств
    * Настраиваемые требования соответствия
    * Доступ для аудитора
  </Card>
</CardGroup>

Для большинства приложений мы рекомендуем стандартное конфиденциальное кольцо, не требующее разрешений.

Используйте настраиваемое кольцо, если вашему приложению нужны собственные требования соответствия, доступ аудитора и средства контроля.
Настраиваемые кольца — это программы Solana, которые определяют разрешения на переводы и дополнительные полномочия, подобно Token-2022.

Стандартное кольцо служит основой для конфиденциальных приложений DeFi и других приложений.
Независимые настраиваемые кольца могут использовать существующие приложения или создавать собственные, одновременно определяя собственные политики,
доступ аудитора и полномочия, применимые только к балансам внутри соответствующего кольца.
Кольца по умолчанию совместимы друг с другом и используют общую ликвидность в экосистеме конфиденциальных DeFi-приложений Solana.

<img src="https://mintcdn.com/helius/ITnDOhn5GRfQ1FQW/images/privacy/privacy-rings-workshop.png?fit=max&auto=format&n=ITnDOhn5GRfQ1FQW&q=85&s=c549ef2c514a89c73af25da87ac0a8cf" alt="Публичные и приватные балансы в Solana: одно кольцо без разрешений рядом с настраиваемыми кольцами 1, 2 и n." width="850" height="370" data-path="images/privacy/privacy-rings-workshop.png" />

## Ключевые свойства

* **Скорость Solana** — компактные <Tooltip tip="Groth16 ZK-SNARKs let Solana verify private transactions without revealing their private data. Proofs are generated server-side using GPUs, or can be generated locally.">доказательства с нулевым разглашением</Tooltip> создаются за десятки миллисекунд, сохраняя привычное взаимодействие для пользователя. Это похоже на еще один вызов RPC.
* **Выполнение в блокчейне** — зашифрованные балансы остаются в Solana. Никаких внешних реестров, сайдчейнов или централизованных секвенсоров.
* **Шифрование любых активов** — кольца поддерживают SOL, токены SPL и токены Token-2022.
* **Самостоятельное хранение средств** — для приватных транзакций всегда требуется подпись владельца.
* **Совместимость со смарт-аккаунтами** — кольца могут поддерживать смарт-аккаунты с собственной логикой авторизации.
* **Компонуемость Solana** — объединяйте взаимодействие с любой программой Solana в одной транзакции.
* **Программируемая приватность** — создавайте приватные эскроу в программах Solana.

## Пользовательские сценарии и гарантии приватности

Пользователи хранят зашифрованный баланс в приватном кошельке. Они могут вносить средства в кольцо, выполнять приватные переводы внутри него или выводить средства, а также взаимодействовать с другими программами Solana в рамках одной транзакции.

<img src="https://mintcdn.com/helius/df3Lmw7POmPkuUJN/images/privacy/privacy-rings-lifecycle.svg?fit=max&auto=format&n=df3Lmw7POmPkuUJN&q=85&s=54d057b2674ad3a194575858d35db167" alt="Public and fiat balances enter a Ring, tokens move between private balances, and users withdraw or off-ramp." width="1420" height="240" data-path="images/privacy/privacy-rings-lifecycle.svg" />

<span id="deposit-to-a-private-balance-what-is-private" />

Пользователи отправляют токены на адрес кошелька Solana так же, как и при работе с публичными балансами.
Любой пользователь может внести средства в любой приватный кошелек, зная только адрес кошелька получателя.

### Внесение средств на приватный баланс

Пользователи могут внести средства на приватный баланс двумя способами:

1. Купить криптовалюту за фиатные средства и зачислить ее на приватный баланс
2. Перевести криптовалюту с публичного баланса на приватный

<Tabs>
  <Tab title="On-ramp from fiat balance">
    | Поле | Видимость |
    | - | - |
    | Актив | Приватный. Зашифрован в блокчейне. |
    | Сумма | Приватная. Зашифрована в блокчейне. |
    | Отправитель | Провайдер ввода фиатных средств. Публичный в конфиденциальном Ring; приватный в анонимном Ring. |
    | Получатель | Пользователь. Публичный в конфиденциальном Ring; приватный в анонимном Ring. |
    | Примечание (необязательно) | Приватное. Зашифровано в блокчейне. |
    | Фиатный баланс и платеж | Не хранятся в блокчейне. Фиатный платеж проводится через провайдера ввода фиатных средств. |

    В отличие от пополнения с публичного баланса, при вводе фиатных средств на приватный баланс актив и сумма остаются приватными. Провайдер переводит средства из своего приватного кошелька в ваш. В конфиденциальном Ring публичны только адреса отправителя и получателя.
  </Tab>

  <Tab title="Deposit from public crypto balance">
    | Поле | Видимость |
    | - | - |
    | Актив | Публичное. Отображается в публичном депозите. |
    | Сумма | Публичное. Отображается в публичном депозите. |
    | Отправитель | Публичное. Адрес исходного кошелька отображается в публичном депозите. |
    | Получатель | Публичное. Адрес целевого кошелька отображается в публичном депозите. |
    | Примечание (необязательно) | Публичное. Публикуется вместе с публичным депозитом. |
    | Итоговый приватный баланс | Приватное. Зашифровано в блокчейне. |
  </Tab>
</Tabs>

<span id="private-transfer-what-is-private" />

### Перевод между приватными балансами

Пользователи могут выполнить приватный перевод двумя способами:

1. Перевести средства внутри одного кольца
2. Перевести средства в другое кольцо

<Tabs>
  <Tab title="Default Ring">
    | Поле | Видимость |
    | - | - |
    | Актив | Приватный. Зашифрован в блокчейне. |
    | Сумма | Приватная. Зашифрована в блокчейне. |
    | Отправитель | Публичный. Кольцо по умолчанию конфиденциально. |
    | Получатель | Публичный. Кольцо по умолчанию конфиденциально. |
    | Примечание (необязательно) | Приватное. Зашифровано в блокчейне. |
  </Tab>

  <Tab title="Custom Rings">
    | Перевод | Актив | Сумма | Отправитель | Получатель | Примечание (необязательно) |
    | - | - | - | - | - | - |
    | В пределах пользовательского конфиденциального кольца | Приватный | Приватная | Публичный | Публичный | Приватное |
    | В пределах пользовательского анонимного кольца | Приватный | Приватная | Приватный | Приватный | Приватное |
    | Из кольца по умолчанию в пользовательское конфиденциальное кольцо или обратно | Приватный | Приватная | Публичный | Публичный | Приватное |
    | Из конфиденциального кольца в пользовательское анонимное кольцо | Приватный | Приватная | Публичный | Приватный | Приватное |
    | Из пользовательского анонимного кольца в конфиденциальное кольцо | Приватный | Приватная | Приватный | Публичный | Приватное |

    Ретранслятор отправляет переводы из анонимных колец, поэтому публичный реестр не раскрывает исходный приватный кошелек. Идентификатор программы пользовательского кольца остается публичным.

    Переводы между кольцами должны соответствовать политике исходного кольца. Одна транзакция может объединять балансы из кольца по умолчанию и одного пользовательского кольца. Перевод между двумя пользовательскими кольцами проходит через кольцо по умолчанию.
  </Tab>
</Tabs>

<span id="withdraw-from-a-private-balance-what-is-private" />

### Вывод средств на публичный баланс

Пользователи могут вывести средства с приватного баланса двумя способами:

1. Обменять приватную криптовалюту на фиатные средства
2. Перевести криптовалюту с приватного баланса на публичный

<Tabs>
  <Tab title="Off-ramp to fiat balance">
    | Поле | Видимость |
    | - | - |
    | Актив | Приватный. Зашифрован в блокчейне. |
    | Сумма | Приватная. Зашифрована в блокчейне. |
    | Отправитель | Пользователь. Публичный в конфиденциальном кольце; приватный в анонимном кольце. |
    | Получатель | Провайдер вывода в фиат. Публичный в конфиденциальном кольце; приватный в анонимном кольце. |
    | Примечание (необязательно) | Приватное. Зашифровано в блокчейне. |
    | Выплата в фиате | Выполняется вне блокчейна. Выплату в фиате проводит провайдер вывода. |

    В отличие от вывода на публичный баланс, при выводе в фиат с приватного баланса актив и сумма остаются приватными. Вы переводите средства из своего приватного кошелька в приватный кошелек провайдера, а провайдер выплачивает вам фиатные средства. В конфиденциальном кольце публичны только адреса отправителя и получателя. Остаток на вашем приватном балансе остается приватным.
  </Tab>

  <Tab title="Withdraw to public crypto balance">
    | Поле | Видимость |
    | - | - |
    | Актив | Публично. Отображается в публичной операции вывода. |
    | Сумма | Публично. Отображается в публичной операции вывода. |
    | Отправитель | Публично в конфиденциальном кольце; скрыто в анонимном кольце. |
    | Получатель | Публично. Адрес кошелька назначения отображается в публичной операции вывода. |
    | Примечание (необязательно) | Скрыто, если прикреплено к зашифрованному выходу. |
    | Итоговый публичный баланс | Публично. Хранится в публичном аккаунте получателя. |
    | Оставшийся приватный баланс | Скрыто. Зашифровано в блокчейне. |
  </Tab>
</Tabs>

## Программируемость и приватные эскроу

Программы Solana могут использовать приватные эскроу для создания конфиденциальных DeFi-приложений.

* **Приватные эскроу** — ZK-программы Solana могут резервировать приватные балансы и определять условия их высвобождения
* **Компонуемость Solana** — объединяйте приватные транзакции с другими программами Solana в одной транзакции
* **Общая ликвидность** — ZK-программы в экосистеме конфиденциальных DeFi-приложений могут использовать общую ликвидность

**Что можно создать**

* **Условные приватные платежи** — резервируйте зашифрованные активы и высвобождайте их по расписанию или после получения необходимых подтверждений. Это позволяет организовать выплату заработной платы, вестинг, поэтапные платежи и приватные рабочие процессы с мультиподписью.
* **Обмен и торговля** — обменивайте обернутые токены, SOL, мемкоины, акции и RWA через приватные эскроу, например при обмене токенов или внебиржевых сделках.
* **Стейкинг и доходность** — создавайте приватные приложения для получения доходности, например пулы стейкинга, токенизированные казначейские активы и другие хранилища доходности.
* **Кредитование и займы** — храните залог в приватных эскроу, например для займов в стейблкоинах, обеспеченных токенизированными активами.

<img src="https://mintcdn.com/helius/ITnDOhn5GRfQ1FQW/images/privacy/programmability.svg?fit=max&auto=format&n=ITnDOhn5GRfQ1FQW&q=85&s=1ead5d736db986e9fedd4a0e51d5a730" alt="Private balances connected by transfer, swap, and lending, with yield and staking above them inside Helius Privacy Rings." style={{ width: "100%" }} width="1000" height="680" data-path="images/privacy/programmability.svg" />

## Общая схема транзакции

<a id="overview" />

Приватный перевод выполняется аналогично публичным переводам в рамках одной транзакции Solana.

<Tabs>
  <Tab title="Private transfer">
    1. Баланс SOL или SPL пользователя шифруется в блокчейне.
    2. Система получает зашифрованное состояние и расшифровывает его локально либо делегированный поставщик расшифровывает и предоставляет расшифрованное состояние.
    3. Кошелек задает сумму и получателя, а затем запрашивает ZK-доказательство.
    4. По умолчанию поставщик RPC создает и возвращает ZK-доказательство. Для настраиваемого кольца также требуется доказательство соблюдения политики.
    5. Кошелек формирует транзакцию Solana. ZK-доказательства проверяются без раскрытия зашифрованного состояния. Вызываемые программы, а также сторона, которая подписывает и отправляет транзакцию, зависят от кольца:

    | | Конфиденциальное кольцо без разрешений | Настраиваемое конфиденциальное кольцо | Настраиваемое анонимное кольцо |
    | - | - | - | - |
    | Вызываемые программы | Программа конфиденциальности Solana | Программа настраиваемого кольца и программа конфиденциальности Solana | Программа настраиваемого кольца и программа конфиденциальности Solana |
    | Подписант | Отправитель подписывает транзакцию. Спонсор газа может оплатить комиссию. | Отправитель подписывает транзакцию. Спонсор газа может оплатить комиссию. | Ретранслятор, чтобы отправитель не был связан с транзакцией. |

    6. Приложение отслеживает статус по хешу транзакции Solana.

    <Tabs sync={false}>
      <Tab title="Permissionless Confidential Ring">
        ```mermaid theme={"system"}
        %%{init: {
          'theme': 'base',
          'themeVariables': {
            'lineColor':           '#FF6B35',
            'primaryTextColor':    '#737373',
            'primaryBorderColor':  '#9CA3AF',
            'actorBkg':            '#FFFFFF',
            'actorBorder':         '#9CA3AF',
            'actorTextColor':      '#737373',
            'signalColor':         '#FF6B35',
            'signalTextColor':     '#737373',
            'labelBoxBkgColor':    '#FF6B351F',
            'labelBoxBorderColor': '#FF6B35',
            'noteBkgColor':        '#F5F5F5',
            'noteTextColor':       '#737373',
            'noteBorderColor':     '#9CA3AF'
          }
        }}%%
        sequenceDiagram
            participant Wallet
            participant RPC as RPC Provider
            participant Solana

            rect rgba(255, 107, 53, 0.06)
                Note left of Wallet: Local
                Wallet->>RPC: Fetch encrypted state
                RPC-->>Wallet: Encrypted state
                Note over Wallet: Decrypt locally
            end
            rect rgba(255, 107, 53, 0.06)
                Note left of Wallet: Delegated
                Wallet->>RPC: Get private balance
                Note over RPC: Decrypt and serve decrypted state
                RPC-->>Wallet: Decrypted state
            end

            Note over Wallet: Set amount and recipient
            Wallet->>RPC: Request ZK proof
            Note over RPC: Generate ZK proof
            RPC-->>Wallet: ZK proof
            Note over Wallet: Build transaction, sign

            Wallet->>RPC: Submit Transaction
            RPC->>Solana: Forward transaction
            Note over Solana: Verify signatures
            Note over Solana: CPI Solana Privacy Program
            Note over Solana: Verify ZK proof
            RPC-->>Wallet: Transaction signature
        ```
      </Tab>

      <Tab title="Custom Confidential Ring">
        ```mermaid theme={"system"}
        %%{init: {
          'theme': 'base',
          'themeVariables': {
            'lineColor':           '#FF6B35',
            'primaryTextColor':    '#737373',
            'primaryBorderColor':  '#9CA3AF',
            'actorBkg':            '#FFFFFF',
            'actorBorder':         '#9CA3AF',
            'actorTextColor':      '#737373',
            'signalColor':         '#FF6B35',
            'signalTextColor':     '#737373',
            'labelBoxBkgColor':    '#FF6B351F',
            'labelBoxBorderColor': '#FF6B35',
            'noteBkgColor':        '#F5F5F5',
            'noteTextColor':       '#737373',
            'noteBorderColor':     '#9CA3AF'
          }
        }}%%
        sequenceDiagram
            participant Wallet
            participant RPC as RPC Provider
            participant Solana

            rect rgba(255, 107, 53, 0.06)
                Note left of Wallet: Local
                Wallet->>RPC: Fetch encrypted state
                RPC-->>Wallet: Encrypted state
                Note over Wallet: Decrypt locally
            end
            rect rgba(255, 107, 53, 0.06)
                Note left of Wallet: Delegated
                Wallet->>RPC: Get private balance
                Note over RPC: Decrypt and serve decrypted state
                RPC-->>Wallet: Decrypted state
            end

            Note over Wallet: Set amount and recipient
            Wallet->>RPC: Request ZK proof
            Note over RPC: Generate ZK proof and policy proof
            RPC-->>Wallet: ZK proof and policy proof
            Note over Wallet: Build transaction, sign

            Wallet->>RPC: Submit Transaction
            RPC->>Solana: Forward transaction
            Note over Solana: Verify signatures
            Note over Solana: CPI Custom Ring Program
            Note over Solana: Verify policy ZK proof
            Note over Solana: CPI Solana Privacy Program
            Note over Solana: Verify SPP ZK proof
            RPC-->>Wallet: Transaction signature
        ```
      </Tab>

      <Tab title="Custom Anonymous Ring">
        ```mermaid theme={"system"}
        %%{init: {
          'theme': 'base',
          'themeVariables': {
            'lineColor':           '#FF6B35',
            'primaryTextColor':    '#737373',
            'primaryBorderColor':  '#9CA3AF',
            'actorBkg':            '#FFFFFF',
            'actorBorder':         '#9CA3AF',
            'actorTextColor':      '#737373',
            'signalColor':         '#FF6B35',
            'signalTextColor':     '#737373',
            'labelBoxBkgColor':    '#FF6B351F',
            'labelBoxBorderColor': '#FF6B35',
            'noteBkgColor':        '#F5F5F5',
            'noteTextColor':       '#737373',
            'noteBorderColor':     '#9CA3AF'
          }
        }}%%
        sequenceDiagram
            participant Wallet
            participant RPC as RPC Provider
            participant Relayer
            participant Solana

            rect rgba(255, 107, 53, 0.06)
                Note left of Wallet: Delegated
                Wallet->>RPC: Get private balance
                Note over RPC: Decrypt and serve decrypted state
                RPC-->>Wallet: Decrypted state
            end

            Note over Wallet: Set amount and recipient, sign
            Wallet->>RPC: Request ZK proof
            Note over RPC: Generate ZK proof and policy proof
            RPC-->>Wallet: ZK proof and policy proof
            Note over Wallet: Build transaction

            Wallet->>Relayer: Submit Transaction
            Relayer->>Solana: Forward transaction
            Note over Solana: Verify signatures
            Note over Solana: CPI Custom Ring Program
            Note over Solana: Verify policy ZK proof
            Note over Solana: CPI Solana Privacy Program
            Note over Solana: Verify SPP ZK proof
            Relayer-->>Wallet: Transaction signature
        ```
      </Tab>
    </Tabs>
  </Tab>

  <Tab title="Solana transfer">
    1. Баланс SOL или SPL пользователя общедоступен в блокчейне.
    2. Кошелек считывает общедоступное состояние, формирует перевод, а владелец подписывает его.
    3. Среда выполнения Solana проверяет подписи и вызывает System Program или Token Program, которая обновляет публичный баланс.
    4. Приложение отслеживает статус по хешу транзакции Solana.

    ```mermaid theme={"system"}
    %%{init: {
      'theme': 'base',
      'themeVariables': {
        'lineColor':           '#FF6B35',
        'primaryTextColor':    '#737373',
        'primaryBorderColor':  '#9CA3AF',
        'actorBkg':            '#FFFFFF',
        'actorBorder':         '#9CA3AF',
        'actorTextColor':      '#737373',
        'signalColor':         '#FF6B35',
        'signalTextColor':     '#737373',
        'labelBoxBkgColor':    '#FF6B351F',
        'labelBoxBorderColor': '#FF6B35',
        'noteBkgColor':        '#F5F5F5',
        'noteTextColor':       '#737373',
        'noteBorderColor':     '#9CA3AF'
      }
    }}%%
    sequenceDiagram
        participant Wallet
        participant RPC
        participant Solana

        Wallet->>RPC: Get public balance
        RPC-->>Wallet: Public state
        Note over Wallet: Build transfer, owner signs
        Wallet->>RPC: sendTransaction
        RPC->>Solana: Forward transaction
        Note over Solana: Verify signatures
        Note over Solana: CPI System / Token Program
        Note over Solana: Update balance
        RPC-->>Wallet: Transaction signature
    ```
  </Tab>
</Tabs>

<CardGroup cols={1}>
  <a href="https://www.helius.dev/privacy/demo" target="_blank" rel="noopener noreferrer" className="not-prose">
    <Card title="Launch Demo" icon="play">
      Попробуйте конфиденциальные переводы и обмены в devnet.
    </Card>
  </a>
</CardGroup>

<span id="private-wallet" />

<span id="creation-of-a-private-wallet" />

<span id="transfers-to-a-private-wallet" />

<span id="key-management" />

<span id="creating-a-shielded-keypair" />

<span id="integrating-a-shielded-keypair" />

<span id="decryption-modes-and-wallet-sync" />

<span id="local-decryption" />

<span id="delegated-decryption" />

<span id="indexer-serves-encrypted-state" />

<span id="private-wallet-balance" />

<span id="private-solana-token-accounts" />

<span id="on-concurrency" />

<span id="on-proof-generation-time" />

<span id="terms" />

<span id="custom-rings-are-programmable" />

## Подробнее

<CardGroup cols={2}>
  <Card title="Architecture" icon="diagram-project" href="/docs/ru/privacy/concepts/architecture">
    Как взаимодействуют кошельки, службы RPC и программы Solana.
  </Card>

  <Card title="Private State and UTXOs" icon="database" href="/docs/ru/privacy/concepts/utxo">
    Как хранятся и расходуются приватные балансы.
  </Card>

  <Card title="Encryption and Privacy Guarantees" icon="key" href="/docs/ru/privacy/concepts/encryption">
    Как шифруются активы и какую роль играет защищенная пара ключей.
  </Card>

  <Card title="Custom Enterprise Rings" icon="building" href="/docs/ru/privacy/integration/enterprise">
    Как настроить кольцо с пользовательскими параметрами доступа аудитора и контроля соответствия требованиям.
  </Card>
</CardGroup>

## Не нашли то, что искали?

<Callout type="info">
  Свяжитесь с нами! [Telegram](https://t.me/tilo_light) | [Электронная почта](mailto:sales@helius.xyz) | [Контакты](https://www.helius.dev/contact)
</Callout>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.