@n1xyz/wallet-widget 0.0.35-alpha.0 → 0.0.35-alpha.1

package/dist/src/features/onboarding-flow/errors/depositError.js

@@ -0,0 +1,134 @@
+var __extends = (this && this.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+import { BridgeAssistError } from '../bridge-assist/types';
+export var DepositErrorCode;
+(function (DepositErrorCode) {
+    DepositErrorCode["USER_REJECTED"] = "USER_REJECTED";
+    DepositErrorCode["WALLET_NOT_READY"] = "WALLET_NOT_READY";
+    DepositErrorCode["WALLET_NOT_CONNECTED"] = "WALLET_NOT_CONNECTED";
+    DepositErrorCode["WRONG_WALLET_CHAIN"] = "WRONG_WALLET_CHAIN";
+    DepositErrorCode["INVALID_AMOUNT"] = "INVALID_AMOUNT";
+    DepositErrorCode["BELOW_MINIMUM_DEPOSIT"] = "BELOW_MINIMUM_DEPOSIT";
+    DepositErrorCode["INSUFFICIENT_BALANCE"] = "INSUFFICIENT_BALANCE";
+    DepositErrorCode["INSUFFICIENT_FEES"] = "INSUFFICIENT_FEES";
+    DepositErrorCode["NETWORK_ERROR"] = "NETWORK_ERROR";
+    DepositErrorCode["ATTESTATION_NOT_READY"] = "ATTESTATION_NOT_READY";
+    DepositErrorCode["ATTESTATION_TIMEOUT"] = "ATTESTATION_TIMEOUT";
+    DepositErrorCode["BRIDGE_ASSIST_NOT_FOUND"] = "BRIDGE_ASSIST_NOT_FOUND";
+    DepositErrorCode["BRIDGE_ASSIST_CONFLICT"] = "BRIDGE_ASSIST_CONFLICT";
+    DepositErrorCode["BRIDGE_ASSIST_RATE_LIMITED"] = "BRIDGE_ASSIST_RATE_LIMITED";
+    DepositErrorCode["BRIDGE_ASSIST_UNAUTHORIZED"] = "BRIDGE_ASSIST_UNAUTHORIZED";
+    DepositErrorCode["CLAIM_SUBMISSION_FAILED"] = "CLAIM_SUBMISSION_FAILED";
+    DepositErrorCode["BRIDGE_SUBMISSION_FAILED"] = "BRIDGE_SUBMISSION_FAILED";
+    DepositErrorCode["NORD_DEPOSIT_FAILED"] = "NORD_DEPOSIT_FAILED";
+    DepositErrorCode["UNKNOWN"] = "UNKNOWN";
+})(DepositErrorCode || (DepositErrorCode = {}));
+var DepositError = /** @class */ (function (_super) {
+    __extends(DepositError, _super);
+    function DepositError(code, message, retryable, userMessage, details, cause) {
+        var _this = _super.call(this, message) || this;
+        _this.code = code;
+        _this.retryable = retryable;
+        _this.userMessage = userMessage;
+        _this.details = details;
+        _this.cause = cause;
+        _this.name = 'DepositError';
+        return _this;
+    }
+    return DepositError;
+}(Error));
+export { DepositError };
+var msg = function (e) {
+    return e instanceof Error ? e.message : e == null ? '' : String(e);
+};
+var includesAny = function (haystack, needles) {
+    return needles.some(function (n) { return haystack.includes(n); });
+};
+/**
+ * Normalizes unknown errors into a stable taxonomy.
+ * This is the single source of truth for: retryability, user-safe copy, and structured metadata.
+ */
+export var toDepositError = function (error, context) {
+    if (error instanceof DepositError)
+        return error;
+    var rawMessage = msg(error);
+    var lower = rawMessage.toLowerCase();
+    // Bridge Assist HTTP-ish errors
+    if (error instanceof BridgeAssistError) {
+        var status_1 = error.status;
+        if (status_1 === 404) {
+            return new DepositError(DepositErrorCode.BRIDGE_ASSIST_NOT_FOUND, rawMessage, true, 'Deposit record was not found yet. Retrying…', __assign(__assign({}, context), { status: status_1 }), error);
+        }
+        if (status_1 === 409) {
+            return new DepositError(DepositErrorCode.BRIDGE_ASSIST_CONFLICT, rawMessage, false, 'This deposit conflicted with an existing request. Please start a new deposit.', __assign(__assign({}, context), { status: status_1 }), error);
+        }
+        if (status_1 === 429) {
+            return new DepositError(DepositErrorCode.BRIDGE_ASSIST_RATE_LIMITED, rawMessage, true, 'Service is busy. Please retry in a moment.', __assign(__assign({}, context), { status: status_1, retryAfter: error.retryAfter }), error);
+        }
+        if (status_1 === 401 || status_1 === 403) {
+            return new DepositError(DepositErrorCode.BRIDGE_ASSIST_UNAUTHORIZED, rawMessage, false, 'Request was rejected. Please reconnect your wallet and try again.', __assign(__assign({}, context), { status: status_1 }), error);
+        }
+    }
+    // Wallet / user intent
+    if (includesAny(lower, ['user rejected', 'user denied', 'rejected the request', 'denied transaction'])) {
+        return new DepositError(DepositErrorCode.USER_REJECTED, rawMessage, false, 'You rejected the transaction. Please approve to continue.', context, error);
+    }
+    // Minimum / amount validation (e.g. Nord min deposit)
+    if (includesAny(lower, ['less than the minimum deposit', 'minimum deposit'])) {
+        return new DepositError(DepositErrorCode.BELOW_MINIMUM_DEPOSIT, rawMessage, false, rawMessage, // already user-friendly in most cases
+        context, error);
+    }
+    if (includesAny(lower, ['invalid amount', 'amount must be', 'amount is required'])) {
+        return new DepositError(DepositErrorCode.INVALID_AMOUNT, rawMessage, false, 'Enter a valid amount to continue.', context, error);
+    }
+    // Retryable on-chain / network-ish failures
+    if (includesAny(lower, ['blockhash expired', 'blockhash not found'])) {
+        return new DepositError(DepositErrorCode.CLAIM_SUBMISSION_FAILED, rawMessage, true, 'Transaction expired. Retrying…', context, error);
+    }
+    if (includesAny(lower, ['fee payer not available', 'server fee payer not available', 'fee payer'])) {
+        return new DepositError(DepositErrorCode.NETWORK_ERROR, rawMessage, true, 'Claim server is not available. Retrying…', context, error);
+    }
+    if (includesAny(lower, ['bridge assist server is not available', 'server is not available', 'failed to fetch'])) {
+        return new DepositError(DepositErrorCode.NETWORK_ERROR, rawMessage, true, 'Claim server is not available. Retrying…', context, error);
+    }
+    if (includesAny(lower, ['timed out', 'timeout', 'transaction was not confirmed'])) {
+        return new DepositError(DepositErrorCode.NETWORK_ERROR, rawMessage, true, 'Network is taking too long to respond. Retrying…', context, error);
+    }
+    // Balance / allowance
+    if (lower.includes('insufficient')) {
+        return new DepositError(DepositErrorCode.INSUFFICIENT_BALANCE, rawMessage, false, 'Insufficient balance or allowance to complete the deposit.', context, error);
+    }
+    // Attestation signals
+    if (includesAny(lower, ['attestation not ready'])) {
+        return new DepositError(DepositErrorCode.ATTESTATION_NOT_READY, rawMessage, true, 'Attestation not ready yet. Please wait a moment and try again.', context, error);
+    }
+    if (includesAny(lower, ['attestation timeout'])) {
+        return new DepositError(DepositErrorCode.ATTESTATION_TIMEOUT, rawMessage, true, 'Bridge confirmation is taking too long. Please retry.', context, error);
+    }
+    return new DepositError(DepositErrorCode.UNKNOWN, rawMessage || 'Unknown error', false, rawMessage || 'Something went wrong. Please try again.', context, error);
+};
+//# sourceMappingURL=depositError.js.map

package/dist/src/features/onboarding-flow/errors/depositError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"depositError.js","sourceRoot":"","sources":["../../../../../src/features/onboarding-flow/errors/depositError.ts"],"names":[],"mappings":"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","sourcesContent":["import { BridgeAssistError } from '../bridge-assist/types';\n\nexport enum DepositErrorCode {\n  USER_REJECTED = 'USER_REJECTED',\n  WALLET_NOT_READY = 'WALLET_NOT_READY',\n  WALLET_NOT_CONNECTED = 'WALLET_NOT_CONNECTED',\n  WRONG_WALLET_CHAIN = 'WRONG_WALLET_CHAIN',\n  INVALID_AMOUNT = 'INVALID_AMOUNT',\n  BELOW_MINIMUM_DEPOSIT = 'BELOW_MINIMUM_DEPOSIT',\n  INSUFFICIENT_BALANCE = 'INSUFFICIENT_BALANCE',\n  INSUFFICIENT_FEES = 'INSUFFICIENT_FEES',\n  NETWORK_ERROR = 'NETWORK_ERROR',\n  ATTESTATION_NOT_READY = 'ATTESTATION_NOT_READY',\n  ATTESTATION_TIMEOUT = 'ATTESTATION_TIMEOUT',\n  BRIDGE_ASSIST_NOT_FOUND = 'BRIDGE_ASSIST_NOT_FOUND',\n  BRIDGE_ASSIST_CONFLICT = 'BRIDGE_ASSIST_CONFLICT',\n  BRIDGE_ASSIST_RATE_LIMITED = 'BRIDGE_ASSIST_RATE_LIMITED',\n  BRIDGE_ASSIST_UNAUTHORIZED = 'BRIDGE_ASSIST_UNAUTHORIZED',\n  CLAIM_SUBMISSION_FAILED = 'CLAIM_SUBMISSION_FAILED',\n  BRIDGE_SUBMISSION_FAILED = 'BRIDGE_SUBMISSION_FAILED',\n  NORD_DEPOSIT_FAILED = 'NORD_DEPOSIT_FAILED',\n  UNKNOWN = 'UNKNOWN',\n}\n\nexport type DepositErrorDetails = Record<string, unknown>;\n\nexport class DepositError extends Error {\n  public readonly name = 'DepositError';\n\n  constructor(\n    public readonly code: DepositErrorCode,\n    message: string,\n    public readonly retryable: boolean,\n    public readonly userMessage: string,\n    public readonly details?: DepositErrorDetails,\n    public readonly cause?: unknown,\n  ) {\n    super(message);\n  }\n}\n\nconst msg = (e: unknown): string =>\n  e instanceof Error ? e.message : e == null ? '' : String(e);\n\nconst includesAny = (haystack: string, needles: string[]) =>\n  needles.some((n) => haystack.includes(n));\n\n/**\n * Normalizes unknown errors into a stable taxonomy.\n * This is the single source of truth for: retryability, user-safe copy, and structured metadata.\n */\nexport const toDepositError = (\n  error: unknown,\n  context?: DepositErrorDetails,\n): DepositError => {\n  if (error instanceof DepositError) return error;\n\n  const rawMessage = msg(error);\n  const lower = rawMessage.toLowerCase();\n\n  // Bridge Assist HTTP-ish errors\n  if (error instanceof BridgeAssistError) {\n    const status = error.status;\n    if (status === 404) {\n      return new DepositError(\n        DepositErrorCode.BRIDGE_ASSIST_NOT_FOUND,\n        rawMessage,\n        true,\n        'Deposit record was not found yet. Retrying…',\n        { ...context, status },\n        error,\n      );\n    }\n    if (status === 409) {\n      return new DepositError(\n        DepositErrorCode.BRIDGE_ASSIST_CONFLICT,\n        rawMessage,\n        false,\n        'This deposit conflicted with an existing request. Please start a new deposit.',\n        { ...context, status },\n        error,\n      );\n    }\n    if (status === 429) {\n      return new DepositError(\n        DepositErrorCode.BRIDGE_ASSIST_RATE_LIMITED,\n        rawMessage,\n        true,\n        'Service is busy. Please retry in a moment.',\n        { ...context, status, retryAfter: error.retryAfter },\n        error,\n      );\n    }\n    if (status === 401 || status === 403) {\n      return new DepositError(\n        DepositErrorCode.BRIDGE_ASSIST_UNAUTHORIZED,\n        rawMessage,\n        false,\n        'Request was rejected. Please reconnect your wallet and try again.',\n        { ...context, status },\n        error,\n      );\n    }\n  }\n\n  // Wallet / user intent\n  if (includesAny(lower, ['user rejected', 'user denied', 'rejected the request', 'denied transaction'])) {\n    return new DepositError(\n      DepositErrorCode.USER_REJECTED,\n      rawMessage,\n      false,\n      'You rejected the transaction. Please approve to continue.',\n      context,\n      error,\n    );\n  }\n\n  // Minimum / amount validation (e.g. Nord min deposit)\n  if (includesAny(lower, ['less than the minimum deposit', 'minimum deposit'])) {\n    return new DepositError(\n      DepositErrorCode.BELOW_MINIMUM_DEPOSIT,\n      rawMessage,\n      false,\n      rawMessage, // already user-friendly in most cases\n      context,\n      error,\n    );\n  }\n\n  if (includesAny(lower, ['invalid amount', 'amount must be', 'amount is required'])) {\n    return new DepositError(\n      DepositErrorCode.INVALID_AMOUNT,\n      rawMessage,\n      false,\n      'Enter a valid amount to continue.',\n      context,\n      error,\n    );\n  }\n\n  // Retryable on-chain / network-ish failures\n  if (includesAny(lower, ['blockhash expired', 'blockhash not found'])) {\n    return new DepositError(\n      DepositErrorCode.CLAIM_SUBMISSION_FAILED,\n      rawMessage,\n      true,\n      'Transaction expired. Retrying…',\n      context,\n      error,\n    );\n  }\n\n  if (includesAny(lower, ['fee payer not available', 'server fee payer not available', 'fee payer'])) {\n    return new DepositError(\n      DepositErrorCode.NETWORK_ERROR,\n      rawMessage,\n      true,\n      'Claim server is not available. Retrying…',\n      context,\n      error,\n    );\n  }\n\n  if (includesAny(lower, ['bridge assist server is not available', 'server is not available', 'failed to fetch'])) {\n    return new DepositError(\n      DepositErrorCode.NETWORK_ERROR,\n      rawMessage,\n      true,\n      'Claim server is not available. Retrying…',\n      context,\n      error,\n    );\n  }\n\n  if (includesAny(lower, ['timed out', 'timeout', 'transaction was not confirmed'])) {\n    return new DepositError(\n      DepositErrorCode.NETWORK_ERROR,\n      rawMessage,\n      true,\n      'Network is taking too long to respond. Retrying…',\n      context,\n      error,\n    );\n  }\n\n  // Balance / allowance\n  if (lower.includes('insufficient')) {\n    return new DepositError(\n      DepositErrorCode.INSUFFICIENT_BALANCE,\n      rawMessage,\n      false,\n      'Insufficient balance or allowance to complete the deposit.',\n      context,\n      error,\n    );\n  }\n\n  // Attestation signals\n  if (includesAny(lower, ['attestation not ready'])) {\n    return new DepositError(\n      DepositErrorCode.ATTESTATION_NOT_READY,\n      rawMessage,\n      true,\n      'Attestation not ready yet. Please wait a moment and try again.',\n      context,\n      error,\n    );\n  }\n\n  if (includesAny(lower, ['attestation timeout'])) {\n    return new DepositError(\n      DepositErrorCode.ATTESTATION_TIMEOUT,\n      rawMessage,\n      true,\n      'Bridge confirmation is taking too long. Please retry.',\n      context,\n      error,\n    );\n  }\n\n  return new DepositError(\n    DepositErrorCode.UNKNOWN,\n    rawMessage || 'Unknown error',\n    false,\n    rawMessage || 'Something went wrong. Please try again.',\n    context,\n    error,\n  );\n};\n\n\n"]}

