@eulerxyz/euler-v2-sdk 0.1.0-beta

package/dist/src/services/walletService/adapters/walletOnchainAdapter.js

@@ -0,0 +1,222 @@
+import { getAddress, erc20Abi } from "viem";
+import { applyBuildQuery, } from "../../../utils/buildQuery.js";
+import { numberLikeToSafeFiniteNumber } from "../../../utils/normalization.js";
+// Permit2 IAllowanceTransfer.allowance function ABI
+const permit2AllowanceAbi = [
+    {
+        type: "function",
+        name: "allowance",
+        inputs: [
+            { name: "user", type: "address" },
+            { name: "token", type: "address" },
+            { name: "spender", type: "address" },
+        ],
+        outputs: [
+            { name: "amount", type: "uint160" },
+            { name: "expiration", type: "uint48" },
+            { name: "nonce", type: "uint48" },
+        ],
+        stateMutability: "view",
+    },
+];
+export class WalletOnchainAdapter {
+    providerService;
+    deploymentService;
+    constructor(providerService, deploymentService, buildQuery) {
+        this.providerService = providerService;
+        this.deploymentService = deploymentService;
+        if (buildQuery)
+            applyBuildQuery(this, buildQuery);
+    }
+    setProviderService(providerService) {
+        this.providerService = providerService;
+    }
+    queryBalanceOf = async (provider, asset, account) => {
+        return provider.readContract({
+            address: asset,
+            abi: erc20Abi,
+            functionName: "balanceOf",
+            args: [account],
+        });
+    };
+    setQueryBalanceOf(fn) {
+        this.queryBalanceOf = fn;
+    }
+    queryAllowance = async (provider, asset, owner, spender) => {
+        return provider.readContract({
+            address: asset,
+            abi: erc20Abi,
+            functionName: "allowance",
+            args: [owner, spender],
+        });
+    };
+    setQueryAllowance(fn) {
+        this.queryAllowance = fn;
+    }
+    queryPermit2Allowance = async (provider, permit2Address, owner, asset, spender) => {
+        return provider.readContract({
+            address: permit2Address,
+            abi: permit2AllowanceAbi,
+            functionName: "allowance",
+            args: [owner, asset, spender],
+        });
+    };
+    setQueryPermit2Allowance(fn) {
+        this.queryPermit2Allowance = fn;
+    }
+    async fetchWallet(chainId, account, assetsWithSpenders) {
+        const provider = this.providerService.getProvider(chainId);
+        const deployment = this.deploymentService.getDeployment(chainId);
+        const permit2Address = deployment.addresses.coreAddrs.permit2;
+        const errors = [];
+        try {
+            const walletAssets = [];
+            // Fetch all data in parallel
+            const assetResults = await Promise.all(assetsWithSpenders.map(async ({ asset, spenders }, assetIdx) => {
+                const assetAddress = getAddress(asset);
+                const balanceResult = await this.queryBalanceOf(provider, assetAddress, account)
+                    .then((value) => ({ value, failed: false }))
+                    .catch(() => ({ value: undefined, failed: true }));
+                const spenderResults = await Promise.all(spenders.map(async (spender) => {
+                    const spenderAddress = getAddress(spender);
+                    const assetForVault = await this.queryAllowance(provider, assetAddress, account, spender)
+                        .then((value) => ({ value, failed: false }))
+                        .catch(() => ({ value: 0n, failed: true }));
+                    const assetForPermit2 = await this.queryAllowance(provider, assetAddress, account, permit2Address)
+                        .then((value) => ({ value, failed: false }))
+                        .catch(() => ({ value: 0n, failed: true }));
+                    const permit2Allowance = await this.queryPermit2Allowance(provider, permit2Address, account, assetAddress, spender)
+                        .then((value) => ({ value, failed: false }))
+                        .catch(() => ({
+                        value: [0n, 0, 0],
+                        failed: true,
+                    }));
+                    if (assetForVault.failed) {
+                        errors.push({
+                            code: "SOURCE_UNAVAILABLE",
+                            severity: "warning",
+                            message: "Failed to fetch asset allowance for spender; defaulted to 0.",
+                            paths: [
+                                `$.assets[${assetIdx}].allowances['${spenderAddress}'].assetForVault`,
+                            ],
+                            entityId: assetAddress,
+                            source: "erc20.allowance",
+                            normalizedValue: "0",
+                        });
+                    }
+                    if (assetForPermit2.failed) {
+                        errors.push({
+                            code: "SOURCE_UNAVAILABLE",
+                            severity: "warning",
+                            message: "Failed to fetch Permit2 allowance approval; defaulted to 0.",
+                            paths: [
+                                `$.assets[${assetIdx}].allowances['${spenderAddress}'].assetForPermit2`,
+                            ],
+                            entityId: assetAddress,
+                            source: "erc20.allowance",
+                            normalizedValue: "0",
+                        });
+                    }
+                    if (permit2Allowance.failed) {
+                        errors.push({
+                            code: "SOURCE_UNAVAILABLE",
+                            severity: "warning",
+                            message: "Failed to fetch Permit2 spender allowance; defaulted to 0.",
+                            paths: [
+                                `$.assets[${assetIdx}].allowances['${spenderAddress}'].assetForVaultInPermit2`,
+                            ],
+                            entityId: assetAddress,
+                            source: "permit2.allowance",
+                            normalizedValue: "0",
+                        });
+                    }
+                    return {
+                        spender,
+                        spenderAddress,
+                        assetForVault,
+                        assetForPermit2,
+                        permit2Allowance,
+                    };
+                }));
+                return {
+                    assetAddress,
+                    assetIdx,
+                    balanceResult,
+                    spenders,
+                    spenderResults,
+                };
+            }));
+            for (const { assetAddress, assetIdx, balanceResult, spenders, spenderResults, } of assetResults) {
+                const balance = balanceResult.value;
+                if (balance === undefined) {
+                    errors.push({
+                        code: "SOURCE_UNAVAILABLE",
+                        severity: "warning",
+                        message: "Failed to fetch asset balance; asset entry omitted from wallet result.",
+                        paths: ["$.assets"],
+                        entityId: assetAddress,
+                        source: "erc20.balanceOf",
+                        originalValue: assetAddress,
+                        normalizedValue: "asset-omitted",
+                    });
+                    console.error(`Failed to fetch balance for ${account} and asset ${assetAddress}`);
+                    continue;
+                }
+                const allowances = {};
+                for (let i = 0; i < spenders.length; i++) {
+                    const spender = spenders[i];
+                    if (!spender)
+                        continue;
+                    const result = spenderResults[i];
+                    if (!result)
+                        continue;
+                    const spenderAddress = result.spenderAddress;
+                    const assetForVault = result.assetForVault.value;
+                    const assetForPermit2 = result.assetForPermit2.value;
+                    const permit2Result = result.permit2Allowance.value;
+                    const assetForVaultInPermit2 = permit2Result?.[0] ?? 0n;
+                    const permit2ExpirationTime = numberLikeToSafeFiniteNumber((permit2Result?.[1] ?? 0), {
+                        path: `$.assets[${assetIdx}].allowances['${spenderAddress}'].permit2ExpirationTime`,
+                        errors,
+                        source: "permit2.allowance",
+                        fallback: 0,
+                    });
+                    allowances[getAddress(spender)] = {
+                        assetForVault,
+                        assetForPermit2,
+                        assetForVaultInPermit2,
+                        permit2ExpirationTime,
+                    };
+                }
+                walletAssets.push({
+                    account,
+                    asset: assetAddress,
+                    balance,
+                    allowances,
+                });
+            }
+            return {
+                result: {
+                    chainId,
+                    account,
+                    assets: walletAssets,
+                },
+                errors,
+            };
+        }
+        catch (error) {
+            console.error(`Failed to fetch wallet info for ${account}:`, error);
+            errors.push({
+                code: "SOURCE_UNAVAILABLE",
+                severity: "warning",
+                message: "Failed to fetch wallet info.",
+                paths: ["$"],
+                entityId: account,
+                source: "walletOnchainAdapter",
+                originalValue: error instanceof Error ? error.message : String(error),
+            });
+            return { result: undefined, errors };
+        }
+    }
+}
+//# sourceMappingURL=walletOnchainAdapter.js.map

