Einführung in Rings
Jede Transaktion auf Solana ist öffentlich lesbar: Adressen, Guthaben und der Übertragungsverlauf sind für alle sichtbar. Rings verschlüsseln Onchain-Guthaben und sind standardmäßig immer nicht-verwahrend:- In vertraulichen Rings sind Asset und Betrag privat, während Absender und Empfänger sichtbar bleiben.
- In anonymen Rings sind Asset, Betrag, Absender und Empfänger privat.
- Der Default Ring ist erlaubnisfrei und vertraulich. Er verschlüsselt Asset und Betrag, kann von allen verwendet werden und bietet keine benutzerdefinierten Richtlinienkontrollen.
- Custom Rings sind Solana-Programme, die Datenschutz auf Solana programmierbar machen, ähnlich wie Token-2022. Ein Custom Ring kann vertraulich oder anonym sein und benutzerdefinierte Regeln für Richtlinien, Berichte und Sichtbarkeit enthalten.
Für die meisten Anwendungen empfehlen wir den erlaubnisfreien, vertraulichen Default Ring.
Wenn du benutzerdefinierte Richtlinien und Compliance-Kontrollen benötigst, kontaktiere uns, um mit einem Custom Ring zu beginnen.
Custom Rings sind programmierbar
Custom Rings sind einfache Solana-Programme, die Datenschutz programmierbar machen und ähnliche Funktionen wie Token-2022 bieten. Ein Custom Ring kann vollständig benutzerdefinierte Regeln für Übertragungen sowie Sichtbarkeit und Prüfungen definieren.Example Custom Ring policies
Example Custom Ring policies
Nutzerabläufe und Datenschutzgarantien
Transaktionen mit Helius Privacy werden nativ onchain ausgeführt und lassen sich in einer einzelnen Transaktion mit anderen Solana-Programmen kombinieren. Nutzer können einem Ring beitreten, innerhalb eines Rings private Übertragungen ausführen oder ihn verlassen: 1. Einzahlung oder On-Ramp. Nutzer senden Token von einem öffentlichen Solana-Guthaben oder Fiat-Guthaben direkt an ein privates Guthaben. 2. Private Übertragung. Nutzer senden Token zwischen privaten Guthaben im selben Ring oder an einen anderen Ring. 3. Auszahlung oder Off-Ramp. Nutzer senden Token von einem privaten Guthaben an ein öffentliches Solana-Guthaben oder direkt an ein Fiat-Guthaben.Einzahlung auf ein privates Guthaben: Was ist privat?
Nutzer können auf zwei Arten auf ein privates Guthaben einzahlen:- On-Ramp von einem Fiat-Guthaben auf ein privates Kryptoguthaben
- Einzahlung von einem öffentlichen auf ein privates Kryptoguthaben
- On-ramp from fiat balance
- Deposit from public crypto balance
Anders als bei einer Einzahlung aus einem öffentlichen Guthaben bleiben der Vermögenswert und der Betrag beim On-Ramping auf ein privates Guthaben privat. Der Anbieter überträgt die Mittel aus seiner privaten Wallet in deine. In einem vertraulichen Ring sind nur die Adressen des Absenders und des Empfängers öffentlich.
Private Übertragung: Was ist privat?
Nutzer können eine private Übertragung auf zwei Arten senden:- Übertragung innerhalb desselben Rings
- Übertragung an einen anderen Ring
Für die meisten Anwendungen empfehlen wir den erlaubnisfreien, vertraulichen Default Ring.
Wenn du benutzerdefinierte Richtlinien und Compliance-Kontrollen benötigst, kontaktiere uns, um mit einem Custom Ring zu beginnen.
- Default Ring
- Custom Rings
Auszahlung von einem privaten Guthaben: Was ist privat?
Nutzer können auf zwei Arten von einem privaten Guthaben auszahlen:- Off-Ramp von privatem Kryptoguthaben auf ein Fiat-Guthaben
- Auszahlung von privatem Kryptoguthaben auf ein öffentliches Kryptoguthaben
- Off-ramp to fiat balance
- Withdraw to public crypto balance
Anders als bei einer Auszahlung auf ein öffentliches Guthaben bleiben Vermögenswert und Betrag beim Off-Ramping von einem privaten Guthaben privat. Du überträgst das Guthaben von deiner privaten Wallet an die private Wallet des Anbieters. Der Anbieter zahlt dir den Betrag in Fiatwährung aus. In einem vertraulichen Ring sind nur die Adressen von Absender und Empfänger öffentlich. Dein verbleibendes privates Guthaben bleibt privat.
Allgemeiner Transaktionsablauf
Eine private Übertragung verhält sich ähnlich wie eine öffentliche Übertragung und wird in einer einzelnen Solana-Transaktion ausgeführt.- Private transfer
- Solana transfer
- Das SOL- oder SPL-Guthaben des Nutzers wird onchain verschlüsselt.
- Rufe den verschlüsselten Zustand ab und entschlüssele ihn lokal. Alternativ entschlüsselt ein beauftragter Anbieter den Zustand und stellt ihn entschlüsselt bereit.
- Die Wallet legt Betrag und Empfänger fest und fordert dann einen ZK-Beweis an.
- Der RPC-Anbieter generiert den ZK-Beweis standardmäßig und gibt ihn zurück. Ein Custom Ring erfordert zusätzlich einen Richtlinienbeweis.
- Die Wallet erstellt die Solana-Transaktion. ZK-Beweise werden geprüft, ohne den verschlüsselten Zustand offenzulegen. Welche Programme aufgerufen werden und wer signiert und übermittelt, hängt vom Ring ab:
- Die App verfolgt den Status über den Hash der Solana-Transaktion.
- Permissionless Confidential Ring
- Custom Confidential Ring
- Custom Anonymous Ring
Private Wallet
Nutzer verwahren ihr verschlüsseltes Guthaben in einem Private Wallet. Das Private Wallet empfängt Übertragungen unter der öffentlichen Solana-Adresse des Nutzers und dient alsinbox.
So gibt der Absender wie bei öffentlichen Übertragungen immer die Solana-Adresse des Empfängers ein.
Erstellen eines Private Wallet
Beim Erstellen eines Private Wallet wird die Solana-Adresse in einer Onchain-Registry registriert. Die Registry ordnet eine Solana-Adresse genau einer zu. Übertragungen werden im Hintergrund für die Shielded Address verschlüsselt. Mehrere Solana-Adressen können sich nicht dieselbe Shielded Address teilen. Jeder Registry-Eintrag ist eine PDA, die dem gehört. Jeder kann darin nachsehen, ob eine Solana-Adresse private Übertragungen empfangen kann.In deiner Wallet-App kannst du Nutzern erlauben, Private Wallets nur für einen dedizierten öffentlichen Schlüssel des „Private Wallet“
oder für jeden öffentlichen Schlüssel zu erstellen.
Übertragungen an ein Private Wallet
Bei jeder Übertragung sucht die Privacy API die Wallet-Adresse in der Onchain-Registry, um zu prüfen, ob der Empfänger ein Private Wallet hat. Bei einem Treffer verwendet sie im Hintergrund die Shielded Address, um die Übertragung zu verschlüsseln.Wenn der Empfänger einer privaten Übertragung kein Private Wallet hat, löst die Privacy API die Übertragung als Auszahlung von privat zu öffentlich auf.Wir empfehlen, in der UI eine separate Nutzersignatur anzufordern. So stellst du sicher, dass der Nutzer nicht versehentlich auf ein öffentliches Guthaben auszahlt.
Schlüsselverwaltung
Ein Private Wallet ergänzt eine Solana-Wallet aus deinem Solana-Schlüsselpaar um ein abgeschirmtes Schlüsselpaar.
Das abgeschirmte Schlüsselpaar ist ein Paket aus Signatur-, Nullifier- und Anzeigeschlüsseln. Es ist kein Solana-Schlüsselpaar.
Die Shielded Address besteht aus den öffentlichen Schlüsseln des abgeschirmten Schlüsselpaars. Übertragungen werden für sie verschlüsselt.
Ein abgeschirmtes Schlüsselpaar erstellen
Eine Wallet kann das abgeschirmte Schlüsselpaar auf zwei Arten erstellen.-
Schlüssel aus der Seed-Phrase ableiten.
- Der empfohlene Ansatz für Seed-basierte Wallets.
- Vertrauliche Rings: Der Signaturschlüssel ist derselbe Ed25519-Schlüssel, den eine Solana-Wallet aus diesem Seed ableitet. Nullifier- und Anzeigeschlüssel sind zusätzliche Schlüssel, die aus demselben Seed abgeleitet werden.
- Anonyme Custom Rings: Der Signaturschlüssel ist ein zusätzlicher P-256-Schlüssel, der aus dem Wallet-Seed abgeleitet wird.
- Du kannst das abgeschirmte Schlüsselpaar immer auf dieselbe Weise wiederherstellen wie die Solana-Wallet.
-
Schlüssel mit dem vorhandenen Solana-Schlüssel aus einer festen Nachricht ableiten.
- Solana-Signaturen sind deterministisch. Daher erzeugt dasselbe Solana-Schlüsselpaar immer dasselbe abgeschirmte Schlüsselpaar. Die App erhält den privaten Schlüssel nie.
- Der empfohlene Ansatz für Tests und Wallets, die keine Seed-Phrase verwenden. Die integrierende Wallet muss sicherstellen, dass die Signatur nicht gegenüber Dritten offengelegt wird.
Ein abgeschirmtes Schlüsselpaar integrieren
Eine Wallet kann das abgeschirmte Schlüsselpaar über die native Wallet-Integration selbst verwahren. Beim Embedded Privacy Wallet verwahrt stattdessen ein Wallet-Anbieter das abgeschirmte Schlüsselpaar und führt dessen Schlüsseloperationen aus.Entschlüsselungsmodi und Wallet-Synchronisierung
Nur der Eigentümer kann das Guthaben eines Private Wallet mit einem Anzeigeschlüssel entschlüsseln. Für eine selektive Offenlegung kann ein Eigentümer einen Anzeigeschlüssel mit einem Prüfer teilen. Der Prüfer kann dann Aktivitäten lesen, aber keine Gelder ausgeben. In Custom Rings kann die Richtlinie einen Prüfer festlegen, der alle Guthaben dieses Custom Ring entschlüsseln kann. Vertrauliche Rings (der Default Ring und vertrauliche Custom Rings) unterstützen lokale und delegierte Entschlüsselung. Anonyme Rings (nur Custom Rings) unterstützen ausschließlich delegierte Entschlüsselung.Eine Wallet sollte Guthaben überall dort entschlüsseln und aktualisieren, wo sie backfill ausführt: beim Entsperren der Wallet,
Öffnen des Private Wallet, Fortsetzen der App, Wiederherstellen der Netzwerkverbindung, bei einer Lücke im stream oder beim Wiederherstellen der Wallet.
Lokale Entschlüsselung
Im lokalen Entschlüsselungsmodus entschlüsselt und synchronisiert die Wallet Guthaben und Verlauf lokal. Helius-Server erhalten weder Mnemonic noch Seed, privaten Signaturschlüssel, private Anzeigeschlüssel oder Nullifier-Geheimnis.Delegierte Entschlüsselung
Im delegierten Entschlüsselungsmodus teilen sich die Wallet und der ausgewählte Anbieter einen Anzeigeschlüssel. Dadurch kann der Anbieter Guthaben und Verlauf entschlüsseln, erhält aber keine Berechtigung, Gelder auszugeben. Eine Wallet kann auch frühere Anzeigeschlüssel teilen, wenn sie den Anbieter zur Synchronisierung historischer Aktivitäten autorisiert. Der Zugriff für Prüfer ist von der delegierten Entschlüsselung getrennt. Ein Prüfer erhält die in der Richtlinie definierte Ring-Sichtbarkeit. Ein delegierter Anbieter erhält dagegen Synchronisierungszugriff für eine bestimmte Wallet.Indexer stellt verschlüsselten Zustand bereit
So wie öffentliche Wallets auf einen Solana RPC angewiesen sind, benötigen Private Wallets einen Indexer. Der Indexer stellt den verschlüsselten Zustand bereit, den eine Wallet zum Lesen von Guthaben und Erstellen privater Transaktionen benötigt. Standardmäßig ist der Indexer über die erreichbar. Als Ausweichlösung kann jeder erlaubnisfrei einen eigenen Indexer betreiben.Guthaben des Private Wallet
Das Guthaben des Private Wallet wird onchain in privaten Solana-Token-Konten als UTXOs (nicht ausgegebene Transaktionsausgaben) gehalten, nicht in einem Solana-Token-Konto. Der Default Ring und alle Custom Rings speichern private Guthaben in einem gemeinsamen Merkle-Zustandsbaum. Das Guthaben des Private Wallet ist die Summe aller UTXOs, die einem Private Wallet gehören. Solana-Programme können UTXOs ähnlich wie reguläre Solana-Konten besitzen. Diese Dokumentation verwendet „private Solana-Token-Konten“ und „UTXOs“ synonym.Balances in UTXOs vs Solana accounts
Balances in UTXOs vs Solana accounts
Für die Nutzererfahrung spielt es keine Rolle, ob das Guthaben in UTXOs oder Solana-Token-Konten gehalten wird.Auf technischer Ebene reduziert das Ausgeben eines öffentlichen Guthabens den Wert im Feld 
amount eines Solana-Token-Kontos.
Beim Ausgeben eines privaten Guthabens wird das Feld amount eines UTXO nicht überschrieben.
Stattdessen verwenden private Transaktionen vorhandene UTXOs als Eingaben, die das SDK automatisch auswählt.
Sie verbrauchen die Eingaben und erstellen neue Ausgaben für den Empfänger und das verbleibende Guthaben des Absenders.Alice hat beispielsweise 50 USDC und sendet Bob 35.- In einem Solana-Token-Konto ändert sich ihr Feld
amountvon 50 auf 15. Bobs Wert steigt um 35. Die Zahl wird direkt geändert. - Bei UTXOs besitzt Alice eine einzelne Notiz über 50 USDC. Die Transaktion gibt sie aus und erstellt zwei neue Notizen: eine Notiz über 35 USDC für Bob und eine Wechselgeldnotiz über 15 USDC für Alice. Ihre alte 50-USDC-Notiz gilt nun als ausgegeben.
- One input note
- Multiple input notes
Bei einer Einzahlung von SOL- und SPL-Assets auf ein privates Guthaben verwahrt eine Interface-PDA des Solana Privacy Program die Token und erstellt UTXOs mit dem Nutzer als Eigentümer.Bei einer Auszahlung auf ein öffentliches Guthaben werden vorhandene UTXOs als ausgegeben markiert und die Token an die Solana-Token-Konten freigegeben.
policy_program_id gespeichert.
Private Solana-Token-Konten
Ein privates Solana-Token-Konto ist ein UTXO, das sich ähnlich wie ein Solana-Token-Konto verhält, jedoch zwei wesentliche Unterschiede aufweist:- Ein privates Solana-Token-Konto muss bei der Erstellung nicht von der Rent befreit werden und
- sein Guthaben ist onchain verschlüsselt.
- Asset: der Mint, dessen Einheiten das UTXO enthält. SOL ist die standardmäßige Mint-Adresse. Das Asset kann SOL oder ein beliebiges SPL- oder Token-2022-Asset sein.
- Betrag: die Anzahl der Einheiten von
asset, die die Notiz enthält, angegeben in der kleinsten Einheit des Assets. - Programm- und Richtliniendaten: optionale Daten, mit denen die konfigurierte Ring-Richtlinie ähnliche Funktionen wie Token-2022 ergänzt
- Diagram
- Code
View Solana token account
View Solana token account
- Diagram
- Code