Skip to main content

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.
Two Solana transaction cards side by side. The confidential card shows the transaction hash, sender, and recipient while the asset and amount are blacked out. The anonymous card shows only the transaction hash; the sender, asset, amount, and recipient are all blacked out. The transaction hash stays public on both. Es gibt verschiedene Arten von Rings:
  1. Der Default Ring ist erlaubnisfrei und vertraulich. Er verschlüsselt Asset und Betrag, kann von allen verwendet werden und bietet keine benutzerdefinierten Richtlinienkontrollen.
  2. 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.
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.

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.
Ring-Autoritäten werden bei der Erstellung des Rings festgelegt. Nutzer können die Richtlinie daher prüfen, bevor sie einen Ring auswählen. Der Default Ring ist erlaubnisfrei und hat weder eine benutzerdefinierte Autorität noch einen Prüfer.
Wenn du einen eigenen Custom Ring einrichten möchtest, kontaktiere uns. Wir richten ihn für dich ein. Du kannst entweder deine eigene Compliance-Lösung mitbringen oder die verwaltete KYC- und Sanktionsprüfung von Helius verwenden.

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. Diagram of the Ring lifecycle. A public balance of 100 USDC deposits into a Ring and a fiat balance of USD / EUR / ... on-ramps into the same Ring, funds move between two private balances via private transfer, then withdraw to a public balance or off-ramp to a fiat balance. Nutzer senden Token wie bei öffentlichen Guthaben an eine Solana-Wallet-Adresse. Die Privacy API leitet die Übertragung automatisch an das Private Wallet weiter, wenn der Empfänger eines hat. Andernfalls wird die Übertragung als Auszahlung an die öffentliche Adresse des Empfängers ausgeführt. Jeder kann auf jedes Private Wallet einzahlen, wenn nur die öffentliche Wallet-Adresse des Empfängers bekannt ist. Wenn die App des Absenders keinen Datenschutz unterstützt, erhält der Empfänger die Gelder öffentlich und kann sie in einem zweiten Schritt in sein eigenes privates Guthaben verschlüsseln.

Einzahlung auf ein privates Guthaben: Was ist privat?

Nutzer können auf zwei Arten auf ein privates Guthaben einzahlen:
  1. On-Ramp von einem Fiat-Guthaben auf ein privates Kryptoguthaben
  2. Einzahlung von einem öffentlichen auf ein privates Kryptoguthaben
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:
  1. Übertragung innerhalb desselben Rings
  2. Ü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.

Auszahlung von einem privaten Guthaben: Was ist privat?

Nutzer können auf zwei Arten von einem privaten Guthaben auszahlen:
  1. Off-Ramp von privatem Kryptoguthaben auf ein Fiat-Guthaben
  2. Auszahlung von privatem Kryptoguthaben auf ein öffentliches Kryptoguthaben
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.
  1. Das SOL- oder SPL-Guthaben des Nutzers wird onchain verschlüsselt.
  2. 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.
  3. Die Wallet legt Betrag und Empfänger fest und fordert dann einen ZK-Beweis an.
  4. Der RPC-Anbieter generiert den ZK-Beweis standardmäßig und gibt ihn zurück. Ein Custom Ring erfordert zusätzlich einen Richtlinienbeweis.
  5. 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:
  1. Die App verfolgt den Status über den Hash der Solana-Transaktion.

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 als inbox. 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. User wallet showing two public Solana wallets and a private wallet. An inbox arrow connects Public Wallet A's public key to the private wallet's Shielded Address.
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.
  1. 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.
  2. 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. A Private Wallet connected by dashed lines to several UTXO notes, each holding one amount of one asset. The wallet balance is the sum of the notes.
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 amount von 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.
Alice sends Bob 35 of her 50 USDC. On a Solana token account the amount field changes in place from 50 to 15. With UTXOs, Alice's single 50 USDC note is spent and two new notes are created: a 35 USDC note for Bob and a 15 USDC change note for Alice.
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.
Ein Private Wallet kann gleichzeitig Guthaben in beliebig vielen Rings halten. Der Ring, zu dem ein Guthaben gehört, ist keine Eigenschaft der Wallet. Er ist eine Eigenschaft jedes UTXO und wird in dessen Feld 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.
Private Solana-Token-Konten speichern dennoch dieselben Daten, darunter:
  • 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
A Private Solana Token Account. The Solana Privacy Program owns a Private Token Account, which expands into its PrivateAccount fields: owner, asset, amount, policy data, and policy program id.
A Solana Token Account. The Token Program owns a Token Account, expanded into its AccountInfo fields (Data, Executable, Lamports, Owner) and the Data field expanded into Account Data (Mint, Owner, Amount).

Nebenläufigkeit

Nutzer können private Guthaben ausgeben, sobald Transaktionen final sind. Das Guthaben eines Schlüsselpaars kann also gleichzeitig verwendet werden, wenn es auf mehrere UTXOs verteilt ist. Die Wallet wählt aus, welche UTXOs ausgegeben werden. Ein Merkle-Baum speichert den privaten Zustand für den erlaubnisfreien Default Ring und alle Custom Rings. Der Baum wird in einem einzelnen beschreibbaren Solana-Konto gespeichert. Private Übertragungen, die in dieses Konto schreiben, teilen sich Solanas write-lock-Limit von 12 Millionen CU pro Konto und Block. Eine private Übertragung verbraucht etwa 220.000 CU. Ein Baum unterstützt daher ungefähr 54 private Übertragungen pro Block oder bei den aktuellen Solana-Blockzeiten von etwa 400 Millisekunden ungefähr 130 Transaktionen pro Sekunde. Das Protokoll kann weitere Bäume hinzufügen, um den Durchsatz zu erhöhen. Jeder Baum ist ein separates beschreibbares Konto mit einem eigenen Compute-Budget pro Konto. Transaktionen auf verschiedenen Bäumen konkurrieren daher nicht um dasselbe write-lock-Budget.

Dauer der Beweisgenerierung

Zero-Knowledge-Beweise werden derzeit von einem Prover-Server generiert. Eine typische vertrauliche Übertragung wird innerhalb weniger Dutzend Millisekunden bewiesen. Lokale Beweisgenerierung für vertrauliche Rings ist geplant. Die Beweisgenerierung wird aktiv optimiert, um eine reibungslose Nutzererfahrung sicherzustellen.

Begriffe

Nicht gefunden, wonach du gesucht hast?

Melde dich! Telegram | E-Mail | Kontakt