@hyperbridge/simplex 0.16.13 → 0.17.0

package/dist/index.d.cts

@@ -2,8 +2,8 @@ import { EventEmitter as EventEmitter$1 } from 'node:events';
 import { HexString, ERC7821Call, ChainConfig, Order, TokenInfo, IntentsCoprocessor, ExecutionResult, IntentGateway, FillOptions, FillerConfig as FillerConfig$1 } from '@hyperbridge/sdk';
 import { PublicClient, Hash, AbiEvent, BlockNumber, BlockTag, GetLogsParameters, GetLogsReturnType, WalletClient, Transport, Chain } from 'viem';
 import { LocalAccount, Account } from 'viem/accounts';
-import { L as LoggerContext, a as LogLevel, b as Logger, A as ActivityStore, c as ActivityInsert, d as ActivityEvent, O as OrderHistoryPage, W as WalletTx, e as LimitOrderStore, f as LimitOrder, g as LimitOrderFilter, B as BidStore, S as SimplexDataStore, h as LimitOrderFill, i as StoredBid, j as LogSink, k as BidStats, l as StateStore, I as InventoryStore } from './types-BISgqJhM.cjs';
-export { m as ActivityType, n as BidInsert, o as InventorySnapshot, p as LimitOrderFillInsert, q as LimitOrderFillRecord, r as LimitOrderHold, s as LimitOrderInsert, t as LimitOrderPosting, u as LimitOrderSide, v as LimitOrderStatus, w as OperatorNotification, R as RuntimeState, x as WalletTxKind, y as addLogSink, z as configureLogger, C as getLogger } from './types-BISgqJhM.cjs';
+import { L as LoggerContext, a as LogLevel, b as Logger, A as ActivityStore, c as ActivityInsert, d as ActivityEvent, O as OrderHistoryPage, W as WalletTx, e as LimitOrderStore, f as LimitOrder, g as LimitOrderFilter, B as BidStore, S as SimplexDataStore, h as LimitOrderFill, i as StoredBid, j as LogSink, k as BidStats, l as StateStore, I as InventoryStore } from './types-BPyUX8qu.cjs';
+export { m as ActivityType, n as BidInsert, o as InventorySnapshot, p as LimitOrderFillInsert, q as LimitOrderFillRecord, r as LimitOrderHold, s as LimitOrderInsert, t as LimitOrderPosting, u as LimitOrderSide, v as LimitOrderStatus, w as OperatorNotification, R as RuntimeState, x as WalletTxKind, y as addLogSink, z as configureLogger, C as getLogger } from './types-BPyUX8qu.cjs';
 import { ChannelCredentials } from '@grpc/grpc-js';
 import { EventEmitter } from 'events';
 import Decimal$1, { Decimal } from 'decimal.js';
