> ## 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. # Aneis Personalizados para Empresas > Adicione pagamentos e saldos de stablecoins privados no Solana via a Private Wallet API, com controles de política e conformidade programáveis para instituições. Este guia é para fintechs, emissores, plataformas de folha de pagamento, empresas de remessas, neobancos e empresas que desejam contas de pagamento privadas combinadas com os benefícios do blockchain. ## Visão Geral Seu negócio poderá: 1. Criar carteiras privadas para contas de clientes, comerciantes ou tesouraria 2. Depositar stablecoins de carteiras públicas para privadas 3. Enviar pagamentos privados entre carteiras privadas 4. Retirar para endereços e carteiras públicas Solana 5. Visualizar saldos e histórico privados por meio da API 6. Definir Aneis Personalizados dedicados com sua própria conformidade, auditoria e regras de negócios. Você pode trazer sua própria conformidade ou usar a solução de verificação de identidade e triagem de sanções gerenciada pela Helius. 7. Configurar quem pode visualizar, aprovar, congelar ou mover fundos dentro de um anel 8. Acompanhar o status de pagamento privado através de polling ou webhooks | Termo | Significado | | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Empresa | A companhia integrando Helius Privacy | | Carteira Privada | Uma conta de pagamento com saldos e transferências onchain criptografados | | Provedor de Carteira | O sistema que gerencia contas de usuários, signatários, contas inteligentes ou carteiras de tesouraria e guarda chaves de privacidade não exportáveis. Exemplos incluem Turnkey, Privy, Squads, Rain ou uma pilha de custódia interna | | Proprietário | A chave pública Solana, conta inteligente ou signatário apoiado pelo provedor que autoriza ações da Carteira Privada | | Inbox | A chave pública Solana usada como endereço público de recebimento para uma Carteira Privada | | Anel | Um grupo de carteiras privadas com saldos no Anel Padrão ou em um Anel Personalizado | | Anel Padrão | O Anel confidencial sem permissão; ativo e montante são privados enquanto remetente e destinatário permanecem públicos. Sem política personalizada, autoridade ou auditor | | Anel Personalizado | Um anel configurado com regras personalizadas, visibilidade e autoridades | | Auditor | Um visualizador configurado para um Anel Personalizado. Auditores podem ler dados do anel, mas não podem gastar | | Co-signatário | Um signatário configurado opcionalmente que deve aprovar transferências selecionadas | | Autoridade de Congelamento | Uma autoridade configurada que pode congelar ou descongelar saldos quando a política permite | | Delegado Permanente | Uma autoridade configurada que pode mover saldos dentro de um anel quando a política permite | | Privacy API | A API Helius para criar Carteiras Privadas, ler saldos/histórico, preparar transferências, gerar provas e enviar transações | ## Como Funciona Uma Carteira Privada é o principal objeto API com o qual você interage. Você pode mapear uma Carteira Privada para, por exemplo, uma conta de cliente, conta de comerciante, conta de funcionário, conta de tesouraria ou conta inteligente. Saldos e transferências privadas são criptografados onchain. Provedores RPC como a Helius indexam o estado criptografado, geram provas, constroem transações e as enviam para a Solana sob demanda. Para a maioria dos casos de uso empresarial, as Carteiras Privadas vivem dentro de um Anel Personalizado dedicado. O anel define as regras para transferências, visibilidade e conformidade. Aqui está como o Helius Privacy se encaixa em sua stack: Modelo de confiança. O aplicativo da Empresa envia a intenção para a API de Privacidade / Provedor RPC, que chama o Provedor de Carteira para operações chave e envia transações para a Solana. ### Modelo de Confiança | Componente | Responsabilidade | | -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | | Aplicativo Empresarial | UI do produto, autenticação do cliente, fluxos de trabalho de negócios | | Provedor de Carteira | Custódia de conta, signatários, política de aprovação e chaves de privacidade não exportáveis com operações de chave controladas por política | | Privacy API / Provedor RPC | Private Wallet API, sincronização, estado, prova, construção de transações, auditoria opcional e envio de transações para a rede Solana | | Anel Personalizado | Regras de negócios, regras de conformidade, regras de visibilidade, autoridades opcionais, especificadas via instruções de programa personalizadas onchain | | Solana | Execução e liquidação | Pagamentos privados requerem autorização pela carteira privada e devem cumprir com a política correspondente do anel. Anéis confidenciais (o Anel Padrão e Anéis Personalizados confidenciais) suportam descriptografia local e delegada. Anéis Personalizados anônimos suportam apenas descriptografia delegada. No modo de descriptografia delegada, a carteira e o provedor RPC selecionado compartilham uma chave de visualização. O provedor pode fornecer saldos e histórico mas não pode autorizar gastos. Isso é distinto de um auditor, cuja visibilidade é definida pela política do Anel. Você pode operar a infraestrutura (RPC, indexador, servidor auditor ou co-signatário) por conta própria, ou usar um provedor RPC como a Helius para executá-la para você. Executamos a infraestrutura através de nossa frota global de RPCs de alto desempenho e, opcionalmente, via uma configuração dedicada personalizável às suas necessidades. Infraestrutura dedicada não implica uma árvore de estado onchain separada. Anéis Personalizados e o Anel Padrão sem permissão compartilham uma árvore de Merkle. ### Anéis Anéis tornam a privacidade no Solana programável, semelhante ao Token-2022. O Anel Padrão é sem permissão e não tem política personalizada. Um Anel Personalizado é regido por seu próprio conjunto de regras de política. Uma Carteira Privada pode manter saldos em múltiplos Anéis ao mesmo tempo. Qual Anel um saldo pertence não é uma propriedade da carteira. É uma propriedade de cada UTXO, armazenada em seu campo `policy_program_id`. * O anel padrão é confidencial e sem permissão, sem qualquer política, auditores ou autoridades. Anéis confidenciais criptografam ativo e montante. * Anéis personalizados podem ser configurados com política personalizada e controles de conformidade, podendo ser confidenciais ou anônimos (ativo, montante, remetente, destinatário criptografados). Saldos Privados mostrados como uma zona onchain tracejada contendo dois anéis. O Anel Padrão é confidencial, autocustodial e sem permissão. O Anel Personalizado é confidencial ou anônimo, autocustodial e adiciona política personalizada e conformidade personalizada. Uma transferência privada conecta os anéis, e cada um deposita e retira de uma camada de Saldos Públicos Solana abaixo. Uma carteira privada pode retirar de um Anel Personalizado para uma conta de token público, para o Anel Padrão confidencial e sem permissão, ou para outro Anel Personalizado se a política do anel de origem permitir. #### Anéis Personalizados São Programáveis Um Anel Personalizado pode definir regras totalmente personalizadas para transferências e visibilidade/auditoria. Se você deseja configurar seu próprio Anel Personalizado, [entre em contato conosco](https://www.helius.dev/contact) e nós ajudaremos na configuração. Você pode trazer sua própria conformidade ou usar a solução de verificação de identidade e triagem de sanções gerenciada pela Helius. Anéis são programáveis. Exemplos comuns de regras incluem: | Política | Exemplo | | ----------------------------- | -------------------------------------------------------------------------------------- | | Ativos permitidos | Apenas USDC ou um stablecoin emitido específico | | Limites de transferência | Requerer aprovação extra acima de um limite | | Co-assinatura | Requerer aprovação de conformidade para pagamentos selecionados | | Listas de autorização | Permitir transferências apenas para contas, comerciantes ou anéis aprovados | | Listas de bloqueio | Bloquear destinos sancionados ou de risco | | Congelar/descongelar | Congelar um saldo enquanto uma investigação está pendente | | Delegado permanente | Permitir que uma autoridade configurada mova fundos sob política | | Visibilidade do auditor | Permitir que conformidade, contabilidade ou reguladores visualizem a atividade do anel | | Regras entre anéis | Permitir ou bloquear movimentação entre anéis específicos | | Regras de retirada | Restringir retiradas públicas ou requerer aprovação | | Suporte a contas inteligentes | Permitir uso nativo com contas inteligentes como Squads | | Recuperação de conta | Permitir que uma autoridade configurada ou identidade de fallback recupere contas | Esses conjuntos de regras personalizadas são programados como um programa Solana dedicado que verifica a transição de estado de cada transferência aplicável antes de se estabelecer atomicamente onchain através do Protocolo de Privacidade Solana (TSPP). ## Administração de Anel ### Relatório de Anel Utilize relatórios de anel para tesouraria, contabilidade, conformidade ou seu próprio conjunto de regras de visibilidade. ```bash theme={"system"} curl "https://privacy.helius.xyz/v1/rings/ring_acme_usdc/transactions?limit=100" \ -H "Authorization: Bearer $HELIUS_API_KEY" ``` Resposta de exemplo: ```json theme={"system"} { "ringId": "ring_acme_usdc", "transactions": [ { "kind": "private_transfer", "fromPrivateWalletId": "pw_2W6Qk...", "toPrivateWalletId": "pw_8Se1...", "mint": "EPjFWdd5AufqSSqeM2q...", "amount": "25000000", "status": "confirmed", "signature": "3jd...", "slot": 291044120, "metadata": { "invoiceId": "inv_123", "purpose": "vendor_payment" } } ] } ``` O acesso do auditor é somente leitura. Um auditor pode visualizar os dados configurados pela política do anel, mas não pode assinar, gastar, congelar ou mover fundos a menos que configurado separadamente como uma autoridade. ### Congelar ou Descongelar uma Carteira Privada Se o Anel Personalizado tiver uma autoridade de congelamento, você pode congelar ou descongelar uma Carteira Privada conforme a política. ```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 Auth as Ring Authority participant API as Privacy API participant SOL as Solana Auth->>API: POST /freeze or /thaw (walletId, authority signature) Note over API: Verify Custom Ring freeze authority API->>SOL: Apply freeze or thaw via policy program SOL-->>API: Wallet status updated ``` ```bash theme={"system"} curl -X POST https://privacy.helius.xyz/v1/private-wallets/pw_2W6Qk.../freeze \ -H "Authorization: Bearer $HELIUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "reason": "compliance_review", "authorization": { "type": "solana_signature", "message": "BASE64_ENCODED_FREEZE_MESSAGE", "signature": "BASE58_SIGNATURE" } }' ``` Resposta de exemplo: ```json theme={"system"} { "id": "pw_2W6Qk...", "status": "frozen", "reason": "compliance_review" } ``` Descongelar: ```bash theme={"system"} curl -X POST https://privacy.helius.xyz/v1/private-wallets/pw_2W6Qk.../thaw \ -H "Authorization: Bearer $HELIUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "authorization": { "type": "solana_signature", "message": "BASE64_ENCODED_THAW_MESSAGE", "signature": "BASE58_SIGNATURE" } }' ``` ## Monitoramento via Webhooks Use webhooks para atualizações de ciclo de vida de transferências. ```bash theme={"system"} curl -X POST https://privacy.helius.xyz/v1/webhooks \ -H "Authorization: Bearer $HELIUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "events": [ "private_wallet.created", "private_wallet.balance_updated", "private_wallet.transaction_confirmed", "policy.action_required" ], "url": "https://example.com/helius/privacy/webhook" }' ``` Evento de exemplo: ```json theme={"system"} { "type": "private_wallet.transaction_confirmed", "ringId": "ring_acme_usdc", "owner": "9xQeWvG816bUx9EPf...", "privateWalletId": "pw_2W6Qk...", "signature": "3jd...", "slot": 291044120 } ``` ## Propriedades de Segurança e Privacidade * As chaves API da Helius autenticam projetos empresariais. Elas não autorizam gastos. A autorização de gastos requer uma assinatura de carteira, autorização alternativa por meio do serviço de gerenciamento de chaves subjacente (como Privy ou Turnkey) ou, se configurado, política do anel. * O material de chave privada é mantido em infraestrutura segura gerenciada pelo Provedor de Carteiras. * A Helius não recebe ou exporta chaves de gastos privadas. * No modo de descriptografia delegada, a carteira e o provedor compartilham uma chave de visualização. O provedor pode ler saldos e histórico, mas não pode autorizar gastos. * Auditores de Anéis Personalizados podem visualizar a atividade configurada do anel, mas não podem gastar. * Transações para ou dentro de um Anel Personalizado invocam publicamente seu programa de política. * Co-signatários aprovam transferências selecionadas, mas não podem gastar sozinhos, a menos que a política permita. * Autoridades de congelamento podem congelar ou descongelar saldos somente se a política do anel permitir. * Delegados permanentes podem mover saldos somente se explicitamente configurados na política do anel. * Transferências privadas dentro de um anel não revelam ativo ou montante onchain. Um anel confidencial revela remetente e destinatário; um anel anônimo usa um relayer e não revela nenhuma das partes. A política do anel pode especificar visibilidade adicional. * Retiradas revelam destino, ativo e montante. * Depósitos cripto públicos revelam origem, ativo e montante. O on-ramp de um saldo fiduciário mantém ativo e montante privados (criptografados onchain). * Transferências públicas revelam remetente, destinatário, ativo e montante. ## Didn't find what you were looking for? Reach out! [Telegram](https://t.me/tilo_light) | [E-Mail](mailto:sales@helius.xyz) | [Contact](https://www.helius.dev/contact)