@absol-labs/agent 0.12.0-rc.2 → 0.12.0-rc.4

package/src/x402-opener/scheme.ts

@@ -40,6 +40,7 @@ import {
 
 import { x402StreamOpenerAbi, x402StreamOpenerFactoryAbi } from "./abi.js";
 import type { OperatorSignedListingResolver } from "./listing-resolver.js";
+import type { StreamBlockFloors } from "./block-floors.js";
 import { RelayerQueue } from "./relayer-queue.js";
 import {
   chainIdFromNetwork,
@@ -233,6 +234,12 @@ export interface MetrikOpenerExactSchemeConfig {
    * when the relay is actually mounted. Default false.
    */
   readonly advertiseRefundRelay?: boolean;
+  /**
+   * Records the block of every successful settlement per stream id, shared
+   * with the refund relay, so the relay never answers about a just-opened
+   * stream from a lagging RPC node (it would look unknown). Optional.
+   */
+  readonly streamFloors?: StreamBlockFloors;
 }
 
 /**
@@ -855,6 +862,36 @@ export class MetrikOpenerExactScheme implements SchemeNetworkFacilitator {
     plan: OpenerSettlementPlan,
     opener: Address,
     network: Network,
+  ): Promise<SettleResponse> {
+    const mined: { block?: bigint } = {};
+    const response = await this.awaitSettlementOutcome(
+      hash,
+      auth,
+      plan,
+      opener,
+      network,
+      mined,
+    );
+    if (response.success && mined.block !== undefined) {
+      const streamId = (
+        response.extra?.[OPENER_EXTRA_KEY] as { streamId?: unknown } | undefined
+      )?.streamId;
+      if (typeof streamId === "string") {
+        // The refund relay must answer about this stream from this block or
+        // later: a lagging RPC node would otherwise report it as unknown.
+        this.config.streamFloors?.note(streamId, mined.block);
+      }
+    }
+    return response;
+  }
+
+  private async awaitSettlementOutcome(
+    hash: Hex,
+    auth: ExactEIP3009Payload & { signature: Hex },
+    plan: OpenerSettlementPlan,
+    opener: Address,
+    network: Network,
+    mined: { block?: bigint },
   ): Promise<SettleResponse> {
     const payer = getAddress(auth.authorization.from);
     let receipt;
@@ -863,6 +900,7 @@ export class MetrikOpenerExactScheme implements SchemeNetworkFacilitator {
         hash,
         timeout: this.receiptTimeoutMs,
       });
+      mined.block = receipt.blockNumber;
     } catch (error) {
       // Broadcast but unconfirmed: keep the pending entry so a retry
       // reconciles against this hash. Never success without a receipt.