@eulerxyz/euler-v2-sdk 0.1.0-beta

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/plugins/pyth/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,gBAAgB,EAChB,iBAAiB,GAEjB,MAAM,iBAAiB,CAAC"}

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

@@ -0,0 +1,29 @@
+import { type Address, type Hex, type PublicClient } from "viem";
+import type { EulerPlugin } from "../types.js";
+import { type BuildQueryFn } from "../../utils/buildQuery.js";
+/**
+ * Adapter for the Pyth plugin. Follows the SDK's injectable query pattern:
+ * all external calls are `query*` arrow-function properties, wrapped by `applyBuildQuery`.
+ */
+export declare class PythPluginAdapter {
+    private hermesUrl;
+    private fetchFn;
+    constructor(hermesUrl: string, buildQuery?: BuildQueryFn, fetchFn?: typeof fetch);
+    /**
+     * Fetch latest price update data from Pyth Hermes API.
+     * FeedIds are automatically bundled across concurrent calls within the same tick.
+     */
+    queryPythUpdateData: (keys: `0x${string}`[]) => Promise<`0x${string}`[]>;
+    private fetchPythUpdateData;
+    /**
+     * Query the on-chain Pyth contract for the fee required to update given price data.
+     */
+    queryPythUpdateFee: (provider: PublicClient, pythAddress: Address, updateData: Hex[]) => Promise<bigint>;
+    setQueryPythUpdateData(fn: typeof this.queryPythUpdateData): void;
+    setQueryPythUpdateFee(fn: typeof this.queryPythUpdateFee): void;
+}
+export interface PythPluginConfig {
+    hermesUrl?: string;
+    buildQuery?: BuildQueryFn;
+}
+export declare function createPythPlugin(config?: PythPluginConfig): EulerPlugin;

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

