@heliofi/withdraw-core 0.0.1 → 0.0.2

package/README.md

@@ -0,0 +1,12 @@
+# @heliofi/withdraw-core
+
+Core JS/TS SDK for MoonPay Commerce withdrawals — routes, quotes, balance checks, and transaction submission.
+
+## Install guide
+
+```bash
+npm install @heliofi/withdraw-core
+yarn add @heliofi/withdraw-core
+pnpm add @heliofi/withdraw-core
+```
+

package/dist/errors/WithdrawalApiError.d.ts

@@ -0,0 +1,9 @@
+import { WithdrawalErrorCode } from '../types/enums';
+export declare class WithdrawalApiError extends Error {
+    readonly status: number;
+    readonly code: WithdrawalErrorCode;
+    readonly detail?: string | undefined;
+    readonly name = "WithdrawalApiError";
+    constructor(status: number, code: WithdrawalErrorCode, detail?: string | undefined);
+}
+export declare const toWithdrawalErrorCode: (raw: string | undefined) => WithdrawalErrorCode;

package/dist/errors/index.d.ts

@@ -0,0 +1 @@
+export { toWithdrawalErrorCode, WithdrawalApiError, } from './WithdrawalApiError';

package/dist/index.d.ts

@@ -1 +1,7 @@
-export declare const VERSION = "0.0.1";
+export { toWithdrawalErrorCode, WithdrawalApiError, } from './errors';
+export type { WithdrawalJwtPayload } from './jwt';
+export { decodeJwt, isQuoteExpired } from './jwt';
+export type { ApiClientConfig } from './sdk';
+export { WithdrawalSDK } from './sdk';
+export type { BalanceResponse, BaseBlockchain, PolymarketWalletPreparedTransaction, PreparedTransaction, PrepareWithdrawalParams, QuoteResponse, QuoteSummary, RawPreparedTransaction, RoutesResponse, SlimCurrencyWithBlockchain, StatusResponse, SubmitResponse, SubmitWithdrawalParams, UpdateQuoteParams, UserOpPreparedTransaction, WalletCurrencyBalance, WithdrawalConfig, WithdrawalCurrenciesExchangeRate, WithdrawalCustomerSwapRoute, } from './types';
+export { BroadcastAck, SignedTransactionKind, TERMINAL_STATES, WithdrawalErrorCode, WithdrawalState, WithdrawBlockchainSymbol, WithdrawFeature, WithdrawPlatform, } from './types';

package/dist/jwt.d.ts

@@ -0,0 +1,8 @@
+export interface WithdrawalJwtPayload {
+    exp?: number;
+    iat?: number;
+    withdrawalDetailId?: string;
+    [key: string]: unknown;
+}
+export declare const decodeJwt: (jwt: string) => WithdrawalJwtPayload;
+export declare const isQuoteExpired: (jwt: string, bufferMs?: number) => boolean;

package/dist/sdk/ApiClient.d.ts

@@ -0,0 +1,16 @@
+export interface ApiClientConfig {
+    baseUrl: string;
+    headers?: Record<string, string>;
+    fetch?: typeof globalThis.fetch;
+}
+export declare class ApiClient {
+    private readonly baseUrl;
+    private readonly headers;
+    private readonly fetch;
+    constructor(config: ApiClientConfig);
+    get<T>(path: string, signal?: AbortSignal): Promise<T>;
+    post<T>(path: string, body: unknown, signal?: AbortSignal): Promise<T>;
+    patch<T>(path: string, body: unknown, signal?: AbortSignal): Promise<T>;
+    private request;
+    private buildError;
+}

package/dist/sdk/WithdrawalSDK.d.ts

