amped-defi 1.0.0

package/dist/utils/errorUtils.d.ts

@@ -0,0 +1,2 @@
+export declare function serializeError(error: unknown): string;
+//# sourceMappingURL=errorUtils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errorUtils.d.ts","sourceRoot":"","sources":["../../src/utils/errorUtils.ts"],"names":[],"mappings":"AAOA,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAQrD"}

package/dist/utils/errorUtils.js

@@ -0,0 +1,19 @@
+/**
+ * Serialize SDK error objects for readable error messages
+ */
+function bigintReplacer(key, value) {
+    return typeof value === 'bigint' ? value.toString() : value;
+}
+export function serializeError(error) {
+    if (error instanceof Error)
+        return error.message;
+    if (typeof error === 'string')
+        return error;
+    try {
+        return JSON.stringify(error, bigintReplacer, 2);
+    }
+    catch {
+        return String(error);
+    }
+}
+//# sourceMappingURL=errorUtils.js.map

package/dist/utils/errorUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorUtils.js","sourceRoot":"","sources":["../../src/utils/errorUtils.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,SAAS,cAAc,CAAC,GAAW,EAAE,KAAU;IAC7C,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,KAAK,YAAY,KAAK;QAAE,OAAO,KAAK,CAAC,OAAO,CAAC;IACjD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC;IAClD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/utils/errors.d.ts

