Tesseras
Fase 3: Memórias nas Suas Mãos
2026-02-14
As pessoas agora podem segurar suas memórias nas próprias mãos. A Fase 3 entrega o que as fases anteriores construíram: um app mobile onde alguém baixa o Tesseras, cria uma identidade, tira uma foto, e aquela memória entra na rede de preservação. Sem contas na nuvem, sem assinaturas, sem nenhuma empresa entre você e suas memórias.
O que foi construído
tesseras-embedded — Um nó P2P completo que roda dentro de um app mobile. A
struct EmbeddedNode é dona de um runtime Tokio, banco SQLite, transporte QUIC,
engine Kademlia DHT, serviço de replicação e serviço de tessera — a mesma stack
do daemon desktop, compilada como biblioteca compartilhada. Um padrão singleton
global (Mutex<Option<EmbeddedNode>>) garante um único nó por ciclo de vida do
app. Ao iniciar, ele abre o banco de dados, executa migrações, carrega ou gera
uma identidade Ed25519 com proof-of-work para o node ID, faz bind QUIC numa
porta efêmera, conecta DHT e replicação, e inicia o loop de reparo. Ao parar,
envia um sinal de shutdown e drena graciosamente.
Onze funções FFI são expostas para Dart via flutter_rust_bridge: ciclo de vida
(node_start, node_stop, node_is_running), identidade (create_identity,
get_identity), memórias (create_memory, get_timeline, get_memory) e
status da rede (get_network_stats, get_replication_status). Todos os tipos
que cruzam a fronteira FFI são structs planas com apenas String,
Option<String>, Vec<String> e primitivos — sem trait objects, sem generics,
sem lifetimes.
Quatro módulos adaptadores fazem a ponte entre as ports do core e as
implementações concretas: Blake3HasherAdapter,
Ed25519SignerAdapter/Ed25519VerifierAdapter para criptografia,
DhtPortAdapter para operações DHT, e ReplicationHandlerAdapter para RPCs de
fragmentos e atestação recebidos.
A feature flag bundled-sqlite compila o SQLite a partir do código-fonte,
necessário para Android e iOS onde a biblioteca do sistema pode não estar
disponível. A configuração do Cargokit passa essa flag automaticamente em builds
de debug e release.
App Flutter — Uma aplicação Material Design 3 com gerenciamento de estado Riverpod, direcionada para Android, iOS, Linux, macOS e Windows a partir de uma única base de código.
O fluxo de onboarding são três telas: uma tela de boas-vindas explicando o projeto em uma frase ("Preserve suas memórias através dos milênios. Sem nuvem. Sem empresa."), uma tela de criação de identidade que dispara a geração do par de chaves Ed25519 em Rust, e uma tela de confirmação mostrando o nome do usuário e a identidade criptográfica.
A tela de timeline exibe memórias em ordem cronológica reversa com previews de
imagem, texto de contexto e chips para tipo de memória e visibilidade.
Pull-to-refresh recarrega a partir do nó Rust. Um floating action button abre a
tela de criação de memória, que suporta seleção de foto da galeria ou câmera
via image_picker, texto de contexto opcional, dropdowns de tipo de memória e
visibilidade, e tags separadas por vírgula. Criar uma memória chama o FFI Rust
sincronamente, depois retorna à timeline.
A tela de rede mostra dois cards: status do nó (contagem de peers, tamanho da DHT, estado de bootstrap, uptime) e saúde da replicação (total de fragmentos, fragmentos saudáveis, fragmentos em reparo, fator de replicação). A tela de configurações exibe a identidade do usuário — nome, node ID truncado, chave pública truncada e data de criação.
Três providers Riverpod gerenciam o estado: nodeProvider inicia o nó embarcado
ao abrir o app usando o diretório de documentos e para ao fazer dispose;
identityProvider carrega o perfil existente ou cria um novo;
timelineProvider busca a lista de memórias com paginação.
Testes — 9 testes unitários Rust em tesseras-embedded cobrindo ciclo de vida do nó (start/stop sem panic), persistência de identidade entre reinícios, ciclos de reinício sem corrupção do SQLite, streaming de eventos de rede, recuperação de estatísticas, criação de memória e recuperação da timeline, e busca de memória individual por hash. 2 testes Flutter: um teste de integração verificando inicialização do Rust e startup do app, e um smoke test de widget.
Decisões de arquitetura
- Nó embarcado, não cliente-servidor: o celular roda a stack P2P completa, não um thin client conversando com um daemon remoto. Isso significa que memórias são preservadas mesmo sem internet. Usuários com um Raspberry Pi ou VPS podem opcionalmente conectar o app ao seu daemon via GraphQL para maior disponibilidade, mas não é obrigatório.
- FFI síncrono: todas as funções flutter_rust_bridge são marcadas como
#[frb(sync)]e bloqueiam no runtime Tokio interno. Isso simplifica o lado Dart (sem complexidade de bridge assíncrono) enquanto o lado Rust lida com concorrência internamente. A UI thread do Flutter permanece responsiva porque o Riverpod envolve as chamadas em providers assíncronos. - Singleton global: um global
Mutex<Option<EmbeddedNode>>garante que o ciclo de vida do nó seja previsível — um start, um stop, sem race conditions. Plataformas mobile matam processos agressivamente, então simplicidade no gerenciamento de ciclo de vida é uma feature. - Tipos FFI planos: nenhuma abstração Rust vaza pela fronteira FFI. Todo tipo é uma struct plana com strings e números. Isso torna os bindings Dart auto-gerados confiáveis e fáceis de debugar.
- Onboarding de três telas: a criação de identidade é o único passo obrigatório. Sem email, sem senha, sem registro em servidor. O app gera uma identidade criptográfica localmente e está pronto para uso.
O que vem a seguir
- Fase 4: Resiliência e Escala — NAT traversal avançado (STUN/TURN), Shamir's Secret Sharing para herdeiros, tesseras seladas com criptografia temporal, ajuste de performance, auditorias de segurança, empacotamento para Alpine/Arch/Debian/FreeBSD/OpenBSD
- Fase 5: Exploração e Cultura — Navegador público de tesseras por era/localização/tema/idioma, curadoria institucional, integração com genealogia, exportação para mídia física (M-DISC, microfilme, papel livre de ácido com QR)
A infraestrutura está completa. A rede existe, a replicação funciona, e agora qualquer pessoa com um celular pode participar. O que resta é fortalecer o que temos e abrir para o mundo.