Aomi Transact

Uso autorizado apenas. Esta habilidade assina e transmite transações on-chain em nome do usuário. O usuário deve solicitar explicitamente cada etapa de assinatura. A habilidade não será executada aomi tx sign sem uma solicitação explícita do usuário e um tx-N correspondente enfileirado por aomi tx list.

Portão de assinatura. Não inclua aomi tx sign em um bloco de múltiplos comandos copiado ou executável. Pare após listar ou simular transações enfileiradas, resuma os IDs das transações, a cadeia, o valor, o destinatário, o propósito do calldata e o resultado da simulação, e então peça ao usuário uma instrução de assinatura explícita como sign tx-1. Execute o comando de assinatura exato apenas após essa aprovação separada.

Visão Geral

aomi-transact é um procedimento para controlar a CLI do Aomi (@aomi-labs/client) a partir de prompts em linguagem natural. O usuário digita algo como "trocar 1 ETH por USDC na Uniswap"; o agente escolhe o protocolo e o contrato corretos, prepara o approve+swap como um lote, simula em uma cadeia bifurcada e retorna uma solicitação de carteira enfileirada para o usuário assinar. A carteira só vê calldata que já passou pela simulação.

A CLI é focada em abstração de conta: por padrão, ela assina através de um proxy Alchemy sem configuração (sem necessidade de credenciais de provedor), usando EIP-7702 na rede principal Ethereum e ERC-4337 em L2s. Cada invocação de aomi <subcommand> inicia, executa e sai — não há processo de longa duração.

A habilidade completa, incluindo referências (account-abstraction.md, apps.md, examples.md, session.md, troubleshooting.md, drain-vectors.md), templates (aomi-workflow.sh) e metadados por host (agents/openai.yaml), reside upstream em aomi-labs/skills. Esta entrada é apenas o SKILL.md canônico — clone o upstream para o pacote completo.

Quando Usar Esta Habilidade

• O usuário quer conversar com o agente Aomi pelo terminal.
• O usuário quer saldos, preços, rotas, cotações ou status de transação.
• O usuário quer construir, simular, confirmar, assinar ou transmitir solicitações de carteira.
• O usuário quer simular um lote de transações pendentes antes de assinar.
• O usuário quer inspecionar ou alternar aplicativos, modelos, cadeias ou sessões.
• O usuário quer inspecionar ou alterar as configurações de Abstração de Conta (EIP-7702 / ERC-4337).
• O usuário quer assinar payloads de dados tipados EIP-712 (acordos off-chain, preenchedores de intenção).

Exemplos

Somente Leitura — verificação de preço

aomi --prompt "what is the price of ETH?" --new-session

Retorna uma cotação sem solicitação de carteira enfileirada. Use aomi tx list para confirmar que não há nada pendente.

Fluxo de transação única — stake Lido

aomi chat "Stake 0.01 ETH with Lido to get stETH" \
  --public-key 0xUserAddress --chain 1 --new-session
aomi tx list

submit(address(0)) na Lido stETH 0xae7ab96520DE3A18E5e111B5EaAb095312D7fE84, value = 0.01 ETH. Sem aprovação, transação única. Pare aqui, mostre os detalhes da transação enfileirada e aguarde a instrução explícita do usuário antes de assinar.

Lote de múltiplas etapas — swap Uniswap V3

aomi chat "swap 1 USDC for WETH on Uniswap V3, send to my wallet" \
  --public-key 0xUserAddress --chain 1 --new-session
aomi tx list                        # tx-1 = approve, tx-2 = swap
aomi tx simulate tx-1 tx-2          # mandatory for multi-step

O simulador executa cada tx sequencialmente em uma cadeia bifurcada para que a etapa de swap veja as mudanças de estado do approve. Não assine a etapa 2 independentemente — ela reverteria. Pare após a simulação, resuma o lote e aguarde uma instrução explícita do usuário nomeando ambos os IDs de transação antes de assinar.

Cross-chain — CCTP Ethereum → Base

aomi chat "Bridge 50 USDC from Ethereum to Base via CCTP. Recipient is my wallet." \
  --public-key 0xUserAddress --chain 1 --new-session
aomi tx list
aomi tx simulate tx-1 tx-2

Pare após a simulação e aguarde o usuário aprovar explicitamente a assinatura dos IDs de transação nomeados. Após a assinatura, a queima na cadeia de origem confirma em 1-2 blocos; a cunhagem de destino requer a attestation off-chain da Circle (~13-19 minutos).

Limitações

• Requer @aomi-labs/client v0.1.30 ou mais recente. Versões mais antigas não possuem --aa, --aa-provider, --aa-mode e o portão de simulação. Instale com npm install -g @aomi-labs/client ou execute sob demanda via npx @aomi-labs/client@0.1.30 ....

…