@@ -0,0 +1,31 @@
+import type { QuoteResponse } from '../types/prepared';
+import type { PrepareWithdrawalParams, SubmitWithdrawalParams, UpdateQuoteParams } from '../types/requests';
+import type { BalanceResponse, RoutesResponse, StatusResponse, SubmitResponse, WithdrawalConfig } from '../types/responses';
+import { type ApiClientConfig } from './ApiClient';
+export declare class WithdrawalSDK {
+    private readonly api;
+    constructor(config: ApiClientConfig);
+    getWithdrawalConfig(withdrawalConfigId: string, signal?: AbortSignal): Promise<WithdrawalConfig>;
+    getRoutes(withdrawalConfigId: string, signal?: AbortSignal): Promise<RoutesResponse>;
+    getBalance(withdrawalConfigId: string, walletAddress: string, signal?: AbortSignal): Promise<BalanceResponse>;
+    /**
+     * Calls `POST /withdraw/:withdrawalConfigId/prepare`.
+     * `withdrawalConfigId` goes in the path; the remaining fields are the
+     * request body matching the backend `PreparedWithdrawalDto`.
+     */
+    prepare(params: PrepareWithdrawalParams, signal?: AbortSignal): Promise<QuoteResponse>;
+    /**
+     * Update an existing quote.
+     *
+     * NOTE: The backend does not yet expose a PATCH endpoint for prepare.
+     * This stub is kept for forward compatibility. It will throw until
+     * the backend ships the handler.
+     */
+    updateQuote(_withdrawalDetailId: string, _params: UpdateQuoteParams, _signal?: AbortSignal): Promise<QuoteResponse>;
+    /**
+     * Body matches the backend `SubmitWithdrawalDto`:
+     * `{ token, signedTx }`, where `signedTx` is the bare signed payload string.
+     */
+    submitWithdrawal(params: SubmitWithdrawalParams, signal?: AbortSignal): Promise<SubmitResponse>;
+    getWithdrawalDetail(withdrawalDetailId: string, signal?: AbortSignal): Promise<StatusResponse>;
+}

package/dist/sdk/index.d.ts

@@ -0,0 +1,2 @@
+export type { ApiClientConfig } from './ApiClient';
+export { WithdrawalSDK } from './WithdrawalSDK';

package/dist/types/enums.d.ts

@@ -0,0 +1,66 @@
+export declare enum WithdrawalState {
+    QUOTED = "QUOTED",
+    SUBMITTING = "SUBMITTING",
+    SUBMITTED = "SUBMITTED",
+    BRIDGING = "BRIDGING",
+    COMPLETED = "COMPLETED",
+    FAILED = "FAILED",
+    FAILED_EXPIRED = "FAILED_EXPIRED",
+    EXPIRED = "EXPIRED",
+    REFUNDED_BY_PROVIDER = "REFUNDED_BY_PROVIDER"
+}
+export declare const TERMINAL_STATES: ReadonlySet<WithdrawalState>;
+export declare enum WithdrawalErrorCode {
+    WITHDRAW_TX_INVALID_SIGNATURE = "WITHDRAW_TX_INVALID_SIGNATURE",
+    WITHDRAW_TX_BLOCKHASH_EXPIRED = "WITHDRAW_TX_BLOCKHASH_EXPIRED",
+    WITHDRAW_TX_NONCE_TOO_LOW = "WITHDRAW_TX_NONCE_TOO_LOW",
+    WITHDRAW_TX_USEROP_EXPIRED = "WITHDRAW_TX_USEROP_EXPIRED",
+    WITHDRAW_TX_UNDERPRICED = "WITHDRAW_TX_UNDERPRICED",
+    WITHDRAW_BUNDLER_REJECTED = "WITHDRAW_BUNDLER_REJECTED",
+    WITHDRAW_TX_BROADCAST_TIMEOUT = "WITHDRAW_TX_BROADCAST_TIMEOUT",
+    WITHDRAW_TX_ALREADY_KNOWN = "WITHDRAW_TX_ALREADY_KNOWN",
+    WITHDRAW_QUOTE_EXPIRED = "WITHDRAW_QUOTE_EXPIRED",
+    WITHDRAW_SANCTIONS_BLOCKED = "WITHDRAW_SANCTIONS_BLOCKED",
+    WITHDRAW_NO_ROUTE = "WITHDRAW_NO_ROUTE",
+    WITHDRAW_NOT_FOUND = "WITHDRAW_NOT_FOUND",
+    WITHDRAW_INSUFFICIENT_BALANCE = "WITHDRAW_INSUFFICIENT_BALANCE",
+    WITHDRAW_DETAILS_NOT_UPDATABLE = "WITHDRAW_DETAILS_NOT_UPDATABLE",
+    INVALID_WALLET_ADDRESS = "INVALID_WALLET_ADDRESS",
+    BALANCE_FETCH_FAILED = "BALANCE_FETCH_FAILED",
+    UNKNOWN = "UNKNOWN"
+}
+export declare enum BroadcastAck {
+    ACKNOWLEDGED = "acknowledged",
+    UNACKNOWLEDGED = "unacknowledged",
+    REJECTED = "rejected"
+}
+export declare enum SignedTransactionKind {
+    RAW = "raw",
+    USER_OP = "userop",
+    POLYMARKET_WALLET = "polymarket_wallet"
+}
+/** Mirror of backend `Platform` (packages/common/.../constants/platform.ts). */
+export declare enum WithdrawPlatform {
+    HELIO = "HELIO",
+    MAGIC_EDEN = "MAGIC_EDEN"
+}
+/** Mirror of backend `WithdrawalFeature` (.../withdraw/constants/WithdrawalFeature.ts). */
+export declare enum WithdrawFeature {
+    IRON = "iron",
+    MP_SELL = "mp_sell"
+}
+/**
+ * Mirror of backend `BlockchainSymbol`
+ * (.../blockchain/constants/BlockchainSymbol.ts) — withdraw-supported chains.
+ */
+export declare enum WithdrawBlockchainSymbol {
+    SOL = "SOL",
+    ETH = "ETH",
+    POLYGON = "POLYGON",
+    BASE = "BASE",
+    BITCOIN = "BITCOIN",
+    ARBITRUM = "ARBITRUM",
+    BSC = "BSC",
+    TRON = "TRON",
+    DOGE = "DOGE"
+}

