@ercworldio/blockchain-shared 1.0.1-dev.9 → 1.0.2-dev.0

package/build/errors/errors.d.ts

@@ -1,3 +1,114 @@
+/**
+ * Centralized static error message strings.
+ * Keys mirror ErrorCodes — subclasses reference these instead of using inline string literals.
+ */
+export declare const ErrorMessages: {
+    readonly INTERNAL_SERVER: "Internal Server Error";
+    readonly UNAUTHORIZED: "You are not authorized to perform this action";
+    readonly REQUIRE_PARAMETER: "A required parameter is missing";
+    readonly USER_NOT_FOUND: "User not found";
+    readonly INVALID_VALUE: "One or more values provided are invalid";
+    readonly INVALID_TOKEN_FORMAT: "Invalid authorization format. Expected: Bearer <token>";
+    readonly RENEW_NOT_ALLOWED: "Your deposit address is not yet eligible for renewal";
+    readonly VALIDATION_ERROR: "Request validation failed";
+    readonly UNSUPPORTED_RESOURCE: "The requested resource is not supported";
+    readonly INVALID_PAYMENT_TOKEN: "The payment token provided is not recognized";
+    readonly UNEXPECTED_PAYMENT_TOKEN: "The selected payment token is not supported on this network";
+    readonly NOT_FOUND: "The requested resource was not found";
+    readonly CHAIN_CONFIG_NOT_SET: "Chain configuration is missing. Please contact support";
+    readonly UNEXPECTED_ERROR: "An unexpected error occurred. Please try again later";
+    readonly DATABASE_NOT_INITIALIZED: "Database connection is not available";
+    readonly INVALID_USER_ID: "The provided user ID is invalid";
+    readonly NO_PAYMENT_TOKENS: "No payment tokens are configured for this network";
+    readonly SERVER_NOT_INITIALIZED: "Server is starting up. Please try again in a moment";
+    readonly SERVER_NOT_RESPONDING: "The server is not responding. Please try again later";
+    readonly INVALID_ADDRESS: "The provided address is invalid";
+    readonly PAYMENT_REQUEST_NOT_APPROVED: "Payment request has not been approved";
+    readonly REQUIRE_PAYMENT_ID: "Payment ID is required";
+    readonly ADDRESS_EXISTS: "A deposit address already exists for this account";
+    readonly UNSUPPORTED_ALCHEMY_NETWORK: "The blockchain network is not supported by Alchemy";
+    readonly FAILED_INITIALIZE_WEBHOOKS: "Failed to initialize webhooks. Please try again later";
+    readonly SERVER_UNAVAILABLE: "Service is temporarily unavailable. Please try again later";
+    readonly FAILED_GET_TRANSACTIONS: "Failed to retrieve transaction count. Please try again later";
+    readonly INVOICE_SUBSCRIBER_ERROR: "Failed to subscribe to the invoice. Please try again";
+    readonly REQUIRE_MIN_AMOUNT: "The amount is below the minimum required";
+    readonly PAYMENT_ID_NOT_FOUND: "Invoice not found or expired. Please request a new one";
+    readonly ALREADY_PAID_INVOICE: "This invoice has already been paid";
+    readonly PAYMENT_FAILED: "Payment could not be processed. Please try again";
+    readonly FAILED_WEBHOOK_ACTION: "A webhook operation failed. Please try again later";
+    readonly ORM_REPO_NOT_INITIALIZED: "A required database repository is not initialized";
+    readonly NO_WEBHOOKS: "No webhooks found for this subscription";
+    readonly FAILED_GET_WEBHOOK_ADDRESSES: "Failed to retrieve webhook addresses. Please try again later";
+    readonly PARENT_INDEX_IN_USE: "The selected wallet index is already in use";
+    readonly REQUEST_NOT_APPROVED: "Withdrawal request has not been approved";
+    readonly RECEIVER_REQUIRED: "Receiver address is missing. Please contact support";
+    readonly UNEXPECTED_RECEIVER: "Please use the wallet address associated with your deposit";
+    readonly DUPLICATE_CLAIM_JOB: "A claim for this request is already in progress. Please check back in a few minutes";
+    readonly INVALID_WALLET_ADDRESS: "The wallet address provided is invalid";
+    readonly REQUEST_FULFILLED: "This request has already been fulfilled";
+    readonly WITHDRAW_REQUEST_NOT_FOUND: "Withdrawal request not found";
+    readonly UNSUPPORTED_NETWORK: "The selected network is not supported";
+    readonly UNSUPPORTED_ADDRESS: "The address format is not compatible with the selected network";
+    readonly UNEXPECTED_ADDRESS_FORMAT: "The address does not match the expected format for the selected network";
+    readonly EMPTY_PAYLOAD: "Request payload cannot be empty";
+    readonly ONLY_STABLECOIN_WITHDRAWAL: "This network only supports stablecoin withdrawals";
+};
+export declare const ErrorCodes: {
+    readonly INTERNAL_SERVER: "error.internal_server_error";
+    readonly UNAUTHORIZED: "error.unauthorized";
+    readonly REQUIRE_PARAMETER: "error.require_parameter";
+    readonly USER_NOT_FOUND: "error.user_not_found";
+    readonly INVALID_VALUE: "error.invalid_value";
+    readonly INVALID_TOKEN_FORMAT: "error.invalid_token_format";
+    readonly RENEW_NOT_ALLOWED: "error.renew_not_allowed";
+    readonly VALIDATION_ERROR: "error.validation_error";
+    readonly UNSUPPORTED_RESOURCE: "error.unsupported_resource";
+    readonly INVALID_PAYMENT_TOKEN: "error.invalid_payment_token";
+    readonly UNEXPECTED_PAYMENT_TOKEN: "error.unexpected_payment_token";
+    readonly NOT_FOUND: "error.not_found";
+    readonly CHAIN_CONFIG_NOT_SET: "error.chain_config_not_set";
+    readonly UNEXPECTED_ERROR: "error.unexpected_error";
+    readonly DATABASE_NOT_INITIALIZED: "error.database_not_initialized";
+    readonly INVALID_USER_ID: "error.invalid_user_id";
+    readonly NO_PAYMENT_TOKENS: "error.no_payment_tokens";
+    readonly SERVER_NOT_INITIALIZED: "error.server_not_initialized";
+    readonly SERVER_NOT_RESPONDING: "error.server_not_responding";
+    readonly INVALID_ADDRESS: "error.invalid_address";
+    readonly PAYMENT_REQUEST_NOT_APPROVED: "error.payment_request_not_approved";
+    readonly REQUIRE_PAYMENT_ID: "error.require_payment_id";
+    readonly ADDRESS_EXISTS: "error.address_exists";
+    readonly UNSUPPORTED_ALCHEMY_NETWORK: "error.unsupported_alchemy_network";
+    readonly FAILED_INITIALIZE_WEBHOOKS: "error.failed_initialize_webhooks";
+    readonly SERVER_UNAVAILABLE: "error.server_unavailable";
+    readonly FAILED_GET_TRANSACTIONS: "error.failed_get_transactions";
+    readonly ORM_REPO_NOT_INITIALIZED: "error.orm_repo_not_initialized";
+    readonly INVOICE_SUBSCRIBER_ERROR: "error.invoice_subscriber_error";
+    readonly REQUIRE_MIN_AMOUNT: "error.require_min_amount";
+    readonly PAYMENT_ID_NOT_FOUND: "error.payment_id_not_found";
+    readonly ALREADY_PAID_INVOICE: "error.already_paid_invoice";
+    readonly PAYMENT_FAILED: "error.payment_failed";
+    readonly FAILED_WEBHOOK_ACTION: "error.failed_webhook_action";
+    readonly NO_WEBHOOKS: "error.no_webhooks";
+    readonly FAILED_GET_WEBHOOK_ADDRESSES: "error.failed_get_webhook_addresses";
+    readonly PARENT_INDEX_IN_USE: "error.parent_index_in_use";
+    readonly REQUEST_NOT_APPROVED: "error.request_not_approved";
+    readonly RECEIVER_REQUIRED: "error.receiver_required";
+    readonly UNEXPECTED_RECEIVER: "error.unexpected_receiver";
+    readonly DUPLICATE_CLAIM_JOB: "error.duplicate_claim_job";
+    readonly REQUEST_FULFILLED: "error.request_fulfilled";
+    readonly WITHDRAW_REQUEST_NOT_FOUND: "error.withdraw_request_not_found";
+    readonly UNSUPPORTED_NETWORK: "error.unsupported_network";
+    readonly UNSUPPORTED_ADDRESS: "error.unsupported_address";
+    readonly UNEXPECTED_ADDRESS_FORMAT: "error.unexpected_address_format";
+    readonly EMPTY_PAYLOAD: "error.empty_payload";
+    readonly ONLY_STABLECOIN_WITHDRAWAL: "error.only_stablecoin_withdrawal";
+};
+export type ErrorCode = typeof ErrorCodes[keyof typeof ErrorCodes];
+export interface ErrorCodeEntry {
+    code: number;
+    error: string;
+    error_code: ErrorCode;
+}
 interface ErrorHandlerResponse {
     status_code: number;
     response: ResponseObject;
@@ -6,6 +117,8 @@ interface ErrorHandlerResponse {
 interface ResponseObject {
     status: boolean;
     message: string;
+    /** Static CMS translation key. Null for unrecognised/internal errors. */
+    error_code: ErrorCode | null;
     data: any;
     error: string;
 }
@@ -40,35 +153,32 @@ declare class BaseErrors {
             error: string;
         };
     };
-    /** Error Definition */
-    Unauthorized(): string;
-    RequireParameter(key: string): string;
-    NotFoundUser(): string;
-    InvalidValue(name: string, context?: string): string;
-    InvalidTokenFormat(): string;
-    RenewNotAllowed(remaining_duration_s: number, remaining_threshold_s: number): string;
-    ValidationError(validation_type: string): string;
-    UnsupportedResource(target: string): string;
-    InvalidPaymentToken(token: string): string;
-    UnexpectedPaymentToken(): string;
-    NotFound(resource_name: string): string;
-    ChainConfigNotSet(): string;
-    UnexpectedError(details?: string): string;
-    NotInitializedDatabase(): string;
-    InvalidUserId(id: string): string;
-    NoPaymentTokens(): string;
-    NotInitializedServer(): string;
-    ServerNotResponding(): string;
-    InvalidAddress(target: string): string;
-    NotApprovedPaymentRequest(): string;
-    RequirePaymentId(): string;
-    AddressExists(): string;
+    /** Error definitions — unchanged, backward compatible */
+    Unauthorized(_?: any): "You are not authorized to perform this action";
+    RequireParameter(_?: any): "A required parameter is missing";
+    NotFoundUser(_?: any): "User not found";
+    InvalidValue(_?: any, __?: any): "One or more values provided are invalid";
+    InvalidTokenFormat(_?: any): "Invalid authorization format. Expected: Bearer <token>";
+    RenewNotAllowed(_?: any, __?: any): "Your deposit address is not yet eligible for renewal";
+    ValidationError(_?: any): "Request validation failed";
+    UnsupportedResource(_?: any): "The requested resource is not supported";
+    InvalidPaymentToken(_?: any): "The payment token provided is not recognized";
+    UnexpectedPaymentToken(_?: any): "The selected payment token is not supported on this network";
+    NotFound(_?: any): "The requested resource was not found";
+    ChainConfigNotSet(_?: any): "Chain configuration is missing. Please contact support";
+    UnexpectedError(_?: any): "An unexpected error occurred. Please try again later";
+    NotInitializedDatabase(_?: any): "Database connection is not available";
+    InvalidUserId(_?: any): "The provided user ID is invalid";
+    NoPaymentTokens(_?: any): "No payment tokens are configured for this network";
+    NotInitializedServer(_?: any): "Server is starting up. Please try again in a moment";
+    ServerNotResponding(_?: any): "The server is not responding. Please try again later";
+    InvalidAddress(_?: any): string;
+    NotApprovedPaymentRequest(_?: any): "Payment request has not been approved";
+    RequirePaymentId(_?: any): "Payment ID is required";
+    AddressExists(_?: any): "A deposit address already exists for this account";
     /** Handler methods */
     handle_error: (error: any, source_method: string) => ErrorHandlerResponse;
-    get_error_code_base: (message: string) => {
-        code: number;
-        error: string;
-    } | null;
+    get_error_code_base: (message: string) => ErrorCodeEntry | null;
 }
 export default BaseErrors;
 //# sourceMappingURL=errors.d.ts.map

