Pular para o conteúdo principal

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âmetroSignificado
saltSalt 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.
initialValidatorMódulo validador usado na implantação inicial. A Pali usa um validador ECDSA controlado pela carteira para uma configuração determinística.
initDataDados 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:

  1. A Pali verifica se a infraestrutura de contas inteligentes da Pali está configurada na chain ativa.
  2. A Pali deriva o próximo descritor determinístico de conta e seu endereço contrafactual.
  3. A Pali cria ou normaliza o autenticador solicitado.
  4. A Pali mostra o host da dapp, o rótulo da conta, o tipo de autenticador e quaisquer proprietários ECDSA externos.
  5. A Pali cria a conta localmente e a implanta on-chain com o validador inicial.
  6. Se o validador solicitado for diferente do inicial, a Pali instala o solicitado e desinstala o inicial por uma execução da conta inteligente.
  7. 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​

Tela de configurações da Pali para recuperar contas inteligentes
A tela de recuperação ajuda a restaurar o acesso a contas inteligentes reconstruindo contas criadas pela Pali ou usando a recuperação por guardiões para substituir o validador ativo.

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​

Solicitação de asserção de passkey do navegador ou sistema operacional
A recuperação e a execução exigem uma asserção WebAuthn da credencial de passkey correspondente.

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.