amped-defi 1.0.0

package/dist/wallet/walletRegistry.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Wallet Registry
+ *
+ * Manages wallet resolution by walletId.
+ * Supports execution mode (with private key) and prepare mode (address-only).
+ *
+ * Now integrates with evm-wallet-skill for seamless wallet configuration.
+ * @see https://github.com/surfer77/evm-wallet-skill
+ */
+import { WalletConfig } from '../types';
+/**
+ * Wallet registry entry
+ */
+interface WalletEntry extends WalletConfig {
+    mode: 'execute' | 'prepare';
+}
+/**
+ * Wallet Registry class for resolving wallet configurations
+ */
+export declare class WalletRegistry {
+    private wallets;
+    private skillAdapter;
+    constructor();
+    /**
+     * Load wallet configurations from environment
+     *
+     * @returns Map of walletId to wallet entry
+     */
+    private loadWallets;
+    /**
+     * Get a wallet by its ID (synchronous version)
+     * Only checks local registry, not skill adapter
+     *
+     * @param walletId - The wallet identifier
+     * @returns The wallet configuration or null if not found
+     */
+    getWallet(walletId: string): WalletEntry | null;
+    /**
+     * Resolve a wallet by its ID (async version)
+     * Checks local registry first, then tries skill adapter
+     *
+     * @param walletId - The wallet identifier
+     * @returns The wallet configuration or null if not found
+     */
+    resolveWallet(walletId: string): Promise<WalletEntry | null>;
+    /**
+     * Validate a wallet entry
+     */
+    private validateWallet;
+    /**
+     * Get the wallet mode (execute or prepare)
+     *
+     * @returns The current wallet mode
+     */
+    getMode(): 'execute' | 'prepare';
+    /**
+     * Check if running in execute mode
+     *
+     * @returns True if in execute mode
+     */
+    isExecuteMode(): boolean;
+    /**
+     * Check if running in prepare mode
+     *
+     * @returns True if in prepare mode
+     */
+    isPrepareMode(): boolean;
+    /**
+     * Get all registered wallet IDs (local + skill)
+     *
+     * @returns Array of wallet IDs
+     */
+    getWalletIds(): string[];
+    /**
+     * Get the count of registered wallets (local + skill)
+     *
+     * @returns Number of wallets
+     */
+    getWalletCount(): number;
+    /**
+     * Reload wallets from environment (useful for hot-reloading)
+     */
+    reload(): void;
+}
+/**
+ * Get the singleton wallet registry instance
+ * @returns The WalletRegistry singleton
+ */
+export declare function getWalletRegistry(): WalletRegistry;
+/**
+ * Reset the wallet registry (useful for testing)
+ */
+export declare function resetWalletRegistry(): void;
+export {};
+//# sourceMappingURL=walletRegistry.d.ts.map

package/dist/wallet/walletRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"walletRegistry.d.ts","sourceRoot":"","sources":["../../src/wallet/walletRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAGxC;;GAEG;AACH,UAAU,WAAY,SAAQ,YAAY;IACxC,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC;CAC7B;AAED;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAA2B;IAC1C,OAAO,CAAC,YAAY,CAAwB;;IAY5C;;;;OAIG;IACH,OAAO,CAAC,WAAW;IA4BnB;;;;;;OAMG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAU/C;;;;;;OAMG;IACG,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IA2BlE;;OAEG;IACH,OAAO,CAAC,cAAc;IAgBtB;;;;OAIG;IACH,OAAO,IAAI,SAAS,GAAG,SAAS;IAIhC;;;;OAIG;IACH,aAAa,IAAI,OAAO;IAIxB;;;;OAIG;IACH,aAAa,IAAI,OAAO;IAIxB;;;;OAIG;IACH,YAAY,IAAI,MAAM,EAAE;IAOxB;;;;OAIG;IACH,cAAc,IAAI,MAAM;IAIxB;;OAEG;IACH,MAAM,IAAI,IAAI;CAGf;AAKD;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,CAKlD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C"}

package/dist/wallet/walletRegistry.js

