@gearbox-protocol/sdk 14.11.3 → 14.12.0-next.2

package/dist/esm/plugins/adapters/contracts/AccountMigratorAdapterContract.js

@@ -12,6 +12,15 @@ class AccountMigratorAdapterContract extends AbstractAdapterContract {
       `classifyLegacyOperation is not supported for legacy adapter: ${this.contractType}`
     );
   }
+  /**
+   * The account-migrator adapter's `execute` targets the migrator bot, not an
+   * external protocol, so there is no protocol-level call to recover. Returning
+   * `undefined` keeps the `protocol` field aligned with its external-protocol
+   * semantics (see {@link TraceAdapterExt}).
+   */
+  parseProtocolCall(_trace, _strict) {
+    return void 0;
+  }
 }
 export {
   AccountMigratorAdapterContract

package/dist/esm/preview/index.js

@@ -0,0 +1,4 @@
+export * from "./parse/index.js";
+export * from "./prerequisites/index.js";
+export * from "./simulate/index.js";
+export * from "./trace/index.js";

package/dist/esm/preview/package.json

@@ -0,0 +1 @@
+{"type": "module","sideEffects":false}

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

@@ -0,0 +1,68 @@
+import { AbstractAdapterContract } from "../../plugins/adapters/index.js";
+function classifyInnerOperations(calls, props) {
+  const { sdk, underlying } = props;
+  const result = [];
+  for (const call of calls) {
+    const contract = sdk.getContract(call.target);
+    if (contract instanceof AbstractAdapterContract || contract === void 0) {
+      result.push({
+        operation: "Execute",
+        adapter: call.target,
+        adapterType: call.contractType,
+        version: call.version,
+        label: call.label,
+        adapterFunctionName: call.functionName,
+        adapterArgs: call.rawArgs
+      });
+      continue;
+    }
+    const op = classifyFacadeInnerCall(call, underlying);
+    if (op) {
+      result.push(op);
+    }
+  }
+  return result;
+}
+function classifyFacadeInnerCall(call, underlying) {
+  const functionName = call.functionName.split("(")[0];
+  const { rawArgs } = call;
+  switch (functionName) {
+    case "increaseDebt":
+      return {
+        operation: "IncreaseBorrowedAmount",
+        token: underlying,
+        amount: rawArgs.amount
+      };
+    case "decreaseDebt":
+      return {
+        operation: "DecreaseBorrowedAmount",
+        token: underlying,
+        amount: rawArgs.amount
+      };
+    case "addCollateral":
+    case "addCollateralWithPermit":
+      return {
+        operation: "AddCollateral",
+        token: rawArgs.token,
+        amount: rawArgs.amount
+      };
+    case "withdrawCollateral":
+      return {
+        operation: "WithdrawCollateral",
+        token: rawArgs.token,
+        amount: rawArgs.amount,
+        to: rawArgs.to
+      };
+    case "updateQuota":
+      return {
+        operation: "UpdateQuota",
+        token: rawArgs.token,
+        change: rawArgs.quotaChange
+      };
+    default:
+      return null;
+  }
+}
+export {
+  classifyInnerOperations
+};

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

@@ -0,0 +1,24 @@
+import { UnsupportedZapperFunctionError } from "../../sdk/index.js";
+class UnsupportedTargetError extends Error {
+  target;
+  constructor(target) {
+    super(`unsupported transaction target: ${target}`);
+    this.name = "UnsupportedTargetError";
+    this.target = target;
+  }
+}
+class UnsupportedPoolFunctionError extends Error {
+  pool;
+  functionName;
+  constructor(pool, functionName) {
+    super(`unsupported pool function "${functionName}" on ${pool}`);
+    this.name = "UnsupportedPoolFunctionError";
+    this.pool = pool;
+    this.functionName = functionName;
+  }
+}
+export {
+  UnsupportedPoolFunctionError,
+  UnsupportedTargetError,
+  UnsupportedZapperFunctionError
+};

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

@@ -0,0 +1,24 @@
+function extractExpectedBalanceChanges(innerCalls) {
+  const calls = innerCalls.filter(
+    (call) => functionName(call) !== "onDemandPriceUpdates"
+  );
+  if (calls.length === 0) {
+    return void 0;
+  }
+  const first = calls[0];
+  const last = calls[calls.length - 1];
+  if (functionName(first) !== "storeExpectedBalances" || functionName(last) !== "compareBalances") {
+    return void 0;
+  }
+  const balanceDeltas = first.rawArgs.balanceDeltas;
+  if (!balanceDeltas) {
+    return void 0;
+  }
+  return balanceDeltas.map(({ token, amount }) => ({ token, delta: amount }));
+}
+function functionName(call) {
+  return call.functionName.split("(")[0];
+}
+export {
+  extractExpectedBalanceChanges
+};

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

@@ -0,0 +1,7 @@
+export * from "./classifyInnerOperations.js";
+export * from "./errors.js";
+export * from "./extractExpectedBalanceChanges.js";
+export * from "./parseFacadeOperationCalldata.js";
+export * from "./parseOperationCalldata.js";
+export * from "./parsePoolOperationCalldata.js";
+export * from "./types.js";

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

@@ -0,0 +1,91 @@
+import { isAddressEqual, zeroAddress } from "viem";
+import { classifyInnerOperations } from "./classifyInnerOperations.js";
+import { extractExpectedBalanceChanges } from "./extractExpectedBalanceChanges.js";
+function parseFacadeOperationCalldata(props) {
+  const { sdk, facade, calldata } = props;
+  const parsed = sdk.parseFunctionDataV2(facade.address, calldata);
+  const functionName = parsed.functionName.split("(")[0];
+  const { rawArgs } = parsed;
+  const suite = sdk.marketRegister.creditManagers.find(
+    (cm) => isAddressEqual(cm.creditFacade.address, facade.address)
+  );
+  if (!suite) {
+    throw new Error(`no credit suite found for facade ${facade.address}`);
+  }
+  const metadata = {
+    creditManager: suite.creditManager.address,
+    creditFacade: facade.address
+  };
+  const innerCalls = rawArgs.calls ?? [];
+  const multicall = classifyInnerOperations(innerCalls, {
+    sdk,
+    underlying: suite.underlying
+  });
+  const expectedBalanceChanges = extractExpectedBalanceChanges(innerCalls);
+  switch (functionName) {
+    case "multicall":
+      return {
+        ...metadata,
+        operation: "MultiCall",
+        creditAccount: rawArgs.creditAccount,
+        multicall,
+        expectedBalanceChanges
+      };
+    case "botMulticall":
+      return {
+        ...metadata,
+        operation: "BotMulticall",
+        creditAccount: rawArgs.creditAccount,
+        multicall,
+        expectedBalanceChanges
+      };
+    case "openCreditAccount":
+      return {
+        ...metadata,
+        operation: "OpenCreditAccount",
+        creditAccount: zeroAddress,
+        onBehalfOf: rawArgs.onBehalfOf,
+        referralCode: rawArgs.referralCode,
+        multicall,
+        expectedBalanceChanges
+      };
+    case "closeCreditAccount":
+      return {
+        ...metadata,
+        operation: "CloseCreditAccount",
+        creditAccount: rawArgs.creditAccount,
+        multicall,
+        expectedBalanceChanges
+      };
+    case "liquidateCreditAccount":
+      return {
+        ...metadata,
+        operation: "LiquidateCreditAccount",
+        creditAccount: rawArgs.creditAccount,
+        to: rawArgs.to,
+        // `token` and `remainingFunds` are only emitted on-chain during
+        // liquidation, so they are not recoverable from raw calldata.
+        token: zeroAddress,
+        remainingFunds: 0n,
+        multicall,
+        expectedBalanceChanges
+      };
+    case "partiallyLiquidateCreditAccount":
+      return {
+        ...metadata,
+        operation: "PartiallyLiquidateCreditAccount",
+        creditAccount: rawArgs.creditAccount,
+        token: rawArgs.token,
+        repaidAmount: rawArgs.repaidAmount,
+        minSeizedAmount: rawArgs.minSeizedAmount,
+        to: rawArgs.to
+      };
+    default:
+      throw new Error(
+        `unsupported credit facade function "${parsed.functionName}" on ${facade.address}`
+      );
+  }
+}
+export {
+  parseFacadeOperationCalldata
+};

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

@@ -0,0 +1,55 @@
+import {
+  CreditFacadeV310Contract,
+  PoolV310Contract,
+  ZapperContract
+} from "../../sdk/index.js";
+import { UnsupportedTargetError } from "./errors.js";
+import { parseFacadeOperationCalldata } from "./parseFacadeOperationCalldata.js";
+import { parsePoolOperationCalldata } from "./parsePoolOperationCalldata.js";
+function parseOperationCalldata(input) {
+  const { sdk, to, calldata, value, sender } = input;
+  const contract = sdk.getContract(to);
+  if (contract instanceof PoolV310Contract) {
+    return parsePoolOperationCalldata({ sdk, pool: contract, calldata });
+  }
+  if (contract instanceof ZapperContract) {
+    const parsed = contract.parseOperation(calldata, value);
+    if (parsed.operation === "Deposit") {
+      const op2 = {
+        operation: "Deposit",
+        pool: parsed.pool,
+        receiver: parsed.receiver,
+        assets: parsed.assets,
+        underlying: parsed.underlying,
+        tokenIn: parsed.token,
+        zapper: parsed.zapper,
+        referralCode: parsed.referralCode
+      };
+      return op2;
+    }
+    const op = {
+      operation: "Redeem",
+      pool: parsed.pool,
+      receiver: parsed.receiver,
+      // The zapper burns the caller's pool shares, so the share owner is the
+      // transaction sender.
+      owner: sender,
+      shares: parsed.shares,
+      underlying: parsed.underlying,
+      tokenOut: parsed.token,
+      zapper: parsed.zapper
+    };
+    return op;
+  }
+  if (contract instanceof CreditFacadeV310Contract) {
+    return parseFacadeOperationCalldata({
+      sdk,
+      facade: contract,
+      calldata
+    });
+  }
+  throw new UnsupportedTargetError(to);
+}
+export {
+  parseOperationCalldata
+};

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

@@ -0,0 +1,61 @@
+import { UnsupportedPoolFunctionError } from "./errors.js";
+function parsePoolOperationCalldata(props) {
+  const { sdk, pool, calldata } = props;
+  const parsed = sdk.parseFunctionDataV2(pool.address, calldata);
+  const functionName = parsed.functionName.split("(")[0];
+  const { rawArgs } = parsed;
+  const underlying = pool.underlying;
+  switch (functionName) {
+    case "deposit":
+    case "depositWithReferral":
+      return {
+        operation: "Deposit",
+        pool: pool.address,
+        receiver: rawArgs.receiver,
+        assets: rawArgs.assets,
+        underlying,
+        tokenIn: underlying,
+        zapper: void 0,
+        referralCode: functionName === "depositWithReferral" ? rawArgs.referralCode : void 0
+      };
+    case "mint":
+    case "mintWithReferral":
+      return {
+        operation: "Mint",
+        pool: pool.address,
+        receiver: rawArgs.receiver,
+        shares: rawArgs.shares,
+        underlying,
+        tokenIn: underlying,
+        zapper: void 0,
+        referralCode: functionName === "mintWithReferral" ? rawArgs.referralCode : void 0
+      };
+    case "withdraw":
+      return {
+        operation: "Withdraw",
+        pool: pool.address,
+        receiver: rawArgs.receiver,
+        owner: rawArgs.owner,
+        assets: rawArgs.assets,
+        underlying,
+        tokenOut: underlying,
+        zapper: void 0
+      };
+    case "redeem":
+      return {
+        operation: "Redeem",
+        pool: pool.address,
+        receiver: rawArgs.receiver,
+        owner: rawArgs.owner,
+        shares: rawArgs.shares,
+        underlying,
+        tokenOut: underlying,
+        zapper: void 0
+      };
+    default:
+      throw new UnsupportedPoolFunctionError(pool.address, parsed.functionName);
+  }
+}
+export {
+  parsePoolOperationCalldata
+};

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

@@ -0,0 +1,9 @@
+export * from "./types-adapters.js";
+export * from "./types-facades.js";
+export * from "./types-pools.js";
+function isPoolOperation(tx) {
+  return tx.operation === "Deposit" || tx.operation === "Mint" || tx.operation === "Withdraw" || tx.operation === "Redeem";
+}
+export {
+  isPoolOperation
+};

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

@@ -0,0 +1,57 @@
+import { erc20Abi } from "viem";
+import {
+  Prerequisite,
+  toPrerequisiteError
+} from "./Prerequisite.js";
+class AllowancePrerequisite extends Prerequisite {
+  _id;
+  _title;
+  _detail;
+  constructor(props) {
+    super();
+    this._id = props.id ?? `allowance:${props.token}:${props.owner}:${props.spender}`;
+    this._title = props.title ?? "Token approval";
+    this._detail = {
+      token: props.token,
+      owner: props.owner,
+      spender: props.spender,
+      required: props.required
+    };
+  }
+  get id() {
+    return this._id;
+  }
+  get kind() {
+    return "allowance";
+  }
+  get title() {
+    return this._title;
+  }
+  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;
+    return this.satisfiedResult(actual >= this._detail.required, {
+      ...this._detail,
+      actual
+    });
+  }
+}
+export {
+  AllowancePrerequisite
+};

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

