Skip to content

feat(agentkit): Add WalletPrintActionProvider for behavioral transaction risk scoring#1335

Open
Loai17 wants to merge 1 commit into
coinbase:mainfrom
Loai17:feat/walletprint-action-provider
Open

feat(agentkit): Add WalletPrintActionProvider for behavioral transaction risk scoring#1335
Loai17 wants to merge 1 commit into
coinbase:mainfrom
Loai17:feat/walletprint-action-provider

Conversation

@Loai17

@Loai17 Loai17 commented Jun 22, 2026

Copy link
Copy Markdown

Summary

This PR adds a native WalletPrintActionProvider for WalletPrint — an open-source behavioral transaction risk scoring SDK for AI agent wallets.

What it does

Before an agent signs a transaction, it can call score_transaction to check whether the recipient, amount, asset, or timing looks unusual relative to that wallet's own behavioral history. The action returns a risk score (0–100), a band (low / medium / high), plain-English reason codes, and a recommended action (proceed / review / escalate).

This action is advisory only — it never blocks a transaction. The agent decides what to do with the result.

Changes

  • src/action-providers/walletprint/walletprintActionProvider.tsWalletPrintActionProvider class with score_transaction action
  • src/action-providers/walletprint/schemas.ts — Zod schema for transaction inputs
  • src/action-providers/walletprint/index.ts — re-exports
  • src/action-providers/walletprint/README.md — usage docs
  • src/action-providers/walletprint/walletprintActionProvider.test.ts — 12 unit tests (all passing)
  • src/action-providers/index.ts — wired into main exports
  • .changeset/add-walletprint-action-provider.md — patch changeset

Supported networks

Ethereum mainnet (chain ID 1) and Base (chain ID 8453).

Usage

import { walletprintActionProvider } from "@coinbase/agentkit";

const agentKit = await AgentKit.from({
  walletProvider,
  actionProviders: [
    walletprintActionProvider({ apiKey: "your-api-key" }),
  ],
});

Use walletprint-dev-key as the API key for sandbox testing.

Links

Test plan

  • npx jest --testPathPattern=walletprint — 12/12 tests pass
  • Manual: instantiate walletprintActionProvider({ apiKey: "walletprint-dev-key" }) and call score_transaction against the sandbox API

…ion risk scoring

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@Loai17 Loai17 requested a review from murrlincoln as a code owner June 22, 2026 22:23
@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 1
Sum 2

@github-actions github-actions Bot added documentation Improvements or additions to documentation action provider New action provider typescript labels Jun 22, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

action provider New action provider documentation Improvements or additions to documentation typescript

Development

Successfully merging this pull request may close these issues.

2 participants