@@ -0,0 +1,184 @@
+/**
+ * Wallet Registry
+ *
+ * Manages wallet resolution by walletId.
+ * Supports execution mode (with private key) and prepare mode (address-only).
+ *
+ * Now integrates with evm-wallet-skill for seamless wallet configuration.
+ * @see https://github.com/surfer77/evm-wallet-skill
+ */
+import { getWalletAdapter } from './skillWalletAdapter';
+/**
+ * Wallet Registry class for resolving wallet configurations
+ */
+export class WalletRegistry {
+    wallets;
+    skillAdapter;
+    constructor() {
+        this.skillAdapter = getWalletAdapter();
+        this.wallets = this.loadWallets();
+        // Log skill adapter status
+        if (this.skillAdapter.isUsingSkillWallets()) {
+            console.log('[walletRegistry] evm-wallet-skill integration active');
+        }
+    }
+    /**
+     * Load wallet configurations from environment
+     *
+     * @returns Map of walletId to wallet entry
+     */
+    loadWallets() {
+        const walletsJson = process.env.AMPED_OC_WALLETS_JSON;
+        const mode = process.env.AMPED_OC_MODE || 'execute';
+        if (!walletsJson) {
+            console.warn('[walletRegistry] AMPED_OC_WALLETS_JSON not set');
+            return new Map();
+        }
+        try {
+            const walletConfigs = JSON.parse(walletsJson);
+            const wallets = new Map();
+            for (const [walletId, config] of Object.entries(walletConfigs)) {
+                wallets.set(walletId, {
+                    ...config,
+                    mode,
+                });
+            }
+            console.log(`[walletRegistry] Loaded ${wallets.size} wallet(s) in ${mode} mode`);
+            return wallets;
+        }
+        catch (error) {
+            console.error('[walletRegistry] Failed to parse AMPED_OC_WALLETS_JSON', error);
+            return new Map();
+        }
+    }
+    /**
+     * Get a wallet by its ID (synchronous version)
+     * Only checks local registry, not skill adapter
+     *
+     * @param walletId - The wallet identifier
+     * @returns The wallet configuration or null if not found
+     */
+    getWallet(walletId) {
+        const wallet = this.wallets.get(walletId);
+        if (wallet) {
+            return this.validateWallet(wallet, walletId);
+        }
+        console.error(`[walletRegistry] Wallet not found: ${walletId}`);
+        return null;
+    }
+    /**
+     * Resolve a wallet by its ID (async version)
+     * Checks local registry first, then tries skill adapter
+     *
+     * @param walletId - The wallet identifier
+     * @returns The wallet configuration or null if not found
+     */
+    async resolveWallet(walletId) {
+        // Try local registry first (synchronous)
+        const wallet = this.getWallet(walletId);
+        if (wallet) {
+            return wallet;
+        }
+        // Try skill adapter (includes ~/.evm-wallet.json)
+        if (this.skillAdapter.isUsingSkillWallets()) {
+            try {
+                const config = await this.skillAdapter.getWalletConfig(walletId);
+                const mode = this.getMode();
+                return {
+                    address: config.address,
+                    privateKey: config.privateKey,
+                    mode,
+                };
+            }
+            catch (error) {
+                console.error(`[walletRegistry] Skill wallet resolution failed: ${error}`);
+            }
+        }
+        console.error(`[walletRegistry] Wallet not found: ${walletId}`);
+        return null;
+    }
+    /**
+     * Validate a wallet entry
+     */
+    validateWallet(wallet, walletId) {
+        // In execute mode, validate that private key is present
+        if (wallet.mode === 'execute' && !wallet.privateKey) {
+            console.error(`[walletRegistry] Wallet ${walletId} missing privateKey in execute mode`);
+            return null;
+        }
+        // Validate address format (basic check)
+        if (!wallet.address || !wallet.address.startsWith('0x')) {
+            console.error(`[walletRegistry] Wallet ${walletId} has invalid address: ${wallet.address}`);
+            return null;
+        }
+        return wallet;
+    }
+    /**
+     * Get the wallet mode (execute or prepare)
+     *
+     * @returns The current wallet mode
+     */
+    getMode() {
+        return process.env.AMPED_OC_MODE || 'execute';
+    }
+    /**
+     * Check if running in execute mode
+     *
+     * @returns True if in execute mode
+     */
+    isExecuteMode() {
+        return this.getMode() === 'execute';
+    }
+    /**
+     * Check if running in prepare mode
+     *
+     * @returns True if in prepare mode
+     */
+    isPrepareMode() {
+        return this.getMode() === 'prepare';
+    }
+    /**
+     * Get all registered wallet IDs (local + skill)
+     *
+     * @returns Array of wallet IDs
+     */
+    getWalletIds() {
+        const localIds = Array.from(this.wallets.keys());
+        const skillIds = this.skillAdapter.getWalletIds();
+        // Merge unique IDs
+        return [...new Set([...localIds, ...skillIds])];
+    }
+    /**
+     * Get the count of registered wallets (local + skill)
+     *
+     * @returns Number of wallets
+     */
+    getWalletCount() {
+        return this.getWalletIds().length;
+    }
+    /**
+     * Reload wallets from environment (useful for hot-reloading)
+     */
+    reload() {
+        this.wallets = this.loadWallets();
+    }
+}
+// Singleton instance
+let walletRegistryInstance = null;
+/**
+ * Get the singleton wallet registry instance
+ * @returns The WalletRegistry singleton
+ */
+export function getWalletRegistry() {
+    if (!walletRegistryInstance) {
+        walletRegistryInstance = new WalletRegistry();
+    }
+    return walletRegistryInstance;
+}
+/**
+ * Reset the wallet registry (useful for testing)
+ */
+export function resetWalletRegistry() {
+    walletRegistryInstance = null;
+}
+//# sourceMappingURL=walletRegistry.js.map