@@ -0,0 +1,144 @@
+/**
+ * Error Handling Utilities
+ *
+ * Provides standardized error handling, error codes, and user-friendly error messages
+ * for all Amped DeFi operations.
+ */
+/**
+ * Standard error codes for Amped DeFi operations
+ */
+export declare enum ErrorCode {
+    POLICY_SLIPPAGE_EXCEEDED = "POLICY_SLIPPAGE_EXCEEDED",
+    POLICY_SPEND_LIMIT_EXCEEDED = "POLICY_SPEND_LIMIT_EXCEEDED",
+    POLICY_CHAIN_NOT_ALLOWED = "POLICY_CHAIN_NOT_ALLOWED",
+    POLICY_TOKEN_NOT_ALLOWED = "POLICY_TOKEN_NOT_ALLOWED",
+    POLICY_RECIPIENT_BLOCKED = "POLICY_RECIPIENT_BLOCKED",
+    WALLET_NOT_FOUND = "WALLET_NOT_FOUND",
+    WALLET_INVALID_ADDRESS = "WALLET_INVALID_ADDRESS",
+    WALLET_MISSING_PRIVATE_KEY = "WALLET_MISSING_PRIVATE_KEY",
+    WALLET_RESOLUTION_FAILED = "WALLET_RESOLUTION_FAILED",
+    CHAIN_NOT_SUPPORTED = "CHAIN_NOT_SUPPORTED",
+    RPC_URL_NOT_CONFIGURED = "RPC_URL_NOT_CONFIGURED",
+    PROVIDER_CREATION_FAILED = "PROVIDER_CREATION_FAILED",
+    SONIC_PROVIDER_REQUIRED = "SONIC_PROVIDER_REQUIRED",
+    INSUFFICIENT_BALANCE = "INSUFFICIENT_BALANCE",
+    INSUFFICIENT_ALLOWANCE = "INSUFFICIENT_ALLOWANCE",
+    TOKEN_NOT_SUPPORTED = "TOKEN_NOT_SUPPORTED",
+    TOKEN_DECIMALS_NOT_FOUND = "TOKEN_DECIMALS_NOT_FOUND",
+    QUOTE_EXPIRED = "QUOTE_EXPIRED",
+    QUOTE_NOT_FOUND = "QUOTE_NOT_FOUND",
+    BRIDGE_NOT_AVAILABLE = "BRIDGE_NOT_AVAILABLE",
+    SWAP_EXECUTION_FAILED = "SWAP_EXECUTION_FAILED",
+    BRIDGE_EXECUTION_FAILED = "BRIDGE_EXECUTION_FAILED",
+    MM_HEALTH_FACTOR_LOW = "MM_HEALTH_FACTOR_LOW",
+    MM_CROSS_CHAIN_NOT_SUPPORTED = "MM_CROSS_CHAIN_NOT_SUPPORTED",
+    MM_INSUFFICIENT_COLLATERAL = "MM_INSUFFICIENT_COLLATERAL",
+    MM_POSITION_NOT_FOUND = "MM_POSITION_NOT_FOUND",
+    TRANSACTION_FAILED = "TRANSACTION_FAILED",
+    TRANSACTION_TIMEOUT = "TRANSACTION_TIMEOUT",
+    TRANSACTION_REJECTED = "TRANSACTION_REJECTED",
+    TRANSACTION_SIMULATION_FAILED = "TRANSACTION_SIMULATION_FAILED",
+    SDK_NOT_INITIALIZED = "SDK_NOT_INITIALIZED",
+    SDK_INITIALIZATION_FAILED = "SDK_INITIALIZATION_FAILED",
+    INVALID_CONFIGURATION = "INVALID_CONFIGURATION",
+    CONFIG_PARSE_ERROR = "CONFIG_PARSE_ERROR",
+    UNKNOWN_ERROR = "UNKNOWN_ERROR",
+    OPERATION_CANCELLED = "OPERATION_CANCELLED"
+}
+/**
+ * Error severity levels
+ */
+export declare enum ErrorSeverity {
+    INFO = "info",
+    WARNING = "warning",
+    ERROR = "error",
+    CRITICAL = "critical"
+}
+/**
+ * Structured error information
+ */
+export interface AmpedError {
+    code: ErrorCode;
+    message: string;
+    severity: ErrorSeverity;
+    remediation?: string;
+    details?: Record<string, unknown>;
+    cause?: Error;
+}
+/**
+ * Error context for logging
+ */
+export interface ErrorContext {
+    operation?: string;
+    walletId?: string;
+    chainId?: string;
+    chainIds?: string[];
+    token?: string;
+    tokens?: string[];
+    amount?: string;
+    requestId?: string;
+    txHash?: string;
+    [key: string]: unknown;
+}
+/**
+ * Amped DeFi Error class
+ */
+export declare class AmpedDefiError extends Error {
+    readonly code: ErrorCode;
+    readonly severity: ErrorSeverity;
+    readonly remediation?: string;
+    readonly details?: Record<string, unknown>;
+    readonly context?: ErrorContext;
+    constructor(code: ErrorCode, message: string, options?: {
+        severity?: ErrorSeverity;
+        remediation?: string;
+        details?: Record<string, unknown>;
+        context?: ErrorContext;
+        cause?: Error;
+    });
+    /**
+     * Convert to JSON-serializable object
+     */
+    toJSON(): AmpedError;
+    /**
+     * Get user-friendly error message
+     */
+    toUserMessage(): string;
+}
+/**
+ * Create a policy error
+ */
+export declare function createPolicyError(code: ErrorCode, message: string, details?: {
+    current?: unknown;
+    limit?: unknown;
+    [key: string]: unknown;
+}, context?: ErrorContext): AmpedDefiError;
+/**
+ * Create a wallet error
+ */
+export declare function createWalletError(code: ErrorCode, walletId: string, cause?: Error, context?: ErrorContext): AmpedDefiError;
+/**
+ * Create a transaction error
+ */
+export declare function createTransactionError(code: ErrorCode, message: string, txHash?: string, cause?: Error, context?: ErrorContext): AmpedDefiError;
+/**
+ * Create an SDK error
+ */
+export declare function createSDKError(code: ErrorCode, message: string, cause?: Error, context?: ErrorContext): AmpedDefiError;
+/**
+ * Wrap an unknown error into an AmpedDefiError
+ */
+export declare function wrapError(error: unknown, fallbackCode?: ErrorCode, context?: ErrorContext): AmpedDefiError;
+/**
+ * Log an error with structured context
+ */
+export declare function logError(error: AmpedDefiError | Error, context?: ErrorContext): void;
+/**
+ * Check if an error is retryable
+ */
+export declare function isRetryableError(error: AmpedDefiError | Error): boolean;
+/**
+ * Get retry delay in milliseconds with exponential backoff
+ */
+export declare function getRetryDelay(attempt: number, baseDelay?: number): number;
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,oBAAY,SAAS;IAEnB,wBAAwB,6BAA6B;IACrD,2BAA2B,gCAAgC;IAC3D,wBAAwB,6BAA6B;IACrD,wBAAwB,6BAA6B;IACrD,wBAAwB,6BAA6B;IAGrD,gBAAgB,qBAAqB;IACrC,sBAAsB,2BAA2B;IACjD,0BAA0B,+BAA+B;IACzD,wBAAwB,6BAA6B;IAGrD,mBAAmB,wBAAwB;IAC3C,sBAAsB,2BAA2B;IACjD,wBAAwB,6BAA6B;IACrD,uBAAuB,4BAA4B;IAGnD,oBAAoB,yBAAyB;IAC7C,sBAAsB,2BAA2B;IACjD,mBAAmB,wBAAwB;IAC3C,wBAAwB,6BAA6B;IAGrD,aAAa,kBAAkB;IAC/B,eAAe,oBAAoB;IACnC,oBAAoB,yBAAyB;IAC7C,qBAAqB,0BAA0B;IAC/C,uBAAuB,4BAA4B;IACnD,oBAAoB,yBAAyB;IAC7C,4BAA4B,iCAAiC;IAC7D,0BAA0B,+BAA+B;IACzD,qBAAqB,0BAA0B;IAG/C,kBAAkB,uBAAuB;IACzC,mBAAmB,wBAAwB;IAC3C,oBAAoB,yBAAyB;IAC7C,6BAA6B,kCAAkC;IAG/D,mBAAmB,wBAAwB;IAC3C,yBAAyB,8BAA8B;IACvD,qBAAqB,0BAA0B;IAC/C,kBAAkB,uBAAuB;IAGzC,aAAa,kBAAkB;IAC/B,mBAAmB,wBAAwB;CAC5C;AAED;;GAEG;AACH,oBAAY,aAAa;IACvB,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,KAAK,UAAU;IACf,QAAQ,aAAa;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,aAAa,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACvC,SAAgB,IAAI,EAAE,SAAS,CAAC;IAChC,SAAgB,QAAQ,EAAE,aAAa,CAAC;IACxC,SAAgB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrC,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClD,SAAgB,OAAO,CAAC,EAAE,YAAY,CAAC;gBAGrC,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,EAAE,aAAa,CAAC;QACzB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClC,OAAO,CAAC,EAAE,YAAY,CAAC;QACvB,KAAK,CAAC,EAAE,KAAK,CAAC;KACf;IAgBH;;OAEG;IACH,MAAM,IAAI,UAAU;IAUpB;;OAEG;IACH,aAAa,IAAI,MAAM;CAOxB;AAMD;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,EACxE,OAAO,CAAC,EAAE,YAAY,GACrB,cAAc,CAQhB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,KAAK,EACb,OAAO,CAAC,EAAE,YAAY,GACrB,cAAc,CAQhB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,KAAK,EACb,OAAO,CAAC,EAAE,YAAY,GACrB,cAAc,CAQhB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,KAAK,EACb,OAAO,CAAC,EAAE,YAAY,GACrB,cAAc,CAOhB;AAED;;GAEG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,OAAO,EACd,YAAY,GAAE,SAAmC,EACjD,OAAO,CAAC,EAAE,YAAY,GACrB,cAAc,CAmBhB;AAqFD;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,cAAc,GAAG,KAAK,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI,CAcpF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,cAAc,GAAG,KAAK,GAAG,OAAO,CAiBvE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,SAAO,GAAG,MAAM,CAEvE"}