package/dist/types/index.d.ts

@@ -0,0 +1,4 @@
+export { BroadcastAck, SignedTransactionKind, TERMINAL_STATES, WithdrawalErrorCode, WithdrawalState, WithdrawBlockchainSymbol, WithdrawFeature, WithdrawPlatform, } from './enums';
+export type { PolymarketWalletPreparedTransaction, PreparedTransaction, QuoteResponse, QuoteSummary, RawPreparedTransaction, UserOpPreparedTransaction, } from './prepared';
+export type { PrepareWithdrawalParams, SubmitWithdrawalParams, UpdateQuoteParams, } from './requests';
+export type { BalanceResponse, BaseBlockchain, RoutesResponse, SlimCurrencyWithBlockchain, StatusResponse, SubmitResponse, WalletCurrencyBalance, WithdrawalConfig, WithdrawalCurrenciesExchangeRate, WithdrawalCustomerSwapRoute, } from './responses';

package/dist/types/prepared.d.ts

@@ -0,0 +1,31 @@
+import type { SignedTransactionKind } from './enums';
+export interface PolymarketWalletPreparedTransaction {
+    kind: SignedTransactionKind.POLYMARKET_WALLET;
+    typedData: Record<string, unknown>;
+}
+export interface RawPreparedTransaction {
+    kind: SignedTransactionKind.RAW;
+    chain: string;
+    unsignedTx: string;
+}
+export interface UserOpPreparedTransaction {
+    kind: SignedTransactionKind.USER_OP;
+    chain: string;
+    userOp: Record<string, unknown>;
+    entryPoint: string;
+}
+export type PreparedTransaction = PolymarketWalletPreparedTransaction | RawPreparedTransaction | UserOpPreparedTransaction;
+export interface QuoteSummary {
+    sourceToken: string;
+    sourceAmount: string;
+    destinationToken: string;
+    destinationAmount: string;
+    destinationAmountMin: string;
+    expiresAt: string;
+}
+export interface QuoteResponse {
+    withdrawalDetailId: string;
+    token: string;
+    prepared: PreparedTransaction;
+    summary: QuoteSummary;
+}