package/dist/wallet/walletRegistry.js.map

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

package/index.js

@@ -0,0 +1,2 @@
+// Re-export from compiled dist
+module.exports = require('./dist/index.js');

package/openclaw.plugin.json

@@ -0,0 +1,37 @@
+{
+    "id": "amped-defi",
+    "kind": "tools",
+    "uiHints": {
+        "walletsJson": {
+            "label": "Wallets JSON",
+            "sensitive": true,
+            "placeholder": "{\"default\": {\"privateKey\": \"0x...\"}}",
+            "help": "JSON object mapping wallet IDs to configs. Or use ${AMPED_OC_WALLETS_JSON}"
+        },
+        "rpcUrlsJson": {
+            "label": "RPC URLs JSON",
+            "placeholder": "{\"sonic\": \"https://rpc.sonic.fantom.network\"}",
+            "help": "JSON object mapping chain IDs to RPC URLs. Or use ${AMPED_OC_RPC_URLS_JSON}"
+        },
+        "mode": {
+            "label": "Execution Mode",
+            "help": "'execute' (default) = execute transactions, 'simulate' = dry-run only"
+        },
+        "dynamicConfig": {
+            "label": "Dynamic SDK Config",
+            "help": "Fetch fresh configuration from SODAX API on startup",
+            "advanced": true
+        }
+    },
+    "configSchema": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+            "walletsJson": { "type": "string" },
+            "rpcUrlsJson": { "type": "string" },
+            "mode": { "type": "string", "enum": ["execute", "simulate"] },
+            "dynamicConfig": { "type": "boolean" }
+        },
+        "required": []
+    }
+}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "amped-defi",
+  "version": "1.0.0",
+  "description": "Amped DeFi plugin for cross-chain swaps, bridging, and money markets via SODAX SDK",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "src",
+    "index.js",
+    "README.md",
+    "openclaw.plugin.json"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src --ext .ts",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage"
+  },
+  "openclaw": {
+    "extensions": [
+      "./index.js"
+    ]
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/amped-finance/amped-openclaw.git"
+  },
+  "homepage": "https://github.com/amped-finance/amped-openclaw#readme",
+  "bugs": {
+    "url": "https://github.com/amped-finance/amped-openclaw/issues"
+  },
+  "author": "Amped Finance",
+  "dependencies": {
+    "@sinclair/typebox": "^0.32.0",
+    "@sodax/sdk": "1.1.0-beta-rc2",
+    "@sodax/wallet-sdk-core": "1.1.0-beta-rc2",
+    "@sodax/types": "1.1.0-beta-rc2",
+    "viem": "^2.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.3.0",
+    "eslint": "^8.0.0",
+    "@typescript-eslint/eslint-plugin": "^6.0.0",
+    "@typescript-eslint/parser": "^6.0.0",
+    "jest": "^29.0.0",
+    "@types/jest": "^29.0.0",
+    "ts-jest": "^29.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "openclaw",
+    "plugin",
+    "defi",
+    "sodax",
+    "bridge",
+    "swap",
+    "money-market",
+    "cross-chain",
+    "intent"
+  ],
+  "license": "MIT"
+}

package/src/__mocks__/@sodax/sdk.ts

@@ -0,0 +1,28 @@
+/**
+ * Mock for @sodax/sdk
+ */
+
+export class Sodax {
+  static initialize = jest.fn().mockResolvedValue(undefined);
+  
+  swaps = {
+    getQuote: jest.fn(),
+    executeSwap: jest.fn(),
+    cancelIntent: jest.fn(),
+  };
+  
+  bridge = {
+    getBridgeableTokens: jest.fn(),
+    bridge: jest.fn(),
+  };
+  
+  moneyMarket = {
+    supply: jest.fn(),
+    withdraw: jest.fn(),
+    borrow: jest.fn(),
+    repay: jest.fn(),
+    getUserAccountDataOnSpoke: jest.fn(),
+  };
+}
+
+export const Intent = {};

