@eulerxyz/euler-v2-sdk 0.1.0-beta

package/dist/src/entities/EulerLabels.d.ts

@@ -0,0 +1,53 @@
+export type EulerLabelVaults = {
+    [address: string]: EulerLabelVault;
+};
+export type EulerLabelVault = {
+    name: string;
+    description: string;
+    entity: string | string[];
+};
+export type EulerLabelEntity = {
+    name: string;
+    logo: string;
+    description: string;
+    url: string;
+    addresses: Record<string, string>;
+    social: {
+        twitter: string;
+        youtube: string;
+        discord: string;
+        telegram: string;
+        github: string;
+    };
+};
+export type EulerLabelProduct = {
+    name: string;
+    description: string;
+    entity: string[];
+    url: string;
+    logo?: string;
+    vaults: string[];
+    deprecatedVaults?: string[];
+    deprecationReason?: string;
+};
+export type EulerLabelPoint = {
+    name: string;
+    logo: string;
+    description?: string;
+    url?: string;
+    entity?: string | string[];
+    token?: string;
+    collateralVaults?: string[];
+    liabilityVaults?: string[];
+    skipTooltipPrefix?: boolean;
+    isTurtleClub?: boolean;
+};
+/** Combined label data resolved for a specific vault. Logos are resolved to full URLs. */
+export type EulerLabel = {
+    vault: EulerLabelVault;
+    entities: EulerLabelEntity[];
+    products: EulerLabelProduct[];
+    points: EulerLabelPoint[];
+    deprecated?: boolean;
+    deprecationReason?: string;
+};

package/dist/src/entities/EulerLabels.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=EulerLabels.js.map

package/dist/src/entities/EulerLabels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EulerLabels.js","sourceRoot":"","sources":["../../../src/entities/EulerLabels.ts"],"names":[],"mappings":""}

package/dist/src/entities/SecuritizeCollateralVault.d.ts

@@ -0,0 +1,16 @@
+import type { Address } from "viem";
+import { ERC4626Vault, type IERC4626Vault, type IERC4626VaultConversion } from "./ERC4626Vault.js";
+export interface ISecuritizeCollateralVault extends IERC4626Vault {
+    governor: Address;
+    supplyCap: bigint;
+}
+export declare class SecuritizeCollateralVault extends ERC4626Vault implements ISecuritizeCollateralVault, IERC4626VaultConversion {
+    governor: Address;
+    supplyCap: bigint;
+    constructor(args: ISecuritizeCollateralVault);
+    get isBorrowable(): boolean;
+    /** 1:1 conversion (standard ERC4626 when totalShares === totalAssets). */
+    convertToAssets(shares: bigint): bigint;
+    /** 1:1 conversion (standard ERC4626 when totalShares === totalAssets). */
+    convertToShares(assets: bigint): bigint;
+}

package/dist/src/entities/SecuritizeCollateralVault.js

@@ -0,0 +1,22 @@
+import { ERC4626Vault, } from "./ERC4626Vault.js";
+export class SecuritizeCollateralVault extends ERC4626Vault {
+    governor;
+    supplyCap;
+    constructor(args) {
+        super(args);
+        this.governor = args.governor;
+        this.supplyCap = args.supplyCap;
+    }
+    get isBorrowable() {
+        return false;
+    }
+    /** 1:1 conversion (standard ERC4626 when totalShares === totalAssets). */
+    convertToAssets(shares) {
+        return shares;
+    }
+    /** 1:1 conversion (standard ERC4626 when totalShares === totalAssets). */
+    convertToShares(assets) {
+        return assets;
+    }
+}
+//# sourceMappingURL=SecuritizeCollateralVault.js.map

