@waiaas/core 2.0.0-rc.1

package/dist/errors/chain-error.d.ts

@@ -0,0 +1,48 @@
+/**
+ * ChainError: Chain adapter internal error with 3-category system.
+ *
+ * Categories:
+ * - PERMANENT: Non-recoverable errors (retryable=false)
+ * - TRANSIENT: Temporary infrastructure issues (retryable=true)
+ * - STALE: Stale state errors (retryable=true, rebuild tx)
+ *
+ * Stage 5 catches ChainError and converts to WAIaaSError for API responses.
+ * 29 error codes mapped to 3 categories (PERMANENT 21, TRANSIENT 4, STALE 4).
+ */
+export type ChainErrorCategory = 'PERMANENT' | 'TRANSIENT' | 'STALE';
+/**
+ * 29 chain-specific error codes for chain adapter internal use.
+ * Separate from ERROR_CODES (HTTP-level error codes for API responses).
+ */
+export type ChainErrorCode = 'INSUFFICIENT_BALANCE' | 'INVALID_ADDRESS' | 'ACCOUNT_NOT_FOUND' | 'CONTRACT_EXECUTION_FAILED' | 'INVALID_INSTRUCTION' | 'PROGRAM_NOT_FOUND' | 'TOKEN_ACCOUNT_NOT_FOUND' | 'INSUFFICIENT_TOKEN_BALANCE' | 'SPENDER_NOT_APPROVED' | 'ATA_CREATION_FAILED' | 'INVALID_PROGRAM_DATA' | 'UNAUTHORIZED_SIGNER' | 'TRANSACTION_TOO_LARGE' | 'DUPLICATE_TRANSACTION' | 'ACCOUNT_ALREADY_EXISTS' | 'INVALID_TOKEN_PROGRAM' | 'INSUFFICIENT_FOR_FEE' | 'BATCH_NOT_SUPPORTED' | 'BATCH_SIZE_EXCEEDED' | 'INVALID_RAW_TRANSACTION' | 'WALLET_NOT_SIGNER' | 'RPC_TIMEOUT' | 'RPC_CONNECTION_ERROR' | 'RATE_LIMITED' | 'NODE_BEHIND' | 'BLOCKHASH_EXPIRED' | 'NONCE_TOO_LOW' | 'NONCE_ALREADY_USED' | 'SLOT_SKIPPED';
+/**
+ * Maps each ChainErrorCode to its category.
+ * retryable is derived: category !== 'PERMANENT'.
+ */
+export declare const CHAIN_ERROR_CATEGORIES: Record<ChainErrorCode, ChainErrorCategory>;
+/**
+ * Chain adapter internal error.
+ *
+ * Extends Error (not WAIaaSError) because:
+ * - ChainError is internal to chain adapters, no httpStatus needed
+ * - Stage 5 catches ChainError and converts to WAIaaSError for API responses
+ * - Keeps chain adapter layer decoupled from HTTP concerns
+ */
+export declare class ChainError extends Error {
+    readonly code: ChainErrorCode;
+    readonly category: ChainErrorCategory;
+    readonly chain: string;
+    readonly retryable: boolean;
+    constructor(code: ChainErrorCode, chain: string, options?: {
+        message?: string;
+        cause?: Error;
+    });
+    toJSON(): {
+        code: ChainErrorCode;
+        message: string;
+        category: ChainErrorCategory;
+        chain: string;
+        retryable: boolean;
+    };
+}
+//# sourceMappingURL=chain-error.d.ts.map

