agentsoul-sdk 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,44 @@
+import { ethers } from 'ethers';
+export interface AgentSoulConfig {
+    vaultAddress: string;
+    endpoint?: string;
+    network?: 'testnet' | 'mainnet';
+    dailyLimit?: string;
+    guardianWallet?: string;
+    apiKey?: string;
+}
+export interface ValidateTransferParams {
+    recipientAddress: string;
+    amountEth: number;
+    agentId?: string;
+    token?: string;
+}
+export interface ValidateResult {
+    allowed: boolean;
+    status: 'approved' | 'rejected_limit' | 'rejected_allowlist' | 'failed';
+    reason?: string;
+    message: string;
+    todaySpentEth?: number;
+    signature?: string;
+}
+export declare class AgentSoul {
+    private config;
+    private endpoint;
+    constructor(config?: Partial<AgentSoulConfig>);
+    /**
+     * Pre-flight policy verification for AI agent transactions
+     * Intercepts and validates against spending limits, allowlists, and shared immune threats.
+     */
+    validateTransfer(params: ValidateTransferParams): Promise<ValidateResult>;
+    /**
+     * Complete safe transaction runner on Robinhood Chain
+     * Validates with AgentSoul shield before executing on-chain via ethers.js
+     */
+    executeSecureTransfer(wallet: ethers.Wallet, params: ValidateTransferParams): Promise<{
+        success: boolean;
+        txHash?: string;
+        error?: string;
+    }>;
+    getConfig(): AgentSoulConfig;
+}
+export default AgentSoul;

package/dist/index.js

@@ -0,0 +1,149 @@
+"use strict";
+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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentSoul = void 0;
+const ethers_1 = require("ethers");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+class AgentSoul {
+    constructor(config) {
+        // 1. Auto-load from local agentsoul.config.json if available
+        let fileConfig = {};
+        const configPath = path.join(process.cwd(), 'agentsoul.config.json');
+        if (fs.existsSync(configPath)) {
+            try {
+                fileConfig = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+            }
+            catch (err) {
+                console.warn('[AgentSoul] Warning: could not parse local agentsoul.config.json');
+            }
+        }
+        this.config = {
+            vaultAddress: config?.vaultAddress || fileConfig.vaultAddress || '0x89205A3A3b2A69De6Dbf7f01ED13B2108B2c43e7',
+            endpoint: config?.endpoint || fileConfig.endpoint || 'https://agentsoul.tech/api/transfer',
+            network: config?.network || fileConfig.network || 'testnet',
+            dailyLimit: config?.dailyLimit || fileConfig.dailyLimit || '2.0',
+            guardianWallet: config?.guardianWallet || fileConfig.guardianWallet || '',
+            apiKey: config?.apiKey || fileConfig.apiKey || '',
+        };
+        this.endpoint = this.config.endpoint || 'https://agentsoul.tech/api/transfer';
+    }
+    /**
+     * Pre-flight policy verification for AI agent transactions
+     * Intercepts and validates against spending limits, allowlists, and shared immune threats.
+     */
+    async validateTransfer(params) {
+        try {
+            const response = await fetch(this.endpoint, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    ...(this.config.apiKey ? { 'Authorization': `Bearer ${this.config.apiKey}` } : {}),
+                },
+                body: JSON.stringify({
+                    ownerAddress: this.config.vaultAddress,
+                    recipientAddress: params.recipientAddress,
+                    amountEth: params.amountEth,
+                    agentId: params.agentId || 'AI-Agent',
+                    network: this.config.network || 'testnet',
+                    token: params.token || 'ETH',
+                }),
+            });
+            const data = (await response.json());
+            return {
+                allowed: data.allowed === true,
+                status: data.status || (data.allowed ? 'approved' : 'failed'),
+                reason: data.reason,
+                message: data.message || (data.allowed ? 'Approved by AgentSoul Protocol' : 'Transaction rejected'),
+                todaySpentEth: data.todaySpentEth,
+                signature: data.signature,
+            };
+        }
+        catch (error) {
+            // Local failsafe check if backend is unreachable
+            const limit = parseFloat(this.config.dailyLimit || '2.0');
+            if (params.amountEth > limit) {
+                return {
+                    allowed: false,
+                    status: 'rejected_limit',
+                    reason: 'DAILY_LIMIT_EXCEEDED',
+                    message: `[Failsafe] Transfer ${params.amountEth} ETH exceeds local daily cap ${limit} ETH`,
+                };
+            }
+            return {
+                allowed: true,
+                status: 'approved',
+                message: `[Failsafe] Allowed under local cap (${params.amountEth} ETH <= ${limit} ETH)`,
+            };
+        }
+    }
+    /**
+     * Complete safe transaction runner on Robinhood Chain
+     * Validates with AgentSoul shield before executing on-chain via ethers.js
+     */
+    async executeSecureTransfer(wallet, params) {
+        const check = await this.validateTransfer(params);
+        if (!check.allowed) {
+            console.error(`🚨 [AgentSoul] Transaction Intercepted & Blocked: ${check.message}`);
+            return {
+                success: false,
+                error: check.message,
+            };
+        }
+        try {
+            const tx = await wallet.sendTransaction({
+                to: params.recipientAddress,
+                value: ethers_1.ethers.parseEther(params.amountEth.toString()),
+                gasLimit: 200000, // Satisfies Arbitrum Orbit L2 intrinsic gas
+            });
+            const receipt = await tx.wait();
+            return {
+                success: true,
+                txHash: receipt?.hash || tx.hash,
+            };
+        }
+        catch (txErr) {
+            return {
+                success: false,
+                error: txErr.message || 'On-chain transfer failed',
+            };
+        }
+    }
+    getConfig() {
+        return { ...this.config };
+    }
+}
+exports.AgentSoul = AgentSoul;
+exports.default = AgentSoul;