package/dist/src/entities/SecuritizeCollateralVault.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SecuritizeCollateralVault.js","sourceRoot":"","sources":["../../../src/entities/SecuritizeCollateralVault.ts"],"names":[],"mappings":"AACA,OAAO,EACN,YAAY,GAGZ,MAAM,mBAAmB,CAAC;AAO3B,MAAM,OAAO,yBACZ,SAAQ,YAAY;IAGpB,QAAQ,CAAU;IAClB,SAAS,CAAS;IAElB,YAAY,IAAgC;QAC3C,KAAK,CAAC,IAAI,CAAC,CAAC;QACZ,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;IACjC,CAAC;IAED,IAAa,YAAY;QACxB,OAAO,KAAK,CAAC;IACd,CAAC;IAED,0EAA0E;IACjE,eAAe,CAAC,MAAc;QACtC,OAAO,MAAM,CAAC;IACf,CAAC;IAED,0EAA0E;IACjE,eAAe,CAAC,MAAc;QACtC,OAAO,MAAM,CAAC;IACf,CAAC;CACD"}

package/dist/src/entities/Wallet.d.ts

@@ -0,0 +1,27 @@
+import { type Address } from "viem";
+export interface IWallet {
+    chainId: number;
+    account: Address;
+    assets: WalletAsset[];
+}
+export interface AssetAllowances {
+    assetForVault: bigint;
+    assetForPermit2: bigint;
+    assetForVaultInPermit2: bigint;
+    permit2ExpirationTime: number;
+}
+export interface WalletAsset {
+    account: Address;
+    asset: Address;
+    balance: bigint;
+    allowances: Record<Address, AssetAllowances>;
+}
+export declare class Wallet implements IWallet {
+    chainId: number;
+    account: Address;
+    assets: WalletAsset[];
+    constructor(wallet: IWallet);
+    getAsset(asset: Address): WalletAsset | undefined;
+    getBalance(asset: Address): bigint;
+    getAllowances(asset: Address, spender: Address): AssetAllowances | undefined;
+}

package/dist/src/entities/Wallet.js

@@ -0,0 +1,21 @@
+import { isAddressEqual } from "viem";
+export class Wallet {
+    chainId;
+    account;
+    assets;
+    constructor(wallet) {
+        this.chainId = wallet.chainId;
+        this.account = wallet.account;
+        this.assets = wallet.assets;
+    }
+    getAsset(asset) {
+        return this.assets.find((a) => isAddressEqual(a.asset, asset));
+    }
+    getBalance(asset) {
+        return this.getAsset(asset)?.balance ?? 0n;
+    }
+    getAllowances(asset, spender) {
+        return this.getAsset(asset)?.allowances[spender];
+    }
+}
+//# sourceMappingURL=Wallet.js.map

package/dist/src/entities/Wallet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Wallet.js","sourceRoot":"","sources":["../../../src/entities/Wallet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,cAAc,EAAE,MAAM,MAAM,CAAC;AAsBpD,MAAM,OAAO,MAAM;IAClB,OAAO,CAAS;IAChB,OAAO,CAAU;IACjB,MAAM,CAAgB;IAEtB,YAAY,MAAe;QAC1B,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC9B,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC9B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC7B,CAAC;IAED,QAAQ,CAAC,KAAc;QACtB,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;IAChE,CAAC;IAED,UAAU,CAAC,KAAc;QACxB,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,IAAI,EAAE,CAAC;IAC5C,CAAC;IAED,aAAa,CAAC,KAAc,EAAE,OAAgB;QAC7C,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;IAClD,CAAC;CACD"}

package/dist/src/index.d.ts