package/dist/src/services/walletService/adapters/walletOnchainAdapter.js.map

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

package/dist/src/services/walletService/index.d.ts

@@ -0,0 +1,3 @@
+export { WalletService } from "./walletService.js";
+export type { IWalletService, IWalletAdapter, AssetWithSpenders, } from "./walletService.js";
+export type { TransactionPlanItem } from "../executionService/executionServiceTypes.js";

package/dist/src/services/walletService/index.js

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

package/dist/src/services/walletService/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/services/walletService/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/src/services/walletService/walletService.d.ts

@@ -0,0 +1,19 @@
+import { Wallet, type IWallet } from "../../entities/Wallet.js";
+import type { Address } from "viem";
+import { type ServiceResult } from "../../utils/entityDiagnostics.js";
+export interface AssetWithSpenders {
+    asset: Address;
+    spenders: Address[];
+}
+export interface IWalletAdapter {
+    fetchWallet(chainId: number, account: Address, assetsWithSpenders: AssetWithSpenders[]): Promise<ServiceResult<IWallet | undefined>>;
+}
+export interface IWalletService {
+    fetchWallet(chainId: number, account: Address, assetsWithSpenders: AssetWithSpenders[]): Promise<ServiceResult<Wallet>>;
+}
+export declare class WalletService implements IWalletService {
+    private adapter;
+    constructor(adapter: IWalletAdapter);
+    setAdapter(adapter: IWalletAdapter): void;
+    fetchWallet(chainId: number, account: Address, assetsWithSpenders: AssetWithSpenders[]): Promise<ServiceResult<Wallet>>;
+}

