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

# Visão geral

> Saiba como o Helius Privacy funciona, incluindo os fluxos do usuário, o que permanece público ou privado em uma transferência e os anéis com políticas personalizáveis.

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

## Introdução

Todas as transações na Solana podem ser lidas publicamente: endereços, saldos e histórico de transferências ficam visíveis para qualquer pessoa.
Para os Anéis de Privacidade da Solana, definimos dois níveis de privacidade:

* **Confidencialidade** – criptografa o ativo e o valor
* **Anonimato** – criptografa o ativo, o valor, o remetente e o destinatário

<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" />

## Anéis de Privacidade da Solana

Os anéis são pools protegidos e programáveis, com saldos on-chain criptografados e execução diretamente na Solana.
Diferentes tipos de anéis coexistem:

<CardGroup cols={2}>
  <Card title="Default Ring" icon="lock">
    * Confidencial
    * Autocustodial
    * Sem necessidade de permissão
    * Sem visibilidade para auditores
  </Card>

  <Card title="Custom Enterprise Rings" icon="building" href="/docs/pt-BR/privacy/integration/enterprise">
    * Confidencial ou anônimo
    * Autocustodial
    * Conformidade personalizada
    * Visibilidade para auditores
  </Card>
</CardGroup>

Para a maioria das aplicações, recomendamos o Anel padrão confidencial e sem necessidade de permissão.

Use um Anel personalizado quando sua aplicação precisar de conformidade personalizada com acesso e controles para auditores.
Os Anéis personalizados são programas da Solana que definem permissões de transferência e quaisquer autoridades adicionais, de forma semelhante ao Token-2022.

O Anel padrão fornece a base para DeFi confidencial e outras aplicações.
Anéis personalizados independentes podem usar aplicações existentes ou criar as próprias, enquanto definem suas próprias políticas,
acesso para auditores e autoridades, que se aplicam apenas aos saldos dentro do respectivo Anel.
Os Anéis são interoperáveis por padrão e compartilham liquidez em todo o ecossistema DeFi confidencial da 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="Saldos públicos e saldos privados na Solana, com um Anel sem necessidade de permissão ao lado do Anel personalizado 1, Anel personalizado 2 e Anel personalizado n." width="850" height="370" data-path="images/privacy/privacy-rings-workshop.png" />

## Principais propriedades

* **Velocidade nativa da 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.">provas de conhecimento zero</Tooltip> sucintas são geradas em dezenas de ms, preservando uma experiência familiar para o usuário. Pense nisso como outra chamada RPC.
* **Execução on-chain** – Os saldos criptografados permanecem na Solana. Sem livro-razão off-chain, sidechain ou sequenciador centralizado.
* **Criptografia de qualquer ativo** – Os Anéis oferecem suporte a SOL, tokens SPL e tokens Token-2022.
* **Saldos autocustodiais** – As transações privadas sempre exigem a assinatura do proprietário.
* **Compatibilidade com contas inteligentes** – Os Anéis podem oferecer suporte a contas inteligentes com lógica própria de autorização.
* **Componibilidade da Solana** – Combine com qualquer programa da Solana em uma única transação.
* **Privacidade programável** – Crie depósitos em garantia privados em programas da Solana.

## Fluxos do usuário e garantias de privacidade

Os usuários mantêm o saldo criptografado em uma Carteira Privada. Eles podem entrar em um Anel, fazer transferências privadas dentro dele ou sair dele, além de combinar essas operações com outros programas da Solana em uma única transação.

<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" />

Os usuários enviam tokens para um endereço de carteira da Solana, assim como fazem com saldos públicos.
Qualquer pessoa pode depositar em qualquer carteira privada conhecendo apenas o endereço da carteira do destinatário.

### Depósito em um saldo privado

Os usuários podem depositar em um saldo privado de duas formas:

1. Converter um saldo fiduciário em um saldo de cripto privado
2. Depositar de um saldo de cripto público em um saldo de cripto privado

