@avaprotocol/sdk-js 4.0.0-dev.0 → 4.0.0-dev.2

package/dist/index.mjs

@@ -374,6 +374,11 @@ var HealthResource = class {
   constructor(transport) {
     this.transport = transport;
   }
+  /**
+   * GET /health — returns `{ status, chainId, version }` when the
+   * gateway is up. Use for liveness checks; do not rely on it for
+   * deep readiness (it doesn't probe worker connectivity).
+   */
   check() {
     return this.transport.request({ path: "/health" });
   }
@@ -384,7 +389,21 @@ var NodesResource = class {
   constructor(transport) {
     this.transport = transport;
   }
-  /** POST /nodes:run — execute a single node against inline input. */
+  /**
+   * POST /nodes:run — execute one node against inline `inputVariables`.
+   *
+   * The request shape mirrors a single entry from `workflows.simulate`:
+   * a complete node definition + the variables the node would have seen
+   * inside a workflow. The gateway runs the node in-process (no worker
+   * delegation, no persistence) and returns the raw output keyed by
+   * node type — `{ success, output: { <nodeType>: {...} } }`.
+   *
+   * Chain context: the gateway resolves the target chain in this order:
+   * `body.chainId` → `inputVariables.settings.chain_id` → the JWT's
+   * `aud` claim → the gateway's default chain. Specify `chainId`
+   * explicitly when calling a contract that lives on a non-default
+   * chain (e.g. a sepolia oracle when the gateway defaults to mainnet).
+   */
   run(req) {
     return this.transport.request({
       path: "/nodes:run",
@@ -399,7 +418,15 @@ var OperatorsResource = class {
   constructor(transport) {
     this.transport = transport;
   }
-  /** GET /operators — connected operators + capabilities. */
+  /**
+   * GET /operators — every operator currently connected to the
+   * gateway, plus their advertised capabilities (block / time /
+   * event monitoring) and the timestamp of their last heartbeat.
+   *
+   * An empty array means no operators are connected — workflows will
+   * still accept, but won't execute until at least one operator
+   * comes online.
+   */
   list() {
     return this.transport.request({ path: "/operators" });
   }
@@ -441,10 +468,16 @@ var TokensResource = class {
     this.transport = transport;
   }
   /**
-   * GET /tokens/{address} — returns `{ found: false }` (not 404)
-   * when the token is not in the aggregator's whitelist and the
-   * on-chain fallback fails. Partial info (the address) is still
-   * useful to callers.
+   * GET /tokens/{address} — resolve a token by contract address.
+   *
+   * Returns `{ found: false, address }` (not 404) when the token
+   * isn't on the whitelist and the on-chain probe also fails — the
+   * partial response keeps the caller's UI from breaking on
+   * unrecognized tokens.
+   *
+   * `opts.chainId` picks which chain's whitelist + RPC to consult.
+   * Omit it to fall back to the JWT's `aud` chain (the gateway's
+   * default chain context for the authenticated user).
    */
   retrieve(address, opts) {
     return this.transport.request({
@@ -459,7 +492,20 @@ var TriggersResource = class {
   constructor(transport) {
     this.transport = transport;
   }
-  /** POST /triggers:run — evaluate a trigger config against inline input. */
+  /**
+   * POST /triggers:run — evaluate a trigger config against inline
+   * input and return the same shape an executor would see.
+   *
+   * For event triggers, the gateway uses Tenderly to simulate a
+   * matching event log against the request's `addresses` + `topics`
+   * filter, then returns the decoded log under `output.data` and
+   * the raw log under `output.metadata`.
+   *
+   * For time-based triggers (cron, fixedTime, block), the response
+   * carries the next scheduled fire time / block height.
+   *
+   * No workflow record is created and no execution is persisted.
+   */
   run(req) {
     return this.transport.request({
       path: "/triggers:run",
@@ -474,13 +520,29 @@ var WalletsResource = class {
   constructor(transport) {
     this.transport = transport;
   }
-  /** GET /wallets */
+  /**
+   * GET /wallets — every smart wallet owned by the authenticated
+   * EOA on the JWT's audience chain.
+   *
+   * Hidden wallets (`isHidden=true`) are excluded by default. The
+   * response is an envelope `{ data: Wallet[] }`, not a bare array.
+   */
   list() {
     return this.transport.request({ path: "/wallets" });
   }
   /**
    * POST /wallets — idempotent "ensure exists". Derives the CREATE2
-   * address from (owner, salt, factory) and persists the record.
+   * address from `(owner, salt, factory)` and persists the record;
+   * calling twice with the same triple returns the same address.
+   *
+   * The on-chain account is **not** deployed by this call — deployment
+   * happens lazily as part of the first UserOp (workflow execution or
+   * `withdraw`) via the `initCode` field, so the smart wallet costs
+   * zero gas until it's first used.
+   *
+   * Per-owner cap is enforced by `max_wallets_per_owner` in the
+   * aggregator config; the call returns 429 `WALLETS_LIMIT_REACHED`
+   * when exceeded.
    */
   create(req) {
     return this.transport.request({
@@ -490,8 +552,11 @@ var WalletsResource = class {
     });
   }
   /**
-   * PATCH /wallets/{address} — partial update. Today the only
-   * mutable field is `isHidden`.
+   * PATCH /wallets/{address} — partial update. The only mutable
+   * field today is `isHidden`, used by the Studio UI's hide/unhide
+   * wallet action. Keyed by **address**, not salt — callers that
+   * still think in salts must look up the address first via
+   * `create({ salt })`.
    */
   update(address, body) {
     return this.transport.request({
@@ -500,7 +565,18 @@ var WalletsResource = class {
       body
     });
   }
-  /** POST /wallets/{address}:withdraw — UserOp-driven withdraw. */
+  /**
+   * POST /wallets/{address}:withdraw — transfer ETH or an ERC-20 out
+   * of the smart wallet via a UserOp through the bundler + paymaster.
+   *
+   * Per-chain config (bundler URL, paymaster address, RPC) is resolved
+   * by the gateway from the JWT's `aud` claim or `body.chainId`.
+   * The response's `status` is one of `pending | confirmed | failed`:
+   * `confirmed` means the bundler returned a receipt synchronously,
+   * `pending` means it accepted the UserOp but the receipt hasn't
+   * landed yet, `failed` means the bundler rejected the op or it
+   * reverted before inclusion.
+   */
   withdraw(address, req) {
     return this.transport.request({
       path: `/wallets/${encodeURIComponent(address)}:withdraw`,
@@ -508,7 +584,14 @@ var WalletsResource = class {
       body: req
     });
   }
-  /** GET /wallets/{address}:getNonce */
+  /**
+   * GET /wallets/{address}:getNonce — current AA nonce for the wallet.
+   *
+   * Used when an external signer needs to assemble a UserOp outside
+   * the SDK's bundler path. Most callers don't need this directly —
+   * `workflows.simulate` and `wallets.withdraw` handle nonce sourcing
+   * internally.
+   */
   getNonce(address) {
     return this.transport.request({
       path: `/wallets/${encodeURIComponent(address)}:getNonce`
@@ -756,7 +839,8 @@ var Nodes = Object.freeze({
         url: opts.url,
         method: opts.method,
         ...opts.body ? { body: opts.body } : {},
-        ...opts.headers ? { headers: opts.headers } : {}
+        ...opts.headers ? { headers: opts.headers } : {},
+        ...opts.options ? { options: opts.options } : {}
       }
     };
   },
@@ -814,6 +898,780 @@ var Nodes = Object.freeze({
     };
   }
 });
+
+// src/v4/protocols/aave-v3.ts
+var pool = {
+  [Chains.EthereumMainnet]: "0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2",
+  [Chains.Sepolia]: "0x6Ae43d3271ff6888e7Fc43Fd7321a503ff738951",
+  [Chains.BaseMainnet]: "0xA238Dd80C259a72e81d7e4664a9801593F98d1c5",
+  [Chains.BaseSepolia]: "0x8bAB6d1b75f19e9eD9fCe8b9BD338844fF79aE27"
+};
+var oracle = {
+  [Chains.EthereumMainnet]: "0x54586bE62E3c3580375aE3723C145253060Ca0C2",
+  [Chains.Sepolia]: "0x2da88497588bf89281816106C7259e31AF45a663",
+  [Chains.BaseMainnet]: "0x2Cc0Fc26eD4563A5ce5e8bdcfe1A2878676Ae156",
+  [Chains.BaseSepolia]: "0x943b0dE18d4abf4eF02A85912F8fc07684C141dF"
+};
+var wethGateway = {
+  [Chains.EthereumMainnet]: "0xd01607c3C5eCABa394D8be377a08590149325722",
+  [Chains.Sepolia]: "0x387d311e47e80b498169e6fb51d3193167d89F7D",
+  [Chains.BaseMainnet]: "0xa0d9C1E9E48Ca30c8d8C3B5D69FF5dc1f6DFfC24",
+  [Chains.BaseSepolia]: "0x0568130e794429D2eEBC4dafE18f25Ff1a1ed8b6"
+};
+var eventTopics = Object.freeze({
+  Supply: "0x2b627736bca15cd5381dcf80b0bf11fd197d01a037c52b927a881a10fb73ba61",
+  Withdraw: "0x3115d1449a7b732c986cba18244e897a450f61e1bb8d589cd2e69e6c8924f9f7",
+  Borrow: "0xb3d084820fb1a9decffb176436bd02558d15fac9b0ddfed8c465bc7359d7dce0",
+  Repay: "0xa534c8dbe71f871f9f3530e97a74601fea17b426cae02e1c5aee42c96c784051",
+  LiquidationCall: "0xe413a321e8681d831f4dbccbca790d2952b56f977908e45be37335533e005286"
+});
+var poolEventsAbi = Object.freeze([
+  {
+    anonymous: false,
+    inputs: [
+      { indexed: true, internalType: "address", name: "reserve", type: "address" },
+      { indexed: false, internalType: "address", name: "user", type: "address" },
+      { indexed: true, internalType: "address", name: "onBehalfOf", type: "address" },
+      { indexed: false, internalType: "uint256", name: "amount", type: "uint256" },
+      { indexed: true, internalType: "uint16", name: "referralCode", type: "uint16" }
+    ],
+    name: "Supply",
+    type: "event"
+  },
+  {
+    anonymous: false,
+    inputs: [
+      { indexed: true, internalType: "address", name: "reserve", type: "address" },
+      { indexed: true, internalType: "address", name: "user", type: "address" },
+      { indexed: true, internalType: "address", name: "to", type: "address" },
+      { indexed: false, internalType: "uint256", name: "amount", type: "uint256" }
+    ],
+    name: "Withdraw",
+    type: "event"
+  },
+  {
+    anonymous: false,
+    inputs: [
+      { indexed: true, internalType: "address", name: "reserve", type: "address" },
+      { indexed: false, internalType: "address", name: "user", type: "address" },
+      { indexed: true, internalType: "address", name: "onBehalfOf", type: "address" },
+      { indexed: false, internalType: "uint256", name: "amount", type: "uint256" },
+      { indexed: false, internalType: "uint8", name: "interestRateMode", type: "uint8" },
+      { indexed: false, internalType: "uint256", name: "borrowRate", type: "uint256" },
+      { indexed: true, internalType: "uint16", name: "referralCode", type: "uint16" }
+    ],
+    name: "Borrow",
+    type: "event"
+  },
+  {
+    anonymous: false,
+    inputs: [
+      { indexed: true, internalType: "address", name: "reserve", type: "address" },
+      { indexed: true, internalType: "address", name: "user", type: "address" },
+      { indexed: true, internalType: "address", name: "repayer", type: "address" },
+      { indexed: false, internalType: "uint256", name: "amount", type: "uint256" },
+      { indexed: false, internalType: "bool", name: "useATokens", type: "bool" }
+    ],
+    name: "Repay",
+    type: "event"
+  },
+  {
+    anonymous: false,
+    inputs: [
+      { indexed: true, internalType: "address", name: "collateralAsset", type: "address" },
+      { indexed: true, internalType: "address", name: "debtAsset", type: "address" },
+      { indexed: true, internalType: "address", name: "user", type: "address" },
+      { indexed: false, internalType: "uint256", name: "debtToCover", type: "uint256" },
+      { indexed: false, internalType: "uint256", name: "liquidatedCollateralAmount", type: "uint256" },
+      { indexed: false, internalType: "address", name: "liquidator", type: "address" },
+      { indexed: false, internalType: "bool", name: "receiveAToken", type: "bool" }
+    ],
+    name: "LiquidationCall",
+    type: "event"
+  }
+]);
+var poolMethodsAbi = Object.freeze([
+  {
+    inputs: [{ internalType: "address", name: "user", type: "address" }],
+    name: "getUserAccountData",
+    outputs: [
+      { internalType: "uint256", name: "totalCollateralBase", type: "uint256" },
+      { internalType: "uint256", name: "totalDebtBase", type: "uint256" },
+      { internalType: "uint256", name: "availableBorrowsBase", type: "uint256" },
+      { internalType: "uint256", name: "currentLiquidationThreshold", type: "uint256" },
+      { internalType: "uint256", name: "ltv", type: "uint256" },
+      { internalType: "uint256", name: "healthFactor", type: "uint256" }
+    ],
+    stateMutability: "view",
+    type: "function"
+  },
+  {
+    inputs: [
+      { internalType: "address", name: "asset", type: "address" },
+      { internalType: "uint256", name: "amount", type: "uint256" },
+      { internalType: "address", name: "onBehalfOf", type: "address" },
+      { internalType: "uint16", name: "referralCode", type: "uint16" }
+    ],
+    name: "supply",
+    outputs: [],
+    stateMutability: "nonpayable",
+    type: "function"
+  },
+  {
+    inputs: [
+      { internalType: "address", name: "asset", type: "address" },
+      { internalType: "uint256", name: "amount", type: "uint256" },
+      { internalType: "uint256", name: "interestRateMode", type: "uint256" },
+      { internalType: "uint16", name: "referralCode", type: "uint16" },
+      { internalType: "address", name: "onBehalfOf", type: "address" }
+    ],
+    name: "borrow",
+    outputs: [],
+    stateMutability: "nonpayable",
+    type: "function"
+  },
+  {
+    inputs: [
+      { internalType: "address", name: "asset", type: "address" },
+      { internalType: "uint256", name: "amount", type: "uint256" },
+      { internalType: "uint256", name: "interestRateMode", type: "uint256" },
+      { internalType: "address", name: "onBehalfOf", type: "address" }
+    ],
+    name: "repay",
+    outputs: [{ internalType: "uint256", name: "", type: "uint256" }],
+    stateMutability: "nonpayable",
+    type: "function"
+  },
+  {
+    inputs: [
+      { internalType: "address", name: "asset", type: "address" },
+      { internalType: "uint256", name: "amount", type: "uint256" },
+      { internalType: "address", name: "to", type: "address" }
+    ],
+    name: "withdraw",
+    outputs: [{ internalType: "uint256", name: "", type: "uint256" }],
+    stateMutability: "nonpayable",
+    type: "function"
+  },
+  {
+    inputs: [
+      { internalType: "address", name: "asset", type: "address" },
+      { internalType: "bool", name: "useAsCollateral", type: "bool" }
+    ],
+    name: "setUserUseReserveAsCollateral",
+    outputs: [],
+    stateMutability: "nonpayable",
+    type: "function"
+  }
+]);
+var tokens = Object.freeze({
+  LINK: {
+    [Chains.Sepolia]: "0xf8Fb3713D459D7C1018BD0A49D19b4C44290EBE5"
+  }
+});
+var aaveV3 = Object.freeze({
+  pool,
+  oracle,
+  wethGateway,
+  eventTopics,
+  poolEventsAbi,
+  poolMethodsAbi,
+  tokens
+});
+
+// src/v4/protocols/aerodrome.ts
+var router = {
+  [Chains.BaseMainnet]: "0xcF77a3Ba9A5CA399B7c97c74d54e5b1Beb874E43"
+};
+var aerodrome = Object.freeze({
+  router
+});
+
+// src/v4/protocols/common.ts
+var aggregatorV3Abi = Object.freeze([
+  {
+    inputs: [],
+    name: "latestRoundData",
+    outputs: [
+      { internalType: "uint80", name: "roundId", type: "uint80" },
+      { internalType: "int256", name: "answer", type: "int256" },
+      { internalType: "uint256", name: "startedAt", type: "uint256" },
+      { internalType: "uint256", name: "updatedAt", type: "uint256" },
+      { internalType: "uint80", name: "answeredInRound", type: "uint80" }
+    ],
+    stateMutability: "view",
+    type: "function"
+  },
+  {
+    inputs: [],
+    name: "decimals",
+    outputs: [{ internalType: "uint8", name: "", type: "uint8" }],
+    stateMutability: "view",
+    type: "function"
+  }
+]);
+var erc4626VaultAbi = Object.freeze([
+  {
+    inputs: [
+      { internalType: "uint256", name: "assets", type: "uint256" },
+      { internalType: "address", name: "receiver", type: "address" }
+    ],
+    name: "deposit",
+    outputs: [{ internalType: "uint256", name: "shares", type: "uint256" }],
+    stateMutability: "nonpayable",
+    type: "function"
+  },
+  {
+    inputs: [
+      { internalType: "uint256", name: "shares", type: "uint256" },
+      { internalType: "address", name: "receiver", type: "address" },
+      { internalType: "address", name: "owner", type: "address" }
+    ],
+    name: "redeem",
+    outputs: [{ internalType: "uint256", name: "assets", type: "uint256" }],
+    stateMutability: "nonpayable",
+    type: "function"
+  },
+  {
+    inputs: [{ internalType: "uint256", name: "shares", type: "uint256" }],
+    name: "previewRedeem",
+    outputs: [{ internalType: "uint256", name: "assets", type: "uint256" }],
+    stateMutability: "view",
+    type: "function"
+  },
+  {
+    inputs: [{ internalType: "uint256", name: "shares", type: "uint256" }],
+    name: "convertToAssets",
+    outputs: [{ internalType: "uint256", name: "assets", type: "uint256" }],
+    stateMutability: "view",
+    type: "function"
+  }
+]);
+
+// src/v4/protocols/chainlink.ts
+var ethUsdFeed = {
+  [Chains.EthereumMainnet]: "0x5f4eC3Df9cbd43714FE2740f5E3616155c5b8419",
+  [Chains.Sepolia]: "0x694AA1769357215DE4FAC081bf1f309aDC325306"
+};
+var btcUsdFeed = {
+  [Chains.EthereumMainnet]: "0xF4030086522a5bEEa4988F8cA5B36dbC97BeE88c"
+};
+var chainlink = Object.freeze({
+  ethUsdFeed,
+  btcUsdFeed,
+  /** Shared AggregatorV3 ABI — works for any Chainlink feed. */
+  aggregatorV3Abi
+});
+
+// src/v4/protocols/compound-v3.ts
+var cometUsdc = {
+  [Chains.EthereumMainnet]: "0xc3d688B66703497DAA19211EEdff47f25384cdc3",
+  [Chains.BaseMainnet]: "0xb125E6687d4313864e53df431d5425969c15Eb2F"
+};
+var compoundV3 = Object.freeze({
+  cometUsdc
+});
+
+// src/v4/protocols/erc20.ts
+var erc20 = Object.freeze({
+  approveAbi: Object.freeze([
+    {
+      inputs: [
+        { internalType: "address", name: "spender", type: "address" },
+        { internalType: "uint256", name: "amount", type: "uint256" }
+      ],
+      name: "approve",
+      outputs: [{ internalType: "bool", name: "", type: "bool" }],
+      stateMutability: "nonpayable",
+      type: "function"
+    }
+  ])
+});
+
+// src/v4/protocols/ethena.ts
+var susde = {
+  [Chains.EthereumMainnet]: "0x9D39A5DE30e57443BfF2A8307A4256c8797A3497"
+};
+var usde = {
+  [Chains.EthereumMainnet]: "0x4c9EDD5852cd905f086C759E8383e09bff1E68B3"
+};
+var susdeAbi = Object.freeze([
+  {
+    inputs: [
+      { internalType: "uint256", name: "assets", type: "uint256" },
+      { internalType: "address", name: "receiver", type: "address" }
+    ],
+    name: "deposit",
+    outputs: [{ internalType: "uint256", name: "shares", type: "uint256" }],
+    stateMutability: "nonpayable",
+    type: "function"
+  },
+  {
+    inputs: [{ internalType: "uint256", name: "shares", type: "uint256" }],
+    name: "cooldownShares",
+    outputs: [{ internalType: "uint256", name: "assets", type: "uint256" }],
+    stateMutability: "nonpayable",
+    type: "function"
+  },
+  {
+    inputs: [{ internalType: "address", name: "receiver", type: "address" }],
+    name: "unstake",
+    outputs: [],
+    stateMutability: "nonpayable",
+    type: "function"
+  },
+  {
+    inputs: [{ internalType: "uint256", name: "shares", type: "uint256" }],
+    name: "previewRedeem",
+    outputs: [{ internalType: "uint256", name: "assets", type: "uint256" }],
+    stateMutability: "view",
+    type: "function"
+  },
+  {
+    inputs: [{ internalType: "uint256", name: "shares", type: "uint256" }],
+    name: "convertToAssets",
+    outputs: [{ internalType: "uint256", name: "assets", type: "uint256" }],
+    stateMutability: "view",
+    type: "function"
+  }
+]);
+var ethena = Object.freeze({
+  susde,
+  usde,
+  susdeAbi
+});
+
+// src/v4/protocols/frax-ether.ts
+var sfrxeth = {
+  [Chains.EthereumMainnet]: "0xac3E018457B222d93114458476f3E3416Abbe38F"
+};
+var frxeth = {
+  [Chains.EthereumMainnet]: "0x5E8422345238F34275888049021821E8E08CAa1f"
+};
+var fraxEther = Object.freeze({
+  sfrxeth,
+  frxeth,
+  /** Standard ERC-4626 surface — sfrxETH conforms exactly. */
+  vaultAbi: erc4626VaultAbi
+});
+
+// src/v4/protocols/lido.ts
+var wsteth = {
+  [Chains.EthereumMainnet]: "0x7f39C581F595B53c5cb19bD0b3f8dA6c935E2Ca0",
+  [Chains.BaseMainnet]: "0xc1CBa3fCea344f92D9239c08C0568f6F2F0ee452"
+};
+var steth = {
+  [Chains.EthereumMainnet]: "0xae7ab96520DE3A18E5e111B5EaAb095312D7fE84"
+};
+var wstethAbi = Object.freeze([
+  {
+    inputs: [{ internalType: "uint256", name: "_stETHAmount", type: "uint256" }],
+    name: "wrap",
+    outputs: [{ internalType: "uint256", name: "", type: "uint256" }],
+    stateMutability: "nonpayable",
+    type: "function"
+  },
+  {
+    inputs: [{ internalType: "uint256", name: "_wstETHAmount", type: "uint256" }],
+    name: "unwrap",
+    outputs: [{ internalType: "uint256", name: "", type: "uint256" }],
+    stateMutability: "nonpayable",
+    type: "function"
+  },
+  {
+    inputs: [{ internalType: "uint256", name: "_wstETHAmount", type: "uint256" }],
+    name: "getStETHByWstETH",
+    outputs: [{ internalType: "uint256", name: "", type: "uint256" }],
+    stateMutability: "view",
+    type: "function"
+  }
+]);
+var lido = Object.freeze({
+  wsteth,
+  steth,
+  wstethAbi
+});
+
+// src/v4/protocols/morpho.ts
+var morpho = {
+  [Chains.EthereumMainnet]: "0xBBBBBbbBBb9cC5e90e3b3Af64bdAF62C37EEFFCb",
+  [Chains.BaseMainnet]: "0xBBBBBbbBBb9cC5e90e3b3Af64bdAF62C37EEFFCb"
+};
+var morphoAbi = Object.freeze([
+  {
+    inputs: [
+      {
+        components: [
+          { internalType: "address", name: "loanToken", type: "address" },
+          { internalType: "address", name: "collateralToken", type: "address" },
+          { internalType: "address", name: "oracle", type: "address" },
+          { internalType: "address", name: "irm", type: "address" },
+          { internalType: "uint256", name: "lltv", type: "uint256" }
+        ],
+        internalType: "struct MarketParams",
+        name: "marketParams",
+        type: "tuple"
+      },
+      { internalType: "uint256", name: "assets", type: "uint256" },
+      { internalType: "uint256", name: "shares", type: "uint256" },
+      { internalType: "address", name: "onBehalf", type: "address" },
+      { internalType: "bytes", name: "data", type: "bytes" }
+    ],
+    name: "supply",
+    outputs: [
+      { internalType: "uint256", name: "assetsSupplied", type: "uint256" },
+      { internalType: "uint256", name: "sharesSupplied", type: "uint256" }
+    ],
+    stateMutability: "nonpayable",
+    type: "function"
+  },
+  {
+    inputs: [
+      {
+        components: [
+          { internalType: "address", name: "loanToken", type: "address" },
+          { internalType: "address", name: "collateralToken", type: "address" },
+          { internalType: "address", name: "oracle", type: "address" },
+          { internalType: "address", name: "irm", type: "address" },
+          { internalType: "uint256", name: "lltv", type: "uint256" }
+        ],
+        internalType: "struct MarketParams",
+        name: "marketParams",
+        type: "tuple"
+      },
+      { internalType: "uint256", name: "assets", type: "uint256" },
+      { internalType: "uint256", name: "shares", type: "uint256" },
+      { internalType: "address", name: "onBehalf", type: "address" },
+      { internalType: "address", name: "receiver", type: "address" }
+    ],
+    name: "borrow",
+    outputs: [
+      { internalType: "uint256", name: "assetsBorrowed", type: "uint256" },
+      { internalType: "uint256", name: "sharesBorrowed", type: "uint256" }
+    ],
+    stateMutability: "nonpayable",
+    type: "function"
+  },
+  {
+    inputs: [
+      { internalType: "bytes32", name: "id", type: "bytes32" },
+      { internalType: "address", name: "user", type: "address" }
+    ],
+    name: "position",
+    outputs: [
+      { internalType: "uint256", name: "supplyShares", type: "uint256" },
+      { internalType: "uint128", name: "borrowShares", type: "uint128" },
+      { internalType: "uint128", name: "collateral", type: "uint128" }
+    ],
+    stateMutability: "view",
+    type: "function"
+  }
+]);
+var morphoBlue = Object.freeze({
+  morpho,
+  morphoAbi
+});
+
+// src/v4/protocols/rocket-pool.ts
+var reth = {
+  [Chains.EthereumMainnet]: "0xae78736Cd615f374D3085123A210448E74Fc6393",
+  [Chains.BaseMainnet]: "0xB6fe221Fe9EeF5aBa221c348bA20A1Bf5e73624c"
+};
+var rethAbi = Object.freeze([
+  {
+    inputs: [{ internalType: "uint256", name: "_rethAmount", type: "uint256" }],
+    name: "burn",
+    outputs: [],
+    stateMutability: "nonpayable",
+    type: "function"
+  },
+  {
+    inputs: [],
+    name: "getExchangeRate",
+    outputs: [{ internalType: "uint256", name: "", type: "uint256" }],
+    stateMutability: "view",
+    type: "function"
+  },
+  {
+    inputs: [{ internalType: "uint256", name: "_rethAmount", type: "uint256" }],
+    name: "getEthValue",
+    outputs: [{ internalType: "uint256", name: "", type: "uint256" }],
+    stateMutability: "view",
+    type: "function"
+  }
+]);
+var rocketPool = Object.freeze({
+  reth,
+  rethAbi
+});
+
+// src/v4/protocols/sky.ts
+var sdai = {
+  [Chains.EthereumMainnet]: "0x83F20F44975D03b1b09e64809B757c47f942BEeA"
+};
+var sky = Object.freeze({
+  sdai,
+  /** Standard ERC-4626 surface — sDAI conforms exactly. */
+  vaultAbi: erc4626VaultAbi
+});
+
+// src/v4/protocols/spark.ts
+var pool2 = {
+  [Chains.EthereumMainnet]: "0xC13e21B648A5Ee794902342038FF3aDAB66BE987"
+};
+var spark = Object.freeze({
+  pool: pool2
+});
+
+// src/v4/protocols/superfluid.ts
+var cfaForwarder = {
+  [Chains.EthereumMainnet]: "0xcfA132E353cB4E398080B9700609bb008eceB125",
+  [Chains.BaseMainnet]: "0xcfA132E353cB4E398080B9700609bb008eceB125"
+};
+var cfaForwarderAbi = Object.freeze([
+  {
+    inputs: [
+      { internalType: "address", name: "token", type: "address" },
+      { internalType: "address", name: "receiver", type: "address" },
+      { internalType: "int96", name: "flowrate", type: "int96" }
+    ],
+    name: "setFlowrate",
+    outputs: [{ internalType: "bool", name: "", type: "bool" }],
+    stateMutability: "nonpayable",
+    type: "function"
+  },
+  {
+    inputs: [
+      { internalType: "address", name: "token", type: "address" },
+      { internalType: "address", name: "sender", type: "address" },
+      { internalType: "address", name: "receiver", type: "address" },
+      { internalType: "int96", name: "flowrate", type: "int96" },
+      { internalType: "bytes", name: "userData", type: "bytes" }
+    ],
+    name: "createFlow",
+    outputs: [{ internalType: "bool", name: "", type: "bool" }],
+    stateMutability: "nonpayable",
+    type: "function"
+  }
+]);
+var superfluid = Object.freeze({
+  cfaForwarder,
+  cfaForwarderAbi
+});
+
+// src/v4/protocols/uniswap-v3.ts
+var swapRouter02 = {
+  [Chains.EthereumMainnet]: "0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45",
+  [Chains.Sepolia]: "0x3bFA4769FB09eefC5a80d6E87c3B9C650f7Ae48E",
+  [Chains.BaseMainnet]: "0x2626664c2603336E57B271c5C0b26F421741e481",
+  [Chains.BaseSepolia]: "0x94cC0AaC535CCDB3C01d6787D6413C739ae12bc4"
+};
+var quoterV2 = {
+  [Chains.EthereumMainnet]: "0x61fFE014bA17989E743c5F6cB21bF9697530B21e",
+  [Chains.Sepolia]: "0xEd1f6473345F45b75F8179591dd5bA1888cf2FB3",
+  [Chains.BaseMainnet]: "0x3d4e44Eb1374240CE5F1B871ab261CD16335B76a",
+  [Chains.BaseSepolia]: "0xC5290058841028F1614F3A6F0F5816cAd0df5E27"
+};
+var permit2 = {
+  [Chains.EthereumMainnet]: "0x000000000022d473030F116dDEE9F6B43aC78BA3",
+  [Chains.Sepolia]: "0x000000000022d473030F116dDEE9F6B43aC78BA3",
+  [Chains.BaseMainnet]: "0x000000000022d473030F116dDEE9F6B43aC78BA3",
+  [Chains.BaseSepolia]: "0x000000000022d473030F116dDEE9F6B43aC78BA3"
+};
+var factory = {
+  [Chains.EthereumMainnet]: "0x1F98431c8aD98523631AE4a59f267346ea31F984",
+  [Chains.Sepolia]: "0x0227628f3F023bb0B980b67D528571c95c6DaC1c",
+  [Chains.BaseMainnet]: "0x33128a8fC17869897dcE68Ed026d694621f6FDfD",
+  [Chains.BaseSepolia]: "0x4752ba5DBc23f44D87826276BF6Fd6b1C372aD24"
+};
+var nonfungiblePositionManager = {
+  [Chains.EthereumMainnet]: "0xC36442b4a4522E871399CD717aBDD847Ab11FE88",
+  [Chains.Sepolia]: "0x1238536071E1c677A632429e3655c799b22cDA52",
+  [Chains.BaseMainnet]: "0x03a520b32C04BF3bEEf7BEb72E919cf822Ed34f1",
+  [Chains.BaseSepolia]: "0x27F971cb582BF9E50F397e4d29a5C7A34f11faA2"
+};
+var universalRouter = {
+  [Chains.EthereumMainnet]: "0x66a9893cc07d91d95644aedd05d03f95e1dba8af",
+  [Chains.Sepolia]: "0x3A9D48AB9751398BbFa63ad67599Bb04e4BdF98b",
+  [Chains.BaseMainnet]: "0x6ff5693b99212da76ad316178a184ab56d299b43",
+  [Chains.BaseSepolia]: "0x492e6456d9528771018deb9e87ef7750ef184104"
+};
+var swapRouter02Abi = Object.freeze([
+  {
+    inputs: [
+      {
+        components: [
+          { internalType: "address", name: "tokenIn", type: "address" },
+          { internalType: "address", name: "tokenOut", type: "address" },
+          { internalType: "uint24", name: "fee", type: "uint24" },
+          { internalType: "address", name: "recipient", type: "address" },
+          { internalType: "uint256", name: "amountIn", type: "uint256" },
+          { internalType: "uint256", name: "amountOutMinimum", type: "uint256" },
+          { internalType: "uint160", name: "sqrtPriceLimitX96", type: "uint160" }
+        ],
+        internalType: "struct IV3SwapRouter.ExactInputSingleParams",
+        name: "params",
+        type: "tuple"
+      }
+    ],
+    name: "exactInputSingle",
+    outputs: [{ internalType: "uint256", name: "amountOut", type: "uint256" }],
+    stateMutability: "payable",
+    type: "function"
+  },
+  {
+    inputs: [
+      {
+        components: [
+          { internalType: "address", name: "tokenIn", type: "address" },
+          { internalType: "address", name: "tokenOut", type: "address" },
+          { internalType: "uint24", name: "fee", type: "uint24" },
+          { internalType: "address", name: "recipient", type: "address" },
+          { internalType: "uint256", name: "amountOut", type: "uint256" },
+          { internalType: "uint256", name: "amountInMaximum", type: "uint256" },
+          { internalType: "uint160", name: "sqrtPriceLimitX96", type: "uint160" }
+        ],
+        internalType: "struct IV3SwapRouter.ExactOutputSingleParams",
+        name: "params",
+        type: "tuple"
+      }
+    ],
+    name: "exactOutputSingle",
+    outputs: [{ internalType: "uint256", name: "amountIn", type: "uint256" }],
+    stateMutability: "payable",
+    type: "function"
+  }
+]);
+var quoterV2Abi = Object.freeze([
+  {
+    inputs: [
+      {
+        components: [
+          { internalType: "address", name: "tokenIn", type: "address" },
+          { internalType: "address", name: "tokenOut", type: "address" },
+          { internalType: "uint256", name: "amountIn", type: "uint256" },
+          { internalType: "uint24", name: "fee", type: "uint24" },
+          { internalType: "uint160", name: "sqrtPriceLimitX96", type: "uint160" }
+        ],
+        internalType: "struct IQuoterV2.QuoteExactInputSingleParams",
+        name: "params",
+        type: "tuple"
+      }
+    ],
+    name: "quoteExactInputSingle",
+    outputs: [
+      { internalType: "uint256", name: "amountOut", type: "uint256" },
+      { internalType: "uint160", name: "sqrtPriceX96After", type: "uint160" },
+      { internalType: "uint32", name: "initializedTicksCrossed", type: "uint32" },
+      { internalType: "uint256", name: "gasEstimate", type: "uint256" }
+    ],
+    stateMutability: "nonpayable",
+    type: "function"
+  }
+]);
+var factoryAbi = Object.freeze([
+  {
+    inputs: [
+      { internalType: "address", name: "tokenA", type: "address" },
+      { internalType: "address", name: "tokenB", type: "address" },
+      { internalType: "uint24", name: "fee", type: "uint24" }
+    ],
+    name: "getPool",
+    outputs: [{ internalType: "address", name: "pool", type: "address" }],
+    stateMutability: "view",
+    type: "function"
+  }
+]);
+var tokens2 = Object.freeze({
+  WETH: {
+    [Chains.Sepolia]: "0xfFf9976782d46CC05630D1f6eBAb18b2324d6B14",
+    [Chains.EthereumMainnet]: "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
+    [Chains.BaseMainnet]: "0x4200000000000000000000000000000000000006",
+    [Chains.BaseSepolia]: "0x4200000000000000000000000000000000000006"
+  },
+  USDC: {
+    [Chains.Sepolia]: "0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238",
+    [Chains.EthereumMainnet]: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
+    [Chains.BaseMainnet]: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
+    [Chains.BaseSepolia]: "0x036CbD53842c5426634e7929541eC2318f3dCF7e"
+  }
+});
+var uniswapV3 = Object.freeze({
+  swapRouter02,
+  quoterV2,
+  permit2,
+  factory,
+  nonfungiblePositionManager,
+  universalRouter,
+  swapRouter02Abi,
+  quoterV2Abi,
+  factoryAbi,
+  tokens: tokens2
+});
+
+// src/v4/protocols/wrapped.ts
+var weth = {
+  [Chains.EthereumMainnet]: "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
+  [Chains.Sepolia]: "0xfFf9976782d46CC05630D1f6eBAb18b2324d6B14",
+  [Chains.BaseMainnet]: "0x4200000000000000000000000000000000000006",
+  [Chains.BaseSepolia]: "0x4200000000000000000000000000000000000006"
+};
+var wethAbi = Object.freeze([
+  {
+    inputs: [],
+    name: "deposit",
+    outputs: [],
+    stateMutability: "payable",
+    type: "function"
+  },
+  {
+    inputs: [{ internalType: "uint256", name: "wad", type: "uint256" }],
+    name: "withdraw",
+    outputs: [],
+    stateMutability: "nonpayable",
+    type: "function"
+  },
+  {
+    inputs: [
+      { internalType: "address", name: "guy", type: "address" },
+      { internalType: "uint256", name: "wad", type: "uint256" }
+    ],
+    name: "approve",
+    outputs: [{ internalType: "bool", name: "", type: "bool" }],
+    stateMutability: "nonpayable",
+    type: "function"
+  },
+  {
+    inputs: [{ internalType: "address", name: "", type: "address" }],
+    name: "balanceOf",
+    outputs: [{ internalType: "uint256", name: "", type: "uint256" }],
+    stateMutability: "view",
+    type: "function"
+  }
+]);
+var wrapped = Object.freeze({
+  weth,
+  wethAbi
+});
+
+// src/v4/protocols/index.ts
+var Protocols = Object.freeze({
+  aaveV3,
+  aerodrome,
+  chainlink,
+  compoundV3,
+  erc20,
+  ethena,
+  fraxEther,
+  lido,
+  morphoBlue,
+  rocketPool,
+  sky,
+  spark,
+  superfluid,
+  uniswapV3,
+  wrapped
+});
 export {
   APIError,
   AUTH_TEMPLATE,
@@ -827,6 +1685,7 @@ export {
   Nodes,
   NodesResource,
   OperatorsResource,
+  Protocols,
   SecretsResource,
   TokensResource,
   Triggers,