Encrypt Solana Pre-Alpha
Normativ: Encrypt Developer Guide · mdbook in encrypt-pre-alpha docs/. Lade references/ für gRPC, Instruktionen (Ix), Abläufe.
Dokumentationsrevision: references/docs-revision.md — falls docs/ auf main neuer ist als der verfolgte Commit, informiere den Benutzer, dass der Skill veraltet sein könnte; überschreibe Skill-Dateien nicht stillschweigend.
Pre-Alpha-Haftungsausschluss
- Nur zur Erkundung – nicht für vertrauliche Produktionsdaten.
- Keine echte Verschlüsselungsgarantie – Daten können als Klartext auf der Chain liegen; übermittle keine sensiblen oder echten Daten.
- Schlüssel-/Trust-Modell nicht endgültig; Devnet wird zurückgesetzt; keine Gewährleistung. Vermarkte dies nicht als produktionsreifes FHE oder private Verwahrung für Endnutzer.
Referenzen (auf Anfrage laden)
| Datei | Laden für |
|---|---|
references/developer-guide-map.md | Buch-Inhaltsverzeichnis + URLs — vor dem Raten laden |
references/book-snapshots.md | Listet alle Buchkopien unter references/ |
references/fee-and-state-reference.md | ENC/SOL-Gebühren, sieben Account-Typen, fünf Ereignistypen |
references/docs-revision.md | docs/ vs. main |
references/grpc-api.md | EncryptService, Proto, Clients |
references/instructions.md | Diskriminatoren, Instruktionsgruppen |
references/frameworks.md | Crates, EncryptCpi, Toolchain |
references/flows.md | Lebenszyklus, Tests, CPI vs. Signer |
references/dsl-types.md | Tabellen zu EUint* / EVector* / EBitVector* / PUint* |
references/gotchas.md | Erprobte Fehler, stille Fehlschläge, BPF-Grenzen, CPI-Layout |
references/performance-caveats.md | Zeitmessung, REFHE vs. TFHE, unbekannte Bootstrap-Kosten |
Installation & Werkzeuge
TS: @encrypt.xyz/pre-alpha-solana-client + createEncryptClient — grpc-api.md. Rust 2024, Solana CLI 3.x (build-sbf), Bun, just test-unit / test-examples — frameworks.md, flows.md. Verwende Git-Crates gemäß dem Cargo.toml des Upstreams.
Umgebung (Pre-Alpha)
| Ressource | Wert |
|---|---|
| Encrypt gRPC (TLS) | https://pre-alpha-dev-1.encrypt.ika-network.net:443 |
| Solana RPC | https://api.devnet.solana.com (typisch) |
| Encrypt-Programm-ID | 4ebfzWdKnrnGseuQpezXdG8yCdHqwQ1SSBHD3bWArND8 |
| Quellrepository | https://github.com/dwallet-labs/encrypt-pre-alpha |
Kanonisch: Programm-ID, gRPC-URL, Solana-RPC, Git-Remote – nur der Hub; richte Beispiele danach aus.
Kurzhinweise
On-Chain: Das erste Byte einer Instruktion ist der Diskriminator; 22 Benutzer-Ix + emit_event 228 — instructions.md. Häufiger Pfad: Diskriminatoren 1–4 (create_input_ciphertext … execute_graph); vollständige Metas: Instruktionsreferenz.
gRPC: encrypt.v1.EncryptService — CreateInput, ReadCiphertext — grpc-api.md.
Modell: #[encrypt_fn] (Skalare) oder #[encrypt_fn_graph] (Skalare + Vektoren) → Graph → on-chain execute_graph / Chiffrat-Konten → Executor + commit_ciphertext; Entschlüsselung über Gateway-Instruktion — flows.md, Einführung. Erprobte Fallstricke (Executor-Fehler, stille Fehlschläge, BPF-Grenzen, CPI-Layout): gotchas.md. Leistung (REFHE vs. TFHE, Timing-Vorbehalte): performance-caveats.md. Nur im Buch (DSL inkl. EVector* / EBitVector*, Tutorial, PC-Token/Swap, Gebühren, Schemata): developer-guide-map.md, book-snapshots.md, fee-and-state-reference.md.
Häufige Fehler
| Fehler | Stattdessen |
|---|---|
| Annahme, dass Pre-Alpha-Chiffrate geheim sind | Behandle sie als öffentlich / klartextfähig (Buch + Repository). |
Verwendung von #[encrypt_fn] mit Vektortypen | Vektoren fehlt HasFheTypeId – verwende #[encrypt_fn_graph] aus encrypt-dsl und führe CPI manuell aus. Siehe gotchas.md. |
| Behandlung von Devnet-Commit-Zeiten als FHE-Benchmarks | Pre-Alpha führt keine echte FHE aus – alle Zeitmessungen sind simulierte Overhead-Werte. Siehe performance-caveats.md. |
Falscher CreateInput authorized / network_encryption_public_key | Stimme mit NetworkEncryptionKey + Zugriffsregeln überein — grpc-api.md. |
| Encrypt vs. ika dWallet | ika-Signierung / approve_message → ika-solana-prealpha-Skill, nicht dieser hier. |
Patchen des Skills, wenn sich docs/ im Upstream geändert hat | Benutzer benachrichtigen — docs-revision.md. |
| Vergessen von Encrypt-Gebühren / Einzahlungen / Ereignissen | Nicht ika-förmig — fee-and-state-reference.md + book-snapshots.md. |
Beispiele: encrypt-pre-alpha chains/solana/examples.