<Tabs>
  <Tab title="Entrada a partir do saldo em fiat">
    | Campo | Visibilidade |
    | - | - |
    | Ativo | Privado. Criptografado on-chain. |
    | Valor | Privado. Criptografado on-chain. |
    | Remetente | O provedor de on-ramp. Público em um Ring confidencial; privado em um Ring anônimo. |
    | Destinatário | O usuário. Público em um Ring confidencial; privado em um Ring anônimo. |
    | Memorando (opcional) | Privado. Criptografado on-chain. |
    | Saldo em moeda fiduciária e pagamento | Não fica on-chain. O pagamento em moeda fiduciária ocorre por meio do provedor de on-ramp. |

    Ao contrário de um depósito feito a partir de um saldo público, fazer on-ramp para um saldo privado mantém o ativo e o valor privados. O provedor transfere da carteira privada dele para a sua. Em um Ring confidencial, apenas os endereços do remetente e do destinatário são públicos.
  </Tab>

  <Tab title="Depósito do saldo público de cripto">
    | Campo | Visibilidade |
    | - | - |
    | Ativo | Público. Visível no depósito público. |
    | Valor | Público. Visível no depósito público. |
    | Remetente | Público. O endereço da carteira de origem fica visível no depósito público. |
    | Destinatário | Público. O endereço da carteira de destino fica visível no depósito público. |
    | Memorando (opcional) | Público. Emitido com o depósito público. |
    | Saldo privado resultante | Privado. Criptografado onchain. |
  </Tab>
</Tabs>

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

### Transferência entre saldos privados

Os usuários podem enviar uma transferência privada de duas formas:

1. Transferir dentro do mesmo Anel
2. Transferir para outro Anel

<Tabs>
  <Tab title="Default Ring">
    | Campo | Visibilidade |
    | - | - |
    | Ativo | Privado. Criptografado na blockchain. |
    | Valor | Privado. Criptografado na blockchain. |
    | Remetente | Público. O Anel Padrão é confidencial. |
    | Destinatário | Público. O Anel Padrão é confidencial. |
    | Memo (opcional) | Privado. Criptografado na blockchain. |
  </Tab>

  <Tab title="Custom Rings">
    | Transferência | Ativo | Valor | Remetente | Destinatário | Memo (opcional) |
    | - | - | - | - | - | - |
    | Dentro de um Anel personalizado confidencial | Privado | Privado | Público | Público | Privado |
    | Dentro de um Anel personalizado anônimo | Privado | Privado | Privado | Privado | Privado |
    | Do Anel Padrão para um Anel personalizado confidencial ou vice-versa | Privado | Privado | Público | Público | Privado |
    | De um Anel confidencial para um Anel personalizado anônimo | Privado | Privado | Público | Privado | Privado |
    | De um Anel personalizado anônimo para um Anel confidencial | Privado | Privado | Privado | Público | Privado |

    Um retransmissor envia as transferências de Anéis anônimos, portanto o livro-razão público não revela a carteira privada de origem. O ID do programa do Anel personalizado permanece público.

    As transferências entre Anéis devem seguir a política do Anel de origem. Uma transação pode combinar saldos do Anel Padrão e de um Anel personalizado. Uma transferência entre dois Anéis personalizados é roteada pelo Anel Padrão.
  </Tab>
</Tabs>

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

### Saque para um saldo público

Os usuários podem sacar de um saldo privado de duas formas:

1. Converter cripto privada em um saldo fiduciário
2. Sacar de um saldo de cripto privado para um saldo de cripto público

<Tabs>
  <Tab title="Rota de saída para saldo fiat">
    | Campo | Visibilidade |
    | - | - |
    | Ativo | Privado. Criptografado na blockchain. |
    | Valor | Privado. Criptografado na blockchain. |
    | Remetente | O usuário. Público em um Ring confidencial; privado em um Ring anônimo. |
    | Destinatário | O provedor de conversão para moeda fiduciária. Público em um Ring confidencial; privado em um Ring anônimo. |
    | Memorando (opcional) | Privado. Criptografado na blockchain. |
    | Pagamento em moeda fiduciária | Não ocorre na blockchain. O pagamento em moeda fiduciária é realizado pelo provedor de conversão. |

    Ao contrário de um saque para um saldo público, a conversão de um saldo privado para moeda fiduciária mantém o ativo e o valor privados. Você transfere da sua carteira privada para a carteira privada do provedor, que paga você em moeda fiduciária. Em um Ring confidencial, apenas os endereços do remetente e do destinatário são públicos. Seu saldo privado restante permanece privado.
  </Tab>

  <Tab title="Sacar para saldo cripto público">
    | Campo | Visibilidade |
    | - | - |
    | Ativo | Público. Visível no saque público. |
    | Valor | Público. Visível no saque público. |
    | Remetente | Público em um Anel confidencial; privado em um Anel anônimo. |
    | Destinatário | Público. O endereço da carteira de destino fica visível no saque público. |
    | Memorando (opcional) | Privado quando anexado a uma saída criptografada. |
    | Saldo público resultante | Público. Mantido na conta pública do destinatário. |
    | Saldo privado restante | Privado. Criptografado on-chain. |
  </Tab>
