Abba Baba Refuerza la Seguridad de las Claves de Sesión con Límites de Presupuesto de Gas y Validez de 1 Hora

Las claves de sesión permiten a los agentes autónomos operar sin mantener su clave privada principal activa. Un desarrollador de agentes genera una clave de sesión con alcance — restringida a métodos de contrato específicos, limitada en el tiempo y ahora con límite de gas — y entrega esa clave al runtime del agente. La clave privada principal permanece fría en una bóveda o HSM. El agente solo toca la clave de sesión.

Ese modelo funciona bien hasta que la clave de sesión se ve comprometida.

El modelo de amenaza

Una clave de sesión es una clave privada real. Si se filtra — a través de una variable de entorno comprometida, un pipeline de registros que captura demasiado, un ataque a la cadena de suministro en una dependencia del agente — un atacante posee una credencial que puede enviar transacciones en nombre de la cuenta inteligente del agente.

Con los valores predeterminados anteriores enviados en versiones anteriores del SDK, una clave de sesión filtrada tenía una ventana de validez de 24 horas y ningún límite de gasto de gas. Un atacante con esa clave podría enviar transacciones arbitrarias dentro del alcance del método permitido durante hasta 24 horas. En un agente de alto volumen, esa ventana es suficiente para causar daños operativos graves: inundando el contrato de escrow con transacciones spam, agotando las aprobaciones de tokens del agente, o simplemente acumulando costos de gas.

Dos cosas acotan el radio de impacto: tiempo y gas. SDK v0.4.3 ajusta ambos.

Mitigación 1: ventana de validez de 1 hora

El validitySeconds predeterminado para nuevas claves de sesión baja de 86.400 (24 horas) a 3.600 (1 hora).

Una clave de sesión se aplica en cadena a través de una TimestampPolicy adjunta al plugin de permisos ZeroDev Kernel V3.1. Una vez que expira la ventana de validez, la clave es criptográficamente inválida — ninguna transacción firmada por esa clave será aceptada por el bundler o el contrato. No hay nada que revocar y nada que drenar después de la expiración.

Con una ventana de 1 hora, la exposición máxima de una clave de sesión filtrada es 1 hora de actividad dentro del alcance del método permitido. Para la mayoría de los flujos de trabajo de agentes — una sola creación de escrow, un envío de entrega, una liberación — 1 hora es más que suficiente. La clave de sesión puede regenerarse para cada trabajo o sesión sin fricción.

Mitigación 2: límite de presupuesto de gas de 0,01 ETH

Una nueva GasPolicy ahora se incluye en cada clave de sesión generada por buildEscrowPolicies(). El presupuesto de gas predeterminado es 10_000_000_000_000_000 wei — 0,01 ETH.

La política se aplica en cadena por el validador de permisos de ZeroDev. Las transacciones enviadas por la clave de sesión se acumulan contra este presupuesto. Cuando el presupuesto se agota, la política rechaza más operaciones de usuario. Un atacante no puede excederlo independientemente de cuántas transacciones intente.

En Base L2, 0,01 ETH cubre miles de operaciones típicas de escrow. El límite no es una restricción práctica para la actividad legítima del agente — es un techo que limita lo que un atacante puede hacer con una clave filtrada.

La API de sobrescritura

Ambos parámetros son configurables a través de BuyerAgent.createSessionKey():

import { BuyerAgent } from '@abbababa/sdk'

// Por defecto: validez de 1 hora, límite de gas de 0,01 ETH
const { serializedSessionKey } = await BuyerAgent.createSessionKey({
  ownerPrivateKey: process.env.OWNER_PRIVATE_KEY!,
  zeroDevProjectId: process.env.ZERODEV_PROJECT_ID!,
})

// Sesión extendida para un trabajo por lotes de larga duración: 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
})

Si un trabajo requiere una ventana más larga, el desarrollador la establece explícitamente y documenta el porqué. La ruta predeterminada es la ruta segura.

El principio más amplio

Los agentes autónomos necesitan permisos acotados. Una clave de sesión que puede ejecutarse indefinidamente y gastar gas ilimitado no es una clave de sesión — es una cartera activa con pasos adicionales. El objetivo de los permisos modulares ERC-7579 es que puedas expresar exactamente lo que un agente tiene permitido hacer y aplicar esas restricciones en la capa de cuenta, no en la capa de aplicación.

El tiempo y el gas son los dos ejes principales. El alcance del método (la CallPolicy que restringe qué funciones de contrato puede llamar la clave) ya estaba presente. Los cambios de v0.4.3 completan el panorama: el alcance, el tiempo y el presupuesto están todos acotados por defecto.

Documentación de claves de sesión: docs.abbababa.com/sdk/session-keys

npm install @abbababa/sdk

Confianza. Sin confianza.