WalletPrint
WalletPrint is a behavioral transaction risk SDK for crypto wallets and AI agent wallets. It scores proposed transactions to detect anomalies like new recipients, unusual amounts, velocity spikes, and known scam addresses. It is for developers building wallet or agent integrations that need pre-transaction risk screening.
✨ Key features
- Scores transactions for behavioral risk (new recipients, unusual amounts, velocity).
- Provides reason codes and risk bands (e.g., high, medium).
- Supports EVM chains (e.g., Base) and Solana.
- Integrates with ZeroDev, LangChain, and Solana via wrappers.
- Offers per-agent API keys and webhook alerts.
- Advisory mode: never blocks transactions, only signals risk.
🎯 Use cases
- Screen transactions for AI agent wallets before signing.
- Integrate risk scoring into ZeroDev session-key send flows.
- Add a risk assessment tool to LangChain agents.
- Monitor Solana agent wallet transactions for anomalies.
- Build a compliance audit trail with CSV exports.
📦 Installation
🧰 Requirements: Requires Node.js and an API key (sandbox key walletprint-dev-key for testing; production key from dashboard).
npm install @walletprint/sdk
🚀 Usage
import { WalletPrintClient } from "@walletprint/sdk";
const client = new WalletPrintClient({
baseUrl: "https://walletprint.up.railway.app",
apiKey: process.env.WALLETPRINT_API_KEY!,
});
const result = await client.score({
wallet: { address: "0xYourWallet", chain: "base" },
transaction: { to: "0xRecipient", value_usd: 1200, asset: "USDC" },
});
console.log(result.score, result.band, result.reason_codes);
⚠️ Good to know
v1 is advisory only; the SDK does not block transactions. The open-source SDK does not include the scoring engine, API, or dashboard.
❓ FAQ
How do I get a production API key?
Sign up at walletprint.vercel.app/dashboard/signup to receive a master integrator key (wp_live_…). You can then create per-agent keys from the dashboard or via the API.
Does WalletPrint block transactions?
No, v1 is advisory only. It returns risk scores and reason codes, and your application decides whether to proceed, pause, or require human approval.
Can I test without signing up?
Yes, use the sandbox key walletprint-dev-key with base URL https://walletprint.up.railway.app. It is rate-limited and scores are not persisted.
What integrations are supported?
ZeroDev (wrapZeroDevSendTransaction), LangChain (createLangChainDynamicTool), Solana (createSolanaWalletPrintMiddleware), and a framework-agnostic tool (createWalletPrintScoreTool).
📊 Repository
🤖 Overview, features, install steps and FAQ were generated from the project's README on Sep 4, 2026. Always check the original source before running commands.