@ember-finance/sdk 2.0.1 → 2.0.2

package/dist/src/evm-vaults/on-chain-calls/tx-builder.d.ts

@@ -1,5 +1,5 @@
 import { EVMDeploymentParser } from "../utils/index.js";
-import { IEvmDeployment, VaultPauseOperation, ITransactionCall, IPermitSignature } from "../interfaces/index.js";
+import { EvmProtocolInfo, VaultPauseOperation, ITransactionCall, IPermitSignature, IOFTSendParam, IOFTMessagingFee } from "../interfaces/index.js";
 import { NumStr } from "../../common/types.js";
 /**
  * EVM Transaction Builder for Ember Protocol (ERC-4626 Compatible)
@@ -38,12 +38,12 @@ import { NumStr } from "../../common/types.js";
  */
 export declare class EVMTxBuilder {
     parser: EVMDeploymentParser;
-    constructor(_deployment: IEvmDeployment);
+    constructor(_deployment: EvmProtocolInfo);
     /**
      * Updates the deployment configuration
      * @param newDeployment The new deployment configuration
      */
-    updateDeployment(newDeployment: IEvmDeployment): void;
+    updateDeployment(newDeployment: EvmProtocolInfo): void;
     /**
      * Gets the chain ID from the deployment
      */
@@ -310,4 +310,23 @@ export declare class EVMTxBuilder {
      * Gets the ERC20Token ABI
      */
     static getERC20ABI(): unknown[];
+    /**
+     * Gets the EmberVaultOFTAdapter ABI
+     */
+    static getOFTAdapterABI(): unknown[];
+    /**
+     * Builds the transaction to bridge receipt tokens to another chain via LayerZero OFT.
+     *
+     * The caller must first:
+     * 1. Approve the adapter to spend the receipt token (`approveToken`).
+     * 2. Obtain a fee quote (`EVMVaultReader.getOFTFeeQuote`) and pass the result as `fee`.
+     *    Set `value` on the returned `ITransactionCall` to `fee.nativeFee`.
+     *
+     * @param adapterAddress The OFT adapter contract address
+     * @param sendParam The bridge send parameters (destination, recipient, amounts, options)
+     * @param fee The messaging fee (native + LZ token fee) obtained from a prior quote
+     * @param refundAddress Address to receive any excess native fee refund
+     * @returns Transaction call object
+     */
+    bridgeSend(adapterAddress: string, sendParam: IOFTSendParam, fee: IOFTMessagingFee, refundAddress: string): ITransactionCall;
 }

package/dist/src/evm-vaults/on-chain-calls/tx-builder.js

@@ -3,6 +3,7 @@ import EmberVaultABI from "../../abis/EmberVault.json" with { type: "json" };
 import EmberETHVaultABI from "../../abis/EmberETHVault.json" with { type: "json" };
 import EmberProtocolConfigABI from "../../abis/EmberProtocolConfig.json" with { type: "json" };
 import ERC20TokenABI from "../../abis/ERC20Token.json" with { type: "json" };
+import EmberVaultOFTAdapterABI from "../../abis/EmberVaultMintBurnOFTAdapter.json" with { type: "json" };
 /**
  * EVM Transaction Builder for Ember Protocol (ERC-4626 Compatible)
  *
@@ -654,4 +655,52 @@ export class EVMTxBuilder {
     static getERC20ABI() {
         return ERC20TokenABI.abi;
     }
+    /**
+     * Gets the EmberVaultOFTAdapter ABI
+     */
+    static getOFTAdapterABI() {
+        return EmberVaultOFTAdapterABI.abi;
+    }
+    // ============================================
+    // Bridge / OFT Methods (LayerZero)
+    // ============================================
+    /**
+     * Builds the transaction to bridge receipt tokens to another chain via LayerZero OFT.
+     *
+     * The caller must first:
+     * 1. Approve the adapter to spend the receipt token (`approveToken`).
+     * 2. Obtain a fee quote (`EVMVaultReader.getOFTFeeQuote`) and pass the result as `fee`.
+     *    Set `value` on the returned `ITransactionCall` to `fee.nativeFee`.
+     *
+     * @param adapterAddress The OFT adapter contract address
+     * @param sendParam The bridge send parameters (destination, recipient, amounts, options)
+     * @param fee The messaging fee (native + LZ token fee) obtained from a prior quote
+     * @param refundAddress Address to receive any excess native fee refund
+     * @returns Transaction call object
+     */
+    bridgeSend(adapterAddress, sendParam, fee, refundAddress) {
+        return {
+            to: adapterAddress,
+            functionName: "send",
+            args: [
+                {
+                    dstEid: sendParam.dstEid,
+                    to: sendParam.to,
+                    amountLD: sendParam.amountLD,
+                    minAmountLD: sendParam.minAmountLD,
+                    extraOptions: sendParam.extraOptions ?? "0x",
+                    composeMsg: sendParam.composeMsg ?? "0x",
+                    oftCmd: sendParam.oftCmd ?? "0x"
+                },
+                {
+                    nativeFee: fee.nativeFee,
+                    lzTokenFee: fee.lzTokenFee
+                },
+                refundAddress
+            ],
+            abi: EmberVaultOFTAdapterABI.abi,
+            value: fee.nativeFee,
+            chainId: this.getChainId()
+        };
+    }
 }