package/dist/src/features/onboarding-flow/hooks/useBridgeDeposit.d.ts

@@ -0,0 +1,35 @@
+import { createPendingDepositDraft, PendingDepositState } from '../utils/deposit/storage';
+interface UseBridgeDepositProps {
+    setDepositProgressPhase: (phase: 'bridge' | 'claim' | 'solana' | 'nord') => void;
+    setPendingBridgeTx: (tx: string | null) => void;
+    setPendingMintTx: (tx: string | null) => void;
+    setPendingDepositId: (id: string | null) => void;
+    setPendingBridgeExplorerUrl: (url: string | null) => void;
+    ensurePendingDraft: (amount: string) => ReturnType<typeof createPendingDepositDraft>;
+    finalizeBridgeSuccess: (status: {
+        tx?: string | null;
+        mintTx?: string | null;
+        bridgeTx?: string | null;
+        solanaTx?: string | null;
+        depositId?: string | null;
+    }) => void;
+    setIsDepositing: (isDepositing: boolean) => void;
+    runSolanaDeposit: (amount: string, pendingState?: ReturnType<typeof createPendingDepositDraft> | null) => Promise<{
+        txId: string | null;
+        workingState: ReturnType<typeof createPendingDepositDraft>;
+        solanaTx: string | null;
+    }>;
+}
+export declare const useBridgeDeposit: ({ setDepositProgressPhase, setPendingBridgeTx, setPendingMintTx, setPendingDepositId, setPendingBridgeExplorerUrl, ensurePendingDraft, finalizeBridgeSuccess, setIsDepositing, runSolanaDeposit, }: UseBridgeDepositProps) => {
+    startCctpBridge: (draftAmount: string) => Promise<PendingDepositState>;
+    resumeClaimProcess: (pendingState: PendingDepositState) => Promise<void>;
+    bridgeRetryable: boolean;
+    setBridgeRetryable: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    bridgeError: string | null;
+    setBridgeError: import("react").Dispatch<import("react").SetStateAction<string | null>>;
+    bridgeApprovalPending: boolean;
+    setBridgeApprovalPending: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    bridgeApprovalError: string | null;
+    setBridgeApprovalError: import("react").Dispatch<import("react").SetStateAction<string | null>>;
+};
+export {};