package/dist/errors/chain-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain-error.d.ts","sourceRoot":"","sources":["../../src/errors/chain-error.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,WAAW,GAAG,OAAO,CAAC;AAErE;;;GAGG;AACH,MAAM,MAAM,cAAc,GAEtB,sBAAsB,GACtB,iBAAiB,GACjB,mBAAmB,GACnB,2BAA2B,GAC3B,qBAAqB,GACrB,mBAAmB,GACnB,yBAAyB,GACzB,4BAA4B,GAC5B,sBAAsB,GACtB,qBAAqB,GACrB,sBAAsB,GACtB,qBAAqB,GACrB,uBAAuB,GACvB,uBAAuB,GACvB,wBAAwB,GACxB,uBAAuB,GACvB,sBAAsB,GACtB,qBAAqB,GACrB,qBAAqB,GACrB,yBAAyB,GACzB,mBAAmB,GAEnB,aAAa,GACb,sBAAsB,GACtB,cAAc,GACd,aAAa,GAEb,mBAAmB,GACnB,eAAe,GACf,oBAAoB,GACpB,cAAc,CAAC;AAEnB;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,cAAc,EAAE,kBAAkB,CAiC7E,CAAC;AAEF;;;;;;;GAOG;AACH,qBAAa,UAAW,SAAQ,KAAK;IACnC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;gBAG1B,IAAI,EAAE,cAAc,EACpB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE;IAW/C,MAAM,IAAI;QACR,IAAI,EAAE,cAAc,CAAC;QACrB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,kBAAkB,CAAC;QAC7B,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,OAAO,CAAC;KACpB;CASF"}

package/dist/errors/chain-error.js

@@ -0,0 +1,83 @@
+/**
+ * ChainError: Chain adapter internal error with 3-category system.
+ *
+ * Categories:
+ * - PERMANENT: Non-recoverable errors (retryable=false)
+ * - TRANSIENT: Temporary infrastructure issues (retryable=true)
+ * - STALE: Stale state errors (retryable=true, rebuild tx)
+ *
+ * Stage 5 catches ChainError and converts to WAIaaSError for API responses.
+ * 29 error codes mapped to 3 categories (PERMANENT 21, TRANSIENT 4, STALE 4).
+ */
+/**
+ * Maps each ChainErrorCode to its category.
+ * retryable is derived: category !== 'PERMANENT'.
+ */
+export const CHAIN_ERROR_CATEGORIES = {
+    // PERMANENT (21)
+    INSUFFICIENT_BALANCE: 'PERMANENT',
+    INVALID_ADDRESS: 'PERMANENT',
+    ACCOUNT_NOT_FOUND: 'PERMANENT',
+    CONTRACT_EXECUTION_FAILED: 'PERMANENT',
+    INVALID_INSTRUCTION: 'PERMANENT',
+    PROGRAM_NOT_FOUND: 'PERMANENT',
+    TOKEN_ACCOUNT_NOT_FOUND: 'PERMANENT',
+    INSUFFICIENT_TOKEN_BALANCE: 'PERMANENT',
+    SPENDER_NOT_APPROVED: 'PERMANENT',
+    ATA_CREATION_FAILED: 'PERMANENT',
+    INVALID_PROGRAM_DATA: 'PERMANENT',
+    UNAUTHORIZED_SIGNER: 'PERMANENT',
+    TRANSACTION_TOO_LARGE: 'PERMANENT',
+    DUPLICATE_TRANSACTION: 'PERMANENT',
+    ACCOUNT_ALREADY_EXISTS: 'PERMANENT',
+    INVALID_TOKEN_PROGRAM: 'PERMANENT',
+    INSUFFICIENT_FOR_FEE: 'PERMANENT',
+    BATCH_NOT_SUPPORTED: 'PERMANENT',
+    BATCH_SIZE_EXCEEDED: 'PERMANENT',
+    INVALID_RAW_TRANSACTION: 'PERMANENT',
+    WALLET_NOT_SIGNER: 'PERMANENT',
+    // TRANSIENT (4)
+    RPC_TIMEOUT: 'TRANSIENT',
+    RPC_CONNECTION_ERROR: 'TRANSIENT',
+    RATE_LIMITED: 'TRANSIENT',
+    NODE_BEHIND: 'TRANSIENT',
+    // STALE (4)
+    BLOCKHASH_EXPIRED: 'STALE',
+    NONCE_TOO_LOW: 'STALE',
+    NONCE_ALREADY_USED: 'STALE',
+    SLOT_SKIPPED: 'STALE',
+};
+/**
+ * Chain adapter internal error.
+ *
+ * Extends Error (not WAIaaSError) because:
+ * - ChainError is internal to chain adapters, no httpStatus needed
+ * - Stage 5 catches ChainError and converts to WAIaaSError for API responses
+ * - Keeps chain adapter layer decoupled from HTTP concerns
+ */
+export class ChainError extends Error {
+    code;
+    category;
+    chain;
+    retryable;
+    constructor(code, chain, options) {
+        super(options?.message ?? `Chain error: ${code}`);
+        this.name = 'ChainError';
+        this.code = code;
+        this.chain = chain;
+        this.category = CHAIN_ERROR_CATEGORIES[code];
+        this.retryable = this.category !== 'PERMANENT';
+        if (options?.cause)
+            this.cause = options.cause;
+    }
+    toJSON() {
+        return {
+            code: this.code,
+            message: this.message,
+            category: this.category,
+            chain: this.chain,
+            retryable: this.retryable,
+        };
+    }
+}
+//# sourceMappingURL=chain-error.js.map