@@ -0,0 +1,56 @@
+import { erc20Abi } from "viem";
+import {
+  Prerequisite,
+  toPrerequisiteError
+} from "./Prerequisite.js";
+class BalancePrerequisite extends Prerequisite {
+  _id;
+  _title;
+  _detail;
+  constructor(props) {
+    super();
+    this._id = props.id ?? `balance:${props.token}:${props.owner}`;
+    this._title = props.title ?? "Sufficient balance";
+    this._detail = {
+      token: props.token,
+      owner: props.owner,
+      required: props.required
+    };
+  }
+  get id() {
+    return this._id;
+  }
+  get kind() {
+    return "balance";
+  }
+  get title() {
+    return this._title;
+  }
+  get detail() {
+    return this._detail;
+  }
+  calls() {
+    return [
+      {
+        address: this._detail.token,
+        abi: erc20Abi,
+        functionName: "balanceOf",
+        args: [this._detail.owner]
+      }
+    ];
+  }
+  resolve(slice) {
+    const res = slice[0];
+    if (!res || res.status === "failure") {
+      return this.errorResult(toPrerequisiteError(res?.error));
+    }
+    const actual = res.result;
+    return this.satisfiedResult(actual >= this._detail.required, {
+      ...this._detail,
+      actual
+    });
+  }
+}
+export {
+  BalancePrerequisite
+};

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

