@gearbox-protocol/sdk 14.12.0-next.11 → 14.12.0-next.13

package/dist/cjs/preview/prerequisites/helpers.js

@@ -0,0 +1,47 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var helpers_exports = {};
+__export(helpers_exports, {
+  allowanceAndBalance: () => allowanceAndBalance
+});
+module.exports = __toCommonJS(helpers_exports);
+var import_AllowancePrerequisite = require("./AllowancePrerequisite.js");
+var import_BalancePrerequisite = require("./BalancePrerequisite.js");
+function allowanceAndBalance(props) {
+  const { token, owner, spender, required } = props;
+  return [
+    new import_AllowancePrerequisite.AllowancePrerequisite({
+      token,
+      owner,
+      spender,
+      required,
+      title: props.allowanceTitle
+    }),
+    new import_BalancePrerequisite.BalancePrerequisite({
+      token,
+      owner,
+      required,
+      title: props.balanceTitle
+    })
+  ];
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  allowanceAndBalance
+});

package/dist/cjs/preview/prerequisites/index.js

@@ -17,20 +17,16 @@ var prerequisites_exports = {};
 module.exports = __toCommonJS(prerequisites_exports);
 __reExport(prerequisites_exports, require("./AllowancePrerequisite.js"), module.exports);
 __reExport(prerequisites_exports, require("./BalancePrerequisite.js"), module.exports);
-__reExport(prerequisites_exports, require("./buildPrerequisites.js"), module.exports);
+__reExport(prerequisites_exports, require("./checkPrerequisites.js"), module.exports);
 __reExport(prerequisites_exports, require("./Prerequisite.js"), module.exports);
-__reExport(prerequisites_exports, require("./prepareAction.js"), module.exports);
 __reExport(prerequisites_exports, require("./RWAOpenRequirementsPrerequisite.js"), module.exports);
-__reExport(prerequisites_exports, require("./runPrerequisites.js"), module.exports);
 __reExport(prerequisites_exports, require("./types.js"), module.exports);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ...require("./AllowancePrerequisite.js"),
   ...require("./BalancePrerequisite.js"),
-  ...require("./buildPrerequisites.js"),
+  ...require("./checkPrerequisites.js"),
   ...require("./Prerequisite.js"),
-  ...require("./prepareAction.js"),
   ...require("./RWAOpenRequirementsPrerequisite.js"),
-  ...require("./runPrerequisites.js"),
   ...require("./types.js")
 });

package/dist/cjs/preview/preview/detectCloseOrRepay.js

@@ -0,0 +1,51 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var detectCloseOrRepay_exports = {};
+__export(detectCloseOrRepay_exports, {
+  classifyCloseOrRepay: () => classifyCloseOrRepay,
+  isCloseOrRepay: () => isCloseOrRepay
+});
+module.exports = __toCommonJS(detectCloseOrRepay_exports);
+var import_viem = require("viem");
+var import_sdk = require("../../sdk/index.js");
+function isCloseOrRepay(multicall) {
+  const repaysFullDebt = multicall.some(
+    (op) => op.operation === "DecreaseBorrowedAmount" && op.amount === import_sdk.MAX_UINT256
+  );
+  const withdrawsEverything = multicall.some(
+    (op) => op.operation === "WithdrawCollateral" && op.amount === import_sdk.MAX_UINT256
+  );
+  return repaysFullDebt && withdrawsEverything;
+}
+function classifyCloseOrRepay(multicall, underlying) {
+  for (const op of multicall) {
+    if (op.operation === "AddCollateral") {
+      return "repay";
+    }
+    if (op.operation === "WithdrawCollateral" && !(0, import_viem.isAddressEqual)(op.token, underlying)) {
+      return "repay";
+    }
+  }
+  return "close";
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  classifyCloseOrRepay,
+  isCloseOrRepay
+});

package/dist/cjs/preview/preview/index.js

@@ -16,15 +16,19 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var preview_exports = {};
 module.exports = __toCommonJS(preview_exports);
 __reExport(preview_exports, require("./applyInnerOperations.js"), module.exports);
+__reExport(preview_exports, require("./detectCloseOrRepay.js"), module.exports);
 __reExport(preview_exports, require("./errors.js"), module.exports);
 __reExport(preview_exports, require("./previewAdjustCreditAccount.js"), module.exports);
+__reExport(preview_exports, require("./previewCloseOrRepay.js"), module.exports);
 __reExport(preview_exports, require("./previewOperation.js"), module.exports);
 __reExport(preview_exports, require("./types.js"), module.exports);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ...require("./applyInnerOperations.js"),
