> ## 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.
# Anneaux Personnalisés pour Entreprises
> Ajoutez des paiements et des soldes en stablecoins privés sur Solana via l'API du portefeuille privé, avec des contrôles de politique et de conformité programmables pour les institutions.
Ce guide est destiné aux fintechs, émetteurs, plateformes de paie, entreprises de transfert d'argent, néobanques et entreprises qui souhaitent des comptes de paiement privés combinés avec les avantages de la blockchain.
## Vue d'ensemble
Votre entreprise pourra :
1. Créer des portefeuilles privés pour les comptes clients, marchands ou trésorerie
2. Déposer des stablecoins depuis des portefeuilles publics vers des portefeuilles privés
3. Envoyer des paiements privés entre portefeuilles privés
4. Retirer vers des adresses et portefeuilles publics Solana
5. Voir les soldes et historiques privés via l'API
6. Définir des Anneaux Personnalisés dédiés avec vos propres règles de conformité, d'audit et d'entreprise.
Vous pouvez soit apporter votre propre conformité, soit utiliser la solution de gestion KYC et de filtrage des sanctions de Helius.
7. Configurer qui peut voir, approuver, geler ou déplacer des fonds à l'intérieur d'un anneau
8. Suivre le statut des paiements privés via le polling ou les webhooks
Essayez les transferts et échanges confidentiels sur devnet.
| Terme | Signification |
| --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Entreprise | La société intégrant Helius Privacy |
| Portefeuille Privé | Un compte de paiement avec des soldes et transferts chiffrés en chaîne |
| Fournisseur de Portefeuille | Le système qui gère les comptes utilisateurs, signataires, comptes intelligents ou portefeuilles de trésorerie et détient des clés de confidentialité non exportables. Exemples : Turnkey, Privy, Squads, Rain, ou une pile de garde interne |
| Propriétaire | La clé publique Solana, compte intelligent ou signataire soutenu par le fournisseur qui autorise les actions du Portefeuille Privé |
| Boîte de Réception | La clé publique Solana utilisée comme adresse de réception publique pour un Portefeuille Privé |
| Anneau | Un groupe de portefeuilles privés avec des soldes dans l'Anneau par Défaut ou un Anneau Personnalisé |
| Anneau par Défaut | L’Anneau confidentiel sans permission ; l’actif et le montant sont privés alors que l’expéditeur et le destinataire restent publics. Pas de politique, d'autorité ou d’auditeur personnalisé |
| Anneau Personnalisé | Un anneau configuré avec des règles, une visibilité et des autorités personnalisées |
| Auditeur | Un spectateur configuré pour un Anneau Personnalisé. Les auditeurs peuvent lire les données de l'anneau mais ne peuvent pas dépenser |
| Co-signataire | Un signataire configuré en option qui doit approuver les transferts sélectionnés |
| Autorité de Gel | Une autorité configurée qui peut geler ou dégeler les soldes lorsque la politique le permet |
| Délégué Permanent | Une autorité configurée qui peut déplacer les soldes à l'intérieur d'un anneau lorsque la politique le permet |
| API de Confidentialité | API Helius pour créer des Portefeuilles Privés, lire les soldes/historiques, préparer les transferts, générer des preuves et soumettre des transactions |
## Comment ça marche
Un Portefeuille Privé est l'objet central de l'API avec lequel vous interagissez. Vous pouvez associer un Portefeuille Privé à, par exemple, un compte client, un compte marchand, un compte employé, un compte de trésorerie ou un compte intelligent.
Les soldes et transferts privés sont chiffrés en chaîne. Les fournisseurs RPC tels que Helius indexent l'état chiffré, génèrent des preuves, construisent des transactions et les soumettent à Solana à la demande.
Pour la plupart des cas d'utilisation des entreprises, les Portefeuilles Privés vivent à l'intérieur d'un Anneau Personnalisé dédié. L'anneau définit les règles pour les transferts, la visibilité et la conformité.
Voici comment Helius Privacy s'intègre dans votre pile :
### Modèle de Confiance
| Composant | Responsabilité |
| ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Application d'Entreprise | Interface utilisateur du produit, authentification client, flux de travail d'entreprise |
| Fournisseur de Portefeuille | Garde des comptes, signataires, politique d'approbation et clés de confidentialité non exportables avec opérations clés contrôlées par la politique |
| API de Confidentialité / Fournisseur RPC | API de Portefeuille Privé, synchronisation, état, preuve, construction de transactions, éventuellement audit, et soumission de transactions au réseau Solana |
| Anneau Personnalisé | Règles d'affaires, règles de conformité, règles de visibilité, autorités optionnelles, spécifiées via des instructions de programme personnalisées en chaîne |
| Solana | Exécution et règlement |
Les paiements privés requièrent une autorisation par le portefeuille privé et doivent se conformer à la politique respective de l'anneau.
Les anneaux confidentiels (l'Anneau par Défaut et les Anneaux Personnalisés confidentiels) prennent en charge le déchiffrement local et délégué. Les Anneaux Personnalisés anonymes ne prennent en charge que le déchiffrement délégué.
En mode déchiffrement délégué, le portefeuille et le fournisseur RPC sélectionné partagent une clé de visualisation.
Le fournisseur peut servir les soldes et l'historique mais ne peut pas autoriser les dépenses.
Cela est distinct d'un auditeur, dont la visibilité est définie par la politique de l'Anneau.
Vous pouvez exécuter l'infrastructure (RPC, indexeur, serveur d'auditeur ou co-signataire) vous-même, ou utiliser un fournisseur RPC tel que Helius pour l'exécuter pour vous.
Nous exécutons l'infrastructure à travers notre flotte mondiale de RPC performant, et éventuellement via une configuration dédiée personnalisable selon vos besoins.
Une infrastructure dédiée n'implique pas un arbre d'état en chaîne séparé.
Les Anneaux Personnalisés et l’Anneau par Défaut sans permission partagent un arbre de Merkle.
### Anneaux
Les anneaux rendent la confidentialité sur Solana programmable, similaire à Token-2022.
L'Anneau par Défaut est sans permission et n'a pas de politique personnalisée. Un Anneau Personnalisé est régi par ses propres règles de politique.
Un Portefeuille Privé peut détenir des soldes dans plusieurs Anneaux en même temps. À quel Anneau appartient un solde n'est pas une propriété du portefeuille. C’est une propriété de chaque UTXO, stockée dans son champ `policy_program_id`.
* L'anneau par défaut est confidentiel et sans permission, sans aucune politique, auditeurs ou autorités. Les anneaux confidentiels cryptent l'actif et le montant.
* Les anneaux personnalisés peuvent être configurés avec des contrôles de politique et de conformité personnalisés et être confidentiels ou anonymes (actifs cryptés, montant, expéditeur, destinataire).
Un portefeuille privé peut retirer d'un Anneau Personnalisé vers un compte de jeton public, vers l’Anneau par Défaut confidentiel et sans permission, ou vers un autre
Anneau Personnalisé si la politique de l'anneau source le permet.
#### Les Anneaux Personnalisés sont Programmables
Un Anneau Personnalisé peut définir des règles entièrement personnalisées pour les transferts et la visibilité/l'audit.
Si vous souhaitez configurer votre propre Anneau Personnalisé, [contactez-nous](https://www.helius.dev/contact) et nous vous aiderons à le mettre en place.
Vous pouvez soit apporter votre propre conformité, soit utiliser la solution de gestion KYC et de filtrage des sanctions de Helius.
Les anneaux sont programmables. Exemples courants de règles :
| Politique | Exemple |
| ---------------------------------------- | ---------------------------------------------------------------------------------------------- |
| Actifs autorisés | Seulement USDC ou un stablecoin émis spécifique |
| Limites de transfert | Nécessitent une approbation supplémentaire au-dessus d'un seuil |
| Co-signature | Nécessitent une approbation de conformité pour les paiements sélectionnés |
| Listes blanches | Autorisent uniquement les transferts vers des comptes, marchands ou anneaux approuvés |
| Listes noires | Bloquer les destinations sanctionnées ou risquées |
| Gel/dégel | Geler un solde en attente d'une enquête |
| Délégué permanent | Autoriser une autorité configurée à déplacer des fonds sous politique |
| Visibilité de l'auditeur | Permettre à la conformité, à la comptabilité ou aux régulateurs de voir l'activité de l'anneau |
| Règles inter-anneaux | Autoriser ou bloquer les déplacements entre anneaux spécifiques |
| Règles de retrait | Limiter les retraits publics ou nécessiter une approbation |
| Prise en charge des comptes intelligents | Permettre l'utilisation native avec des comptes intelligents tels que Squads |
| Récupération de compte | Permettre à une autorité configurée ou une identité de repli de récupérer des comptes |
Ces ensembles de règles personnalisées sont programmés en tant que programme Solana dédié qui vérifie chaque transition d'état de transfert applicable avant qu'elle ne se règle atomiquement en chaîne via le Protocole de Confidentialité Solana (TSPP).
## Administration de l'Anneau
### Rapport de l'Anneau
Utilisez le rapport de l'anneau pour la trésorerie, la comptabilité, la conformité ou vos propres règles de visibilité.
```bash theme={"system"}
curl "https://privacy.helius.xyz/v1/rings/ring_acme_usdc/transactions?limit=100" \
-H "Authorization: Bearer $HELIUS_API_KEY"
```
Exemple de réponse :
```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"
}
}
]
}
```
L'accès de l'auditeur est en lecture seule. Un auditeur peut voir les données configurées par la politique de l'anneau, mais ne peut pas signer, dépenser, geler ou déplacer des fonds à moins d'être configuré séparément en tant qu'autorité.
### Geler ou Dégeler un Portefeuille Privé
Si l'Anneau Personnalisé a une autorité de gel, vous pouvez geler ou dégeler un Portefeuille Privé selon la politique.
```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"
}
}'
```
Exemple de réponse :
```json theme={"system"}
{
"id": "pw_2W6Qk...",
"status": "frozen",
"reason": "compliance_review"
}
```
Dégel :
```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"
}
}'
```
## Surveillance via Webhooks
Utilisez les webhooks pour les mises à jour du cycle de vie des transferts.
```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"
}'
```
Exemple d'événement :
```json theme={"system"}
{
"type": "private_wallet.transaction_confirmed",
"ringId": "ring_acme_usdc",
"owner": "9xQeWvG816bUx9EPf...",
"privateWalletId": "pw_2W6Qk...",
"signature": "3jd...",
"slot": 291044120
}
```
## Propriétés de Sécurité et de Confidentialité
* Les clés API de Helius authentifient les projets d'entreprise. Elles n'autorisent pas les dépenses. L'autorisation de dépense nécessite une signature de portefeuille, une autorisation alternative via le service de gestion des clés sous-jacent (tel que Privy ou Turnkey), ou, si configuré, la politique de l'anneau.
* Le matériel clé privé est détenu dans une infrastructure sécurisée gérée par le Fournisseur de Portefeuille.
* Helius ne reçoit ni n'exporte de clés de dépenses privées.
* En mode déchiffrement délégué, le portefeuille et le fournisseur partagent une clé de visualisation. Le fournisseur peut lire les soldes et l'historique mais ne peut pas autoriser les dépenses.
* Les auditeurs des Anneaux Personnalisés peuvent voir l'activité configurée de l'anneau mais ne peuvent pas dépenser.
* Les transactions vers ou au sein d'un Anneau Personnalisé invoquent publiquement son programme de politique.
* Les co-signataires approuvent les transferts sélectionnés mais ne peuvent pas dépenser seuls à moins que la politique ne le permette.
* Les autorités de gel peuvent geler ou dégeler les soldes uniquement si la politique de l'anneau le permet.
* Les délégués permanents peuvent déplacer des soldes uniquement s'ils sont explicitement configurés dans la politique de l'anneau.
* Les transferts privés à l'intérieur d'un anneau ne révèlent pas l'actif ou le montant en chaîne. Un anneau confidentiel révèle l'expéditeur et le destinataire ; un anneau anonyme utilise un relais et ne révèle ni l'un ni l'autre. La politique de l'anneau peut spécifier une visibilité supplémentaire.
* Les retraits révèlent la destination, l'actif et le montant.
* Les dépôts crypto publics révèlent la source, l'actif et le montant. L'intégration depuis un solde fiat garde l'actif et le montant privés (chiffrés en chaîne).
* Les transferts publics révèlent l'expéditeur, le destinataire, l'actif et le montant.
## 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)