package/dist/src/index.d.ts

@@ -0,0 +1,44 @@
+import { ethers } from 'ethers';
+export interface AgentSoulConfig {
+    vaultAddress: string;
+    endpoint?: string;
+    network?: 'testnet' | 'mainnet';
+    dailyLimit?: string;
+    guardianWallet?: string;
+    apiKey?: string;
+}
+export interface ValidateTransferParams {
+    recipientAddress: string;
+    amountEth: number;
+    agentId?: string;
+    token?: string;
+}
+export interface ValidateResult {
+    allowed: boolean;
+    status: 'approved' | 'rejected_limit' | 'rejected_allowlist' | 'failed';
+    reason?: string;
+    message: string;
+    todaySpentEth?: number;
+    signature?: string;
+}
+export declare class AgentSoul {
+    private config;
+    private endpoint;
+    constructor(config?: Partial<AgentSoulConfig>);
+    /**
+     * Pre-flight policy verification for AI agent transactions
+     * Intercepts and validates against spending limits, allowlists, and shared immune threats.
+     */
+    validateTransfer(params: ValidateTransferParams): Promise<ValidateResult>;
+    /**
+     * Complete safe transaction runner on Robinhood Chain
+     * Validates with AgentSoul shield before executing on-chain via ethers.js
+     */
+    executeSecureTransfer(wallet: ethers.Wallet, params: ValidateTransferParams): Promise<{
+        success: boolean;
+        txHash?: string;
+        error?: string;
+    }>;
+    getConfig(): AgentSoulConfig;
+}
+export default AgentSoul;

package/dist/src/index.js

