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

package/dist/v4/builders/nodes.d.ts

@@ -21,7 +21,7 @@ export declare const Nodes: Readonly<{
         id: string;
         name: string;
         contractAddress: string;
-        contractAbi?: Array<Record<string, unknown>>;
+        contractAbi?: ReadonlyArray<Record<string, unknown>>;
         methodCalls?: Array<{
             methodName: string;
             methodParams?: string[];
@@ -38,7 +38,7 @@ export declare const Nodes: Readonly<{
         id: string;
         name: string;
         contractAddress: string;
-        contractAbi?: Array<Record<string, unknown>>;
+        contractAbi?: ReadonlyArray<Record<string, unknown>>;
         methodCalls?: Array<{
             methodName: string;
             methodParams?: string[];
@@ -61,6 +61,9 @@ export declare const Nodes: Readonly<{
         method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
         body?: string;
         headers?: Record<string, string>;
+        options?: {
+            summarize?: boolean;
+        };
     }): v4.Node;
     branch(opts: {
         id: string;

package/dist/v4/builders/nodes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nodes.d.ts","sourceRoot":"","sources":["../../../src/v4/builders/nodes.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"nodes.d.ts","sourceRoot":"","sources":["../../../src/v4/builders/nodes.ts"],"names":[],"mappings":"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"}

package/dist/v4/builders/nodes.js

@@ -73,6 +73,7 @@ export const Nodes = Object.freeze({
                 method: opts.method,
                 ...(opts.body ? { body: opts.body } : {}),
                 ...(opts.headers ? { headers: opts.headers } : {}),
+                ...(opts.options ? { options: opts.options } : {}),
             },
         };
     },

package/dist/v4/index.d.ts

@@ -2,6 +2,7 @@ export { Client, type ClientOptions } from "./client";
 export { Chains, type ChainId } from "./chains";
 export { Triggers } from "./builders/triggers";
 export { Nodes } from "./builders/nodes";
+export { Protocols, type AbiFragment, type AddressByChain } from "./protocols";
 export { buildAuthMessage, signAuthMessage, AUTH_TEMPLATE, type BuildAuthMessageInput, type BuiltAuthMessage, } from "./auth";
 export { APIError, NetworkError, AuthRequiredError } from "./internal/errors";
 export { AuthResource } from "./resources/auth";

package/dist/v4/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/v4/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,KAAK,OAAO,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,GACtB,MAAM,QAAQ,CAAC;AAChB,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAK9E,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAI1D,YAAY,EAAE,EAAE,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/v4/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,KAAK,OAAO,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,KAAK,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,GACtB,MAAM,QAAQ,CAAC;AAChB,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAK9E,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAI1D,YAAY,EAAE,EAAE,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/v4/index.js

@@ -6,6 +6,7 @@ export { Client } from "./client";
 export { Chains } from "./chains";
 export { Triggers } from "./builders/triggers";
 export { Nodes } from "./builders/nodes";
+export { Protocols } from "./protocols";
 export { buildAuthMessage, signAuthMessage, AUTH_TEMPLATE, } from "./auth";
 export { APIError, NetworkError, AuthRequiredError } from "./internal/errors";
 // Resource classes are exported in case advanced consumers want to

package/dist/v4/protocols/aave-v3.d.ts

@@ -0,0 +1,21 @@
+import { type AbiFragment } from "./types";
+export declare const aaveV3: Readonly<{
+    pool: Partial<Record<number, `0x${string}`>>;
+    oracle: Partial<Record<number, `0x${string}`>>;
+    wethGateway: Partial<Record<number, `0x${string}`>>;
+    eventTopics: Readonly<{
+        readonly Supply: "0x2b627736bca15cd5381dcf80b0bf11fd197d01a037c52b927a881a10fb73ba61";
+        readonly Withdraw: "0x3115d1449a7b732c986cba18244e897a450f61e1bb8d589cd2e69e6c8924f9f7";
+        readonly Borrow: "0xb3d084820fb1a9decffb176436bd02558d15fac9b0ddfed8c465bc7359d7dce0";
+        readonly Repay: "0xa534c8dbe71f871f9f3530e97a74601fea17b426cae02e1c5aee42c96c784051";
+        readonly LiquidationCall: "0xe413a321e8681d831f4dbccbca790d2952b56f977908e45be37335533e005286";
+    }>;
+    poolEventsAbi: readonly AbiFragment[];
+    poolMethodsAbi: readonly AbiFragment[];
+    tokens: Readonly<{
+        LINK: {
+            11155111: "0xf8Fb3713D459D7C1018BD0A49D19b4C44290EBE5";
+        };
+    }>;
+}>;
+//# sourceMappingURL=aave-v3.d.ts.map

package/dist/v4/protocols/aave-v3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aave-v3.d.ts","sourceRoot":"","sources":["../../../src/v4/protocols/aave-v3.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,KAAK,WAAW,EAAuB,MAAM,SAAS,CAAC;AA4NhE,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;EAQjB,CAAC"}

package/dist/v4/protocols/aave-v3.js

@@ -0,0 +1,238 @@
+// AAVE V3 whitelist context — Pool/Oracle/wethGateway addresses per
+// supported chain, the Pool ABI fragments (events + the read/write
+// methods the canonical templates target), and event-topic hashes.
+//
+// Mirrors studio/app/lib/contracts/protocols/aave-v3.ts but in a flat,
+// data-only shape — no UI metadata (no `slug`, `label`, `description`
+// fields, no `KnownProtocol`/`KnownEvent` envelopes). The SDK only needs
+// the raw whitelist context so template tests can stop hard-coding it.
+// Studio's UI layer keeps its richer shape; both will eventually consume
+// from the same canonical data once studio's request-builder moves over.
+//
+// Address parity with studio's per-chain data files:
+//   sepolia       → app/lib/aave/v3/data/sepolia.json
+//   ethereum      → app/lib/aave/v3/data/ethereum.json
+//   base          → app/lib/aave/v3/data/base.json
+//   base-sepolia  → app/lib/aave/v3/data/base-sepolia.json
+// If those drift, update here too.
+import { Chains } from "../chains";
+/**
+ * AAVE V3 Pool addresses per chain. The Pool is the single entry point
+ * for supply / borrow / repay / withdraw / liquidationCall and is the
+ * contract whose events templates filter on (`Supply`, `Borrow`, etc.).
+ */
+const pool = {
+    [Chains.EthereumMainnet]: "0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2",
+    [Chains.Sepolia]: "0x6Ae43d3271ff6888e7Fc43Fd7321a503ff738951",
+    [Chains.BaseMainnet]: "0xA238Dd80C259a72e81d7e4664a9801593F98d1c5",
+    [Chains.BaseSepolia]: "0x8bAB6d1b75f19e9eD9fCe8b9BD338844fF79aE27",
+};
+/**
+ * Aave Oracle — the price feed used by Pool to value collateral and
+ * debt. Templates that derive health-factor-equivalent metrics off
+ * chain can hit this directly to avoid a Pool round-trip.
+ */
+const oracle = {
+    [Chains.EthereumMainnet]: "0x54586bE62E3c3580375aE3723C145253060Ca0C2",
+    [Chains.Sepolia]: "0x2da88497588bf89281816106C7259e31AF45a663",
+    [Chains.BaseMainnet]: "0x2Cc0Fc26eD4563A5ce5e8bdcfe1A2878676Ae156",
+    [Chains.BaseSepolia]: "0x943b0dE18d4abf4eF02A85912F8fc07684C141dF",
+};
+/**
+ * WETH gateway — wraps native ETH supplies so Pool can hold WETH as
+ * the reserve. Templates that supply native ETH (rather than an
+ * already-wrapped token) go through here instead of Pool directly.
+ */
+const wethGateway = {
+    [Chains.EthereumMainnet]: "0xd01607c3C5eCABa394D8be377a08590149325722",
+    [Chains.Sepolia]: "0x387d311e47e80b498169e6fb51d3193167d89F7D",
+    [Chains.BaseMainnet]: "0xa0d9C1E9E48Ca30c8d8C3B5D69FF5dc1f6DFfC24",
+    [Chains.BaseSepolia]: "0x0568130e794429D2eEBC4dafE18f25Ff1a1ed8b6",
+};
+/**
+ * Pre-computed keccak256 of the canonical event signatures. Cheaper
+ * than recomputing per-call and stable across deployments. Match
+ * topics[0] on `eventTrigger` queries against these.
+ */
+const eventTopics = Object.freeze({
+    Supply: "0x2b627736bca15cd5381dcf80b0bf11fd197d01a037c52b927a881a10fb73ba61",
+    Withdraw: "0x3115d1449a7b732c986cba18244e897a450f61e1bb8d589cd2e69e6c8924f9f7",
+    Borrow: "0xb3d084820fb1a9decffb176436bd02558d15fac9b0ddfed8c465bc7359d7dce0",
+    Repay: "0xa534c8dbe71f871f9f3530e97a74601fea17b426cae02e1c5aee42c96c784051",
+    LiquidationCall: "0xe413a321e8681d831f4dbccbca790d2952b56f977908e45be37335533e005286",
+});
+/**
+ * Pool event ABI — Supply / Withdraw / Borrow / Repay / LiquidationCall.
+ * Used by `eventTrigger` queries to decode topic data so downstream
+ * nodes can reference `reserve`, `amount`, `onBehalfOf`, etc. by name.
+ */
+const 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",
+    },
+]);
+/**
+ * Pool method ABI — the read + write surface templates routinely call:
+ * `getUserAccountData` (account health), `supply`, `borrow`, `repay`,
+ * `withdraw`, and `setUserUseReserveAsCollateral`. Mirrors the
+ * `actions[]` block in studio's `aave-v3.ts` but as raw ABI so
+ * `Nodes.contractRead`/`contractWrite` can consume it directly.
+ */
+const 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",
+    },
+]);
+/**
+ * Per-chain reserve token addresses for the assets AAVE V3 markets
+ * keep available across chains. Mainly used by template tests that
+ * need a known faucet-mintable token to drive supply/borrow flows
+ * against the live testnet markets. Extend per chain as more reserves
+ * become test-relevant.
+ *
+ * NOTE: the Sepolia LINK here is AAVE's *faucet-mintable test token*
+ * wired into the Sepolia market, not mainnet ChainLink LINK.
+ */
+const tokens = Object.freeze({
+    LINK: {
+        [Chains.Sepolia]: "0xf8Fb3713D459D7C1018BD0A49D19b4C44290EBE5",
+    },
+});
+export const aaveV3 = Object.freeze({
+    pool,
+    oracle,
+    wethGateway,
+    eventTopics,
+    poolEventsAbi,
+    poolMethodsAbi,
+    tokens,
+});