package/dist/types/requests.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Parameters for `POST /withdraw/:withdrawalConfigId/prepare`.
+ *
+ * Field names mirror the backend `PreparedWithdrawalDto` exactly.
+ * `withdrawalConfigId` is sent as a URL path segment (not in the body).
+ */
+export interface PrepareWithdrawalParams {
+    /** Merchant withdrawal config ID — used in the URL path. */
+    withdrawalConfigId: string;
+    /** Owner address of the source wallet (lane-specific format). */
+    ownerAddress: string;
+    /** Destination address to receive the withdrawn funds. */
+    recipient: string;
+    /** Amount in atomic units (no decimals), serialised as a string. */
+    amount: string;
+    /** Destination currency ID (MongoDB ObjectId). */
+    toCurrencyId: string;
+}
+/**
+ * Parameters for `PATCH /withdraw/:withdrawalDetailId/prepare`.
+ *
+ * NOTE: The backend does not yet expose this endpoint. The SDK method
+ * is kept as a forward-compatible stub and will throw at runtime until
+ * the backend ships the PATCH handler.
+ */
+export interface UpdateQuoteParams {
+    amount: string;
+    recipient?: string;
+    toCurrencyId?: string;
+}
+/**
+ * Parameters for `POST /withdraw/:withdrawalDetailId/submit`.
+ *
+ * Field names mirror the backend `SubmitWithdrawalDto`.
+ */
+export interface SubmitWithdrawalParams {
+    /** Per-request WithdrawalDetail ID (returned by prepare in JWT claims). */
+    withdrawalDetailId: string;
+    /** JWT token from the prepare response. */
+    token: string;
+    /**
+     * The client's signed payload, interpreted server-side by the strategy the
+     * WithdrawalConfig resolves: an EIP-712 signature for polymarket, a base64
+     * signed tx for raw. Mirrors the backend `SubmitWithdrawalDto.signedTx: string`.
+     */
+    signedTx: string;
+}

package/dist/types/responses.d.ts

@@ -0,0 +1,77 @@
+import type { BroadcastAck, WithdrawalState, WithdrawBlockchainSymbol, WithdrawFeature, WithdrawPlatform } from './enums';
+export interface WithdrawalCurrenciesExchangeRate {
+    minimalUnitRate: string;
+    decimalRate: string;
+    fromCurrencyId: string;
+    fromCurrencySymbol: string;
+    fromBlockchainSymbol: WithdrawBlockchainSymbol;
+    toCurrencyId: string;
+    toCurrencySymbol: string;
+}
+export interface WithdrawalConfig {
+    id: string;
+    name: string;
+    platform: WithdrawPlatform;
+    disabled: boolean;
+    disabledBlockchainSymbols: WithdrawBlockchainSymbol[];
+    enabledFeatures: WithdrawFeature[];
+    /** ISO 8601 timestamp. */
+    createdAt: string;
+    /** ISO 8601 timestamp. */
+    updatedAt: string;
+    fromCurrencies: SlimCurrencyWithBlockchain[];
+    exchangeRates: WithdrawalCurrenciesExchangeRate[];
+}
+export interface BaseBlockchain {
+    id: string;
+    symbol: string;
+    displayName: string;
+}
+export interface SlimCurrencyWithBlockchain {
+    id: string;
+    symbol: string;
+    name: string;
+    mintAddress: string;
+    decimals: number;
+    blockchain: BaseBlockchain;
+}
+export interface WithdrawalCustomerSwapRoute {
+    id: string;
+    fromCurrencyId: string;
+    toCurrency: SlimCurrencyWithBlockchain;
+    available: boolean;
+}
+export interface RoutesResponse {
+    /** Source currencies available under the merchant's config. */
+    fromCurrencies: SlimCurrencyWithBlockchain[];
+    routes: WithdrawalCustomerSwapRoute[];
+}
+export interface WalletCurrencyBalance {
+    currencyId: string;
+    symbol: string;
+    mintAddress: string;
+    /** Minimal units. */
+    balance: string | null;
+    uiBalance: string | null;
+}
+export interface BalanceResponse {
+    balances: WalletCurrencyBalance[];
+}
+export interface SubmitResponse {
+    withdrawalDetailId: string;
+    /**
+     * Relayer/transaction hash; `null` only when the broadcast was rejected
+     * before producing a hash.
+     */
+    txHash: string | null;
+    state: WithdrawalState;
+    /** `null` when no broadcast was attempted (defensive idempotent return). */
+    broadcastAck: BroadcastAck | null;
+}
+export interface StatusResponse {
+    withdrawalDetailId: string;
+    state: WithdrawalState;
+    txHash: string | null;
+    broadcastAck: BroadcastAck | null;
+    errorReason: string | null;
+}

package/dist/withdraw-core.cjs