@@ -936,7 +936,11 @@ declare class UserOpSender {
      */
     private estimateGas;
     private buildSignedUserOp;
-    /** Mirrors the gas-price selection used by the delegation and fill paths. */
+    /**
+     * Mirrors the gas-price selection used by the delegation and fill paths: Pimlico's and
+     * Alchemy's own pricing, otherwise the chain's gas price raised to the priority fee a
+     * rundler bundler requires, when the bundler gives one.
+     */
     private getGasPrice;
     private sendBundlerRpc;
     private waitForUserOpReceipt;
@@ -1419,10 +1423,10 @@ declare function validateAssetDefinitions(assets: Record<string, AssetDefinition
  *  1. the user's `[assets]` table — an *escape hatch* for assets the registry
  *     doesn't ship (or per-deployment overrides), never required for shipped
  *     symbols;
- *  2. shipped symbols (USDC, USDT, DAI, CNGN, USDR, ZARP, EURC, XSGD, TRYB)
- *     resolved per chain from the SDK chain registry (`chain.ts`) — the single
- *     source of truth shared with the rest of the SDK, so an address
- *     correction there is never shadowed by a parallel table here.
+ *  2. shipped symbols (USDC, USDT, DAI, CNGN, USDR, ZARP, EURC, XSGD, TRYB,
+ *     BRIDGE) resolved per chain from the SDK chain registry (`chain.ts`) —
+ *     the single source of truth shared with the rest of the SDK, so an
+ *     address correction there is never shadowed by a parallel table here.
  *
  * Address lookups are per `(symbol, chain)` — a chain where no layer knows the
  * asset simply doesn't trade pairs involving it. The registry holds addresses
@@ -1830,7 +1834,7 @@ interface FillerTomlConfig {
      * Optional asset-registry escape hatch: symbol → { chain → address }. Only
      * needed for assets the built-in registry does not ship, or to override a
      * shipped address for a deployment. Shipped symbols: USDC, USDT, DAI, CNGN
-     * (SDK chain registry) + curated USDR, ZARP, EURC, XSGD and TRYB.
+     * (SDK chain registry) + curated USDR, ZARP, EURC, XSGD, TRYB and BRIDGE.
      */
     assets?: Record<string, AssetDefinition>;
     /**
@@ -2248,6 +2252,7 @@ declare class ContractInteractionService {
     cacheService: CacheService;
     private logger;
     private sdkHelperCache;
+    private blockTimes;
     private solverAccountAddress;
     private signer;
     constructor(clientManager: ChainClientManager, configService: FillerConfigService, signer: Signer, sharedCacheService?: CacheService);
@@ -2406,11 +2411,28 @@ declare class ContractInteractionService {
      *
      * Operators configure seconds because that is the unit the risk is actually in, but the
      * contract compares against block numbers so `order.deadline` and this read the same
-     * clock. The conversion uses the chain's nominal block time; it is deliberately rounded
-     * up, since erring long costs a slightly stale quote while erring short silently drops
-     * winnable bids.
+     * clock. The conversion uses the chain's block time from {@link blockTimeSeconds}; it is
+     * deliberately rounded up, since erring long costs a slightly stale quote while erring
+     * short silently drops winnable bids.
      */
     private bidValidUntilBlock;
+    /**
+     * Seconds per block on `chain`. Measured once, when simplex starts ({@link initCache}), and
+     * kept until it stops. A chain with no measurement yet, because it was added later or its
+     * blocks could not be read at startup, is measured at its first bid.
+     *
+     * The nominal `Chain.blockTime` cannot be relied on alone: it goes stale when a chain
+     * speeds up (BSC makes a block every 0.45s against a declared 0.75s) and some chains
+     * declare none. Converting at a slower block time than the chain's ends a bid early, so
+     * the faster of the measured and the declared figure is used, and a stalled or idle
+     * stretch in the sample never shortens a bid.
+     *
+     * Blocks that cannot be read fall back to the declared figure, then to
+     * {@link FALLBACK_BLOCK_TIME_SECONDS}. That answer is not kept.
+     */
+    private blockTimeSeconds;
+    /** The average block time over the chain's last {@link BLOCK_TIME_SAMPLE_BLOCKS} blocks, in seconds. */
+    private measureBlockTimeSeconds;
     /**
      * Builds the signed, never-executed UserOperation that carries one limit order
      * to the HyperFX orderbook.
@@ -3084,7 +3106,10 @@ interface CancelledLimitOrder {
 interface ReconcileReport {
     /** Orderbook entries no limit order here owns, now withdrawn. */
     cancelled: number;
-    /** Limit orders whose entry had gone, now posted again. */
+    /**
+     * Limit orders posted again: their entry had gone, or it was signed for an
+     * EntryPoint the fill chain no longer uses.
+     */
     reposted: number;
     /** Postings the orderbook is not backing in full, left alone and surfaced. */
     underFunded: number;
@@ -3120,6 +3145,8 @@ declare class LimitOrderService {
     private logger;
     private cachedLimits?;
     private onEvent?;
+    /** Re-signs in flight, by order id. A fill's resize waits one out rather than reposting alongside it. */
+    private readonly resigning;
     constructor(store: LimitOrderStore, client: OrderbookClient, contractService: ContractInteractionService, configService: FillerConfigService, assetRegistry: AssetRegistry, signer: Signer, defaultTtlSecs: number, delegationService?: DelegationService | undefined, loggers?: LoggerContext, 
     /** Where a new order's nonce starts; tests pin it, production draws it at random. */
     startingNonce?: () => bigint, 
@@ -3269,9 +3296,25 @@ declare class LimitOrderService {
      * They drift apart when a request never got an answer or the process died
      * between two of them: an entry the orderbook still lists that nothing here
      * owns, an order here whose entry has gone, or an entry the orderbook has cut
-     * down because the solver cannot cover what it quoted.
+     * down because the solver cannot cover what it quoted. A posted op is also
+     * signed over one EntryPoint, so when the fill chain moves to another, every
+     * entry signed before the move is withdrawn and posted again.
      */
     reconcile(now?: Date): Promise<ReconcileReport>;
+    /**
+     * Withdraws a posting signed for an EntryPoint its fill chain no longer uses,
+     * and posts it again signed for the one it uses now. Answers whether a new
+     * posting landed.
+     *
+     * The row is read again and claimed out of `open` first: a fill can have worked
+     * it down or started its own repost since reconciliation listed it, and that
+     * write is the one to follow. A fill that lands once the claim is taken waits
+     * in `resize` for this to finish. The EntryPoint is only written with a posting
+     * that landed, so a pass cut short anywhere leaves a row the next pass still
+     * reads as stale, or as having no entry, and finishes the job.
+     */
+    private resign;
+    private signAgain;
     /**
      * Lowers every open order's `remaining` to what the solver's account will still
      * pay for it, and puts the order back on the book at that size.
@@ -3330,6 +3373,8 @@ declare class LimitOrderService {
      * only the second one.
      */
     private submit;
+    /** The EntryPoint a posting on `chain` is signed for now. */
+    private entryPointFor;
     /**
      * The entry the orderbook holds at `commitment`, if it holds one. A lookup that
      * fails answers null, which sends the caller down the nonce-bump path it would

package/dist/index.d.ts

@@ -2,8 +2,8 @@ import { EventEmitter as EventEmitter$1 } from 'node:events';
 import { HexString, ERC7821Call, ChainConfig, Order, TokenInfo, IntentsCoprocessor, ExecutionResult, IntentGateway, FillOptions, FillerConfig as FillerConfig$1 } from '@hyperbridge/sdk';
 import { PublicClient, Hash, AbiEvent, BlockNumber, BlockTag, GetLogsParameters, GetLogsReturnType, WalletClient, Transport, Chain } from 'viem';
 import { LocalAccount, Account } from 'viem/accounts';
-import { L as LoggerContext, a as LogLevel, b as Logger, A as ActivityStore, c as ActivityInsert, d as ActivityEvent, O as OrderHistoryPage, W as WalletTx, e as LimitOrderStore, f as LimitOrder, g as LimitOrderFilter, B as BidStore, S as SimplexDataStore, h as LimitOrderFill, i as StoredBid, j as LogSink, k as BidStats, l as StateStore, I as InventoryStore } from './types-BISgqJhM.js';
-export { m as ActivityType, n as BidInsert, o as InventorySnapshot, p as LimitOrderFillInsert, q as LimitOrderFillRecord, r as LimitOrderHold, s as LimitOrderInsert, t as LimitOrderPosting, u as LimitOrderSide, v as LimitOrderStatus, w as OperatorNotification, R as RuntimeState, x as WalletTxKind, y as addLogSink, z as configureLogger, C as getLogger } from './types-BISgqJhM.js';
+import { L as LoggerContext, a as LogLevel, b as Logger, A as ActivityStore, c as ActivityInsert, d as ActivityEvent, O as OrderHistoryPage, W as WalletTx, e as LimitOrderStore, f as LimitOrder, g as LimitOrderFilter, B as BidStore, S as SimplexDataStore, h as LimitOrderFill, i as StoredBid, j as LogSink, k as BidStats, l as StateStore, I as InventoryStore } from './types-BPyUX8qu.js';
+export { m as ActivityType, n as BidInsert, o as InventorySnapshot, p as LimitOrderFillInsert, q as LimitOrderFillRecord, r as LimitOrderHold, s as LimitOrderInsert, t as LimitOrderPosting, u as LimitOrderSide, v as LimitOrderStatus, w as OperatorNotification, R as RuntimeState, x as WalletTxKind, y as addLogSink, z as configureLogger, C as getLogger } from './types-BPyUX8qu.js';
 import { ChannelCredentials } from '@grpc/grpc-js';
 import { EventEmitter } from 'events';
 import Decimal$1, { Decimal } from 'decimal.js';
@@ -936,7 +936,11 @@ declare class UserOpSender {
      */
     private estimateGas;
     private buildSignedUserOp;
-    /** Mirrors the gas-price selection used by the delegation and fill paths. */
+    /**
+     * Mirrors the gas-price selection used by the delegation and fill paths: Pimlico's and
+     * Alchemy's own pricing, otherwise the chain's gas price raised to the priority fee a
+     * rundler bundler requires, when the bundler gives one.
+     */
     private getGasPrice;
     private sendBundlerRpc;
     private waitForUserOpReceipt;
@@ -1419,10 +1423,10 @@ declare function validateAssetDefinitions(assets: Record<string, AssetDefinition
  *  1. the user's `[assets]` table — an *escape hatch* for assets the registry
  *     doesn't ship (or per-deployment overrides), never required for shipped
  *     symbols;
- *  2. shipped symbols (USDC, USDT, DAI, CNGN, USDR, ZARP, EURC, XSGD, TRYB)
- *     resolved per chain from the SDK chain registry (`chain.ts`) — the single
- *     source of truth shared with the rest of the SDK, so an address
- *     correction there is never shadowed by a parallel table here.
+ *  2. shipped symbols (USDC, USDT, DAI, CNGN, USDR, ZARP, EURC, XSGD, TRYB,
+ *     BRIDGE) resolved per chain from the SDK chain registry (`chain.ts`) —
+ *     the single source of truth shared with the rest of the SDK, so an
+ *     address correction there is never shadowed by a parallel table here.
  *
  * Address lookups are per `(symbol, chain)` — a chain where no layer knows the
  * asset simply doesn't trade pairs involving it. The registry holds addresses
@@ -1830,7 +1834,7 @@ interface FillerTomlConfig {
      * Optional asset-registry escape hatch: symbol → { chain → address }. Only
      * needed for assets the built-in registry does not ship, or to override a
      * shipped address for a deployment. Shipped symbols: USDC, USDT, DAI, CNGN
-     * (SDK chain registry) + curated USDR, ZARP, EURC, XSGD and TRYB.
+     * (SDK chain registry) + curated USDR, ZARP, EURC, XSGD, TRYB and BRIDGE.
      */
     assets?: Record<string, AssetDefinition>;
     /**
@@ -2248,6 +2252,7 @@ declare class ContractInteractionService {
     cacheService: CacheService;
     private logger;
     private sdkHelperCache;
+    private blockTimes;
     private solverAccountAddress;
     private signer;
     constructor(clientManager: ChainClientManager, configService: FillerConfigService, signer: Signer, sharedCacheService?: CacheService);
@@ -2406,11 +2411,28 @@ declare class ContractInteractionService {
      *
      * Operators configure seconds because that is the unit the risk is actually in, but the
      * contract compares against block numbers so `order.deadline` and this read the same
-     * clock. The conversion uses the chain's nominal block time; it is deliberately rounded
-     * up, since erring long costs a slightly stale quote while erring short silently drops
-     * winnable bids.
+     * clock. The conversion uses the chain's block time from {@link blockTimeSeconds}; it is
+     * deliberately rounded up, since erring long costs a slightly stale quote while erring
+     * short silently drops winnable bids.
      */
     private bidValidUntilBlock;
+    /**
+     * Seconds per block on `chain`. Measured once, when simplex starts ({@link initCache}), and
+     * kept until it stops. A chain with no measurement yet, because it was added later or its
+     * blocks could not be read at startup, is measured at its first bid.
+     *
+     * The nominal `Chain.blockTime` cannot be relied on alone: it goes stale when a chain
+     * speeds up (BSC makes a block every 0.45s against a declared 0.75s) and some chains
+     * declare none. Converting at a slower block time than the chain's ends a bid early, so
+     * the faster of the measured and the declared figure is used, and a stalled or idle
+     * stretch in the sample never shortens a bid.
+     *
+     * Blocks that cannot be read fall back to the declared figure, then to
+     * {@link FALLBACK_BLOCK_TIME_SECONDS}. That answer is not kept.
+     */
+    private blockTimeSeconds;
+    /** The average block time over the chain's last {@link BLOCK_TIME_SAMPLE_BLOCKS} blocks, in seconds. */
+    private measureBlockTimeSeconds;
     /**
      * Builds the signed, never-executed UserOperation that carries one limit order
      * to the HyperFX orderbook.
@@ -3084,7 +3106,10 @@ interface CancelledLimitOrder {
 interface ReconcileReport {
     /** Orderbook entries no limit order here owns, now withdrawn. */
     cancelled: number;
-    /** Limit orders whose entry had gone, now posted again. */
+    /**
+     * Limit orders posted again: their entry had gone, or it was signed for an
+     * EntryPoint the fill chain no longer uses.
+     */
     reposted: number;
     /** Postings the orderbook is not backing in full, left alone and surfaced. */
     underFunded: number;
@@ -3120,6 +3145,8 @@ declare class LimitOrderService {
     private logger;
     private cachedLimits?;
     private onEvent?;
+    /** Re-signs in flight, by order id. A fill's resize waits one out rather than reposting alongside it. */
+    private readonly resigning;
     constructor(store: LimitOrderStore, client: OrderbookClient, contractService: ContractInteractionService, configService: FillerConfigService, assetRegistry: AssetRegistry, signer: Signer, defaultTtlSecs: number, delegationService?: DelegationService | undefined, loggers?: LoggerContext, 
     /** Where a new order's nonce starts; tests pin it, production draws it at random. */
     startingNonce?: () => bigint, 
@@ -3269,9 +3296,25 @@ declare class LimitOrderService {
      * They drift apart when a request never got an answer or the process died
      * between two of them: an entry the orderbook still lists that nothing here
      * owns, an order here whose entry has gone, or an entry the orderbook has cut
-     * down because the solver cannot cover what it quoted.
+     * down because the solver cannot cover what it quoted. A posted op is also
+     * signed over one EntryPoint, so when the fill chain moves to another, every
+     * entry signed before the move is withdrawn and posted again.
      */
     reconcile(now?: Date): Promise<ReconcileReport>;
+    /**
+     * Withdraws a posting signed for an EntryPoint its fill chain no longer uses,
+     * and posts it again signed for the one it uses now. Answers whether a new
+     * posting landed.
+     *
+     * The row is read again and claimed out of `open` first: a fill can have worked
+     * it down or started its own repost since reconciliation listed it, and that
+     * write is the one to follow. A fill that lands once the claim is taken waits
+     * in `resize` for this to finish. The EntryPoint is only written with a posting
+     * that landed, so a pass cut short anywhere leaves a row the next pass still
+     * reads as stale, or as having no entry, and finishes the job.
+     */
+    private resign;
+    private signAgain;
     /**
      * Lowers every open order's `remaining` to what the solver's account will still
      * pay for it, and puts the order back on the book at that size.
@@ -3330,6 +3373,8 @@ declare class LimitOrderService {
      * only the second one.
      */
     private submit;
+    /** The EntryPoint a posting on `chain` is signed for now. */
+    private entryPointFor;
     /**
      * The entry the orderbook holds at `commitment`, if it holds one. A lookup that
      * fails answers null, which sends the caller down the nonce-bump path it would