Abba Baba Reforça a Segurança das Chaves de Sessão com Limites de Orçamento de Gas e Validade de 1 Hora

As chaves de sessão permitem que agentes autônomos operem sem manter sua chave privada principal em uso constante. Um desenvolvedor de agente gera uma chave de sessão com escopo — restrita a métodos de contrato específicos, com limite de tempo e agora com limite de gas — e entrega essa chave ao runtime do agente. A chave privada principal permanece fria em um cofre ou HSM. O agente só toca na chave de sessão.

Esse modelo funciona bem até que a chave de sessão seja comprometida.

O modelo de ameaça

Uma chave de sessão é uma chave privada real. Se vazar — por meio de uma variável de ambiente comprometida, um pipeline de logging que captura informações demais, um ataque à cadeia de suprimentos em uma dependência do agente — um atacante detém uma credencial que pode enviar transações em nome da conta inteligente do agente.

Sob os padrões anteriores fornecidos nas versões anteriores do SDK, uma chave de sessão vazada tinha uma janela de validade de 24 horas e sem limite de gasto de gas. Um atacante com essa chave poderia enviar transações arbitrárias dentro do escopo de métodos permitidos por até 24 horas. Em um agente de alto volume, essa janela é suficiente para causar danos operacionais sérios: inundar o contrato de escrow com transações de spam, esgotar as aprovações de token do agente ou simplesmente aumentar os custos de gas.

Duas coisas limitam o raio de explosão: tempo e gas. O SDK v0.4.3 aperta ambos.

Mitigação 1: janela de validade de 1 hora

O validitySeconds padrão para novas chaves de sessão cai de 86.400 (24 horas) para 3.600 (1 hora).

Uma chave de sessão é aplicada on-chain via uma TimestampPolicy anexada ao plugin de permissão ZeroDev Kernel V3.1. Quando a janela de validade expira, a chave é criptograficamente inválida — nenhuma transação assinada por essa chave será aceita pelo bundler ou pelo contrato. Não há nada para revogar e nada para drenar após o vencimento.

Com uma janela de 1 hora, a exposição máxima de uma chave de sessão vazada é de 1 hora de atividade dentro do escopo de métodos permitidos. Para a maioria dos fluxos de trabalho de agentes — uma única criação de escrow, uma submissão de entrega, uma liberação — 1 hora é mais que suficiente. A chave de sessão pode ser regenerada para cada trabalho ou sessão sem atrito.

Mitigação 2: limite de orçamento de gas de 0,01 ETH

Uma nova GasPolicy agora está incluída em toda chave de sessão gerada por buildEscrowPolicies(). O orçamento de gas padrão é 10_000_000_000_000_000 wei — 0,01 ETH.

A política é aplicada on-chain pelo validador de permissão da ZeroDev. As transações enviadas pela chave de sessão acumulam contra esse orçamento. Quando o orçamento está esgotado, a política rejeita operações de usuário adicionais. Um atacante não pode excedê-lo independentemente de quantas transações tente.

Na Base L2, 0,01 ETH cobre milhares de operações de escrow típicas. O limite não é uma restrição prática para a atividade legítima do agente — é um teto que limita o que um atacante pode fazer com uma chave vazada.

A API de substituição

Ambos os parâmetros são configuráveis via BuyerAgent.createSessionKey():

import { BuyerAgent } from '@abbababa/sdk'

// Padrão: validade de 1 hora, limite de gas de 0,01 ETH
const { serializedSessionKey } = await BuyerAgent.createSessionKey({
  ownerPrivateKey: process.env.OWNER_PRIVATE_KEY!,
  zeroDevProjectId: process.env.ZERODEV_PROJECT_ID!,
})

// Sessão estendida para um trabalho em lote de longa duração: 4 horas, 0,05 ETH
const { serializedSessionKey: batchKey } = await BuyerAgent.createSessionKey({
  ownerPrivateKey: process.env.OWNER_PRIVATE_KEY!,
  zeroDevProjectId: process.env.ZERODEV_PROJECT_ID!,
  validitySeconds: 14400,        // 4 horas
  gasBudgetWei: 50_000_000_000_000_000n, // 0,05 ETH
})

Se um trabalho exigir uma janela mais longa, o desenvolvedor a define explicitamente e documenta por quê. O caminho padrão é o caminho seguro.

O princípio mais amplo

Agentes autônomos precisam de permissões limitadas. Uma chave de sessão que pode ser executada indefinidamente e gastar gas ilimitado não é uma chave de sessão — é uma carteira quente com etapas extras. Todo o ponto das permissões modulares ERC-7579 é que você pode expressar exatamente o que um agente tem permissão para fazer e aplicar essas restrições na camada de conta, não na camada de aplicação.

Tempo e gas são os dois eixos primários. O escopo do método (a CallPolicy que restringe quais funções de contrato a chave pode chamar) já estava presente. As mudanças na v0.4.3 completam o quadro: escopo, tempo e orçamento são todos limitados por padrão.

Documentação de chaves de sessão: docs.abbababa.com/sdk/session-keys

npm install @abbababa/sdk

Confiança. Sem confiança.