Skip to content

feat(wallet-providers): add DACS-Standard (§9.5.7) pre-flight spend mandate guardrail to WalletProvider and EvmWalletProvider - #1668

Open
HaramMalik wants to merge 2 commits into
coinbase:mainfrom
HaramMalik:patch-1
Open

HaramMalik wants to merge 2 commits into
coinbase:mainfrom
HaramMalik:patch-1

Conversation

@HaramMalik

Copy link
Copy Markdown

Summary

Implements DacsMandateMeta and assertDacsSpendMandate inside WalletProvider and EvmWalletProvider (toSigner and toEip1193Provider) to enforce deterministic, fail-closed pre-flight spend mandate ceilings across AgentKit EVM wallet providers in compliance with DACS-Standard (§9.5.7 X402-1..X402-4 & §14.4 DACS-4 Settle).

Motivation

Autonomous AI agents executing on-chain transactions via EvmWalletProvider.toEip1193Provider() (eth_sendTransaction) or EvmWalletProvider.toSigner() (signTransaction) often operate under delegated session or task mandates (dacsMandate / dacsSessionId + dacsMaxAmount). Validating assertDacsSpendMandate() before signature generation or transaction broadcast prevents over-ceiling spend across all downstream EVM wallet providers (CDP, Smart Wallet, Viem, Privy, ZeroDev).

Changes

  • typescript/agentkit/src/wallet-providers/walletProvider.ts: Added DacsMandateMeta interface and assertDacsSpendMandate() atomic spend validator.
  • typescript/agentkit/src/wallet-providers/evmWalletProvider.ts: Exported DacsTransactionRequest and enforced assertDacsSpendMandate() inside toSigner().signTransaction and toEip1193Provider().request (eth_sendTransaction).

…andate guardrail to WalletProvider and EvmWalletProvider

### Summary
Implements `DacsMandateMeta` and `assertDacsSpendMandate` inside `WalletProvider` and `EvmWalletProvider` (`toSigner` and `toEip1193Provider`) to enforce deterministic, fail-closed pre-flight spend mandate ceilings across AgentKit EVM wallet providers in compliance with **DACS-Standard** (§9.5.7 `X402-1..X402-4` & §14.4 `DACS-4 Settle`).

### Motivation
Autonomous AI agents executing on-chain transactions via `EvmWalletProvider.toEip1193Provider()` (`eth_sendTransaction`) or `EvmWalletProvider.toSigner()` (`signTransaction`) often operate under delegated session or task mandates (`dacsMandate` / `dacsSessionId` + `dacsMaxAmount`). Validating `assertDacsSpendMandate()` before signature generation or transaction broadcast prevents over-ceiling spend across all downstream EVM wallet providers (CDP, Smart Wallet, Viem, Privy, ZeroDev).

### Changes
- **`typescript/agentkit/src/wallet-providers/walletProvider.ts`**: Added `DacsMandateMeta` interface and `assertDacsSpendMandate()` atomic spend validator.
- **`typescript/agentkit/src/wallet-providers/evmWalletProvider.ts`**: Exported `DacsTransactionRequest` and enforced `assertDacsSpendMandate()` inside `toSigner().signTransaction` and `toEip1193Provider().request` (`eth_sendTransaction`).
…andate guardrail to WalletProvider and EvmWalletProvider

### Summary
Implements `DacsMandateMeta` and `assertDacsSpendMandate` inside `WalletProvider` and `EvmWalletProvider` (`toSigner` and `toEip1193Provider`) to enforce deterministic, fail-closed pre-flight spend mandate ceilings across AgentKit EVM wallet providers in compliance with **DACS-Standard** (§9.5.7 `X402-1..X402-4` & §14.4 `DACS-4 Settle`).

### Motivation
Autonomous AI agents executing on-chain transactions via `EvmWalletProvider.toEip1193Provider()` (`eth_sendTransaction`) or `EvmWalletProvider.toSigner()` (`signTransaction`) often operate under delegated session or task mandates (`dacsMandate` / `dacsSessionId` + `dacsMaxAmount`). Validating `assertDacsSpendMandate()` before signature generation or transaction broadcast prevents over-ceiling spend across all downstream EVM wallet providers (CDP, Smart Wallet, Viem, Privy, ZeroDev).

### Changes
- **`typescript/agentkit/src/wallet-providers/walletProvider.ts`**: Added `DacsMandateMeta` interface and `assertDacsSpendMandate()` atomic spend validator.
- **`typescript/agentkit/src/wallet-providers/evmWalletProvider.ts`**: Exported `DacsTransactionRequest` and enforced `assertDacsSpendMandate()` inside `toSigner().signTransaction` and `toEip1193Provider().request` (`eth_sendTransaction`).
@cb-heimdall

Copy link
Copy Markdown

🟡 Heimdall Review Status

Requirement Status More Info
Reviews 🟡 0/1
Denominator calculation
Show calculation
1 if user is bot 0
1 if user is external 0
2 if repo is sensitive 0
From .codeflow.yml 1
Additional review requirements
Show calculation
Max 0
0
From CODEOWNERS 0
Global minimum 0
Max 1
1
1 if commit is unverified 0
1 if authored by an app that is not allowlisted and lacks verified human attribution 0
Sum 1

@github-actions github-actions Bot added wallet provider New wallet provider typescript labels Nov 20, 2026

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Development

Successfully merging this pull request may close these issues.

2 participants