package/dist/v4/protocols/aerodrome.d.ts

@@ -0,0 +1,4 @@
+export declare const aerodrome: Readonly<{
+    router: Partial<Record<number, `0x${string}`>>;
+}>;
+//# sourceMappingURL=aerodrome.d.ts.map

package/dist/v4/protocols/aerodrome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aerodrome.d.ts","sourceRoot":"","sources":["../../../src/v4/protocols/aerodrome.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,SAAS;;EAEpB,CAAC"}

package/dist/v4/protocols/aerodrome.js

@@ -0,0 +1,9 @@
+// Aerodrome — Base-native AMM (Velodrome V2 fork). Base-only.
+// Swaps route through `Route` hops (from, to, stable, factory).
+import { Chains } from "../chains";
+const router = {
+    [Chains.BaseMainnet]: "0xcF77a3Ba9A5CA399B7c97c74d54e5b1Beb874E43",
+};
+export const aerodrome = Object.freeze({
+    router,
+});

package/dist/v4/protocols/chainlink.d.ts

@@ -0,0 +1,7 @@
+export declare const chainlink: Readonly<{
+    ethUsdFeed: Partial<Record<number, `0x${string}`>>;
+    btcUsdFeed: Partial<Record<number, `0x${string}`>>;
+    /** Shared AggregatorV3 ABI — works for any Chainlink feed. */
+    aggregatorV3Abi: readonly import("./types").AbiFragment[];
+}>;
+//# sourceMappingURL=chainlink.d.ts.map