@@ -0,0 +1,149 @@
+"use strict";
+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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentSoul = void 0;
+const ethers_1 = require("ethers");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+class AgentSoul {
+    constructor(config) {
+        // 1. Auto-load from local agentsoul.config.json if available
+        let fileConfig = {};
+        const configPath = path.join(process.cwd(), 'agentsoul.config.json');
+        if (fs.existsSync(configPath)) {
+            try {
+                fileConfig = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+            }
+            catch (err) {
+                console.warn('[AgentSoul] Warning: could not parse local agentsoul.config.json');
+            }
+        }
+        this.config = {
+            vaultAddress: config?.vaultAddress || fileConfig.vaultAddress || '0x89205A3A3b2A69De6Dbf7f01ED13B2108B2c43e7',
+            endpoint: config?.endpoint || fileConfig.endpoint || 'https://agentsoul.tech/api/transfer',
+            network: config?.network || fileConfig.network || 'testnet',
+            dailyLimit: config?.dailyLimit || fileConfig.dailyLimit || '2.0',
+            guardianWallet: config?.guardianWallet || fileConfig.guardianWallet || '',
+            apiKey: config?.apiKey || fileConfig.apiKey || '',
+        };
+        this.endpoint = this.config.endpoint || 'https://agentsoul.tech/api/transfer';
+    }
+    /**
+     * Pre-flight policy verification for AI agent transactions
+     * Intercepts and validates against spending limits, allowlists, and shared immune threats.
+     */
+    async validateTransfer(params) {
+        try {
+            const response = await fetch(this.endpoint, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    ...(this.config.apiKey ? { 'Authorization': `Bearer ${this.config.apiKey}` } : {}),
+                },
+                body: JSON.stringify({
+                    ownerAddress: this.config.vaultAddress,
+                    recipientAddress: params.recipientAddress,
+                    amountEth: params.amountEth,
+                    agentId: params.agentId || 'AI-Agent',
+                    network: this.config.network || 'testnet',
+                    token: params.token || 'ETH',
+                }),
+            });
+            const data = (await response.json());
+            return {
+                allowed: data.allowed === true,
+                status: data.status || (data.allowed ? 'approved' : 'failed'),
+                reason: data.reason,
+                message: data.message || (data.allowed ? 'Approved by AgentSoul Protocol' : 'Transaction rejected'),
+                todaySpentEth: data.todaySpentEth,
+                signature: data.signature,
+            };
+        }
+        catch (error) {
+            // Local failsafe check if backend is unreachable
+            const limit = parseFloat(this.config.dailyLimit || '2.0');
+            if (params.amountEth > limit) {
+                return {
+                    allowed: false,
+                    status: 'rejected_limit',
+                    reason: 'DAILY_LIMIT_EXCEEDED',
+                    message: `[Failsafe] Transfer ${params.amountEth} ETH exceeds local daily cap ${limit} ETH`,
+                };
+            }
+            return {
+                allowed: true,
+                status: 'approved',
+                message: `[Failsafe] Allowed under local cap (${params.amountEth} ETH <= ${limit} ETH)`,
+            };
+        }
+    }
+    /**
+     * Complete safe transaction runner on Robinhood Chain
+     * Validates with AgentSoul shield before executing on-chain via ethers.js
+     */
+    async executeSecureTransfer(wallet, params) {
+        const check = await this.validateTransfer(params);
+        if (!check.allowed) {
+            console.error(`🚨 [AgentSoul] Transaction Intercepted & Blocked: ${check.message}`);
+            return {
+                success: false,
+                error: check.message,
+            };
+        }
+        try {
+            const tx = await wallet.sendTransaction({
+                to: params.recipientAddress,
+                value: ethers_1.ethers.parseEther(params.amountEth.toString()),
+                gasLimit: 200000, // Satisfies Arbitrum Orbit L2 intrinsic gas
+            });
+            const receipt = await tx.wait();
+            return {
+                success: true,
+                txHash: receipt?.hash || tx.hash,
+            };
+        }
+        catch (txErr) {
+            return {
+                success: false,
+                error: txErr.message || 'On-chain transfer failed',
+            };
+        }
+    }
+    getConfig() {
+        return { ...this.config };
+    }
+}
+exports.AgentSoul = AgentSoul;
+exports.default = AgentSoul;

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "agentsoul-sdk",
+  "version": "1.0.0",
+  "description": "Production Security SDK for Autonomous AI Agents on Robinhood Chain",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc"
+  },
+  "keywords": [
+    "agentsoul",
+    "ai-agents",
+    "elizaos",
+    "robinhood-chain",
+    "security",
+    "anti-drain",
+    "blockchain",
+    "evm"
+  ],
+  "author": "AgentSoul Protocol <titershield@gmail.com>",
+  "license": "MIT",
+  "dependencies": {
+    "ethers": "^6.13.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.0.0"
+  }
+}

package/src/index.ts