package/src/__tests__/errors.test.ts

@@ -0,0 +1,238 @@
+/**
+ * Error Handling Utilities Tests
+ */
+
+import {
+  ErrorCode,
+  ErrorSeverity,
+  AmpedDefiError,
+  createPolicyError,
+  createWalletError,
+  createTransactionError,
+  wrapError,
+  isRetryableError,
+  getRetryDelay,
+  logError,
+} from '../utils/errors';
+
+describe('Error Utilities', () => {
+  describe('AmpedDefiError', () => {
+    it('should create error with all properties', () => {
+      const error = new AmpedDefiError(
+        ErrorCode.POLICY_SLIPPAGE_EXCEEDED,
+        'Slippage too high',
+        {
+          severity: ErrorSeverity.WARNING,
+          remediation: 'Increase slippage tolerance',
+          details: { current: 100, limit: 50 },
+          context: { operation: 'swap', walletId: 'test' },
+        }
+      );
+
+      expect(error.code).toBe(ErrorCode.POLICY_SLIPPAGE_EXCEEDED);
+      expect(error.message).toBe('Slippage too high');
+      expect(error.severity).toBe(ErrorSeverity.WARNING);
+      expect(error.remediation).toBe('Increase slippage tolerance');
+      expect(error.details).toEqual({ current: 100, limit: 50 });
+      expect(error.context).toEqual({ operation: 'swap', walletId: 'test' });
+      expect(error.name).toBe('AmpedDefiError');
+    });
+
+    it('should default severity to ERROR', () => {
+      const error = new AmpedDefiError(
+        ErrorCode.UNKNOWN_ERROR,
+        'Something went wrong'
+      );
+
+      expect(error.severity).toBe(ErrorSeverity.ERROR);
+    });
+
+    it('should serialize to JSON correctly', () => {
+      const error = new AmpedDefiError(
+        ErrorCode.WALLET_NOT_FOUND,
+        'Wallet not found',
+        { remediation: 'Check configuration' }
+      );
+
+      const json = error.toJSON();
+      expect(json.code).toBe(ErrorCode.WALLET_NOT_FOUND);
+      expect(json.message).toBe('Wallet not found');
+      expect(json.remediation).toBe('Check configuration');
+    });
+
+    it('should generate user-friendly message', () => {
+      const error = new AmpedDefiError(
+        ErrorCode.TRANSACTION_FAILED,
+        'Transaction failed',
+        { remediation: 'Try again later' }
+      );
+
+      const userMsg = error.toUserMessage();
+      expect(userMsg).toContain('[TRANSACTION_FAILED] Transaction failed');
+      expect(userMsg).toContain('Suggestion: Try again later');
+    });
+  });
+
+  describe('Error Factory Functions', () => {
+    it('should create policy error with remediation', () => {
+      const error = createPolicyError(
+        ErrorCode.POLICY_SLIPPAGE_EXCEEDED,
+        'Slippage exceeds limit',
+        { current: 150, limit: 100 }
+      );
+
+      expect(error.code).toBe(ErrorCode.POLICY_SLIPPAGE_EXCEEDED);
+      expect(error.severity).toBe(ErrorSeverity.WARNING);
+      expect(error.remediation).toContain('150');
+      expect(error.remediation).toContain('100');
+      expect(error.remediation).toContain('exceeds limit');
+    });
+
+    it('should create wallet error with context', () => {
+      const cause = new Error('Original error');
+      const error = createWalletError(
+        ErrorCode.WALLET_NOT_FOUND,
+        'my-wallet',
+        cause,
+        { operation: 'borrow' }
+      );
+
+      expect(error.code).toBe(ErrorCode.WALLET_NOT_FOUND);
+      expect(error.message).toContain('my-wallet');
+      expect(error.context).toEqual({ operation: 'borrow', walletId: 'my-wallet' });
+      expect(error.cause).toBe(cause);
+    });
+
+    it('should create transaction error with txHash', () => {
+      const error = createTransactionError(
+        ErrorCode.TRANSACTION_TIMEOUT,
+        'Transaction timed out',
+        '0xabc123'
+      );
+
+      expect(error.code).toBe(ErrorCode.TRANSACTION_TIMEOUT);
+      expect(error.details).toEqual({ txHash: '0xabc123' });
+      expect(error.context).toEqual({ txHash: '0xabc123' });
+    });
+  });
+
+  describe('wrapError', () => {
+    it('should return AmpedDefiError as-is', () => {
+      const original = new AmpedDefiError(
+        ErrorCode.SDK_NOT_INITIALIZED,
+        'SDK not ready'
+      );
+      const wrapped = wrapError(original);
+
+      expect(wrapped).toBe(original);
+    });
+
+    it('should wrap standard Error and infer code', () => {
+      const original = new Error('Insufficient balance for transaction');
+      const wrapped = wrapError(original);
+
+      expect(wrapped).toBeInstanceOf(AmpedDefiError);
+      expect(wrapped.code).toBe(ErrorCode.INSUFFICIENT_BALANCE);
+      expect(wrapped.message).toBe('Insufficient balance for transaction');
+    });
+
+    it('should use fallback code when unable to infer', () => {
+      const original = new Error('Some random error');
+      const wrapped = wrapError(original, ErrorCode.UNKNOWN_ERROR);
+
+      expect(wrapped.code).toBe(ErrorCode.UNKNOWN_ERROR);
+    });
+
+    it('should wrap non-error values', () => {
+      const wrapped = wrapError('string error');
+
+      expect(wrapped).toBeInstanceOf(AmpedDefiError);
+      expect(wrapped.message).toBe('string error');
+    });
+  });
+
+  describe('isRetryableError', () => {
+    it('should identify retryable error codes', () => {
+      const timeoutError = new AmpedDefiError(
+        ErrorCode.TRANSACTION_TIMEOUT,
+        'Timeout'
+      );
+      expect(isRetryableError(timeoutError)).toBe(true);
+
+      const rpcError = new AmpedDefiError(
+        ErrorCode.RPC_URL_NOT_CONFIGURED,
+        'RPC error'
+      );
+      expect(isRetryableError(rpcError)).toBe(true);
+    });
+
+    it('should identify non-retryable error codes', () => {
+      const policyError = new AmpedDefiError(
+        ErrorCode.POLICY_SLIPPAGE_EXCEEDED,
+        'Slippage'
+      );
+      expect(isRetryableError(policyError)).toBe(false);
+    });
+
+    it('should check message patterns for generic errors', () => {
+      const networkError = new Error('Network connection failed');
+      expect(isRetryableError(networkError)).toBe(true);
+
+      const randomError = new Error('Something broke');
+      expect(isRetryableError(randomError)).toBe(false);
+    });
+  });
+
+  describe('getRetryDelay', () => {
+    it('should calculate exponential backoff', () => {
+      expect(getRetryDelay(0)).toBe(1000);
+      expect(getRetryDelay(1)).toBe(2000);
+      expect(getRetryDelay(2)).toBe(4000);
+      expect(getRetryDelay(3)).toBe(8000);
+    });
+
+    it('should cap at 30 seconds', () => {
+      expect(getRetryDelay(10)).toBe(30000);
+      expect(getRetryDelay(20)).toBe(30000);
+    });
+
+    it('should use custom base delay', () => {
+      expect(getRetryDelay(0, 500)).toBe(500);
+      expect(getRetryDelay(1, 500)).toBe(1000);
+    });
+  });
+
+  describe('logError', () => {
+    it('should log structured error', () => {
+      const consoleSpy = jest.spyOn(console, 'error').mockImplementation();
+
+      const error = new AmpedDefiError(
+        ErrorCode.TRANSACTION_FAILED,
+        'Transaction failed'
+      );
+
+      logError(error, { operation: 'swap', walletId: 'test' });
+
+      expect(consoleSpy).toHaveBeenCalled();
+      const logged = JSON.parse(consoleSpy.mock.calls[0][0]);
+      expect(logged.component).toBe('amped-defi');
+      expect(logged.code).toBe(ErrorCode.TRANSACTION_FAILED);
+      expect(logged.level).toBe('error');
+
+      consoleSpy.mockRestore();
+    });
+
+    it('should handle standard errors', () => {
+      const consoleSpy = jest.spyOn(console, 'error').mockImplementation();
+
+      const error = new Error('Standard error');
+      logError(error);
+
+      expect(consoleSpy).toHaveBeenCalled();
+      const logged = JSON.parse(consoleSpy.mock.calls[0][0]);
+      expect(logged.code).toBe(ErrorCode.UNKNOWN_ERROR);
+
+      consoleSpy.mockRestore();
+    });
+  });
+});