@@ -0,0 +1,43 @@
+export * from "./entities/ERC4626Vault.js";
+export * from "./entities/EVault.js";
+export * from "./entities/Account.js";
+export * from "./entities/Wallet.js";
+export * from "./entities/EulerEarn.js";
+export * from "./entities/EulerLabels.js";
+export * from "./sdk/sdk.js";
+export * from "./sdk/buildSDK.js";
+export { defaultVaultTypeSubgraphAdapterConfig } from "./sdk/defaultConfig.js";
+/** @deprecated Use `buildEulerSDK` instead. */
+export { buildEulerSDK as buildSDK } from "./sdk/buildSDK.js";
+export * from "./services/abiService/index.js";
+export * from "./services/accountService/index.js";
+export * from "./services/walletService/index.js";
+export * from "./services/deploymentService/index.js";
+export * from "./services/vaults/eulerEarnService/index.js";
+export * from "./services/eulerLabelsService/index.js";
+export * from "./services/tokenlistService/index.js";
+export * from "./services/vaults/eVaultService/index.js";
+export * from "./services/vaults/vaultMetaService/index.js";
+export * from "./services/vaults/index.js";
+export * from "./services/executionService/index.js";
+export * from "./services/providerService/index.js";
+export * from "./services/swapService/index.js";
+export * from "./services/priceService/index.js";
+export * from "./services/rewardsService/index.js";
+export * from "./services/intrinsicApyService/index.js";
+export * from "./services/oracleAdapterService/index.js";
+export * from "./services/simulationService/index.js";
+export * from "./services/feeFlowService/index.js";
+export * from "./plugins/index.js";
+export * from "./utils/subAccounts.js";
+export { type BuildQueryFn, type QueryCacheConfig, applyBuildQuery, createQueryCacheBuildQuery, } from "./utils/buildQuery.js";
+export type { EulerSDKQueryName, QueryMethodName } from "./utils/queryNames.js";
+export * from "./utils/stateOverrides/index.js";
+export * from "./utils/oracle.js";
+export * from "./utils/accountComputations.js";
+export * from "./utils/callBundler.js";
+export * from "./utils/entityDiagnostics.js";
+export * from "./utils/normalization.js";
+export * from "./utils/parsing.js";
+export * from "./utils/decodeSmartContractErrors.js";
+export * from "./utils/eulerErrorSelectors.js";

package/dist/src/index.js

@@ -0,0 +1,46 @@
+export * from "./entities/ERC4626Vault.js";
+export * from "./entities/EVault.js";
+export * from "./entities/Account.js";
+export * from "./entities/Wallet.js";
+export * from "./entities/EulerEarn.js";
+export * from "./entities/EulerLabels.js";
+export * from "./sdk/sdk.js";
+export * from "./sdk/buildSDK.js";
+export { defaultVaultTypeSubgraphAdapterConfig } from "./sdk/defaultConfig.js";
+/** @deprecated Use `buildEulerSDK` instead. */
+export { buildEulerSDK as buildSDK } from "./sdk/buildSDK.js";
+// Services
+export * from "./services/abiService/index.js";
+export * from "./services/accountService/index.js";
+export * from "./services/walletService/index.js";
+export * from "./services/deploymentService/index.js";
+export * from "./services/vaults/eulerEarnService/index.js";
+export * from "./services/eulerLabelsService/index.js";
+export * from "./services/tokenlistService/index.js";
+export * from "./services/vaults/eVaultService/index.js";
+export * from "./services/vaults/vaultMetaService/index.js";
+export * from "./services/vaults/index.js";
+export * from "./services/executionService/index.js";
+export * from "./services/providerService/index.js";
+export * from "./services/swapService/index.js";
+export * from "./services/priceService/index.js";
+export * from "./services/rewardsService/index.js";
+export * from "./services/intrinsicApyService/index.js";
+export * from "./services/oracleAdapterService/index.js";
+export * from "./services/simulationService/index.js";
+export * from "./services/feeFlowService/index.js";
+// Plugins
+export * from "./plugins/index.js";
+// Utils
+export * from "./utils/subAccounts.js";
+export { applyBuildQuery, createQueryCacheBuildQuery, } from "./utils/buildQuery.js";
+export * from "./utils/stateOverrides/index.js";
+export * from "./utils/oracle.js";
+export * from "./utils/accountComputations.js";
+export * from "./utils/callBundler.js";
+export * from "./utils/entityDiagnostics.js";
+export * from "./utils/normalization.js";
+export * from "./utils/parsing.js";
+export * from "./utils/decodeSmartContractErrors.js";
+export * from "./utils/eulerErrorSelectors.js";
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,qCAAqC,EAAE,MAAM,wBAAwB,CAAC;AAC/E,+CAA+C;AAC/C,OAAO,EAAE,aAAa,IAAI,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE9D,WAAW;AACX,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oCAAoC,CAAC;AACnD,cAAc,mCAAmC,CAAC;AAClD,cAAc,uCAAuC,CAAC;AACtD,cAAc,6CAA6C,CAAC;AAC5D,cAAc,wCAAwC,CAAC;AACvD,cAAc,sCAAsC,CAAC;AACrD,cAAc,0CAA0C,CAAC;AACzD,cAAc,6CAA6C,CAAC;AAC5D,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sCAAsC,CAAC;AACrD,cAAc,qCAAqC,CAAC;AACpD,cAAc,iCAAiC,CAAC;AAChD,cAAc,kCAAkC,CAAC;AACjD,cAAc,oCAAoC,CAAC;AACnD,cAAc,yCAAyC,CAAC;AACxD,cAAc,0CAA0C,CAAC;AACzD,cAAc,uCAAuC,CAAC;AACtD,cAAc,oCAAoC,CAAC;AAEnD,UAAU;AACV,cAAc,oBAAoB,CAAC;AAEnC,QAAQ;AACR,cAAc,wBAAwB,CAAC;AACvC,OAAO,EAGN,eAAe,EACf,0BAA0B,GAC1B,MAAM,uBAAuB,CAAC;AAE/B,cAAc,iCAAiC,CAAC;AAChD,cAAc,mBAAmB,CAAC;AAClC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sCAAsC,CAAC;AACrD,cAAc,gCAAgC,CAAC"}