package/dist/v4/protocols/chainlink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chainlink.d.ts","sourceRoot":"","sources":["../../../src/v4/protocols/chainlink.ts"],"names":[],"mappings":"AAwBA,eAAO,MAAM,SAAS;;;IAGpB,8DAA8D;;EAE9D,CAAC"}

package/dist/v4/protocols/chainlink.js

@@ -0,0 +1,25 @@
+// Chainlink Data Feeds — AggregatorV3Interface price oracles.
+//
+// The ABI for every Chainlink Data Feed is the same (AggregatorV3
+// Interface), so it lives in `./common.ts` as `aggregatorV3Abi` and
+// every feed entry below reuses it. The catalog ships the ETH/USD +
+// BTC/USD feeds Studio surfaces by default plus the Sepolia ETH/USD
+// feed the v4 stoploss template test uses.
+//
+// Address verification dates: same as studio's chainlink.ts (May 2026).
+// Extend with more feeds (LINK/USD, EUR/USD, etc.) as templates land.
+import { Chains } from "../chains";
+import { aggregatorV3Abi } from "./common";
+const ethUsdFeed = {
+    [Chains.EthereumMainnet]: "0x5f4eC3Df9cbd43714FE2740f5E3616155c5b8419",
+    [Chains.Sepolia]: "0x694AA1769357215DE4FAC081bf1f309aDC325306",
+};
+const btcUsdFeed = {
+    [Chains.EthereumMainnet]: "0xF4030086522a5bEEa4988F8cA5B36dbC97BeE88c",
+};
+export const chainlink = Object.freeze({
+    ethUsdFeed,
+    btcUsdFeed,
+    /** Shared AggregatorV3 ABI — works for any Chainlink feed. */
+    aggregatorV3Abi,
+});