package/dist/src/evm-vaults/on-chain-calls/user.d.ts

@@ -1,7 +1,8 @@
 import { Signer, Provider } from "ethers";
 import { EVMOnChainCalls } from "./onchain-calls.js";
-import { IEvmDeployment, IUserCallOptions, IEvmCallOptions, EvmOnChainCallResponse, IPermitSignature, IETHDepositOptions } from "../interfaces/index.js";
+import { EvmProtocolInfo, IUserCallOptions, IEvmCallOptions, EvmOnChainCallResponse, IPermitSignature, IETHDepositOptions, IBridgeSendOptions, IOFTFeeQuote } from "../interfaces/index.js";
 import { NumStr } from "../../common/types.js";
+import { Chain } from "../../api/v2/index.js";
 /**
  * User Calls for Ember Protocol on EVM (ERC-4626 Compatible)
  *
@@ -49,7 +50,7 @@ import { NumStr } from "../../common/types.js";
  * ```
  */
 export declare class EVMUserCalls extends EVMOnChainCalls {
-    constructor(_deployment: IEvmDeployment, _signer?: Signer, _provider?: Provider, _walletAddress?: string);
+    constructor(_deployment: EvmProtocolInfo, _signer?: Signer, _provider?: Provider, _walletAddress?: string);
     /**
      * Deposit assets into a vault (ERC-4626 standard)
      *
@@ -225,6 +226,21 @@ export declare class EVMUserCalls extends EVMOnChainCalls {
      * @returns EvmOnChainCallResponse
      */
     approveTokenMax(tokenAddress: string, spender: string, options?: IEvmCallOptions): Promise<EvmOnChainCallResponse>;
+    /**
+     * Bridges a receipt token to a destination chain using the configured OFT adapter.
+     *
+     * This method validates allowance, builds the LayerZero send parameters,
+     * and executes the adapter send transaction.
+     *
+     * @param destinationChain Destination chain metadata (must include lzChainId)
+     * @param tokenAddress Receipt token address (also used as vault identifier in EVM deployment data)
+     * @param amount Amount to bridge in local token decimals
+     * @param receiver Recipient wallet address on destination chain
+     * @param feeQuote Fee quote returned by reader.getOFTFeeQuote
+     * @param options Optional bridge/send overrides
+     * @returns Transaction execution response
+     */
+    bridgeSendToken(destinationChain: Chain, tokenAddress: string, amount: NumStr, receiver: string, feeQuote: IOFTFeeQuote, options?: IBridgeSendOptions): Promise<EvmOnChainCallResponse>;
     /**
      * Gets the vault contract instance for read operations
      * @param vaultAddress The address of the vault

package/dist/src/evm-vaults/on-chain-calls/user.js

@@ -1,7 +1,8 @@
-import { Contract } from "ethers";
+import { Contract, ethers } from "ethers";
 import { EVMOnChainCalls } from "./onchain-calls.js";
 import EmberVaultABI from "../../abis/EmberVault.json" with { type: "json" };
 import EmberETHVaultABI from "../../abis/EmberETHVault.json" with { type: "json" };
+import { addressToBytes32 } from "../index.js";
 /**
  * User Calls for Ember Protocol on EVM (ERC-4626 Compatible)
  *
@@ -284,6 +285,58 @@ export class EVMUserCalls extends EVMOnChainCalls {
         return this.approveToken(tokenAddress, spender, maxUint256, options);
     }
     // ============================================
+    // Bridge Methods
+    // ============================================
+    /**
+     * Bridges a receipt token to a destination chain using the configured OFT adapter.
+     *
+     * This method validates allowance, builds the LayerZero send parameters,
+     * and executes the adapter send transaction.
+     *
+     * @param destinationChain Destination chain metadata (must include lzChainId)
+     * @param tokenAddress Receipt token address (also used as vault identifier in EVM deployment data)
+     * @param amount Amount to bridge in local token decimals
+     * @param receiver Recipient wallet address on destination chain
+     * @param feeQuote Fee quote returned by reader.getOFTFeeQuote
+     * @param options Optional bridge/send overrides
+     * @returns Transaction execution response
+     */
+    async bridgeSendToken(destinationChain, tokenAddress, amount, receiver, feeQuote, options) {
+        if (!this.provider) {
+            throw new Error("Provider required for bridge send read operations and allowance checks");
+        }
+        const adapter = this.parser.getOFTAdapterObjectByVaultId(tokenAddress);
+        if (!adapter?.address) {
+            throw new Error(`OFT adapter not found for token address: ${tokenAddress}`);
+        }
+        const refundAddress = options?.refundAddress ?? (await this.getWalletAddress());
+        if (destinationChain.lzChainId === undefined ||
+            destinationChain.lzChainId === null) {
+            throw new Error(`Destination chain "${destinationChain.name ?? destinationChain.identifier}" has no lzChainId — cannot construct sendParam.dstEid`);
+        }
+        const dstEid = destinationChain.lzChainId;
+        const amountBigInt = BigInt(amount);
+        const token = new ethers.Contract(tokenAddress, ["function allowance(address,address) view returns (uint256)"], this.provider);
+        const currentAllowance = await token.allowance(await this.getWalletAddress(), adapter.address);
+        if (currentAllowance < amountBigInt) {
+            throw new Error(`Insufficient allowance for bridge transfer. Current allowance: ${currentAllowance}, required: ${amountBigInt}`);
+        }
+        const sendParam = {
+            dstEid,
+            to: addressToBytes32(receiver),
+            amountLD: amountBigInt,
+            minAmountLD: options?.minAmount ?? amountBigInt,
+            extraOptions: options?.extraOptions,
+            composeMsg: options?.composeMsg,
+            oftCmd: options?.oftCmd
+        };
+        const txCall = this.txBuilder.bridgeSend(adapter.address, sendParam, {
+            nativeFee: feeQuote.nativeFee,
+            lzTokenFee: options?.payInLzToken ? feeQuote.lzTokenFee : 0n
+        }, refundAddress);
+        return this.execCall(txCall, options);
+    }
+    // ============================================
     // Read-Only Methods
     // ============================================
     /**

package/dist/src/evm-vaults/on-chain-calls/vault-admin.d.ts

@@ -1,6 +1,6 @@
 import { Signer, Provider } from "ethers";
 import { EVMOnChainCalls } from "./onchain-calls.js";
-import { IEvmDeployment, IEvmCallOptions, EvmOnChainCallResponse, VaultPauseOperation } from "../interfaces/index.js";
+import { EvmProtocolInfo, IEvmCallOptions, EvmOnChainCallResponse, VaultPauseOperation } from "../interfaces/index.js";
 import { NumStr } from "../../common/types.js";
 /**
  * Vault Admin Calls for Ember Protocol on EVM
@@ -35,7 +35,7 @@ import { NumStr } from "../../common/types.js";
  * ```
  */
 export declare class EVMVaultAdminCalls extends EVMOnChainCalls {
-    constructor(_deployment: IEvmDeployment, _signer?: Signer, _provider?: Provider, _walletAddress?: string);
+    constructor(_deployment: EvmProtocolInfo, _signer?: Signer, _provider?: Provider, _walletAddress?: string);
     /**
      * Update the operator of a vault
      * @param vaultAddress The address of the vault

package/dist/src/evm-vaults/on-chain-calls/vault-reader.d.ts

@@ -1,7 +1,8 @@
 import { Provider } from "ethers";
 import { EVMDeploymentParser } from "../utils/deployment-parser.js";
-import { IEvmDeployment } from "../interfaces/index.js";
+import { EvmProtocolInfo, IOFTSendParam, IOFTFeeQuote, IOFTVaultSupportedChain } from "../interfaces/index.js";
 import { NumStr } from "../../common/types.js";
+import { Chain, VaultsApi } from "../../api/v2/index.js";
 /**
  * Vault state returned by getVaultState
  */
@@ -164,12 +165,15 @@ export interface IUserPosition {
 export declare class EVMVaultReader {
     parser: EVMDeploymentParser;
     provider: Provider;
-    constructor(_deployment: IEvmDeployment, _provider: Provider);
+    vaultsApi: VaultsApi;
+    constructor(_deployment: EvmProtocolInfo, _provider: Provider, options?: {
+        apiBaseUrl: string;
+    });
     /**
      * Updates the deployment configuration
      * @param newDeployment The new deployment configuration
      */
-    updateDeployment(newDeployment: IEvmDeployment): void;
+    updateDeployment(newDeployment: EvmProtocolInfo): void;
     /**
      * Creates an ethers Contract instance for a vault
      * @param vaultAddress The vault address
@@ -460,4 +464,34 @@ export declare class EVMVaultReader {
      * @returns Array of complete vault info for all vaults
      */
     getAllVaultsInfo(): Promise<ICompleteVaultInfo[]>;
+    getOFTAdapterAddressByVaultId(vaultId: string): string | null;
+    /**
+     * Creates an ethers Contract instance for an OFT adapter
+     */
+    private getOFTAdapterContract;
+    /**
+     * Resolves and instantiates the OFT adapter contract for a vault identifier.
+     *
+     * @param vaultId Vault identifier (receipt token address on EVM)
+     * @returns OFT adapter contract instance, or null if no adapter is configured
+     */
+    private getOFTAdapterByVaultId;
+    /**
+     * Returns the list of destination chains that an OFT adapter has peers configured for.
+     *
+     * @param vaultId The vault identifier (receipt token address on EVM)
+     * @returns Destination chains enriched with OFT adapter and peer metadata
+     */
+    getOFTSupportedChains(vaultId: string, supportedChains?: Chain[]): Promise<IOFTVaultSupportedChain[]>;
+    /**
+     * Gets a fee quote for bridging tokens to another chain via LayerZero OFT.
+     * Combines both the messaging fee (quoteSend) and the OFT transfer details
+     * (quoteOFT) into a single result.
+     *
+     * @param vaultId The vault identifier used to resolve the OFT adapter
+     * @param sendParam The bridge send parameters
+     * @param payInLzToken Whether to pay the fee in the LZ token (default false = pay in native)
+     * @returns Combined fee quote including native fee and expected amounts
+     */
+    getOFTFeeQuote(vaultId: string, sendParam: IOFTSendParam, payInLzToken?: boolean): Promise<IOFTFeeQuote>;
 }

package/dist/src/evm-vaults/on-chain-calls/vault-reader.js

@@ -1,9 +1,12 @@
-import { Contract } from "ethers";
+import { Contract, isAddress } from "ethers";
 import { EVMDeploymentParser } from "../utils/deployment-parser.js";
 import EmberVaultABI from "../../abis/EmberVault.json" with { type: "json" };
 import EmberETHVaultABI from "../../abis/EmberETHVault.json" with { type: "json" };
 import EmberProtocolConfigABI from "../../abis/EmberProtocolConfig.json" with { type: "json" };
 import ERC20TokenABI from "../../abis/ERC20Token.json" with { type: "json" };
+import EmberVaultOFTAdapterABI from "../../abis/EmberVaultMintBurnOFTAdapter.json" with { type: "json" };
+import { Configuration, VaultsApi } from "../../api/v2/index.js";
+import { environmentConfig } from "../../common/constants.js";
 /**
  * EVM Vault Reader - Read-only operations for Ember Vaults
  *
@@ -28,9 +31,11 @@ import ERC20TokenABI from "../../abis/ERC20Token.json" with { type: "json" };
  * ```
  */
 export class EVMVaultReader {
-    constructor(_deployment, _provider) {
+    constructor(_deployment, _provider, options) {
         this.parser = new EVMDeploymentParser(_deployment);
         this.provider = _provider;
+        const baseUrl = options?.apiBaseUrl || environmentConfig.prod.apiHost;
+        this.vaultsApi = new VaultsApi(new Configuration({ basePath: baseUrl }));
     }
     /**
      * Updates the deployment configuration
@@ -566,4 +571,105 @@ export class EVMVaultReader {
         const addresses = this.getAllVaultAddresses();
         return this.getMultipleVaultsInfo(addresses);
     }
+    // ========== Bridge / OFT Methods ==========
+    getOFTAdapterAddressByVaultId(vaultId) {
+        const adapter = this.parser.getOFTAdapterObjectByVaultId(vaultId);
+        if (!adapter?.address) {
+            return null;
+        }
+        // Adapter address in generated models is optional, so validate before use.
+        if (!isAddress(adapter.address)) {
+            return null;
+        }
+        return adapter.address;
+    }
+    /**
+     * Creates an ethers Contract instance for an OFT adapter
+     */
+    getOFTAdapterContract(adapterAddress) {
+        return new Contract(adapterAddress, EmberVaultOFTAdapterABI.abi, this.provider);
+    }
+    /**
+     * Resolves and instantiates the OFT adapter contract for a vault identifier.
+     *
+     * @param vaultId Vault identifier (receipt token address on EVM)
+     * @returns OFT adapter contract instance, or null if no adapter is configured
+     */
+    getOFTAdapterByVaultId(vaultId) {
+        const adapterAddress = this.getOFTAdapterAddressByVaultId(vaultId);
+        if (!adapterAddress) {
+            return null;
+        }
+        return this.getOFTAdapterContract(adapterAddress);
+    }
+    /**
+     * Returns the list of destination chains that an OFT adapter has peers configured for.
+     *
+     * @param vaultId The vault identifier (receipt token address on EVM)
+     * @returns Destination chains enriched with OFT adapter and peer metadata
+     */
+    async getOFTSupportedChains(vaultId, supportedChains) {
+        const adapter = this.parser.getOFTAdapterObjectByVaultId(vaultId);
+        const adapterAddress = this.getOFTAdapterAddressByVaultId(vaultId);
+        if (!adapter || !adapterAddress) {
+            return [];
+        }
+        supportedChains =
+            supportedChains ?? (await this.vaultsApi.getSupportedChains()).data;
+        const chains = [];
+        Object.keys(adapter.peers ?? {}).forEach(key => {
+            const peer = adapter.peers?.[key];
+            const lzChainId = Number(key);
+            const chain = supportedChains.find(chain => chain.lzChainId === lzChainId);
+            if (!chain) {
+                return;
+            }
+            chains.push({
+                ...chain,
+                adapterAddress,
+                vaultId,
+                lzEndpointId: lzChainId,
+                chainIdentifier: chain.identifier,
+                peerAddress: peer.decodedAddress
+            });
+        });
+        return chains;
+    }
+    /**
+     * Gets a fee quote for bridging tokens to another chain via LayerZero OFT.
+     * Combines both the messaging fee (quoteSend) and the OFT transfer details
+     * (quoteOFT) into a single result.
+     *
+     * @param vaultId The vault identifier used to resolve the OFT adapter
+     * @param sendParam The bridge send parameters
+     * @param payInLzToken Whether to pay the fee in the LZ token (default false = pay in native)
+     * @returns Combined fee quote including native fee and expected amounts
+     */
+    async getOFTFeeQuote(vaultId, sendParam, payInLzToken = false) {
+        const adapter = this.getOFTAdapterByVaultId(vaultId);
+        if (!adapter) {
+            throw new Error(`OFT adapter not found for vault: ${vaultId}`);
+        }
+        const param = {
+            dstEid: sendParam.dstEid,
+            to: sendParam.to,
+            amountLD: sendParam.amountLD,
+            minAmountLD: sendParam.minAmountLD,
+            extraOptions: sendParam.extraOptions ?? "0x",
+            composeMsg: sendParam.composeMsg ?? "0x",
+            oftCmd: sendParam.oftCmd ?? "0x"
+        };
+        const [msgFee, oftQuote] = await Promise.all([
+            adapter.quoteSend(param, payInLzToken),
+            adapter.quoteOFT(param)
+        ]);
+        return {
+            nativeFee: msgFee.nativeFee,
+            lzTokenFee: msgFee.lzTokenFee,
+            amountSentLD: oftQuote.oftReceipt.amountSentLD,
+            amountReceivedLD: oftQuote.oftReceipt.amountReceivedLD,
+            minAmountLD: oftQuote.oftLimit.minAmountLD,
+            maxAmountLD: oftQuote.oftLimit.maxAmountLD
+        };
+    }
 }

package/dist/src/evm-vaults/utils/deployment-parser.d.ts

@@ -1,12 +1,13 @@
-import { IEvmDeployment } from "../interfaces/index.js";
+import { EvmOFTAdapter } from "../../api/v2/index.js";
+import { EvmProtocolInfo } from "../interfaces/index.js";
 export declare class EVMDeploymentParser {
-    deployment: IEvmDeployment;
-    constructor(_deployment: IEvmDeployment);
+    deployment: EvmProtocolInfo;
+    constructor(_deployment: EvmProtocolInfo);
     /**
      * Updates the deployment configuration
      * @param newDeployment The new deployment configuration
      */
-    updateDeployment(newDeployment: IEvmDeployment): void;
+    updateDeployment(newDeployment: EvmProtocolInfo): void;
     /**
      * Gets the network name (e.g., "sepolia", "mainnet")
      */
@@ -18,15 +19,15 @@ export declare class EVMDeploymentParser {
     /**
      * Gets the protocol config proxy address
      */
-    getProtocolConfigAddress(): string;
+    getProtocolConfigAddress(): string | undefined;
     /**
      * Gets the protocol config implementation address
      */
-    getProtocolConfigImplementationAddress(): string;
+    getProtocolConfigImplementationAddress(): string | undefined;
     /**
      * Gets the protocol config owner address
      */
-    getProtocolConfigOwner(): string;
+    getProtocolConfigOwner(): string | undefined;
     /**
      * Gets a receipt token address by its symbol
      * @param symbol The receipt token symbol (e.g., "eUSDC")
@@ -46,7 +47,7 @@ export declare class EVMDeploymentParser {
      * Gets vault info by its proxy address
      * @param vaultAddress The vault's proxy address
      */
-    getVaultByAddress(vaultAddress: string): IEvmDeployment["contracts"]["vaults"][string];
+    getVaultByAddress(vaultAddress: string): EvmProtocolInfo["contracts"]["vaults"][string];
     /**
      * Gets the base token address for a vault
      * @param vaultAddress The vault's proxy address
@@ -94,4 +95,9 @@ export declare class EVMDeploymentParser {
      * Gets all receipt token symbols
      */
     getReceiptTokenSymbols(): string[];
+    /**
+     * Finds the OFT adapter entry for a given vault address.
+     * @param vaultAddress The vault address (receipt token address in EVM deployment data)
+     */
+    getOFTAdapterObjectByVaultId(vaultAddress: string): EvmOFTAdapter | undefined;
 }

package/dist/src/evm-vaults/utils/deployment-parser.js

@@ -25,26 +25,26 @@ export class EVMDeploymentParser {
      * Gets the protocol config proxy address
      */
     getProtocolConfigAddress() {
-        return this.deployment.contracts.protocolConfig.proxyAddress;
+        return this.deployment.contracts?.protocolConfig.proxyAddress;
     }
     /**
      * Gets the protocol config implementation address
      */
     getProtocolConfigImplementationAddress() {
-        return this.deployment.contracts.protocolConfig.implementationAddress;
+        return this.deployment.contracts?.protocolConfig.implementationAddress;
     }
     /**
      * Gets the protocol config owner address
      */
     getProtocolConfigOwner() {
-        return this.deployment.contracts.protocolConfig.ownerAddress;
+        return this.deployment.contracts?.protocolConfig.ownerAddress;
     }
     /**
      * Gets a receipt token address by its symbol
      * @param symbol The receipt token symbol (e.g., "eUSDC")
      */
     getReceiptTokenAddress(symbol) {
-        const receiptToken = this.deployment.contracts.receiptTokens[symbol];
+        const receiptToken = this.deployment.contracts?.receiptTokens[symbol];
         if (!receiptToken) {
             throw new Error(`Receipt token not found for symbol: ${symbol}`);
         }
@@ -55,7 +55,7 @@ export class EVMDeploymentParser {
      * @param symbol The receipt token symbol (e.g., "eUSDC")
      */
     getReceiptTokenDecimals(symbol) {
-        const receiptToken = this.deployment.contracts.receiptTokens[symbol];
+        const receiptToken = this.deployment.contracts?.receiptTokens[symbol];
         if (!receiptToken) {
             throw new Error(`Receipt token not found for symbol: ${symbol}`);
         }
@@ -66,7 +66,7 @@ export class EVMDeploymentParser {
      * @param vaultKey The vault key (e.g., "emberUsdcVault")
      */
     getVaultAddress(vaultKey) {
-        const vault = this.deployment.contracts.vaults[vaultKey];
+        const vault = this.deployment.contracts?.vaults[vaultKey];
         if (!vault) {
             throw new Error(`Vault not found for key: ${vaultKey}`);
         }
@@ -77,7 +77,7 @@ export class EVMDeploymentParser {
      * @param vaultAddress The vault's proxy address
      */
     getVaultByAddress(vaultAddress) {
-        const vault = Object.values(this.deployment.contracts.vaults).find(v => v.proxyAddress.toLowerCase() === vaultAddress.toLowerCase());
+        const vault = Object.values(this.deployment.contracts?.vaults ?? {}).find(v => v.proxyAddress.toLowerCase() === vaultAddress.toLowerCase());
         if (!vault) {
             throw new Error(`Vault not found for address: ${vaultAddress}`);
         }
@@ -143,18 +143,29 @@ export class EVMDeploymentParser {
      * Gets all vault keys
      */
     getVaultKeys() {
-        return Object.keys(this.deployment.contracts.vaults);
+        return Object.keys(this.deployment.contracts?.vaults ?? {});
     }
     /**
      * Gets all vault addresses
      */
     getVaultAddresses() {
-        return Object.values(this.deployment.contracts.vaults).map(v => v.proxyAddress);
+        return Object.values(this.deployment.contracts?.vaults ?? {}).map(v => v.proxyAddress);
     }
     /**
      * Gets all receipt token symbols
      */
     getReceiptTokenSymbols() {
-        return Object.keys(this.deployment.contracts.receiptTokens);
+        return Object.keys(this.deployment.contracts?.receiptTokens ?? {});
+    }
+    /**
+     * Finds the OFT adapter entry for a given vault address.
+     * @param vaultAddress The vault address (receipt token address in EVM deployment data)
+     */
+    getOFTAdapterObjectByVaultId(vaultAddress) {
+        const entry = Object.values(this.deployment.contracts?.oftAdapters ?? {}).find(adapter => adapter.vaultAddress?.toLowerCase() === vaultAddress.toLowerCase());
+        if (!entry) {
+            return undefined;
+        }
+        return entry;
     }
 }

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@ember-finance/sdk",
     "description": "Ember Protocol SDK",
-    "version": "2.0.1",
+    "version": "2.0.2",
     "type": "module",
     "module": "./dist/index.js",
     "main": "./dist/index.js",