@galaxy-kj/core-stellar-sdk 2.0.0

package/dist/soroban/utils/error-parser.js

@@ -0,0 +1,302 @@
+// @ts-nocheck
+/**
+ * @fileoverview Error Parser
+ * @description Parse and handle Soroban contract errors
+ * @author Galaxy DevKit Team
+ * @version 1.0.0
+ * @since 2024-12-01
+ */
+import { xdr } from '@stellar/stellar-sdk';
+export class SorobanError extends Error {
+    constructor(message, code = 0, type = 'Unknown') {
+        super(message);
+        this.name = 'SorobanError';
+        this.code = code;
+        this.type = type;
+    }
+    static withContext(message, code, type, context) {
+        const error = new SorobanError(message, code, type);
+        if (context) {
+            Object.defineProperty(error, 'contractId', {
+                value: context.contractId,
+                writable: true,
+                configurable: true,
+            });
+            Object.defineProperty(error, 'method', {
+                value: context.method,
+                writable: true,
+                configurable: true,
+            });
+        }
+        return error;
+    }
+}
+export class ErrorParser {
+    /**
+     * Parse Soroban error from result
+     */
+    static parseError(result) {
+        if (!result) {
+            return new SorobanError('Unknown error occurred', -1, 'Unknown');
+        }
+        try {
+            // Try to parse as error struct
+            const errorValue = this.extractErrorValue(result);
+            if (errorValue instanceof Map) {
+                return this.parseErrorStruct(errorValue);
+            }
+            // Try to parse as error code
+            if (typeof errorValue === 'number') {
+                return this.parseErrorCode(errorValue);
+            }
+            // Try to parse as error string
+            if (typeof errorValue === 'string') {
+                return new SorobanError(errorValue, 0, 'Custom');
+            }
+            return new SorobanError(`Unrecognized error format: ${errorValue}`, -1, 'InvalidFormat');
+        }
+        catch (error) {
+            return new SorobanError(`Failed to parse error: ${error.message}`, -2, 'ParseError');
+        }
+    }
+    /**
+     * Parse transaction error
+     */
+    static parseTransactionError(resultXdr, metaXdr) {
+        try {
+            if (resultXdr) {
+                const result = xdr.TransactionResult.fromXDR(resultXdr, 'base64');
+                if (result.result().switch() === xdr.TransactionResultCode.txFailed()) {
+                    const operations = result.result().results() || [];
+                    for (const op of operations) {
+                        if (op.tr()?.switch() ===
+                            xdr.TransactionResultResultCode.txInternalError()) {
+                            return this.parseError(op.tr().value());
+                        }
+                    }
+                }
+            }
+            // Parse meta for additional error information
+            if (metaXdr) {
+                const meta = xdr.TransactionMeta.fromXDR(metaXdr, 'base64');
+                return this.parseMetaError(meta);
+            }
+            return new SorobanError('Transaction failed but no specific error found', -1, 'TransactionFailed');
+        }
+        catch (error) {
+            return new SorobanError(`Failed to parse transaction error: ${error.message}`, -2, 'ParseError');
+        }
+    }
+    /**
+     * Parse simulation error
+     */
+    static parseSimulationError(error, result) {
+        if (error) {
+            // Try to extract error details from error string
+            if (error.includes('insufficient fee')) {
+                return new SorobanError('Insufficient fee for transaction', 4001, 'InsufficientFee');
+            }
+            if (error.includes('insufficient balance')) {
+                return new SorobanError('Insufficient balance', 4002, 'InsufficientBalance');
+            }
+            if (error.includes('contract not found')) {
+                return new SorobanError('Contract not found', 4003, 'ContractNotFound');
+            }
+            if (error.includes('method not found')) {
+                return new SorobanError('Method not found', 4004, 'MethodNotFound');
+            }
+            if (error.includes('invalid argument')) {
+                return new SorobanError('Invalid argument', 4005, 'InvalidArgument');
+            }
+            return new SorobanError(error, 4000, 'SimulationError');
+        }
+        if (result) {
+            return this.parseError(result);
+        }
+        return new SorobanError('Simulation failed', 4000, 'SimulationError');
+    }
+    /**
+     * Parse common error codes
+     */
+    static parseErrorCode(code) {
+        switch (code) {
+            case 1:
+                return new SorobanError('Contract panicked', 1, 'ContractPanic');
+            case 2:
+                return new SorobanError('Arithmetic overflow', 2, 'ArithmeticOverflow');
+            case 3:
+                return new SorobanError('Division by zero', 3, 'DivisionByZero');
+            case 4:
+                return new SorobanError('Invalid arithmetic', 4, 'InvalidArithmetic');
+            case 5:
+                return new SorobanError('Invalid input', 5, 'InvalidInput');
+            case 6:
+                return new SorobanError('Index out of bounds', 6, 'IndexOutOfBounds');
+            case 7:
+                return new SorobanError('Memory access violation', 7, 'MemoryAccessViolation');
+            case 8:
+                return new SorobanError('Invalid conversion', 8, 'InvalidConversion');
+            case 9:
+                return new SorobanError('Missing value in optional', 9, 'MissingValue');
+            case 10:
+                return new SorobanError('Expected error in result', 10, 'ExpectedError');
+            case 11:
+                return new SorobanError('Host context error', 11, 'HostContextError');
+            default:
+                return new SorobanError(`Unknown error code: ${code}`, code, 'UnknownCode');
+        }
+    }
+    /**
+     * Parse error struct from Map
+     */
+    static parseErrorStruct(errorMap) {
+        const code = errorMap.get('code');
+        const message = errorMap.get('message');
+        const type = errorMap.get('type');
+        if (typeof code === 'number') {
+            return new SorobanError(typeof message === 'string' ? message : 'Contract error', code, typeof type === 'string' ? type : 'ContractError');
+        }
+        return new SorobanError(typeof message === 'string' ? message : 'Unknown contract error', 0, typeof type === 'string' ? type : 'ContractError');
+    }
+    /**
+     * Extract error value from ScVal
+     */
+    static extractErrorValue(result) {
+        switch (result.switch()) {
+            case xdr.ScValType.scvError():
+                // Error is encoded as a ScVal containing error information
+                return result.error();
+            case xdr.ScValType.scvU32():
+                return result.u32();
+            case xdr.ScValType.scvI32():
+                return result.i32();
+            case xdr.ScValType.scvString():
+                return result.str().toString();
+            case xdr.ScValType.scvSymbol():
+                return result.symbol().toString();
+            case xdr.ScValType.scvMap():
+                const map = new Map();
+                for (const entry of result.map()) {
+                    const key = this.extractScValValue(entry.key());
+                    const value = this.extractScValValue(entry.val());
+                    map.set(key, value);
+                }
+                return map;
+            default:
+                return result;
+        }
+    }
+    /**
+     * Extract primitive value from ScVal
+     */
+    static extractScValValue(scVal) {
+        switch (scVal.switch()) {
+            case xdr.ScValType.scvVoid():
+                return null;
+            case xdr.ScValType.scvBool():
+                return scVal.bool();
+            case xdr.ScValType.scvU32():
+                return scVal.u32();
+            case xdr.ScValType.scvI32():
+                return scVal.i32();
+            case xdr.ScValType.scvString():
+                return scVal.str().toString();
+            case xdr.ScValType.scvSymbol():
+                return scVal.symbol().toString();
+            default:
+                return scVal;
+        }
+    }
+    /**
+     * Parse error from transaction meta
+     */
+    static parseMetaError(meta) {
+        const v3 = meta.v3();
+        if (!v3) {
+            return new SorobanError('Transaction meta version not supported', -1, 'UnsupportedVersion');
+        }
+        const sorobanMeta = v3.sorobanMeta();
+        if (!sorobanMeta) {
+            return new SorobanError('No Soroban meta found', -1, 'MissingSorobanMeta');
+        }
+        // Check for diagnostic events that might contain error information
+        for (const event of sorobanMeta.events()) {
+            if (event.type().equals(xdr.ContractEventType.contractError())) {
+                return this.parseError(event.data());
+            }
+        }
+        // Check for exceptions
+        const ext = v3.ext();
+        if (ext.switch() === xdr.TransactionMetaExtension.v1()) {
+            const v1Ext = ext.v1();
+            if (v1Ext.sorobanMeta()) {
+                // Additional error parsing logic could go here
+            }
+        }
+        return new SorobanError('Transaction failed but specific error not found', -1, 'TransactionError');
+    }
+    /**
+     * Check if error is recoverable
+     */
+    static isRecoverableError(error) {
+        const recoverableTypes = [
+            'InsufficientFee',
+            'InsufficientBalance',
+            'NetworkError',
+            'Timeout',
+        ];
+        return recoverableTypes.includes(error.type);
+    }
+    /**
+     * Check if error should be retried
+     */
+    static shouldRetry(error, attemptCount) {
+        if (!this.isRecoverableError(error)) {
+            return false;
+        }
+        // Don't retry too many times
+        if (attemptCount >= 3) {
+            return false;
+        }
+        // Don't retry certain errors even if they're recoverable
+        const nonRetryableTypes = ['InsufficientBalance', 'ContractNotFound'];
+        return !nonRetryableTypes.includes(error.type);
+    }
+    /**
+     * Get retry delay for error
+     */
+    static getRetryDelay(error, attemptCount) {
+        // Base delay with exponential backoff
+        let baseDelay = 1000; // 1 second
+        switch (error.type) {
+            case 'InsufficientFee':
+                baseDelay = 2000; // 2 seconds
+                break;
+            case 'NetworkError':
+                baseDelay = 5000; // 5 seconds
+                break;
+            case 'Timeout':
+                baseDelay = 3000; // 3 seconds
+                break;
+        }
+        return baseDelay * Math.pow(2, attemptCount - 1);
+    }
+    /**
+     * Format error for display
+     */
+    static formatError(error) {
+        let message = error.message;
+        if (error.contractId) {
+            message += ` (Contract: ${error.contractId})`;
+        }
+        if (error.method) {
+            message += ` (Method: ${error.method})`;
+        }
+        if (error.code !== 0) {
+            message += ` (Code: ${error.code})`;
+        }
+        message += ` (Type: ${error.type})`;
+        return message;
+    }
+}
+//# sourceMappingURL=error-parser.js.map

