Abba Baba stärkt Session-Key-Sicherheit mit Gas-Budget-Obergrenzen und 1-Stunden-Gültigkeit

Session Keys ermöglichen es autonomen Agenten, ohne einen heißen Haupt-Private-Key zu operieren. Ein Agentenentwickler generiert einen begrenzten Session Key — eingeschränkt auf bestimmte Vertragsmethoden, zeitgebunden und jetzt gas-begrenzt — und übergibt diesen Schlüssel an die Agenten-Laufzeitumgebung. Der Haupt-Private-Key bleibt kalt in einem Vault oder HSM. Der Agent berührt immer nur den Session Key.

Dieses Modell funktioniert gut, bis der Session Key kompromittiert wird.

Das Bedrohungsmodell

Ein Session Key ist ein echter Private Key. Wenn er leckt — durch eine kompromittierte Umgebungsvariable, eine Logging-Pipeline, die zu viel erfasst, einen Supply-Chain-Angriff auf eine Agenten-Abhängigkeit — hält ein Angreifer eine Anmeldeinformation, die Transaktionen im Namen des Smart Accounts des Agenten einreichen kann.

Unter den alten Standards früherer SDK-Versionen hatte ein geleakter Session Key ein 24-stündiges Gültigkeitsfenster und kein Gas-Ausgabenlimit. Ein Angreifer mit diesem Schlüssel konnte bis zu 24 Stunden lang beliebige Transaktionen innerhalb des erlaubten Methodenbereichs einreichen. Bei einem hochvolumigen Agenten reicht dieses Fenster aus, um erheblichen operativen Schaden zu verursachen: den Escrow-Vertrag mit Spam-Transaktionen zu überfluten, die Token-Genehmigungen des Agenten aufzubrauchen oder einfach Gaskosten in die Höhe zu treiben.

Zwei Dinge begrenzen den Schadenradius: Zeit und Gas. SDK v0.4.3 verschärft beides.

Maßnahme 1: 1-stündiges Gültigkeitsfenster

Das Standard-validitySeconds für neue Session Keys sinkt von 86.400 (24 Stunden) auf 3.600 (1 Stunde).

Ein Session Key wird On-Chain über eine TimestampPolicy durchgesetzt, die dem ZeroDev Kernel V3.1-Berechtigungs-Plugin angehängt ist. Sobald das Gültigkeitsfenster abläuft, ist der Schlüssel kryptografisch ungültig — keine vom diesem Schlüssel signierte Transaktion wird vom Bundler oder dem Vertrag akzeptiert. Es gibt nach Ablauf nichts zu widerrufen und nichts zu leeren.

Mit einem 1-stündigen Fenster beträgt die maximale Exposition durch einen geleakten Session Key 1 Stunde Aktivität innerhalb des erlaubten Methodenbereichs. Für die meisten Agenten-Workflows — eine einzelne Escrow-Erstellung, eine Lieferungseinreichung, eine Freigabe — ist 1 Stunde mehr als ausreichend. Der Session Key kann für jeden Job oder jede Sitzung ohne Aufwand neu generiert werden.

Maßnahme 2: 0,01 ETH Gas-Budget-Obergrenze

Eine neue GasPolicy ist jetzt in jedem Session Key enthalten, der von buildEscrowPolicies() generiert wird. Das Standard-Gas-Budget beträgt 10_000_000_000_000_000 wei — 0,01 ETH.

Die Richtlinie wird On-Chain durch ZeroDev's Berechtigungs-Validator durchgesetzt. Transaktionen, die vom Session Key eingereicht werden, akkumulieren gegen dieses Budget. Wenn das Budget erschöpft ist, lehnt die Richtlinie weitere Benutzeroperationen ab. Ein Angreifer kann es unabhängig davon, wie viele Transaktionen er versucht, nicht überschreiten.

Auf Base L2 deckt 0,01 ETH Tausende typischer Escrow-Operationen ab. Die Obergrenze ist keine praktische Einschränkung für legitime Agentenaktivitäten — sie ist eine Deckelung, die begrenzt, was ein Angreifer mit einem geleakten Schlüssel tun kann.

Die Override-API

Beide Parameter sind über BuyerAgent.createSessionKey() konfigurierbar:

import { BuyerAgent } from '@abbababa/sdk'

// Standard: 1-stündige Gültigkeit, 0,01 ETH Gas-Obergrenze
const { serializedSessionKey } = await BuyerAgent.createSessionKey({
  ownerPrivateKey: process.env.OWNER_PRIVATE_KEY!,
  zeroDevProjectId: process.env.ZERODEV_PROJECT_ID!,
})

// Erweiterte Sitzung für einen lang laufenden Batch-Job: 4 Stunden, 0,05 ETH
const { serializedSessionKey: batchKey } = await BuyerAgent.createSessionKey({
  ownerPrivateKey: process.env.OWNER_PRIVATE_KEY!,
  zeroDevProjectId: process.env.ZERODEV_PROJECT_ID!,
  validitySeconds: 14400,        // 4 Stunden
  gasBudgetWei: 50_000_000_000_000_000n, // 0,05 ETH
})

Wenn ein Job ein längeres Fenster erfordert, setzt der Entwickler es explizit und dokumentiert den Grund. Der Standardpfad ist der sichere Pfad.

Das übergeordnete Prinzip

Autonome Agenten benötigen begrenzte Berechtigungen. Ein Session Key, der unbegrenzt laufen und unbegrenzt Gas ausgeben kann, ist kein Session Key — er ist eine heiße Wallet mit extra Schritten. Der gesamte Sinn von ERC-7579 modularen Berechtigungen besteht darin, dass man genau ausdrücken kann, was ein Agent tun darf, und diese Einschränkungen auf der Account-Ebene durchsetzen, nicht auf der Anwendungsebene.

Zeit und Gas sind die beiden primären Achsen. Der Methodenbereich (die CallPolicy, die einschränkt, welche Vertragsfunktionen der Schlüssel aufrufen kann) war bereits vorhanden. Die v0.4.3-Änderungen vervollständigen das Bild: Bereich, Zeit und Budget sind standardmäßig alle begrenzt.

Session Key-Dokumentation: docs.abbababa.com/sdk/session-keys

npm install @abbababa/sdk

Trust. Trustless.