@xyo-network/chain-bridge 1.23.0 → 2.0.0

package/dist/node/services/queue/workers/util/buildEthToXl1ReserveTx.d.ts

@@ -2,6 +2,8 @@ import type { Address, Hex } from '@xylabs/sdk-js';
 import type { AccountInstance } from '@xyo-network/sdk-js';
 import type { ChainId, SignedHydratedTransaction, XL1BlockNumber } from '@xyo-network/xl1-sdk';
 export interface BuildEthToXl1ReserveTxOptions {
+    /** Gross deposit on the EVM side (from `bridgesToRemote[id].amount`). The user's destination
+     * credit is `amount - feesAmount`; the fees address receives `feesAmount`. */
     amount: bigint;
     bridgeAccount: AccountInstance;
     /** Contract-assigned bridge id from `bridgesToRemote(bridgeId)` storage. */
@@ -14,23 +16,37 @@ export interface BuildEthToXl1ReserveTxOptions {
     /** Tx hash of the EVM transaction that emitted BridgedToRemote(bridgeId). */
     evmTxHash: Hex;
     exp: XL1BlockNumber;
+    /** XL1 address that receives the bridge fee. Pass the same value as `destAddress` to
+     * collapse to a single-output Transfer (the user effectively pays themselves). */
+    feesAddress: Address;
+    /** Total fee, in atto, to be credited to `feesAddress`. Caller is responsible for ensuring
+     * `amount >= feesAmount` (typically by enforcing `amount >= minBridgeAmount` upstream).
+     * Computed as `hexToBigInt(feeFixed) + hexToBigInt(feeVariable)`. */
+    feesAmount: bigint;
     nbf: XL1BlockNumber;
     xl1ChainId: ChainId;
     xl1TokenAddress: Hex;
 }
 /**
- * Builds a signed XL1 transaction that credits `destAddress` by transferring `amount` from
- * the bridge's reserve account, with `BridgeIntent` + `BridgeSourceObservation` audit
- * payloads attached off-chain. Used by the EVM→XL1 reverse-bridge flow once the canonical
- * EVM event has been verified at confirmation depth.
+ * Builds a signed XL1 transaction that settles an EVM→XL1 inbound bridge. The Transfer
+ * splits the gross `amount` between `destAddress` (net = amount - feesAmount) and
+ * `feesAddress`, mirroring the XL1→EVM outbound model where `createBridgeTransfer` splits
+ * the user's source amount between escrow and fees. `BridgeIntent` + `BridgeSourceObservation`
+ * attach the cross-chain provenance off-chain.
  *
  * The Transfer payload is what actually moves balance on XL1 (on-chain). The intent +
  * source observation are off-chain provenance: they record what cross-chain operation this
  * transfer represents and which EVM tx emitted the source-side `BridgedToRemote` event.
  *
- * The BridgeIntent.nonce is the deterministic `evm:{chainId}:{contract}:{bridgeId}` form so
+ * Field semantics in the intent/observation: `srcAmount = amount` (gross EVM deposit) and
+ * `destAmount = amount - feesAmount` (net XL1 credit). This makes the fee directly derivable
+ * from the intent (`srcAmount - destAmount`) without consulting external config — the
+ * inbound mirror of how the outbound flow records what hits destAddress as `destAmount`.
+ *
+ * The BridgeIntent.nonce is the deterministic `evm-{chainId}-{contract}-{bridgeId}` form so
  * it aligns with the BullMQ jobId and the status route's URL `:nonce` parameter — a single
- * canonical id ties the same logical bridge across all surfaces.
+ * canonical id ties the same logical bridge across all surfaces. Dash delimiter is used
+ * because BullMQ rejects custom jobIds containing `:`.
  */
 export declare function buildEthToXl1ReserveTx(options: BuildEthToXl1ReserveTxOptions): Promise<SignedHydratedTransaction>;
 //# sourceMappingURL=buildEthToXl1ReserveTx.d.ts.map

package/dist/node/services/queue/workers/util/buildEthToXl1ReserveTx.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"buildEthToXl1ReserveTx.d.ts","sourceRoot":"","sources":["../../../../../../src/services/queue/workers/util/buildEthToXl1ReserveTx.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAA;AAElD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAE1D,OAAO,KAAK,EAC6B,OAAO,EAAE,yBAAyB,EAAE,cAAc,EAC1F,MAAM,sBAAsB,CAAA;AAK7B,MAAM,WAAW,6BAA6B;IAC5C,MAAM,EAAE,MAAM,CAAA;IACd,aAAa,EAAE,eAAe,CAAA;IAC9B,4EAA4E;IAC5E,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,OAAO,CAAA;IACpB,UAAU,EAAE,GAAG,CAAA;IACf,kBAAkB,EAAE,OAAO,CAAA;IAC3B,aAAa,EAAE,OAAO,CAAA;IACtB,eAAe,EAAE,GAAG,CAAA;IACpB,6EAA6E;IAC7E,SAAS,EAAE,GAAG,CAAA;IACd,GAAG,EAAE,cAAc,CAAA;IACnB,GAAG,EAAE,cAAc,CAAA;IACnB,UAAU,EAAE,OAAO,CAAA;IACnB,eAAe,EAAE,GAAG,CAAA;CACrB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,yBAAyB,CAAC,CA0DpC"}
+{"version":3,"file":"buildEthToXl1ReserveTx.d.ts","sourceRoot":"","sources":["../../../../../../src/services/queue/workers/util/buildEthToXl1ReserveTx.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAA;AAGlD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAE1D,OAAO,KAAK,EACe,OAAO,EAAE,yBAAyB,EAAE,cAAc,EAC5E,MAAM,sBAAsB,CAAA;AAG7B,MAAM,WAAW,6BAA6B;IAC5C;kFAC8E;IAC9E,MAAM,EAAE,MAAM,CAAA;IACd,aAAa,EAAE,eAAe,CAAA;IAC9B,4EAA4E;IAC5E,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,OAAO,CAAA;IACpB,UAAU,EAAE,GAAG,CAAA;IACf,kBAAkB,EAAE,OAAO,CAAA;IAC3B,aAAa,EAAE,OAAO,CAAA;IACtB,eAAe,EAAE,GAAG,CAAA;IACpB,6EAA6E;IAC7E,SAAS,EAAE,GAAG,CAAA;IACd,GAAG,EAAE,cAAc,CAAA;IACnB;sFACkF;IAClF,WAAW,EAAE,OAAO,CAAA;IACpB;;yEAEqE;IACrE,UAAU,EAAE,MAAM,CAAA;IAClB,GAAG,EAAE,cAAc,CAAA;IACnB,UAAU,EAAE,OAAO,CAAA;IACnB,eAAe,EAAE,GAAG,CAAA;CACrB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,yBAAyB,CAAC,CAgEpC"}

package/dist/node/services/queue/workers/util/index.d.ts

@@ -1,3 +1,4 @@
+export * from './buildAcceptedSnapshot.ts';
 export * from './buildEthToXl1ReserveTx.ts';
 export * from './resolveEvmBlockTagAtDepth.ts';
 export * from './submitEthTransaction.ts';

package/dist/node/services/queue/workers/util/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/services/queue/workers/util/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAA;AAC3C,cAAc,gCAAgC,CAAA;AAC9C,cAAc,2BAA2B,CAAA;AACzC,cAAc,2BAA2B,CAAA;AACzC,cAAc,2BAA2B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/services/queue/workers/util/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAA;AAC1C,cAAc,6BAA6B,CAAA;AAC3C,cAAc,gCAAgC,CAAA;AAC9C,cAAc,2BAA2B,CAAA;AACzC,cAAc,2BAA2B,CAAA;AACzC,cAAc,2BAA2B,CAAA"}

package/dist/node/services/queue/workers/util/resolveEvmBlockTagAtDepth.d.ts

@@ -3,14 +3,29 @@ import type { EvmConfirmationDepth } from '../../../evm/index.ts';
 /**
  * Resolves an EvmConfirmationDepth into the concrete block reference used by `eth_call`
  * / `eth_getLogs` / `nextBridgeToId({ blockTag })` / `bridgesToRemote(id, { blockTag })` /
- * `queryFilter(filter, fromBlock, toBlock)`. Return is `number | 'finalized'` to satisfy
- * the typechain overload's narrower `string | number` signature on `queryFilter`.
+ * `queryFilter(filter, fromBlock, toBlock)`. Return type covers all three forms ethers
+ * accepts as BlockTag and that typechain's `queryFilter` overload tolerates (`string |
+ * number`).
  *
- * Numeric depth: subtract from the current head and clamp to >= 0. The provider RPC fires
- * exactly once per call.
+ * Three branches, picked to avoid an unnecessary RPC round-trip *and* to avoid a class of
+ * pre-deploy-block bugs:
  *
- * 'finalized': forwarded as-is. ethers and the underlying JSON-RPC accept the string tag
- * directly, so no head fetch is needed — saves a round-trip on every read at depth.
+ *  - 'finalized': forwarded as-is. Resolved server-side, so no head fetch needed.
+ *
+ *  - depth === 0: returns 'latest' rather than computing `head - 0`. Semantically
+ *    identical ("trust head, no reorg buffer"), but materially safer. ethers v6 caches
+ *    `getBlockNumber()` for up to `pollingInterval` ms (~1s WS, ~4s JSON-RPC), so a
+ *    stale read can hand back a block number from BEFORE the contract was deployed —
+ *    then `eth_call` at that historical block returns `0x` (no code at that address
+ *    yet) and ethers throws BAD_DATA. Letting the server resolve 'latest' at call time
+ *    sidesteps the race entirely. Also saves the head-fetch round-trip.
+ *
+ *  - numeric depth > 0: subtract from the current head and clamp to >= `deployBlock`.
+ *    The head fetch is unavoidable here — we need a specific past block, not the live
+ *    head. The deploy-block floor guards against the early-life scenario where
+ *    `head - depth < deployBlock` (e.g. the actor starts on a 32-confirmation depth a
+ *    few blocks after deploy): a pre-deploy block would fail an `eth_call` with
+ *    BAD_DATA, so we clamp upward to the deploy block instead.
  */
-export declare function resolveEvmBlockTagAtDepth(provider: Provider, depth: EvmConfirmationDepth): Promise<number | 'finalized'>;
+export declare function resolveEvmBlockTagAtDepth(provider: Provider, depth: EvmConfirmationDepth, deployBlock: number): Promise<number | 'latest' | 'finalized'>;
 //# sourceMappingURL=resolveEvmBlockTagAtDepth.d.ts.map

package/dist/node/services/queue/workers/util/resolveEvmBlockTagAtDepth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolveEvmBlockTagAtDepth.d.ts","sourceRoot":"","sources":["../../../../../../src/services/queue/workers/util/resolveEvmBlockTagAtDepth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAA;AAEtC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AAEjE;;;;;;;;;;;GAWG;AACH,wBAAsB,yBAAyB,CAC7C,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAAC,MAAM,GAAG,WAAW,CAAC,CAI/B"}
+{"version":3,"file":"resolveEvmBlockTagAtDepth.d.ts","sourceRoot":"","sources":["../../../../../../src/services/queue/workers/util/resolveEvmBlockTagAtDepth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAA;AAEtC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AAEjE;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,yBAAyB,CAC7C,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,oBAAoB,EAC3B,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,GAAG,QAAQ,GAAG,WAAW,CAAC,CAK1C"}

package/dist/node/services/queue/workers/util/verifyEthBridgeEvent.d.ts

@@ -8,6 +8,10 @@ export interface EthBridgeEventData {
     destToken: Address;
     /** Tx hash of the EVM transaction that emitted BridgedToRemote(id). */
     evmTxHash: Hex;
+    /** Wall-clock timestamp (epoch ms) the bridge actor observed the event at confirmation
+     * depth. Optional for back-compat with state-map entries written before this field
+     * existed; new writes always populate it. Powers the settle-latency histogram. */
+    observedAt?: number;
     srcAddress: Address;
 }
 /**
@@ -23,9 +27,8 @@ export interface EthBridgeEventData {
  * or never reached canonical state — the caller must treat this as terminal.
  *
  * The event-log lookup is what surfaces the EVM tx hash for `BridgeSourceObservation`'s
- * `srcConfirmation`. It scans from genesis to the depth-tagged block; on chains with long
- * history this is expensive, so a future optimization should narrow the range (cache the
- * contract's deploy block or accept a fromBlock hint).
+ * `srcConfirmation`. Floored at `deployBlock` (cached at actor startup) so the eth_getLogs
+ * range is the contract's lifetime, not genesis-to-now.
  */
-export declare function verifyEthBridgeEvent(id: bigint, bridge: LiquidityPoolBridge, provider: Provider, confirmationDepth: EvmConfirmationDepth): Promise<EthBridgeEventData | null>;
+export declare function verifyEthBridgeEvent(id: bigint, bridge: LiquidityPoolBridge, provider: Provider, confirmationDepth: EvmConfirmationDepth, deployBlock: number): Promise<EthBridgeEventData | null>;
 //# sourceMappingURL=verifyEthBridgeEvent.d.ts.map

package/dist/node/services/queue/workers/util/verifyEthBridgeEvent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"verifyEthBridgeEvent.d.ts","sourceRoot":"","sources":["../../../../../../src/services/queue/workers/util/verifyEthBridgeEvent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAA;AAElD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AACjE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAA;AAGtC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AAGjE,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,OAAO,CAAA;IACpB,SAAS,EAAE,OAAO,CAAA;IAClB,uEAAuE;IACvE,SAAS,EAAE,GAAG,CAAA;IACd,UAAU,EAAE,OAAO,CAAA;CACpB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,oBAAoB,CACxC,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,mBAAmB,EAC3B,QAAQ,EAAE,QAAQ,EAClB,iBAAiB,EAAE,oBAAoB,GACtC,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CA0BpC"}
+{"version":3,"file":"verifyEthBridgeEvent.d.ts","sourceRoot":"","sources":["../../../../../../src/services/queue/workers/util/verifyEthBridgeEvent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAA;AAElD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AACjE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAA;AAGtC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AAGjE,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,OAAO,CAAA;IACpB,SAAS,EAAE,OAAO,CAAA;IAClB,uEAAuE;IACvE,SAAS,EAAE,GAAG,CAAA;IACd;;sFAEkF;IAClF,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,OAAO,CAAA;CACpB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,oBAAoB,CACxC,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,mBAAmB,EAC3B,QAAQ,EAAE,QAAQ,EAClB,iBAAiB,EAAE,oBAAoB,EACvC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CA4BpC"}

package/dist/node/services/util/generateBridgeEstimate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generateBridgeEstimate.d.ts","sourceRoot":"","sources":["../../../../src/services/util/generateBridgeEstimate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAA;AAEzC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAA;AAEpE,OAAO,KAAK,EACV,YAAY,EAAsB,QAAQ,EAC3C,MAAM,sBAAsB,CAAA;AAQ7B,eAAO,MAAM,sBAAsB,GACjC,YAAY,GAAG,EACf,WAAW,GAAG,EACd,aAAa,GAAG,EAChB,QAAQ,YAAY,EACpB,gBAAgB,MAAM,KACrB,OAAO,CAAC,CAAC,YAAY,EAAE,QAAQ,CAAC,CAkClC,CAAA"}
+{"version":3,"file":"generateBridgeEstimate.d.ts","sourceRoot":"","sources":["../../../../src/services/util/generateBridgeEstimate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAA;AAEzC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAA;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAIlE,eAAO,MAAM,sBAAsB,GACjC,YAAY,GAAG,EACf,WAAW,GAAG,EACd,aAAa,GAAG,EAChB,QAAQ,YAAY,EACpB,gBAAgB,MAAM,KACrB,OAAO,CAAC,CAAC,YAAY,EAAE,QAAQ,CAAC,CAGlC,CAAA"}

package/dist/node/services/util/index.d.ts

@@ -1,8 +1,3 @@
-export * from './BridgeFees.ts';
-export * from './bridgeFeesAsBigInt.ts';
-export * from './calculateBridgeFees.ts';
-export * from './calculateMaxBridgeAmount.ts';
-export * from './createBridgeTransfer.ts';
 export * from './generateBridgeEstimate.ts';
 export * from './getConfigFromEnv.ts';
 //# sourceMappingURL=index.d.ts.map

package/dist/node/services/util/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/services/util/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA;AAC/B,cAAc,yBAAyB,CAAA;AACvC,cAAc,0BAA0B,CAAA;AACxC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,2BAA2B,CAAA;AACzC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,uBAAuB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/services/util/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAA;AAC3C,cAAc,uBAAuB,CAAA"}

package/dist/node/services/validation/index.d.ts

@@ -1,3 +1,4 @@
+export * from './validateAmountMeetsMinBridgeAmount.ts';
 export * from './validateBridgeEstimateExact.ts';
 export * from './validateBridgeTransaction.ts';
 export * from './validateSufficientLiquiditySourceAllowance.ts';

package/dist/node/services/validation/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/services/validation/index.ts"],"names":[],"mappings":"AAAA,cAAc,kCAAkC,CAAA;AAChD,cAAc,gCAAgC,CAAA;AAC9C,cAAc,iDAAiD,CAAA;AAC/D,cAAc,+CAA+C,CAAA;AAC7D,cAAc,+CAA+C,CAAA;AAC7D,cAAc,0CAA0C,CAAA;AACxD,cAAc,gDAAgD,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/services/validation/index.ts"],"names":[],"mappings":"AAAA,cAAc,yCAAyC,CAAA;AACvD,cAAc,kCAAkC,CAAA;AAChD,cAAc,gCAAgC,CAAA;AAC9C,cAAc,iDAAiD,CAAA;AAC/D,cAAc,+CAA+C,CAAA;AAC7D,cAAc,+CAA+C,CAAA;AAC7D,cAAc,0CAA0C,CAAA;AACxD,cAAc,gDAAgD,CAAA"}

package/dist/node/services/validation/validateAmountMeetsMinBridgeAmount.d.ts

@@ -0,0 +1,20 @@
+import type { Hex } from '@xylabs/sdk-js';
+export interface ValidateAmountMeetsMinBridgeAmountArgs {
+    /** Gross deposit amount in atto. For EVM→XL1 this is `bridgesToRemote[id].amount`. */
+    amount: bigint;
+    /** Configured floor (Hex-encoded atto), shared with the XL1→EVM outbound direction
+     * (BridgeConfig.minBridgeAmount). */
+    minBridgeAmount: Hex;
+}
+/**
+ * Returns true if `amount >= minBridgeAmount`. Used by Stage 2 of the EVM→XL1 inbound flow
+ * to short-circuit fulfillment for deposits below the bridge's configured floor.
+ *
+ * The contract (`LiquidityPoolBridge.bridgeToRemote`) does NOT enforce a minimum — it only
+ * rejects zero and over-max. So any inbound deposit smaller than what the bridge service
+ * considers economical (post-fee) reaches Stage 2 and must be filtered here. Failed
+ * inbound deposits sit in the EVM-side `liquiditySource` reserve and are operator-refundable
+ * out-of-band; this is documented behavior, not a protocol guarantee.
+ */
+export declare function validateAmountMeetsMinBridgeAmount({ amount, minBridgeAmount, }: ValidateAmountMeetsMinBridgeAmountArgs): boolean;
+//# sourceMappingURL=validateAmountMeetsMinBridgeAmount.d.ts.map

package/dist/node/services/validation/validateAmountMeetsMinBridgeAmount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateAmountMeetsMinBridgeAmount.d.ts","sourceRoot":"","sources":["../../../../src/services/validation/validateAmountMeetsMinBridgeAmount.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAA;AAGzC,MAAM,WAAW,sCAAsC;IACrD,sFAAsF;IACtF,MAAM,EAAE,MAAM,CAAA;IACd;yCACqC;IACrC,eAAe,EAAE,GAAG,CAAA;CACrB;AAED;;;;;;;;;GASG;AACH,wBAAgB,kCAAkC,CAAC,EACjD,MAAM,EACN,eAAe,GAChB,EAAE,sCAAsC,GAAG,OAAO,CAElD"}

package/dist/node/services/validation/validateBridgeEstimate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validateBridgeEstimate.d.ts","sourceRoot":"","sources":["../../../../src/services/validation/validateBridgeEstimate.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAA;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAKlE;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB,GACjC,QAAQ,YAAY,EACpB,UAAU,QAAQ,EAClB,QAAQ,YAAY,KACnB,OAAO,CAAC,OAAO,CAuCjB,CAAA"}
+{"version":3,"file":"validateBridgeEstimate.d.ts","sourceRoot":"","sources":["../../../../src/services/validation/validateBridgeEstimate.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAA;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAIlE;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB,GACjC,QAAQ,YAAY,EACpB,UAAU,QAAQ,EAClB,QAAQ,YAAY,KACnB,OAAO,CAAC,OAAO,CAuCjB,CAAA"}

package/dist/node/services/validation/validateSufficientXl1ReserveBalance.d.ts

@@ -8,21 +8,26 @@ export interface ValidateSufficientXl1ReserveBalanceArgs {
     logger?: AsyncLogger;
 }
 /**
- * Checks that the bridge's XL1 reserve account has at least `amount` of native balance
- * available to cover an inbound (EVM → XL1) reserve transfer. Mirrors the XL1 → EVM
- * direction's `validateSufficientXL1SourceAddressBalance` in spirit: a quick pre-flight
- * gate to avoid building, signing, and dispatching a transaction the chain will then
- * reject for insufficient funds.
+ * 1 XL1 of headroom above the requested amount. The actual XL1 transaction the bridge will
+ * submit pays a small network fee on top of the transfer; without a buffer, an exactly-equal
+ * balance check would pass here and the chain would then reject the tx for being a few atto
+ * short. One XL1 is far above any realistic per-tx fee and stays comfortably under the
+ * configured minBridgeAmount (1500 XL1 by default), so it doesn't materially affect the
+ * threshold at which legitimate bridges become serviceable.
+ */
+export declare const RESERVE_FEE_BUFFER: bigint;
+/**
+ * Checks that the bridge's XL1 reserve account has at least `amount + RESERVE_FEE_BUFFER`
+ * of native balance available to cover an inbound (EVM → XL1) reserve transfer plus the
+ * network fee the actual submission will pay. Mirrors the XL1 → EVM direction's
+ * `validateSufficientXL1SourceAddressBalance` in spirit: a quick pre-flight gate to avoid
+ * building, signing, and dispatching a transaction the chain will then reject for
+ * insufficient funds.
  *
  * Race conditions: a concurrent submission could deplete the reserve between this check
  * and the actual XL1 submission. That's acceptable — the worker chain will fail the
  * submission, BullMQ will retry, and the next retry will re-validate. The check exists to
  * filter the bulk of insufficient-balance cases cheaply, not to be perfectly atomic.
- *
- * Network fees are not included in the comparison (matching the XL1 → EVM validator's
- * convention). Operators are expected to keep the reserve sufficiently above any single
- * bridge amount; tiny network-fee deltas would only flip the outcome at the margin and
- * BullMQ retry handles those.
  */
 export declare function validateSufficientXl1ReserveBalance({ amount, bridgeAccount, gateway, logger, }: ValidateSufficientXl1ReserveBalanceArgs): Promise<boolean>;
 //# sourceMappingURL=validateSufficientXl1ReserveBalance.d.ts.map

package/dist/node/services/validation/validateSufficientXl1ReserveBalance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validateSufficientXl1ReserveBalance.d.ts","sourceRoot":"","sources":["../../../../src/services/validation/validateSufficientXl1ReserveBalance.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAE5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAEnD,MAAM,WAAW,uCAAuC;IACtD,MAAM,EAAE,MAAM,CAAA;IACd,aAAa,EAAE,eAAe,CAAA;IAC9B,OAAO,EAAE,gBAAgB,CAAA;IACzB,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,mCAAmC,CAAC,EACxD,MAAM,EACN,aAAa,EACb,OAAO,EACP,MAAM,GACP,EAAE,uCAAuC,GAAG,OAAO,CAAC,OAAO,CAAC,CAK5D"}
+{"version":3,"file":"validateSufficientXl1ReserveBalance.d.ts","sourceRoot":"","sources":["../../../../src/services/validation/validateSufficientXl1ReserveBalance.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAG5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAEnD,MAAM,WAAW,uCAAuC;IACtD,MAAM,EAAE,MAAM,CAAA;IACd,aAAa,EAAE,eAAe,CAAA;IAC9B,OAAO,EAAE,gBAAgB,CAAA;IACzB,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAsC,CAAA;AAEvE;;;;;;;;;;;;GAYG;AACH,wBAAsB,mCAAmC,CAAC,EACxD,MAAM,EACN,aAAa,EACb,OAAO,EACP,MAAM,GACP,EAAE,uCAAuC,GAAG,OAAO,CAAC,OAAO,CAAC,CAS5D"}

package/dist/node/telemetry/bucketFailureReason.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Closed-enum failure-reason buckets for the bridge's terminal-failure counter. Free-form
+ * `failedReason` strings (from thrown Errors at BullMQ retry exhaustion) get collapsed to
+ * one of these values so the metric label stays low-cardinality and queryable.
+ *
+ * Adding a new bucket here means the `reason` label gets a new possible value — coordinate
+ * with the dashboard / alert rules before doing so.
+ */
+export type BridgeFailureReason = 'attempts_exhausted' | 'below_min_bridge_amount' | 'orphaned_at_depth' | 'other' | 'reserve_insufficient';
+/**
+ * Map a free-form `failedReason` (BullMQ's `Job.failedReason` or `Error.message` at terminal
+ * failure) into a `BridgeFailureReason`. Order matters — more specific patterns come first
+ * so the well-known structured errors don't fall through to the generic 'attempts_exhausted'
+ * bucket.
+ */
+export declare function bucketFailureReason(failedReason: string): BridgeFailureReason;
+//# sourceMappingURL=bucketFailureReason.d.ts.map

package/dist/node/telemetry/bucketFailureReason.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bucketFailureReason.d.ts","sourceRoot":"","sources":["../../../src/telemetry/bucketFailureReason.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,MAAM,mBAAmB,GACzB,oBAAoB,GACpB,yBAAyB,GACzB,mBAAmB,GACnB,OAAO,GACP,sBAAsB,CAAA;AAE5B;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,mBAAmB,CAS7E"}

package/dist/node/telemetry/createBalanceMonitor.d.ts

@@ -1,4 +1,5 @@
 import type { Meter } from '@opentelemetry/api';
+import type { Hex } from '@xylabs/sdk-js';
 import type { AccountInstance } from '@xyo-network/sdk-js';
 import type { BridgeableToken, LiquidityPoolBridge } from '@xyo-network/typechain';
 import type { XyoGatewayRunner } from '@xyo-network/xl1-sdk';
@@ -11,6 +12,10 @@ export interface BalanceMonitorConfig {
     intervalMs?: number;
     meter: Meter;
     provider: Provider;
+    /** Remote (EVM) chain id, attached as a low-cardinality `remoteChainId` label so a
+     * single bridge actor monitoring multiple destinations can be queried per-chain in
+     * Prometheus. */
+    remoteChainId: Hex;
     wallet: Wallet;
 }
 export interface BalanceMonitorHandle {

package/dist/node/telemetry/createBalanceMonitor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createBalanceMonitor.d.ts","sourceRoot":"","sources":["../../../src/telemetry/createBalanceMonitor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAS,KAAK,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAC1D,OAAO,KAAK,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AAClF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAC5D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAE9C,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,eAAe,CAAA;IACxB,MAAM,EAAE,mBAAmB,CAAA;IAC3B,eAAe,EAAE,eAAe,CAAA;IAChC,OAAO,EAAE,gBAAgB,CAAA;IACzB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,KAAK,CAAA;IACZ,QAAQ,EAAE,QAAQ,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,IAAI,CAAA;IACjB,IAAI,EAAE,MAAM,IAAI,CAAA;CACjB;AAOD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,GAAG,oBAAoB,CAsFvF"}
+{"version":3,"file":"createBalanceMonitor.d.ts","sourceRoot":"","sources":["../../../src/telemetry/createBalanceMonitor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAS,KAAK,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAA;AAEzC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAC1D,OAAO,KAAK,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AAClF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAC5D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAE9C,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,eAAe,CAAA;IACxB,MAAM,EAAE,mBAAmB,CAAA;IAC3B,eAAe,EAAE,eAAe,CAAA;IAChC,OAAO,EAAE,gBAAgB,CAAA;IACzB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,KAAK,CAAA;IACZ,QAAQ,EAAE,QAAQ,CAAA;IAClB;;qBAEiB;IACjB,aAAa,EAAE,GAAG,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,IAAI,CAAA;IACjB,IAAI,EAAE,MAAM,IAAI,CAAA;CACjB;AAOD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,GAAG,oBAAoB,CAwFvF"}

package/dist/node/telemetry/createBridgeFlowMetrics.d.ts

@@ -0,0 +1,76 @@
+import type { Meter } from '@opentelemetry/api';
+import type { Hex } from '@xylabs/sdk-js';
+import type { BridgeFailureReason } from './bucketFailureReason.ts';
+export type BridgeDirection = 'inbound' | 'outbound';
+/**
+ * What user-facing action caused the retry. `api_singular` for the singular retry routes
+ * (one bridge id, one increment); `api_bulk` for the bulk retryFailed routes (one
+ * increment per actually-retried job). BullBoard's manual retry button has no operator-
+ * facing hook today, so it is deliberately not represented here.
+ */
+export type BridgeRetryTrigger = 'api_singular' | 'api_bulk';
+export interface RecordBridgeRetryOptions {
+    /** Default 1. Bulk routes pass `result.counts.retried` so a single call records the
+     * whole batch atomically. */
+    count?: number;
+    direction: BridgeDirection;
+    trigger: BridgeRetryTrigger;
+}
+export interface RecordBridgeSuccessOptions {
+    direction: BridgeDirection;
+    /** Fee skim, in AttoXL1, attributable to this single bridge. Recorded as a counter
+     * increment on bridge_fee_revenue_total. */
+    feeAmount: bigint;
+    /** Wall-clock seconds from acceptance (canonical observed) to fulfillment (tx submitted /
+     * confirmed). Optional — outbound may pass `undefined` when a clean
+     * acceptance-to-fulfillment timestamp isn't available, in which case the histogram is
+     * not recorded for that flow. */
+    latencySeconds?: number;
+    /** Token contract / chain id the fee is denominated in. Bridge fees are XL1-denominated
+     * for both directions today; this label exists so future direction-specific fee streams
+     * can be distinguished without a metric rename. */
+    token: Hex;
+}
+export interface BridgeFlowMetricsConfig {
+    /** Optional — when absent (no OTel meter wired up), the returned handle records nothing
+     * (no-op). Keeps worker call sites unconditional. */
+    meter?: Meter;
+    /** Low-cardinality remote-chain label attached to every recording. */
+    remoteChainId: Hex;
+}
+export interface BridgeFlowMetricsHandle {
+    /** Increments bridge_attempt_expirations_total for a non-terminal per-attempt failure
+     * (inbound: Stage 2's exp-block elapsed; outbound: BullMQ retry with attempts remaining). */
+    recordAttemptExpiration(opts: {
+        direction: BridgeDirection;
+    }): void;
+    /** Increments bridge_retried_total. Fired from the retry routes when a job actually
+     * moves from `failed` to `waiting` (never on dry-run, never on filter-mismatch /
+     * not-in-failed-state skips). */
+    recordRetried(opts: RecordBridgeRetryOptions): void;
+    recordSuccess(opts: RecordBridgeSuccessOptions): void;
+    /** Increments bridge_terminal_failures_total. Fired from the leaf worker's .on('failed')
+     * when `job.attemptsMade >= job.opts.attempts` (or one-shot attempts=1). */
+    recordTerminalFailure(opts: {
+        direction: BridgeDirection;
+        reason: BridgeFailureReason;
+    }): void;
+}
+/**
+ * Three metrics for successful bridge settlements, per direction (inbound = EVM→XL1,
+ * outbound = XL1→EVM):
+ *
+ *   - `bridge_completed_total` — counter, labels (remoteChainId, direction).
+ *   - `bridge_settle_latency_seconds` — histogram, same labels. Recorded only when the
+ *     caller can supply a latency; the inbound path always can (canonical.observedAt and
+ *     fulfilled.submittedAt are both wall-clock ms), the outbound path supplies what it
+ *     can (currently EthTransactionMonitor's own wait time).
+ *   - `bridge_fee_revenue_total` — counter, labels (remoteChainId, direction, token).
+ *     `feeAmount` is in AttoXL1 (matching the protocol); operators converting to whole
+ *     XL1 can divide by 10^18 in their PromQL.
+ *
+ * No-op when constructed without a meter: workers can call recordSuccess unconditionally
+ * even on actors that don't have OTel wired up.
+ */
+export declare function createBridgeFlowMetrics(config: BridgeFlowMetricsConfig): BridgeFlowMetricsHandle;
+//# sourceMappingURL=createBridgeFlowMetrics.d.ts.map

package/dist/node/telemetry/createBridgeFlowMetrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createBridgeFlowMetrics.d.ts","sourceRoot":"","sources":["../../../src/telemetry/createBridgeFlowMetrics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACU,KAAK,EAC1B,MAAM,oBAAoB,CAAA;AAC3B,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAA;AAEzC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAEnE,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,UAAU,CAAA;AAEpD;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG,cAAc,GAAG,UAAU,CAAA;AAE5D,MAAM,WAAW,wBAAwB;IACvC;iCAC6B;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,eAAe,CAAA;IAC1B,OAAO,EAAE,kBAAkB,CAAA;CAC5B;AAED,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,eAAe,CAAA;IAC1B;gDAC4C;IAC5C,SAAS,EAAE,MAAM,CAAA;IACjB;;;qCAGiC;IACjC,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;;uDAEmD;IACnD,KAAK,EAAE,GAAG,CAAA;CACX;AAED,MAAM,WAAW,uBAAuB;IACtC;yDACqD;IACrD,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,sEAAsE;IACtE,aAAa,EAAE,GAAG,CAAA;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC;iGAC6F;IAC7F,uBAAuB,CAAC,IAAI,EAAE;QAAE,SAAS,EAAE,eAAe,CAAA;KAAE,GAAG,IAAI,CAAA;IACnE;;qCAEiC;IACjC,aAAa,CAAC,IAAI,EAAE,wBAAwB,GAAG,IAAI,CAAA;IACnD,aAAa,CAAC,IAAI,EAAE,0BAA0B,GAAG,IAAI,CAAA;IACrD;gFAC4E;IAC5E,qBAAqB,CAAC,IAAI,EAAE;QAAE,SAAS,EAAE,eAAe,CAAC;QAAC,MAAM,EAAE,mBAAmB,CAAA;KAAE,GAAG,IAAI,CAAA;CAC/F;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,uBAAuB,GAAG,uBAAuB,CA0EhG"}

package/dist/node/telemetry/createInFlightPoller.d.ts

@@ -0,0 +1,29 @@
+import type { Meter } from '@opentelemetry/api';
+import type { Hex } from '@xylabs/sdk-js';
+import type { IterableMap } from '@xyo-network/xl1-sdk';
+import type { BridgeFulfillmentState } from '../services/index.ts';
+export interface InFlightPollerConfig {
+    bridgeFulfillmentMap: IterableMap<string, BridgeFulfillmentState>;
+    intervalMs?: number;
+    meter: Meter;
+    /** Same low-cardinality label used by the other bridge metrics so dashboards can join. */
+    remoteChainId: Hex;
+}
+export interface InFlightPollerHandle {
+    /** Run one poll and record the gauge. Exposed for tests and so callers can prime the
+     * gauge before the first interval tick. */
+    poll: () => Promise<void>;
+    start: () => void;
+    stop: () => void;
+}
+/**
+ * Periodically counts entries in `bridgeFulfillmentMap` that represent in-flight inbound
+ * (EVM→XL1) bridges — those where Stage 1 wrote `canonical` but Stage 2 has not yet
+ * transitioned to `fulfilled`. Records the count on
+ * `bridge_in_flight{remoteChainId, direction='inbound'}`.
+ *
+ * Outbound (XL1→EVM) has no equivalent durable state map today; the gauge stays inbound-only
+ * until a parallel store exists.
+ */
+export declare function createInFlightPoller(config: InFlightPollerConfig): InFlightPollerHandle;
+//# sourceMappingURL=createInFlightPoller.d.ts.map

package/dist/node/telemetry/createInFlightPoller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createInFlightPoller.d.ts","sourceRoot":"","sources":["../../../src/telemetry/createInFlightPoller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAS,KAAK,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAA;AAEzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAEvD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAElE,MAAM,WAAW,oBAAoB;IACnC,oBAAoB,EAAE,WAAW,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAA;IACjE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,KAAK,CAAA;IACZ,0FAA0F;IAC1F,aAAa,EAAE,GAAG,CAAA;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC;+CAC2C;IAC3C,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IACzB,KAAK,EAAE,MAAM,IAAI,CAAA;IACjB,IAAI,EAAE,MAAM,IAAI,CAAA;CACjB;AAID;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,GAAG,oBAAoB,CAwCvF"}

package/dist/node/telemetry/createQueueMetrics.d.ts

@@ -1,4 +1,5 @@
 import type { Meter } from '@opentelemetry/api';
+import type { Hex } from '@xylabs/sdk-js';
 import type { Queue } from 'bullmq';
 export interface QueueMetricsConfig {
     intervalMs?: number;
@@ -11,6 +12,9 @@ export interface QueueMetricsConfig {
      * shared XL1 queues collide on identical key names so spread-merge dedupes naturally.
      */
     queues: Record<string, Queue>;
+    /** Remote (EVM) chain id, attached as a low-cardinality `remoteChainId` label on every
+     * queue gauge so queries can scope to a single destination chain. */
+    remoteChainId: Hex;
 }
 export interface QueueMetricsHandle {
     start: () => void;

package/dist/node/telemetry/createQueueMetrics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createQueueMetrics.d.ts","sourceRoot":"","sources":["../../../src/telemetry/createQueueMetrics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAS,KAAK,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAA;AAEnC,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,KAAK,CAAA;IACZ;;;;;;OAMG;IACH,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;CAC9B;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,IAAI,CAAA;IACjB,IAAI,EAAE,MAAM,IAAI,CAAA;CACjB;AAID,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,kBAAkB,CA6DjF"}
+{"version":3,"file":"createQueueMetrics.d.ts","sourceRoot":"","sources":["../../../src/telemetry/createQueueMetrics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAS,KAAK,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAA;AAEzC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAA;AAEnC,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,KAAK,CAAA;IACZ;;;;;;OAMG;IACH,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;IAC7B;yEACqE;IACrE,aAAa,EAAE,GAAG,CAAA;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,IAAI,CAAA;IACjB,IAAI,EAAE,MAAM,IAAI,CAAA;CACjB;AAID,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,kBAAkB,CA+DjF"}

package/dist/node/telemetry/index.d.ts

@@ -1,3 +1,6 @@
+export * from './bucketFailureReason.ts';
 export * from './createBalanceMonitor.ts';
+export * from './createBridgeFlowMetrics.ts';
+export * from './createInFlightPoller.ts';
 export * from './createQueueMetrics.ts';
 //# sourceMappingURL=index.d.ts.map

package/dist/node/telemetry/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/telemetry/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAA;AACzC,cAAc,yBAAyB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/telemetry/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAA;AACxC,cAAc,2BAA2B,CAAA;AACzC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,2BAA2B,CAAA;AACzC,cAAc,yBAAyB,CAAA"}