@@ -0,0 +1,190 @@
+import { encodeFunctionData, decodeFunctionData, zeroAddress, } from "viem";
+import { prependToBatch } from "../types.js";
+import { collectPythFeedsFromAdapters, } from "../../utils/oracle.js";
+import { applyBuildQuery } from "../../utils/buildQuery.js";
+import { createBundledCall } from "../../utils/callBundler.js";
+// ── Pyth ABI (minimal: only the two functions we need) ──
+const PYTH_ABI = [
+    {
+        type: "function",
+        name: "getUpdateFee",
+        inputs: [{ name: "updateData", type: "bytes[]" }],
+        outputs: [{ name: "feeAmount", type: "uint256" }],
+        stateMutability: "view",
+    },
+    {
+        type: "function",
+        name: "updatePriceFeeds",
+        inputs: [{ name: "updateData", type: "bytes[]" }],
+        outputs: [],
+        stateMutability: "payable",
+    },
+];
+// ── Hermes data fetch (injectable query pattern) ──
+const normalizeHex = (value) => (value.startsWith("0x") ? value : `0x${value}`);
+const normalizeFeedId = (value) => normalizeHex(value).toLowerCase();
+const PYTH_PRICE_ID_PATTERN = /0x[0-9a-fA-F]{64}/g;
+const parseMissingPriceIds = (body) => {
+    const matches = body.match(PYTH_PRICE_ID_PATTERN) ?? [];
+    return new Set(matches.map((id) => normalizeFeedId(id)));
+};
+/**
+ * Adapter for the Pyth plugin. Follows the SDK's injectable query pattern:
+ * all external calls are `query*` arrow-function properties, wrapped by `applyBuildQuery`.
+ */
+export class PythPluginAdapter {
+    hermesUrl;
+    fetchFn;
+    constructor(hermesUrl, buildQuery, fetchFn = globalThis.fetch) {
+        this.hermesUrl = hermesUrl;
+        this.fetchFn = fetchFn;
+        if (buildQuery)
+            applyBuildQuery(this, buildQuery);
+    }
+    /**
+     * Fetch latest price update data from Pyth Hermes API.
+     * FeedIds are automatically bundled across concurrent calls within the same tick.
+     */
+    queryPythUpdateData = createBundledCall(async (feedIds) => {
+        const normalizedIds = [...new Set(feedIds.map(normalizeFeedId))];
+        if (!normalizedIds.length)
+            return [];
+        return this.fetchPythUpdateData(normalizedIds);
+    });
+    fetchPythUpdateData = async (feedIds) => {
+        if (!feedIds.length)
+            return [];
+        const url = new URL("/v2/updates/price/latest", this.hermesUrl);
+        feedIds.forEach((id) => url.searchParams.append("ids[]", id));
+        url.searchParams.set("encoding", "hex");
+        const response = await this.fetchFn(url.toString());
+        if (!response.ok) {
+            const body = await response.text().catch(() => "");
+            if (response.status === 404) {
+                const missingIds = parseMissingPriceIds(body);
+                if (missingIds.size > 0) {
+                    const retryIds = feedIds.filter((id) => !missingIds.has(id));
+                    return this.fetchPythUpdateData(retryIds);
+                }
+            }
+            throw new Error(`Failed to fetch Pyth update data: ${response.status}${body ? ` ${body}` : ""}`);
+        }
+        const body = (await response.json());
+        const binaryData = body?.binary?.data;
+        if (!Array.isArray(binaryData))
+            return [];
+        return binaryData.map((item) => normalizeHex(String(item)));
+    };
+    /**
+     * Query the on-chain Pyth contract for the fee required to update given price data.
+     */
+    queryPythUpdateFee = async (provider, pythAddress, updateData) => {
+        return provider.readContract({
+            address: pythAddress,
+            abi: PYTH_ABI,
+            functionName: "getUpdateFee",
+            args: [updateData],
+        });
+    };
+    setQueryPythUpdateData(fn) {
+        this.queryPythUpdateData = fn;
+    }
+    setQueryPythUpdateFee(fn) {
+        this.queryPythUpdateFee = fn;
+    }
+}
+// ── Core batch item builder ──
+async function buildPythBatchItems(feeds, adapter, provider, sender = zeroAddress) {
+    if (!feeds.length)
+        return { items: [], totalValue: 0n };
+    // Group feeds by Pyth contract address
+    const grouped = new Map();
+    for (const feed of feeds) {
+        const set = grouped.get(feed.pythAddress) || new Set();
+        set.add(feed.feedId);
+        grouped.set(feed.pythAddress, set);
+    }
+    const items = [];
+    let totalValue = 0n;
+    for (const [pythAddress, feedSet] of grouped.entries()) {
+        try {
+            const updateData = await adapter.queryPythUpdateData([...feedSet]);
+            if (!updateData.length)
+                continue;
+            const fee = await adapter.queryPythUpdateFee(provider, pythAddress, updateData);
+            items.push({
+                targetContract: pythAddress,
+                onBehalfOfAccount: sender,
+                value: fee,
+                data: encodeFunctionData({
+                    abi: PYTH_ABI,
+                    functionName: "updatePriceFeeds",
+                    args: [updateData],
+                }),
+            });
+            totalValue += fee;
+        }
+        catch { }
+    }
+    return { items, totalValue };
+}
+// ── Deduplicate feeds ──
+function deduplicateFeeds(feeds) {
+    const seen = new Map();
+    for (const feed of feeds) {
+        const key = `${feed.pythAddress.toLowerCase()}:${feed.feedId.toLowerCase()}`;
+        if (!seen.has(key))
+            seen.set(key, feed);
+    }
+    return [...seen.values()];
+}
+export function createPythPlugin(config = {}) {
+    const hermesUrl = config.hermesUrl || "https://hermes.pyth.network";
+    const adapter = new PythPluginAdapter(hermesUrl, config.buildQuery);
+    return {
+        name: "pyth",
+        async getReadPrepend(ctx) {
+            const feeds = deduplicateFeeds(ctx.vaults.flatMap((v) => collectPythFeedsFromAdapters(v.oracle.adapters)));
+            if (!feeds.length)
+                return null;
+            const result = await buildPythBatchItems(feeds, adapter, ctx.provider);
+            return result.items.length > 0 ? result : null;
+        },
+        async processPlan(plan, ctx) {
+            const feeds = deduplicateFeeds(ctx.vaults.flatMap((v) => collectPythFeedsFromAdapters(v.oracle.adapters)));
+            if (!feeds.length)
+                return plan;
+            const result = await buildPythBatchItems(feeds, adapter, ctx.provider, ctx.sender);
+            if (!result.items.length)
+                return plan;
+            return prependToBatch(plan, result.items);
+        },
+        decodeBatchItem(item) {
+            try {
+                const decoded = decodeFunctionData({
+                    abi: PYTH_ABI,
+                    data: item.data,
+                });
+                const functionAbi = PYTH_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=pythPlugin.js.map

package/dist/src/plugins/pyth/pythPlugin.js.map

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

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

@@ -0,0 +1,39 @@
+import type { Address, Hex, PublicClient } from "viem";
+import type { EVault } from "../entities/EVault.js";
+import type { BatchItemDescription, EVCBatchItem, TransactionPlan } from "../services/executionService/executionServiceTypes.js";
+export interface PluginBatchItems {
+    items: EVCBatchItem[];
+    totalValue: bigint;
+}
+export interface ReadPluginContext {
+    chainId: number;
+    vaults: EVault[];
+    provider: PublicClient;
+}
+export interface Signer {
+    signTypedData(data: Record<string, unknown>): Promise<Hex>;
+    sendTransaction(tx: {
+        to: Address;
+        data: Hex;
+        value?: bigint;
+    }): Promise<Hex>;
+}
+export interface WritePluginContext extends ReadPluginContext {
+    sender: Address;
+    collateralAddresses?: Address[];
+    signer?: Signer;
+}
+export interface EulerPlugin {
+    name: string;
+    /** Return batch items to prepend when simulating lens reads. null = not relevant for these vaults. */
+    getReadPrepend?(ctx: ReadPluginContext): Promise<PluginBatchItems | null>;
+    /** Transform a transaction plan (e.g. prepend oracle updates, resolve approvals). */
+    processPlan?(plan: TransactionPlan, ctx: WritePluginContext): Promise<TransactionPlan>;
+    /** Decode a batch item that this plugin produced. Return null if the item is not from this plugin. */
+    decodeBatchItem?(item: EVCBatchItem): BatchItemDescription | null;
+}
+export type ProcessPluginsArgs = Omit<WritePluginContext, "provider">;
+/**
+ * Prepend batch items to the first `evcBatch` entry in a transaction plan.
+ */
+export declare function prependToBatch(plan: TransactionPlan, items: EVCBatchItem[]): TransactionPlan;

package/dist/src/plugins/types.js

@@ -0,0 +1,16 @@
+/**
+ * Prepend batch items to the first `evcBatch` entry in a transaction plan.
+ */
+export function prependToBatch(plan, items) {
+    if (items.length === 0)
+        return plan;
+    let prepended = false;
+    return plan.map((entry) => {
+        if (entry.type === "evcBatch" && !prepended) {
+            prepended = true;
+            return { ...entry, items: [...items, ...entry.items] };
+        }
+        return entry;
+    });
+}
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/plugins/types.ts"],"names":[],"mappings":"AA8CA;;GAEG;AACH,MAAM,UAAU,cAAc,CAC7B,IAAqB,EACrB,KAAqB;IAErB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEpC,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,KAA0B,EAAE,EAAE;QAC9C,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,IAAI,CAAC,SAAS,EAAE,CAAC;YAC7C,SAAS,GAAG,IAAI,CAAC;YACjB,OAAO,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,CAAC,GAAG,KAAK,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QACxD,CAAC;QACD,OAAO,KAAK,CAAC;IACd,CAAC,CAAC,CAAC;AACJ,CAAC"}

package/dist/src/sdk/buildSDK.d.ts

@@ -0,0 +1,77 @@
+import { EulerSDK } from "./sdk.js";
+import { type IABIService } from "../services/abiService/index.js";
+import { type IDeploymentService } from "../services/deploymentService/index.js";
+import { type IProviderService } from "../services/providerService/index.js";
+import { type IAccountService } from "../services/accountService/index.js";
+import { type AccountVaultsSubgraphAdapterConfig } from "../services/accountService/adapters/accountOnchainAdapter/accountVaultsSubgraphAdapter.js";
+import type { AccountServiceConfig } from "../services/accountService/accountServiceConfig.js";
+import { type IWalletService } from "../services/walletService/index.js";
+import { type IEVaultService } from "../services/vaults/eVaultService/index.js";
+import type { EVaultServiceConfig } from "../services/vaults/eVaultService/eVaultServiceConfig.js";
+import { type EulerEarnServiceConfig, type IEulerEarnService } from "../services/vaults/eulerEarnService/index.js";
+import { type ISecuritizeVaultService } from "../services/vaults/securitizeVaultService/index.js";
+import { type EulerLabelsURLAdapterConfig, type IEulerLabelsService } from "../services/eulerLabelsService/index.js";
+import { type ITokenlistService } from "../services/tokenlistService/index.js";
+import { type ISwapService, type SwapServiceConfig } from "../services/swapService/index.js";
+import { type IExecutionService } from "../services/executionService/index.js";
+import { type IPriceService, type BackendConfig } from "../services/priceService/index.js";
+import { type IRewardsService, type RewardsServiceConfig } from "../services/rewardsService/index.js";
+import { type IIntrinsicApyService, type IntrinsicApyServiceConfig } from "../services/intrinsicApyService/index.js";
+import { type IOracleAdapterService, type OracleAdapterServiceConfig } from "../services/oracleAdapterService/index.js";
+import { type ISimulationService } from "../services/simulationService/index.js";
+import { type IFeeFlowService, type FeeFlowServiceConfig } from "../services/feeFlowService/index.js";
+import type { TokenlistServiceConfig } from "../services/tokenlistService/index.js";
+import { type IVaultMetaService, type VaultEntity, type VaultServiceEntry } from "../services/vaults/vaultMetaService/index.js";
+import type { VaultTypeSubgraphAdapterConfig, VaultTypeV3AdapterConfig } from "../services/vaults/vaultMetaService/index.js";
+import type { IVaultEntity } from "../entities/Account.js";
+import { type BuildQueryFn, type QueryCacheConfig } from "../utils/buildQuery.js";
+import type { EulerPlugin } from "../plugins/types.js";
+export interface BuildSDKOverrides<TVaultEntity extends IVaultEntity = VaultEntity> {
+    abiService?: IABIService;
+    deploymentService?: IDeploymentService;
+    providerService?: IProviderService;
+    accountService?: IAccountService<TVaultEntity>;
+    walletService?: IWalletService;
+    eVaultService?: IEVaultService;
+    eulerEarnService?: IEulerEarnService;
+    securitizeVaultService?: ISecuritizeVaultService;
+    vaultMetaService?: IVaultMetaService<TVaultEntity>;
+    eulerLabelsService?: IEulerLabelsService;
+    tokenlistService?: ITokenlistService;
+    swapService?: ISwapService;
+    executionService?: IExecutionService;
+    simulationService?: ISimulationService<TVaultEntity>;
+    priceService?: IPriceService;
+    rewardsService?: IRewardsService;
+    intrinsicApyService?: IIntrinsicApyService;
+    oracleAdapterService?: IOracleAdapterService;
+    feeFlowService?: IFeeFlowService;
+}
+export interface BuildSDKOptions<TVaultEntity extends IVaultEntity = VaultEntity> {
+    rpcUrls: Record<number, string>;
+    /** Optional API key propagated to built-in V3 HTTP adapters as `X-API-Key`. */
+    v3ApiKey?: string;
+    accountServiceConfig?: AccountServiceConfig;
+    eVaultServiceConfig?: EVaultServiceConfig;
+    eulerEarnServiceConfig?: EulerEarnServiceConfig;
+    accountVaultsAdapterConfig?: AccountVaultsSubgraphAdapterConfig;
+    vaultTypeAdapterConfig?: VaultTypeSubgraphAdapterConfig | VaultTypeV3AdapterConfig;
+    /** Additional vault services to register; use { type, service } to register a custom vault type for getFactoryByType(chainId, type). Pass the extended entity type as the generic (e.g. buildEulerSDK<VaultEntity | CustomVault>({ ..., additionalVaultServices: [{ type: 'CustomVault', service: customService }] })). */
+    additionalVaultServices?: VaultServiceEntry<TVaultEntity>[];
+    eulerLabelsAdapterConfig?: EulerLabelsURLAdapterConfig;
+    tokenlistServiceConfig?: TokenlistServiceConfig;
+    swapServiceConfig?: SwapServiceConfig;
+    backendConfig?: BackendConfig;
+    rewardsServiceConfig?: RewardsServiceConfig;
+    intrinsicApyServiceConfig?: IntrinsicApyServiceConfig;
+    oracleAdapterServiceConfig?: OracleAdapterServiceConfig;
+    feeFlowServiceConfig?: FeeFlowServiceConfig;
+    /** Default in-memory cache applied to all decorated `query*` methods. Enabled by default with a 5s TTL. */
+    queryCacheConfig?: QueryCacheConfig;
+    /** Optional query decorator applied to all query* functions across all services. Use for global logging, caching, profiling, etc. */
+    buildQuery?: BuildQueryFn;
+    /** Plugins that enrich on-chain reads (via batchSimulation) and transaction plans (via processPlan). */
+    plugins?: EulerPlugin[];
+    servicesOverrides?: BuildSDKOverrides<TVaultEntity>;
+}
+export declare function buildEulerSDK<TVaultEntity extends IVaultEntity = VaultEntity>(options: BuildSDKOptions<TVaultEntity>): Promise<EulerSDK<TVaultEntity>>;