package/build/errors/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors/errors.ts"],"names":[],"mappings":"AAAA,UAAU,oBAAoB;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,cAAc,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;CACzB;AAED,UAAU,cAAc;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,GAAG,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;CACjB;AAGD,cAAM,UAAU;IACL,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAQX;IAED,uBAAuB;IAChB,YAAY;IACZ,gBAAgB,CAAC,GAAG,EAAE,MAAM;IAC5B,YAAY;IACZ,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;IAC3C,kBAAkB;IAClB,eAAe,CAAC,oBAAoB,EAAE,MAAM,EAAE,qBAAqB,EAAE,MAAM;IAC3E,eAAe,CAAC,eAAe,EAAE,MAAM;IACvC,mBAAmB,CAAC,MAAM,EAAE,MAAM;IAClC,mBAAmB,CAAC,KAAK,EAAE,MAAM;IACjC,sBAAsB;IACtB,QAAQ,CAAC,aAAa,EAAE,MAAM;IAC9B,iBAAiB;IACjB,eAAe,CAAC,OAAO,CAAC,EAAE,MAAM;IAChC,sBAAsB;IACtB,aAAa,CAAC,EAAE,EAAE,MAAM;IACxB,eAAe;IACf,oBAAoB;IACpB,mBAAmB;IACnB,cAAc,CAAC,MAAM,EAAE,MAAM;IAC7B,yBAAyB;IACzB,gBAAgB;IAChB,aAAa;IAEpB,sBAAsB;IAEf,YAAY,GAAI,OAAO,GAAG,EAAE,eAAe,MAAM,KAAG,oBAAoB,CAkB9E;IAGM,mBAAmB,GAAI,SAAS,MAAM;;;aAqB5C;CACJ;AAED,eAAe,UAAU,CAAC"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors/errors.ts"],"names":[],"mappings":"AACA;;;GAGG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsFhB,CAAC;AAEX,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsDb,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,OAAO,UAAU,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC;AAEnE,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,SAAS,CAAC;CACzB;AAED,UAAU,oBAAoB;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,cAAc,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;CACzB;AAED,UAAU,cAAc;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,yEAAyE;IACzE,UAAU,EAAE,SAAS,GAAG,IAAI,CAAC;IAC7B,IAAI,EAAE,GAAG,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;CACjB;AAGD,cAAM,UAAU;IACL,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAQX;IAED,yDAAyD;IAClD,YAAY,CAAC,CAAC,CAAC,EAAE,GAAG;IACpB,gBAAgB,CAAC,CAAC,CAAC,EAAE,GAAG;IACxB,YAAY,CAAC,CAAC,CAAC,EAAE,GAAG;IACpB,YAAY,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,EAAE,GAAG;IAC9B,kBAAkB,CAAC,CAAC,CAAC,EAAE,GAAG;IAC1B,eAAe,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,EAAE,GAAG;IACjC,eAAe,CAAC,CAAC,CAAC,EAAE,GAAG;IACvB,mBAAmB,CAAC,CAAC,CAAC,EAAE,GAAG;IAC3B,mBAAmB,CAAC,CAAC,CAAC,EAAE,GAAG;IAC3B,sBAAsB,CAAC,CAAC,CAAC,EAAE,GAAG;IAC9B,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG;IAChB,iBAAiB,CAAC,CAAC,CAAC,EAAE,GAAG;IACzB,eAAe,CAAC,CAAC,CAAC,EAAE,GAAG;IACvB,sBAAsB,CAAC,CAAC,CAAC,EAAE,GAAG;IAC9B,aAAa,CAAC,CAAC,CAAC,EAAE,GAAG;IACrB,eAAe,CAAC,CAAC,CAAC,EAAE,GAAG;IACvB,oBAAoB,CAAC,CAAC,CAAC,EAAE,GAAG;IAC5B,mBAAmB,CAAC,CAAC,CAAC,EAAE,GAAG;IAC3B,cAAc,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,MAAM;IAC/B,yBAAyB,CAAC,CAAC,CAAC,EAAE,GAAG;IACjC,gBAAgB,CAAC,CAAC,CAAC,EAAE,GAAG;IACxB,aAAa,CAAC,CAAC,CAAC,EAAE,GAAG;IAE5B,sBAAsB;IACf,YAAY,GAAI,OAAO,GAAG,EAAE,eAAe,MAAM,KAAG,oBAAoB,CAuB9E;IAEM,mBAAmB,GAAI,SAAS,MAAM,KAAG,cAAc,GAAG,IAAI,CAyBpE;CACJ;AAED,eAAe,UAAU,CAAC"}

