> ## 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. # Anillos personalizados para empresas > Agrega pagos y saldos privados con monedas estables en Solana mediante la API de billeteras privadas, con controles programables de políticas y cumplimiento para instituciones. Esta guía está dirigida a empresas fintech, emisores, plataformas de nómina, empresas de remesas, neobancos y otras empresas que buscan cuentas de pago privadas combinadas con los beneficios de la blockchain. ## Descripción general Tu empresa podrá: 1. Crear billeteras privadas para cuentas de clientes, comercios o tesorería 2. Depositar monedas estables desde billeteras públicas en billeteras privadas 3. Enviar pagos privados entre billeteras privadas 4. Retirar fondos a direcciones y billeteras públicas de Solana 5. Consultar saldos privados e historiales mediante la API 6. Definir Anillos personalizados dedicados con tus propias reglas de cumplimiento, auditoría y negocio. Puedes aportar tu propio sistema de cumplimiento o usar la solución administrada de Helius para KYC y verificación de sanciones. 7. Configurar quién puede ver, aprobar, congelar o mover fondos dentro de un anillo 8. Dar seguimiento al estado de los pagos privados mediante sondeo o webhooks Prueba transferencias y swaps confidenciales en devnet. | Término | Significado | | ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Empresa | La empresa que integra Helius Privacy | | Billetera privada | Una cuenta de pago con saldos y transferencias cifrados en cadena | | Proveedor de billeteras | El sistema que administra cuentas de usuario, firmantes, cuentas inteligentes o billeteras de tesorería y conserva claves de privacidad no exportables. Algunos ejemplos son Turnkey, Privy, Squads, Rain o una infraestructura interna de custodia | | Propietario | La clave pública de Solana, cuenta inteligente o firmante respaldado por un proveedor que autoriza las acciones de la Billetera privada | | Bandeja de entrada | La clave pública de Solana utilizada como dirección pública de recepción de una Billetera privada | | Anillo | Un grupo de billeteras privadas con saldos en el Anillo predeterminado o en un Anillo personalizado | | Anillo predeterminado | El Anillo confidencial sin permisos; el activo y el monto son privados, mientras que el remitente y el destinatario siguen siendo públicos. No tiene políticas, autoridades ni auditores personalizados | | Anillo personalizado | Un anillo configurado con reglas, visibilidad y autoridades personalizadas | | Auditor | Un observador configurado para un Anillo personalizado. Los auditores pueden leer los datos del anillo, pero no pueden gastar | | Cofirmante | Un firmante configurado opcionalmente que debe aprobar determinadas transferencias | | Autoridad de congelación | Una autoridad configurada que puede congelar o descongelar saldos cuando la política lo permite | | Delegado permanente | Una autoridad configurada que puede mover saldos dentro de un anillo cuando la política lo permite | | API de privacidad | API de Helius para crear Billeteras privadas, consultar saldos e historiales, preparar transferencias, generar pruebas y enviar transacciones | ## Cómo funciona Una Billetera privada es el objeto principal de la API con el que interactúas. Puedes asociar una Billetera privada, por ejemplo, con una cuenta de cliente, de comercio, de empleado, de tesorería o una cuenta inteligente. Los saldos y las transferencias privadas se cifran en cadena. Los proveedores de RPC como Helius indexan el estado cifrado, generan pruebas, crean transacciones y las envían a Solana cuando se solicitan. En la mayoría de los casos de uso empresariales, las Billeteras privadas se encuentran dentro de un Anillo personalizado dedicado. El anillo define las reglas de transferencias, visibilidad y cumplimiento. Así se integra Helius Privacy en tu infraestructura: Trust model. The Enterprise App submits intent to the Privacy API / RPC Provider, which calls the Wallet Provider for key operations and submits transactions to Solana. ### Modelo de confianza | Componente | Responsabilidad | | ------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Aplicación empresarial | Interfaz de usuario del producto, autenticación de clientes y flujos de trabajo empresariales | | Proveedor de billeteras | Custodia de cuentas, firmantes, política de aprobación y claves de privacidad no exportables con operaciones de claves controladas por políticas | | API de privacidad / Proveedor de RPC | API de Billeteras privadas, sincronización, estado, generación de pruebas, creación de transacciones, auditoría opcional y envío de transacciones a la red de Solana | | Anillo personalizado | Reglas de negocio, reglas de cumplimiento, reglas de visibilidad y autoridades opcionales, especificadas mediante instrucciones de programa personalizadas en cadena | | Solana | Ejecución y liquidación | Los pagos privados requieren la autorización de la billetera privada y deben cumplir con la política del anillo correspondiente. Los anillos confidenciales (el Anillo predeterminado y los Anillos personalizados confidenciales) admiten descifrado local y delegado. Los Anillos personalizados anónimos solo admiten descifrado delegado. En el modo de descifrado delegado, la billetera y el proveedor de RPC seleccionado comparten una clave de visualización. El proveedor puede proporcionar saldos e historiales, pero no puede autorizar gastos. Esto es distinto de un auditor, cuya visibilidad se define mediante la política del Anillo. Puedes ejecutar por tu cuenta la infraestructura (RPC, indexador, servidor de auditoría o cofirmante), o recurrir a un proveedor de RPC como Helius para que la gestione por ti. Ejecutamos la infraestructura mediante nuestra flota global de RPC de alto rendimiento y, opcionalmente, mediante una configuración dedicada que puedes personalizar según tus requisitos. La infraestructura dedicada no implica un árbol de estado en cadena independiente. Los Anillos personalizados y el Anillo predeterminado sin permisos comparten un único árbol de Merkle. ### Anillos Los Anillos hacen que la privacidad en Solana sea programable, de manera similar a Token-2022. El Anillo predeterminado no requiere permisos y no tiene políticas personalizadas. Un Anillo personalizado se rige por su propio conjunto de reglas de políticas. Una Billetera privada puede mantener saldos en varios Anillos al mismo tiempo. El Anillo al que pertenece un saldo no es una propiedad de la billetera. Es una propiedad de cada UTXO, almacenada en su campo `policy_program_id`. * El anillo predeterminado es confidencial y no requiere permisos, políticas, auditores ni autoridades. Los anillos confidenciales cifran el activo y el monto. * Los anillos personalizados se pueden configurar con políticas y controles de cumplimiento personalizados, y pueden ser confidenciales o anónimos (activo, monto, remitente y destinatario cifrados). Private Balances shown as a dashed onchain zone holding two rings. The Default Ring is confidential, self-custodial, and permissionless. The Custom Ring is confidential or anonymous, self-custodial, and adds custom policy and custom compliance. A private transfer connects the rings, and each deposits into and withdraws from a Solana Public Balances layer below. Una billetera privada puede retirar fondos desde un Anillo personalizado hacia una cuenta pública de tokens, hacia el Anillo predeterminado confidencial y sin permisos, o hacia otro Anillo personalizado si la política del anillo de origen lo permite. #### Los Anillos personalizados son programables Un Anillo personalizado puede definir reglas totalmente personalizadas para las transferencias y la visibilidad o auditoría. Si quieres configurar tu propio Anillo personalizado, [contáctanos](https://www.helius.dev/contact) y te ayudaremos a configurarlo. Puedes aportar tu propio sistema de cumplimiento o usar la solución administrada de Helius para KYC y verificación de sanciones. Los Anillos son programables. Algunos ejemplos comunes de reglas son: | Política | Ejemplo | | --------------------------------------- | ---------------------------------------------------------------------------------------------------------------- | | Activos permitidos | Solo USDC o una moneda estable emitida específica | | Límites de transferencia | Exigir aprobación adicional por encima de un umbral | | Firma conjunta | Exigir la aprobación del equipo de cumplimiento para determinados pagos | | Listas de permitidos | Permitir únicamente transferencias a cuentas, comercios o anillos aprobados | | Listas de bloqueados | Bloquear destinos sancionados o riesgosos | | Congelación/descongelación | Congelar un saldo mientras haya una investigación pendiente | | Delegado permanente | Permitir que una autoridad configurada mueva fondos de acuerdo con la política | | Visibilidad del auditor | Permitir que los equipos de cumplimiento, contabilidad o los organismos reguladores vean la actividad del anillo | | Reglas entre anillos | Permitir o bloquear movimientos entre anillos específicos | | Reglas de retiro | Restringir los retiros públicos o exigir aprobación | | Compatibilidad con cuentas inteligentes | Permitir el uso nativo con cuentas inteligentes como Squads | | Recuperación de cuentas | Permitir que una autoridad configurada o una identidad alternativa recupere cuentas | Estos conjuntos de reglas personalizadas se programan como un programa dedicado de Solana que verifica la transición de estado de cada transferencia aplicable antes de liquidarla de forma atómica en cadena mediante el Protocolo de Privacidad de Solana (TSPP). ## Administración de Anillos ### Informes de Anillos Usa los informes de anillos para tesorería, contabilidad, cumplimiento o tu propio conjunto de reglas de visibilidad. ```bash theme={"system"} curl "https://privacy.helius.xyz/v1/rings/ring_acme_usdc/transactions?limit=100" \ -H "Authorization: Bearer $HELIUS_API_KEY" ``` Respuesta de ejemplo: ```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" } } ] } ``` El acceso del auditor es de solo lectura. Un auditor puede ver los datos configurados mediante la política del anillo, pero no puede firmar, gastar, congelar ni mover fondos, a menos que también esté configurado como autoridad. ### Congelar o descongelar una Billetera privada Si el Anillo personalizado tiene una autoridad de congelación, puedes congelar o descongelar una Billetera privada de acuerdo con la 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" } }' ``` Respuesta de ejemplo: ```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" } }' ``` ## Monitoreo mediante webhooks Usa webhooks para recibir actualizaciones del ciclo de vida de las transferencias. ```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 ejemplo: ```json theme={"system"} { "type": "private_wallet.transaction_confirmed", "ringId": "ring_acme_usdc", "owner": "9xQeWvG816bUx9EPf...", "privateWalletId": "pw_2W6Qk...", "signature": "3jd...", "slot": 291044120 } ``` ## Propiedades de seguridad y privacidad * Las claves de API de Helius autentican proyectos empresariales. No autorizan gastos. La autorización de gastos requiere una firma de billetera, una autorización alternativa mediante el servicio de administración de claves subyacente (como Privy o Turnkey) o, si está configurada, la política del anillo. * El material de claves privadas se almacena en una infraestructura segura administrada por el Proveedor de billeteras. * Helius no recibe ni exporta claves privadas de gasto. * En el modo de descifrado delegado, la billetera y el proveedor comparten una clave de visualización. El proveedor puede consultar saldos e historiales, pero no puede autorizar gastos. * Los auditores de Anillos personalizados pueden ver la actividad configurada del anillo, pero no pueden gastar. * Las transacciones hacia un Anillo personalizado o dentro de él invocan públicamente su programa de políticas. * Los cofirmantes aprueban determinadas transferencias, pero no pueden gastar por sí solos, a menos que la política lo permita. * Las autoridades de congelación solo pueden congelar o descongelar saldos si la política del anillo lo permite. * Los delegados permanentes solo pueden mover saldos si están configurados explícitamente en la política del anillo. * Las transferencias privadas dentro de un anillo no revelan el activo ni el monto en cadena. Un anillo confidencial revela al remitente y al destinatario; un anillo anónimo utiliza un retransmisor y no revela a ninguna de las partes. La política del anillo puede especificar visibilidad adicional. * Los retiros revelan el destino, el activo y el monto. * Los depósitos públicos de criptomonedas revelan el origen, el activo y el monto. La conversión desde un saldo en moneda fiduciaria mantiene privados el activo y el monto (cifrados en cadena). * Las transferencias públicas revelan al remitente, al destinatario, el activo y el monto. ## 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)