package/dist/soroban/utils/error-parser.js.map

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

package/dist/soroban/utils/event-decoder.d.ts

@@ -0,0 +1,91 @@
+import { ContractEvent, ScType } from '../types/contract-types';
+import { ContractEventDetail } from '../types/contract-types';
+export declare class EventDecoder {
+    /**
+     * Decode contract event from raw event data
+     */
+    static decodeEvent(rawEvent: SorobanRpc.Api.GetEventsResponseEvent, eventDefinition?: ContractEvent): ContractEventDetail;
+    /**
+     * Decode event with known event schema
+     */
+    static decodeEventWithSchema(rawEvent: SorobanRpc.Api.GetEventsResponseEvent, schema: {
+        name: string;
+        topicTypes: ScType[];
+        dataTypes: ScType[];
+    }): ContractEventDetail & {
+        decodedTopics: any[];
+        decodedData: any;
+        parsedEvent: any;
+    };
+    /**
+     * Decode token transfer event
+     */
+    static decodeTransferEvent(event: ContractEventDetail): {
+        from: string;
+        to: string;
+        amount: string;
+    } | null;
+    /**
+     * Decode token approval event
+     */
+    static decodeApprovalEvent(event: ContractEventDetail): {
+        owner: string;
+        spender: string;
+        amount: string;
+    } | null;
+    /**
+     * Decode contract error event
+     */
+    static decodeErrorEvent(event: ContractEventDetail): {
+        error: string;
+        code?: number;
+        context?: any;
+    } | null;
+    /**
+     * Decode custom event
+     */
+    static decodeCustomEvent(event: ContractEventDetail, fieldMapping: Record<string, {
+        topic: number;
+        type: ScType;
+    } | {
+        data: string;
+        type: ScType;
+    }>): Record<string, any>;
+    /**
+     * Create event decoder for specific contract
+     */
+    static createEventDecoder(eventSchemas: Array<{
+        name: string;
+        topicTypes: ScType[];
+        dataTypes: ScType[];
+    }>): (event: ContractEventDetail) => any;
+    /**
+     * Filter events by type
+     */
+    static filterEventsByType(events: ContractEventDetail[], eventType: string): ContractEventDetail[];
+    /**
+     * Group events by transaction
+     */
+    static groupEventsByTransaction(events: ContractEventDetail[]): Map<string, ContractEventDetail[]>;
+    /**
+     * Extract event statistics
+     */
+    static extractEventStats(events: ContractEventDetail[]): {
+        totalEvents: number;
+        eventTypes: Map<string, number>;
+        contracts: Map<string, number>;
+        timeRange: {
+            min: number;
+            max: number;
+        };
+    };
+    /**
+     * Format event for display
+     */
+    static formatEvent(event: ContractEventDetail): string;
+    /**
+     * Export events to CSV
+     */
+    static exportToCSV(events: ContractEventDetail[]): string;
+}
+//# sourceMappingURL=event-decoder.d.ts.map

package/dist/soroban/utils/event-decoder.d.ts.map

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