package/dist/src/services/walletService/walletService.js

@@ -0,0 +1,37 @@
+import { Wallet } from "../../entities/Wallet.js";
+import { compressDataIssues, } from "../../utils/entityDiagnostics.js";
+export class WalletService {
+    adapter;
+    constructor(adapter) {
+        this.adapter = adapter;
+    }
+    setAdapter(adapter) {
+        this.adapter = adapter;
+    }
+    async fetchWallet(chainId, account, assetsWithSpenders) {
+        const fetched = await this.adapter.fetchWallet(chainId, account, assetsWithSpenders);
+        if (!fetched.result) {
+            const emptyWallet = { chainId, account, assets: [] };
+            return {
+                result: new Wallet(emptyWallet),
+                errors: [
+                    ...fetched.errors,
+                    {
+                        code: "SOURCE_UNAVAILABLE",
+                        severity: "warning",
+                        message: "Wallet adapter returned no data; created empty wallet.",
+                        paths: ["$"],
+                        entityId: account,
+                        source: "walletAdapter",
+                        normalizedValue: "empty-wallet",
+                    },
+                ],
+            };
+        }
+        return {
+            result: new Wallet(fetched.result),
+            errors: compressDataIssues(fetched.errors),
+        };
+    }
+}
+//# sourceMappingURL=walletService.js.map

package/dist/src/services/walletService/walletService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"walletService.js","sourceRoot":"","sources":["../../../../src/services/walletService/walletService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAgB,MAAM,0BAA0B,CAAC;AAEhE,OAAO,EACN,kBAAkB,GAElB,MAAM,kCAAkC,CAAC;AAuB1C,MAAM,OAAO,aAAa;IACL;IAApB,YAAoB,OAAuB;QAAvB,YAAO,GAAP,OAAO,CAAgB;IAAG,CAAC;IAE/C,UAAU,CAAC,OAAuB;QACjC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,WAAW,CAChB,OAAe,EACf,OAAgB,EAChB,kBAAuC;QAEvC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,CAC7C,OAAO,EACP,OAAO,EACP,kBAAkB,CAClB,CAAC;QACF,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YACrB,MAAM,WAAW,GAAY,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;YAC9D,OAAO;gBACN,MAAM,EAAE,IAAI,MAAM,CAAC,WAAW,CAAC;gBAC/B,MAAM,EAAE;oBACP,GAAG,OAAO,CAAC,MAAM;oBACjB;wBACC,IAAI,EAAE,oBAAoB;wBAC1B,QAAQ,EAAE,SAAS;wBACnB,OAAO,EAAE,wDAAwD;wBACjE,KAAK,EAAE,CAAC,GAAG,CAAC;wBACZ,QAAQ,EAAE,OAAO;wBACjB,MAAM,EAAE,eAAe;wBACvB,eAAe,EAAE,cAAc;qBAC/B;iBACD;aACD,CAAC;QACH,CAAC;QAED,OAAO;YACN,MAAM,EAAE,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;YAClC,MAAM,EAAE,kBAAkB,CAAC,OAAO,CAAC,MAAM,CAAC;SAC1C,CAAC;IACH,CAAC;CACD"}