@@ -0,0 +1 @@
+"use strict";var L=Object.defineProperty;var p=(e,t,E)=>t in e?L(e,t,{enumerable:!0,configurable:!0,writable:!0,value:E}):e[t]=E;var D=(e,t,E)=>p(e,typeof t!="symbol"?t+"":t,E);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});var A=(e=>(e.QUOTED="QUOTED",e.SUBMITTING="SUBMITTING",e.SUBMITTED="SUBMITTED",e.BRIDGING="BRIDGING",e.COMPLETED="COMPLETED",e.FAILED="FAILED",e.FAILED_EXPIRED="FAILED_EXPIRED",e.EXPIRED="EXPIRED",e.REFUNDED_BY_PROVIDER="REFUNDED_BY_PROVIDER",e))(A||{});const U=new Set(["COMPLETED","FAILED","FAILED_EXPIRED","EXPIRED","REFUNDED_BY_PROVIDER"]);var I=(e=>(e.WITHDRAW_TX_INVALID_SIGNATURE="WITHDRAW_TX_INVALID_SIGNATURE",e.WITHDRAW_TX_BLOCKHASH_EXPIRED="WITHDRAW_TX_BLOCKHASH_EXPIRED",e.WITHDRAW_TX_NONCE_TOO_LOW="WITHDRAW_TX_NONCE_TOO_LOW",e.WITHDRAW_TX_USEROP_EXPIRED="WITHDRAW_TX_USEROP_EXPIRED",e.WITHDRAW_TX_UNDERPRICED="WITHDRAW_TX_UNDERPRICED",e.WITHDRAW_BUNDLER_REJECTED="WITHDRAW_BUNDLER_REJECTED",e.WITHDRAW_TX_BROADCAST_TIMEOUT="WITHDRAW_TX_BROADCAST_TIMEOUT",e.WITHDRAW_TX_ALREADY_KNOWN="WITHDRAW_TX_ALREADY_KNOWN",e.WITHDRAW_QUOTE_EXPIRED="WITHDRAW_QUOTE_EXPIRED",e.WITHDRAW_SANCTIONS_BLOCKED="WITHDRAW_SANCTIONS_BLOCKED",e.WITHDRAW_NO_ROUTE="WITHDRAW_NO_ROUTE",e.WITHDRAW_NOT_FOUND="WITHDRAW_NOT_FOUND",e.WITHDRAW_INSUFFICIENT_BALANCE="WITHDRAW_INSUFFICIENT_BALANCE",e.WITHDRAW_DETAILS_NOT_UPDATABLE="WITHDRAW_DETAILS_NOT_UPDATABLE",e.INVALID_WALLET_ADDRESS="INVALID_WALLET_ADDRESS",e.BALANCE_FETCH_FAILED="BALANCE_FETCH_FAILED",e.UNKNOWN="UNKNOWN",e))(I||{}),R=(e=>(e.ACKNOWLEDGED="acknowledged",e.UNACKNOWLEDGED="unacknowledged",e.REJECTED="rejected",e))(R||{}),r=(e=>(e.RAW="raw",e.USER_OP="userop",e.POLYMARKET_WALLET="polymarket_wallet",e))(r||{}),n=(e=>(e.HELIO="HELIO",e.MAGIC_EDEN="MAGIC_EDEN",e))(n||{}),N=(e=>(e.IRON="iron",e.MP_SELL="mp_sell",e))(N||{}),O=(e=>(e.SOL="SOL",e.ETH="ETH",e.POLYGON="POLYGON",e.BASE="BASE",e.BITCOIN="BITCOIN",e.ARBITRUM="ARBITRUM",e.BSC="BSC",e.TRON="TRON",e.DOGE="DOGE",e))(O||{});const c=new Set(Object.values(I));class a extends Error{constructor(E,s,T){super(T??s);D(this,"name","WithdrawalApiError");this.status=E,this.code=s,this.detail=T}}const i=e=>e&&c.has(e)?e:I.UNKNOWN,u=e=>{const t=e.split(".");if(t.length!==3)throw new Error("Invalid JWT: expected 3 parts");const E=atob(t[1].replace(/-/g,"+").replace(/_/g,"/"));return JSON.parse(E)},o=(e,t=5e3)=>{const{exp:E}=u(e);return E===void 0?!1:Date.now()>=E*1e3-t};class H{constructor(t){D(this,"baseUrl");D(this,"headers");D(this,"fetch");this.baseUrl=t.baseUrl.endsWith("/")?t.baseUrl.slice(0,-1):t.baseUrl,this.headers={"Content-Type":"application/json",...t.headers},this.fetch=t.fetch??globalThis.fetch.bind(globalThis)}async get(t,E){return this.request("GET",t,void 0,E)}async post(t,E,s){return this.request("POST",t,E,s)}async patch(t,E,s){return this.request("PATCH",t,E,s)}async request(t,E,s,T){const W=`${this.baseUrl}${E}`,_=await this.fetch(W,{method:t,headers:this.headers,body:s!==void 0?JSON.stringify(s):void 0,signal:T});if(!_.ok)throw await this.buildError(_);return await _.json()}async buildError(t){let E,s;try{const T=await t.json();E=T.message??void 0,s=T.errorCode??T.errorType??void 0}catch{E=t.statusText||void 0}return new a(t.status,i(s),E)}}class P{constructor(t){D(this,"api");this.api=new H(t)}async getWithdrawalConfig(t,E){return this.api.get(`/withdrawal-configs/${t}/public`,E)}async getRoutes(t,E){return this.api.get(`/withdraw/${t}/routes`,E)}async getBalance(t,E,s){return this.api.get(`/withdraw/${t}/balances?walletAddress=${encodeURIComponent(E)}`,s)}async prepare(t,E){const{withdrawalConfigId:s,...T}=t;return this.api.post(`/withdraw/${s}/prepare`,T,E)}async updateQuote(t,E,s){throw new Error("updateQuote is not yet supported by the backend. Create a new quote via prepare() instead.")}async submitWithdrawal(t,E){const{withdrawalDetailId:s,...T}=t;return this.api.post(`/withdraw/${s}/submit`,T,E)}async getWithdrawalDetail(t,E){return this.api.get(`/withdraw-details/${t}`,E)}}exports.BroadcastAck=R;exports.SignedTransactionKind=r;exports.TERMINAL_STATES=U;exports.WithdrawBlockchainSymbol=O;exports.WithdrawFeature=N;exports.WithdrawPlatform=n;exports.WithdrawalApiError=a;exports.WithdrawalErrorCode=I;exports.WithdrawalSDK=P;exports.WithdrawalState=A;exports.decodeJwt=u;exports.isQuoteExpired=o;exports.toWithdrawalErrorCode=i;

