Anillos personalizados para empresas

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á:

Crear billeteras privadas para cuentas de clientes, comercios o tesorería
Depositar monedas estables desde billeteras públicas en billeteras privadas
Enviar pagos privados entre billeteras privadas
Retirar fondos a direcciones y billeteras públicas de Solana
Consultar saldos privados e historiales mediante la API
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.
Configurar quién puede ver, aprobar, congelar o mover fondos dentro de un anillo
Dar seguimiento al estado de los pagos privados mediante sondeo o webhooks

Launch Demo

Prueba transferencias y swaps confidenciales en devnet.

Terms

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

curl "https://privacy.helius.xyz/v1/rings/ring_acme_usdc/transactions?limit=100" \
  -H "Authorization: Bearer $HELIUS_API_KEY"

Respuesta de ejemplo:

{
  "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.

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:

{
  "id": "pw_2W6Qk...",
  "status": "frozen",
  "reason": "compliance_review"
}

Descongelar:

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.

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:

{
  "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 | E-Mail | Contact

Primeros pasos

Streaming de datos y escucha de eventos

API de datos y RPC

Trading

Envío de transacciones

Billetera como servicio

Privacidad

Recursos

Anillos personalizados para empresas

Descripción general

Launch Demo

Cómo funciona

Modelo de confianza

Anillos

Los Anillos personalizados son programables

Administración de Anillos

Informes de Anillos

Congelar o descongelar una Billetera privada

Monitoreo mediante webhooks

Propiedades de seguridad y privacidad

Didn’t find what you were looking for?

​Descripción general

Launch Demo

​Cómo funciona

​Modelo de confianza

​Anillos

​Los Anillos personalizados son programables

​Administración de Anillos

​Informes de Anillos

​Congelar o descongelar una Billetera privada

​Monitoreo mediante webhooks

​Propiedades de seguridad y privacidad

​Didn’t find what you were looking for?

Descripción general

Cómo funciona

Modelo de confianza

Anillos

Los Anillos personalizados son programables

Administración de Anillos

Informes de Anillos

Congelar o descongelar una Billetera privada

Monitoreo mediante webhooks

Propiedades de seguridad y privacidad

Didn’t find what you were looking for?