encrypt solana pré-alpha
Normativo: Guia do Desenvolvedor Encrypt · mdbook em encrypt-pre-alpha docs/. Carregue references/ para gRPC, ix, fluxos.
Revisão da documentação: references/docs-revision.md — se docs/ em main estiver além do commit registrado, informe o usuário que o skill pode estar desatualizado; não reescreva silenciosamente os arquivos do skill.
Aviso pré-alpha
- Apenas exploração — não é confidencial para produção.
- Nenhuma garantia real de criptografia — os dados podem estar em texto puro na blockchain; não envie dados sensíveis ou reais.
- Chaves / modelo de confiança não finalizados; redes devnet são reiniciadas; nenhuma garantia. Não comercialize como FHE de produção ou custódia privada para usuários finais.
referências (carregar sob demanda)
| arquivo | carregar para |
|---|---|
references/developer-guide-map.md | Índice do livro + URLs — carregue antes de adivinhar |
references/book-snapshots.md | Lista todos os md de cópia do livro sob references/ |
references/fee-and-state-reference.md | Taxas ENC/SOL, sete tipos de conta, cinco tipos de evento |
references/docs-revision.md | docs/ vs main |
references/grpc-api.md | EncryptService, proto, clientes |
references/instructions.md | Discriminadores, grupos ix |
references/frameworks.md | Crates, EncryptCpi, toolchain |
references/flows.md | Ciclo de vida, testes, CPI vs signatário |
references/dsl-types.md | Tabelas EUint* / EVector* / EBitVector* / PUint* |
references/gotchas.md | Erros testados em campo, falhas silenciosas, limites BPF, layout CPI |
references/performance-caveats.md | Tempo, REFHE vs TFHE, custos de inicialização desconhecidos |
instalação e ferramentas
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. Fixe crates git conforme Cargo.toml upstream.
ambiente (pré-alpha)
| recurso | valor |
|---|---|
| gRPC Encrypt (TLS) | https://pre-alpha-dev-1.encrypt.ika-network.net:443 |
| RPC Solana | https://api.devnet.solana.com (típico) |
| id do programa Encrypt | 4ebfzWdKnrnGseuQpezXdG8yCdHqwQ1SSBHD3bWArND8 |
| repositório fonte | https://github.com/dwallet-labs/encrypt-pre-alpha |
Canônico: id do programa, URL gRPC, RPC Solana, remote git — apenas hub; alinhe amostras.
dicas rápidas
On-chain: primeiro byte da ix = discriminador; 22 ix de usuário + emit_event 228 — instructions.md. Caminho comum: discos 1–4 (create_input_ciphertext … execute_graph); metadados completos: referência de instrução.
gRPC: encrypt.v1.EncryptService — CreateInput, ReadCiphertext — grpc-api.md.
Modelo: #[encrypt_fn] (escalares) ou #[encrypt_fn_graph] (escalares + vetores) → gráfico → on-chain execute_graph / contas de ciphertext → executor + commit_ciphertext; descriptografe via gateway ix — flows.md, introdução. Erros testados em campo (bugs do executor, falhas silenciosas, limites BPF, layout CPI): gotchas.md. Desempenho (REFHE vs TFHE, ressalvas de tempo): performance-caveats.md. Apenas livro (DSL incl. EVector* / EBitVector*, tutorial, PC-token/swap, taxas, esquemas): developer-guide-map.md, book-snapshots.md, fee-and-state-reference.md.
erros comuns
| erro | em vez disso |
|---|---|
| Assumir que ciphertexts pré-alpha são secretos | Trate como público / capaz de texto puro (livro + repositório). |
Usar #[encrypt_fn] com tipos vetoriais | Vetores não possuem HasFheTypeId — use #[encrypt_fn_graph] de encrypt-dsl e invoque CPI manualmente. Veja gotchas.md. |
| Tratar tempos de confirmação devnet como benchmarks FHE | Pré-alpha não executa FHE real — todos os tempos são sobrecarga simulada. Veja performance-caveats.md. |
CreateInput autorizado / chave_pública_de_criptografia_de_rede errados | Corresponda a NetworkEncryptionKey + regras de acesso — grpc-api.md. |
| Encrypt vs ika dWallet | Assinatura ika / approve_message → skill ika-solana-prealpha, não este. |
Corrigir skill quando docs/ upstream mudou | Notifique o usuário — docs-revision.md. |
| Esquecer taxas / depósitos / eventos Encrypt | Não são semelhantes a ika — fee-and-state-reference.md + book-snapshots.md. |
Exemplos: encrypt-pre-alpha chains/solana/examples.