</Tabs>

## Programabilidade e depósitos em garantia privados

Os programas da Solana podem usar depósitos em garantia privados para criar aplicações DeFi confidenciais.

* **Depósitos em garantia privados** – Os programas ZK da Solana podem manter saldos privados em garantia e definir as condições de liberação
* **Componibilidade da Solana** – Combine transações privadas com outros programas da Solana em uma única transação
* **Liquidez compartilhada** – Programas ZK em todo o ecossistema DeFi confidencial podem compartilhar liquidez

**O que você pode criar**

* **Pagamentos privados condicionais** – Mantenha ativos criptografados em garantia e libere-os conforme um cronograma ou após as aprovações necessárias, viabilizando folha de pagamento, aquisição de direitos, pagamentos por marcos e fluxos de trabalho multisig privados.
* **Swaps e negociação** – Troque tokens encapsulados, SOL, memecoins, ações e RWAs por meio de depósitos em garantia privados, como em swaps de tokens ou negociações OTC.
* **Staking e rendimento** – Crie aplicações privadas que geram rendimento, como pools de staking, tesourarias tokenizadas ou outros cofres de rendimento.
* **Empréstimos** – Mantenha garantias em depósitos privados, como em empréstimos de stablecoins respaldados por ativos tokenizados.

<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" />

## Fluxo de transação em alto nível

<a id="overview" />

Uma transferência privada funciona de forma semelhante às transferências públicas e é executada em uma única transação da Solana.

<Tabs>
  <Tab title="Private transfer">
    1. O saldo de SOL ou SPL do usuário é criptografado on-chain.
    2. Busque o estado criptografado e descriptografe-o localmente, ou um provedor delegado descriptografa e fornece o estado descriptografado.
    3. A carteira define o valor e o destinatário e, em seguida, solicita uma prova ZK.
    4. Por padrão, o provedor RPC gera a prova ZK e a retorna. Um Anel personalizado também exige uma prova de política.
    5. A carteira cria a transação da Solana. As provas ZK são verificadas sem revelar o estado criptografado. Os programas invocados e quem assina e envia dependem do Anel:

    | | Anel confidencial sem necessidade de permissão | Anel confidencial personalizado | Anel anônimo personalizado |
    | - | - | - | - |
    | Programas invocados | Programa de Privacidade da Solana | Programa do Anel personalizado e Programa de Privacidade da Solana | Programa do Anel personalizado e Programa de Privacidade da Solana |
    | Signatário | O remetente assina. Um patrocinador de gas pode pagar a taxa. | O remetente assina. Um patrocinador de gas pode pagar a taxa. | Um retransmissor, para que o remetente não seja vinculado à transação. |

    6. A aplicação acompanha o status pelo hash da transação da 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. O saldo de SOL ou SPL do usuário é público on-chain.
    2. A carteira lê o estado público, cria uma transferência e o proprietário assina.
    3. O ambiente de execução da Solana verifica as assinaturas e invoca o Programa do Sistema ou o Programa de Tokens, que atualiza o saldo público.
    4. A aplicação acompanha o status pelo hash da transação da 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">
      Experimente transferências confidenciais e swaps na 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" />

## Saiba mais

<CardGroup cols={2}>
  <Card title="Architecture" icon="diagram-project" href="/docs/pt-BR/privacy/concepts/architecture">
    Como carteiras, serviços RPC e programas da Solana interagem.
  </Card>

  <Card title="Private State and UTXOs" icon="database" href="/docs/pt-BR/privacy/concepts/utxo">
    Como os saldos privados são armazenados e gastos.
  </Card>

  <Card title="Encryption and Privacy Guarantees" icon="key" href="/docs/pt-BR/privacy/concepts/encryption">
    Como os ativos são criptografados e qual é a função do par de chaves protegido.
  </Card>

  <Card title="Custom Enterprise Rings" icon="building" href="/docs/pt-BR/privacy/integration/enterprise">
    Como configurar um Anel personalizado com controles de auditoria e conformidade.
  </Card>
</CardGroup>

## Não encontrou o que estava procurando?

<Callout type="info">
  Entre em contato! [Telegram](https://t.me/tilo_light) | [E-Mail](mailto:sales@helius.xyz) | [Typeform](https://form.typeform.com/to/LPFASU8a)
</Callout>


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