@proofgate/agentkit 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 ProofGate
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,247 @@
+# @proofgate/agentkit
+
+[![npm version](https://img.shields.io/npm/v/@proofgate/agentkit.svg)](https://www.npmjs.com/package/@proofgate/agentkit)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+**ProofGate Action Provider for Coinbase AgentKit** - Add transaction security validation to your AI agents.
+
+ProofGate validates blockchain transactions in real-time, detecting and blocking:
+- 🚫 Phishing addresses
+- 🏴 Sanctioned wallets
+- 💀 Known scam contracts
+- ⚠️ Suspicious patterns
+
+## Installation
+
+```bash
+npm install @proofgate/agentkit @coinbase/agentkit
+# or
+yarn add @proofgate/agentkit @coinbase/agentkit
+# or
+pnpm add @proofgate/agentkit @coinbase/agentkit
+```
+
+## Quick Start
+
+```typescript
+import { AgentKit } from "@coinbase/agentkit";
+import { proofGateActionProvider } from "@proofgate/agentkit";
+
+const agent = await AgentKit.from({
+  walletProvider,
+  actionProviders: [
+    proofGateActionProvider({
+      apiKey: process.env.PROOFGATE_API_KEY!,
+    }),
+  ],
+});
+
+// Your agent now has transaction validation superpowers! 🛡️
+```
+
+## Features
+
+### 🔍 Transaction Validation
+
+Validate any transaction before execution:
+
+```typescript
+// The agent can use the validate_transaction action
+const validation = await agent.execute(`
+  Validate this transaction before I send:
+  - To: 0xSuspiciousAddress...
+  - Amount: 5 ETH
+`);
+// Returns: SAFE, WARNING, or BLOCKED with risk details
+```
+
+### 🔐 Safe Transfers
+
+Execute transfers with automatic validation:
+
+```typescript
+// The agent can use the safe_transfer action
+const result = await agent.execute(`
+  Send 100 USDC to 0xRecipient... using ProofGate validation
+`);
+// Transaction will be blocked if the address is malicious
+```
+
+### 📋 Audit Trail
+
+Every validation returns a `proofId` for compliance:
+
+```typescript
+// Later, check validation status
+const status = await agent.execute(`
+  Get validation status for proof ID: 550e8400-e29b-41d4-a716-446655440000
+`);
+```
+
+## Configuration
+
+```typescript
+const proofgate = proofGateActionProvider({
+  // Required
+  apiKey: process.env.PROOFGATE_API_KEY!,
+
+  // Optional settings
+  baseUrl: "https://www.proofgate.xyz/api/v1", // Custom API endpoint
+  blockThreshold: 70,    // Block transactions with risk score >= 70
+  warnThreshold: 40,     // Issue warnings for risk score >= 40
+  allowWarnings: true,   // Allow transactions with WARNING status
+  timeout: 10000,        // API timeout in milliseconds
+  verbose: false,        // Enable debug logging
+});
+```
+
+## Actions Provided
+
+| Action | Description |
+|--------|-------------|
+| `proofgate_validate_transaction` | Validate transaction parameters against threat intelligence |
+| `proofgate_safe_transfer` | Transfer with automatic ProofGate validation |
+| `proofgate_get_validation_status` | Check status of a previous validation by proof ID |
+
+## Validation Response
+
+```typescript
+interface ValidationResult {
+  success: boolean;
+  proofId: string;              // Unique ID for audit trail
+  status: "SAFE" | "WARNING" | "BLOCKED";
+  riskScore: number;            // 0-100 risk score
+  riskFactors: string[];        // Detected risk factors
+  allowed: boolean;             // Whether to proceed
+  recommendation: string;       // Human-readable advice
+  metadata?: {
+    addressLabels?: Record<string, string>;
+    contractInfo?: { verified: boolean; name?: string };
+    sanctions?: boolean;
+    phishing?: boolean;
+  };
+}
+```
+
+## Integration Examples
+
+### With Langchain
+
+```typescript
+import { AgentKit, createLangChainTools } from "@coinbase/agentkit";
+import { proofGateActionProvider } from "@proofgate/agentkit";
+import { ChatOpenAI } from "@langchain/openai";
+import { createReactAgent } from "@langchain/langgraph/prebuilt";
+
+const agent = await AgentKit.from({
+  walletProvider,
+  actionProviders: [proofGateActionProvider({ apiKey: process.env.PROOFGATE_API_KEY! })],
+});
+
+const tools = await createLangChainTools(agent);
+const langchainAgent = createReactAgent({
+  llm: new ChatOpenAI({ model: "gpt-4" }),
+  tools,
+});
+```
+
+### With OpenAI Assistants
+
+```typescript
+import { AgentKit, createOpenAITools } from "@coinbase/agentkit";
+import { proofGateActionProvider } from "@proofgate/agentkit";
+import OpenAI from "openai";
+
+const agent = await AgentKit.from({
+  walletProvider,
+  actionProviders: [proofGateActionProvider({ apiKey: process.env.PROOFGATE_API_KEY! })],
+});
+
+const openai = new OpenAI();
+const tools = createOpenAITools(agent);
+
+const assistant = await openai.beta.assistants.create({
+  name: "Secure Crypto Agent",
+  instructions: "You are a crypto agent that validates all transactions with ProofGate before executing.",
+  tools,
+  model: "gpt-4-turbo",
+});
+```
+
+### Wrapping Existing Transfers
+
+For maximum security, validate before using other action providers:
+
+```typescript
+import { AgentKit } from "@coinbase/agentkit";
+import { erc20ActionProvider } from "@coinbase/agentkit";
+import { proofGateActionProvider } from "@proofgate/agentkit";
+
+const agent = await AgentKit.from({
+  walletProvider,
+  actionProviders: [
+    proofGateActionProvider({ apiKey: process.env.PROOFGATE_API_KEY! }),
+    erc20ActionProvider(), // ProofGate validates, ERC20 executes
+  ],
+});
+
+// Agent workflow:
+// 1. Use proofgate_validate_transaction to check recipient
+// 2. If SAFE/WARNING allowed, use erc20_transfer to execute
+// 3. Log the proofId for compliance
+```
+
+## Network Support
+
+ProofGate supports all EVM-compatible networks:
+- Ethereum Mainnet
+- Base
+- Arbitrum
+- Optimism
+- Polygon
+- And more...
+
+## API Reference
+
+### proofGateActionProvider(config)
+
+Creates a new ProofGate action provider instance.
+
+**Parameters:**
+- `config.apiKey` (required): Your ProofGate API key
+- `config.baseUrl` (optional): Custom API endpoint
+- `config.blockThreshold` (optional): Risk score to block (default: 70)
+- `config.warnThreshold` (optional): Risk score to warn (default: 40)
+- `config.allowWarnings` (optional): Allow WARNING status (default: true)
+- `config.timeout` (optional): Request timeout ms (default: 10000)
+- `config.verbose` (optional): Debug logging (default: false)
+
+## Getting an API Key
+
+Visit [proofgate.xyz](https://proofgate.xyz) to get your API key.
+
+## Security Best Practices
+
+1. **Always validate before high-value transactions**
+2. **Set appropriate thresholds** - Lower `blockThreshold` for stricter security
+3. **Log proofIds** - Keep audit trail for compliance
+4. **Handle failures safely** - If validation fails, don't proceed
+5. **Use in combination** - Layer with other security measures
+
+## Contributing
+
+Contributions are welcome! Please read our [Contributing Guide](CONTRIBUTING.md) first.
+
+## License
+
+MIT - see [LICENSE](LICENSE)
+
+## Support
+
+- 📧 Email: support@proofgate.xyz
+- 🐦 Twitter: [@proofgate](https://twitter.com/proofgate)
+- 📚 Docs: [docs.proofgate.xyz](https://docs.proofgate.xyz)
+
+---
+
+Built with ❤️ by [ProofGate](https://proofgate.xyz)

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @proofgate/agentkit
+ *
+ * ProofGate transaction validation action provider for Coinbase AgentKit.
+ * Validates blockchain transactions through ProofGate's security API to detect
+ * and block malicious, phishing, or sanctioned addresses.
+ *
+ * @packageDocumentation
+ */
+export * from "./proofgate-action-provider.js";
+export * from "./schemas.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,cAAc,gCAAgC,CAAC;AAC/C,cAAc,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,28 @@
+"use strict";
+/**
+ * @proofgate/agentkit
+ *
+ * ProofGate transaction validation action provider for Coinbase AgentKit.
+ * Validates blockchain transactions through ProofGate's security API to detect
+ * and block malicious, phishing, or sanctioned addresses.
+ *
+ * @packageDocumentation
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./proofgate-action-provider.js"), exports);
+__exportStar(require("./schemas.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;;;;;;;;;;;;;;AAEH,iEAA+C;AAC/C,+CAA6B"}

package/dist/proofgate-action-provider.d.ts

@@ -0,0 +1,98 @@
+import { z } from "zod";
+import { ActionProvider, EvmWalletProvider, Network } from "@coinbase/agentkit";
+import { ValidateTransactionSchema, GetValidationStatusSchema, SafeTransferSchema, ProofGateConfig } from "./schemas.js";
+/**
+ * ProofGateActionProvider provides transaction validation through ProofGate's
+ * security API. It can be used standalone or to wrap existing transaction actions
+ * with security checks.
+ *
+ * @example
+ * ```typescript
+ * import { proofGateActionProvider } from "@proofgate/agentkit";
+ *
+ * const agent = await AgentKit.from({
+ *   walletProvider,
+ *   actionProviders: [
+ *     proofGateActionProvider({
+ *       apiKey: process.env.PROOFGATE_API_KEY!,
+ *       blockThreshold: 70,
+ *     }),
+ *   ],
+ * });
+ * ```
+ */
+export declare class ProofGateActionProvider extends ActionProvider<EvmWalletProvider> {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly allowWarnings;
+    private readonly timeout;
+    private readonly verbose;
+    /**
+     * Constructs a new ProofGateActionProvider.
+     *
+     * @param config - ProofGate configuration options
+     */
+    constructor(config: ProofGateConfig);
+    /**
+     * Internal method to call ProofGate validation API
+     */
+    private callValidationApi;
+    /**
+     * Logs a message if verbose mode is enabled
+     */
+    private log;
+    /**
+     * Validates a transaction through ProofGate's security API.
+     * This is the core validation action that checks transaction parameters
+     * against ProofGate's security intelligence.
+     *
+     * @param args - The transaction parameters to validate
+     * @returns Validation result as stringified JSON
+     */
+    validateTransaction(args: z.infer<typeof ValidateTransactionSchema>): Promise<string>;
+    /**
+     * Validates and executes a transfer with ProofGate protection.
+     * Blocks the transaction if ProofGate determines it's unsafe.
+     *
+     * @param walletProvider - The wallet provider to execute the transfer
+     * @param args - Transfer parameters including destination and amount
+     * @returns Transfer result or block message
+     */
+    safeTransfer(walletProvider: EvmWalletProvider, args: z.infer<typeof SafeTransferSchema>): Promise<string>;
+    /**
+     * Gets the validation status for a previously submitted transaction.
+     *
+     * @param args - The proof ID to look up
+     * @returns Validation status as stringified JSON
+     */
+    getValidationStatus(args: z.infer<typeof GetValidationStatusSchema>): Promise<string>;
+    /**
+     * Generates a human-readable recommendation based on validation result
+     */
+    private getRecommendation;
+    /**
+     * Checks if this action provider supports the given network.
+     * ProofGate supports all EVM networks.
+     *
+     * @param network - The network to check
+     * @returns True if the network is EVM-based
+     */
+    supportsNetwork(network: Network): boolean;
+}
+/**
+ * Factory function to create a ProofGateActionProvider instance.
+ *
+ * @param config - ProofGate configuration options
+ * @returns A new ProofGateActionProvider instance
+ *
+ * @example
+ * ```typescript
+ * const proofgate = proofGateActionProvider({
+ *   apiKey: process.env.PROOFGATE_API_KEY!,
+ *   blockThreshold: 70,
+ *   verbose: true,
+ * });
+ * ```
+ */
+export declare const proofGateActionProvider: (config: ProofGateConfig) => ProofGateActionProvider;
+//# sourceMappingURL=proofgate-action-provider.d.ts.map

package/dist/proofgate-action-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proofgate-action-provider.d.ts","sourceRoot":"","sources":["../src/proofgate-action-provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAgB,iBAAiB,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC9F,OAAO,EACL,yBAAyB,EACzB,yBAAyB,EACzB,kBAAkB,EAClB,eAAe,EAGhB,MAAM,cAAc,CAAC;AAKtB;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,uBAAwB,SAAQ,cAAc,CAAC,iBAAiB,CAAC;IAC5E,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAU;IACxC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAElC;;;;OAIG;gBACS,MAAM,EAAE,eAAe;IAcnC;;OAEG;YACW,iBAAiB;IAsC/B;;OAEG;IACH,OAAO,CAAC,GAAG;IAMX;;;;;;;OAOG;IAwBG,mBAAmB,CACvB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,GAC9C,OAAO,CAAC,MAAM,CAAC;IAsClB;;;;;;;OAOG;IAiBG,YAAY,CAChB,cAAc,EAAE,iBAAiB,EACjC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,GACvC,OAAO,CAAC,MAAM,CAAC;IAiFlB;;;;;OAKG;IAaG,mBAAmB,CACvB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,GAC9C,OAAO,CAAC,MAAM,CAAC;IAmDlB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAiBzB;;;;;;OAMG;IACH,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO;CAG3C;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,uBAAuB,GAAI,QAAQ,eAAe,4BAC1B,CAAC"}

package/dist/proofgate-action-provider.js

@@ -0,0 +1,395 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.proofGateActionProvider = exports.ProofGateActionProvider = void 0;
+const zod_1 = require("zod");
+const agentkit_1 = require("@coinbase/agentkit");
+const schemas_js_1 = require("./schemas.js");
+const DEFAULT_API_URL = "https://www.proofgate.xyz/api/v1";
+const DEFAULT_TIMEOUT = 10000;
+/**
+ * ProofGateActionProvider provides transaction validation through ProofGate's
+ * security API. It can be used standalone or to wrap existing transaction actions
+ * with security checks.
+ *
+ * @example
+ * ```typescript
+ * import { proofGateActionProvider } from "@proofgate/agentkit";
+ *
+ * const agent = await AgentKit.from({
+ *   walletProvider,
+ *   actionProviders: [
+ *     proofGateActionProvider({
+ *       apiKey: process.env.PROOFGATE_API_KEY!,
+ *       blockThreshold: 70,
+ *     }),
+ *   ],
+ * });
+ * ```
+ */
+class ProofGateActionProvider extends agentkit_1.ActionProvider {
+    apiKey;
+    baseUrl;
+    allowWarnings;
+    timeout;
+    verbose;
+    /**
+     * Constructs a new ProofGateActionProvider.
+     *
+     * @param config - ProofGate configuration options
+     */
+    constructor(config) {
+        super("proofgate", []);
+        if (!config.apiKey) {
+            throw new Error("ProofGate API key is required");
+        }
+        this.apiKey = config.apiKey;
+        this.baseUrl = config.baseUrl ?? DEFAULT_API_URL;
+        this.allowWarnings = config.allowWarnings ?? true;
+        this.timeout = config.timeout ?? DEFAULT_TIMEOUT;
+        this.verbose = config.verbose ?? false;
+    }
+    /**
+     * Internal method to call ProofGate validation API
+     */
+    async callValidationApi(params) {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            const response = await fetch(`${this.baseUrl}/validate`, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    Authorization: `Bearer ${this.apiKey}`,
+                    "X-ProofGate-Client": "agentkit",
+                    "X-ProofGate-Version": "1.0.0",
+                },
+                body: JSON.stringify({
+                    from: params.fromAddress,
+                    to: params.toAddress,
+                    value: params.value ?? "0",
+                    data: params.data ?? "0x",
+                    chainId: params.chainId,
+                    tokenAddress: params.tokenAddress,
+                    tokenAmount: params.tokenAmount,
+                }),
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                const errorBody = await response.text();
+                throw new Error(`ProofGate API error (${response.status}): ${errorBody}`);
+            }
+            return await response.json();
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    /**
+     * Logs a message if verbose mode is enabled
+     */
+    log(message, data) {
+        if (this.verbose) {
+            console.log(`[ProofGate] ${message}`, data ?? "");
+        }
+    }
+    /**
+     * Validates a transaction through ProofGate's security API.
+     * This is the core validation action that checks transaction parameters
+     * against ProofGate's security intelligence.
+     *
+     * @param args - The transaction parameters to validate
+     * @returns Validation result as stringified JSON
+     */
+    async validateTransaction(args) {
+        try {
+            this.log("Validating transaction", args);
+            const result = await this.callValidationApi(args);
+            this.log("Validation result", result);
+            const statusEmoji = {
+                [schemas_js_1.ValidationStatus.SAFE]: "✅",
+                [schemas_js_1.ValidationStatus.WARNING]: "⚠️",
+                [schemas_js_1.ValidationStatus.BLOCKED]: "🚫",
+                [schemas_js_1.ValidationStatus.PENDING]: "⏳",
+            };
+            return JSON.stringify({
+                success: true,
+                proofId: result.proofId,
+                status: result.status,
+                statusDisplay: `${statusEmoji[result.status]} ${result.status}`,
+                riskScore: result.riskScore,
+                riskFactors: result.riskFactors,
+                allowed: result.status === schemas_js_1.ValidationStatus.SAFE ||
+                    (result.status === schemas_js_1.ValidationStatus.WARNING && this.allowWarnings),
+                metadata: result.metadata,
+                recommendation: this.getRecommendation(result),
+            });
+        }
+        catch (error) {
+            this.log("Validation error", error);
+            return JSON.stringify({
+                success: false,
+                error: error instanceof Error ? error.message : "Unknown validation error",
+                allowed: false,
+                recommendation: "Transaction validation failed. Do not proceed.",
+            });
+        }
+    }
+    /**
+     * Validates and executes a transfer with ProofGate protection.
+     * Blocks the transaction if ProofGate determines it's unsafe.
+     *
+     * @param walletProvider - The wallet provider to execute the transfer
+     * @param args - Transfer parameters including destination and amount
+     * @returns Transfer result or block message
+     */
+    async safeTransfer(walletProvider, args) {
+        try {
+            const network = walletProvider.getNetwork();
+            const fromAddress = walletProvider.getAddress();
+            this.log("Safe transfer requested", { from: fromAddress, ...args });
+            // Validate through ProofGate first
+            const chainId = typeof network.chainId === "number"
+                ? network.chainId
+                : parseInt(String(network.chainId), 10) || 1;
+            const validationResult = await this.callValidationApi({
+                fromAddress,
+                toAddress: args.destinationAddress,
+                chainId,
+                tokenAddress: args.tokenAddress,
+                value: args.tokenAddress ? undefined : args.amount,
+                tokenAmount: args.tokenAddress ? args.amount : undefined,
+            });
+            this.log("ProofGate validation result", validationResult);
+            // Check if transaction should be blocked
+            if (validationResult.status === schemas_js_1.ValidationStatus.BLOCKED) {
+                return JSON.stringify({
+                    success: false,
+                    blocked: true,
+                    proofId: validationResult.proofId,
+                    status: schemas_js_1.ValidationStatus.BLOCKED,
+                    riskScore: validationResult.riskScore,
+                    riskFactors: validationResult.riskFactors,
+                    message: `🚫 TRANSACTION BLOCKED by ProofGate\n\nRisk Score: ${validationResult.riskScore}/100\nReasons: ${validationResult.riskFactors.join(", ")}\n\nThis transaction was blocked for your protection. Do NOT proceed with this address.`,
+                });
+            }
+            // Check warnings
+            if (validationResult.status === schemas_js_1.ValidationStatus.WARNING && !this.allowWarnings) {
+                return JSON.stringify({
+                    success: false,
+                    blocked: true,
+                    proofId: validationResult.proofId,
+                    status: schemas_js_1.ValidationStatus.WARNING,
+                    riskScore: validationResult.riskScore,
+                    riskFactors: validationResult.riskFactors,
+                    message: `⚠️ TRANSACTION BLOCKED due to warnings\n\nRisk Score: ${validationResult.riskScore}/100\nReasons: ${validationResult.riskFactors.join(", ")}\n\nThis transaction was blocked because warnings are not allowed in the current configuration.`,
+                });
+            }
+            // Validation passed - return validation info
+            // Note: Actual transfer execution should be done by the ERC20 or wallet action provider
+            return JSON.stringify({
+                success: true,
+                validated: true,
+                proofId: validationResult.proofId,
+                status: validationResult.status,
+                riskScore: validationResult.riskScore,
+                riskFactors: validationResult.riskFactors,
+                message: validationResult.status === schemas_js_1.ValidationStatus.SAFE
+                    ? `✅ Transaction validated as SAFE by ProofGate\n\nProof ID: ${validationResult.proofId}\nRisk Score: ${validationResult.riskScore}/100\n\nYou may proceed with the transfer.`
+                    : `⚠️ Transaction has WARNINGS but is allowed\n\nProof ID: ${validationResult.proofId}\nRisk Score: ${validationResult.riskScore}/100\nWarnings: ${validationResult.riskFactors.join(", ")}\n\nProceed with caution.`,
+                transferParams: {
+                    from: fromAddress,
+                    to: args.destinationAddress,
+                    amount: args.amount,
+                    tokenAddress: args.tokenAddress ?? "native",
+                    chainId: network.chainId,
+                    networkId: network.networkId,
+                },
+            });
+        }
+        catch (error) {
+            this.log("Safe transfer error", error);
+            return JSON.stringify({
+                success: false,
+                error: error instanceof Error ? error.message : "Unknown error",
+                blocked: true,
+                message: "❌ ProofGate validation failed. Transaction blocked for safety.",
+            });
+        }
+    }
+    /**
+     * Gets the validation status for a previously submitted transaction.
+     *
+     * @param args - The proof ID to look up
+     * @returns Validation status as stringified JSON
+     */
+    async getValidationStatus(args) {
+        try {
+            this.log("Getting validation status", args);
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+            try {
+                const response = await fetch(`${this.baseUrl}/validate/${args.proofId}`, {
+                    method: "GET",
+                    headers: {
+                        Authorization: `Bearer ${this.apiKey}`,
+                        "X-ProofGate-Client": "agentkit",
+                        "X-ProofGate-Version": "1.0.0",
+                    },
+                    signal: controller.signal,
+                });
+                if (!response.ok) {
+                    if (response.status === 404) {
+                        return JSON.stringify({
+                            success: false,
+                            error: `Proof ID not found: ${args.proofId}`,
+                        });
+                    }
+                    throw new Error(`ProofGate API error: ${response.status}`);
+                }
+                const result = await response.json();
+                return JSON.stringify({
+                    success: true,
+                    proofId: result.proofId,
+                    status: result.status,
+                    riskScore: result.riskScore,
+                    riskFactors: result.riskFactors,
+                    timestamp: result.timestamp,
+                    metadata: result.metadata,
+                });
+            }
+            finally {
+                clearTimeout(timeoutId);
+            }
+        }
+        catch (error) {
+            this.log("Get status error", error);
+            return JSON.stringify({
+                success: false,
+                error: error instanceof Error ? error.message : "Unknown error",
+            });
+        }
+    }
+    /**
+     * Generates a human-readable recommendation based on validation result
+     */
+    getRecommendation(result) {
+        switch (result.status) {
+            case schemas_js_1.ValidationStatus.SAFE:
+                return "This transaction appears safe. You may proceed.";
+            case schemas_js_1.ValidationStatus.WARNING:
+                return this.allowWarnings
+                    ? `Proceed with caution. Risk factors: ${result.riskFactors.join(", ")}`
+                    : "This transaction has warnings and is blocked by current settings.";
+            case schemas_js_1.ValidationStatus.BLOCKED:
+                return `DO NOT proceed with this transaction. Risk factors: ${result.riskFactors.join(", ")}`;
+            case schemas_js_1.ValidationStatus.PENDING:
+                return "Validation is still processing. Please check again shortly.";
+            default:
+                return "Unable to determine recommendation.";
+        }
+    }
+    /**
+     * Checks if this action provider supports the given network.
+     * ProofGate supports all EVM networks.
+     *
+     * @param network - The network to check
+     * @returns True if the network is EVM-based
+     */
+    supportsNetwork(network) {
+        return network.protocolFamily === "evm";
+    }
+}
+exports.ProofGateActionProvider = ProofGateActionProvider;
+__decorate([
+    (0, agentkit_1.CreateAction)({
+        name: "validate_transaction",
+        description: `Validate a blockchain transaction through ProofGate's security API.
+    
+This action checks transaction parameters against ProofGate's threat intelligence to detect:
+- Malicious or phishing addresses
+- Sanctioned wallets
+- Suspicious contract interactions
+- Known scam patterns
+
+Inputs:
+- fromAddress: The sender wallet address (your wallet)
+- toAddress: The recipient or contract address
+- chainId: The blockchain network ID (e.g., 1 for Ethereum, 8453 for Base)
+- value: (Optional) Transaction value in wei
+- data: (Optional) Transaction calldata for contract interactions
+- tokenAddress: (Optional) ERC20 token contract address
+- tokenAmount: (Optional) Token amount in base units
+
+Returns validation status (SAFE, WARNING, or BLOCKED) with risk details.
+Always use this before executing high-value or unfamiliar transactions.`,
+        schema: schemas_js_1.ValidateTransactionSchema,
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [void 0]),
+    __metadata("design:returntype", Promise)
+], ProofGateActionProvider.prototype, "validateTransaction", null);
+__decorate([
+    (0, agentkit_1.CreateAction)({
+        name: "safe_transfer",
+        description: `Execute a transfer with ProofGate security validation.
+    
+This action validates the destination address through ProofGate before executing.
+If the address is flagged as malicious, the transfer will be BLOCKED.
+
+Inputs:
+- amount: Amount to transfer in whole units (e.g., "0.5" for 0.5 ETH)
+- destinationAddress: The recipient address
+- tokenAddress: (Optional) ERC20 token address. Omit for native ETH/token transfers.
+
+Use this instead of regular transfer for maximum security.
+The transaction will only execute if ProofGate validation passes.`,
+        schema: schemas_js_1.SafeTransferSchema,
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [agentkit_1.EvmWalletProvider, void 0]),
+    __metadata("design:returntype", Promise)
+], ProofGateActionProvider.prototype, "safeTransfer", null);
+__decorate([
+    (0, agentkit_1.CreateAction)({
+        name: "get_validation_status",
+        description: `Get the validation status for a previously submitted transaction.
+    
+Use this to check on the status of a transaction that was validated earlier.
+
+Inputs:
+- proofId: The proof ID returned from a previous validate_transaction call
+
+Returns the current status and any updated risk information.`,
+        schema: schemas_js_1.GetValidationStatusSchema,
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [void 0]),
+    __metadata("design:returntype", Promise)
+], ProofGateActionProvider.prototype, "getValidationStatus", null);
+/**
+ * Factory function to create a ProofGateActionProvider instance.
+ *
+ * @param config - ProofGate configuration options
+ * @returns A new ProofGateActionProvider instance
+ *
+ * @example
+ * ```typescript
+ * const proofgate = proofGateActionProvider({
+ *   apiKey: process.env.PROOFGATE_API_KEY!,
+ *   blockThreshold: 70,
+ *   verbose: true,
+ * });
+ * ```
+ */
+const proofGateActionProvider = (config) => new ProofGateActionProvider(config);
+exports.proofGateActionProvider = proofGateActionProvider;
+//# sourceMappingURL=proofgate-action-provider.js.map

package/dist/proofgate-action-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proofgate-action-provider.js","sourceRoot":"","sources":["../src/proofgate-action-provider.ts"],"names":[],"mappings":"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"}

package/dist/schemas.d.ts

@@ -0,0 +1,123 @@
+import { z } from "zod";
+/**
+ * ProofGate validation status enum
+ */
+export declare const ValidationStatus: {
+    readonly SAFE: "SAFE";
+    readonly BLOCKED: "BLOCKED";
+    readonly WARNING: "WARNING";
+    readonly PENDING: "PENDING";
+};
+export type ValidationStatus = (typeof ValidationStatus)[keyof typeof ValidationStatus];
+/**
+ * Input schema for validating a transaction
+ */
+export declare const ValidateTransactionSchema: z.ZodObject<{
+    fromAddress: z.ZodString;
+    toAddress: z.ZodString;
+    value: z.ZodOptional<z.ZodString>;
+    data: z.ZodOptional<z.ZodString>;
+    chainId: z.ZodNumber;
+    tokenAddress: z.ZodOptional<z.ZodString>;
+    tokenAmount: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    fromAddress: string;
+    toAddress: string;
+    chainId: number;
+    value?: string | undefined;
+    data?: string | undefined;
+    tokenAddress?: string | undefined;
+    tokenAmount?: string | undefined;
+}, {
+    fromAddress: string;
+    toAddress: string;
+    chainId: number;
+    value?: string | undefined;
+    data?: string | undefined;
+    tokenAddress?: string | undefined;
+    tokenAmount?: string | undefined;
+}>;
+/**
+ * Input schema for getting validation status by proof ID
+ */
+export declare const GetValidationStatusSchema: z.ZodObject<{
+    proofId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    proofId: string;
+}, {
+    proofId: string;
+}>;
+/**
+ * Input schema for wrapped transfer with validation
+ */
+export declare const SafeTransferSchema: z.ZodObject<{
+    amount: z.ZodString;
+    destinationAddress: z.ZodString;
+    tokenAddress: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    amount: string;
+    destinationAddress: string;
+    tokenAddress?: string | undefined;
+}, {
+    amount: string;
+    destinationAddress: string;
+    tokenAddress?: string | undefined;
+}>;
+/**
+ * ProofGate API response type
+ */
+export interface ProofGateValidationResponse {
+    proofId: string;
+    status: ValidationStatus;
+    riskScore: number;
+    riskFactors: string[];
+    timestamp: string;
+    metadata?: {
+        addressLabels?: Record<string, string>;
+        contractInfo?: {
+            verified: boolean;
+            name?: string;
+        };
+        sanctions?: boolean;
+        phishing?: boolean;
+    };
+}
+/**
+ * ProofGate configuration options
+ */
+export interface ProofGateConfig {
+    /**
+     * ProofGate API key
+     */
+    apiKey: string;
+    /**
+     * ProofGate API base URL (defaults to production)
+     */
+    baseUrl?: string;
+    /**
+     * Risk score threshold (0-100) above which transactions are blocked
+     * Default: 70
+     */
+    blockThreshold?: number;
+    /**
+     * Risk score threshold (0-100) above which warnings are issued
+     * Default: 40
+     */
+    warnThreshold?: number;
+    /**
+     * Whether to allow transactions in WARNING status
+     * Default: true
+     */
+    allowWarnings?: boolean;
+    /**
+     * Request timeout in milliseconds
+     * Default: 10000
+     */
+    timeout?: number;
+    /**
+     * Enable verbose logging
+     * Default: false
+     */
+    verbose?: boolean;
+}
+//# sourceMappingURL=schemas.d.ts.map

package/dist/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;CAKnB,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAC;AAExF;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;EAiC6B,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;EAQ4B,CAAC;AAEnE;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;EAgBmD,CAAC;AAEnF;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,gBAAgB,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE;QACT,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACvC,YAAY,CAAC,EAAE;YACb,QAAQ,EAAE,OAAO,CAAC;YAClB,IAAI,CAAC,EAAE,MAAM,CAAC;SACf,CAAC;QACF,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB"}

package/dist/schemas.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SafeTransferSchema = exports.GetValidationStatusSchema = exports.ValidateTransactionSchema = exports.ValidationStatus = void 0;
+const zod_1 = require("zod");
+/**
+ * ProofGate validation status enum
+ */
+exports.ValidationStatus = {
+    SAFE: "SAFE",
+    BLOCKED: "BLOCKED",
+    WARNING: "WARNING",
+    PENDING: "PENDING",
+};
+/**
+ * Input schema for validating a transaction
+ */
+exports.ValidateTransactionSchema = zod_1.z
+    .object({
+    fromAddress: zod_1.z
+        .string()
+        .regex(/^0x[a-fA-F0-9]{40}$/, "Invalid Ethereum address format")
+        .describe("The sender wallet address"),
+    toAddress: zod_1.z
+        .string()
+        .regex(/^0x[a-fA-F0-9]{40}$/, "Invalid Ethereum address format")
+        .describe("The recipient/contract address"),
+    value: zod_1.z
+        .string()
+        .optional()
+        .describe("Transaction value in wei (optional for contract calls)"),
+    data: zod_1.z
+        .string()
+        .optional()
+        .describe("Transaction calldata (optional)"),
+    chainId: zod_1.z
+        .number()
+        .positive()
+        .describe("The chain ID of the network"),
+    tokenAddress: zod_1.z
+        .string()
+        .regex(/^0x[a-fA-F0-9]{40}$/, "Invalid Ethereum address format")
+        .optional()
+        .describe("Token contract address for ERC20 transfers (optional)"),
+    tokenAmount: zod_1.z
+        .string()
+        .optional()
+        .describe("Token amount in base units (optional)"),
+})
+    .strip()
+    .describe("Transaction parameters to validate through ProofGate");
+/**
+ * Input schema for getting validation status by proof ID
+ */
+exports.GetValidationStatusSchema = zod_1.z
+    .object({
+    proofId: zod_1.z
+        .string()
+        .uuid()
+        .describe("The proof ID returned from a previous validation"),
+})
+    .strip()
+    .describe("Get the status of a previously submitted validation");
+/**
+ * Input schema for wrapped transfer with validation
+ */
+exports.SafeTransferSchema = zod_1.z
+    .object({
+    amount: zod_1.z
+        .string()
+        .describe("The amount to transfer in whole units (e.g. 1.5 ETH or 100 USDC)"),
+    destinationAddress: zod_1.z
+        .string()
+        .regex(/^0x[a-fA-F0-9]{40}$/, "Invalid Ethereum address format")
+        .describe("The destination address to send funds to"),
+    tokenAddress: zod_1.z
+        .string()
+        .regex(/^0x[a-fA-F0-9]{40}$/, "Invalid Ethereum address format")
+        .optional()
+        .describe("Token contract address for ERC20 transfers (omit for native ETH)"),
+})
+    .strip()
+    .describe("Transfer with ProofGate validation - blocks suspicious transactions");
+//# sourceMappingURL=schemas.js.map

package/dist/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB;;GAEG;AACU,QAAA,gBAAgB,GAAG;IAC9B,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;CACV,CAAC;AAIX;;GAEG;AACU,QAAA,yBAAyB,GAAG,OAAC;KACvC,MAAM,CAAC;IACN,WAAW,EAAE,OAAC;SACX,MAAM,EAAE;SACR,KAAK,CAAC,qBAAqB,EAAE,iCAAiC,CAAC;SAC/D,QAAQ,CAAC,2BAA2B,CAAC;IACxC,SAAS,EAAE,OAAC;SACT,MAAM,EAAE;SACR,KAAK,CAAC,qBAAqB,EAAE,iCAAiC,CAAC;SAC/D,QAAQ,CAAC,gCAAgC,CAAC;IAC7C,KAAK,EAAE,OAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,wDAAwD,CAAC;IACrE,IAAI,EAAE,OAAC;SACJ,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,iCAAiC,CAAC;IAC9C,OAAO,EAAE,OAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,6BAA6B,CAAC;IAC1C,YAAY,EAAE,OAAC;SACZ,MAAM,EAAE;SACR,KAAK,CAAC,qBAAqB,EAAE,iCAAiC,CAAC;SAC/D,QAAQ,EAAE;SACV,QAAQ,CAAC,uDAAuD,CAAC;IACpE,WAAW,EAAE,OAAC;SACX,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,uCAAuC,CAAC;CACrD,CAAC;KACD,KAAK,EAAE;KACP,QAAQ,CAAC,sDAAsD,CAAC,CAAC;AAEpE;;GAEG;AACU,QAAA,yBAAyB,GAAG,OAAC;KACvC,MAAM,CAAC;IACN,OAAO,EAAE,OAAC;SACP,MAAM,EAAE;SACR,IAAI,EAAE;SACN,QAAQ,CAAC,kDAAkD,CAAC;CAChE,CAAC;KACD,KAAK,EAAE;KACP,QAAQ,CAAC,qDAAqD,CAAC,CAAC;AAEnE;;GAEG;AACU,QAAA,kBAAkB,GAAG,OAAC;KAChC,MAAM,CAAC;IACN,MAAM,EAAE,OAAC;SACN,MAAM,EAAE;SACR,QAAQ,CAAC,kEAAkE,CAAC;IAC/E,kBAAkB,EAAE,OAAC;SAClB,MAAM,EAAE;SACR,KAAK,CAAC,qBAAqB,EAAE,iCAAiC,CAAC;SAC/D,QAAQ,CAAC,0CAA0C,CAAC;IACvD,YAAY,EAAE,OAAC;SACZ,MAAM,EAAE;SACR,KAAK,CAAC,qBAAqB,EAAE,iCAAiC,CAAC;SAC/D,QAAQ,EAAE;SACV,QAAQ,CAAC,kEAAkE,CAAC;CAChF,CAAC;KACD,KAAK,EAAE;KACP,QAAQ,CAAC,qEAAqE,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@proofgate/agentkit",
+  "version": "1.0.0",
+  "description": "ProofGate transaction validation action provider for Coinbase AgentKit",
+  "author": "ProofGate <hello@proofgate.xyz>",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/proofgate/agentkit.git"
+  },
+  "homepage": "https://proofgate.xyz",
+  "bugs": {
+    "url": "https://github.com/proofgate/agentkit/issues"
+  },
+  "keywords": [
+    "proofgate",
+    "agentkit",
+    "coinbase",
+    "transaction-validation",
+    "security",
+    "ai-agent",
+    "blockchain",
+    "web3"
+  ],
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist/*",
+    "lint": "eslint -c .eslintrc.json \"src/**/*.ts\"",
+    "lint:fix": "eslint -c .eslintrc.json \"src/**/*.ts\" --fix",
+    "format": "prettier -c .prettierrc --write \"**/*.{ts,js,json,md}\"",
+    "format:check": "prettier -c .prettierrc --check \"**/*.{ts,js,json,md}\"",
+    "test": "jest --no-cache --testMatch='**/*.test.ts'",
+    "prepack": "npm run build"
+  },
+  "peerDependencies": {
+    "@coinbase/agentkit": ">=0.10.0"
+  },
+  "dependencies": {
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@coinbase/agentkit": "^0.10.4",
+    "@types/jest": "^29.5.14",
+    "@types/node": "^20.11.0",
+    "@typescript-eslint/eslint-plugin": "^7.0.0",
+    "@typescript-eslint/parser": "^7.0.0",
+    "eslint": "^8.57.0",
+    "jest": "^29.7.0",
+    "prettier": "^3.2.0",
+    "reflect-metadata": "^0.2.2",
+    "ts-jest": "^29.2.5",
+    "typescript": "^5.7.2"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  }
+}