@gearbox-protocol/sdk 12.8.1 → 12.9.0-txparser.2

package/dist/types/plugins/adapters/contracts/AbstractAdapter.d.ts

@@ -1,13 +1,55 @@
-import type { Abi, Address } from "viem";
-import type { AdapterData, ConstructOptions } from "../../../sdk/index.js";
+import { type Abi, type Address, type Hex, type PartialBy } from "viem";
+import type { ConstructOptions, ParsedCallV2, RelaxedBaseParams } from "../../../sdk/index.js";
 import { BaseContract } from "../../../sdk/index.js";
-import type { AdapterContractType } from "../types.js";
-export interface AbstractAdapterContractOptions<abi extends Abi | readonly unknown[]> extends AdapterData {
-    abi: abi;
+import type { LegacyAdapterOperation, Transfers } from "../legacyAdapterOperations.js";
+import type { AdapterContractType, AdapterOperation, TokenTransfer } from "../types.js";
+export interface ConcreteAdapterContractOptions {
+    baseParams: RelaxedBaseParams;
+    targetContract?: Address;
     name?: string;
 }
-export declare class AbstractAdapterContract<const abi extends Abi | readonly unknown[]> extends BaseContract<abi> {
-    readonly targetContract: Address;
-    constructor(options: ConstructOptions, args: AbstractAdapterContractOptions<abi>);
+export interface AbstractAdapterContractOptions<abi extends Abi | readonly unknown[], protocolAbi extends Abi | readonly unknown[]> extends ConcreteAdapterContractOptions {
+    abi: abi;
+    /**
+     * The ABI of targetContract
+     */
+    protocolAbi: protocolAbi;
+}
+export declare class AbstractAdapterContract<const abi extends Abi | readonly unknown[], const protocolAbi extends Abi | readonly unknown[]> extends BaseContract<abi> {
+    #private;
+    readonly protocolAbi: protocolAbi;
+    constructor(options: ConstructOptions, args: AbstractAdapterContractOptions<abi, protocolAbi>);
+    get targetContract(): Address;
     get adapterType(): AdapterContractType;
+    /**
+     * Builds an {@link AdapterOperation} from a parsed call and ordered transfer entries.
+     *
+     * Returns `PartialBy<AdapterOperation, "targetContract">` because the adapter
+     * may not have `targetContract` (adapters created without SDK do not have serializedParams)
+     *
+     * @param protocolCalldata Raw calldata of the actual CALL to targetContract, extracted from trace
+     * @param strict When true, throws if protocol ABI is missing or decode fails
+     */
+    parseAdapterOperation(parsed: ParsedCallV2, transfers: TokenTransfer[], creditAccount: Address, protocolCalldata: Hex, strict?: boolean): PartialBy<AdapterOperation, "protocol">;
+    /**
+     * Decodes protocol-level function name and args from the raw calldata
+     * sent to targetContract.
+     */
+    protected parseProtocolCall(calldata: Hex, strict?: boolean): {
+        protocolFunctionName: string;
+        protocolArgs: Record<string, unknown>;
+    };
+    /**
+     * Classifies an adapter call into a {@link LegacyAdapterOperation} using the
+     * parsed call and credit-account transfer deltas.
+     *
+     * Default: replicates charts_server fallback —
+     * - no positive transfers (swap.to is zero) → {@link MakerDeposit}
+     * - otherwise → generic {@link Swap}
+     *
+     * Override in protocol-specific subclasses for richer classification.
+     *
+     * @see https://github.com/Gearbox-protocol/charts_server/blob/master/core/account_operation.go#L238-L264
+     */
+    protected classifyLegacyOperation(_parsed: ParsedCallV2, transfers: Transfers): LegacyAdapterOperation;
 }

package/dist/types/plugins/adapters/contracts/AccountMigratorAdapterContract.d.ts

@@ -1,5 +1,6 @@
-import type { ConstructOptions } from "../../../sdk/index.js";
-import type { AbstractAdapterContractOptions } from "./AbstractAdapter.js";
+import type { ConstructOptions, ParsedCallV2 } from "../../../sdk/index.js";
+import type { LegacyAdapterOperation, Transfers } from "../legacyAdapterOperations.js";
+import type { ConcreteAdapterContractOptions } from "./AbstractAdapter.js";
 import { AbstractAdapterContract } from "./AbstractAdapter.js";
 declare const abi: readonly [{
     readonly type: "constructor";
@@ -232,7 +233,240 @@ declare const abi: readonly [{
     readonly inputs: readonly [];
 }];
 type abi = typeof abi;
-export declare class AccountMigratorAdapterContract extends AbstractAdapterContract<abi> {
-    constructor(options: ConstructOptions, args: Omit<AbstractAdapterContractOptions<abi>, "abi">);
+declare const protocolAbi: readonly [{
+    readonly type: "constructor";
+    readonly inputs: readonly [{
+        readonly name: "_creditManager";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "_targetContract";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "acl";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly stateMutability: "view";
+}, {
+    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: "creditManager";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "lock";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "locked";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+        readonly internalType: "bool";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "migrate";
+    readonly inputs: readonly [{
+        readonly name: "params";
+        readonly type: "tuple";
+        readonly internalType: "struct MigrationParams";
+        readonly components: readonly [{
+            readonly name: "accountOwner";
+            readonly type: "address";
+            readonly internalType: "address";
+        }, {
+            readonly name: "sourceCreditAccount";
+            readonly type: "address";
+            readonly internalType: "address";
+        }, {
+            readonly name: "targetCreditManager";
+            readonly type: "address";
+            readonly internalType: "address";
+        }, {
+            readonly name: "migratedCollaterals";
+            readonly type: "tuple[]";
+            readonly internalType: "struct MigratedCollateral[]";
+            readonly components: readonly [{
+                readonly name: "collateral";
+                readonly type: "address";
+                readonly internalType: "address";
+            }, {
+                readonly name: "amount";
+                readonly type: "uint256";
+                readonly internalType: "uint256";
+            }, {
+                readonly name: "targetQuotaIncrease";
+                readonly type: "uint96";
+                readonly internalType: "uint96";
+            }, {
+                readonly name: "underlyingInSource";
+                readonly type: "bool";
+                readonly internalType: "bool";
+            }, {
+                readonly name: "underlyingInTarget";
+                readonly type: "bool";
+                readonly internalType: "bool";
+            }, {
+                readonly name: "phantomTokenParams";
+                readonly type: "tuple";
+                readonly internalType: "struct PhantomTokenParams";
+                readonly components: readonly [{
+                    readonly name: "isPhantomToken";
+                    readonly type: "bool";
+                    readonly internalType: "bool";
+                }, {
+                    readonly name: "underlying";
+                    readonly type: "address";
+                    readonly internalType: "address";
+                }, {
+                    readonly name: "underlyingAmount";
+                    readonly type: "uint256";
+                    readonly internalType: "uint256";
+                }];
+            }];
+        }, {
+            readonly name: "targetBorrowAmount";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "underlyingSwapCalls";
+            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: "extraOpeningCalls";
+            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: "uniqueTransferredTokens";
+            readonly type: "address[]";
+            readonly internalType: "address[]";
+        }, {
+            readonly name: "numAddCollateralCalls";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "numRemoveQuotasCalls";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "numIncreaseQuotaCalls";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "numPhantomTokenCalls";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }];
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+        readonly internalType: "bool";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "serialize";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "serializedData";
+        readonly type: "bytes";
+        readonly internalType: "bytes";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "targetContract";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "unlock";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [];
+    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";
+}, {
+    readonly type: "error";
+    readonly name: "AddressIsNotContractException";
+    readonly inputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+}, {
+    readonly type: "error";
+    readonly name: "CallerNotCreditFacadeException";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "ZeroAddressException";
+    readonly inputs: readonly [];
+}];
+type protocolAbi = typeof protocolAbi;
+export declare class AccountMigratorAdapterContract extends AbstractAdapterContract<abi, protocolAbi> {
+    constructor(options: ConstructOptions, args: ConcreteAdapterContractOptions);
+    /** Legacy adapter not present in integrations-v3. */
+    protected classifyLegacyOperation(_parsed: ParsedCallV2, _transfers: Transfers): LegacyAdapterOperation;
 }
 export {};

package/dist/types/plugins/adapters/contracts/BalancerV3RouterAdapterContract.d.ts

@@ -1,6 +1,6 @@
 import { type Address } from "viem";
 import type { ConstructOptions } from "../../../sdk/index.js";
-import type { AbstractAdapterContractOptions } from "./AbstractAdapter.js";
+import type { ConcreteAdapterContractOptions } from "./AbstractAdapter.js";
 import { AbstractAdapterContract } from "./AbstractAdapter.js";
 import type { BalancerV3PoolStatus } from "./types.js";
 declare const abi: readonly [{
@@ -318,11 +318,120 @@ declare const abi: readonly [{
     readonly name: "InvalidPoolException";
 }];
 type abi = typeof abi;
-export declare class BalancerV3RouterAdapterContract extends AbstractAdapterContract<abi> {
-    readonly allowedPools: Address[] | {
+declare const protocolAbi: readonly [{
+    readonly type: "function";
+    readonly name: "addLiquidityUnbalanced";
+    readonly inputs: readonly [{
+        readonly name: "pool";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "exactAmountsIn";
+        readonly type: "uint256[]";
+        readonly internalType: "uint256[]";
+    }, {
+        readonly name: "minBptAmountOut";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "wethIsEth";
+        readonly type: "bool";
+        readonly internalType: "bool";
+    }, {
+        readonly name: "userData";
+        readonly type: "bytes";
+        readonly internalType: "bytes";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "bptAmountOut";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "removeLiquiditySingleTokenExactIn";
+    readonly inputs: readonly [{
+        readonly name: "pool";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "exactBptAmountIn";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "tokenOut";
+        readonly type: "address";
+        readonly internalType: "contract IERC20";
+    }, {
+        readonly name: "minAmountOut";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "wethIsEth";
+        readonly type: "bool";
+        readonly internalType: "bool";
+    }, {
+        readonly name: "userData";
+        readonly type: "bytes";
+        readonly internalType: "bytes";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "amountOut";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "swapSingleTokenExactIn";
+    readonly inputs: readonly [{
+        readonly name: "pool";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "tokenIn";
+        readonly type: "address";
+        readonly internalType: "contract IERC20";
+    }, {
+        readonly name: "tokenOut";
+        readonly type: "address";
+        readonly internalType: "contract IERC20";
+    }, {
+        readonly name: "exactAmountIn";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "minAmountOut";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "deadline";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "wethIsEth";
+        readonly type: "bool";
+        readonly internalType: "bool";
+    }, {
+        readonly name: "userData";
+        readonly type: "bytes";
+        readonly internalType: "bytes";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "amountOut";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly stateMutability: "nonpayable";
+}];
+type protocolAbi = typeof protocolAbi;
+export declare class BalancerV3RouterAdapterContract extends AbstractAdapterContract<abi, protocolAbi> {
+    #private;
+    constructor(options: ConstructOptions, args: ConcreteAdapterContractOptions);
+    get allowedPools(): Address[] | {
         pool: Address;
         status: BalancerV3PoolStatus;
     }[];
-    constructor(options: ConstructOptions, args: Omit<AbstractAdapterContractOptions<abi>, "abi">);
 }
 export {};

package/dist/types/plugins/adapters/contracts/BalancerV3WrapperAdapterContract.d.ts

@@ -1,6 +1,6 @@
 import { type Address } from "viem";
 import type { ConstructOptions } from "../../../sdk/index.js";
-import type { AbstractAdapterContractOptions } from "./AbstractAdapter.js";
+import type { ConcreteAdapterContractOptions } from "./AbstractAdapter.js";
 import { AbstractAdapterContract } from "./AbstractAdapter.js";
 declare const abi: readonly [{
     readonly type: "function";
@@ -120,8 +120,41 @@ declare const abi: readonly [{
     readonly stateMutability: "view";
 }];
 type abi = typeof abi;
-export declare class BalancerV3WrapperAdapterContract extends AbstractAdapterContract<abi> {
-    readonly balancerPoolToken: Address;
-    constructor(options: ConstructOptions, args: Omit<AbstractAdapterContractOptions<abi>, "abi">);
+declare const protocolAbi: readonly [{
+    readonly type: "function";
+    readonly name: "balancerPoolToken";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+        readonly internalType: "address";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "burn";
+    readonly inputs: readonly [{
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "mint";
+    readonly inputs: readonly [{
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}];
+type protocolAbi = typeof protocolAbi;
+export declare class BalancerV3WrapperAdapterContract extends AbstractAdapterContract<abi, protocolAbi> {
+    #private;
+    constructor(options: ConstructOptions, args: ConcreteAdapterContractOptions);
+    get balancerPoolToken(): Address;
 }
 export {};