Criar e recuperar smart accounts
wallet_prepareSmartAccount cria uma conta inteligente da Pali para integrar usuários por uma dapp. A Pali deriva a conta, implanta-a pela fábrica configurada, instala o validador solicitado quando necessário, conecta a conta à dapp solicitante e grava metadados duráveis da conta no estado local da carteira.
O estado local da carteira representa as contas inteligentes que a Pali pode operar. Uma conta pode usar um validador ECDSA, passkey, SLH-DSA ou composto. Um executor de recuperação por guardiões instalado separadamente pode substituir um validador após o prazo configurado.
Estrutura da conta inteligente e da fábrica
O sistema de contas inteligentes tem estas partes:
- Fábrica: calcula endereços determinísticos e implanta contas com os dados iniciais dos módulos.
- Conta inteligente: executa chamadas, acompanha os módulos instalados e solicita aos validadores que aprovem assinaturas.
- Validadores: Em redes configuradas, a Pali suporta ECDSA, passkeys P-256 WebAuthn, SLH-DSA e validadores compostos; os módulos compatíveis devem estar implantados e as chaves ou credenciais locais necessárias devem estar disponíveis.
- Executores: adicionam recursos à conta. A Pali usa a recuperação por guardiões como módulo executor.
Os parâmetros de conta da fábrica incluem:
| Parâmetro | Significado |
|---|---|
salt | Salt de implantação determinístico derivado pela Pali a partir da âncora da carteira, do índice da conta, da chain e da versão da conta. |
initialValidator | Módulo validador usado na implantação inicial. A Pali usa um validador ECDSA controlado pela carteira para uma configuração determinística. |
initData | Dados codificados de inicialização do validador. |
Após a implantação, a Pali pode instalar o validador solicitado e remover o inicial em um único lote da conta inteligente. Por isso, uma dapp pode solicitar uma conta controlada por passkey enquanto a Pali mantém determinístico o caminho da primeira implantação.
Criar uma conta controlada por passkey
const smartAccount = await window.ethereum.request({
method: 'wallet_prepareSmartAccount',
params: [
{
label: 'Pali Passkey',
authenticator: { id: 'p256-webauthn' },
},
],
});
Se a dapp omitir authenticator, a Pali usa o caminho de passkey por padrão. Use uma solicitação que contenha apenas o identificador, como { id: 'p256-webauthn' }, e deixe a Pali selecionar ou criar a credencial controlada pela carteira. Proprietários ECDSA externos continuam usando o fluxo de confirmação explícita descrito abaixo.
Criar uma conta inteligente ECDSA
const smartAccount = await window.ethereum.request({
method: 'wallet_prepareSmartAccount',
params: [
{
label: 'Team account',
authenticator: {
id: 'ecdsa',
config: {
owners: ['0xOwnerAddress'],
threshold: 1,
},
},
},
],
});
Proprietários ECDSA que já são contas locais da carteira Pali são considerados controlados pela carteira. Endereços de proprietários ECDSA externos só são permitidos após um aviso e uma confirmação explícitos, porque esses endereços podem aprovar ações futuras da conta inteligente.
Comportamento de criação e implantação
Quando uma dapp solicita uma conta inteligente:
- A Pali verifica se a infraestrutura de contas inteligentes da Pali está configurada na chain ativa.
- A Pali deriva o próximo descritor determinístico de conta e seu endereço contrafactual.
- A Pali cria ou normaliza o autenticador solicitado.
- A Pali mostra o host da dapp, o rótulo da conta, o tipo de autenticador e quaisquer proprietários ECDSA externos.
- A Pali cria a conta localmente e a implanta on-chain com o validador inicial.
- Se o validador solicitado for diferente do inicial, a Pali instala o solicitado e desinstala o inicial por uma execução da conta inteligente.
- A Pali aguarda a confirmação, armazena metadados duráveis da conta inteligente e conecta a conta à dapp.
Se o endereço resultante já estiver presente localmente, a Pali poderá reutilizar essa conta inteligente local.
O que determina o endereço?
O endereço da conta inteligente é derivado da fábrica, da implementação da conta, dos dados de inicialização do validador inicial e do salt determinístico de implantação da Pali. A Pali deriva o salt de uma âncora da carteira e do índice da conta, permitindo recuperar contas por meio dos metadados da carteira em vez de um estado local aleatório.
Se o usuário perder os dados locais da Pali

Se o perfil do navegador, o armazenamento da extensão ou os metadados locais da conta inteligente forem perdidos, a recuperação dependerá dos módulos atuais da conta:
- Contas determinísticas criadas pela Pali podem ser reconstruídas a partir da âncora da carteira, da chain, do índice da conta e da configuração da fábrica.
- Validadores de passkey ainda exigem a credencial WebAuthn correspondente para autorizar ações futuras.
- A recuperação por guardiões pode substituir o validador ativo após o atraso configurado se o método original de aprovação não estiver disponível.
A recuperação da Pali funciona sob autocustódia. Ela não é uma porta dos fundos do servidor e não pode contornar os módulos instalados na conta.
RP ID e nome da credencial

O navegador controla o RP ID efetivo do WebAuthn na origem da extensão, a menos que o fluxo da carteira forneça um RP ID. A Pali usa o rótulo de conta solicitado como nome e nome de exibição da credencial WebAuthn.