package/dist/src/plugins/batchSimulation.d.ts

@@ -0,0 +1,34 @@
+import { type Abi, type Address, type Hex, type PublicClient } from "viem";
+import type { EVCBatchItem } from "../services/executionService/executionServiceTypes.js";
+import { type BuildQueryFn } from "../utils/buildQuery.js";
+export interface ExecuteBatchSimulationParams {
+    provider: PublicClient;
+    evcAddress: Address;
+    prependItems: EVCBatchItem[];
+    totalValue: bigint;
+    lensAddress: Address;
+    lensAbi: Abi | readonly unknown[];
+    lensFunctionName: string;
+    lensArgs: unknown[];
+}
+/**
+ * Adapter for EVC batchSimulation calls.
+ * Follows the SDK's injectable query pattern: the raw RPC call is a `query*` arrow
+ * function property, wrapped by `applyBuildQuery` for logging/caching/profiling.
+ */
+export declare class BatchSimulationAdapter {
+    constructor(buildQuery?: BuildQueryFn);
+    /**
+     * Execute an EVC batchSimulation via eth_call.
+     * The calldata should already be encoded as batchSimulation(items).
+     */
+    queryBatchSimulation: (provider: PublicClient, evcAddress: Address, calldata: Hex, value: bigint) => Promise<Hex | undefined>;
+}
+/**
+ * Wraps a lens contract call inside EVC.batchSimulation() with prepended batch items.
+ * This enables read-time injection of state changes (e.g. Pyth price updates) that
+ * are atomically applied before the lens read, without any on-chain transaction.
+ *
+ * Returns the decoded lens call result, or undefined on failure.
+ */
+export declare function executeBatchSimulation<T>(params: ExecuteBatchSimulationParams, adapter?: BatchSimulationAdapter): Promise<T | undefined>;

package/dist/src/plugins/batchSimulation.js