package/dist/v4/protocols/common.d.ts

@@ -0,0 +1,16 @@
+import { type AbiFragment } from "./types";
+/**
+ * Chainlink AggregatorV3Interface — `latestRoundData` and `decimals`.
+ * Every Chainlink Data Feed contract implements this, so the same ABI
+ * works for ETH/USD, BTC/USD, LINK/USD, etc.
+ */
+export declare const aggregatorV3Abi: readonly AbiFragment[];
+/**
+ * Minimal ERC-4626 vault ABI — `deposit`, `redeem`, `previewRedeem`,
+ * `convertToAssets`. Sufficient for staking vault templates that wrap
+ * an underlying into a yield-bearing share token (sfrxETH, sDAI, etc.).
+ * Vaults with non-standard write paths (e.g. sUSDe's cooldown +
+ * unstake) ship their own ABI in their own protocol module.
+ */
+export declare const erc4626VaultAbi: readonly AbiFragment[];
+//# sourceMappingURL=common.d.ts.map

package/dist/v4/protocols/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../src/v4/protocols/common.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,SAAS,WAAW,EAqBhD,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,EAAE,SAAS,WAAW,EAoChD,CAAC"}

package/dist/v4/protocols/common.js

@@ -0,0 +1,76 @@
+// Shared ABI fragments that more than one protocol routinely reuses:
+// - AggregatorV3Interface for any Chainlink-compatible price feed
+// - ERC-4626 deposit/redeem for staking vaults (sUSDe, sfrxETH, sDAI, ...)
+// - ERC-20 approve already lives in `./erc20.ts` — keep that import path
+//   stable since it's the most-touched fragment in the catalog.
+/**
+ * Chainlink AggregatorV3Interface — `latestRoundData` and `decimals`.
+ * Every Chainlink Data Feed contract implements this, so the same ABI
+ * works for ETH/USD, BTC/USD, LINK/USD, etc.
+ */
+export const 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",
+    },
+]);
+/**
+ * Minimal ERC-4626 vault ABI — `deposit`, `redeem`, `previewRedeem`,
+ * `convertToAssets`. Sufficient for staking vault templates that wrap
+ * an underlying into a yield-bearing share token (sfrxETH, sDAI, etc.).
+ * Vaults with non-standard write paths (e.g. sUSDe's cooldown +
+ * unstake) ship their own ABI in their own protocol module.
+ */
+export const 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",
+    },
+]);

package/dist/v4/protocols/compound-v3.d.ts

@@ -0,0 +1,4 @@
+export declare const compoundV3: Readonly<{
+    cometUsdc: Partial<Record<number, `0x${string}`>>;
+}>;
+//# sourceMappingURL=compound-v3.d.ts.map

package/dist/v4/protocols/compound-v3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compound-v3.d.ts","sourceRoot":"","sources":["../../../src/v4/protocols/compound-v3.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,UAAU;;EAErB,CAAC"}

package/dist/v4/protocols/compound-v3.js