+  ...require("./detectCloseOrRepay.js"),
   ...require("./errors.js"),
   ...require("./previewAdjustCreditAccount.js"),
+  ...require("./previewCloseOrRepay.js"),
   ...require("./previewOperation.js"),
   ...require("./types.js")
 });

package/dist/cjs/preview/preview/previewCloseOrRepay.js

@@ -0,0 +1,94 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var previewCloseOrRepay_exports = {};
+__export(previewCloseOrRepay_exports, {
+  previewCloseOrRepay: () => previewCloseOrRepay
+});
+module.exports = __toCommonJS(previewCloseOrRepay_exports);
+var import_sdk = require("../../sdk/index.js");
+var import_applyInnerOperations = require("./applyInnerOperations.js");
+var import_detectCloseOrRepay = require("./detectCloseOrRepay.js");
+var import_unwrapNativeCollateral = require("./unwrapNativeCollateral.js");
+async function previewCloseOrRepay(input, operation, permanent, options) {
+  const { sdk } = input;
+  const market = sdk.marketRegister.findByCreditManager(
+    operation.creditManager
+  );
+  const kind = (0, import_detectCloseOrRepay.classifyCloseOrRepay)(operation.multicall, market.underlying);
+  return kind === "close" ? previewCloseCreditAccount(input, operation, permanent, options) : previewRepayCreditAccount(input, operation, permanent, options);
+}
+async function previewCloseCreditAccount(input, operation, permanent, options) {
+  const { sdk } = input;
+  const market = sdk.marketRegister.findByCreditManager(
+    operation.creditManager
+  );
+  const { state } = await replayMulticall(sdk, operation, options);
+  return {
+    operation: "CloseCreditAccount",
+    permanent,
+    creditManager: operation.creditManager,
+    creditAccount: operation.creditAccount,
+    receivedAmount: state.collateralWithdrawn.getOrZero(market.underlying)
+  };
+}
+async function previewRepayCreditAccount(input, operation, permanent, options) {
+  const { sdk, value = 0n } = input;
+  const { ca, state } = await replayMulticall(sdk, operation, options);
+  const collateralAdded = (0, import_unwrapNativeCollateral.unwrapNativeCollateral)(
+    state.collateralAdded.toAssets(),
+    value,
+    sdk.addressProvider.getAddress(import_sdk.AP_WETH_TOKEN, import_sdk.NO_VERSION)
+  );
+  const initialTotalDebt = ca.debt + ca.accruedInterest + ca.accruedFees;
+  return {
+    operation: "RepayCreditAccount",
+    permanent,
+    creditManager: operation.creditManager,
+    creditAccount: operation.creditAccount,
+    collateralAdded,
+    debtRepaid: initialTotalDebt - state.totalDebt,
+    collateralWithdrawn: state.collateralWithdrawn.toAssets()
+  };
+}
+async function replayMulticall(sdk, operation, options) {
+  let ca = options?.creditAccount;
+  if (!ca) {
+    ca = await sdk.accounts.getCreditAccountData(
+      operation.creditAccount,
+      options?.blockNumber
+    );
+  }
+  if (!ca) {
+    throw new Error(`credit account ${operation.creditAccount} not found`);
+  }
+  const state = (0, import_applyInnerOperations.makeInnerOperationsState)();
+  for (const t of ca.tokens) {
+    if (t.balance > 1n) {
+      state.balances.upsert(t.token, t.balance);
+    }
+  }
+  state.debt = ca.debt;
+  state.totalDebt = ca.debt + ca.accruedInterest + ca.accruedFees;
+  (0, import_applyInnerOperations.applyInnerOperations)(sdk, operation.multicall, state);
+  return { ca, state };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  previewCloseOrRepay
+});

package/dist/cjs/preview/preview/previewOperation.js

@@ -22,8 +22,10 @@ __export(previewOperation_exports, {
 });
 module.exports = __toCommonJS(previewOperation_exports);
 var import_parse = require("../parse/index.js");
+var import_detectCloseOrRepay = require("./detectCloseOrRepay.js");
 var import_errors = require("./errors.js");
 var import_previewAdjustCreditAccount = require("./previewAdjustCreditAccount.js");
