28. Carteiras Inteligentes e Account Abstraction
A experiência Web3 da eBattery visa permitir que os investidores giram os seus direitos económicos em segurança, sem terem de aprender os detalhes técnicos da blockchain. Aderir a um projeto de estação, reclamar a participação mensal nos lucros ou transferir unidades de investimento devem ser operações compreensíveis, verificáveis e sob o controlo do utilizador.
No uso tradicional de carteiras, pode-se esperar que o usuário proteja chaves privadas, escolha uma rede, mantenha um ativo separado para taxas de transação e interprete mensagens técnicas de assinatura. Impor todas essas responsabilidades ao usuário da mesma forma cria uma barreira significativa de uso para uma plataforma que pretende alcançar um público amplo.
A abordagem de carteira inteligente da eBattery torna essa experiência Account Abstraction — abstração da conta com a sua arquitetura. A aprovação de transações da conta, os limites de autoridade, o método de pagamento de taxas e as regras de recuperação são tratados numa estrutura programável. Enquanto o utilizador se move numa experiência de aplicação que já conhece, preservam-se a autorização e o registo que as operações de investimento exigem.
Esta seção define a arquitetura de conta inteligente e os princípios de segurança que a eBattery adota como base para a sua fase Web3. O objetivo da estrutura não é apenas reduzir o número de transações. Para que o usuário possa entender o que está permitindo, limitar as permissões que concede e manter o controle de sua conta é a base da conceção.
28.1 Da conta Web2 ao acesso Web3
A conta de usuário eBattery é o ponto de acesso comum ao mapa, ao planejamento de rotas, à comunidade e aos demais módulos Web2. O acesso Web3 é vinculado a essa conta; no entanto, cadastrar-se no aplicativo não significa, por si só, a abertura de uma conta de investimento nem a concessão de autorização para transações financeiras.
Quando um utilizador passa para a área Web3, são estabelecidas três relações distintas:
| Camada | Função principal |
|---|---|
| Conta de utilizador eBattery | Gerenciar a sessão do app e as preferências do usuário |
| e-ID do investidor | Vincular identidade, elegibilidade do investidor e condições de acesso ao projeto |
| Carteira inteligente | Gerir ativos onchain e transações autorizadas |
Esta distinção é importante tanto para a experiência do utilizador como para a segurança. O facto de uma pessoa ter iniciado sessão na aplicação não significa que seja elegível para participar num projeto de investimento específico. Do mesmo modo, concluir a verificação de identidade não permite, por si só, efetuar operações a partir da carteira.
A passagem para a Web3 decorre com o utilizador a rever as condições de serviço aplicáveis, a concluir os passos de elegibilidade necessários e a definir o método de autorização da sua conta inteligente. A ligação da carteira é associada à identidade de utilizador e de investidor através de uma transação verificada.
Para o usuário que quer continuar usando apenas o Web2, a participação no Web3 não é obrigatória. O acesso ao mapa, à comunidade ou à Game Zone não depende da abertura de uma conta de investimento, da aquisição de um ativo digital nem de assinatura com carteira.
Os pontos de jogo, os créditos de carregamento, os saldos de pagamento e os ativos de investimento também não se convertem uns nos outros durante esta transição. Uma conta de utilizador partilhada não significa que funções económicas diferentes sejam reunidas num mesmo saldo.
28.2 Estrutura de conta inteligente baseada em ERC-4337
A arquitetura de carteira inteligente da eBattery, nas redes EVM suportadas, a abordagem de conta inteligente baseada no ERC-4337 baseia-se em.
O ERC-4337 permite que a lógica de validação de transações de uma conta seja definida por código de contrato inteligente. A transação do usuário é enviada por meio de uma estrutura chamada UserOperation. Os bundlers levam essas operações para a blockchain de forma adequada, enquanto o contrato EntryPoint atua como componente central do protocolo no processo de validação e execução. Um paymaster opcional pode cobrir a taxa da transação em nome do usuário.
Do ponto de vista do eBattery, os componentes dessa arquitetura são posicionados da seguinte forma:
| Componente | Função na eBattery |
|---|---|
| Conta inteligente | Aplicar as regras de assinatura, autoridade e execução do usuário |
| UserOperation | Representar tecnicamente a transação aprovada pelo usuário |
| Bundler | Verificar a transação e enviá-la à blockchain por meio de um EntryPoint suportado |
| EntryPoint | Executar a verificação da conta e, quando existir, do paymaster |
| Paymaster | Cobrir a taxa de rede dentro da política definida |
| Componente de criação de conta | Configurar a nova conta inteligente com as permissões iniciais corretas |
Uma conta inteligente não precisa estar presa a um único método de assinatura. O ecossistema ERC-4337 oferece uma estrutura capaz de suportar diferentes métodos de assinatura, regras de conta programáveis e cenários de abstração de taxas. No entanto, o comportamento de recursos como passkeys, chaves de sessão ou recuperação é projetado separadamente na implementação de conta utilizada.
Na criação de uma conta eBattery, a autoridade de assinatura, a estrutura de recuperação e os módulos ativos são verificados em conjunto. Não se usa um modelo inicial baseado em criar a conta com uma autoridade incorreta ou temporária e corrigi-la depois.
A assinatura da transação é associada à conta e ao contexto de rede correspondentes. O ERC-4337 exige que a assinatura esteja vinculada ao ID da rede e ao endereço do EntryPoint para proteger contra ataques de repetição. Além disso, a eBattery verifica o tipo de transação, os limites de autoridade e as condições de validade no nível do aplicativo.
A arquitetura é concebida de modo a não criar dependência desnecessária de um único serviço de bundler. A mesma transação reenviada através de um serviço alternativo não cria uma segunda transação económica. Mantêm-se os controlos de ordenação de contas e de proteção contra repetição.
28.3 Login com Passkey e Aprovação de Transações
A passkey é uma abordagem que autentica o utilizador com uma credencial criptográfica em vez de uma palavra-passe. Na experiência de utilização, isto pode ser concluído com reconhecimento facial, impressão digital ou um método de verificação local suportado pelo dispositivo.
Na abordagem FIDO, as passkeys utilizam autenticação por chave pública específica de cada serviço. Existem tipos associados a um dispositivo ou sincronizados entre dispositivos através de um fornecedor adequado. Quando se utiliza a verificação biométrica, os dados biométricos não se transformam numa credencial enviada ao serviço como uma palavra-passe.
Na eBattery, a passkey é considerada em dois contextos de uso distintos:
Início de sessão na conta, permite ao utilizador abrir uma sessão na aplicação ou na web.
Aprovação de transação financeira, autoriza uma transação onchain específica.
Embora apareçam na mesma experiência do usuário, essas duas operações têm finalidades diferentes. Uma resposta de verificação gerada para o login não pode ser usada como permissão para comprar uma unidade de investimento ou alterar a autorização da carteira.
O WebAuthn vincula a resposta de autenticação ao contexto do serviço e à solicitação de verificação apresentada. Na aprovação de transações do eBattery, essa solicitação é vinculada ao conteúdo da transação, à conta, à rede e às informações de validade. As verificações de RP ID, origin e verificação do usuário correspondentes são aplicadas conforme os contextos suportados dos canais móvel e web.
Para que uma conta inteligente aceite uma assinatura de passkey, é necessário um componente de verificação adequado. A documentação de contas inteligentes WebAuthn da OpenZeppelin oferece uma abordagem de exemplo para verificar respostas de verificação WebAuthn em contratos inteligentes. A escolha técnica da eBattery considera em conjunto se o algoritmo de assinatura e o caminho de verificação utilizados são compatíveis com a rede de destino, bem como o seu custo e as suas propriedades de segurança.
A facilidade de usar uma Passkey não torna o resumo da transação desnecessário. Antes de aprovar, o usuário vê o que está comprando, qual valor será gasto e qual autorização será concedida. A janela de verificação biométrica do dispositivo não é considerada uma tela de contrato que exibe automaticamente todas as condições financeiras.
Por este motivo, a eBattery considera a correspondência entre o resumo da transação mostrado ao utilizador e o conteúdo da transação assinada parte do seu desenho de segurança.
28.4 Acesso Compartilhado à Conta pelo Aplicativo Móvel e pela Web
Um utilizador da eBattery pode aceder à mesma conta de investidor através das interfaces móveis e web suportadas. O acesso partilhado não depende de os dispositivos descarregarem a mesma chave privada do servidor da aplicação.
A continuidade da conta é garantida pela relação verificada entre a conta de usuário, o e-ID do investidor, o endereço da conta inteligente e as credenciais de identidade autorizadas. Quando o usuário entra a partir de outro dispositivo, pode ver seu portfólio e suas transações anteriores; para uma transação financeira, precisa ainda ter acesso ao método de assinatura autorizado.
A relação de confiança entre os aplicativos móveis e o domínio web é estabelecida por meio dos mecanismos das respectivas plataformas. No lado da Apple, a associação de associated domains e webcredentials; no lado do Android, a configuração de Digital Asset Links são os elementos técnicos do vínculo de credenciais entre o aplicativo e o domínio do serviço.
No modelo de acesso compartilhado, aplicam-se os seguintes princípios:
Entrar por um novo dispositivo não é tratado da mesma forma que conceder uma nova autorização de transação.
Os nomes de domínio e os identificadores de aplicativo compatíveis são verificados.
A adição de um novo signatário é aprovada de acordo com a política de segurança vigente.
A autoridade para ver uma conta é separada da autoridade para movimentar ativos.
As transações de diferentes dispositivos pertencentes ao mesmo utilizador são geridas através de uma fila de conta partilhada.
A possibilidade de usar uma passkey em outro dispositivo depende do provedor de credenciais e dos recursos compatíveis de sincronização ou de autenticação entre dispositivos. Por isso, não se presume a portabilidade automática e incondicional da chave entre todos os sistemas operacionais.
Do mesmo modo, o facto de uma conta de utilizador poder aceder a mais do que uma rede não significa que o mesmo endereço de conta inteligente ou a mesma configuração de conta exista em todas as redes. As relações entre redes e contas são apresentadas ao utilizador de forma clara; não é feito qualquer bridging automático entre ativos.
28.5 Patrocínio de Gas e Política de Paymaster
O patrocínio de gas reduz a necessidade de o usuário adquirir separadamente o ativo nativo da rede para determinadas transações. Enquanto a transação parece mais simples para o usuário, o custo da rede é coberto por outra parte, conforme a política aplicável.
A abordagem de paymaster do eBattery, é um patrocínio de transação com escopo e orçamento definidos. Uma operação patrocinada não significa uma operação sem custo económico; o que muda é quem suporta o custo.
As transações elegíveis para patrocínio são determinadas pelo fluxo do utilizador. Transações como a ativação de uma conta inteligente ou um pedido elegível de partilha de lucros podem ser avaliadas ao abrigo da política aplicável. O apoio aplicável a cada transação é apresentado no ecrã de confirmação.
A política do Paymaster controla as seguintes áreas:
| Área de controle | Finalidade |
|---|---|
| Tipos de contrato e de transação permitidos | Evitar que o patrocínio seja usado para fins não previstos |
| Elegibilidade do utilizador e da conta | Identificar as contas que podem beneficiar de apoio |
| Limite de custo por transação | Limitar taxas de rede inesperadas |
| Limite de uso periódico | Gerir o orçamento do patrocinador de forma sustentável |
| Pedidos repetidos e suspeitos | Reduzir o uso abusivo automatizado |
| Período de validade | Evitar que aprovações antigas de patrocinadores sejam reutilizadas |
A segurança do paymaster é tratada em conjunto com verificação, simulação de transações e controles contra abuso. A documentação do ERC-4337 também considera a proteção dos recursos do paymaster contra abuso e tentativas de negação de serviço como uma área de segurança separada.
A aprovação do patrocinador não substitui a assinatura do usuário. Um paymaster pode cobrir a taxa de rede; isso não concede autoridade para comprar investimentos nem transferir ativos em nome do usuário.
Quando o patrocínio não pode ser aplicado, a transação não continua automaticamente com cobrança do saldo do usuário. O novo custo é mostrado ao usuário e a aprovação necessária é obtida. Uma alternativa tecnicamente suportada em que o usuário paga é apresentada com a mesma clareza.
O orçamento do patrocinador não é coberto, sem explicação, com as reservas de manutenção das estações nem com as participações nos lucros não resgatadas dos investidores. Define-se a qual orçamento de serviço o respectivo custo pertence.
28.6 Chaves de Sessão e Permissões Limitadas
As chaves de sessão permitem que o usuário conceda autoridade limitada em duração e escopo para transações específicas. O objetivo é reduzir o uso constante do método principal de assinatura em transações repetidas, preservando o controle da conta.
Estas permissões não são uma funcionalidade pronta que o ERC-4337 defina por si só. São implementadas na lógica de validação da conta ou em módulos de autorização. A documentação relevante do ERC-4337 também indica que as chaves de sessão são controladas por regras específicas da carteira.
As permissões de sessão da eBattery são geridas através de um registo de consentimento explícito. Este registo pode incluir os seguintes limites:
A rede e a conta inteligente a que se aplica.
Contratos permitidos.
Os tipos de ação que podem ser chamados.
Ativos permitidos.
Limite por transação e total.
Endereços de destinatário fixos ou em lista de permissões.
Horário de início e de término.
Número de usos e condições de cancelamento.
Por exemplo, o usuário pode conceder uma autorização limitada apenas para solicitar, em sua própria conta definida, a participação nos lucros de um contrato de distribuição específico. Essa autorização não se estende ao direito de vender unidades de investimento, alterar o endereço do destinatário ou aprovar gastos em outro contrato.
Nenhuma autoridade para movimentar ativos é concedida para ações como visualizar a carteira, ler relatórios ou receber notificações. A facilidade de leitura não se baseia em autoridade de assinatura desnecessária.
As permissões limitadas não são protegidas apenas por uma lista de permissões mantida no servidor da aplicação. A transação onchain em causa tem de cumprir o âmbito da permissão na verificação da conta. Nas transações em lote, cada subtransação também é verificada; é impedido exceder os limites através de chamadas de uso geral.
O utilizador pode ver e revogar as permissões de sessão ativas. Para que uma revogação onchain produza efeitos, a operação em causa tem de ser finalizada; terminar a sessão na aplicação, por si só, não é considerado como remoção de todas as permissões onchain.
As permissões de gasto de tokens também são acompanhadas separadamente das chaves de sessão. A revogação de uma autorização de sessão pode não eliminar automaticamente uma permissão de gasto concedida anteriormente a outro contrato. O ecrã de segurança apresenta estes dois tipos de autorização em separado.
28.7 Confirmação do usuário em operações de investimento
Nas operações de investimento, a eBattery baseia a confirmação do usuário em um resumo da operação cujo significado econômico é claro. A redução da complexidade técnica não torna a decisão invisível.
Antes da transação, as seguintes informações são apresentadas ao usuário:
| Transação | Principais informações na tela de confirmação |
|---|---|
| Participação no Launchpad | Projeto, número de unidades, preço total, taxas e condições de financiamento |
| Compra secundária | Preço unitário, pagamento total, direitos periódicos e condições de troca |
| Venda secundária | Unidades vendidas, preço de venda, comissão de 1% e montante líquido |
| Solicitação de participação nos lucros | Período, direito bruto, deduções, pagamento líquido e destinatário |
| Autorização de despesa | Contrato, ativo, limite e âmbito autorizados |
| Alteração de segurança | Signatários a serem adicionados ou removidos e as autoridades alteradas |
As operações com consequências económicas significativas não são realizadas com base apenas numa sessão aberta da aplicação. É aplicada uma nova verificação adequada em ações como compras, vendas, novas autorizações de despesa, alterações de signatários e configuração de recuperação.
Tecnicamente, várias etapas podem ser executadas no mesmo grupo de transações. Por exemplo, a permissão de pagamento necessária e a chamada de compra podem ser preparadas juntas. O usuário vê o efeito combinado dessas etapas; nenhuma autoridade oculta ou ilimitada é concedida com uma única aprovação.
Nas mensagens assinadas suportadas, podem ser usadas abordagens de dados estruturados como a EIP-712. Este padrão permite que os dados sejam assinados com o contexto do seu tipo e dos seus campos, mas, por si só, não garante a proteção contra reutilização nem que a interface do utilizador seja compreensível. A ordem das transações, a validade, o contrato de destino e o caso de utilização são verificados separadamente.
A compatibilidade com o ERC-1271 é considerada na verificação das assinaturas de contas inteligentes por outros contratos da plataforma. Assim, a conta pode oferecer verificação de assinatura baseada em contrato, sem depender apenas de sistemas que esperam uma assinatura tradicional de chave privada.
A simulação pré-transação ajuda a mostrar as movimentações esperadas de ativos e possíveis erros. No entanto, o preço, a elegibilidade ou o status do contrato podem mudar até que a transação entre na cadeia. Por isso, o preço, o valor e os limites de validade aceitos pelo usuário também são verificados durante a execução.
28.8 Recuperação de Carteira e Troca de Dispositivo
Trocar de dispositivo, recuperar a conta do aplicativo e recuperar a autoridade de assinatura da carteira inteligente são processos diferentes. A eBattery não reúne esses casos em uma única ação de “esqueci minha senha”.
A abordagem de recuperação distingue três cenários principais:
O usuário passar a ter acesso a outro método de assinatura válido: Um novo dispositivo ou uma nova credencial pode ser adicionado à conta através de um método autorizado já existente.
Poder usar a passkey sincronizada no novo dispositivo: Em condições de fornecedor e dispositivo suportadas, é possível voltar a aceder à mesma credencial. Isto pode dispensar a criação de um novo signatário na conta.
Perda de acesso a todos os métodos normais de assinatura: Aplica-se o mecanismo de recuperação independente definido na criação da conta.
O design de recuperação da eBattery é concebido para dar suporte a mecanismos como um método de assinatura de reserva, partes de recuperação previamente autorizadas ou um arranjo adequado de aprovação múltipla. Quem pode trocar os signatários, e em quais condições, com o método escolhido é explicado ao usuário na criação da conta.
Um pedido de recuperação não cria autoridade normal de transferência. O pedido passa pelas verificações necessárias; aplicam-se mecanismos de espera e de contestação; e são enviadas notificações para os canais de segurança existentes. Se o utilizador ainda tiver um método de assinatura válido, deve poder intervir contra uma tentativa de recuperação não autorizada.
O acesso a uma conta de e-mail ou o envio de um documento de identidade à equipe de suporte não é, por si só, tratado como autoridade para movimentar ativos onchain. A análise de identidade pode ser apenas um componente de uma política de recuperação previamente definida.
Tem-se também em conta que uma passkey sincronizada pode representar a mesma credencial em mais de um dispositivo. Terminar as sessões da aplicação num dispositivo perdido não invalida necessariamente a credencial de assinatura que esse dispositivo pode usar na cadeia. Quando necessário, o assinante da conta é substituído e as autorizações das sessões associadas são revogadas.
Após a recuperação, as unidades de investimento e os direitos já acumulados podem continuar na mesma conta. Se for necessário usar um novo endereço, os direitos econômicos e os registros de elegibilidade passam por um processo controlado de transferência. Participações nos lucros passadas ou registros de fim de período não são duplicados pelo fato de uma nova conta ter sido aberta.
Quando não resta nenhuma assinatura válida nem autoridade de recuperação aplicável, obter acesso à conta do aplicativo, por si só, não consegue recuperar a carteira. Por isso, configurar um mecanismo de recuperação é parte essencial da segurança da conta antes de investir.
28.9 Controle de ativos e modelo de custódia
O princípio de conceção central da abordagem de carteira inteligente da eBattery é que o investidor tenha um controlo significativo sobre os movimentos dos ativos. Este controlo não é avaliado apenas por uma indicação de “titular da carteira” apresentada na interface.
As perguntas que determinam a verdadeira estrutura de controlo são as seguintes:
Quem pode produzir a assinatura da transação?
Quem pode adicionar um novo signatário à conta?
Quem pode concluir o processo de recuperação?
Quem pode alterar o código da conta ou os módulos de verificação?
Quem pode remover os limites de gastos?
Quem pode transferir ativos para outro endereço?
As respostas a estas perguntas são a base do modelo de custódia. Uma conta exigir a assinatura do utilizador não é, por si só, um indicador suficiente de controlo se outra parte puder alterar essa condição através de amplos poderes de atualização ou recuperação.
No modelo da eBattery, a autoridade para gerenciar sessões do app, fornecer patrocínio de paymaster ou verificar a elegibilidade do investidor não se converte automaticamente em autoridade para retirar ativos da carteira do usuário.
| Autoridade ou serviço | O seu âmbito |
|---|---|
| Gestão da conta do usuário | Acesso ao aplicativo e preferências |
| Verificação de elegibilidade do investidor | Acesso a transações de investimento específicas |
| Serviço Bundler | Enviar a transação autorizada à rede |
| Serviço Paymaster | Cobrir o custo de rede de uma transação elegível |
| Autoridade de assinatura da carteira | Aprovar transações dentro das regras da conta |
| Autoridade de recuperação | Reorganizar o acesso em condições predefinidas |
Se a conta inteligente for atualizável ou modular, o impacto dessas autorizações na segurança é mostrado separadamente. Atualizações que alteram o controle da conta não são tratadas como uma atualização comum do app. Controles como aprovação do usuário, múltiplas autorizações ou atraso de tempo são definidos com clareza conforme o modelo de conta utilizado.
A carteira do investidor, a estrutura de custódia (escrow) do Launchpad e o pool de distribuição também são estruturas separadas. O dinheiro mantido no contrato de custódia durante o financiamento não é um saldo de carteira que o usuário possa gastar livremente de forma direta. Da mesma forma, uma participação nos lucros não solicitada é um direito econômico no mecanismo de distribuição correspondente.
As regras de transferência permissionada das unidades RWA são uma camada separada do controle da carteira. Mesmo que o usuário seja o signatário da sua carteira, uma unidade de investimento só pode ser transferida a destinatários elegíveis e em condições compatíveis. Esse recurso não significa que todos os ativos da conta sejam geridos livremente pela plataforma.
A explicação de custódia apresentada ao utilizador reflete a estrutura técnica e jurídica de autoridade em uso. A expressão “carteira inteligente” não é usada isoladamente como alegação de controlo total do utilizador, de custódia institucional ou de recuperação automática.
28.10 Histórico de operações e notificações de segurança
A última camada da experiência da carteira inteligente é o acompanhamento claro das transações e das alterações de segurança. O usuário deve poder ver não apenas o saldo, mas também os eventos que afetam esse saldo e as permissões da conta.
O histórico de transações reúne as seguintes informações:
Tipo de transação e projeto de estação relacionado.
A rede e a conta inteligente utilizadas.
Ativo, quantidade e contraparte.
Condições de taxas aprovadas pelo utilizador.
Custo de rede patrocinado e custo coberto pelo usuário.
Referência da UserOperation.
A referência da transação on-chain, se existir.
O resultado real da execução.
O relatório, a venda ou o registro de participação nos lucros correspondente.
O acompanhamento do estado distingue fases como a preparar, a aguardar assinatura, enviado, executado, falhado e finalizado. O facto de um bundler aceitar um pedido não significa que a transação financeira tenha ocorrido.
Como uma única transação on-chain pode conter várias operações de usuários, o registro da transação de nível superior não basta. A eBattery verifica o resultado da operação do próprio usuário e as movimentações de ativos esperadas. Se uma execução malsucedida ainda gerou custo de rede, esse custo não é exibido como compra de investimento realizada nem como comissão de venda.
O historial de segurança, por sua vez, é acompanhado separadamente das transações financeiras:
Início de sessão a partir de um novo dispositivo.
Adição de uma nova passkey ou de um novo signatário.
Revogação da autoridade de assinatura.
Criação e revogação de chaves de sessão.
Concessão ou alteração de uma permissão de gasto.
Abertura da solicitação de recuperação.
Uma alteração no módulo de conta ou na política de segurança.
Tentativas de transação suspeitas.
Sair de um dispositivo informa ao usuário apenas que a sessão do aplicativo foi encerrada. Se for necessário revogar permissões onchain, essa operação é exibida separadamente e sua finalização é acompanhada.
As notificações direcionam o usuário aos detalhes da transação e à etapa de segurança adequada. Informações sensíveis, como a chave privada completa, o segredo da passkey ou a autoridade de recuperação, não são solicitadas em notificação, mensagem de suporte ou e-mail.
Graças a essa integridade, a carteira inteligente da eBattery reduz os detalhes técnicos e mantém visíveis as responsabilidades económicas e de segurança. Ao distinguir entre o acesso à aplicação, a elegibilidade para investir, a assinatura de transações e as autorizações de recuperação da conta, o utilizador pode gerir os serviços Web3 numa experiência única.
