amped-defi 1.0.0

package/dist/utils/sodaxApi.js

@@ -0,0 +1,143 @@
+/**
+ * SODAX API Client
+ *
+ * Provides access to SODAX backend API endpoints for querying intents,
+ * user history, and other off-chain data.
+ */
+import { ErrorCode, AmpedDefiError } from './errors';
+const DEFAULT_BASE_URL = 'https://canary-api.sodax.com';
+const API_VERSION = 'v1';
+export class SodaxApiClient {
+    baseUrl;
+    apiKey;
+    timeoutMs;
+    constructor(config = {}) {
+        this.baseUrl = config.baseUrl || process.env.SODAX_API_URL || DEFAULT_BASE_URL;
+        this.apiKey = config.apiKey || process.env.SODAX_API_KEY;
+        this.timeoutMs = config.timeoutMs || 30000;
+    }
+    /**
+     * Get intent by intentHash
+     * Most reliable lookup method - works for all intents
+     */
+    async getIntentByHash(intentHash) {
+        const normalizedHash = intentHash.startsWith('0x') ? intentHash : `0x${intentHash}`;
+        const url = `${this.baseUrl}/${API_VERSION}/be/intent/${normalizedHash}`;
+        console.log('[sodaxApi] Fetching intent by hash:', { intentHash: normalizedHash });
+        try {
+            const response = await this.fetchWithTimeout(url);
+            if (!response.ok) {
+                if (response.status === 404) {
+                    return null;
+                }
+                const errorText = await response.text();
+                throw new AmpedDefiError(ErrorCode.UNKNOWN_ERROR, `SODAX API error: ${response.status} ${errorText}`);
+            }
+            return await response.json();
+        }
+        catch (error) {
+            if (error instanceof AmpedDefiError)
+                throw error;
+            throw new AmpedDefiError(ErrorCode.UNKNOWN_ERROR, `Failed to fetch intent by hash: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Get intent by transaction hash
+     * NOTE: This expects the HUB chain (Sonic) transaction hash, NOT spoke chain tx
+     */
+    async getIntentByTxHash(txHash) {
+        const normalizedHash = txHash.startsWith('0x') ? txHash : `0x${txHash}`;
+        const url = `${this.baseUrl}/${API_VERSION}/be/intent/tx/${normalizedHash}`;
+        console.log('[sodaxApi] Fetching intent by txHash:', { txHash: normalizedHash });
+        try {
+            const response = await this.fetchWithTimeout(url);
+            if (!response.ok) {
+                if (response.status === 404) {
+                    return null;
+                }
+                const errorText = await response.text();
+                throw new AmpedDefiError(ErrorCode.UNKNOWN_ERROR, `SODAX API error: ${response.status} ${errorText}`);
+            }
+            return await response.json();
+        }
+        catch (error) {
+            if (error instanceof AmpedDefiError)
+                throw error;
+            throw new AmpedDefiError(ErrorCode.UNKNOWN_ERROR, `Failed to fetch intent by txHash: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    async getUserIntents(userAddress, pagination = {}, filters) {
+        if (!this.isValidAddress(userAddress)) {
+            throw new AmpedDefiError(ErrorCode.WALLET_INVALID_ADDRESS, `Invalid user address: ${userAddress}`);
+        }
+        const normalizedAddress = userAddress.toLowerCase();
+        const queryParams = new URLSearchParams();
+        if (pagination.offset !== undefined) {
+            queryParams.set('offset', pagination.offset.toString());
+        }
+        if (pagination.limit !== undefined) {
+            queryParams.set('limit', pagination.limit.toString());
+        }
+        if (filters) {
+            if (filters.open !== undefined)
+                queryParams.set('open', filters.open.toString());
+            if (filters.srcChain !== undefined)
+                queryParams.set('srcChain', filters.srcChain.toString());
+            if (filters.dstChain !== undefined)
+                queryParams.set('dstChain', filters.dstChain.toString());
+            if (filters.inputToken)
+                queryParams.set('inputToken', filters.inputToken.toLowerCase());
+            if (filters.outputToken)
+                queryParams.set('outputToken', filters.outputToken.toLowerCase());
+        }
+        const queryString = queryParams.toString();
+        const url = `${this.baseUrl}/${API_VERSION}/be/intent/user/${normalizedAddress}${queryString ? `?${queryString}` : ''}`;
+        console.log('[sodaxApi] Fetching user intents:', { userAddress: normalizedAddress });
+        try {
+            const response = await this.fetchWithTimeout(url);
+            if (!response.ok) {
+                const errorText = await response.text();
+                throw new AmpedDefiError(ErrorCode.UNKNOWN_ERROR, `SODAX API error: ${response.status} ${errorText}`);
+            }
+            return await response.json();
+        }
+        catch (error) {
+            if (error instanceof AmpedDefiError)
+                throw error;
+            throw new AmpedDefiError(ErrorCode.UNKNOWN_ERROR, `Failed to fetch user intents: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    async getOpenIntents(userAddress, pagination = {}) {
+        return this.getUserIntents(userAddress, pagination, { open: true });
+    }
+    async getIntentHistory(userAddress, pagination = {}) {
+        return this.getUserIntents(userAddress, pagination, { open: false });
+    }
+    async fetchWithTimeout(url) {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeoutMs);
+        try {
+            const headers = { 'Accept': 'application/json' };
+            if (this.apiKey)
+                headers['Authorization'] = `Bearer ${this.apiKey}`;
+            return await fetch(url, { signal: controller.signal, headers });
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    isValidAddress(address) {
+        return /^0x[a-fA-F0-9]{40}$/.test(address);
+    }
+}
+let apiClient = null;
+export function getSodaxApiClient(config) {
+    if (!apiClient) {
+        apiClient = new SodaxApiClient(config);
+    }
+    return apiClient;
+}
+export function resetSodaxApiClient() {
+    apiClient = null;
+}
+//# sourceMappingURL=sodaxApi.js.map

package/dist/utils/sodaxApi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sodaxApi.js","sourceRoot":"","sources":["../../src/utils/sodaxApi.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAErD,MAAM,gBAAgB,GAAG,8BAA8B,CAAC;AACxD,MAAM,WAAW,GAAG,IAAI,CAAC;AAwEzB,MAAM,OAAO,cAAc;IACjB,OAAO,CAAS;IAChB,MAAM,CAAU;IAChB,SAAS,CAAS;IAE1B,YAAY,SAAyB,EAAE;QACrC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,gBAAgB,CAAC;QAC/E,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;QACzD,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,KAAK,CAAC;IAC7C,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,eAAe,CAAC,UAAkB;QACtC,MAAM,cAAc,GAAG,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,UAAU,EAAE,CAAC;QACpF,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,IAAI,WAAW,cAAc,cAAc,EAAE,CAAC;QAEzE,OAAO,CAAC,GAAG,CAAC,qCAAqC,EAAE,EAAE,UAAU,EAAE,cAAc,EAAE,CAAC,CAAC;QAEnF,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;YAElD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;oBAC5B,OAAO,IAAI,CAAC;gBACd,CAAC;gBACD,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACxC,MAAM,IAAI,cAAc,CACtB,SAAS,CAAC,aAAa,EACvB,oBAAoB,QAAQ,CAAC,MAAM,IAAI,SAAS,EAAE,CACnD,CAAC;YACJ,CAAC;YAED,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAgB,CAAC;QAC7C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,cAAc;gBAAE,MAAM,KAAK,CAAC;YACjD,MAAM,IAAI,cAAc,CACtB,SAAS,CAAC,aAAa,EACvB,mCAAmC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAC5F,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,iBAAiB,CAAC,MAAc;QACpC,MAAM,cAAc,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC;QACxE,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,IAAI,WAAW,iBAAiB,cAAc,EAAE,CAAC;QAE5E,OAAO,CAAC,GAAG,CAAC,uCAAuC,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC;QAEjF,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;YAElD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;oBAC5B,OAAO,IAAI,CAAC;gBACd,CAAC;gBACD,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACxC,MAAM,IAAI,cAAc,CACtB,SAAS,CAAC,aAAa,EACvB,oBAAoB,QAAQ,CAAC,MAAM,IAAI,SAAS,EAAE,CACnD,CAAC;YACJ,CAAC;YAED,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAgB,CAAC;QAC7C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,cAAc;gBAAE,MAAM,KAAK,CAAC;YACjD,MAAM,IAAI,cAAc,CACtB,SAAS,CAAC,aAAa,EACvB,qCAAqC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAC9F,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,cAAc,CAClB,WAAmB,EACnB,aAA+B,EAAE,EACjC,OAA2B;QAE3B,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,CAAC;YACtC,MAAM,IAAI,cAAc,CACtB,SAAS,CAAC,sBAAsB,EAChC,yBAAyB,WAAW,EAAE,CACvC,CAAC;QACJ,CAAC;QAED,MAAM,iBAAiB,GAAG,WAAW,CAAC,WAAW,EAAE,CAAC;QACpD,MAAM,WAAW,GAAG,IAAI,eAAe,EAAE,CAAC;QAE1C,IAAI,UAAU,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACpC,WAAW,CAAC,GAAG,CAAC,QAAQ,EAAE,UAAU,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC1D,CAAC;QACD,IAAI,UAAU,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YACnC,WAAW,CAAC,GAAG,CAAC,OAAO,EAAE,UAAU,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QACxD,CAAC;QAED,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS;gBAAE,WAAW,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;YACjF,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS;gBAAE,WAAW,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC7F,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS;gBAAE,WAAW,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC7F,IAAI,OAAO,CAAC,UAAU;gBAAE,WAAW,CAAC,GAAG,CAAC,YAAY,EAAE,OAAO,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC;YACxF,IAAI,OAAO,CAAC,WAAW;gBAAE,WAAW,CAAC,GAAG,CAAC,aAAa,EAAE,OAAO,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,CAAC;QAC7F,CAAC;QAED,MAAM,WAAW,GAAG,WAAW,CAAC,QAAQ,EAAE,CAAC;QAC3C,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,IAAI,WAAW,mBAAmB,iBAAiB,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAExH,OAAO,CAAC,GAAG,CAAC,mCAAmC,EAAE,EAAE,WAAW,EAAE,iBAAiB,EAAE,CAAC,CAAC;QAErF,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;YAElD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACxC,MAAM,IAAI,cAAc,CACtB,SAAS,CAAC,aAAa,EACvB,oBAAoB,QAAQ,CAAC,MAAM,IAAI,SAAS,EAAE,CACnD,CAAC;YACJ,CAAC;YAED,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAmC,CAAC;QAChE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,cAAc;gBAAE,MAAM,KAAK,CAAC;YACjD,MAAM,IAAI,cAAc,CACtB,SAAS,CAAC,aAAa,EACvB,iCAAiC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAC1F,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,cAAc,CAClB,WAAmB,EACnB,aAA+B,EAAE;QAEjC,OAAO,IAAI,CAAC,cAAc,CAAC,WAAW,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACtE,CAAC;IAED,KAAK,CAAC,gBAAgB,CACpB,WAAmB,EACnB,aAA+B,EAAE;QAEjC,OAAO,IAAI,CAAC,cAAc,CAAC,WAAW,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACvE,CAAC;IAEO,KAAK,CAAC,gBAAgB,CAAC,GAAW;QACxC,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAEvE,IAAI,CAAC;YACH,MAAM,OAAO,GAA2B,EAAE,QAAQ,EAAE,kBAAkB,EAAE,CAAC;YACzE,IAAI,IAAI,CAAC,MAAM;gBAAE,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,IAAI,CAAC,MAAM,EAAE,CAAC;YACpE,OAAO,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;QAClE,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,SAAS,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAEO,cAAc,CAAC,OAAe;QACpC,OAAO,qBAAqB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC7C,CAAC;CACF;AAED,IAAI,SAAS,GAA0B,IAAI,CAAC;AAE5C,MAAM,UAAU,iBAAiB,CAAC,MAAuB;IACvD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,SAAS,GAAG,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,SAAS,GAAG,IAAI,CAAC;AACnB,CAAC"}

package/dist/utils/tokenResolver.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Token Resolution Utility
+ *
+ * Resolves token symbols to addresses using the SODAX SDK config service.
+ * Supports case-insensitive symbol lookup with caching.
+ * Handles both EVM (0x) and Solana (base58) address formats.
+ */
+import type { Token } from '@sodax/types';
+declare function isSolanaChain(chainId: string): boolean;
+/**
+ * Check if a string is a valid EVM address (0x format)
+ */
+declare function isEvmAddress(value: string): boolean;
+/**
+ * Check if a string is a valid Solana address (base58 format)
+ * Solana addresses are 32-44 characters, base58 encoded
+ */
+declare function isSolanaAddress(value: string): boolean;
+/**
+ * Check if a string is a valid token address (EVM or Solana)
+ */
+declare function isValidTokenAddress(value: string, chainId?: string): boolean;
+/**
+ * Resolve a token symbol or address to a normalized address
+ *
+ * @param chainId - The chain ID to resolve the token on
+ * @param tokenInput - Token symbol (e.g., "USDC") or address
+ * @returns The token address (lowercase for EVM, original case for Solana)
+ * @throws Error if token symbol is not found on the chain
+ */
+export declare function resolveToken(chainId: string, tokenInput: string): Promise<string>;
+/**
+ * Resolve multiple tokens at once (for efficiency)
+ *
+ * @param chainId - The chain ID
+ * @param tokenInputs - Array of token symbols or addresses
+ * @returns Array of resolved addresses
+ */
+export declare function resolveTokens(chainId: string, tokenInputs: string[]): Promise<string[]>;
+/**
+ * Get token info by symbol or address
+ * Returns null if not found
+ */
+export declare function getTokenInfo(chainId: string, tokenInput: string): Promise<Token | null>;
+/**
+ * Clear the token cache (useful for testing or after config refresh)
+ */
+export declare function clearTokenCache(): void;
+/**
+ * Get all cached tokens for a chain
+ */
+export declare function getCachedTokens(chainId: string): Token[] | undefined;
+export { isEvmAddress, isSolanaAddress, isValidTokenAddress, isSolanaChain };
+//# sourceMappingURL=tokenResolver.d.ts.map

package/dist/utils/tokenResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenResolver.d.ts","sourceRoot":"","sources":["../../src/utils/tokenResolver.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AA4D1C,iBAAS,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE/C;AAsBD;;GAEG;AACH,iBAAS,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE5C;AAED;;;GAGG;AACH,iBAAS,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAI/C;AAED;;GAEG;AACH,iBAAS,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAMrE;AAgDD;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC,CA2BjB;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EAAE,GACpB,OAAO,CAAC,MAAM,EAAE,CAAC,CAEnB;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAyCvB;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAEtC;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,EAAE,GAAG,SAAS,CAEpE;AAGD,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,mBAAmB,EAAE,aAAa,EAAE,CAAC"}

package/dist/utils/tokenResolver.js

@@ -0,0 +1,252 @@
+/**
+ * Token Resolution Utility
+ *
+ * Resolves token symbols to addresses using the SODAX SDK config service.
+ * Supports case-insensitive symbol lookup with caching.
+ * Handles both EVM (0x) and Solana (base58) address formats.
+ */
+import { getSodaxClient } from '../sodax/client';
+import { toSodaxChainId } from '../wallet/types';
+// Cache tokens per chain to avoid repeated lookups
+const tokenCache = new Map();
+// Native token addresses
+const EVM_NATIVE_ADDRESS = '0x0000000000000000000000000000000000000000';
+const SOLANA_NATIVE_ADDRESS = '11111111111111111111111111111111';
+// Native token configs per chain (18 decimals for all EVM chains, 9 for Solana)
+const NATIVE_TOKENS = {
+    sonic: { symbol: 'S', name: 'Sonic', decimals: 18, address: EVM_NATIVE_ADDRESS },
+    ethereum: { symbol: 'ETH', name: 'Ether', decimals: 18, address: EVM_NATIVE_ADDRESS },
+    '0xa4b1.arbitrum': { symbol: 'ETH', name: 'Ether', decimals: 18, address: EVM_NATIVE_ADDRESS },
+    '0x2105.base': { symbol: 'ETH', name: 'Ether', decimals: 18, address: EVM_NATIVE_ADDRESS },
+    '0xa.optimism': { symbol: 'ETH', name: 'Ether', decimals: 18, address: EVM_NATIVE_ADDRESS },
+    '0x38.bsc': { symbol: 'BNB', name: 'BNB', decimals: 18, address: EVM_NATIVE_ADDRESS },
+    '0x89.polygon': { symbol: 'POL', name: 'POL', decimals: 18, address: EVM_NATIVE_ADDRESS },
+    '0xa86a.avax': { symbol: 'AVAX', name: 'Avalanche', decimals: 18, address: EVM_NATIVE_ADDRESS },
+    hyper: { symbol: 'HYPE', name: 'Hyperliquid', decimals: 18, address: EVM_NATIVE_ADDRESS },
+    lightlink: { symbol: 'ETH', name: 'Ether', decimals: 18, address: EVM_NATIVE_ADDRESS },
+    solana: { symbol: 'SOL', name: 'Solana', decimals: 9, address: SOLANA_NATIVE_ADDRESS },
+};
+// Fallback token list for common chains when SDK config is unavailable
+const FALLBACK_TOKENS = {
+    '0x2105.base': [
+        { address: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', symbol: 'USDC', name: 'USD Coin', decimals: 6 },
+        { address: '0x4200000000000000000000000000000000000006', symbol: 'WETH', name: 'Wrapped Ether', decimals: 18 },
+        { address: EVM_NATIVE_ADDRESS, symbol: 'ETH', name: 'Ether', decimals: 18 },
+    ],
+    'ethereum': [
+        { address: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48', symbol: 'USDC', name: 'USD Coin', decimals: 6 },
+        { address: '0xdac17f958d2ee523a2206206994597c13d831ec7', symbol: 'USDT', name: 'Tether USD', decimals: 6 },
+        { address: '0x6B175474E89094C44Da98b954EedeAC495271d0F', symbol: 'DAI', name: 'Dai Stablecoin', decimals: 18 },
+        { address: '0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2', symbol: 'WETH', name: 'Wrapped Ether', decimals: 18 },
+        { address: EVM_NATIVE_ADDRESS, symbol: 'ETH', name: 'Ether', decimals: 18 },
+    ],
+    '0xa4b1.arbitrum': [
+        { address: '0xaf88d065e77c8cC2239327C5EDb3A432268e5831', symbol: 'USDC', name: 'USD Coin', decimals: 6 },
+        { address: '0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9', symbol: 'USDT', name: 'Tether USD', decimals: 6 },
+        { address: EVM_NATIVE_ADDRESS, symbol: 'ETH', name: 'Ether', decimals: 18 },
+    ],
+    'sonic': [
+        { address: '0x29219dd400f2Bf60E5a23d13Be72B486D4038894', symbol: 'USDC', name: 'USD Coin', decimals: 6 },
+        { address: '0x6047828dc181963ba44974801FF68e538dA5eaF9', symbol: 'USDT', name: 'Tether USD', decimals: 6 },
+        { address: EVM_NATIVE_ADDRESS, symbol: 'S', name: 'Sonic', decimals: 18 },
+    ],
+    'solana': [
+        { address: SOLANA_NATIVE_ADDRESS, symbol: 'SOL', name: 'Solana', decimals: 9 },
+        { address: '3rSPCLNEF7Quw4wX8S1NyKivELoyij8eYA2gJwBgt4V5', symbol: 'bnUSD', name: 'bnUSD', decimals: 9 },
+        { address: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v', symbol: 'USDC', name: 'USD Coin', decimals: 6 },
+    ],
+};
+// Chain type detection
+const SOLANA_CHAINS = new Set(['solana']);
+function isSolanaChain(chainId) {
+    return SOLANA_CHAINS.has(chainId.toLowerCase());
+}
+/**
+ * Check if an address is a native token for the given chain
+ */
+function isNativeToken(address, chainId) {
+    const addrLower = address.toLowerCase();
+    if (chainId && isSolanaChain(chainId)) {
+        return addrLower === SOLANA_NATIVE_ADDRESS.toLowerCase();
+    }
+    return addrLower === EVM_NATIVE_ADDRESS;
+}
+/**
+ * Get native token info for a chain
+ */
+function getNativeTokenInfo(chainId) {
+    const native = NATIVE_TOKENS[chainId];
+    if (!native)
+        return null;
+    return { ...native };
+}
+/**
+ * Check if a string is a valid EVM address (0x format)
+ */
+function isEvmAddress(value) {
+    return /^0x[a-fA-F0-9]{40}$/i.test(value);
+}
+/**
+ * Check if a string is a valid Solana address (base58 format)
+ * Solana addresses are 32-44 characters, base58 encoded
+ */
+function isSolanaAddress(value) {
+    // Base58 charset: 123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz
+    // Excludes: 0, O, I, l
+    return /^[1-9A-HJ-NP-Za-km-z]{32,44}$/.test(value);
+}
+/**
+ * Check if a string is a valid token address (EVM or Solana)
+ */
+function isValidTokenAddress(value, chainId) {
+    if (chainId && isSolanaChain(chainId)) {
+        return isSolanaAddress(value);
+    }
+    // For EVM chains or unknown chains, check both formats
+    return isEvmAddress(value) || isSolanaAddress(value);
+}
+/**
+ * Populate the token cache for a chain from SDK config service
+ * This is the canonical way to get tokens - used by both resolveToken and getTokenInfo
+ */
+function populateTokenCache(chainId) {
+    // Convert to SDK chain ID format (e.g., "base" -> "0x2105.base")
+    const sdkChainId = toSodaxChainId(chainId);
+    let tokens = tokenCache.get(chainId);
+    if (tokens)
+        return tokens;
+    try {
+        const client = getSodaxClient();
+        const configService = client.config;
+        if (configService?.getSupportedSwapTokensByChainId) {
+            // Preferred method - returns readonly Token[]
+            tokens = [...configService.getSupportedSwapTokensByChainId(sdkChainId)];
+        }
+        else if (configService?.getSwapTokensByChainId) {
+            tokens = configService.getSwapTokensByChainId(sdkChainId);
+        }
+        else if (configService?.getSwapTokens) {
+            const allTokens = configService.getSwapTokens();
+            tokens = allTokens[sdkChainId] || [];
+        }
+        else {
+            console.warn(`[tokenResolver] configService not available for chain ${chainId}`);
+            tokens = [];
+        }
+        // Log what we got from SDK
+        if (tokens && tokens.length > 0) {
+            console.log(`[tokenResolver] Loaded ${tokens.length} tokens from SDK for ${chainId}`);
+        }
+    }
+    catch (err) {
+        console.error(`[tokenResolver] Failed to fetch tokens for chain ${chainId}:`, err);
+        tokens = [];
+    }
+    // Use fallback tokens if SDK returned empty list
+    if ((!tokens || tokens.length === 0) && FALLBACK_TOKENS[chainId] || FALLBACK_TOKENS[sdkChainId]) {
+        console.log(`[tokenResolver] Using fallback token list for ${chainId}`);
+        tokens = FALLBACK_TOKENS[chainId] || FALLBACK_TOKENS[sdkChainId];
+    }
+    tokenCache.set(chainId, tokens || []);
+    return tokens || [];
+}
+/**
+ * Resolve a token symbol or address to a normalized address
+ *
+ * @param chainId - The chain ID to resolve the token on
+ * @param tokenInput - Token symbol (e.g., "USDC") or address
+ * @returns The token address (lowercase for EVM, original case for Solana)
+ * @throws Error if token symbol is not found on the chain
+ */
+export async function resolveToken(chainId, tokenInput) {
+    // If already a valid address, normalize and return
+    if (isValidTokenAddress(tokenInput, chainId)) {
+        // EVM addresses are lowercased, Solana addresses preserve case
+        return isEvmAddress(tokenInput) ? tokenInput.toLowerCase() : tokenInput;
+    }
+    // Get tokens from cache or SDK
+    const tokens = populateTokenCache(chainId);
+    // Find by symbol (case-insensitive)
+    const symbolUpper = tokenInput.toUpperCase();
+    const token = tokens.find(t => t.symbol.toUpperCase() === symbolUpper);
+    if (!token) {
+        // Build helpful error message with available tokens
+        const available = tokens.length > 0
+            ? tokens.map(t => t.symbol).join(', ')
+            : 'No tokens loaded';
+        throw new Error(`Unknown token "${tokenInput}" on chain ${chainId}. ` +
+            `Available: ${available}. ` +
+            `Alternatively, provide the token address directly.`);
+    }
+    return isEvmAddress(token.address) ? token.address.toLowerCase() : token.address;
+}
+/**
+ * Resolve multiple tokens at once (for efficiency)
+ *
+ * @param chainId - The chain ID
+ * @param tokenInputs - Array of token symbols or addresses
+ * @returns Array of resolved addresses
+ */
+export async function resolveTokens(chainId, tokenInputs) {
+    return Promise.all(tokenInputs.map(t => resolveToken(chainId, t)));
+}
+/**
+ * Get token info by symbol or address
+ * Returns null if not found
+ */
+export async function getTokenInfo(chainId, tokenInput) {
+    const sdkChainId = toSodaxChainId(chainId);
+    // Handle native tokens first
+    if (isValidTokenAddress(tokenInput, chainId) && isNativeToken(tokenInput, chainId)) {
+        const nativeInfo = getNativeTokenInfo(chainId);
+        if (nativeInfo) {
+            return nativeInfo;
+        }
+    }
+    // Get tokens from cache or SDK (same path as resolveToken)
+    const tokens = populateTokenCache(chainId);
+    // Find by address or symbol
+    if (isValidTokenAddress(tokenInput, chainId)) {
+        // Normalize address for comparison
+        const addrNorm = isEvmAddress(tokenInput) ? tokenInput.toLowerCase() : tokenInput;
+        const found = tokens.find(t => {
+            const tokenAddr = isEvmAddress(t.address) ? t.address.toLowerCase() : t.address;
+            return tokenAddr === addrNorm;
+        });
+        if (found) {
+            return found;
+        }
+        // Check fallback tokens even if SDK tokens were loaded
+        const fallback = FALLBACK_TOKENS[chainId] || FALLBACK_TOKENS[sdkChainId];
+        if (fallback) {
+            const fallbackToken = fallback.find(t => {
+                const tokenAddr = isEvmAddress(t.address) ? t.address.toLowerCase() : t.address;
+                return tokenAddr === addrNorm;
+            });
+            if (fallbackToken) {
+                console.log(`[tokenResolver] Found ${fallbackToken.symbol} in fallback for ${chainId}`);
+                return fallbackToken;
+            }
+        }
+        return null;
+    }
+    else {
+        const symbolUpper = tokenInput.toUpperCase();
+        return tokens.find(t => t.symbol.toUpperCase() === symbolUpper) || null;
+    }
+}
+/**
+ * Clear the token cache (useful for testing or after config refresh)
+ */
+export function clearTokenCache() {
+    tokenCache.clear();
+}
+/**
+ * Get all cached tokens for a chain
+ */
+export function getCachedTokens(chainId) {
+    return tokenCache.get(chainId);
+}
+// Export address validation utilities for use by other modules
+export { isEvmAddress, isSolanaAddress, isValidTokenAddress, isSolanaChain };
+//# sourceMappingURL=tokenResolver.js.map

package/dist/utils/tokenResolver.js.map

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

package/dist/wallet/backendConfig.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Wallet Backend Configuration
+ *
+ * Detects and configures the appropriate wallet backend based on
+ * environment variables or config file.
+ *
+ * Supported backends:
+ * - localKey (default): Uses evm-wallet-skill local private keys
+ * - bankr: Uses Bankr Agent API for transaction execution
+ */
+import type { WalletBackendType } from './providers';
+export interface BackendConfig {
+    backend: WalletBackendType;
+    bankrApiKey?: string;
+    bankrApiUrl?: string;
+}
+/**
+ * Get the resolved backend configuration
+ *
+ * Priority:
+ * 1. Environment variables
+ * 2. Config file
+ * 3. Defaults
+ */
+export declare function getBackendConfig(): BackendConfig;
+/**
+ * Check if Bankr backend is configured and available
+ */
+export declare function isBankrConfigured(): boolean;
+/**
+ * Get Bankr configuration if available
+ */
+export declare function getBankrConfig(): {
+    apiKey: string;
+    apiUrl: string;
+} | null;
+//# sourceMappingURL=backendConfig.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"backendConfig.d.ts","sourceRoot":"","sources":["../../src/wallet/backendConfig.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,iBAAiB,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAuED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,CA2BhD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAG3C;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAW1E"}

package/dist/wallet/backendConfig.js

@@ -0,0 +1,125 @@
+/**
+ * Wallet Backend Configuration
+ *
+ * Detects and configures the appropriate wallet backend based on
+ * environment variables or config file.
+ *
+ * Supported backends:
+ * - localKey (default): Uses evm-wallet-skill local private keys
+ * - bankr: Uses Bankr Agent API for transaction execution
+ */
+import { existsSync, readFileSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+/**
+ * Default configuration
+ */
+const DEFAULT_CONFIG = {
+    backend: 'localKey',
+};
+/**
+ * Path to plugin config file
+ */
+function getConfigPath() {
+    return join(homedir(), '.openclaw', 'extensions', 'amped-defi', 'config.json');
+}
+/**
+ * Load configuration from file
+ */
+function loadConfigFile() {
+    const configPath = getConfigPath();
+    if (!existsSync(configPath)) {
+        return null;
+    }
+    try {
+        const content = readFileSync(configPath, 'utf-8');
+        const config = JSON.parse(content);
+        return {
+            backend: config.walletBackend,
+            bankrApiKey: config.bankrApiKey,
+            bankrApiUrl: config.bankrApiUrl,
+        };
+    }
+    catch (error) {
+        console.warn('[backendConfig] Failed to load config file:', error);
+        return null;
+    }
+}
+/**
+ * Load configuration from environment variables
+ */
+function loadEnvConfig() {
+    const config = {};
+    // Check for explicit backend selection
+    const backendEnv = process.env.AMPED_OC_WALLET_BACKEND;
+    if (backendEnv === 'bankr' || backendEnv === 'localKey') {
+        config.backend = backendEnv;
+    }
+    // Check for Bankr API key (implies bankr backend)
+    const bankrApiKey = process.env.BANKR_API_KEY;
+    if (bankrApiKey) {
+        config.bankrApiKey = bankrApiKey;
+        // Auto-select bankr backend if API key is present
+        if (!config.backend) {
+            config.backend = 'bankr';
+        }
+    }
+    // Optional Bankr API URL override
+    const bankrApiUrl = process.env.BANKR_API_URL;
+    if (bankrApiUrl) {
+        config.bankrApiUrl = bankrApiUrl;
+    }
+    return config;
+}
+/**
+ * Get the resolved backend configuration
+ *
+ * Priority:
+ * 1. Environment variables
+ * 2. Config file
+ * 3. Defaults
+ */
+export function getBackendConfig() {
+    const fileConfig = loadConfigFile() || {};
+    const envConfig = loadEnvConfig();
+    // Merge with priority: env > file > default
+    const config = {
+        ...DEFAULT_CONFIG,
+        ...fileConfig,
+        ...envConfig,
+    };
+    // Validate bankr configuration
+    if (config.backend === 'bankr' && !config.bankrApiKey) {
+        console.warn('[backendConfig] Bankr backend selected but no API key provided');
+        console.warn('[backendConfig] Set BANKR_API_KEY environment variable or add bankrApiKey to config.json');
+        console.warn('[backendConfig] Falling back to localKey backend');
+        config.backend = 'localKey';
+    }
+    // Set default Bankr API URL if not specified
+    if (config.backend === 'bankr' && !config.bankrApiUrl) {
+        config.bankrApiUrl = 'https://api.bankr.bot';
+    }
+    console.log(`[backendConfig] Using wallet backend: ${config.backend}`);
+    return config;
+}
+/**
+ * Check if Bankr backend is configured and available
+ */
+export function isBankrConfigured() {
+    const config = getBackendConfig();
+    return config.backend === 'bankr' && !!config.bankrApiKey;
+}
+/**
+ * Get Bankr configuration if available
+ */
+export function getBankrConfig() {
+    const config = getBackendConfig();
+    if (config.backend !== 'bankr' || !config.bankrApiKey) {
+        return null;
+    }
+    return {
+        apiKey: config.bankrApiKey,
+        apiUrl: config.bankrApiUrl || 'https://api.bankr.bot',
+    };
+}
+//# sourceMappingURL=backendConfig.js.map

package/dist/wallet/backendConfig.js.map

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