@pear-protocol/exchanges-sdk 0.7.0 → 0.8.0

package/dist/index.d.ts

@@ -562,9 +562,26 @@ interface AccountSyncerConfig {
     credentials: SupportedCredentials;
     demo: boolean;
 }
+/**
+ * Outcome of one fill sync cycle, so batch/cron callers can tell a completed
+ * cycle apart from one that must be retried:
+ * - `synced`: the cycle posted, or there was nothing to post.
+ * - `deferred`: the server answered 409 SYNC_CREATE_*; the watermark did not
+ *   advance, so a later cycle retries the same window.
+ * - `aborted`: the exchange fetch failed; nothing was posted.
+ */
+type FillSyncOutcome = 'synced' | 'deferred' | 'aborted';
+/**
+ * Outcome of one funding sync cycle. Funding has no server deferral contract,
+ * so the union is narrower than {@link FillSyncOutcome}:
+ * - `synced`: the cycle posted, or there were no new payments.
+ * - `aborted`: the exchange funding fetch failed; nothing was posted.
+ * A failed post still throws — only the exchange fetch is guarded.
+ */
+type FundingSyncOutcome = 'synced' | 'aborted';
 interface AccountSyncer {
-    synchronizeFills(): Promise<void>;
-    synchronizeFunding(): Promise<void>;
+    synchronizeFills(): Promise<FillSyncOutcome>;
+    synchronizeFunding(): Promise<FundingSyncOutcome>;
 }
 interface ListExternalFillsParams {
     since: Date;
@@ -614,8 +631,8 @@ declare abstract class BaseAccountSyncer<ExternalFill> implements AccountSyncer
      * Independent of the fill sync cycle (`synchronizeFills`) — funding rows are
      * immutable and upsert idempotently, so this is driven on its own cadence.
      */
-    synchronizeFunding(): Promise<void>;
-    synchronizeFills(): Promise<void>;
+    synchronizeFunding(): Promise<FundingSyncOutcome>;
+    synchronizeFills(): Promise<FillSyncOutcome>;
 }
 
 interface BinanceRawUserTrade {
@@ -2261,4 +2278,4 @@ declare class ExchangesSDK {
     private fetchCredentials;
 }
 
-export { ACCOUNT_MODE_LABELS, ASSET_DECIMALS, AccountBalance, AccountBalanceCore, type AccountHealthStatus, AccountMode, type AccountPosition, type AccountSnapshot, type AccountStatus, type AccountSyncer, type AccountSyncerConfig, type AccountTracker, type AccountTrackerConfig, type AccountWarningReason, type ApiKey, type ApproveIntegratorParams, type ApproveIntegratorResult, AssetId, type AssetSnapshotMap, type BalanceCallback, BaseAccountSyncer, BaseAccountTracker, BaseWs, BasketLeg, BinanceAccountSyncer, BinanceAccountTracker, type BinanceAccountTrackerConfig, BinanceExchangeWs, BinanceMultiAssetBalance, BinanceSingleAssetBalance, BinanceUserDataWs, type BinanceUserDataWsConfig, BinanceWsApi, type BinanceWsApiConfig, BybitAccountSyncer, BybitAccountTracker, type BybitAccountTrackerConfig, BybitExchangeWs, BybitIsolatedMarginBalance, BybitPortfolioMarginBalance, BybitRegularMarginBalance, BybitWs, type BybitWsConfig, type CappedBasketLeg, type CctpDepositHistorySettlement, type CctpDepositIntentParams, type CctpDepositIntentResult, type CctpDepositParams, type CctpDepositProgress, type CctpDepositRegistrationSettlement, type CctpDepositResult, type CctpDepositSettlement, type CctpDepositWalletAdapter, type CheckApiWalletParams, CollateralBalance, type ConnectOptions, type ConnectWalletParams, type ConnectWalletResult, type CreateAccountTrackerConfig, type CreateExchangeWsConfig, DecimalString, type DepositParams, type DepositResult, type ExchangeConnection, type ExchangeHelperExchange, type ExchangeHelperMap, type ExchangeState, ExchangeWs, type ExchangeWsByConnector, ExchangesSDK, type ExchangesSDKConfig, type FastWithdrawParams, type FastWithdrawResult, HyperliquidAccountSyncer, HyperliquidAccountTracker, type HyperliquidAccountTrackerConfig, HyperliquidDexState, HyperliquidExchangeWs, type HyperliquidHelper, HyperliquidPortfolioMarginBalance, HyperliquidPortfolioMarginCollateral, HyperliquidStandardBalance, HyperliquidUnifiedBalance, HyperliquidWs, type IntegratorApprovalRequirements, L2_ASSET_DECIMALS, LIGHTER_CCTP_USDC_ADDRESSES, LIGHTER_CCTP_USDC_DECIMALS, LighterAccountSyncer, LighterAccountTracker, type LighterAccountTrackerConfig, LighterClassicBalance, type LighterDeposit, type LighterDepositNetwork, LighterExchangeWs, type LighterHelper, type LighterLookupResult, type LighterOnboardingStatus, LighterUnifiedBalance, LighterWs, type ListExternalFillsParams, type ListExternalFundingParams, type ListExternalPositionsParams, MAX_API_KEY_INDEX, MIN_LIGHTER_CCTP_DEPOSIT_USDC, MIN_LIGHTER_FAST_WITHDRAW_USDC, MIN_USER_API_KEY_INDEX, MarginMode, type MaxBasketSizeCalculation, MaxBasketSizeInput, MaxBasketSizeResult, type MessageListener, OkxAccountSyncer, OkxAccountTracker, type OkxAccountTrackerConfig, OkxExchangeWs, OkxFuturesBalance, OkxMultiCurrencyMarginBalance, OkxPortfolioMarginBalance, OkxSpotBalance, OkxWs, type OkxWsConfig, type OpenListener, type PositionsCallback, RouteType, Side, SignedDecimalString, type StateUpdate, type SupportedCredentials, type TrackedAssetCallback, type TrackedAssetInfo, type WalletClientWithAccount, type WithdrawParams, type WithdrawResult, type WsMessage, computeMaxBasketSize, createAccountSyncer, createAccountTracker, createExchangeWs, createHyperliquidHelper, createLighterHelper, findAvailableApiKeyIndex, getAssetDecimals, getLighterCctpUsdcAddress, usdcAbi };
+export { ACCOUNT_MODE_LABELS, ASSET_DECIMALS, AccountBalance, AccountBalanceCore, type AccountHealthStatus, AccountMode, type AccountPosition, type AccountSnapshot, type AccountStatus, type AccountSyncer, type AccountSyncerConfig, type AccountTracker, type AccountTrackerConfig, type AccountWarningReason, type ApiKey, type ApproveIntegratorParams, type ApproveIntegratorResult, AssetId, type AssetSnapshotMap, type BalanceCallback, BaseAccountSyncer, BaseAccountTracker, BaseWs, BasketLeg, BinanceAccountSyncer, BinanceAccountTracker, type BinanceAccountTrackerConfig, BinanceExchangeWs, BinanceMultiAssetBalance, BinanceSingleAssetBalance, BinanceUserDataWs, type BinanceUserDataWsConfig, BinanceWsApi, type BinanceWsApiConfig, BybitAccountSyncer, BybitAccountTracker, type BybitAccountTrackerConfig, BybitExchangeWs, BybitIsolatedMarginBalance, BybitPortfolioMarginBalance, BybitRegularMarginBalance, BybitWs, type BybitWsConfig, type CappedBasketLeg, type CctpDepositHistorySettlement, type CctpDepositIntentParams, type CctpDepositIntentResult, type CctpDepositParams, type CctpDepositProgress, type CctpDepositRegistrationSettlement, type CctpDepositResult, type CctpDepositSettlement, type CctpDepositWalletAdapter, type CheckApiWalletParams, CollateralBalance, type ConnectOptions, type ConnectWalletParams, type ConnectWalletResult, type CreateAccountTrackerConfig, type CreateExchangeWsConfig, DecimalString, type DepositParams, type DepositResult, type ExchangeConnection, type ExchangeHelperExchange, type ExchangeHelperMap, type ExchangeState, ExchangeWs, type ExchangeWsByConnector, ExchangesSDK, type ExchangesSDKConfig, type FastWithdrawParams, type FastWithdrawResult, type FillSyncOutcome, type FundingSyncOutcome, HyperliquidAccountSyncer, HyperliquidAccountTracker, type HyperliquidAccountTrackerConfig, HyperliquidDexState, HyperliquidExchangeWs, type HyperliquidHelper, HyperliquidPortfolioMarginBalance, HyperliquidPortfolioMarginCollateral, HyperliquidStandardBalance, HyperliquidUnifiedBalance, HyperliquidWs, type IntegratorApprovalRequirements, L2_ASSET_DECIMALS, LIGHTER_CCTP_USDC_ADDRESSES, LIGHTER_CCTP_USDC_DECIMALS, LighterAccountSyncer, LighterAccountTracker, type LighterAccountTrackerConfig, LighterClassicBalance, type LighterDeposit, type LighterDepositNetwork, LighterExchangeWs, type LighterHelper, type LighterLookupResult, type LighterOnboardingStatus, LighterUnifiedBalance, LighterWs, type ListExternalFillsParams, type ListExternalFundingParams, type ListExternalPositionsParams, MAX_API_KEY_INDEX, MIN_LIGHTER_CCTP_DEPOSIT_USDC, MIN_LIGHTER_FAST_WITHDRAW_USDC, MIN_USER_API_KEY_INDEX, MarginMode, type MaxBasketSizeCalculation, MaxBasketSizeInput, MaxBasketSizeResult, type MessageListener, OkxAccountSyncer, OkxAccountTracker, type OkxAccountTrackerConfig, OkxExchangeWs, OkxFuturesBalance, OkxMultiCurrencyMarginBalance, OkxPortfolioMarginBalance, OkxSpotBalance, OkxWs, type OkxWsConfig, type OpenListener, type PositionsCallback, RouteType, Side, SignedDecimalString, type StateUpdate, type SupportedCredentials, type TrackedAssetCallback, type TrackedAssetInfo, type WalletClientWithAccount, type WithdrawParams, type WithdrawResult, type WsMessage, computeMaxBasketSize, createAccountSyncer, createAccountTracker, createExchangeWs, createHyperliquidHelper, createLighterHelper, findAvailableApiKeyIndex, getAssetDecimals, getLighterCctpUsdcAddress, usdcAbi };

package/dist/syncer/base.js

@@ -99,10 +99,24 @@ class BaseAccountSyncer {
       return;
     }
     if (payload.reconcilables) {
-      await this.sdk.core.sync.fills.reconcile(payload.reconcilables);
+      const reconcileBytes = new Blob([
+        JSON.stringify(payload.reconcilables)
+      ]).size;
+      if (reconcileBytes > 50 * 1024) {
+        await this.sdk.core.sync.fills.reconcileBulk(payload.reconcilables);
+      } else {
+        await this.sdk.core.sync.fills.reconcile(payload.reconcilables);
+      }
     }
     if (payload.confirmables) {
-      await this.sdk.core.sync.fills.confirm(payload.confirmables);
+      const confirmBytes = new Blob([
+        JSON.stringify(payload.confirmables)
+      ]).size;
+      if (confirmBytes > 50 * 1024) {
+        await this.sdk.core.sync.fills.confirmBulk(payload.confirmables);
+      } else {
+        await this.sdk.core.sync.fills.confirm(payload.confirmables);
+      }
     }
     const { firstSyncTrim } = payload;
     let meta = {
@@ -128,14 +142,14 @@ class BaseAccountSyncer {
       exchangePositions: payload.exchangePositions,
       meta
     };
-    const bytes = new Blob([
+    const createBytes = new Blob([
       JSON.stringify(createBody)
     ]).size;
-    if (bytes > 50 * 1024) {
+    if (createBytes > 50 * 1024) {
       await this.sdk.core.sync.fills.createBulk(createBody);
-      return;
+    } else {
+      await this.sdk.core.sync.fills.create(createBody);
     }
-    await this.sdk.core.sync.fills.create(createBody);
   }
   /**
   * Pull historical funding payments since the funding watermark and post them.
@@ -151,12 +165,18 @@ class BaseAccountSyncer {
         overlapMs: 6e4
       })
     ]);
-    const payments = await this.listExternalFunding({
-      since: new Date(watermark.sinceMs),
-      instruments
-    });
+    let payments;
+    try {
+      payments = await this.listExternalFunding({
+        since: new Date(watermark.sinceMs),
+        instruments
+      });
+    } catch (error) {
+      console.error(`${this.connector}: funding fetch failed \u2014 funding sync aborted, retry next tick`, error);
+      return "aborted";
+    }
     if (payments.length === 0) {
-      return;
+      return "synced";
     }
     const externalMaxTs = Math.max(...payments.map((payment) => payment.timestamp));
     const createBody = {
@@ -170,9 +190,10 @@ class BaseAccountSyncer {
     ]).size;
     if (bytes > 50 * 1024) {
       await this.sdk.core.sync.funding.createBulk(createBody);
-      return;
+      return "synced";
     }
     await this.sdk.core.sync.funding.create(createBody);
+    return "synced";
   }
   async synchronizeFills() {
     const state = await this.loadPearState();
@@ -181,17 +202,18 @@ class BaseAccountSyncer {
       snapshot = await this.snapshotExchange(state);
     } catch (error) {
       console.error(`${this.connector}: position/fill fetch failed \u2014 sync cycle aborted, retry next tick`, error);
-      return;
+      return "aborted";
     }
     try {
       await this.computeAndPostSync(state, snapshot);
     } catch (error) {
       if (isSyncCreateDeferral(error)) {
         console.log(`${this.connector}: sync cycle deferred by the server (${error.errorCode}) \u2014 retry next tick`);
-        return;
+        return "deferred";
       }
       throw error;
     }
+    return "synced";
   }
 }
 function isSyncCreateDeferral(error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pear-protocol/exchanges-sdk",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Pear Protocol Exchanges SDK",
   "private": false,
   "type": "module",
@@ -25,8 +25,8 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@pear-protocol/core-sdk": "^1.17.4",
-    "@pear-protocol/types": "^1.26.1",
+    "@pear-protocol/core-sdk": "^1.18.0",
+    "@pear-protocol/types": "^1.27.0",
     "@pear-protocol/utils": "^0.5.1",
     "bignumber.js": "^11.1.1",
     "partysocket": "^1.0.3",