@galacticcouncil/sdk-next 0.25.0 → 0.26.0

package/build/types/api/ChainWatcher.d.ts

@@ -0,0 +1,11 @@
+import type { PolkadotClient } from 'polkadot-api';
+import { Observable } from 'rxjs';
+export declare class ChainWatcher {
+    private static instance;
+    readonly bestBlock$: Observable<any>;
+    readonly finalizedBlock$: Observable<import("polkadot-api").BlockInfo>;
+    readonly connection$: Observable<"online" | "offline">;
+    private constructor();
+    static getInstance(client: PolkadotClient): ChainWatcher;
+    private watched;
+}

package/build/types/api/Papi.d.ts

@@ -1,8 +1,9 @@
 import { PolkadotClient, TypedApi } from 'polkadot-api';
 import { hydration } from '@galacticcouncil/descriptors';
+import { ChainWatcher } from './ChainWatcher';
 export declare abstract class Papi {
     readonly client: PolkadotClient;
     readonly api: TypedApi<typeof hydration>;
+    readonly watcher: ChainWatcher;
     constructor(client: PolkadotClient);
-    protected log(message?: any, ...optionalParams: any[]): void;
 }

package/build/types/api/index.d.ts

@@ -1,2 +1,3 @@
 export * from './Papi';
+export * from './ChainWatcher';
 export * from './client';

package/build/types/api/probe.d.ts

@@ -0,0 +1,19 @@
+import { PolkadotClient } from 'polkadot-api';
+import { Observable } from 'rxjs';
+type ConnState = 'online' | 'offline';
+type Opts = {
+    intervalMs?: number;
+    rpcTimeoutMs?: number;
+};
+/**
+ * Periodically probes the node and exposes a derived
+ * online/offline state.
+ *
+ * @param client - polkadot client
+ * @param opts.intervalMs - probe interval
+ * @param opts.rpcTimeoutMs - rpc timeout
+ *
+ * @returns observable emitting connection state
+ */
+export declare function connectionProbe$(client: PolkadotClient, { intervalMs, rpcTimeoutMs }?: Opts): Observable<ConnState>;
+export {};

package/build/types/pool/PoolClient.d.ts

@@ -1,13 +1,18 @@
 import { PolkadotClient } from 'polkadot-api';
-import { Observable, Subscription } from 'rxjs';
+import { Observable, OperatorFunction, Subscription } from 'rxjs';
 import { BalanceClient } from '../client';
 import { EvmClient } from '../evm';
 import { PoolBase, PoolFees, PoolPair, PoolType } from './types';
 import { PoolStore } from './PoolStore';
+import { PoolLog } from './PoolLog';
 export declare abstract class PoolClient<T extends PoolBase> extends BalanceClient {
     protected evm: EvmClient;
     protected store: PoolStore<T>;
+    protected log: PoolLog;
     private shared$?;
+    private resync$;
+    private resyncAt;
+    private resyncPending;
     private mem;
     private memPoolsCache;
     private memPools;
@@ -26,4 +31,43 @@ export declare abstract class PoolClient<T extends PoolBase> extends BalanceClie
     protected hasErc20Asset(pool: PoolBase): boolean;
     private hasValidAssets;
     private updateBalances;
+    /**
+     * Invalidates the current seed, tears down all active writers,
+     * and rebuilds the store from scratch.
+     *
+     * - Increments `mem` to bust memoized seeds
+     * - Emits on `resync$` to restart the active cycle
+     * - Rate-limited by default to avoid resync storms
+     * - Use `force` for fatal, state-corrupting errors
+     *
+     * @param force - bypass the resync throttle
+     */
+    private resync;
+    /**
+     * Schedules a resync on the next tick.
+     *
+     * - Ensures the current cycle tears down before resync
+     * - Dedup multiple requests occurring in the same tick
+     *
+     * @param force - forward the force flag to `resync`
+     */
+    private requestResync;
+    /**
+     * Starts the connection and block watchdog.
+     *
+     * - Triggers a resync on offline → online recovery
+     * - Triggers a resync on block gap
+     * - Errors are swallowed and the watchdog re-subscribes (`repeat`)
+     */
+    private startWatchdog;
+    /**
+     * Guards a watcher stream.
+     *
+     * - Logs any error and treats it as fatal
+     * - Schedules a forced resync
+     * - Outer re-sync cycle handles recovery
+     *
+     * @param tag - log prefix of the watcher
+     */
+    protected watchGuard<T>(tag: string): OperatorFunction<T, T>;
 }

package/build/types/pool/PoolLog.d.ts

