> For the complete documentation index, see [llms.txt](https://docs.goodcrypto.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.goodcrypto.app/goodcryptox-pt/wallets/built-in-wallet/wallet-architecture.md).

# Arquitetura da carteira

> **resumindo** Criamos duas carteiras para cadeias EVM: uma carteira assinante (EOA) e uma Carteira de Contrato Inteligente (SCW). Os seus fundos ficam guardados na SCW. A carteira assinante autoriza as transações da SCW e é protegida por segurança MPC de nível empresarial. Ambas as carteiras são totalmente não custodiais.
>
> Para utilizadores de Solana, criamos uma única carteira MPC não custodial. Ela não tem um componente de contrato inteligente (já que a Solana ainda não suporta SCWs). Os princípios de segurança são os mesmos.

### Ethereum e cadeias EVM (Base, BNB Chain, Arbitrum)

Em termos simples, uma carteira Ethereum "tradicional" é apenas um par de chaves privada/pública. A chave privada assina transações; a chave pública é o endereço da sua carteira.

Essas carteiras tradicionais são chamadas Contas de Propriedade Externa (EOAs). Apenas EOAs podem assinar transações diretamente em blockchains EVM.

As Carteiras de Contrato Inteligente (SCWs) são contratos inteligentes on-chain que *parecem* carteiras, mas não conseguem assinar transações. Para resolver isso, as SCWs delegam a assinatura a uma carteira EOA emparelhada.

Quando você configura uma carteira EVM no goodcryptoX, criamos:

* **Carteira 1** (`assinante`) — uma carteira EOA tradicional. Ela assina transações para a sua Carteira de Contrato Inteligente.
* **Carteira 2** (`carteira`) — uma Carteira de Contrato Inteligente (Kernel) implantada pela ZeroDev. Esta carteira guarda os seus fundos.

A carteira EOA (Carteira 1) é criada e protegida por [Web3Auth](https://web3auth.io/customers.html) - um dos líderes em infraestrutura de carteiras web3, alimentando a Trust Wallet e muitas outras.

Esta carteira tem uma chave privada, mas a chave é dividida e encriptada entre duas partes independentes:

* Fragmento 1: encriptado e associado à sua conta goodcryptoX
* Fragmento 2: mantido pela Web3Auth

Como usamos tecnologia full-MPC, a chave privada nunca é reconstruída, nem mesmo durante a assinatura. Em vez disso, ambos os fatores encriptados autorizam as assinaturas em conjunto via MPC. Isto oferece segurança ao nível de uma carteira fria.

A sua Carteira de Contrato Inteligente (Carteira 2) é implantada usando [ZeroDev](https://www.zerodev.app/), com base no contrato inteligente Kernel — atualmente a implementação de SCW mais eficiente em gás e segura.

A SCW não tem chave privada. Ela é controlada inteiramente pela sua carteira assinante.

Como resultado:

* Nunca precisa de gerir nem ver uma chave privada
* O sistema é totalmente não custodial

Para permitir negociações avançadas, emitimos **chaves de sessão**: chaves com permissões limitadas que só podem executar swaps via 1inch em seu nome. Estas chaves são assinadas uma vez pela sua carteira, encriptadas e usadas do lado do servidor para automatizar a negociação.

Apenas os swaps usam chaves de sessão. As transferências exigem sempre assinatura direta da carteira.

A sua SCW é implantada no momento da primeira transação de saída (transferência ou swap). Até à implantação, o endereço aparece como uma EOA normal nos exploradores. A primeira transação custará um pouco mais de gás para cobrir a implantação.

**Palavra-passe da carteira**

Inicialmente, a sua carteira assinante é uma carteira MPC 2/2: goodcryptoX e Web3Auth detêm cada uma um fragmento. Para ficar totalmente não custodial, pode definir uma [palavra-passe da carteira](https://docs.goodcrypto.app/goodcryptox-pt/wallets/built-in-wallet/wallet-password.md), convertendo a sua carteira assinante para MPC 2/3:

* Fragmento 1: associado à sua conta goodcryptoX — encriptado e armazenado pela nossa infraestrutura
* Fragmento 2: a palavra-passe da carteira que definiu
* Fator 3: derivado da palavra-passe e armazenado no seu dispositivo, para que não tenha de introduzir a palavra-passe sempre que abre a app

Isto garante que nenhum terceiro possa alguma vez aceder à sua chave privada — nem sequer em teoria.

Isto também significa que, se perder a sua palavra-passe e o dispositivo, a carteira fica inacessível. Use apenas se compreender os riscos.

**Alterações futuras**

Estamos a transitar para uma **arquitetura de carteira única** em EVMs usando [EIP-7702](https://eips.ethereum.org/EIPS/eip-7702):

* A carteira EOA assinante também funcionará como uma Carteira de Contrato Inteligente
* As chaves de sessão e a funcionalidade avançada estarão disponíveis sem necessidade de duas carteiras
* Poderá exportar a sua chave privada da app

Isto simplificará a configuração mantendo o mesmo nível de segurança MPC.

Também poderá trazer a sua própria EOA (por exemplo, MetaMask) para usar como assinante em vez da carteira gerada pelo goodcryptoX.

***

### carteira Solana

Na Solana, as carteiras de contrato inteligente ainda não são suportadas. Portanto, criamos uma única carteira protegida por MPC (o equivalente a uma EOA).

A carteira é criada usando a mesma configuração MPC:

* Fator 1: associado à sua conta goodcryptoX
* Fator 2: mantido pela Web3Auth

A chave privada nunca é reconstruída durante a utilização. Em vez disso, é usada assinatura baseada em MPC para autorizar transações.

Opcionalmente, pode definir uma palavra-passe da carteira para converter a sua carteira Solana para MPC 2/3. Aplicam-se os mesmos benefícios e riscos que nas cadeias EVM.

Ao contrário da EVM, a chave privada da sua carteira Solana pode ser exportada diretamente da app usando a `Exportar chave` opção no separador Carteira.