package/dist/withdraw-core.js

@@ -0,0 +1,154 @@
+var R = Object.defineProperty;
+var N = (e, E, D) => E in e ? R(e, E, { enumerable: !0, configurable: !0, writable: !0, value: D }) : e[E] = D;
+var T = (e, E, D) => N(e, typeof E != "symbol" ? E + "" : E, D);
+var O = /* @__PURE__ */ ((e) => (e.QUOTED = "QUOTED", e.SUBMITTING = "SUBMITTING", e.SUBMITTED = "SUBMITTED", e.BRIDGING = "BRIDGING", e.COMPLETED = "COMPLETED", e.FAILED = "FAILED", e.FAILED_EXPIRED = "FAILED_EXPIRED", e.EXPIRED = "EXPIRED", e.REFUNDED_BY_PROVIDER = "REFUNDED_BY_PROVIDER", e))(O || {});
+const P = /* @__PURE__ */ new Set([
+  "COMPLETED",
+  "FAILED",
+  "FAILED_EXPIRED",
+  "EXPIRED",
+  "REFUNDED_BY_PROVIDER"
+  /* REFUNDED_BY_PROVIDER */
+]);
+var _ = /* @__PURE__ */ ((e) => (e.WITHDRAW_TX_INVALID_SIGNATURE = "WITHDRAW_TX_INVALID_SIGNATURE", e.WITHDRAW_TX_BLOCKHASH_EXPIRED = "WITHDRAW_TX_BLOCKHASH_EXPIRED", e.WITHDRAW_TX_NONCE_TOO_LOW = "WITHDRAW_TX_NONCE_TOO_LOW", e.WITHDRAW_TX_USEROP_EXPIRED = "WITHDRAW_TX_USEROP_EXPIRED", e.WITHDRAW_TX_UNDERPRICED = "WITHDRAW_TX_UNDERPRICED", e.WITHDRAW_BUNDLER_REJECTED = "WITHDRAW_BUNDLER_REJECTED", e.WITHDRAW_TX_BROADCAST_TIMEOUT = "WITHDRAW_TX_BROADCAST_TIMEOUT", e.WITHDRAW_TX_ALREADY_KNOWN = "WITHDRAW_TX_ALREADY_KNOWN", e.WITHDRAW_QUOTE_EXPIRED = "WITHDRAW_QUOTE_EXPIRED", e.WITHDRAW_SANCTIONS_BLOCKED = "WITHDRAW_SANCTIONS_BLOCKED", e.WITHDRAW_NO_ROUTE = "WITHDRAW_NO_ROUTE", e.WITHDRAW_NOT_FOUND = "WITHDRAW_NOT_FOUND", e.WITHDRAW_INSUFFICIENT_BALANCE = "WITHDRAW_INSUFFICIENT_BALANCE", e.WITHDRAW_DETAILS_NOT_UPDATABLE = "WITHDRAW_DETAILS_NOT_UPDATABLE", e.INVALID_WALLET_ADDRESS = "INVALID_WALLET_ADDRESS", e.BALANCE_FETCH_FAILED = "BALANCE_FETCH_FAILED", e.UNKNOWN = "UNKNOWN", e))(_ || {}), n = /* @__PURE__ */ ((e) => (e.ACKNOWLEDGED = "acknowledged", e.UNACKNOWLEDGED = "unacknowledged", e.REJECTED = "rejected", e))(n || {}), r = /* @__PURE__ */ ((e) => (e.RAW = "raw", e.USER_OP = "userop", e.POLYMARKET_WALLET = "polymarket_wallet", e))(r || {}), u = /* @__PURE__ */ ((e) => (e.HELIO = "HELIO", e.MAGIC_EDEN = "MAGIC_EDEN", e))(u || {}), L = /* @__PURE__ */ ((e) => (e.IRON = "iron", e.MP_SELL = "mp_sell", e))(L || {}), p = /* @__PURE__ */ ((e) => (e.SOL = "SOL", e.ETH = "ETH", e.POLYGON = "POLYGON", e.BASE = "BASE", e.BITCOIN = "BITCOIN", e.ARBITRUM = "ARBITRUM", e.BSC = "BSC", e.TRON = "TRON", e.DOGE = "DOGE", e))(p || {});
+const W = new Set(Object.values(_));
+class U extends Error {
+  constructor(D, s, t) {
+    super(t ?? s);
+    T(this, "name", "WithdrawalApiError");
+    this.status = D, this.code = s, this.detail = t;
+  }
+}
+const i = (e) => e && W.has(e) ? e : _.UNKNOWN, a = (e) => {
+  const E = e.split(".");
+  if (E.length !== 3)
+    throw new Error("Invalid JWT: expected 3 parts");
+  const D = atob(E[1].replace(/-/g, "+").replace(/_/g, "/"));
+  return JSON.parse(D);
+}, C = (e, E = 5e3) => {
+  const { exp: D } = a(e);
+  return D === void 0 ? !1 : Date.now() >= D * 1e3 - E;
+};
+class H {
+  constructor(E) {
+    T(this, "baseUrl");
+    T(this, "headers");
+    T(this, "fetch");
+    this.baseUrl = E.baseUrl.endsWith("/") ? E.baseUrl.slice(0, -1) : E.baseUrl, this.headers = {
+      "Content-Type": "application/json",
+      ...E.headers
+    }, this.fetch = E.fetch ?? globalThis.fetch.bind(globalThis);
+  }
+  async get(E, D) {
+    return this.request("GET", E, void 0, D);
+  }
+  async post(E, D, s) {
+    return this.request("POST", E, D, s);
+  }
+  async patch(E, D, s) {
+    return this.request("PATCH", E, D, s);
+  }
+  async request(E, D, s, t) {
+    const A = `${this.baseUrl}${D}`, I = await this.fetch(A, {
+      method: E,
+      headers: this.headers,
+      body: s !== void 0 ? JSON.stringify(s) : void 0,
+      signal: t
+    });
+    if (!I.ok)
+      throw await this.buildError(I);
+    return await I.json();
+  }
+  async buildError(E) {
+    let D, s;
+    try {
+      const t = await E.json();
+      D = t.message ?? void 0, s = t.errorCode ?? t.errorType ?? void 0;
+    } catch {
+      D = E.statusText || void 0;
+    }
+    return new U(
+      E.status,
+      i(s),
+      D
+    );
+  }
+}
+class X {
+  constructor(E) {
+    T(this, "api");
+    this.api = new H(E);
+  }
+  async getWithdrawalConfig(E, D) {
+    return this.api.get(
+      `/withdrawal-configs/${E}/public`,
+      D
+    );
+  }
+  async getRoutes(E, D) {
+    return this.api.get(`/withdraw/${E}/routes`, D);
+  }
+  async getBalance(E, D, s) {
+    return this.api.get(
+      `/withdraw/${E}/balances?walletAddress=${encodeURIComponent(
+        D
+      )}`,
+      s
+    );
+  }
+  /**
+   * Calls `POST /withdraw/:withdrawalConfigId/prepare`.
+   * `withdrawalConfigId` goes in the path; the remaining fields are the
+   * request body matching the backend `PreparedWithdrawalDto`.
+   */
+  async prepare(E, D) {
+    const { withdrawalConfigId: s, ...t } = E;
+    return this.api.post(
+      `/withdraw/${s}/prepare`,
+      t,
+      D
+    );
+  }
+  /**
+   * Update an existing quote.
+   *
+   * NOTE: The backend does not yet expose a PATCH endpoint for prepare.
+   * This stub is kept for forward compatibility. It will throw until
+   * the backend ships the handler.
+   */
+  async updateQuote(E, D, s) {
+    throw new Error(
+      "updateQuote is not yet supported by the backend. Create a new quote via prepare() instead."
+    );
+  }
+  /**
+   * Body matches the backend `SubmitWithdrawalDto`:
+   * `{ token, signedTx }`, where `signedTx` is the bare signed payload string.
+   */
+  async submitWithdrawal(E, D) {
+    const { withdrawalDetailId: s, ...t } = E;
+    return this.api.post(
+      `/withdraw/${s}/submit`,
+      t,
+      D
+    );
+  }
+  async getWithdrawalDetail(E, D) {
+    return this.api.get(`/withdraw-details/${E}`, D);
+  }
+}
+export {
+  n as BroadcastAck,
+  r as SignedTransactionKind,
+  P as TERMINAL_STATES,
+  p as WithdrawBlockchainSymbol,
+  L as WithdrawFeature,
+  u as WithdrawPlatform,
+  U as WithdrawalApiError,
+  _ as WithdrawalErrorCode,
+  X as WithdrawalSDK,
+  O as WithdrawalState,
+  a as decodeJwt,
+  C as isQuoteExpired,
+  i as toWithdrawalErrorCode
+};

