@eulerxyz/euler-v2-sdk 0.1.0-beta

package/dist/src/services/vaults/vaultMetaService/adapters/VaultTypeV3Adapter.js

@@ -0,0 +1,154 @@
+import { getAddress } from "viem";
+import { applyBuildQuery, } from "../../../../utils/buildQuery.js";
+import { createCallBundler } from "../../../../utils/callBundler.js";
+import { VaultType } from "../../../../utils/types.js";
+const defaultTypeMap = {
+    earn: VaultType.EulerEarn,
+    eulerEarn: VaultType.EulerEarn,
+    evault: VaultType.EVault,
+    evk: VaultType.EVault,
+    vault: VaultType.EVault,
+    securitize: VaultType.SecuritizeCollateral,
+    securitizeCollateral: VaultType.SecuritizeCollateral,
+};
+const V3_VAULT_RESOLVE_BATCH_SIZE = 100;
+const V3_VAULT_RESOLVE_CONCURRENCY = 4;
+function normalizeTypeKey(value) {
+    return value.replace(/[^a-z0-9]/gi, "").toLowerCase();
+}
+export class VaultTypeV3Adapter {
+    config;
+    constructor(config, buildQuery) {
+        this.config = config;
+        if (buildQuery)
+            applyBuildQuery(this, buildQuery);
+    }
+    setConfig(config) {
+        this.config = config;
+    }
+    getHeaders() {
+        return {
+            Accept: "application/json",
+            "Content-Type": "application/json",
+            ...(this.config.apiKey ? { "X-API-Key": this.config.apiKey } : {}),
+        };
+    }
+    resolveSdkVaultType(row) {
+        const configuredTypeMap = Object.fromEntries(Object.entries(this.config.typeMap ?? {}).map(([key, value]) => [
+            normalizeTypeKey(key),
+            value,
+        ]));
+        const mergedTypeMap = {
+            ...defaultTypeMap,
+            ...configuredTypeMap,
+        };
+        if (row.vaultType) {
+            const mapped = mergedTypeMap[normalizeTypeKey(row.vaultType)];
+            if (mapped)
+                return mapped;
+        }
+        const resource = row.resource?.toLowerCase() ?? "";
+        if (resource.startsWith("/v3/earn/vaults/"))
+            return VaultType.EulerEarn;
+        if (resource.startsWith("/v3/evk/vaults/"))
+            return VaultType.EVault;
+        return undefined;
+    }
+    resolveFactoryAddress(row) {
+        const value = row.factoryAddress ?? row.factory;
+        if (!value)
+            return undefined;
+        try {
+            return getAddress(value);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    async queryResolveChunk(url, requestBody) {
+        const response = await fetch(url, {
+            method: "POST",
+            headers: this.getHeaders(),
+            body: JSON.stringify(requestBody),
+        });
+        if (!response.ok) {
+            throw new Error(`vaultTypeV3 resolve ${response.status} ${response.statusText}`);
+        }
+        const json = (await response.json());
+        return json.data ?? [];
+    }
+    queryV3VaultResolve = createCallBundler(async (keys) => {
+        const byChain = new Map();
+        for (const key of keys) {
+            const addresses = byChain.get(key.chainId) ?? [];
+            addresses.push(key.address);
+            byChain.set(key.chainId, addresses);
+        }
+        const chainResults = new Map();
+        for (const [chainId, addresses] of byChain) {
+            const uniqueAddresses = [
+                ...new Set(addresses.map((address) => getAddress(address))),
+            ];
+            const url = `${this.config.endpoint.replace(/\/+$/, "")}/v3/resolve/vaults`;
+            const resolved = new Map();
+            const chunks = [];
+            for (let offset = 0; offset < uniqueAddresses.length; offset += V3_VAULT_RESOLVE_BATCH_SIZE) {
+                chunks.push(uniqueAddresses.slice(offset, offset + V3_VAULT_RESOLVE_BATCH_SIZE));
+            }
+            for (let chunkOffset = 0; chunkOffset < chunks.length; chunkOffset += V3_VAULT_RESOLVE_CONCURRENCY) {
+                const chunkGroup = chunks.slice(chunkOffset, chunkOffset + V3_VAULT_RESOLVE_CONCURRENCY);
+                const results = await Promise.all(chunkGroup.map((chunk) => this.queryResolveChunk(url, {
+                    chainId,
+                    addresses: chunk,
+                })));
+                for (const row of results.flat()) {
+                    if (!row.found)
+                        continue;
+                    const address = getAddress(row.address);
+                    const sdkVaultType = this.resolveSdkVaultType(row);
+                    const factory = this.resolveFactoryAddress(row);
+                    if (!sdkVaultType && !factory)
+                        continue;
+                    resolved.set(address.toLowerCase(), {
+                        id: address,
+                        type: sdkVaultType ?? VaultType.Unknown,
+                        ...(factory ? { factory } : {}),
+                    });
+                }
+            }
+            chainResults.set(chainId, resolved);
+        }
+        return keys.map((key) => {
+            return chainResults
+                .get(key.chainId)
+                ?.get(getAddress(key.address).toLowerCase());
+        });
+    });
+    setQueryV3VaultResolve(fn) {
+        this.queryV3VaultResolve = fn;
+    }
+    async fetchVaultType(chainId, vaultAddress) {
+        const result = await this.queryV3VaultResolve({ address: vaultAddress, chainId });
+        if (!result || result.type === VaultType.Unknown)
+            return undefined;
+        return result.type;
+    }
+    async fetchVaultTypes(chainId, vaultAddresses) {
+        if (vaultAddresses.length === 0)
+            return [];
+        const results = await Promise.all(vaultAddresses.map((address) => this.queryV3VaultResolve({ address, chainId })));
+        return results.filter((result) => result != null && result.type !== VaultType.Unknown);
+    }
+    async fetchVaultFactories(chainId, vaultAddresses) {
+        if (vaultAddresses.length === 0)
+            return [];
+        const results = await Promise.all(vaultAddresses.map((address) => this.queryV3VaultResolve({ address, chainId })));
+        return results
+            .filter((result) => result != null && result.factory != null)
+            .map((result) => ({
+            id: result.id,
+            factory: result.factory,
+        }));
+    }
+}
+//# sourceMappingURL=VaultTypeV3Adapter.js.map

package/dist/src/services/vaults/vaultMetaService/adapters/VaultTypeV3Adapter.js.map

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

package/dist/src/services/vaults/vaultMetaService/index.d.ts

@@ -0,0 +1,4 @@
+export { VaultMetaService, isEVault, isEulerEarn, isSecuritizeCollateralVault, type IVaultMetaService, type VaultMetaServiceConfig, type RegisteredVaultService, type VaultEntity, type VaultMetaPerspective, type VaultServiceEntry, type VaultTypeString, } from "./vaultMetaService.js";
+export type { IVaultTypeAdapter, VaultFactoryResult, VaultResolvedTypeResult, } from "./adapters/IVaultTypeAdapter.js";
+export { VaultTypeSubgraphAdapter, type VaultTypeSubgraphAdapterConfig, } from "./adapters/VaultTypeSubgraphAdapter.js";
+export { VaultTypeV3Adapter, type VaultTypeV3AdapterConfig, } from "./adapters/VaultTypeV3Adapter.js";

package/dist/src/services/vaults/vaultMetaService/index.js

@@ -0,0 +1,4 @@
+export { VaultMetaService, isEVault, isEulerEarn, isSecuritizeCollateralVault, } from "./vaultMetaService.js";
+export { VaultTypeSubgraphAdapter, } from "./adapters/VaultTypeSubgraphAdapter.js";
+export { VaultTypeV3Adapter, } from "./adapters/VaultTypeV3Adapter.js";
+//# sourceMappingURL=index.js.map

package/dist/src/services/vaults/vaultMetaService/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/services/vaults/vaultMetaService/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,gBAAgB,EAChB,QAAQ,EACR,WAAW,EACX,2BAA2B,GAQ3B,MAAM,uBAAuB,CAAC;AAM/B,OAAO,EACN,wBAAwB,GAExB,MAAM,wCAAwC,CAAC;AAChD,OAAO,EACN,kBAAkB,GAElB,MAAM,kCAAkC,CAAC"}

package/dist/src/services/vaults/vaultMetaService/vaultMetaService.d.ts

@@ -0,0 +1,71 @@
+import { type Address } from "viem";
+import type { EVault } from "../../../entities/EVault.js";
+import type { EulerEarn } from "../../../entities/EulerEarn.js";
+import type { SecuritizeCollateralVault } from "../../../entities/SecuritizeCollateralVault.js";
+import type { FetchAllVaultsArgs, IVaultService, VaultFetchOptions } from "../index.js";
+import type { IVaultTypeAdapter } from "./adapters/IVaultTypeAdapter.js";
+import type { StandardEVaultPerspectives } from "../eVaultService/index.js";
+import type { StandardEulerEarnPerspectives } from "../eulerEarnService/index.js";
+import type { ServiceResult } from "../../../utils/entityDiagnostics.js";
+export type VaultMetaPerspective = StandardEulerEarnPerspectives | StandardEVaultPerspectives | Address;
+/** Default union of vault entity types (EVault, Euler Earn, SecuritizeCollateral). Extend this when registering additional vault services. */
+export type VaultEntity = EVault | EulerEarn | SecuritizeCollateralVault;
+/** Type guard: narrows VaultEntity to EVault. */
+export declare function isEVault(v: VaultEntity): v is EVault;
+/** Type guard: narrows VaultEntity to EulerEarn. */
+export declare function isEulerEarn(v: VaultEntity): v is EulerEarn;
+/** Type guard: narrows VaultEntity to SecuritizeCollateralVault. */
+export declare function isSecuritizeCollateralVault(v: VaultEntity): v is SecuritizeCollateralVault;
+/** A vault service that can be registered with VaultMetaService. Use TEntity to extend the meta service return type (e.g. EVault | EulerEarn | CustomVault). */
+export type RegisteredVaultService<TEntity = VaultEntity> = IVaultService<TEntity, string>;
+/** Extendable vault type: built-in (e.g. VaultType.EVault, VaultType.EulerEarn) or custom string when adding vault services with a type. */
+export type VaultTypeString = string;
+/** A vault service optionally tagged with a type for getFactoryByType(chainId, type). Use { type, service } when adding custom vault types. */
+export type VaultServiceEntry<TEntity = VaultEntity> = RegisteredVaultService<TEntity> | {
+    type: VaultTypeString;
+    service: RegisteredVaultService<TEntity>;
+};
+/** Meta vault service; TEntity is the union of all registered vault entity types (default EVault | EulerEarn). Extend with a wider union when registering more services. */
+export interface IVaultMetaService<TEntity = VaultEntity> extends Omit<IVaultService<TEntity, VaultMetaPerspective>, "factory"> {
+    /** Register a vault service; use { type, service } to make the type available to getFactoryByType(chainId, type). */
+    registerVaultService(entry: VaultServiceEntry<TEntity>): void;
+    /** Returns vault type for the given vault address, or undefined if unknown. */
+    fetchVaultType(chainId: number, vault: Address): Promise<VaultTypeString | undefined>;
+    /** Returns vault types for the given vault addresses (keyed by normalized vault address). */
+    fetchVaultTypes(chainId: number, vaults: Address[]): Promise<Partial<Record<Address, VaultTypeString>>>;
+    /** Returns the factory address for the given chain and vault type, or undefined if the type is not registered. */
+    getFactoryByType(chainId: number, type: VaultTypeString): Address | undefined;
+}
+export interface VaultMetaServiceConfig<TEntity = VaultEntity> {
+    vaultTypeAdapter: IVaultTypeAdapter;
+    /** Initial vault services. Use { type, service } to register a vault type for getFactoryByType(chainId, type). */
+    vaultServices?: VaultServiceEntry<TEntity>[];
+}
+export declare class VaultMetaService<TEntity = VaultEntity> implements IVaultMetaService<TEntity> {
+    private config;
+    private readonly vaultServicesList;
+    private readonly typeToService;
+    private readonly serviceToType;
+    constructor(config: VaultMetaServiceConfig<TEntity>);
+    setVaultTypeAdapter(adapter: IVaultTypeAdapter): void;
+    /** Register a vault service; use { type, service } to make the type available to getFactoryByType(chainId, type). */
+    registerVaultService(entry: VaultServiceEntry<TEntity>): void;
+    private get vaultServices();
+    private getFactoryToServiceMap;
+    private getServiceByResolvedType;
+    private getServiceLabel;
+    private fetchVaultToService;
+    getFactoryByType(chainId: number, type: string): Address | undefined;
+    fetchVault(chainId: number, vault: Address, options?: VaultFetchOptions): Promise<ServiceResult<TEntity | undefined>>;
+    fetchVaultType(chainId: number, vault: Address): Promise<VaultTypeString | undefined>;
+    fetchVaultTypes(chainId: number, vaults: Address[]): Promise<Partial<Record<Address, VaultTypeString>>>;
+    fetchVaults(chainId: number, vaults: Address[], options?: VaultFetchOptions): Promise<ServiceResult<(TEntity | undefined)[]>>;
+    fetchVerifiedVaultAddresses(chainId: number, perspectives: VaultMetaPerspective[]): Promise<Address[]>;
+    fetchVerifiedVaults(chainId: number, perspectives: VaultMetaPerspective[], options?: VaultFetchOptions): Promise<ServiceResult<(TEntity | undefined)[]>>;
+    /**
+     * Fetches all discoverable vaults across registered vault services.
+     * The optional async `filter` runs after the first fetch in each service and before populate/enrichment work,
+     * so rejected vaults are skipped before additional resources are spent on them.
+     */
+    fetchAllVaults(chainId: number, args?: FetchAllVaultsArgs<TEntity, VaultFetchOptions>): Promise<ServiceResult<(TEntity | undefined)[]>>;
+}

package/dist/src/services/vaults/vaultMetaService/vaultMetaService.js

@@ -0,0 +1,283 @@
+import { getAddress } from "viem";
+import { VaultType } from "../../../utils/types.js";
+import { compressDataIssues, mapDataIssuePaths, normalizeTopLevelVaultArrayPath, } from "../../../utils/entityDiagnostics.js";
+function remapServiceLocalVaultPath(path, entries) {
+    const match = path.match(/^\$(?:\.(?:vaults|eVaults|eulerEarns))?\[(\d+)\](?=\.|$)/);
+    if (!match)
+        return path;
+    const localIndex = Number(match[1]);
+    const entry = entries[localIndex];
+    if (!entry)
+        return path;
+    return path.replace(/^\$(?:\.(?:vaults|eVaults|eulerEarns))?\[\d+\]/, `$.vaults[${entry.index}]`);
+}
+function remapServiceLocalVaultPaths(paths, entries) {
+    return paths.map((path) => remapServiceLocalVaultPath(path, entries));
+}
+/** Type guard: narrows VaultEntity to EVault. */
+export function isEVault(v) {
+    return v.type === VaultType.EVault;
+}
+/** Type guard: narrows VaultEntity to EulerEarn. */
+export function isEulerEarn(v) {
+    return v.type === VaultType.EulerEarn;
+}
+/** Type guard: narrows VaultEntity to SecuritizeCollateralVault. */
+export function isSecuritizeCollateralVault(v) {
+    return v.type === VaultType.SecuritizeCollateral;
+}
+export class VaultMetaService {
+    config;
+    vaultServicesList = [];
+    typeToService = new Map();
+    serviceToType = new Map();
+    constructor(config) {
+        this.config = config;
+        if (config.vaultServices?.length) {
+            for (const entry of config.vaultServices) {
+                if ("type" in entry && "service" in entry) {
+                    this.typeToService.set(entry.type, entry.service);
+                    this.serviceToType.set(entry.service, entry.type);
+                    this.vaultServicesList.push(entry.service);
+                }
+                else {
+                    this.vaultServicesList.push(entry);
+                }
+            }
+        }
+    }
+    setVaultTypeAdapter(adapter) {
+        this.config = { ...this.config, vaultTypeAdapter: adapter };
+    }
+    /** Register a vault service; use { type, service } to make the type available to getFactoryByType(chainId, type). */
+    registerVaultService(entry) {
+        if ("type" in entry && "service" in entry) {
+            this.typeToService.set(entry.type, entry.service);
+            this.serviceToType.set(entry.service, entry.type);
+            this.vaultServicesList.push(entry.service);
+        }
+        else {
+            this.vaultServicesList.push(entry);
+        }
+    }
+    get vaultServices() {
+        return this.vaultServicesList;
+    }
+    getFactoryToServiceMap(chainId) {
+        const map = new Map();
+        for (const service of this.vaultServices) {
+            const factory = getAddress(service.factory(chainId));
+            map.set(factory, service);
+        }
+        return map;
+    }
+    getServiceByResolvedType(chainId, resolvedType) {
+        const typedService = this.typeToService.get(resolvedType);
+        if (typedService)
+            return typedService;
+        try {
+            return this.getFactoryToServiceMap(chainId).get(getAddress(resolvedType));
+        }
+        catch {
+            return undefined;
+        }
+    }
+    getServiceLabel(service) {
+        const registeredType = this.serviceToType.get(service);
+        if (registeredType)
+            return registeredType;
+        const constructorName = service
+            .constructor?.name;
+        if (constructorName && constructorName !== "Object")
+            return constructorName;
+        return "unknownVaultService";
+    }
+    async fetchVaultToService(chainId, vaultAddresses) {
+        if (vaultAddresses.length === 0)
+            return new Map();
+        const map = new Map();
+        const typeResults = await this.config.vaultTypeAdapter.fetchVaultTypes(chainId, vaultAddresses);
+        for (const { id, type } of typeResults) {
+            const service = this.getServiceByResolvedType(chainId, type);
+            if (!service)
+                continue;
+            map.set(getAddress(id), service);
+        }
+        return map;
+    }
+    getFactoryByType(chainId, type) {
+        const service = this.typeToService.get(type);
+        return service?.factory(chainId);
+    }
+    async fetchVault(chainId, vault, options) {
+        const fetched = await this.fetchVaults(chainId, [vault], options);
+        const result = fetched.result[0];
+        const errors = fetched.errors.map((issue) => mapDataIssuePaths(issue, normalizeTopLevelVaultArrayPath));
+        if (result === undefined) {
+            errors.push({
+                code: "SOURCE_UNAVAILABLE",
+                severity: "error",
+                message: `Vault not found for ${getAddress(vault)}.`,
+                paths: ["$"],
+                entityId: getAddress(vault),
+                source: "vaultMetaService",
+                originalValue: getAddress(vault),
+            });
+        }
+        return {
+            result,
+            errors: compressDataIssues(errors),
+        };
+    }
+    async fetchVaultType(chainId, vault) {
+        const vaultToService = await this.fetchVaultToService(chainId, [vault]);
+        const service = vaultToService.get(getAddress(vault));
+        if (!service)
+            return undefined;
+        return this.serviceToType.get(service);
+    }
+    async fetchVaultTypes(chainId, vaults) {
+        if (vaults.length === 0)
+            return {};
+        const vaultToService = await this.fetchVaultToService(chainId, vaults);
+        const out = {};
+        for (const vault of vaults) {
+            const key = getAddress(vault);
+            const service = vaultToService.get(key);
+            if (!service)
+                continue;
+            const type = this.serviceToType.get(service);
+            if (!type)
+                continue;
+            out[key] = type;
+        }
+        return out;
+    }
+    async fetchVaults(chainId, vaults, options) {
+        if (vaults.length === 0)
+            return { result: [], errors: [] };
+        const errors = [];
+        const vaultToService = await this.fetchVaultToService(chainId, vaults);
+        const result = Array.from({ length: vaults.length }, () => undefined);
+        const serviceToAddresses = new Map();
+        for (const [index, v] of vaults.entries()) {
+            const service = vaultToService.get(getAddress(v));
+            if (service) {
+                const list = serviceToAddresses.get(service) ?? [];
+                list.push({ address: v, index });
+                serviceToAddresses.set(service, list);
+            }
+            else {
+                errors.push({
+                    code: "SOURCE_UNAVAILABLE",
+                    severity: "warning",
+                    message: `No registered vault service for ${getAddress(v)}.`,
+                    paths: [`$.vaults[${index}]`],
+                    entityId: getAddress(v),
+                    source: "vaultTypeAdapter",
+                    originalValue: getAddress(v),
+                });
+            }
+        }
+        await Promise.all(Array.from(serviceToAddresses.entries()).map(async ([service, entries]) => {
+            try {
+                const addresses = entries.map((entry) => entry.address);
+                const entities = await service.fetchVaults(chainId, addresses, options);
+                errors.push(...entities.errors.map((issue) => ({
+                    ...issue,
+                    paths: remapServiceLocalVaultPaths(issue.paths, entries),
+                })));
+                for (const [entryIndex, entry] of entries.entries()) {
+                    const entity = entities.result[entryIndex];
+                    if (entity === undefined) {
+                        errors.push({
+                            code: "SOURCE_UNAVAILABLE",
+                            severity: "warning",
+                            message: `Failed to fetch vault ${getAddress(entry.address)}.`,
+                            paths: [`$.vaults[${entry.index}]`],
+                            entityId: getAddress(entry.address),
+                            source: "vaultService",
+                            originalValue: getAddress(entry.address),
+                        });
+                        continue;
+                    }
+                    result[entry.index] = entity;
+                }
+            }
+            catch (error) {
+                for (const entry of entries) {
+                    errors.push({
+                        code: "SOURCE_UNAVAILABLE",
+                        severity: "warning",
+                        message: `Failed to fetch vault ${getAddress(entry.address)}.`,
+                        paths: [`$.vaults[${entry.index}]`],
+                        entityId: getAddress(entry.address),
+                        source: "vaultService",
+                        originalValue: error instanceof Error ? error.message : String(error),
+                    });
+                }
+            }
+        }));
+        return { result, errors: compressDataIssues(errors) };
+    }
+    async fetchVerifiedVaultAddresses(chainId, perspectives) {
+        if (perspectives.length === 0)
+            return [];
+        const allAddrs = await Promise.all(this.vaultServices.map((service) => service.fetchVerifiedVaultAddresses(chainId, perspectives)));
+        const seen = new Set();
+        const merged = [];
+        for (const addrs of allAddrs) {
+            for (const a of addrs) {
+                const key = getAddress(a);
+                if (seen.has(key))
+                    continue;
+                seen.add(key);
+                merged.push(a);
+            }
+        }
+        return merged;
+    }
+    async fetchVerifiedVaults(chainId, perspectives, options) {
+        const addresses = await this.fetchVerifiedVaultAddresses(chainId, perspectives);
+        const fetched = await this.fetchVaults(chainId, addresses, options);
+        return {
+            ...fetched,
+            errors: compressDataIssues(fetched.errors.map((issue) => mapDataIssuePaths(issue, normalizeTopLevelVaultArrayPath))),
+        };
+    }
+    /**
+     * Fetches all discoverable vaults across registered vault services.
+     * The optional async `filter` runs after the first fetch in each service and before populate/enrichment work,
+     * so rejected vaults are skipped before additional resources are spent on them.
+     */
+    async fetchAllVaults(chainId, args) {
+        const allFetched = await Promise.allSettled(this.vaultServices.map((service) => service.fetchAllVaults(chainId, args)));
+        const errors = [];
+        const results = [];
+        for (const [index, entry] of allFetched.entries()) {
+            if (entry.status === "fulfilled") {
+                results.push(entry.value);
+                continue;
+            }
+            const service = this.vaultServices[index];
+            errors.push({
+                code: "SOURCE_UNAVAILABLE",
+                severity: "warning",
+                message: `Failed to fetch all vaults for ${service ? this.getServiceLabel(service) : "unknownVaultService"}.`,
+                paths: ["$"],
+                source: "vaultMetaService",
+                originalValue: entry.reason instanceof Error
+                    ? entry.reason.message
+                    : String(entry.reason),
+            });
+        }
+        return {
+            result: results.flatMap((entry) => entry.result),
+            errors: compressDataIssues([
+                ...errors,
+                ...results.flatMap((entry) => entry.errors),
+            ]),
+        };
+    }
+}
+//# sourceMappingURL=vaultMetaService.js.map

package/dist/src/services/vaults/vaultMetaService/vaultMetaService.js.map

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

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

@@ -0,0 +1,20 @@
+import type { IWalletAdapter, AssetWithSpenders } from "../walletService.js";
+import type { ProviderService } from "../../providerService/index.js";
+import type { DeploymentService } from "../../deploymentService/index.js";
+import { type Address } from "viem";
+import type { IWallet } from "../../../entities/Wallet.js";
+import { type BuildQueryFn } from "../../../utils/buildQuery.js";
+import type { ServiceResult } from "../../../utils/entityDiagnostics.js";
+export declare class WalletOnchainAdapter implements IWalletAdapter {
+    private providerService;
+    private deploymentService;
+    constructor(providerService: ProviderService, deploymentService: DeploymentService, buildQuery?: BuildQueryFn);
+    setProviderService(providerService: ProviderService): void;
+    queryBalanceOf: (provider: ReturnType<ProviderService["getProvider"]>, asset: Address, account: Address) => Promise<bigint>;
+    setQueryBalanceOf(fn: typeof this.queryBalanceOf): void;
+    queryAllowance: (provider: ReturnType<ProviderService["getProvider"]>, asset: Address, owner: Address, spender: Address) => Promise<bigint>;
+    setQueryAllowance(fn: typeof this.queryAllowance): void;
+    queryPermit2Allowance: (provider: ReturnType<ProviderService["getProvider"]>, permit2Address: Address, owner: Address, asset: Address, spender: Address) => Promise<readonly [bigint, number, number]>;
+    setQueryPermit2Allowance(fn: typeof this.queryPermit2Allowance): void;
+    fetchWallet(chainId: number, account: Address, assetsWithSpenders: AssetWithSpenders[]): Promise<ServiceResult<IWallet | undefined>>;
+}