@@ -0,0 +1,83 @@
+import { decodeFunctionResult, encodeFunctionData, zeroAddress, } from "viem";
+import { ethereumVaultConnectorAbi } from "../services/executionService/abis/ethereumVaultConnectorAbi.js";
+import { applyBuildQuery } from "../utils/buildQuery.js";
+/**
+ * Adapter for EVC batchSimulation calls.
+ * Follows the SDK's injectable query pattern: the raw RPC call is a `query*` arrow
+ * function property, wrapped by `applyBuildQuery` for logging/caching/profiling.
+ */
+export class BatchSimulationAdapter {
+    constructor(buildQuery) {
+        if (buildQuery)
+            applyBuildQuery(this, buildQuery);
+    }
+    /**
+     * Execute an EVC batchSimulation via eth_call.
+     * The calldata should already be encoded as batchSimulation(items).
+     */
+    queryBatchSimulation = async (provider, evcAddress, calldata, value) => {
+        const result = await provider.call({
+            to: evcAddress,
+            data: calldata,
+            value,
+        });
+        return result.data;
+    };
+}
+/**
+ * Wraps a lens contract call inside EVC.batchSimulation() with prepended batch items.
+ * This enables read-time injection of state changes (e.g. Pyth price updates) that
+ * are atomically applied before the lens read, without any on-chain transaction.
+ *
+ * Returns the decoded lens call result, or undefined on failure.
+ */
+export async function executeBatchSimulation(params, adapter) {
+    const { provider, evcAddress, prependItems, totalValue, lensAddress, lensAbi, lensFunctionName, lensArgs, } = params;
+    try {
+        const lensCalldata = encodeFunctionData({
+            abi: lensAbi,
+            functionName: lensFunctionName,
+            args: lensArgs,
+        });
+        const lensBatchItem = {
+            targetContract: lensAddress,
+            onBehalfOfAccount: zeroAddress,
+            value: 0n,
+            data: lensCalldata,
+        };
+        const batchItems = [...prependItems, lensBatchItem];
+        const calldata = encodeFunctionData({
+            abi: ethereumVaultConnectorAbi,
+            functionName: "batchSimulation",
+            args: [batchItems],
+        });
+        const ds = adapter ?? new BatchSimulationAdapter();
+        const resultData = await ds.queryBatchSimulation(provider, evcAddress, calldata, totalValue);
+        if (!resultData)
+            return undefined;
+        const decoded = decodeFunctionResult({
+            abi: ethereumVaultConnectorAbi,
+            functionName: "batchSimulation",
+            data: resultData,
+        });
+        // batchSimulation returns [BatchItemResult[], StatusCheckResult[], StatusCheckResult[]]
+        const batchResults = decoded[0];
+        if (!batchResults || batchResults.length === 0)
+            return undefined;
+        // The lens call is the last item in the batch
+        const lensResult = batchResults[batchResults.length - 1];
+        if (!lensResult.success)
+            return undefined;
+        // Decode the lens result using the lens ABI
+        const lensDecoded = decodeFunctionResult({
+            abi: lensAbi,
+            functionName: lensFunctionName,
+            data: lensResult.result,
+        });
+        return lensDecoded;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=batchSimulation.js.map

package/dist/src/plugins/batchSimulation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batchSimulation.js","sourceRoot":"","sources":["../../../src/plugins/batchSimulation.ts"],"names":[],"mappings":"AAAA,OAAO,EAKN,oBAAoB,EACpB,kBAAkB,EAClB,WAAW,GACX,MAAM,MAAM,CAAC;AAEd,OAAO,EAAE,yBAAyB,EAAE,MAAM,gEAAgE,CAAC;AAC3G,OAAO,EAAqB,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAkB5E;;;;GAIG;AACH,MAAM,OAAO,sBAAsB;IAClC,YAAY,UAAyB;QACpC,IAAI,UAAU;YAAE,eAAe,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACnD,CAAC;IAED;;;OAGG;IACH,oBAAoB,GAAG,KAAK,EAC3B,QAAsB,EACtB,UAAmB,EACnB,QAAa,EACb,KAAa,EACc,EAAE;QAC7B,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC;YAClC,EAAE,EAAE,UAAU;YACd,IAAI,EAAE,QAAQ;YACd,KAAK;SACL,CAAC,CAAC;QACH,OAAO,MAAM,CAAC,IAAI,CAAC;IACpB,CAAC,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC3C,MAAoC,EACpC,OAAgC;IAEhC,MAAM,EACL,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,UAAU,EACV,WAAW,EACX,OAAO,EACP,gBAAgB,EAChB,QAAQ,GACR,GAAG,MAAM,CAAC;IAEX,IAAI,CAAC;QACJ,MAAM,YAAY,GAAG,kBAAkB,CAAC;YACvC,GAAG,EAAE,OAAc;YACnB,YAAY,EAAE,gBAAgB;YAC9B,IAAI,EAAE,QAAQ;SACd,CAAC,CAAC;QAEH,MAAM,aAAa,GAAiB;YACnC,cAAc,EAAE,WAAW;YAC3B,iBAAiB,EAAE,WAAW;YAC9B,KAAK,EAAE,EAAE;YACT,IAAI,EAAE,YAAY;SAClB,CAAC;QAEF,MAAM,UAAU,GAAG,CAAC,GAAG,YAAY,EAAE,aAAa,CAAC,CAAC;QAEpD,MAAM,QAAQ,GAAG,kBAAkB,CAAC;YACnC,GAAG,EAAE,yBAAyB;YAC9B,YAAY,EAAE,iBAAiB;YAC/B,IAAI,EAAE,CAAC,UAAU,CAAC;SAClB,CAAC,CAAC;QAEH,MAAM,EAAE,GAAG,OAAO,IAAI,IAAI,sBAAsB,EAAE,CAAC;QACnD,MAAM,UAAU,GAAG,MAAM,EAAE,CAAC,oBAAoB,CAC/C,QAAQ,EACR,UAAU,EACV,QAAQ,EACR,UAAU,CACV,CAAC;QAEF,IAAI,CAAC,UAAU;YAAE,OAAO,SAAS,CAAC;QAElC,MAAM,OAAO,GAAG,oBAAoB,CAAC;YACpC,GAAG,EAAE,yBAAyB;YAC9B,YAAY,EAAE,iBAAiB;YAC/B,IAAI,EAAE,UAAU;SAChB,CAAC,CAAC;QAEH,wFAAwF;QACxF,MAAM,YAAY,GACjB,OACA,CAAC,CAAC,CAAsB,CAAC;QAC1B,IAAI,CAAC,YAAY,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QAEjE,8CAA8C;QAC9C,MAAM,UAAU,GAAG,YAAY,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC;QAC1D,IAAI,CAAC,UAAU,CAAC,OAAO;YAAE,OAAO,SAAS,CAAC;QAE1C,4CAA4C;QAC5C,MAAM,WAAW,GAAG,oBAAoB,CAAC;YACxC,GAAG,EAAE,OAAc;YACnB,YAAY,EAAE,gBAAgB;YAC9B,IAAI,EAAE,UAAU,CAAC,MAAM;SACvB,CAAC,CAAC;QAEH,OAAO,WAAgB,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,SAAS,CAAC;IAClB,CAAC;AACF,CAAC"}

package/dist/src/plugins/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./types.js";
+export * from "./batchSimulation.js";
+export * from "./pyth/index.js";
+export * from "./keyring/index.js";

package/dist/src/plugins/index.js

@@ -0,0 +1,5 @@
+export * from "./types.js";
+export * from "./batchSimulation.js";
+export * from "./pyth/index.js";
+export * from "./keyring/index.js";
+//# sourceMappingURL=index.js.map

package/dist/src/plugins/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/plugins/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC"}

package/dist/src/plugins/keyring/index.d.ts

@@ -0,0 +1 @@
+export { createKeyringPlugin, KeyringPluginAdapter, type KeyringPluginConfig, type KeyringCredentialData, } from "./keyringPlugin.js";

package/dist/src/plugins/keyring/index.js

@@ -0,0 +1,2 @@
+export { createKeyringPlugin, KeyringPluginAdapter, } from "./keyringPlugin.js";
+//# sourceMappingURL=index.js.map

package/dist/src/plugins/keyring/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/plugins/keyring/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,mBAAmB,EACnB,oBAAoB,GAGpB,MAAM,oBAAoB,CAAC"}

package/dist/src/plugins/keyring/keyringPlugin.d.ts

@@ -0,0 +1,41 @@
+import { type Address, type Hex, type PublicClient } from "viem";
+import type { EulerPlugin } from "../types.js";
+import { type BuildQueryFn } from "../../utils/buildQuery.js";
+export interface KeyringCredentialData {
+    trader: Address;
+    policyId: number;
+    chainId: number;
+    validUntil: number;
+    cost: number;
+    key: Hex;
+    signature: Hex;
+    backdoor: Hex;
+}
+export declare class KeyringPluginAdapter {
+    constructor(buildQuery?: BuildQueryFn);
+    /**
+     * Check if an account has a valid Keyring credential (or wildcard) on a hook target.
+     */
+    queryKeyringCheckCredential: (provider: PublicClient, hookTarget: Address, account: Address) => Promise<boolean>;
+    /**
+     * Read the policyId from a hook target contract.
+     */
+    queryKeyringPolicyId: (provider: PublicClient, hookTarget: Address) => Promise<number>;
+    /**
+     * Read the keyring credentials contract address from a hook target.
+     */
+    queryKeyringAddress: (provider: PublicClient, hookTarget: Address) => Promise<Address>;
+}
+export interface KeyringPluginConfig {
+    /** Known Keyring hook target addresses per chain. Only vaults with these hookTargets will be handled. */
+    hookTargets: Record<number, Address[]>;
+    /** Callback to get credential data. Called when a vault requires keyring and the account doesn't have a valid credential. */
+    getCredentialData: (args: {
+        chainId: number;
+        account: Address;
+        hookTarget: Address;
+        policyId: number;
+    }) => Promise<KeyringCredentialData | null>;
+    buildQuery?: BuildQueryFn;
+}
+export declare function createKeyringPlugin(config: KeyringPluginConfig): EulerPlugin;

package/dist/src/plugins/keyring/keyringPlugin.js

@@ -0,0 +1,182 @@
+import { encodeFunctionData, decodeFunctionData, zeroAddress, } from "viem";
+import { prependToBatch } from "../types.js";
+import { applyBuildQuery } from "../../utils/buildQuery.js";
+// ── Keyring ABIs (minimal: only the functions we need) ──
+const KEYRING_CONTRACT_ABI = [
+    {
+        type: "function",
+        name: "createCredential",
+        inputs: [
+            { name: "tradingAddress", type: "address" },
+            { name: "policyId", type: "uint256" },
+            { name: "chainId", type: "uint256" },
+            { name: "validUntil", type: "uint256" },
+            { name: "cost", type: "uint256" },
+            { name: "key", type: "bytes" },
+            { name: "signature", type: "bytes" },
+            { name: "backdoor", type: "bytes" },
+        ],
+        outputs: [],
+        stateMutability: "payable",
+    },
+];
+const HOOK_TARGET_ABI = [
+    {
+        type: "function",
+        name: "checkKeyringCredentialOrWildCard",
+        inputs: [{ name: "account", type: "address" }],
+        outputs: [{ name: "", type: "bool" }],
+        stateMutability: "view",
+    },
+    {
+        type: "function",
+        name: "policyId",
+        inputs: [],
+        outputs: [{ name: "", type: "uint32" }],
+        stateMutability: "view",
+    },
+    {
+        type: "function",
+        name: "keyring",
+        inputs: [],
+        outputs: [{ name: "", type: "address" }],
+        stateMutability: "view",
+    },
+];
+// ── Adapter (injectable query pattern) ──
+export class KeyringPluginAdapter {
+    constructor(buildQuery) {
+        if (buildQuery)
+            applyBuildQuery(this, buildQuery);
+    }
+    /**
+     * Check if an account has a valid Keyring credential (or wildcard) on a hook target.
+     */
+    queryKeyringCheckCredential = async (provider, hookTarget, account) => {
+        return provider.readContract({
+            address: hookTarget,
+            abi: HOOK_TARGET_ABI,
+            functionName: "checkKeyringCredentialOrWildCard",
+            args: [account],
+        });
+    };
+    /**
+     * Read the policyId from a hook target contract.
+     */
+    queryKeyringPolicyId = async (provider, hookTarget) => {
+        return provider.readContract({
+            address: hookTarget,
+            abi: HOOK_TARGET_ABI,
+            functionName: "policyId",
+        });
+    };
+    /**
+     * Read the keyring credentials contract address from a hook target.
+     */
+    queryKeyringAddress = async (provider, hookTarget) => {
+        return provider.readContract({
+            address: hookTarget,
+            abi: HOOK_TARGET_ABI,
+            functionName: "keyring",
+        });
+    };
+}
+/**
+ * Check if a vault's hook target is a known Keyring hook.
+ */
+function isKeyringHook(vault, hookTargets) {
+    const target = vault.hooks.hookTarget;
+    if (!target || target === zeroAddress)
+        return false;
+    return hookTargets.some((ht) => ht.toLowerCase() === target.toLowerCase());
+}
+export function createKeyringPlugin(config) {
+    const adapter = new KeyringPluginAdapter(config.buildQuery);
+    return {
+        name: "keyring",
+        // Keyring does not affect reads — no getReadPrepend
+        async processPlan(plan, ctx) {
+            const chainHookTargets = config.hookTargets[ctx.chainId];
+            if (!chainHookTargets?.length)
+                return plan;
+            // Find vaults that have keyring hooks
+            const keyringVaults = ctx.vaults.filter((v) => isKeyringHook(v, chainHookTargets));
+            if (!keyringVaults.length)
+                return plan;
+            const items = [];
+            for (const vault of keyringVaults) {
+                try {
+                    const hookTarget = vault.hooks.hookTarget;
+                    // Check if credential is already valid
+                    const hasCredential = await adapter.queryKeyringCheckCredential(ctx.provider, hookTarget, ctx.sender);
+                    if (hasCredential)
+                        continue;
+                    // Read policyId and keyring address from hook target
+                    const [policyId, keyringAddress] = await Promise.all([
+                        adapter.queryKeyringPolicyId(ctx.provider, hookTarget),
+                        adapter.queryKeyringAddress(ctx.provider, hookTarget),
+                    ]);
+                    // Get credential data from consumer callback
+                    const credentialData = await config.getCredentialData({
+                        chainId: ctx.chainId,
+                        account: ctx.sender,
+                        hookTarget,
+                        policyId,
+                    });
+                    if (!credentialData)
+                        continue;
+                    items.push({
+                        targetContract: keyringAddress,
+                        onBehalfOfAccount: ctx.sender,
+                        value: BigInt(credentialData.cost),
+                        data: encodeFunctionData({
+                            abi: KEYRING_CONTRACT_ABI,
+                            functionName: "createCredential",
+                            args: [
+                                credentialData.trader,
+                                BigInt(credentialData.policyId),
+                                BigInt(credentialData.chainId),
+                                BigInt(credentialData.validUntil),
+                                BigInt(credentialData.cost),
+                                credentialData.key,
+                                credentialData.signature,
+                                credentialData.backdoor,
+                            ],
+                        }),
+                    });
+                }
+                catch { }
+            }
+            if (!items.length)
+                return plan;
+            return prependToBatch(plan, items);
+        },
+        decodeBatchItem(item) {
+            try {
+                const decoded = decodeFunctionData({
+                    abi: KEYRING_CONTRACT_ABI,
+                    data: item.data,
+                });
+                const functionAbi = KEYRING_CONTRACT_ABI.find((a) => a.type === "function" && a.name === decoded.functionName);
+                const namedArgs = {};
+                if (functionAbi &&
+                    "inputs" in functionAbi &&
+                    Array.isArray(decoded.args)) {
+                    functionAbi.inputs.forEach((input, index) => {
+                        namedArgs[input.name] = decoded.args?.[index];
+                    });
+                }
+                return {
+                    targetContract: item.targetContract,
+                    onBehalfOfAccount: item.onBehalfOfAccount,
+                    functionName: decoded.functionName,
+                    args: namedArgs,
+                };
+            }
+            catch {
+                return null;
+            }
+        },
+    };
+}
+//# sourceMappingURL=keyringPlugin.js.map

package/dist/src/plugins/keyring/keyringPlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyringPlugin.js","sourceRoot":"","sources":["../../../../src/plugins/keyring/keyringPlugin.ts"],"names":[],"mappings":"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"}

package/dist/src/plugins/pyth/index.d.ts

@@ -0,0 +1 @@
+export { createPythPlugin, PythPluginAdapter, type PythPluginConfig, } from "./pythPlugin.js";

package/dist/src/plugins/pyth/index.js

@@ -0,0 +1,2 @@
+export { createPythPlugin, PythPluginAdapter, } from "./pythPlugin.js";
+//# sourceMappingURL=index.js.map