Boas Práticas Solana Mobile
25 práticas para UX confiável de assinatura mobile.
-
Teste em dispositivo físico: Intents MWA falham diferente em emuladores (Mobile Wallet Adapter).
-
Dev client Expo para MWA: Expo Go é insuficiente para módulos nativos de carteira.
-
Identity authorize completa: name, uri e icon obrigatórios para confiança da carteira.
-
Cluster corresponde ao RPC: carteira devnet com RPC devnet somente.
-
Use mensagens @solana/kit 7.0.0: Mesmo pipeline que web; evite web3.js novo.
-
Minimize escopo transact: Callbacks longos fazem timeout na UI da carteira.
-
Trate cancelamento authorize: Capture erros; ofereça retry (Deep Links e Tratamento de Sessão).
-
Armazenamento seguro de auth token: expo-secure-store, não AsyncStorage simples.
-
Deauthorize no logout: Limpe token localmente e na carteira quando suportado.
-
Intent filters validados: Carteira deve retornar ao seu scheme.
-
Clientes Codama compartilhados em monorepo: Uma fonte IDL para web + mobile.
-
Priority fees na mainnet mobile: Congestionamento afeta usuários mobile igualmente.
-
Alertas nativos de UX de transação: Spinner + link explorer na confirmação.
-
Não inclua chaves secretas: MWA somente para chaves de usuário.
-
Chaves de assinatura de release em secrets EAS: Nunca commite keystore (A dApp Store).
-
Política de privacidade antes de submit dApp Store: Divulgue RPC e analytics.
-
Teste caminho Seeker Seed Vault: História de assinatura com respaldo em hardware para verdade de marketing.
-
Disciplina Android versionCode: Toda atualização de loja incrementa code.
-
Erros RPC offline: Redes mobile oscilam - UI de retry com backoff.
-
Deep link cold start: App reaberto da carteira após kill.
-
Reduza tamanho do bundle: Tree-shake clientes de programa para tempo de startup.
-
Falhas biométricas: Educação do usuário quando carteira rejeita.
-
Builds devnet separados: Nome de pacote ou label diferente para QA interno.
-
Registre versão wallet adapter: Matriz de suporte por release.
-
Runbook de incidente: Desabilite features pesadas em transact se bug de carteira descoberto.
FAQs
Status iOS?
Verifique docs Solana Mobile - priorize testes MWA Android hoje.
Mesmo app que Next.js?
Compartilhe pacotes kit + Codama; camada UI separada.
Seed Vault em todos os telefones?
Feature de hardware Seeker - não afirme em Android genérico.
Relacionados
- Noções Básicas de Solana Mobile - intro
- Construindo um dApp Mobile - Expo
- Boas Práticas de Integração de Carteira - UX compartilhada
Versões da stack: Esta página foi escrita para Agave 4.1.1, Solana CLI 3.0.10, Anchor 0.32.1, anchor-lang 0.32.1, Rust 1.91.1, @solana/kit 7.0.0, Surfpool 0.12.0 e LiteSVM 0.6.x.