@@ -0,0 +1,15 @@
+// Compound V3 (Comet) — USDC base market.
+//
+// Comet bundles supply/borrow on a single contract: `supply` /
+// `withdraw` move the base asset (USDC, 6 decimals) or collateral;
+// `withdraw` past zero opens a borrow.
+//
+// Address parity with studio/app/lib/contracts/protocols/compound-v3.ts.
+import { Chains } from "../chains";
+const cometUsdc = {
+    [Chains.EthereumMainnet]: "0xc3d688B66703497DAA19211EEdff47f25384cdc3",
+    [Chains.BaseMainnet]: "0xb125E6687d4313864e53df431d5425969c15Eb2F",
+};
+export const compoundV3 = Object.freeze({
+    cometUsdc,
+});

package/dist/v4/protocols/erc20.d.ts

@@ -0,0 +1,5 @@
+import { type AbiFragment } from "./types";
+export declare const erc20: Readonly<{
+    approveAbi: readonly AbiFragment[];
+}>;
+//# sourceMappingURL=erc20.d.ts.map

package/dist/v4/protocols/erc20.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"erc20.d.ts","sourceRoot":"","sources":["../../../src/v4/protocols/erc20.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,eAAO,MAAM,KAAK;gBAYV,SAAS,WAAW,EAAE;EAC5B,CAAC"}

package/dist/v4/protocols/erc20.js

@@ -0,0 +1,18 @@
+// Minimal ERC-20 ABI fragments that templates routinely need but don't
+// belong to any one protocol. `approveAbi` is the standard 2-arg ERC-20
+// approve — used by any DeFi flow that funnels tokens through a protocol's
+// pool/router (AAVE.supply, Uniswap.swap, etc.).
+export const 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",
+        },
+    ]),
+});

package/dist/v4/protocols/ethena.d.ts

@@ -0,0 +1,7 @@
+import { type AbiFragment } from "./types";
+export declare const ethena: Readonly<{
+    susde: Partial<Record<number, `0x${string}`>>;
+    usde: Partial<Record<number, `0x${string}`>>;
+    susdeAbi: readonly AbiFragment[];
+}>;
+//# sourceMappingURL=ethena.d.ts.map

package/dist/v4/protocols/ethena.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ethena.d.ts","sourceRoot":"","sources":["../../../src/v4/protocols/ethena.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,WAAW,EAAuB,MAAM,SAAS,CAAC;AAmDhE,eAAO,MAAM,MAAM;;;;EAIjB,CAAC"}

package/dist/v4/protocols/ethena.js

@@ -0,0 +1,58 @@
+// Ethena — USDe synthetic dollar + sUSDe staking vault.
+//
+// sUSDe (StakedUSDeV2) is ERC-4626-shaped on the deposit side but
+// gates withdrawals behind a cooldown: redemption is a two-step
+// `cooldownShares` → `unstake` flow, NOT a direct ERC-4626 redeem.
+// So we ship a custom ABI rather than reusing `common.erc4626VaultAbi`.
+import { Chains } from "../chains";
+const susde = {
+    [Chains.EthereumMainnet]: "0x9D39A5DE30e57443BfF2A8307A4256c8797A3497",
+};
+const usde = {
+    [Chains.EthereumMainnet]: "0x4c9EDD5852cd905f086C759E8383e09bff1E68B3",
+};
+const 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",
+    },
+]);
+export const ethena = Object.freeze({
+    susde,
+    usde,
+    susdeAbi,
+});

package/dist/v4/protocols/frax-ether.d.ts

@@ -0,0 +1,7 @@
+export declare const fraxEther: Readonly<{
+    sfrxeth: Partial<Record<number, `0x${string}`>>;
+    frxeth: Partial<Record<number, `0x${string}`>>;
+    /** Standard ERC-4626 surface — sfrxETH conforms exactly. */
+    vaultAbi: readonly import("./types").AbiFragment[];
+}>;
+//# sourceMappingURL=frax-ether.d.ts.map

package/dist/v4/protocols/frax-ether.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frax-ether.d.ts","sourceRoot":"","sources":["../../../src/v4/protocols/frax-ether.ts"],"names":[],"mappings":"AAmBA,eAAO,MAAM,SAAS;;;IAGpB,4DAA4D;;EAE5D,CAAC"}