package/dist/utils/errors.js

@@ -0,0 +1,310 @@
+/**
+ * Error Handling Utilities
+ *
+ * Provides standardized error handling, error codes, and user-friendly error messages
+ * for all Amped DeFi operations.
+ */
+/**
+ * Standard error codes for Amped DeFi operations
+ */
+export var ErrorCode;
+(function (ErrorCode) {
+    // Policy errors
+    ErrorCode["POLICY_SLIPPAGE_EXCEEDED"] = "POLICY_SLIPPAGE_EXCEEDED";
+    ErrorCode["POLICY_SPEND_LIMIT_EXCEEDED"] = "POLICY_SPEND_LIMIT_EXCEEDED";
+    ErrorCode["POLICY_CHAIN_NOT_ALLOWED"] = "POLICY_CHAIN_NOT_ALLOWED";
+    ErrorCode["POLICY_TOKEN_NOT_ALLOWED"] = "POLICY_TOKEN_NOT_ALLOWED";
+    ErrorCode["POLICY_RECIPIENT_BLOCKED"] = "POLICY_RECIPIENT_BLOCKED";
+    // Wallet errors
+    ErrorCode["WALLET_NOT_FOUND"] = "WALLET_NOT_FOUND";
+    ErrorCode["WALLET_INVALID_ADDRESS"] = "WALLET_INVALID_ADDRESS";
+    ErrorCode["WALLET_MISSING_PRIVATE_KEY"] = "WALLET_MISSING_PRIVATE_KEY";
+    ErrorCode["WALLET_RESOLUTION_FAILED"] = "WALLET_RESOLUTION_FAILED";
+    // Chain/Provider errors
+    ErrorCode["CHAIN_NOT_SUPPORTED"] = "CHAIN_NOT_SUPPORTED";
+    ErrorCode["RPC_URL_NOT_CONFIGURED"] = "RPC_URL_NOT_CONFIGURED";
+    ErrorCode["PROVIDER_CREATION_FAILED"] = "PROVIDER_CREATION_FAILED";
+    ErrorCode["SONIC_PROVIDER_REQUIRED"] = "SONIC_PROVIDER_REQUIRED";
+    // Token errors
+    ErrorCode["INSUFFICIENT_BALANCE"] = "INSUFFICIENT_BALANCE";
+    ErrorCode["INSUFFICIENT_ALLOWANCE"] = "INSUFFICIENT_ALLOWANCE";
+    ErrorCode["TOKEN_NOT_SUPPORTED"] = "TOKEN_NOT_SUPPORTED";
+    ErrorCode["TOKEN_DECIMALS_NOT_FOUND"] = "TOKEN_DECIMALS_NOT_FOUND";
+    // Operation errors
+    ErrorCode["QUOTE_EXPIRED"] = "QUOTE_EXPIRED";
+    ErrorCode["QUOTE_NOT_FOUND"] = "QUOTE_NOT_FOUND";
+    ErrorCode["BRIDGE_NOT_AVAILABLE"] = "BRIDGE_NOT_AVAILABLE";
+    ErrorCode["SWAP_EXECUTION_FAILED"] = "SWAP_EXECUTION_FAILED";
+    ErrorCode["BRIDGE_EXECUTION_FAILED"] = "BRIDGE_EXECUTION_FAILED";
+    ErrorCode["MM_HEALTH_FACTOR_LOW"] = "MM_HEALTH_FACTOR_LOW";
+    ErrorCode["MM_CROSS_CHAIN_NOT_SUPPORTED"] = "MM_CROSS_CHAIN_NOT_SUPPORTED";
+    ErrorCode["MM_INSUFFICIENT_COLLATERAL"] = "MM_INSUFFICIENT_COLLATERAL";
+    ErrorCode["MM_POSITION_NOT_FOUND"] = "MM_POSITION_NOT_FOUND";
+    // Transaction errors
+    ErrorCode["TRANSACTION_FAILED"] = "TRANSACTION_FAILED";
+    ErrorCode["TRANSACTION_TIMEOUT"] = "TRANSACTION_TIMEOUT";
+    ErrorCode["TRANSACTION_REJECTED"] = "TRANSACTION_REJECTED";
+    ErrorCode["TRANSACTION_SIMULATION_FAILED"] = "TRANSACTION_SIMULATION_FAILED";
+    // SDK/Configuration errors
+    ErrorCode["SDK_NOT_INITIALIZED"] = "SDK_NOT_INITIALIZED";
+    ErrorCode["SDK_INITIALIZATION_FAILED"] = "SDK_INITIALIZATION_FAILED";
+    ErrorCode["INVALID_CONFIGURATION"] = "INVALID_CONFIGURATION";
+    ErrorCode["CONFIG_PARSE_ERROR"] = "CONFIG_PARSE_ERROR";
+    // Unknown/Generic
+    ErrorCode["UNKNOWN_ERROR"] = "UNKNOWN_ERROR";
+    ErrorCode["OPERATION_CANCELLED"] = "OPERATION_CANCELLED";
+})(ErrorCode || (ErrorCode = {}));
+/**
+ * Error severity levels
+ */
+export var ErrorSeverity;
+(function (ErrorSeverity) {
+    ErrorSeverity["INFO"] = "info";
+    ErrorSeverity["WARNING"] = "warning";
+    ErrorSeverity["ERROR"] = "error";
+    ErrorSeverity["CRITICAL"] = "critical";
+})(ErrorSeverity || (ErrorSeverity = {}));
+/**
+ * Amped DeFi Error class
+ */
+export class AmpedDefiError extends Error {
+    code;
+    severity;
+    remediation;
+    details;
+    context;
+    constructor(code, message, options) {
+        super(message, { cause: options?.cause });
+        this.name = 'AmpedDefiError';
+        this.code = code;
+        this.severity = options?.severity || ErrorSeverity.ERROR;
+        this.remediation = options?.remediation;
+        this.details = options?.details;
+        this.context = options?.context;
+        // Maintains proper stack trace for where our error was thrown (only available on V8)
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, AmpedDefiError);
+        }
+    }
+    /**
+     * Convert to JSON-serializable object
+     */
+    toJSON() {
+        return {
+            code: this.code,
+            message: this.message,
+            severity: this.severity,
+            remediation: this.remediation,
+            details: this.details,
+        };
+    }
+    /**
+     * Get user-friendly error message
+     */
+    toUserMessage() {
+        let msg = `[${this.code}] ${this.message}`;
+        if (this.remediation) {
+            msg += `\n\nSuggestion: ${this.remediation}`;
+        }
+        return msg;
+    }
+}
+// ============================================================================
+// Error Factory Functions
+// ============================================================================
+/**
+ * Create a policy error
+ */
+export function createPolicyError(code, message, details, context) {
+    const remediation = getPolicyRemediation(code, details);
+    return new AmpedDefiError(code, message, {
+        severity: ErrorSeverity.WARNING,
+        remediation,
+        details,
+        context,
+    });
+}
+/**
+ * Create a wallet error
+ */
+export function createWalletError(code, walletId, cause, context) {
+    const message = getWalletErrorMessage(code, walletId);
+    return new AmpedDefiError(code, message, {
+        severity: ErrorSeverity.ERROR,
+        remediation: getWalletRemediation(code),
+        context: { ...context, walletId },
+        cause,
+    });
+}
+/**
+ * Create a transaction error
+ */
+export function createTransactionError(code, message, txHash, cause, context) {
+    return new AmpedDefiError(code, message, {
+        severity: ErrorSeverity.ERROR,
+        remediation: getTransactionRemediation(code),
+        details: txHash ? { txHash } : undefined,
+        context: txHash ? { ...context, txHash } : context,
+        cause,
+    });
+}
+/**
+ * Create an SDK error
+ */
+export function createSDKError(code, message, cause, context) {
+    return new AmpedDefiError(code, message, {
+        severity: ErrorSeverity.CRITICAL,
+        remediation: 'Please check your configuration and try again. If the issue persists, contact support.',
+        context,
+        cause,
+    });
+}
+/**
+ * Wrap an unknown error into an AmpedDefiError
+ */
+export function wrapError(error, fallbackCode = ErrorCode.UNKNOWN_ERROR, context) {
+    if (error instanceof AmpedDefiError) {
+        return error;
+    }
+    if (error instanceof Error) {
+        // Try to infer error code from message
+        const code = inferErrorCode(error.message) || fallbackCode;
+        return new AmpedDefiError(code, error.message, {
+            severity: ErrorSeverity.ERROR,
+            context,
+            cause: error,
+        });
+    }
+    return new AmpedDefiError(fallbackCode, String(error), {
+        severity: ErrorSeverity.ERROR,
+        context,
+    });
+}
+// ============================================================================
+// Remediation Helpers
+// ============================================================================
+function getPolicyRemediation(code, details) {
+    switch (code) {
+        case ErrorCode.POLICY_SLIPPAGE_EXCEEDED:
+            return `Slippage ${details?.current} bps exceeds limit of ${details?.limit} bps. Increase maxSlippageBps in your policy configuration or wait for better market conditions.`;
+        case ErrorCode.POLICY_SPEND_LIMIT_EXCEEDED:
+            return `Reduce the operation amount or request a policy limit increase. Current limit: ${details?.limit}`;
+        case ErrorCode.POLICY_CHAIN_NOT_ALLOWED:
+            return `Add the chain to your allowedChains policy configuration or use a different chain.`;
+        case ErrorCode.POLICY_TOKEN_NOT_ALLOWED:
+            return `Add the token to your allowedTokensByChain policy configuration or use a different token.`;
+        case ErrorCode.POLICY_RECIPIENT_BLOCKED:
+            return `Use a different recipient address. This address has been blocked by policy.`;
+        default:
+            return 'Review your policy configuration or contact your administrator.';
+    }
+}
+function getWalletRemediation(code) {
+    switch (code) {
+        case ErrorCode.WALLET_NOT_FOUND:
+            return 'Check your AMPED_OC_WALLETS_JSON configuration and ensure the walletId is correct.';
+        case ErrorCode.WALLET_INVALID_ADDRESS:
+            return 'Verify the wallet address format (should be 0x-prefixed Ethereum address).';
+        case ErrorCode.WALLET_MISSING_PRIVATE_KEY:
+            return 'Add the private key to your wallet configuration for execute mode, or switch to prepare mode.';
+        default:
+            return 'Check your wallet configuration and try again.';
+    }
+}
+function getTransactionRemediation(code) {
+    switch (code) {
+        case ErrorCode.TRANSACTION_FAILED:
+            return 'Check the transaction on a block explorer for revert reasons. You may need to adjust parameters or try again later.';
+        case ErrorCode.TRANSACTION_TIMEOUT:
+            return 'The operation timed out. You can check the status later using the transaction hash.';
+        case ErrorCode.TRANSACTION_REJECTED:
+            return 'The transaction was rejected. This may be due to network congestion or insufficient gas.';
+        case ErrorCode.TRANSACTION_SIMULATION_FAILED:
+            return 'The transaction would fail if executed. Check your balances, allowances, and parameters.';
+        default:
+            return 'Try again or contact support if the issue persists.';
+    }
+}
+function getWalletErrorMessage(code, walletId) {
+    switch (code) {
+        case ErrorCode.WALLET_NOT_FOUND:
+            return `Wallet not found: ${walletId}`;
+        case ErrorCode.WALLET_INVALID_ADDRESS:
+            return `Wallet ${walletId} has an invalid address`;
+        case ErrorCode.WALLET_MISSING_PRIVATE_KEY:
+            return `Wallet ${walletId} is missing private key (required in execute mode)`;
+        default:
+            return `Wallet error for ${walletId}`;
+    }
+}
+function inferErrorCode(message) {
+    const lowerMsg = message.toLowerCase();
+    if (lowerMsg.includes('insufficient balance'))
+        return ErrorCode.INSUFFICIENT_BALANCE;
+    if (lowerMsg.includes('allowance'))
+        return ErrorCode.INSUFFICIENT_ALLOWANCE;
+    if (lowerMsg.includes('slippage'))
+        return ErrorCode.POLICY_SLIPPAGE_EXCEEDED;
+    if (lowerMsg.includes('health factor'))
+        return ErrorCode.MM_HEALTH_FACTOR_LOW;
+    if (lowerMsg.includes('timeout'))
+        return ErrorCode.TRANSACTION_TIMEOUT;
+    if (lowerMsg.includes('rejected'))
+        return ErrorCode.TRANSACTION_REJECTED;
+    if (lowerMsg.includes('simulation'))
+        return ErrorCode.TRANSACTION_SIMULATION_FAILED;
+    if (lowerMsg.includes('not initialized'))
+        return ErrorCode.SDK_NOT_INITIALIZED;
+    if (lowerMsg.includes('bridge') && lowerMsg.includes('not'))
+        return ErrorCode.BRIDGE_NOT_AVAILABLE;
+    if (lowerMsg.includes('quote') && lowerMsg.includes('expir'))
+        return ErrorCode.QUOTE_EXPIRED;
+    return null;
+}
+// ============================================================================
+// Logging and Observability
+// ============================================================================
+/**
+ * Log an error with structured context
+ */
+export function logError(error, context) {
+    const structuredLog = {
+        timestamp: new Date().toISOString(),
+        component: 'amped-defi',
+        level: error instanceof AmpedDefiError ? error.severity : 'error',
+        code: error instanceof AmpedDefiError ? error.code : ErrorCode.UNKNOWN_ERROR,
+        message: error.message,
+        context,
+        stack: error.stack,
+        cause: error.cause,
+    };
+    // Log as JSON for structured logging systems
+    console.error(JSON.stringify(structuredLog, (k, v) => typeof v === 'bigint' ? v.toString() : v));
+}
+/**
+ * Check if an error is retryable
+ */
+export function isRetryableError(error) {
+    if (error instanceof AmpedDefiError) {
+        const retryableCodes = [
+            ErrorCode.TRANSACTION_TIMEOUT,
+            ErrorCode.RPC_URL_NOT_CONFIGURED,
+            ErrorCode.SDK_NOT_INITIALIZED,
+            ErrorCode.UNKNOWN_ERROR,
+        ];
+        return retryableCodes.includes(error.code);
+    }
+    // For generic errors, check message patterns
+    const lowerMsg = error.message.toLowerCase();
+    return lowerMsg.includes('timeout') ||
+        lowerMsg.includes('network') ||
+        lowerMsg.includes('connection') ||
+        lowerMsg.includes('rate limit');
+}
+/**
+ * Get retry delay in milliseconds with exponential backoff
+ */
+export function getRetryDelay(attempt, baseDelay = 1000) {
+    return Math.min(baseDelay * Math.pow(2, attempt), 30000); // Cap at 30 seconds
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

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

package/dist/utils/positionAggregator.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Cross-Chain Money Market Position Aggregator
+ *
+ * Aggregates user positions across all supported chains to provide a unified view
+ * of their money market portfolio, including:
+ * - Total supplied/borrowed across all chains
+ * - Health factor and liquidation risk
+ * - Available borrowing power
+ * - Net position (supply - borrow)
+ * - Cross-chain collateral utilization
+ */
+/**
+ * Position data for a single token on a single chain
+ */
+export interface TokenPosition {
+    chainId: string;
+    token: {
+        address: string;
+        symbol: string;
+        name: string;
+        decimals: number;
+        logoURI?: string;
+    };
+    supply: {
+        balance: string;
+        balanceUsd: string;
+        balanceRaw: string;
+        apy: number;
+        isCollateral: boolean;
+    };
+    borrow: {
+        balance: string;
+        balanceUsd: string;
+        balanceRaw: string;
+        apy: number;
+    };
+    loanToValue: number;
+    liquidationThreshold: number;
+}
+/**
+ * Aggregated position summary across all chains
+ */
+export interface AggregatedPositionSummary {
+    totalSupplyUsd: number;
+    totalBorrowUsd: number;
+    netWorthUsd: number;
+    availableBorrowUsd: number;
+    healthFactor: number | null;
+    liquidationRisk: 'none' | 'low' | 'medium' | 'high';
+    weightedSupplyApy: number;
+    weightedBorrowApy: number;
+    netApy: number;
+}
+/**
+ * Chain-specific position summary
+ */
+export interface ChainPositionSummary {
+    chainId: string;
+    supplyUsd: number;
+    borrowUsd: number;
+    netWorthUsd: number;
+    healthFactor: number | null;
+    positionCount: number;
+}
+/**
+ * Complete cross-chain position view
+ */
+export interface CrossChainPositionView {
+    walletId: string;
+    address: string;
+    timestamp: string;
+    summary: AggregatedPositionSummary;
+    chainSummaries: ChainPositionSummary[];
+    positions: TokenPosition[];
+    collateralUtilization: {
+        totalCollateralUsd: number;
+        usedCollateralUsd: number;
+        availableCollateralUsd: number;
+        utilizationRate: number;
+    };
+    riskMetrics: {
+        maxLtv: number;
+        currentLtv: number;
+        bufferUntilLiquidation: number;
+        safeMaxBorrowUsd: number;
+    };
+}
+/**
+ * Options for position aggregation
+ */
+export interface AggregationOptions {
+    /** Specific chains to query (defaults to all supported chains) */
+    chainIds?: string[];
+    /** Include zero-balance positions */
+    includeZeroBalances?: boolean;
+    /** Minimum USD value to include (positions below this are filtered out unless includeZeroBalances is true) */
+    minUsdValue?: number;
+}
+/**
+ * Aggregate money market positions across all supported chains
+ *
+ * @param walletId - The wallet identifier
+ * @param options - Aggregation options
+ * @returns Complete cross-chain position view
+ */
+export declare function aggregateCrossChainPositions(walletId: string, options?: AggregationOptions): Promise<CrossChainPositionView>;
+/**
+ * Format health factor for display
+ */
+export declare function formatHealthFactor(hf: number | null): string;
+/**
+ * Get health factor color/styling indicator
+ */
+export declare function getHealthFactorStatus(hf: number | null): {
+    status: 'healthy' | 'caution' | 'danger' | 'critical';
+    color: 'green' | 'yellow' | 'orange' | 'red';
+};
+/**
+ * Get recommendation based on position health
+ */
+export declare function getPositionRecommendation(view: CrossChainPositionView): string[];
+//# sourceMappingURL=positionAggregator.d.ts.map

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

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