+var import_previewCloseOrRepay = require("./previewCloseOrRepay.js");
 var import_previewOpenCreditAccount = require("./previewOpenCreditAccount.js");
 var import_previewPoolOperation = require("./previewPoolOperation.js");
 async function previewOperation(input, options) {
@@ -31,10 +33,16 @@ async function previewOperation(input, options) {
   if ((0, import_parse.isPoolOperation)(operation)) {
     return (0, import_previewPoolOperation.previewPoolOperation)(input, operation, options);
   }
-  if (operation.operation === "OpenCreditAccount" || operation.operation === "SecuritizeOpenCreditAccount") {
+  if (operation.operation === "OpenCreditAccount" || operation.operation === "RWAOpenCreditAccount") {
     return (0, import_previewOpenCreditAccount.previewOpenCreditAccount)(input, operation);
   }
-  if (operation.operation === "MultiCall" || operation.operation === "BotMulticall" || operation.operation === "SecuritizeMulticall") {
+  if (operation.operation === "CloseCreditAccount") {
+    return (0, import_previewCloseOrRepay.previewCloseOrRepay)(input, operation, true, options);
+  }
+  if (operation.operation === "MultiCall" || operation.operation === "BotMulticall" || operation.operation === "RWAMulticall") {
+    if ((0, import_detectCloseOrRepay.isCloseOrRepay)(operation.multicall)) {
+      return (0, import_previewCloseOrRepay.previewCloseOrRepay)(input, operation, false, options);
+    }
     return (0, import_previewAdjustCreditAccount.previewAdjustCreditAccount)(input, operation, options);
   }
   throw new import_errors.UnsupportedOperationError(operation.operation);

package/dist/cjs/sdk/accounts/CreditAccountsServiceV310.js

@@ -1594,19 +1594,14 @@ class CreditAccountsServiceV310 extends import_base.SDKConstruct {
     );
   }
   /**
-   * {@inheritDoc ICreditAccountsService.assembleCaUpdateCalls}
+   * {@inheritDoc ICreditAccountsService.assembleCaOperations}
    */
-  assembleCaUpdateCalls({
+  assembleCaOperations({
     operations,
-    routerCallGroups,
     creditFacade,
-    withdrawTo,
-    creditAccount,
-    underlyingToken
+    withdrawTo
   }) {
     const calls = [];
-    let swapGroupIndex = 0;
-    let routerGroupsConsumed = 0;
     for (const op of operations) {
       switch (op.type) {
         case "increaseDebt":
@@ -1634,18 +1629,10 @@ class CreditAccountsServiceV310 extends import_base.SDKConstruct {
             )
           );
           break;
-        case "swap": {
-          const routerCalls = routerCallGroups[swapGroupIndex];
-          if (!routerCalls) {
-            throw new Error(
-              `assembleCaUpdateCalls: missing router calls for swap leg ${swapGroupIndex}`
-            );
-          }
-          calls.push(...routerCalls);
-          swapGroupIndex += 1;
-          routerGroupsConsumed += 1;
+        case "swap":
+        case "wrapRwaCollateral":
+          calls.push(...op.calls);
           break;
-        }
         case "changeQuota": {
           const quotaAssets = [...op.quotaIncrease, ...op.quotaDecrease];
           if (quotaAssets.length === 0) {
@@ -1659,43 +1646,110 @@ class CreditAccountsServiceV310 extends import_base.SDKConstruct {
           );
           break;
         }
-        case "closeCreditAccount": {
-          for (const group of routerCallGroups) {
-            calls.push(...group);
-            routerGroupsConsumed += 1;
-          }
+        default: {
+          const _exhaustive = op;
+          throw new Error(
+            `assembleCaOperations: unsupported operation ${JSON.stringify(_exhaustive)}`
+          );
+        }
+      }
+    }
+    return calls;
+  }
+  /**
+   * {@inheritDoc ICreditAccountsService.assembleCaUpdateCalls}
+   * @deprecated Prefer {@link CreditAccountsServiceV310.assembleCaOperations}.
+   */
+  assembleCaUpdateCalls({
+    operations,
+    routerCallGroups,
+    creditFacade,
+    withdrawTo,
+    creditAccount,
+    underlyingToken
+  }) {
+    const calls = [];
+    let swapGroupIndex = 0;
+    let routerGroupsConsumed = 0;
+    const encodableOps = [];
+    let pendingClose = null;
+    const flushEncodable = () => {
+      if (encodableOps.length === 0) {
+        return;
+      }
+      calls.push(
+        ...this.assembleCaOperations({
+          operations: encodableOps.splice(0, encodableOps.length),
+          creditFacade,
+          withdrawTo
+        })
+      );
+    };
+    for (const op of operations) {
+      if (op.type === "closeCreditAccount") {
+        flushEncodable();
+        pendingClose = { routerGroupsStart: routerGroupsConsumed };
+        for (const group of routerCallGroups.slice(routerGroupsConsumed)) {
+          calls.push(...group);
+          routerGroupsConsumed += 1;
+        }
+        calls.push(
+          ...this.#prepareDisableQuotas({
+            creditFacade,
+            tokens: Object.entries(creditAccount.initialQuotas).map(
+              ([token, { quota }]) => ({
+                token,
+                quota
+              })
+            )
+          })
+        );
+        if (creditAccount.debt > 0n) {
           calls.push(
-            ...this.#prepareDisableQuotas({
+            ...this.#prepareDecreaseDebt({
               creditFacade,
-              tokens: Object.entries(creditAccount.initialQuotas).map(
-                ([token, { quota }]) => ({
-                  token,
-                  quota
-                })
-              )
+              debt: creditAccount.debt
             })
           );
-          if (creditAccount.debt > 0n) {
-            calls.push(
-              ...this.#prepareDecreaseDebt({
-                creditFacade,
-                debt: creditAccount.debt
-              })
-            );
-          }
-          const hasAssets = creditAccount.assets.some(
-            (asset) => asset.balance > 0n
+        }
+        const hasAssets = creditAccount.assets.some(
+          (asset) => asset.balance > 0n
+        );
+        if (hasAssets) {
+          calls.push(
+            this.#prepareWithdrawToken(
+              creditFacade,
+              underlyingToken,
+              import_constants.MAX_UINT256,
+              withdrawTo
+            )
           );
-          if (hasAssets) {
-            calls.push(
-              this.#prepareWithdrawToken(
-                creditFacade,
-                underlyingToken,
-                import_constants.MAX_UINT256,
-                withdrawTo
-              )
+        }
+        continue;
+      }
+      if (pendingClose !== null) {
+        throw new Error(
+          "assembleCaUpdateCalls: operations after closeCreditAccount are not supported"
+        );
+      }
+      switch (op.type) {
+        case "increaseDebt":
+        case "decreaseDebt":
+        case "addCollateral":
+        case "withdrawCollateral":
+        case "changeQuota":
+          encodableOps.push(op);
+          break;
+        case "swap": {
+          const routerCalls = routerCallGroups[swapGroupIndex];
+          if (!routerCalls) {
+            throw new Error(
+              `assembleCaUpdateCalls: missing router calls for swap leg ${swapGroupIndex}`
             );
           }
+          encodableOps.push({ type: "swap", calls: routerCalls });
+          swapGroupIndex += 1;
+          routerGroupsConsumed += 1;
           break;
         }
         default: {
@@ -1706,6 +1760,7 @@ class CreditAccountsServiceV310 extends import_base.SDKConstruct {
         }
       }
     }
+    flushEncodable();
     if (routerGroupsConsumed !== routerCallGroups.length) {
       throw new Error(
         `assembleCaUpdateCalls: router call group mismatch (consumed ${routerGroupsConsumed}, got ${routerCallGroups.length})`

package/dist/cjs/sdk/market/rwa/securitize/SecuritizeRWAFactory.js

@@ -189,8 +189,8 @@ class SecuritizeRWAFactory extends import_base.BaseContract {
   /**
    * {@inheritDoc IRWAFactory.multicall}
    */
-  multicall(creditAccount, calls, options) {
-    const { tokensToRegister = [], signaturesToCache = [] } = options ?? {};
+  multicall(creditAccount, calls, args) {
+    const { tokensToRegister = [], signaturesToCache = [] } = args ?? {};
     return this.createRawTx({
       functionName: "multicall",
       args: [creditAccount, calls, tokensToRegister, signaturesToCache]
@@ -220,11 +220,33 @@ class SecuritizeRWAFactory extends import_base.BaseContract {
       requiredSignatures
     };
   }
+  /**
+   * {@inheritDoc IRWAFactory.getMissingRequirements}
+   *
+   * A required signature is omitted when `providedArgs.signaturesToCache`
+   * already carries a signature for the same token: the transaction caches it
+   * on-chain as part of the operation.
+   */
+  getMissingRequirements(requirements, providedArgs) {
+    const providedTokens = new import_utils.AddressSet(
+      (providedArgs?.signaturesToCache ?? []).map((s) => s.token)
+    );
+    const requiredSignatures = requirements.requiredSignatures.filter(
+      (message) => !providedTokens.has(message.message.token)
+    );
+    if (requiredSignatures.length === 0) {
+      return void 0;
+    }
+    return {
+      type: import_constants.RWA_FACTORY_SECURITIZE,
+      requiredSignatures
+    };
+  }
   /**
    * {@inheritDoc IRWAFactory.openCreditAccount}
    */
-  openCreditAccount(creditManager, calls, options) {
-    const { tokensToRegister = [], signaturesToCache = [] } = options ?? {};
+  openCreditAccount(creditManager, calls, args) {
+    const { tokensToRegister = [], signaturesToCache = [] } = args ?? {};
     return this.createRawTx({
       functionName: "openCreditAccount",
       args: [creditManager, calls, tokensToRegister, signaturesToCache]

package/dist/cjs/sdk/utils/AddressSet.js

@@ -38,6 +38,13 @@ class AddressSet extends Set {
   has(value) {
     return super.has((0, import_viem.getAddress)(value));
   }
+  difference(other) {
+    const result = new AddressSet(this.keys());
+    for (const key of other) {
+      result.delete((0, import_viem.getAddress)(key));
+    }
+    return result;
+  }
   /**
    * Returns all addresses as an array.
    **/

package/dist/esm/preview/parse/parseRWAFactoryOperationCalldata.js

@@ -21,12 +21,15 @@ function parseSecuritizeOperationCalldata(props) {
   const functionName = parsed.functionName.split("(")[0];
   const { rawArgs } = parsed;
   const innerCalls = rawArgs.calls ?? [];
-  const tokensToRegister = [
-    ...rawArgs.tokensToRegister ?? []
-  ];
-  const signaturesToCache = [
-    ...rawArgs.signaturesToCache ?? []
-  ];
+  const args = {
+    type: RWA_FACTORY_SECURITIZE,
+    tokensToRegister: [
+      ...rawArgs.tokensToRegister ?? []
+    ],
+    signaturesToCache: [
+      ...rawArgs.signaturesToCache ?? []
+    ]
+  };
   const suite = functionName === "openCreditAccount" ? sdk.marketRegister.findCreditManager(rawArgs.creditManager) : resolveSuiteForMulticall(sdk, factory, innerCalls);
   const metadata = {
     factory: factory.address,
@@ -41,19 +44,17 @@ function parseSecuritizeOperationCalldata(props) {
     case "openCreditAccount":
       return {
         ...metadata,
-        operation: "SecuritizeOpenCreditAccount",
+        operation: "RWAOpenCreditAccount",
         multicall,
-        tokensToRegister,
-        signaturesToCache
+        args
       };
     case "multicall":
       return {
         ...metadata,
-        operation: "SecuritizeMulticall",
+        operation: "RWAMulticall",
         creditAccount: rawArgs.creditAccount,
         multicall,
-        tokensToRegister,
-        signaturesToCache
+        args
       };
     default:
       throw new Error(

package/dist/esm/preview/parse/types.js

@@ -6,7 +6,7 @@ function isPoolOperation(tx) {
   return tx.operation === "Deposit" || tx.operation === "Mint" || tx.operation === "Withdraw" || tx.operation === "Redeem";
 }
 function isRWAOperation(tx) {
-  return tx.operation === "SecuritizeOpenCreditAccount" || tx.operation === "SecuritizeMulticall";
+  return tx.operation === "RWAOpenCreditAccount" || tx.operation === "RWAMulticall";
 }
 export {
   isPoolOperation,

package/dist/esm/preview/prerequisites/AllowancePrerequisite.js

@@ -1,8 +1,5 @@
 import { erc20Abi } from "viem";
-import {
-  Prerequisite,
-  toPrerequisiteError
-} from "./Prerequisite.js";
+import { Prerequisite } from "./Prerequisite.js";
 class AllowancePrerequisite extends Prerequisite {
   #id;
   #title;
@@ -30,22 +27,16 @@ class AllowancePrerequisite extends Prerequisite {
   get detail() {
     return this.#detail;
   }
-  calls() {
-    return [
-      {
-        address: this.#detail.token,
-        abi: erc20Abi,
-        functionName: "allowance",
-        args: [this.#detail.owner, this.#detail.spender]
-      }
-    ];
-  }
-  resolve(slice) {
-    const res = slice[0];
-    if (!res || res.status === "failure") {
-      return this.errorResult(toPrerequisiteError(res?.error));
-    }
-    const actual = res.result;
+  async check(ctx) {
+    const actual = await ctx.sdk.client.readContract({
+      address: this.#detail.token,
+      abi: erc20Abi,
+      functionName: "allowance",
+      args: [this.#detail.owner, this.#detail.spender],
+      // `undefined` lets viem read at `latest`; `blockNumber` is only set for
+      // testnet forks pinned to a specific block.
+      blockNumber: ctx.blockNumber
+    });
     return this.satisfiedResult(actual >= this.#detail.required, {
       ...this.#detail,
       actual