@@ -0,0 +1,63 @@
+import {
+  BaseError,
+  ContractFunctionRevertedError
+} from "viem";
+function toPrerequisiteError(cause) {
+  if (cause instanceof BaseError) {
+    const reverted = cause.walk(
+      (e) => e instanceof ContractFunctionRevertedError
+    );
+    if (reverted instanceof ContractFunctionRevertedError) {
+      return {
+        reason: reverted.data?.errorName ?? reverted.shortMessage ?? "reverted",
+        cause
+      };
+    }
+    return { reason: cause.shortMessage ?? cause.name, cause };
+  }
+  if (cause instanceof Error) {
+    return { reason: cause.message, cause };
+  }
+  return { reason: "unknown error", cause };
+}
+class Prerequisite {
+  /**
+   * Verifies this prerequisite on its own using an `allowFailure` multicall.
+   * Prefer `verifyPrerequisites` to batch several checks into one round-trip.
+   */
+  async verify(ctx) {
+    const calls = this.calls(ctx);
+    const results = await ctx.sdk.client.multicall({
+      allowFailure: true,
+      contracts: calls,
+      // `undefined` lets viem read at `latest`; `blockNumber` is only set for
+      // testnet forks pinned to a specific block.
+      blockNumber: ctx.blockNumber
+    });
+    return this.resolve(results);
+  }
+  /** Builds a successful result; `detail` carries the on-chain `actual`. */
+  satisfiedResult(satisfied, detail) {
+    return {
+      id: this.id,
+      kind: this.kind,
+      title: this.title,
+      detail,
+      satisfied
+    };
+  }
+  /** Builds a failed result from a decoded read error. */
+  errorResult(error) {
+    return {
+      id: this.id,
+      kind: this.kind,
+      title: this.title,
+      detail: this.detail,
+      error
+    };
+  }
+}
+export {
+  Prerequisite,
+  toPrerequisiteError
+};