package/build/errors/errors.js

@@ -1,5 +1,152 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.ErrorCodes = exports.ErrorMessages = void 0;
+/**
+ * Centralized static error message strings.
+ * Keys mirror ErrorCodes — subclasses reference these instead of using inline string literals.
+ */
+exports.ErrorMessages = {
+    // BaseErrors
+    INTERNAL_SERVER: "Internal Server Error",
+    UNAUTHORIZED: "You are not authorized to perform this action",
+    // 400
+    REQUIRE_PARAMETER: "A required parameter is missing",
+    USER_NOT_FOUND: "User not found",
+    // 400
+    INVALID_VALUE: "One or more values provided are invalid",
+    // 400
+    INVALID_TOKEN_FORMAT: "Invalid authorization format. Expected: Bearer <token>",
+    // 400
+    RENEW_NOT_ALLOWED: "Your deposit address is not yet eligible for renewal",
+    // 400
+    VALIDATION_ERROR: "Request validation failed",
+    // 400
+    UNSUPPORTED_RESOURCE: "The requested resource is not supported",
+    // 400
+    INVALID_PAYMENT_TOKEN: "The payment token provided is not recognized",
+    // 400
+    UNEXPECTED_PAYMENT_TOKEN: "The selected payment token is not supported on this network",
+    // 400
+    NOT_FOUND: "The requested resource was not found",
+    CHAIN_CONFIG_NOT_SET: "Chain configuration is missing. Please contact support",
+    UNEXPECTED_ERROR: "An unexpected error occurred. Please try again later",
+    DATABASE_NOT_INITIALIZED: "Database connection is not available",
+    // 400
+    INVALID_USER_ID: "The provided user ID is invalid",
+    NO_PAYMENT_TOKENS: "No payment tokens are configured for this network",
+    SERVER_NOT_INITIALIZED: "Server is starting up. Please try again in a moment",
+    // 400
+    SERVER_NOT_RESPONDING: "The server is not responding. Please try again later",
+    // 400
+    INVALID_ADDRESS: "The provided address is invalid",
+    PAYMENT_REQUEST_NOT_APPROVED: "Payment request has not been approved",
+    // 400
+    REQUIRE_PAYMENT_ID: "Payment ID is required",
+    // 409
+    ADDRESS_EXISTS: "A deposit address already exists for this account",
+    // Admin / webhook
+    UNSUPPORTED_ALCHEMY_NETWORK: "The blockchain network is not supported by Alchemy",
+    FAILED_INITIALIZE_WEBHOOKS: "Failed to initialize webhooks. Please try again later",
+    // Database
+    SERVER_UNAVAILABLE: "Service is temporarily unavailable. Please try again later",
+    FAILED_GET_TRANSACTIONS: "Failed to retrieve transaction count. Please try again later",
+    // Alchemy / Voltage shared
+    INVOICE_SUBSCRIBER_ERROR: "Failed to subscribe to the invoice. Please try again",
+    // 400
+    REQUIRE_MIN_AMOUNT: "The amount is below the minimum required",
+    // 400
+    PAYMENT_ID_NOT_FOUND: "Invoice not found or expired. Please request a new one",
+    // 409
+    ALREADY_PAID_INVOICE: "This invoice has already been paid",
+    PAYMENT_FAILED: "Payment could not be processed. Please try again",
+    FAILED_WEBHOOK_ACTION: "A webhook operation failed. Please try again later",
+    ORM_REPO_NOT_INITIALIZED: "A required database repository is not initialized",
+    NO_WEBHOOKS: "No webhooks found for this subscription",
+    FAILED_GET_WEBHOOK_ADDRESSES: "Failed to retrieve webhook addresses. Please try again later",
+    // Wallet
+    // 409
+    PARENT_INDEX_IN_USE: "The selected wallet index is already in use",
+    // Transactions
+    // 409
+    REQUEST_NOT_APPROVED: "Withdrawal request has not been approved",
+    // 400
+    RECEIVER_REQUIRED: "Receiver address is missing. Please contact support",
+    // 400
+    UNEXPECTED_RECEIVER: "Please use the wallet address associated with your deposit",
+    // 409
+    DUPLICATE_CLAIM_JOB: "A claim for this request is already in progress. Please check back in a few minutes",
+    // 400
+    INVALID_WALLET_ADDRESS: "The wallet address provided is invalid",
+    // 409
+    REQUEST_FULFILLED: "This request has already been fulfilled",
+    // 400
+    WITHDRAW_REQUEST_NOT_FOUND: "Withdrawal request not found",
+    // 400
+    UNSUPPORTED_NETWORK: "The selected network is not supported",
+    // 400
+    UNSUPPORTED_ADDRESS: "The address format is not compatible with the selected network",
+    // 400
+    UNEXPECTED_ADDRESS_FORMAT: "The address does not match the expected format for the selected network",
+    // 400
+    EMPTY_PAYLOAD: "Request payload cannot be empty",
+    // 400
+    ONLY_STABLECOIN_WITHDRAWAL: "This network only supports stablecoin withdrawals",
+};
+exports.ErrorCodes = {
+    INTERNAL_SERVER: 'error.internal_server_error',
+    UNAUTHORIZED: 'error.unauthorized',
+    REQUIRE_PARAMETER: 'error.require_parameter',
+    USER_NOT_FOUND: 'error.user_not_found',
+    INVALID_VALUE: 'error.invalid_value',
+    INVALID_TOKEN_FORMAT: 'error.invalid_token_format',
+    RENEW_NOT_ALLOWED: 'error.renew_not_allowed',
+    VALIDATION_ERROR: 'error.validation_error',
+    UNSUPPORTED_RESOURCE: 'error.unsupported_resource',
+    INVALID_PAYMENT_TOKEN: 'error.invalid_payment_token',
+    UNEXPECTED_PAYMENT_TOKEN: 'error.unexpected_payment_token',
+    NOT_FOUND: 'error.not_found',
+    CHAIN_CONFIG_NOT_SET: 'error.chain_config_not_set',
+    UNEXPECTED_ERROR: 'error.unexpected_error',
+    DATABASE_NOT_INITIALIZED: 'error.database_not_initialized',
+    INVALID_USER_ID: 'error.invalid_user_id',
+    NO_PAYMENT_TOKENS: 'error.no_payment_tokens',
+    SERVER_NOT_INITIALIZED: 'error.server_not_initialized',
+    SERVER_NOT_RESPONDING: 'error.server_not_responding',
+    INVALID_ADDRESS: 'error.invalid_address',
+    PAYMENT_REQUEST_NOT_APPROVED: 'error.payment_request_not_approved',
+    REQUIRE_PAYMENT_ID: 'error.require_payment_id',
+    ADDRESS_EXISTS: 'error.address_exists',
+    // Admin / webhook
+    UNSUPPORTED_ALCHEMY_NETWORK: 'error.unsupported_alchemy_network',
+    FAILED_INITIALIZE_WEBHOOKS: 'error.failed_initialize_webhooks',
+    // Database
+    SERVER_UNAVAILABLE: 'error.server_unavailable',
+    FAILED_GET_TRANSACTIONS: 'error.failed_get_transactions',
+    ORM_REPO_NOT_INITIALIZED: 'error.orm_repo_not_initialized',
+    // Alchemy / Voltage shared
+    INVOICE_SUBSCRIBER_ERROR: 'error.invoice_subscriber_error',
+    REQUIRE_MIN_AMOUNT: 'error.require_min_amount',
+    PAYMENT_ID_NOT_FOUND: 'error.payment_id_not_found',
+    ALREADY_PAID_INVOICE: 'error.already_paid_invoice',
+    PAYMENT_FAILED: 'error.payment_failed',
+    FAILED_WEBHOOK_ACTION: 'error.failed_webhook_action',
+    NO_WEBHOOKS: 'error.no_webhooks',
+    FAILED_GET_WEBHOOK_ADDRESSES: 'error.failed_get_webhook_addresses',
+    // Wallet
+    PARENT_INDEX_IN_USE: 'error.parent_index_in_use',
+    // Transactions
+    REQUEST_NOT_APPROVED: 'error.request_not_approved',
+    RECEIVER_REQUIRED: 'error.receiver_required',
+    UNEXPECTED_RECEIVER: 'error.unexpected_receiver',
+    DUPLICATE_CLAIM_JOB: 'error.duplicate_claim_job',
+    REQUEST_FULFILLED: 'error.request_fulfilled',
+    WITHDRAW_REQUEST_NOT_FOUND: 'error.withdraw_request_not_found',
+    UNSUPPORTED_NETWORK: 'error.unsupported_network',
+    UNSUPPORTED_ADDRESS: 'error.unsupported_address',
+    UNEXPECTED_ADDRESS_FORMAT: 'error.unexpected_address_format',
+    EMPTY_PAYLOAD: 'error.empty_payload',
+    ONLY_STABLECOIN_WITHDRAWAL: 'error.only_stablecoin_withdrawal',
+};
 class BaseErrors {
     constructor() {
         this.codes = {
@@ -12,106 +159,123 @@ class BaseErrors {
             503: { code: 503, error: "Service Unavailable" }
         };
         /** Handler methods */
-        // Return status code, error, and message
         this.handle_error = (error, source_method) => {
             const result = {
                 status_code: 500,
+                source_method,
                 response: {
                     status: false,
                     message: "Unexpected error occured. Please try again later.",
+                    error_code: null,
                     data: {},
                     error: "Internal Server Error"
                 }
             };
-            let status = this.get_error_code_base(error.message);
+            const status = this.get_error_code_base(error.message);
             if (!status)
-                return Object.assign(Object.assign({}, result), { source_method });
+                return result;
             result.status_code = status.code;
-            result.response.message = status.code == 500 && !error.message ? "Unexpected error occured. Please try again later." : error.message;
+            result.response.message = status.code === 500 && !error.message
+                ? "Unexpected error occured. Please try again later."
+                : error.message;
             result.response.error = status.error;
-            return Object.assign(Object.assign({}, result), { source_method });
+            result.response.error_code = status.error_code;
+            return result;
         };
-        // Get the status code and error message
         this.get_error_code_base = (message) => {
-            if (message.includes("is required"))
-                return this.codes[400];
-            if (message.includes("Unauthorized"))
-                return this.codes[401];
-            if (message.includes("User not found"))
-                return this.codes[403];
+            if (message.includes("not authorized"))
+                return Object.assign(Object.assign({}, this.codes[401]), { error_code: exports.ErrorCodes.UNAUTHORIZED });
             if (message.includes("jwt expired"))
-                return this.codes[401];
-            if (message.includes("Token format is invalid. Use Bearer"))
-                return this.codes[400];
-            if (message.includes("You can only renew your deposit address when"))
-                return this.codes[400];
-            if (message.includes("Unsupported "))
-                return this.codes[400];
-            if (message.includes('Invalid payment token'))
-                return this.codes[400];
-            if (message.includes('not found'))
-                return this.codes[400];
-            if (message.includes('Payment tokens not found for specified network'))
-                return this.codes[502];
-            if (message.includes('The selected payment token is not supported by this network'))
-                return this.codes[400];
-            if (message.includes('Server bootstrapping in progress. Try again later.'))
-                return this.codes[503];
-            if (message.includes('server is not responding.'))
-                return this.codes[400];
-            if (message.includes('address is invalid'))
-                return this.codes[400];
-            if (message.includes("Invalid value for"))
-                return this.codes[400];
-            if (message.includes("Payment request not approved"))
-                return this.codes[401];
-            if (message.includes("'paymentId' is required"))
-                return this.codes[400];
-            if (message.includes("Deposit address already exists for user id"))
-                return this.codes[409];
-            if (message.includes("Chain configuration is not set"))
-                return this.codes[500];
+                return Object.assign(Object.assign({}, this.codes[401]), { error_code: exports.ErrorCodes.UNAUTHORIZED });
+            if (message.includes("required parameter is missing"))
+                return Object.assign(Object.assign({}, this.codes[400]), { error_code: exports.ErrorCodes.REQUIRE_PARAMETER });
+            if (message.includes("Payment ID is required"))
+                return Object.assign(Object.assign({}, this.codes[400]), { error_code: exports.ErrorCodes.REQUIRE_PAYMENT_ID });
+            if (message.includes("User not found"))
+                return Object.assign(Object.assign({}, this.codes[403]), { error_code: exports.ErrorCodes.USER_NOT_FOUND });
+            if (message.includes("values provided are invalid"))
+                return Object.assign(Object.assign({}, this.codes[400]), { error_code: exports.ErrorCodes.INVALID_VALUE });
+            if (message.includes("Invalid authorization format"))
+                return Object.assign(Object.assign({}, this.codes[400]), { error_code: exports.ErrorCodes.INVALID_TOKEN_FORMAT });
+            if (message.includes("not yet eligible for renewal"))
+                return Object.assign(Object.assign({}, this.codes[400]), { error_code: exports.ErrorCodes.RENEW_NOT_ALLOWED });
+            if (message.includes("Request validation failed"))
+                return Object.assign(Object.assign({}, this.codes[400]), { error_code: exports.ErrorCodes.VALIDATION_ERROR });
+            if (message.includes("resource is not supported"))
+                return Object.assign(Object.assign({}, this.codes[400]), { error_code: exports.ErrorCodes.UNSUPPORTED_RESOURCE });
+            if (message.includes("payment token provided is not recognized"))
+                return Object.assign(Object.assign({}, this.codes[400]), { error_code: exports.ErrorCodes.INVALID_PAYMENT_TOKEN });
+            if (message.includes("not supported on this network"))
+                return Object.assign(Object.assign({}, this.codes[400]), { error_code: exports.ErrorCodes.UNEXPECTED_PAYMENT_TOKEN });
+            if (message.includes("resource was not found"))
+                return Object.assign(Object.assign({}, this.codes[400]), { error_code: exports.ErrorCodes.NOT_FOUND });
+            if (message.includes("Chain configuration is missing"))
+                return Object.assign(Object.assign({}, this.codes[500]), { error_code: exports.ErrorCodes.CHAIN_CONFIG_NOT_SET });
+            if (message.includes("unexpected error occurred"))
+                return Object.assign(Object.assign({}, this.codes[500]), { error_code: exports.ErrorCodes.UNEXPECTED_ERROR });
+            if (message.includes("Database connection is not available"))
+                return Object.assign(Object.assign({}, this.codes[500]), { error_code: exports.ErrorCodes.DATABASE_NOT_INITIALIZED });
+            if (message.includes("user ID is invalid"))
+                return Object.assign(Object.assign({}, this.codes[400]), { error_code: exports.ErrorCodes.INVALID_USER_ID });
+            if (message.includes("No payment tokens are configured"))
+                return Object.assign(Object.assign({}, this.codes[502]), { error_code: exports.ErrorCodes.NO_PAYMENT_TOKENS });
+            if (message.includes("Server is starting up"))
+                return Object.assign(Object.assign({}, this.codes[503]), { error_code: exports.ErrorCodes.SERVER_NOT_INITIALIZED });
+            if (message.includes("server is not responding"))
+                return Object.assign(Object.assign({}, this.codes[400]), { error_code: exports.ErrorCodes.SERVER_NOT_RESPONDING });
+            if (message.includes("provided address is invalid"))
+                return Object.assign(Object.assign({}, this.codes[400]), { error_code: exports.ErrorCodes.INVALID_ADDRESS });
+            if (message.includes("Payment request has not been approved"))
+                return Object.assign(Object.assign({}, this.codes[401]), { error_code: exports.ErrorCodes.PAYMENT_REQUEST_NOT_APPROVED });
+            if (message.includes("deposit address already exists"))
+                return Object.assign(Object.assign({}, this.codes[409]), { error_code: exports.ErrorCodes.ADDRESS_EXISTS });
             return null;
         };
     }
-    /** Error Definition */
-    Unauthorized() { return "Unauthorized"; }
+    /** Error definitions — unchanged, backward compatible */
+    Unauthorized(_) { return exports.ErrorMessages.UNAUTHORIZED; }
+    ;
+    RequireParameter(_) { return exports.ErrorMessages.REQUIRE_PARAMETER; }
+    ;
+    NotFoundUser(_) { return exports.ErrorMessages.USER_NOT_FOUND; }
+    ;
+    InvalidValue(_, __) { return exports.ErrorMessages.INVALID_VALUE; }
+    ;
+    InvalidTokenFormat(_) { return exports.ErrorMessages.INVALID_TOKEN_FORMAT; }
+    ;
+    RenewNotAllowed(_, __) { return exports.ErrorMessages.RENEW_NOT_ALLOWED; }
+    ;
+    ValidationError(_) { return exports.ErrorMessages.VALIDATION_ERROR; }
     ;
-    RequireParameter(key) { return `${key} is required`; }
+    UnsupportedResource(_) { return exports.ErrorMessages.UNSUPPORTED_RESOURCE; }
     ;
-    NotFoundUser() { return `User not found`; }
+    InvalidPaymentToken(_) { return exports.ErrorMessages.INVALID_PAYMENT_TOKEN; }
     ;
-    InvalidValue(name, context) { return `Invalid value for ${name}${context ? `: ${context}` : ""}`; }
+    UnexpectedPaymentToken(_) { return exports.ErrorMessages.UNEXPECTED_PAYMENT_TOKEN; }
     ;
-    InvalidTokenFormat() { return "Token format is invalid. Use Bearer {token}"; }
+    NotFound(_) { return exports.ErrorMessages.NOT_FOUND; }
     ;
-    RenewNotAllowed(remaining_duration_s, remaining_threshold_s) { return `You can only renew your deposit address when it has less than ${remaining_threshold_s / 60} minutes remaining before expiry.`; }
-    ValidationError(validation_type) { return `Failed while validating ${validation_type}`; }
+    ChainConfigNotSet(_) { return exports.ErrorMessages.CHAIN_CONFIG_NOT_SET; }
     ;
-    UnsupportedResource(target) { return `Unsupported ${target}`; }
+    UnexpectedError(_) { return exports.ErrorMessages.UNEXPECTED_ERROR; }
     ;
-    InvalidPaymentToken(token) { return `Invalid payment token ${token}`; }
+    NotInitializedDatabase(_) { return exports.ErrorMessages.DATABASE_NOT_INITIALIZED; }
     ;
-    UnexpectedPaymentToken() { return `The selected payment token is not supported by this network.`; }
-    NotFound(resource_name) { return `${resource_name} not found`; }
+    InvalidUserId(_) { return exports.ErrorMessages.INVALID_USER_ID; }
     ;
-    ChainConfigNotSet() { return `Chain configuration is not set. Ensure the config file is created and exists in storage service.`; }
+    NoPaymentTokens(_) { return exports.ErrorMessages.NO_PAYMENT_TOKENS; }
     ;
-    UnexpectedError(details) { return `Unexpected error occured${details ? ":" : "."} ${details ? details : ""}`; }
-    NotInitializedDatabase() { return "Database driver is not initialized."; }
+    NotInitializedServer(_) { return exports.ErrorMessages.SERVER_NOT_INITIALIZED; }
     ;
-    InvalidUserId(id) { return `Invalid user id: ${id}`; }
+    ServerNotResponding(_) { return exports.ErrorMessages.SERVER_NOT_RESPONDING; }
     ;
-    NoPaymentTokens() { return `Payment tokens not found for specified network.`; }
+    InvalidAddress(_) { return exports.ErrorMessages.INVALID_ADDRESS; }
     ;
-    NotInitializedServer() { return `Server bootstrapping in progress. Try again later.`; }
-    ServerNotResponding() { return `The provided server is not responding. Please ensure the server is accepting HTTP requests.`; }
-    InvalidAddress(target) { return `The provided ${target} address is invalid`; }
-    NotApprovedPaymentRequest() { return "Payment request not approved"; }
+    NotApprovedPaymentRequest(_) { return exports.ErrorMessages.PAYMENT_REQUEST_NOT_APPROVED; }
     ;
-    RequirePaymentId() { return "'paymentId' is required"; }
+    RequirePaymentId(_) { return exports.ErrorMessages.REQUIRE_PAYMENT_ID; }
     ;
-    AddressExists() { return "Deposit address already exists for user id"; }
+    AddressExists(_) { return exports.ErrorMessages.ADDRESS_EXISTS; }
     ;
 }
 exports.default = BaseErrors;