@megatao/sdk 1.1.0

package/dist/types/margin.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Margin-related type definitions
+ */
+import { Address } from 'viem';
+export interface MarginAccount {
+    balance: bigint;
+    lockedMargin: bigint;
+    availableBalance: bigint;
+    totalPositions: number;
+}
+export interface MarginRequirement {
+    initialMargin: bigint;
+    maintenanceMargin: bigint;
+    currentMargin: bigint;
+    marginRatio: bigint;
+}
+export interface DepositParams {
+    amount: bigint;
+}
+export interface WithdrawParams {
+    amount: bigint;
+}
+export interface MarginUpdateEvent {
+    user: Address;
+    amount: bigint;
+    isDeposit: boolean;
+    timestamp: bigint;
+}
+//# sourceMappingURL=margin.d.ts.map

package/dist/types/margin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"margin.d.ts","sourceRoot":"","sources":["../../src/types/margin.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAE/B,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/types/margin.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Margin-related type definitions
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=margin.js.map

package/dist/types/margin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"margin.js","sourceRoot":"","sources":["../../src/types/margin.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/types/oracle.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Oracle-related type definitions
+ */
+import { Address } from 'viem';
+export interface PriceData {
+    asset: Address;
+    price: bigint;
+    timestamp: bigint;
+    confidence?: bigint;
+}
+export interface OracleConfig {
+    heartbeat: bigint;
+    deviation: bigint;
+    decimals: number;
+}
+export interface PriceFeed {
+    asset: Address;
+    oracle: Address;
+    isActive: boolean;
+}
+//# sourceMappingURL=oracle.d.ts.map

package/dist/types/oracle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oracle.d.ts","sourceRoot":"","sources":["../../src/types/oracle.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAE/B,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;CACnB"}

package/dist/types/oracle.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Oracle-related type definitions
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=oracle.js.map

package/dist/types/oracle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oracle.js","sourceRoot":"","sources":["../../src/types/oracle.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/types/positions.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Position-related type definitions
+ */
+import { Address } from 'viem';
+import type { Bytes16 } from './alpha';
+export interface Position {
+    id: Bytes16;
+    trader: Address;
+    asset: Address;
+    isLong: boolean;
+    notionalValue: bigint;
+    entryPrice: bigint;
+    margin: bigint;
+    lastFundingIndex: bigint;
+    timestamp: bigint;
+    isActive: boolean;
+}
+/**
+ * Parameters for opening a new position (margin-based approach)
+ * Users specify margin amount and desired leverage
+ */
+export interface PositionParams {
+    asset: Address;
+    isLong: boolean;
+    margin: bigint;
+    leverage: bigint;
+}
+export interface ClosePositionParams {
+    positionId: Bytes16;
+    notionalValue?: bigint;
+}
+export interface PositionInfo {
+    position: Position;
+    unrealizedPnL: bigint;
+    marginRatio: bigint;
+    liquidationPrice: bigint;
+}
+export declare enum PositionStatus {
+    ACTIVE = "ACTIVE",
+    CLOSED = "CLOSED",
+    LIQUIDATED = "LIQUIDATED"
+}
+//# sourceMappingURL=positions.d.ts.map

package/dist/types/positions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"positions.d.ts","sourceRoot":"","sources":["../../src/types/positions.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEvC,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,OAAO,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,QAAQ,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,oBAAY,cAAc;IACxB,MAAM,WAAW;IACjB,MAAM,WAAW;IACjB,UAAU,eAAe;CAC1B"}

package/dist/types/positions.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * Position-related type definitions
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PositionStatus = void 0;
+var PositionStatus;
+(function (PositionStatus) {
+    PositionStatus["ACTIVE"] = "ACTIVE";
+    PositionStatus["CLOSED"] = "CLOSED";
+    PositionStatus["LIQUIDATED"] = "LIQUIDATED";
+})(PositionStatus || (exports.PositionStatus = PositionStatus = {}));
+//# sourceMappingURL=positions.js.map

package/dist/types/positions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"positions.js","sourceRoot":"","sources":["../../src/types/positions.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAyCH,IAAY,cAIX;AAJD,WAAY,cAAc;IACxB,mCAAiB,CAAA;IACjB,mCAAiB,CAAA;IACjB,2CAAyB,CAAA;AAC3B,CAAC,EAJW,cAAc,8BAAd,cAAc,QAIzB"}

package/dist/utils/calculations.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Calculation utilities for Alpha Futures
+ */
+/**
+ * Calculate initial margin required for a position
+ * @param positionSize - The size of the position
+ * @returns The initial margin required (33.33% for 3x leverage)
+ */
+export declare function calculateInitialMargin(positionSize: bigint): bigint;
+/**
+ * Calculate maintenance margin required for a position
+ * @param positionSize - The size of the position
+ * @returns The maintenance margin required (20%)
+ */
+export declare function calculateMaintenanceMargin(positionSize: bigint): bigint;
+/**
+ * Calculate leverage from position size and margin
+ * @param positionSize - The size of the position
+ * @param margin - The margin amount
+ * @returns The leverage as a bigint
+ */
+export declare function calculateLeverage(positionSize: bigint, margin: bigint): bigint;
+/**
+ * Calculate position size from margin and leverage
+ * @param margin - The margin amount
+ * @param leverage - The leverage to use
+ * @returns The position size
+ */
+export declare function calculatePositionSize(margin: bigint, leverage: bigint): bigint;
+/**
+ * Calculate unrealized PnL for a position
+ * @param isLong - Whether the position is long
+ * @param size - The position size
+ * @param entryPrice - The entry price
+ * @param currentPrice - The current price
+ * @returns The unrealized PnL (positive for profit, negative for loss)
+ */
+export declare function calculateUnrealizedPnL(isLong: boolean, size: bigint, entryPrice: bigint, currentPrice: bigint): bigint;
+/**
+ * Calculate margin ratio in basis points
+ * @param margin - The current margin
+ * @param unrealizedPnL - The unrealized PnL
+ * @param positionSize - The position size
+ * @returns The margin ratio in basis points
+ */
+export declare function calculateMarginRatio(margin: bigint, unrealizedPnL: bigint, positionSize: bigint): bigint;
+/**
+ * Calculate liquidation price for a position
+ * @param isLong - Whether the position is long
+ * @param entryPrice - The entry price
+ * @param margin - The margin amount
+ * @param positionSize - The position size
+ * @returns The liquidation price
+ */
+export declare function calculateLiquidationPrice(isLong: boolean, entryPrice: bigint, margin: bigint, positionSize: bigint): bigint;
+/**
+ * Calculate trading fee (0.1% of position size)
+ * @param positionSize - The position size
+ * @returns The trading fee
+ */
+export declare function calculateTradingFee(positionSize: bigint): bigint;
+/**
+ * Calculate liquidation bonus (5% of remaining margin)
+ * @param remainingMargin - The remaining margin after liquidation
+ * @returns The liquidation bonus
+ */
+export declare function calculateLiquidationBonus(remainingMargin: bigint): bigint;
+/**
+ * Calculate funding payment
+ * @param positionSize - The position size
+ * @param fundingRate - The funding rate in basis points
+ * @param isLong - Whether the position is long
+ * @returns The funding payment (positive means payment required, negative means payment received)
+ */
+export declare function calculateFundingPayment(positionSize: bigint, fundingRate: bigint, isLong: boolean): bigint;
+/**
+ * Calculate price impact in basis points
+ * @param orderSize - The size of the order
+ * @param liquidity - The available liquidity
+ * @param impactMultiplier - The impact multiplier (default 100)
+ * @returns The price impact in basis points
+ */
+export declare function calculatePriceImpact(orderSize: bigint, liquidity: bigint, impactMultiplier?: bigint): bigint;
+//# sourceMappingURL=calculations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"calculations.d.ts","sourceRoot":"","sources":["../../src/utils/calculations.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAGnE;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAGvE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAG9E;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE9E;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,OAAO,EACf,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,GACnB,MAAM,CAOR;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,MAAM,GACnB,MAAM,CAKR;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,OAAO,EACf,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,GACnB,MAAM,CAcR;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,OAAO,GACd,MAAM,CAUR;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,gBAAgB,GAAE,MAAa,GAC9B,MAAM,CAMR"}

package/dist/utils/calculations.js

@@ -0,0 +1,155 @@
+"use strict";
+/**
+ * Calculation utilities for Alpha Futures
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculateInitialMargin = calculateInitialMargin;
+exports.calculateMaintenanceMargin = calculateMaintenanceMargin;
+exports.calculateLeverage = calculateLeverage;
+exports.calculatePositionSize = calculatePositionSize;
+exports.calculateUnrealizedPnL = calculateUnrealizedPnL;
+exports.calculateMarginRatio = calculateMarginRatio;
+exports.calculateLiquidationPrice = calculateLiquidationPrice;
+exports.calculateTradingFee = calculateTradingFee;
+exports.calculateLiquidationBonus = calculateLiquidationBonus;
+exports.calculateFundingPayment = calculateFundingPayment;
+exports.calculatePriceImpact = calculatePriceImpact;
+const constants_1 = require("../constants");
+/**
+ * Calculate initial margin required for a position
+ * @param positionSize - The size of the position
+ * @returns The initial margin required (33.33% for 3x leverage)
+ */
+function calculateInitialMargin(positionSize) {
+    // For 3x leverage, initial margin is 33.33%
+    return (positionSize * 3333n) / 10000n;
+}
+/**
+ * Calculate maintenance margin required for a position
+ * @param positionSize - The size of the position
+ * @returns The maintenance margin required (20%)
+ */
+function calculateMaintenanceMargin(positionSize) {
+    // Maintenance margin is 20%
+    return (positionSize * 2000n) / 10000n;
+}
+/**
+ * Calculate leverage from position size and margin
+ * @param positionSize - The size of the position
+ * @param margin - The margin amount
+ * @returns The leverage as a bigint
+ */
+function calculateLeverage(positionSize, margin) {
+    if (margin === 0n)
+        return 0n;
+    return positionSize / margin;
+}
+/**
+ * Calculate position size from margin and leverage
+ * @param margin - The margin amount
+ * @param leverage - The leverage to use
+ * @returns The position size
+ */
+function calculatePositionSize(margin, leverage) {
+    return margin * leverage;
+}
+/**
+ * Calculate unrealized PnL for a position
+ * @param isLong - Whether the position is long
+ * @param size - The position size
+ * @param entryPrice - The entry price
+ * @param currentPrice - The current price
+ * @returns The unrealized PnL (positive for profit, negative for loss)
+ */
+function calculateUnrealizedPnL(isLong, size, entryPrice, currentPrice) {
+    if (entryPrice === 0n)
+        return 0n;
+    const priceDiff = currentPrice - entryPrice;
+    const pnl = (size * priceDiff) / entryPrice;
+    return isLong ? pnl : -pnl;
+}
+/**
+ * Calculate margin ratio in basis points
+ * @param margin - The current margin
+ * @param unrealizedPnL - The unrealized PnL
+ * @param positionSize - The position size
+ * @returns The margin ratio in basis points
+ */
+function calculateMarginRatio(margin, unrealizedPnL, positionSize) {
+    if (positionSize === 0n)
+        return 0n;
+    const adjustedMargin = margin + unrealizedPnL;
+    return (adjustedMargin * 10000n) / positionSize;
+}
+/**
+ * Calculate liquidation price for a position
+ * @param isLong - Whether the position is long
+ * @param entryPrice - The entry price
+ * @param margin - The margin amount
+ * @param positionSize - The position size
+ * @returns The liquidation price
+ */
+function calculateLiquidationPrice(isLong, entryPrice, margin, positionSize) {
+    if (positionSize === 0n)
+        return 0n;
+    // Liquidation occurs at 20% margin ratio
+    const maintenanceMargin = calculateMaintenanceMargin(positionSize);
+    const marginDiff = margin - maintenanceMargin;
+    if (isLong) {
+        // Long position liquidates when price drops
+        return entryPrice - (marginDiff * entryPrice) / positionSize;
+    }
+    else {
+        // Short position liquidates when price rises
+        return entryPrice + (marginDiff * entryPrice) / positionSize;
+    }
+}
+/**
+ * Calculate trading fee (0.1% of position size)
+ * @param positionSize - The position size
+ * @returns The trading fee
+ */
+function calculateTradingFee(positionSize) {
+    return (positionSize * 10n) / 10000n; // 0.1%
+}
+/**
+ * Calculate liquidation bonus (5% of remaining margin)
+ * @param remainingMargin - The remaining margin after liquidation
+ * @returns The liquidation bonus
+ */
+function calculateLiquidationBonus(remainingMargin) {
+    return (remainingMargin * 500n) / 10000n; // 5%
+}
+/**
+ * Calculate funding payment
+ * @param positionSize - The position size
+ * @param fundingRate - The funding rate in basis points
+ * @param isLong - Whether the position is long
+ * @returns The funding payment (positive means payment required, negative means payment received)
+ */
+function calculateFundingPayment(positionSize, fundingRate, isLong) {
+    const payment = (positionSize * fundingRate) / 10000n;
+    // If funding rate is positive, longs pay shorts
+    // If funding rate is negative, shorts pay longs
+    if (fundingRate > 0n) {
+        return isLong ? payment : -payment;
+    }
+    else {
+        return isLong ? payment : -payment;
+    }
+}
+/**
+ * Calculate price impact in basis points
+ * @param orderSize - The size of the order
+ * @param liquidity - The available liquidity
+ * @param impactMultiplier - The impact multiplier (default 100)
+ * @returns The price impact in basis points
+ */
+function calculatePriceImpact(orderSize, liquidity, impactMultiplier = 100n) {
+    if (liquidity === 0n)
+        return 0n;
+    // Price impact = (orderSize / liquidity) * BASIS_POINTS * impactMultiplier / 100
+    // The impactMultiplier is divided by 100 as it's expressed as a percentage (100 = 1x)
+    return (orderSize * constants_1.BASIS_POINTS * impactMultiplier) / (liquidity * 100n);
+}
+//# sourceMappingURL=calculations.js.map

package/dist/utils/calculations.js.map

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

package/dist/utils/errors.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Error handling utilities
+ */
+/**
+ * Parse transaction error and return user-friendly message
+ */
+export declare function parseTransactionError(error: unknown): string;
+/**
+ * Check if error is network-related
+ */
+export declare function isNetworkError(error: unknown): boolean;
+/**
+ * Extract error message from various error types
+ */
+export declare function getErrorMessage(error: unknown): string;
+/**
+ * Check if error is retryable
+ */
+export declare function isRetryableError(error: unknown): boolean;
+/**
+ * Format error for logging
+ */
+export declare function formatError(error: unknown): Record<string, unknown>;
+//# 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;;GAEG;AAIH;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAuC5D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAgBtD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CActD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAkBxD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA8BnE"}

package/dist/utils/errors.js

@@ -0,0 +1,129 @@
+"use strict";
+/**
+ * Error handling utilities
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseTransactionError = parseTransactionError;
+exports.isNetworkError = isNetworkError;
+exports.getErrorMessage = getErrorMessage;
+exports.isRetryableError = isRetryableError;
+exports.formatError = formatError;
+// Error handling utilities
+/**
+ * Parse transaction error and return user-friendly message
+ */
+function parseTransactionError(error) {
+    const errorMessage = error?.message || error?.toString?.() || 'Unknown error';
+    // Check for revert reason
+    if (errorMessage.includes('execution reverted')) {
+        const match = errorMessage.match(/execution reverted: (.+?)(?:\n|$)/);
+        if (match) {
+            return match[1];
+        }
+        return 'Transaction execution reverted';
+    }
+    // Check for network errors
+    if (isNetworkError(error)) {
+        return 'Network error: Please check your connection and try again';
+    }
+    // Check for user rejection
+    if (errorMessage.includes('user rejected') || errorMessage.includes('User rejected')) {
+        return 'User rejected the transaction';
+    }
+    // Check for insufficient funds
+    if (errorMessage.includes('insufficient funds')) {
+        return 'Insufficient funds for transaction';
+    }
+    // Check for nonce errors
+    if (errorMessage.includes('nonce too low')) {
+        return 'Transaction nonce too low';
+    }
+    // Check for gas errors
+    if (errorMessage.includes('out of gas') || errorMessage.includes('gas required exceeds')) {
+        return 'Transaction ran out of gas';
+    }
+    // Return original message if no specific handling
+    return errorMessage;
+}
+/**
+ * Check if error is network-related
+ */
+function isNetworkError(error) {
+    const errorMessage = (error?.message || error?.toString?.() || '').toLowerCase();
+    const networkErrorPatterns = [
+        'network',
+        'timeout',
+        'connection',
+        'econnrefused',
+        'etimedout',
+        'enotfound',
+        'econnreset',
+        'socket hang up',
+        'fetch failed',
+    ];
+    return networkErrorPatterns.some((pattern) => errorMessage.includes(pattern));
+}
+/**
+ * Extract error message from various error types
+ */
+function getErrorMessage(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    if (typeof error === 'string') {
+        return error;
+    }
+    if (error && typeof error === 'object' && 'message' in error) {
+        return String(error.message);
+    }
+    return 'Unknown error';
+}
+/**
+ * Check if error is retryable
+ */
+function isRetryableError(error) {
+    // Network errors are usually retryable
+    if (isNetworkError(error)) {
+        return true;
+    }
+    const errorMessage = (error?.message || '').toLowerCase();
+    // Specific retryable conditions
+    const retryablePatterns = [
+        'nonce too low',
+        'replacement transaction underpriced',
+        'transaction underpriced',
+        'known transaction',
+        'already known',
+    ];
+    return retryablePatterns.some((pattern) => errorMessage.includes(pattern));
+}
+/**
+ * Format error for logging
+ */
+function formatError(error) {
+    const formatted = {
+        message: getErrorMessage(error),
+        timestamp: new Date().toISOString(),
+    };
+    if (error instanceof Error) {
+        formatted.name = error.name;
+        formatted.stack = error.stack;
+    }
+    const errorObj = error;
+    if (errorObj?.code) {
+        formatted.code = errorObj.code;
+    }
+    if (errorObj?.reason) {
+        formatted.reason = errorObj.reason;
+    }
+    if (errorObj?.transaction) {
+        formatted.transaction = {
+            to: errorObj.transaction.to,
+            from: errorObj.transaction.from,
+            value: errorObj.transaction.value?.toString(),
+            data: errorObj.transaction.data?.slice(0, 100) + '...', // Truncate long data
+        };
+    }
+    return formatted;
+}
+//# 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/events.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Event parsing and filtering utilities for Viem
+ */
+import { Log, type Abi, type AbiEvent } from 'viem';
+/**
+ * Decoded event log type
+ */
+export interface DecodedEventLog {
+    eventName: string;
+    args: Record<string, unknown> | readonly unknown[] | undefined;
+    address: string;
+    blockHash: string;
+    blockNumber: bigint;
+    data: string;
+    logIndex: number;
+    removed: boolean;
+    topics: readonly string[];
+    transactionHash: string;
+    transactionIndex: number;
+}
+/**
+ * Parse event logs using ABI
+ */
+export declare function parseEventLogs(logs: Log[], abi: Abi): DecodedEventLog[];
+/**
+ * Filter events by name
+ */
+export declare function filterEventsByName(events: DecodedEventLog[], eventName: string): DecodedEventLog[];
+/**
+ * Get event from ABI
+ */
+export declare function getEventFromAbi(abi: Abi, eventName: string): AbiEvent | undefined;
+/**
+ * Create event filter topics
+ */
+export declare function createEventFilter(abi: Abi, eventName: string, _args?: Record<string, unknown>): {
+    address?: string;
+    topics?: string[];
+};
+//# sourceMappingURL=events.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/utils/events.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,GAAG,EAAkB,KAAK,GAAG,EAAE,KAAK,QAAQ,EAAE,MAAM,MAAM,CAAC;AAEpE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,OAAO,EAAE,GAAG,SAAS,CAAC;IAC/D,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,GAAG,EAAE,GAAG,GAAG,eAAe,EAAE,CAgCvE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,eAAe,EAAE,EACzB,SAAS,EAAE,MAAM,GAChB,eAAe,EAAE,CAEnB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAEjF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,GAAG,EACR,SAAS,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAazC"}