@gearbox-protocol/sdk 14.12.0-next.48 → 14.12.0-next.49

package/dist/esm/sdk/accounts/liquidations/MultichainLiquidationsService.js

@@ -35,6 +35,12 @@ class MultichainLiquidationsService {
   async getLiquidationDetails(props) {
     return this.#sdk.chain(props.network).liquidations.getLiquidationDetails(props);
   }
+  /**
+   * {@inheritDoc ILiquidationsService.buildLiquidationTx}
+   **/
+  async buildLiquidationTx(props) {
+    return this.#sdk.chain(props.network).liquidations.buildLiquidationTx(props);
+  }
   /**
    * {@inheritDoc ILiquidationsService.getLiquidatorWithdrawals}
    **/

package/dist/esm/sdk/accounts/liquidations/constants.js

@@ -0,0 +1,5 @@
+import { ADDRESS_0X0 } from "../../constants/index.js";
+const LIQUIDATION_COMPRESSOR_V313_ADDRESS = ADDRESS_0X0;
+export {
+  LIQUIDATION_COMPRESSOR_V313_ADDRESS
+};

package/dist/esm/sdk/accounts/liquidations/helpers.js

@@ -1,4 +1,5 @@
-import { PERCENTAGE_FACTOR } from "../../constants/index.js";
+import { slice } from "viem";
+import { ADDRESS_0X0, PERCENTAGE_FACTOR } from "../../constants/index.js";
 import { hexEq } from "../../utils/index.js";
 const DUST_THRESHOLD = 10n;
 function calcRepaymentAmount(totalValue, liquidationDiscount) {
@@ -53,10 +54,53 @@ function toLiquidatorWithdrawals(current, network) {
   }
   return rows;
 }
+function toReceivedAssets(outputs) {
+  return outputs.map((o) => {
+    if (!o.delayed) {
+      return { isDelayed: false, token: o.token, amount: o.amount };
+    }
+    return {
+      isDelayed: true,
+      token: o.token,
+      amount: o.amount,
+      redeemerAddress: hexEq(o.redeemerAddress, ADDRESS_0X0) ? void 0 : o.redeemerAddress,
+      claimableAt: o.claimableAt === 0n ? void 0 : o.claimableAt
+    };
+  });
+}
+function toLiquidationApproval(props) {
+  const { target, creditFacade, creditManager, token, amount } = props;
+  if (amount === 0n) {
+    return void 0;
+  }
+  return {
+    spender: hexEq(target, creditFacade) ? creditManager : target,
+    token,
+    amount
+  };
+}
+function liquidationCallToRawTx(call, description) {
+  return {
+    to: call.target,
+    value: "0",
+    signature: "",
+    callData: call.callData,
+    contractMethod: {
+      name: slice(call.callData, 0, 4),
+      inputs: [],
+      payable: false
+    },
+    contractInputsValues: {},
+    description
+  };
+}
 export {
   DUST_THRESHOLD,
   calcEstimatedProfit,
   calcRepaymentAmount,
+  liquidationCallToRawTx,
   pickMainAsset,
-  toLiquidatorWithdrawals
+  toLiquidationApproval,
+  toLiquidatorWithdrawals,
+  toReceivedAssets
 };

package/dist/esm/sdk/accounts/liquidations/index.js

@@ -1,4 +1,4 @@
-export * from "./helpers.js";
+export * from "./constants.js";
 export * from "./LiquidationsService.js";
 export * from "./MultichainLiquidationsService.js";
 export * from "./types.js";

package/dist/types/abi/ILiquidationCompressorV313.d.ts

@@ -0,0 +1,107 @@
+export declare const iLiquidationCompressorV313Abi: readonly [{
+    readonly type: "function";
+    readonly name: "contractType";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bytes32";
+        readonly internalType: "bytes32";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "getLiquidationData";
+    readonly inputs: readonly [{
+        readonly name: "liquidator";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "creditAccount";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "priceUpdates";
+        readonly type: "tuple[]";
+        readonly internalType: "struct PriceUpdate[]";
+        readonly components: readonly [{
+            readonly name: "priceFeed";
+            readonly type: "address";
+            readonly internalType: "address";
+        }, {
+            readonly name: "data";
+            readonly type: "bytes";
+            readonly internalType: "bytes";
+        }];
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "tuple";
+        readonly internalType: "struct LiquidationData";
+        readonly components: readonly [{
+            readonly name: "requiredUnderlyingAmount";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "expectedOutputs";
+            readonly type: "tuple[]";
+            readonly internalType: "struct LiquidationOutput[]";
+            readonly components: readonly [{
+                readonly name: "token";
+                readonly type: "address";
+                readonly internalType: "address";
+            }, {
+                readonly name: "amount";
+                readonly type: "uint256";
+                readonly internalType: "uint256";
+            }, {
+                readonly name: "delayed";
+                readonly type: "bool";
+                readonly internalType: "bool";
+            }, {
+                readonly name: "redeemerAddress";
+                readonly type: "address";
+                readonly internalType: "address";
+            }, {
+                readonly name: "claimableAt";
+                readonly type: "uint256";
+                readonly internalType: "uint256";
+            }];
+        }, {
+            readonly name: "liquidationCall";
+            readonly type: "tuple";
+            readonly internalType: "struct MultiCall";
+            readonly components: readonly [{
+                readonly name: "target";
+                readonly type: "address";
+                readonly internalType: "address";
+            }, {
+                readonly name: "callData";
+                readonly type: "bytes";
+                readonly internalType: "bytes";
+            }];
+        }, {
+            readonly name: "isLiquidatorEligible";
+            readonly type: "bool";
+            readonly internalType: "bool";
+        }, {
+            readonly name: "kycProtocol";
+            readonly type: "string";
+            readonly internalType: "string";
+        }, {
+            readonly name: "kycToken";
+            readonly type: "address";
+            readonly internalType: "address";
+        }];
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "version";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "view";
+}];

package/dist/types/rewards/rewards/merkl-api.d.ts

@@ -40,7 +40,7 @@ export declare class MerkleXYZApi {
     static defaultDomain: string;
     static angleDomain: string;
     static apiKeyHeader: string;
-    static fetchWithFallback: <T>(getUrl: (domain: string) => string, apiKey?: string) => Promise<import("axios").AxiosResponse<T, any, {}>>;
+    static fetchWithFallback: <T>(getUrl: (domain: string) => string, apiKey?: string) => Promise<import("axios").AxiosResponse<T, any, {}, any>>;
     static getUserRewardsUrl: (options: UserOptions) => (domain: string) => string;
 }
 export {};

package/dist/types/sdk/MultichainSDK.d.ts

@@ -107,7 +107,7 @@ export declare class MultichainSDK<const Plugins extends PluginsMap = {}> {
      * Namespace for liquidatable credit accounts discovery across all
      * configured chains.
      */
-    readonly liquidations: ILiquidationsService;
+    readonly liquidations: ILiquidationsService<true>;
     constructor(options: MultichainSDKOptions<Plugins>);
     /**
      * Attach all configured chains in parallel.

package/dist/types/sdk/accounts/liquidations/LiquidationsService.d.ts

@@ -1,5 +1,6 @@
 import { SDKConstruct } from "../../base/index.js";
-import type { GetLiquidatableAccountsProps, GetLiquidationDetailsProps, GetLiquidatorWithdrawalsProps, ILiquidationsService, LiquidatableAccount, LiquidationDetails, LiquidatorWithdrawal } from "./types.js";
+import type { RawTx } from "../../types/index.js";
+import type { BuildLiquidationTxProps, GetLiquidatableAccountsProps, GetLiquidationDetailsProps, GetLiquidatorWithdrawalsProps, ILiquidationsService, LiquidatableAccount, LiquidationDetails, LiquidatorWithdrawal } from "./types.js";
 /**
  * Per-chain implementation of {@link ILiquidationsService}.
  *
@@ -17,6 +18,10 @@ export declare class LiquidationsService extends SDKConstruct implements ILiquid
      * {@inheritDoc ILiquidationsService.getLiquidationDetails}
      **/
     getLiquidationDetails(props: GetLiquidationDetailsProps): Promise<LiquidationDetails>;
+    /**
+     * {@inheritDoc ILiquidationsService.buildLiquidationTx}
+     **/
+    buildLiquidationTx(props: BuildLiquidationTxProps): Promise<RawTx>;
     /**
      * {@inheritDoc ILiquidationsService.getLiquidatorWithdrawals}
      **/

package/dist/types/sdk/accounts/liquidations/MultichainLiquidationsService.d.ts

@@ -1,27 +1,32 @@
 import type { MultichainSDK } from "../../MultichainSDK.js";
 import type { PluginsMap } from "../../plugins/index.js";
-import type { GetLiquidatableAccountsProps, GetLiquidationDetailsProps, GetLiquidatorWithdrawalsProps, ILiquidationsService, LiquidatableAccount, LiquidationDetails, LiquidatorWithdrawal } from "./types.js";
+import type { RawTx } from "../../types/index.js";
+import type { BuildLiquidationTxProps, GetLiquidatableAccountsProps, GetLiquidationDetailsProps, GetLiquidatorWithdrawalsProps, ILiquidationsService, LiquidatableAccount, LiquidationDetails, LiquidatorWithdrawal } from "./types.js";
 /**
  * Cross-chain implementation of {@link ILiquidationsService}.
  *
  * Aggregates liquidatable accounts over all chains configured in
  * {@link MultichainSDK} (optionally restricted via
- * {@link GetLiquidatableAccountsProps.networks}). A failed chain is logged as
+ * {@link MultichainNetworksProps.networks}). A failed chain is logged as
  * a warning and skipped, so one dead RPC does not empty the whole list.
  **/
-export declare class MultichainLiquidationsService<const Plugins extends PluginsMap = {}> implements ILiquidationsService {
+export declare class MultichainLiquidationsService<const Plugins extends PluginsMap = {}> implements ILiquidationsService<true> {
     #private;
     constructor(sdk: MultichainSDK<Plugins>);
     /**
      * {@inheritDoc ILiquidationsService.getLiquidatableAccounts}
      **/
-    getLiquidatableAccounts(props?: GetLiquidatableAccountsProps): Promise<LiquidatableAccount[]>;
+    getLiquidatableAccounts(props?: GetLiquidatableAccountsProps<true>): Promise<LiquidatableAccount[]>;
     /**
      * {@inheritDoc ILiquidationsService.getLiquidationDetails}
      **/
-    getLiquidationDetails(props: GetLiquidationDetailsProps): Promise<LiquidationDetails>;
+    getLiquidationDetails(props: GetLiquidationDetailsProps<true>): Promise<LiquidationDetails>;
+    /**
+     * {@inheritDoc ILiquidationsService.buildLiquidationTx}
+     **/
+    buildLiquidationTx(props: BuildLiquidationTxProps<true>): Promise<RawTx>;
     /**
      * {@inheritDoc ILiquidationsService.getLiquidatorWithdrawals}
      **/
-    getLiquidatorWithdrawals(props: GetLiquidatorWithdrawalsProps): Promise<LiquidatorWithdrawal[]>;
+    getLiquidatorWithdrawals(props: GetLiquidatorWithdrawalsProps<true>): Promise<LiquidatorWithdrawal[]>;
 }

package/dist/types/sdk/accounts/liquidations/constants.d.ts

@@ -0,0 +1,6 @@
+import type { Address } from "viem";
+/**
+ * TODO: the contract is not deployed yet, replace with the real address
+ * (per-network lookup if it ends up being deployed on several chains).
+ **/
+export declare const LIQUIDATION_COMPRESSOR_V313_ADDRESS: Address;

package/dist/types/sdk/accounts/liquidations/helpers.d.ts

@@ -1,8 +1,22 @@
-import type { Address } from "viem";
+import type { Address, ContractFunctionReturnType } from "viem";
+import type { iLiquidationCompressorV313Abi } from "../../../abi/ILiquidationCompressorV313.js";
 import type { CreditAccountData } from "../../base/index.js";
 import type { NetworkType } from "../../chain/index.js";
+import type { RawTx } from "../../types/index.js";
 import type { CurrentWithdrawals } from "../withdrawal-compressor/index.js";
-import type { LiquidatorWithdrawal } from "./types.js";
+import type { LiquidationApproval, LiquidatorWithdrawal, ReceivedAsset } from "./types.js";
+/**
+ * Raw `LiquidationData` returned by `LiquidationCompressor.getLiquidationData`.
+ **/
+export type OnchainLiquidationData = ContractFunctionReturnType<typeof iLiquidationCompressorV313Abi, "nonpayable", "getLiquidationData">;
+/**
+ * Single element of {@link OnchainLiquidationData.expectedOutputs}.
+ **/
+export type OnchainLiquidationOutput = OnchainLiquidationData["expectedOutputs"][number];
+/**
+ * Single call built by the liquidation compressor.
+ **/
+export type OnchainLiquidationCall = OnchainLiquidationData["liquidationCall"];
 /**
  * Token balances at or below this threshold are treated as dust and ignored,
  * consistent with the rest of the SDK (see `filterDust`).
@@ -44,3 +58,60 @@ export declare function pickMainAsset(ca: CreditAccountData, convert: (token: Ad
  * @param network - Network the withdrawals live on
  **/
 export declare function toLiquidatorWithdrawals(current: CurrentWithdrawals, network: NetworkType): LiquidatorWithdrawal[];
+/**
+ * Normalizes the liquidation compressor outputs into assets the liquidator
+ * receives. Zero `redeemerAddress` and `claimableAt` (used by the contracts
+ * for "not applicable") become `undefined`.
+ *
+ * @param outputs - `expectedOutputs` of the compressor's liquidation data
+ **/
+export declare function toReceivedAssets(outputs: readonly OnchainLiquidationOutput[]): ReceivedAsset[];
+/**
+ * Props for {@link toLiquidationApproval}.
+ **/
+export interface ToLiquidationApprovalProps {
+    /**
+     * Target of the compressor's `liquidationCall`.
+     **/
+    target: Address;
+    /**
+     * Credit facade of the liquidated account's credit manager.
+     **/
+    creditFacade: Address;
+    /**
+     * Credit manager of the liquidated account.
+     **/
+    creditManager: Address;
+    /**
+     * Token the liquidation transaction pulls from the liquidator.
+     **/
+    token: Address;
+    /**
+     * Amount of `token` the liquidation transaction pulls.
+     **/
+    amount: bigint;
+}
+/**
+ * Resolves the approval the liquidator must grant for the liquidation call.
+ *
+ * A call targeting the credit facade is paid by `msg.sender` but transferred by
+ * the credit manager, so the latter is the spender. Any other target is a
+ * dedicated liquidator contract (Midas / Securitize) that pulls the token to
+ * itself and re-approves the credit manager, so it is the spender itself.
+ *
+ * @param props - See {@link ToLiquidationApprovalProps}
+ * @returns The approval, or `undefined` when the call pulls nothing
+ **/
+export declare function toLiquidationApproval(props: ToLiquidationApprovalProps): LiquidationApproval | undefined;
+/**
+ * Converts the compressor's liquidation call into a raw transaction.
+ *
+ * The calldata is passed through as-is: depending on the liquidated assets,
+ * the target is either the credit facade or a dedicated liquidator contract
+ * (with its own function signature), so it cannot be re-encoded from a single
+ * known ABI.
+ *
+ * @param call - `liquidationCall` of the compressor's liquidation data
+ * @param description - Optional human-readable description
+ **/
+export declare function liquidationCallToRawTx(call: OnchainLiquidationCall, description?: string): RawTx;

package/dist/types/sdk/accounts/liquidations/index.d.ts

@@ -1,4 +1,4 @@
-export * from "./helpers.js";
+export * from "./constants.js";
 export * from "./LiquidationsService.js";
 export * from "./MultichainLiquidationsService.js";
 export * from "./types.js";

package/dist/types/sdk/accounts/liquidations/types.d.ts

@@ -1,17 +1,35 @@
 import type { Address } from "viem";
 import type { Asset } from "../../base/index.js";
 import type { NetworkType } from "../../chain/index.js";
+import type { RawTx } from "../../types/index.js";
 /**
- * Filters for {@link ILiquidationsService.getLiquidatableAccounts}.
- * All filters are optional and applied after liquidatable accounts are fetched.
+ * Selects the chain for single-account methods of a multichain service.
  **/
-export interface GetLiquidatableAccountsProps {
+export interface MultichainNetworkProps {
     /**
-     * Networks to query. On {@link MultichainLiquidationsService} selects which
-     * chains to query; a single-chain service returns an empty list when its
-     * own network is excluded.
+     * Network the credit account lives on.
+     **/
+    network: NetworkType;
+}
+/**
+ * Restricts which chains a multichain list method queries.
+ **/
+export interface MultichainNetworksProps {
+    /**
+     * Networks to query. All chains configured in {@link MultichainSDK} when
+     * omitted.
      **/
     networks?: NetworkType[];
+}
+/**
+ * Adds chain-scoping props `T` only when the service spans multiple chains.
+ **/
+export type WithMultichain<Multichain extends boolean, T extends object> = Multichain extends true ? T : {};
+/**
+ * Chain-independent part of {@link GetLiquidatableAccountsProps}.
+ * All filters are optional and applied after liquidatable accounts are fetched.
+ **/
+export interface GetLiquidatableAccountsPropsBase {
     /**
      * Only return accounts whose main liquidated {@link LiquidatableAccount.asset}
      * is one of these tokens.
@@ -23,6 +41,10 @@ export interface GetLiquidatableAccountsProps {
      **/
     delayed?: boolean;
 }
+/**
+ * Props for {@link ILiquidationsService.getLiquidatableAccounts}.
+ **/
+export type GetLiquidatableAccountsProps<Multichain extends boolean = false> = GetLiquidatableAccountsPropsBase & WithMultichain<Multichain, MultichainNetworksProps>;
 /**
  * A credit account that can be liquidated, with amounts precomputed for
  * manual liquidation via the frontend.
@@ -75,23 +97,54 @@ export interface LiquidatableAccount {
     isDelayed: boolean;
 }
 /**
- * Props for {@link ILiquidationsService.getLiquidationDetails}.
+ * Chain-independent part of {@link GetLiquidationDetailsProps}.
  **/
-export interface GetLiquidationDetailsProps {
-    /**
-     * Network the credit account lives on.
-     **/
-    network: NetworkType;
+export interface GetLiquidationDetailsPropsBase {
     /**
      * Credit account to get liquidation details for.
      **/
     creditAccount: Address;
     /**
-     * Liquidator wallet address. Reserved for future RWA KYC gating;
-     * accepted but not checked yet.
+     * Liquidator wallet address, used by the liquidation compressor to check
+     * KYC eligibility. When omitted, the zero address is used: amounts and
+     * received assets are unaffected, but {@link LiquidationDetails.isLiquidatorEligible}
+     * then only tells whether the liquidation is KYC-gated at all
+     * (see {@link LiquidationDetails.kycProtocol}).
      **/
     liquidator?: Address;
+    /**
+     * If true, reserve price feed updates are excluded from the price updates
+     * applied by the compressor before computing amounts.
+     **/
+    ignoreReservePrices?: boolean;
+}
+/**
+ * Props for {@link ILiquidationsService.getLiquidationDetails}.
+ **/
+export type GetLiquidationDetailsProps<Multichain extends boolean = false> = GetLiquidationDetailsPropsBase & WithMultichain<Multichain, MultichainNetworkProps>;
+/**
+ * Chain-independent part of {@link BuildLiquidationTxProps}.
+ **/
+export interface BuildLiquidationTxPropsBase {
+    /**
+     * Credit account to liquidate.
+     **/
+    creditAccount: Address;
+    /**
+     * Liquidator wallet address. Required: it is encoded into the transaction
+     * as the receiver of the liquidated collateral.
+     **/
+    liquidator: Address;
+    /**
+     * If true, reserve price feed updates are excluded from the price updates
+     * applied by the compressor before building the transaction.
+     **/
+    ignoreReservePrices?: boolean;
 }
+/**
+ * Props for {@link ILiquidationsService.buildLiquidationTx}.
+ **/
+export type BuildLiquidationTxProps<Multichain extends boolean = false> = BuildLiquidationTxPropsBase & WithMultichain<Multichain, MultichainNetworkProps>;
 /**
  * A token received directly from the credit account balance upon liquidation.
  **/
@@ -122,9 +175,10 @@ export interface DelayedReceivedAsset {
      **/
     amount: bigint;
     /**
-     * Source asset spent by the delayed withdrawal (e.g. ACRED).
+     * Redeemer contract transferred to the liquidator, from which `token`
+     * becomes claimable. `undefined` when the compressor does not report one.
      **/
-    sourceToken: Address;
+    redeemerAddress?: Address;
     /**
      * Estimated unix timestamp (in seconds) when a pending withdrawal becomes
      * claimable. `undefined` means the withdrawal is claimable now.
@@ -136,21 +190,19 @@ export interface DelayedReceivedAsset {
  **/
 export type ReceivedAsset = InstantReceivedAsset | DelayedReceivedAsset;
 /**
- * Props for {@link ILiquidationsService.getLiquidatorWithdrawals}.
+ * Chain-independent part of {@link GetLiquidatorWithdrawalsProps}.
  **/
-export interface GetLiquidatorWithdrawalsProps {
-    /**
-     * Networks to query. On {@link MultichainLiquidationsService} selects which
-     * chains to query; a single-chain service returns an empty list when its
-     * own network is excluded.
-     **/
-    networks?: NetworkType[];
+export interface GetLiquidatorWithdrawalsPropsBase {
     /**
      * Liquidator wallet that owns the redemption receipts (redeemer contracts
      * received as a result of liquidations).
      **/
     liquidator: Address;
 }
+/**
+ * Props for {@link ILiquidationsService.getLiquidatorWithdrawals}.
+ **/
+export type GetLiquidatorWithdrawalsProps<Multichain extends boolean = false> = GetLiquidatorWithdrawalsPropsBase & WithMultichain<Multichain, MultichainNetworksProps>;
 /**
  * A single delayed-withdrawal position owned by the liquidator.
  *
@@ -183,8 +235,33 @@ export interface LiquidatorWithdrawal {
     claimableAt?: bigint;
 }
 /**
- * Detailed information about a liquidatable credit account, extending the
- * list row with the full breakdown of assets the liquidator receives.
+ * ERC-20 approval the liquidator must grant before sending the liquidation
+ * transaction.
+ **/
+export interface LiquidationApproval {
+    /**
+     * Address to approve: the credit manager when the liquidation goes directly
+     * through the credit facade (the facade forwards `msg.sender` as the payer
+     * and the credit manager executes the transfer), or the dedicated liquidator
+     * contract (Midas / Securitize) when the liquidation goes through one, since
+     * such contracts pull the token to themselves first.
+     **/
+    spender: Address;
+    /**
+     * Token pulled from the liquidator: the credit manager underlying.
+     **/
+    token: Address;
+    /**
+     * Amount to approve, equal to the amount the liquidation transaction pulls.
+     * The Securitize liquidator recomputes it on-chain, so approving with some
+     * headroom is advisable in case prices move.
+     **/
+    amount: bigint;
+}
+/**
+ * Detailed information about a liquidatable credit account, including
+ * the full breakdown of assets the liquidator receives.
+ *
  **/
 export interface LiquidationDetails extends LiquidatableAccount {
     /**
@@ -193,13 +270,41 @@ export interface LiquidationDetails extends LiquidatableAccount {
      * pending).
      **/
     receivedAssets: ReceivedAsset[];
+    /**
+     * Whether the liquidator passes the KYC checks of the liquidated assets.
+     * When {@link GetLiquidationDetailsPropsBase.liquidator} was not provided,
+     * `false` only means that the liquidation is KYC-gated, not that a
+     * particular wallet was rejected.
+     **/
+    isLiquidatorEligible: boolean;
+    /**
+     * Name of the KYC protocol the liquidator must be whitelisted in
+     * (e.g. `"securitize"`). `undefined` when the liquidation is not KYC-gated.
+     **/
+    kycProtocol?: string;
+    /**
+     * Token the liquidator must be whitelisted for in {@link kycProtocol}.
+     * `undefined` when the liquidation is not KYC-gated.
+     **/
+    kycToken?: Address;
+    /**
+     * ERC-20 approval required before sending the liquidation transaction.
+     * `undefined` when the selected liquidation path needs no capital from the
+     * liquidator, i.e. {@link repaymentAmount} is zero.
+     **/
+    approve?: LiquidationApproval;
 }
 /**
  * Service for discovering liquidatable credit accounts and previewing manual
  * liquidations. Implemented per-chain by {@link LiquidationsService} and
  * across all configured chains by {@link MultichainLiquidationsService}.
+ *
+ * @typeParam Multichain - When `true`, props select the chain to operate on:
+ * {@link MultichainNetworkProps} for single-account methods and
+ * {@link MultichainNetworksProps} for list methods. A per-chain service
+ * operates on the network its SDK is attached to and takes no network props.
  **/
-export interface ILiquidationsService {
+export interface ILiquidationsService<Multichain extends boolean = false> {
     /**
      * Returns all liquidatable credit accounts: accounts with health factor
      * below 1 plus accounts of expired credit managers with outstanding debt.
@@ -207,7 +312,7 @@ export interface ILiquidationsService {
      *
      * @param props - Optional filters, see {@link GetLiquidatableAccountsProps}
      **/
-    getLiquidatableAccounts(props?: GetLiquidatableAccountsProps): Promise<LiquidatableAccount[]>;
+    getLiquidatableAccounts(props?: GetLiquidatableAccountsProps<Multichain>): Promise<LiquidatableAccount[]>;
     /**
      * Returns detailed information about a liquidatable credit account,
      * including the full list of assets the liquidator receives.
@@ -215,7 +320,14 @@ export interface ILiquidationsService {
      * @param props - See {@link GetLiquidationDetailsProps}
      * @throws When the account is not found or its collateral computation fails.
      **/
-    getLiquidationDetails(props: GetLiquidationDetailsProps): Promise<LiquidationDetails>;
+    getLiquidationDetails(props: GetLiquidationDetailsProps<Multichain>): Promise<LiquidationDetails>;
+    /**
+     * Builds the transaction that fully liquidates a credit account, repaying
+     * the debt from own funds and receiving the collateral from the credit account.
+     *
+     * @param props - See {@link BuildLiquidationTxProps}
+     **/
+    buildLiquidationTx(props: BuildLiquidationTxProps<Multichain>): Promise<RawTx>;
     /**
      * Returns the status of delayed-withdrawal positions (redemption receipts)
      * owned by a liquidator wallet: what is receivable, how much, and when it
@@ -223,5 +335,5 @@ export interface ILiquidationsService {
      *
      * @param props - See {@link GetLiquidatorWithdrawalsProps}
      **/
-    getLiquidatorWithdrawals(props: GetLiquidatorWithdrawalsProps): Promise<LiquidatorWithdrawal[]>;
+    getLiquidatorWithdrawals(props: GetLiquidatorWithdrawalsProps<Multichain>): Promise<LiquidatorWithdrawal[]>;
 }