package/dist/errors/chain-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain-error.js","sourceRoot":"","sources":["../../src/errors/chain-error.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AA0CH;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAA+C;IAChF,iBAAiB;IACjB,oBAAoB,EAAE,WAAW;IACjC,eAAe,EAAE,WAAW;IAC5B,iBAAiB,EAAE,WAAW;IAC9B,yBAAyB,EAAE,WAAW;IACtC,mBAAmB,EAAE,WAAW;IAChC,iBAAiB,EAAE,WAAW;IAC9B,uBAAuB,EAAE,WAAW;IACpC,0BAA0B,EAAE,WAAW;IACvC,oBAAoB,EAAE,WAAW;IACjC,mBAAmB,EAAE,WAAW;IAChC,oBAAoB,EAAE,WAAW;IACjC,mBAAmB,EAAE,WAAW;IAChC,qBAAqB,EAAE,WAAW;IAClC,qBAAqB,EAAE,WAAW;IAClC,sBAAsB,EAAE,WAAW;IACnC,qBAAqB,EAAE,WAAW;IAClC,oBAAoB,EAAE,WAAW;IACjC,mBAAmB,EAAE,WAAW;IAChC,mBAAmB,EAAE,WAAW;IAChC,uBAAuB,EAAE,WAAW;IACpC,iBAAiB,EAAE,WAAW;IAC9B,gBAAgB;IAChB,WAAW,EAAE,WAAW;IACxB,oBAAoB,EAAE,WAAW;IACjC,YAAY,EAAE,WAAW;IACzB,WAAW,EAAE,WAAW;IACxB,YAAY;IACZ,iBAAiB,EAAE,OAAO;IAC1B,aAAa,EAAE,OAAO;IACtB,kBAAkB,EAAE,OAAO;IAC3B,YAAY,EAAE,OAAO;CACtB,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,OAAO,UAAW,SAAQ,KAAK;IAC1B,IAAI,CAAiB;IACrB,QAAQ,CAAqB;IAC7B,KAAK,CAAS;IACd,SAAS,CAAU;IAE5B,YACE,IAAoB,EACpB,KAAa,EACb,OAA6C;QAE7C,KAAK,CAAC,OAAO,EAAE,OAAO,IAAI,gBAAgB,IAAI,EAAE,CAAC,CAAC;QAClD,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,QAAQ,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;QAC7C,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,QAAQ,KAAK,WAAW,CAAC;QAC/C,IAAI,OAAO,EAAE,KAAK;YAAE,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IACjD,CAAC;IAED,MAAM;QAOJ,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC;IACJ,CAAC;CACF"}