@@ -0,0 +1,11 @@
+import { PoolType } from './types';
+export declare class PoolLog {
+    private readonly type;
+    constructor(type: PoolType);
+    private prefix;
+    trace(label: string, ...args: any[]): void;
+    debug(label: string, ...args: any[]): void;
+    info(label: string, ...args: any[]): void;
+    error(label: string, ...args: any[]): void;
+    private pad;
+}

package/build/types/sor/TradeScheduler.d.ts

@@ -28,7 +28,7 @@ export declare class TradeScheduler {
      * @param asset - assetIn id
      * @returns minimum order budget
      */
-    getMinimumOrderBudget(asset: number): Promise<bigint>;
+    getMinimumOrderBudget(asset: number, decimals: number): Promise<bigint>;
     /**
      * Calculate maximum number of trades for dca order execution.
      *

package/build/types/utils/async.d.ts

@@ -0,0 +1 @@
+export declare function withTimeout<T>(p: Promise<T>, ms: number, label?: string): Promise<T>;

package/build/types/utils/calc.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Multiply two fixed-point bigint values and rescale the result
+ * to the desired target decimals.
+ *
+ * This helper is fully generic and supports both scaling down
+ * (division) and scaling up (adding trailing zeroes).
+ *
+ * @param value - base value (native bigint)
+ * @param multiplier - multiplier value (native bigint)
+ * @param valueDecimals - decimals of the base value
+ * @param multiplierDecimals - decimals of the multiplier
+ * @param targetDecimals - desired decimals of the result
+ * @returns scaled multiplication result
+ */
+export declare function mulScaled(value: bigint, multiplier: bigint, valueDecimals: number, multiplierDecimals: number, targetDecimals: number): bigint;
+/**
+ * Multiply a value by a spot price and rescale the result
+ * to the desired target decimals.
+ *
+ * Spot price is assumed to be scaled by `RUNTIME_DECIMALS`
+ * (currently 18).
+ *
+ * @param value - base value (native bigint)
+ * @param spot - spot price (scaled by RUNTIME_DECIMALS)
+ * @param valueDecimals - decimals of the base value
+ * @param targetDecimals - desired decimals of the result
+ * @returns scaled spot multiplication result
+ */
+export declare function mulSpot(value: bigint, spot: bigint, valueDecimals: number, targetDecimals: number): bigint;
+/**
+ * Get % fraction from native value
+ *
+ * @param value - native amount
+ * @param pct - percentage value (e.g. 0.5 = 0.5%)
+ * @param dp - safe decimals margin (2dp = 0.01%)
+ * @returns fraction of given amount
+ */
+export declare function getFraction(value: bigint, pct: number, dp?: number): bigint;

package/build/types/utils/index.d.ts

@@ -1,3 +1,5 @@
+export * as async from './async';
+export * as calc from './calc';
 export * as fmt from './format';
 export * as json from './json';
 export * as math from './math';

package/build/types/utils/math.d.ts

@@ -51,12 +51,3 @@ export declare function calculateSellFee(delta0Y: bigint, deltaY: bigint): numbe
  * @param deltaX - the amount in, inclusive of fees
  */
 export declare function calculateBuyFee(delta0X: bigint, deltaX: bigint): number;
-/**
- * Get % fraction from native value
- *
- * @param value - native amount
- * @param pct - percentage value
- * @param dp - safe decimals margin (2dp = 0.01%)
- * @returns fraction of given amount
- */
-export declare function getFraction(value: bigint, pct: number, dp?: number): bigint;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@galacticcouncil/sdk-next",
-  "version": "0.25.0",
+  "version": "0.26.0",
   "description": "Galactic next gen sdk (papi)",
   "author": "GalacticCouncil",
   "repository": {
@@ -48,9 +48,9 @@
     "big.js": "^6.2.1"
   },
   "peerDependencies": {
-    "@galacticcouncil/common": ">=0.2.0 <1.0.0",
+    "@galacticcouncil/common": ">=0.3.0 <1.0.0",
     "@galacticcouncil/descriptors": ">=1.7.0 <2.0.0",
-    "polkadot-api": "^1.23.0",
+    "polkadot-api": "^1.23.2",
     "viem": "^2.38.3"
   }
 }

package/build/types/api/utils.d.ts

@@ -1 +0,0 @@
-export declare function getLogValue(value: any): boolean;

package/build/types/sor/TradeRouter.utils.d.ts

@@ -1 +0,0 @@
-export declare function calculateSwapAmount(amountIn: bigint, spot: bigint, decimalsIn: number, decimalsOut: number): bigint;