@@ -0,0 +1,153 @@
+import { ethers } from 'ethers';
+import * as fs from 'fs';
+import * as path from 'path';
+
+export interface AgentSoulConfig {
+  vaultAddress: string;
+  endpoint?: string;
+  network?: 'testnet' | 'mainnet';
+  dailyLimit?: string;
+  guardianWallet?: string;
+  apiKey?: string;
+}
+
+export interface ValidateTransferParams {
+  recipientAddress: string;
+  amountEth: number;
+  agentId?: string;
+  token?: string;
+}
+
+export interface ValidateResult {
+  allowed: boolean;
+  status: 'approved' | 'rejected_limit' | 'rejected_allowlist' | 'failed';
+  reason?: string;
+  message: string;
+  todaySpentEth?: number;
+  signature?: string;
+}
+
+export class AgentSoul {
+  private config: AgentSoulConfig;
+  private endpoint: string;
+
+  constructor(config?: Partial<AgentSoulConfig>) {
+    // 1. Auto-load from local agentsoul.config.json if available
+    let fileConfig: Partial<AgentSoulConfig> = {};
+    const configPath = path.join(process.cwd(), 'agentsoul.config.json');
+    if (fs.existsSync(configPath)) {
+      try {
+        fileConfig = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+      } catch (err) {
+        console.warn('[AgentSoul] Warning: could not parse local agentsoul.config.json');
+      }
+    }
+
+    this.config = {
+      vaultAddress: config?.vaultAddress || fileConfig.vaultAddress || '0x89205A3A3b2A69De6Dbf7f01ED13B2108B2c43e7',
+      endpoint: config?.endpoint || fileConfig.endpoint || 'https://agentsoul.tech/api/transfer',
+      network: config?.network || fileConfig.network || 'testnet',
+      dailyLimit: config?.dailyLimit || fileConfig.dailyLimit || '2.0',
+      guardianWallet: config?.guardianWallet || fileConfig.guardianWallet || '',
+      apiKey: config?.apiKey || fileConfig.apiKey || '',
+    };
+
+    this.endpoint = this.config.endpoint || 'https://agentsoul.tech/api/transfer';
+  }
+
+  /**
+   * Pre-flight policy verification for AI agent transactions
+   * Intercepts and validates against spending limits, allowlists, and shared immune threats.
+   */
+  public async validateTransfer(params: ValidateTransferParams): Promise<ValidateResult> {
+    try {
+      const response = await fetch(this.endpoint, {
+        method: 'POST',
+        headers: {
+          'Content-Type': 'application/json',
+          ...(this.config.apiKey ? { 'Authorization': `Bearer ${this.config.apiKey}` } : {}),
+        },
+        body: JSON.stringify({
+          ownerAddress: this.config.vaultAddress,
+          recipientAddress: params.recipientAddress,
+          amountEth: params.amountEth,
+          agentId: params.agentId || 'AI-Agent',
+          network: this.config.network || 'testnet',
+          token: params.token || 'ETH',
+        }),
+      });
+
+      const data = (await response.json()) as any;
+
+      return {
+        allowed: data.allowed === true,
+        status: data.status || (data.allowed ? 'approved' : 'failed'),
+        reason: data.reason,
+        message: data.message || (data.allowed ? 'Approved by AgentSoul Protocol' : 'Transaction rejected'),
+        todaySpentEth: data.todaySpentEth,
+        signature: data.signature,
+      };
+    } catch (error: any) {
+      // Local failsafe check if backend is unreachable
+      const limit = parseFloat(this.config.dailyLimit || '2.0');
+      if (params.amountEth > limit) {
+        return {
+          allowed: false,
+          status: 'rejected_limit',
+          reason: 'DAILY_LIMIT_EXCEEDED',
+          message: `[Failsafe] Transfer ${params.amountEth} ETH exceeds local daily cap ${limit} ETH`,
+        };
+      }
+
+      return {
+        allowed: true,
+        status: 'approved',
+        message: `[Failsafe] Allowed under local cap (${params.amountEth} ETH <= ${limit} ETH)`,
+      };
+    }
+  }
+
+  /**
+   * Complete safe transaction runner on Robinhood Chain
+   * Validates with AgentSoul shield before executing on-chain via ethers.js
+   */
+  public async executeSecureTransfer(
+    wallet: ethers.Wallet,
+    params: ValidateTransferParams
+  ): Promise<{ success: boolean; txHash?: string; error?: string }> {
+    const check = await this.validateTransfer(params);
+
+    if (!check.allowed) {
+      console.error(`🚨 [AgentSoul] Transaction Intercepted & Blocked: ${check.message}`);
+      return {
+        success: false,
+        error: check.message,
+      };
+    }
+
+    try {
+      const tx = await wallet.sendTransaction({
+        to: params.recipientAddress,
+        value: ethers.parseEther(params.amountEth.toString()),
+        gasLimit: 200000, // Satisfies Arbitrum Orbit L2 intrinsic gas
+      });
+
+      const receipt = await tx.wait();
+      return {
+        success: true,
+        txHash: receipt?.hash || tx.hash,
+      };
+    } catch (txErr: any) {
+      return {
+        success: false,
+        error: txErr.message || 'On-chain transfer failed',
+      };
+    }
+  }
+
+  public getConfig(): AgentSoulConfig {
+    return { ...this.config };
+  }
+}
+
+export default AgentSoul;

package/tsconfig.json

@@ -0,0 +1,13 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "CommonJS",
+    "declaration": true,
+    "outDir": "./dist",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "include": ["src/**/*"]
+}