package/package.json

@@ -1,39 +1,40 @@
 {
   "name": "@heliofi/withdraw-core",
   "private": false,
-  "version": "0.0.1",
+  "version": "0.0.2",
   "type": "module",
   "scripts": {
     "dev": "vite",
     "build": "tsc && vite build",
-    "lint": "eslint . --ext ts --report-unused-disable-directives --max-warnings 0",
-    "lint:strict": "yarn lint",
-    "lint:fix": "yarn lint --fix && yarn format",
-    "format": "prettier -w .",
-    "format:check": "prettier -c .",
-    "prepublishOnly": "rimraf dist && yarn build",
+    "lint": "biome check src/",
+    "lint:fix": "biome check --fix src/",
+    "format": "biome format --fix src/",
+    "format:check": "biome format src/",
+    "prepublishOnly": "rm -rf dist && pnpm run build",
     "test": "vitest run",
     "test:watch": "vitest",
-    "typecheck": "tsc -p tsconfig.json --noEmit",
-    "typecheck:fast": "tsc --noEmit --incremental"
+    "typecheck": "tsc -p tsconfig.json --noEmit"
   },
-  "main": "./dist/withdraw-core.es.js",
-  "module": "./dist/withdraw-core.es.js",
+  "main": "./dist/withdraw-core.cjs",
+  "module": "./dist/withdraw-core.js",
   "types": "./dist/index.d.ts",
+  "sideEffects": false,
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "import": "./dist/withdraw-core.es.js"
+      "import": "./dist/withdraw-core.js",
+      "require": "./dist/withdraw-core.cjs"
     }
   },
+  "engines": {
+    "node": ">=18"
+  },
+  "packageManager": "pnpm@10",
   "files": [
     "dist"
   ],
   "devDependencies": {
-    "@typescript-eslint/eslint-plugin": "6.7.4",
-    "@typescript-eslint/parser": "6.7.4",
-    "eslint": "8.45.0",
-    "rimraf": "3.0.2",
+    "@biomejs/biome": "^2.4.16",
     "typescript": "5.1.6",
     "vite": "6.4.2",
     "vite-plugin-dts": "3.7.1",

package/dist/withdraw-core.es.js

@@ -1,4 +0,0 @@
-const o = "0.0.1";
-export {
-  o as VERSION
-};