package/dist/src/utils/accountComputations.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Pure computation functions for sub-account metrics and leverage utilities.
+ * All functions return `undefined` when prerequisites are missing.
+ */
+import type { Address } from "viem";
+import type { IAccountLiquidity, IHasVaultAddress, ISubAccount } from "../entities/Account.js";
+/**
+ * Health factor for a sub-account's borrow position.
+ * `totalCollateralValue.liquidation / liabilityValue.liquidation` (WAD, 18 dec).
+ * `> 1e18` = healthy, `< 1e18` = liquidatable.
+ */
+export declare function computeHealthFactor(subAccount: ISubAccount<IHasVaultAddress>): bigint | undefined;
+/**
+ * Current loan-to-value ratio for a sub-account.
+ * `liabilityValue.oracleMid / totalCollateralValue.oracleMid` (WAD).
+ */
+export declare function computeCurrentLTV(subAccount: ISubAccount<IHasVaultAddress>): bigint | undefined;
+/**
+ * Weighted-average liquidation LTV threshold.
+ * `totalCollateralValue.liquidation / totalCollateralValue.oracleMid` (WAD).
+ */
+export declare function computeLiquidationLTV(subAccount: ISubAccount<IHasVaultAddress>): bigint | undefined;
+/**
+ * Leverage multiplier for a sub-account (WAD, 1e18 = 1x).
+ * `totalCollateralValueUsd / (totalCollateralValueUsd - borrowedValueUsd)`.
+ */
+export declare function computeMultiplier(subAccount: ISubAccount<IHasVaultAddress>): bigint | undefined;
+/**
+ * Total collateral value in USD for a sub-account (18 dec).
+ * Sourced from sub-account liquidity and populated by `populateMarketPrices`.
+ */
+export declare function computeSubAccountTotalCollateralValueUsd(subAccount: ISubAccount<IHasVaultAddress>): bigint | undefined;
+/**
+ * Liability value in USD for a sub-account (18 dec).
+ * Sourced from sub-account liquidity and populated by `populateMarketPrices`.
+ */
+export declare function computeSubAccountLiabilityValueUsd(subAccount: ISubAccount<IHasVaultAddress>): bigint | undefined;
+/**
+ * Net value in USD for a sub-account: sum(suppliedValueUsd) - sum(borrowedValueUsd).
+ */
+export declare function computeSubAccountNetValueUsd(subAccount: ISubAccount<IHasVaultAddress>): bigint | undefined;
+/**
+ * Per-collateral liquidation price multipliers.
+ * For each collateral: `(liability - otherCollateral) / thisCollateral` (WAD).
+ * `< 1` means the price can drop by this factor before liquidation.
+ */
+export declare function computeCollateralLiquidationPrices(liquidity: IAccountLiquidity<IHasVaultAddress>): Record<Address, bigint>;
+/**
+ * Borrow liquidation price multiplier (WAD).
+ * `totalCollateralValue.liquidation / liabilityValue.liquidation`.
+ * `> 1` = borrow price can increase by this factor before liquidation.
+ */
+export declare function computeBorrowLiquidationPrice(liquidity: IAccountLiquidity<IHasVaultAddress>): bigint | undefined;
+/**
+ * ROE (Return on Equity) breakdown for a sub-account.
+ * All values are decimal fractions (0.05 = 5%).
+ */
+export interface SubAccountRoe {
+    /** ROE contribution from base supply APYs. */
+    lending: number;
+    /** ROE contribution from base borrow APYs (typically negative). */
+    borrowing: number;
+    /** ROE contribution from reward APRs (supply + borrow incentives). */
+    rewards: number;
+    /** ROE contribution from intrinsic asset yield (e.g. staking rewards, PT implied yield). */
+    intrinsicApy: number;
+    /** Total ROE: lending + borrowing + rewards + intrinsicApy. */
+    total: number;
+}
+/**
+ * Computes the ROE breakdown for a sub-account.
+ * Requires populated vaults (for APY data) and market prices (for USD values).
+ * Returns `undefined` when prerequisites are missing or equity <= 0.
+ */
+export declare function computeSubAccountRoe(subAccount: ISubAccount<IHasVaultAddress>): SubAccountRoe | undefined;
+/**
+ * Net APY relative to total supply.
+ * `(supplyUsd * (supplyApy + supplyReward) - borrowUsd * (borrowApy - borrowReward)) / supplyUsd`
+ */
+export declare function getNetApy(supplyUsd: number, supplyApy: number, borrowUsd: number, borrowApy: number, supplyRewardApy?: number, borrowRewardApy?: number): number;
+/**
+ * Return on equity (ROE): net yield relative to equity (NAV).
+ * Same numerator as getNetApy, but divided by `equity = supplyUsd - borrowUsd`.
+ */
+export declare function getRoe(supplyUsd: number, supplyApy: number, borrowUsd: number, borrowApy: number, supplyRewardApy?: number, borrowRewardApy?: number): number;
+/**
+ * Maximum multiplier for a given borrow LTV.
+ * `1 / (1 - (borrowLtv - safetyMargin))` where borrowLtv is decimal (0.85 = 85%).
+ * Floored to 2 decimal places, minimum 1.
+ */
+export declare function getMaxMultiplier(borrowLtv: number, safetyMargin?: number): number;
+/**
+ * Maximum ROE at max leverage.
+ * `supplyApy + (maxMultiplier - 1) * (supplyApy - borrowApy)`
+ */
+export declare function getMaxRoe(maxMultiplier: number, supplyApy: number, borrowApy: number): number;