@eth-optimism/actions-sdk 0.4.0 → 0.6.0

package/dist/services/nameservices/ens/__tests__/EnsNamespace.spec.js

@@ -0,0 +1,144 @@
+import { describe, expect, it, vi } from 'vitest';
+import { EnsNamespace } from '../EnsNamespace.js';
+import { EnsResolutionError, EnsRpcError, } from '../errors.js';
+const REAL_ADDRESS = '0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045';
+const ENS_NAME = 'vitalik.eth';
+function mockChainManager(client) {
+    const tryGetPublicClient = client
+        ? vi.fn().mockReturnValue(client)
+        : vi.fn().mockReturnValue(undefined);
+    return { tryGetPublicClient };
+}
+function mockClient(overrides = {}) {
+    return {
+        getEnsAddress: vi.fn().mockResolvedValue(REAL_ADDRESS),
+        getEnsName: vi.fn().mockResolvedValue(ENS_NAME),
+        getEnsText: vi.fn().mockResolvedValue(null),
+        ...overrides,
+    };
+}
+describe('EnsNamespace', () => {
+    describe('getAddress', () => {
+        it('resolves a hex address directly', async () => {
+            const ens = new EnsNamespace(mockChainManager());
+            expect(await ens.getAddress(REAL_ADDRESS)).toBe(REAL_ADDRESS);
+        });
+        it('resolves an ENS name via mainnet client', async () => {
+            const client = mockClient();
+            const ens = new EnsNamespace(mockChainManager(client));
+            expect(await ens.getAddress(ENS_NAME)).toBe(REAL_ADDRESS);
+            expect(client.getEnsAddress).toHaveBeenCalledWith({ name: ENS_NAME });
+        });
+        it('caches resolved addresses on subsequent calls', async () => {
+            const client = mockClient();
+            const ens = new EnsNamespace(mockChainManager(client));
+            await ens.getAddress(ENS_NAME);
+            await ens.getAddress(ENS_NAME);
+            expect(client.getEnsAddress).toHaveBeenCalledTimes(1);
+        });
+    });
+    describe('getName', () => {
+        it('returns ENS name for a known address', async () => {
+            const client = mockClient();
+            const ens = new EnsNamespace(mockChainManager(client));
+            expect(await ens.getName(REAL_ADDRESS)).toBe(ENS_NAME);
+            expect(client.getEnsName).toHaveBeenCalledWith({ address: REAL_ADDRESS });
+        });
+        it('returns null when no primary name is set', async () => {
+            const client = mockClient({ getEnsName: vi.fn().mockResolvedValue(null) });
+            const ens = new EnsNamespace(mockChainManager(client));
+            expect(await ens.getName(REAL_ADDRESS)).toBeNull();
+        });
+        it('throws EnsRpcError on RPC failure', async () => {
+            const client = mockClient({
+                getEnsName: vi.fn().mockRejectedValue(new Error('rpc down')),
+            });
+            const ens = new EnsNamespace(mockChainManager(client));
+            await expect(ens.getName(REAL_ADDRESS)).rejects.toThrow(EnsRpcError);
+        });
+        it('caches results on subsequent calls', async () => {
+            const client = mockClient();
+            const ens = new EnsNamespace(mockChainManager(client));
+            await ens.getName(REAL_ADDRESS);
+            await ens.getName(REAL_ADDRESS);
+            expect(client.getEnsName).toHaveBeenCalledTimes(1);
+        });
+        it('caches null results', async () => {
+            const client = mockClient({ getEnsName: vi.fn().mockResolvedValue(null) });
+            const ens = new EnsNamespace(mockChainManager(client));
+            await ens.getName(REAL_ADDRESS);
+            await ens.getName(REAL_ADDRESS);
+            expect(client.getEnsName).toHaveBeenCalledTimes(1);
+        });
+    });
+    describe('getInfo', () => {
+        it('returns all-null EnsInfo when address has no primary name', async () => {
+            const client = mockClient({ getEnsName: vi.fn().mockResolvedValue(null) });
+            const ens = new EnsNamespace(mockChainManager(client));
+            const info = await ens.getInfo(REAL_ADDRESS);
+            expect(info).toEqual({
+                avatar: null,
+                display: null,
+                description: null,
+                url: null,
+                email: null,
+                keywords: null,
+                twitter: null,
+                github: null,
+                discord: null,
+                reddit: null,
+            });
+        });
+        it('returns all text record fields when name is given', async () => {
+            const client = mockClient({
+                getEnsText: vi.fn().mockResolvedValue('test-value'),
+            });
+            const ens = new EnsNamespace(mockChainManager(client));
+            const info = await ens.getInfo(ENS_NAME);
+            expect(info.avatar).toBe('test-value');
+            expect(info.twitter).toBe('test-value');
+            expect(info.github).toBe('test-value');
+        });
+        it('returns null fields when text records are not set', async () => {
+            const client = mockClient({ getEnsText: vi.fn().mockResolvedValue(null) });
+            const ens = new EnsNamespace(mockChainManager(client));
+            const info = await ens.getInfo(ENS_NAME);
+            expect(info.avatar).toBeNull();
+            expect(info.twitter).toBeNull();
+        });
+        it('fetches all 10 standard keys in parallel', async () => {
+            const client = mockClient({ getEnsText: vi.fn().mockResolvedValue(null) });
+            const ens = new EnsNamespace(mockChainManager(client));
+            await ens.getInfo(ENS_NAME);
+            expect(client.getEnsText).toHaveBeenCalledTimes(10);
+        });
+        it('throws EnsRpcError on text lookup RPC failure', async () => {
+            const client = mockClient({
+                getEnsText: vi.fn().mockRejectedValue(new Error('rpc down')),
+            });
+            const ens = new EnsNamespace(mockChainManager(client));
+            await expect(ens.getInfo(ENS_NAME)).rejects.toThrow(EnsRpcError);
+        });
+        it('throws EnsResolutionError when the resolved name fails normalization', async () => {
+            const client = mockClient({
+                getEnsName: vi.fn().mockResolvedValue('not!valid.eth'),
+            });
+            const ens = new EnsNamespace(mockChainManager(client));
+            await expect(ens.getInfo(REAL_ADDRESS)).rejects.toThrow(EnsResolutionError);
+        });
+        it('skips reverse resolution when input is already an EnsName', async () => {
+            const client = mockClient({ getEnsText: vi.fn().mockResolvedValue(null) });
+            const ens = new EnsNamespace(mockChainManager(client));
+            await ens.getInfo(ENS_NAME);
+            expect(client.getEnsName).not.toHaveBeenCalled();
+        });
+        it('caches results on subsequent calls', async () => {
+            const client = mockClient({ getEnsText: vi.fn().mockResolvedValue(null) });
+            const ens = new EnsNamespace(mockChainManager(client));
+            await ens.getInfo(ENS_NAME);
+            await ens.getInfo(ENS_NAME);
+            expect(client.getEnsText).toHaveBeenCalledTimes(10);
+        });
+    });
+});
+//# sourceMappingURL=EnsNamespace.spec.js.map

package/dist/services/nameservices/ens/__tests__/EnsNamespace.spec.js.map

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

package/dist/services/nameservices/ens/__tests__/utils.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=utils.spec.d.ts.map

package/dist/services/nameservices/ens/__tests__/utils.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.spec.d.ts","sourceRoot":"","sources":["../../../../../src/services/nameservices/ens/__tests__/utils.spec.ts"],"names":[],"mappings":""}

package/dist/services/nameservices/ens/__tests__/utils.spec.js

@@ -0,0 +1,75 @@
+import { zeroAddress } from 'viem';
+import { describe, expect, it, vi } from 'vitest';
+import { resolveAddress } from '../utils.js';
+const REAL_ADDRESS = '0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045';
+const ZERO_ADDRESS = zeroAddress;
+function mockClient(returnValue, rejects = false) {
+    const getEnsAddress = rejects
+        ? vi.fn().mockRejectedValue(new Error('network error'))
+        : vi.fn().mockResolvedValue(returnValue);
+    return { getEnsAddress };
+}
+describe('resolveAddress', () => {
+    describe('hex address input', () => {
+        it('returns a valid hex address as-is', async () => {
+            expect(await resolveAddress(REAL_ADDRESS)).toBe(REAL_ADDRESS);
+        });
+        it('does not require a mainnet client for hex addresses', async () => {
+            await expect(resolveAddress(REAL_ADDRESS)).resolves.toBe(REAL_ADDRESS);
+        });
+    });
+    describe('ENS name input', () => {
+        it('resolves a valid ENS name', async () => {
+            const client = mockClient(REAL_ADDRESS);
+            const result = await resolveAddress('vitalik.eth', client);
+            expect(result).toBe(REAL_ADDRESS);
+            expect(client.getEnsAddress).toHaveBeenCalledWith({ name: 'vitalik.eth' });
+        });
+        it('normalises the ENS name before resolving', async () => {
+            const client = mockClient(REAL_ADDRESS);
+            await resolveAddress('Vitalik.ETH', client);
+            expect(client.getEnsAddress).toHaveBeenCalledWith({ name: 'vitalik.eth' });
+        });
+        it('throws EnsNotConfiguredError when no mainnet client is provided', async () => {
+            const { EnsNotConfiguredError } = await import('../errors.js');
+            await expect(resolveAddress('vitalik.eth')).rejects.toThrow(EnsNotConfiguredError);
+        });
+        it('includes chain ID 1 in the error when no mainnet client provided', async () => {
+            await expect(resolveAddress('vitalik.eth')).rejects.toThrow('1');
+        });
+        it('throws when ENS name cannot be resolved (returns null)', async () => {
+            const client = mockClient(null);
+            await expect(resolveAddress('unresolvable.eth', client)).rejects.toThrow('"unresolvable.eth" could not be resolved');
+        });
+        it('throws when ENS name resolves to zero address', async () => {
+            const client = mockClient(ZERO_ADDRESS);
+            await expect(resolveAddress('zero.eth', client)).rejects.toThrow('zero address');
+        });
+        it('throws with RPC error label on network failure', async () => {
+            const client = mockClient(null, true);
+            await expect(resolveAddress('vitalik.eth', client)).rejects.toThrow('RPC error');
+        });
+        it('preserves the original cause on RPC failure', async () => {
+            const client = mockClient(null, true);
+            let caught;
+            try {
+                await resolveAddress('vitalik.eth', client);
+            }
+            catch (e) {
+                caught = e;
+            }
+            expect(caught?.cause).toBeInstanceOf(Error);
+            expect((caught?.cause).message).toBe('network error');
+        });
+    });
+    describe('invalid input', () => {
+        it('throws for ENS-shaped strings that fail normalisation', async () => {
+            // Has a dot so satisfies EnsName, but contains invalid ENS characters
+            await expect(resolveAddress('not!valid.eth', {})).rejects.toThrow('Invalid address or ENS name');
+        });
+        it('includes the invalid input in the error message', async () => {
+            await expect(resolveAddress('!!bad!!.eth', {})).rejects.toThrow('"!!bad!!.eth"');
+        });
+    });
+});
+//# sourceMappingURL=utils.spec.js.map

package/dist/services/nameservices/ens/__tests__/utils.spec.js.map

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

package/dist/services/nameservices/ens/errors.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Thrown when an ENS operation is attempted but the required chain is not
+ * included in the Actions chain configuration.
+ */
+export declare class EnsNotConfiguredError extends Error {
+    chainId: number;
+    constructor(chainId?: 1);
+}
+/**
+ * Thrown when an ENS name cannot be resolved to an address — e.g. the name
+ * is unregistered, resolves to the zero address, or fails normalization.
+ */
+export declare class EnsResolutionError extends Error {
+    input: string;
+    constructor(message: string, input: string, options?: ErrorOptions);
+}
+/**
+ * Thrown when an ENS RPC call fails due to a network or provider error.
+ */
+export declare class EnsRpcError extends Error {
+    input: string;
+    constructor(message: string, input: string, options?: ErrorOptions);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/services/nameservices/ens/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../src/services/nameservices/ens/errors.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,OAAO,EAAE,MAAM,CAAA;gBAEH,OAAO,IAAa;CAQjC;AAED;;;GAGG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,KAAK,EAAE,MAAM,CAAA;gBAED,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAKnE;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,KAAK;IACpC,KAAK,EAAE,MAAM,CAAA;gBAED,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAKnE"}

package/dist/services/nameservices/ens/errors.js

@@ -0,0 +1,35 @@
+import { mainnet } from 'viem/chains';
+/**
+ * Thrown when an ENS operation is attempted but the required chain is not
+ * included in the Actions chain configuration.
+ */
+export class EnsNotConfiguredError extends Error {
+    constructor(chainId = mainnet.id) {
+        super(`ENS operations require Ethereum mainnet. ` +
+            `Add chain ID ${chainId} to your chain configuration.`);
+        this.name = 'EnsNotConfiguredError';
+        this.chainId = chainId;
+    }
+}
+/**
+ * Thrown when an ENS name cannot be resolved to an address — e.g. the name
+ * is unregistered, resolves to the zero address, or fails normalization.
+ */
+export class EnsResolutionError extends Error {
+    constructor(message, input, options) {
+        super(message, options);
+        this.name = 'EnsResolutionError';
+        this.input = input;
+    }
+}
+/**
+ * Thrown when an ENS RPC call fails due to a network or provider error.
+ */
+export class EnsRpcError extends Error {
+    constructor(message, input, options) {
+        super(message, options);
+        this.name = 'EnsRpcError';
+        this.input = input;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/services/nameservices/ens/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../src/services/nameservices/ens/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAErC;;;GAGG;AACH,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAG9C,YAAY,OAAO,GAAG,OAAO,CAAC,EAAE;QAC9B,KAAK,CACH,2CAA2C;YACzC,gBAAgB,OAAO,+BAA+B,CACzD,CAAA;QACD,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAA;QACnC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;IACxB,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAG3C,YAAY,OAAe,EAAE,KAAa,EAAE,OAAsB;QAChE,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QACvB,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAA;QAChC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;IACpB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IAGpC,YAAY,OAAe,EAAE,KAAa,EAAE,OAAsB;QAChE,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QACvB,IAAI,CAAC,IAAI,GAAG,aAAa,CAAA;QACzB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;IACpB,CAAC;CACF"}

package/dist/services/nameservices/ens/index.d.ts

@@ -0,0 +1,5 @@
+export { EnsNamespace } from './EnsNamespace.js';
+export { EnsNotConfiguredError, EnsResolutionError, EnsRpcError, } from './errors.js';
+export { type EnsInfo, type EnsName, isEnsName, type NameServiceProvider, } from './types.js';
+export { passthroughResolver, type RecipientResolver, resolveAddress, } from './utils.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/services/nameservices/ens/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/services/nameservices/ens/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,WAAW,GACZ,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,OAAO,EACZ,SAAS,EACT,KAAK,mBAAmB,GACzB,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,mBAAmB,EACnB,KAAK,iBAAiB,EACtB,cAAc,GACf,MAAM,YAAY,CAAA"}

package/dist/services/nameservices/ens/index.js

@@ -0,0 +1,5 @@
+export { EnsNamespace } from './EnsNamespace.js';
+export { EnsNotConfiguredError, EnsResolutionError, EnsRpcError, } from './errors.js';
+export { isEnsName, } from './types.js';
+export { passthroughResolver, resolveAddress, } from './utils.js';
+//# sourceMappingURL=index.js.map

package/dist/services/nameservices/ens/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/services/nameservices/ens/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,WAAW,GACZ,MAAM,aAAa,CAAA;AACpB,OAAO,EAGL,SAAS,GAEV,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,mBAAmB,EAEnB,cAAc,GACf,MAAM,YAAY,CAAA"}

package/dist/services/nameservices/ens/types.d.ts

@@ -0,0 +1,63 @@
+import type { Address } from 'viem';
+import type { SwapExecuteParams, SwapQuoteParams } from '../../../types/swap/base.js';
+/**
+ * A dot-separated ENS name (e.g. `vitalik.eth`, `sub.vitalik.eth`, `example.com`).
+ *
+ * ENS is not limited to `.eth` — it supports any DNSSEC-enabled DNS TLD as well
+ * as ENS-native TLDs (`.eth`, `.test`). Subdomains of arbitrary depth are valid.
+ *
+ * This type is a structural constraint (at least one dot) mirroring viem's Address type.
+ * True validity is determined at runtime by `normalize()` (ENSIP-15): a name is valid
+ * if and only if it does not throw during normalization.
+ */
+export type EnsName = `${string}.${string}`;
+/**
+ * Type guard for EnsName. Mirrors the pattern of viem's isAddress.
+ * Rejects obviously invalid forms (leading/trailing dots, consecutive dots)
+ * but does not run full ENSIP-15 normalization — use normalize() for that.
+ * @param value - String to check
+ * @returns True if the value satisfies the EnsName structural constraint
+ */
+export declare function isEnsName(value: string): value is EnsName;
+/**
+ * Standard ENS profile text record fields as defined by ENSIP-5 and ENSIP-18.
+ * All fields are null when not set on the resolver.
+ */
+export interface EnsInfo {
+    avatar: string | null;
+    display: string | null;
+    description: string | null;
+    url: string | null;
+    email: string | null;
+    keywords: string | null;
+    /** com.twitter */
+    twitter: string | null;
+    /** com.github */
+    github: string | null;
+    /** com.discord */
+    discord: string | null;
+    /** org.reddit */
+    reddit: string | null;
+}
+/** SwapExecuteParams with recipient narrowed to Address after ENS resolution */
+export type SwapExecuteParamsResolved = Omit<SwapExecuteParams, 'recipient'> & {
+    recipient?: Address;
+};
+/** SwapQuoteParams with recipient narrowed to Address after ENS resolution */
+export type SwapQuoteParamsResolved = Omit<SwapQuoteParams, 'recipient'> & {
+    recipient?: Address;
+};
+/**
+ * Common interface for human-readable name service providers.
+ * Implemented by {@link EnsNamespace}; designed to support future providers
+ * such as Basename, Lens, Unstoppable Domains, etc.
+ */
+export interface NameServiceProvider {
+    /** Resolve a name or address to a checksummed hex address. */
+    getAddress(input: Address | EnsName): Promise<Address>;
+    /** Reverse-resolve an address to its primary name, or null if not set. */
+    getName(address: Address): Promise<EnsName | null>;
+    /** Fetch all standard profile text record fields in a single batched call. */
+    getInfo(input: Address | EnsName): Promise<EnsInfo>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/services/nameservices/ens/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/services/nameservices/ens/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAEnC,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAE9E;;;;;;;;;GASG;AACH,MAAM,MAAM,OAAO,GAAG,GAAG,MAAM,IAAI,MAAM,EAAE,CAAA;AAE3C;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,OAAO,CAOzD;AAED;;;GAGG;AACH,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,kBAAkB;IAClB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,iBAAiB;IACjB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,kBAAkB;IAClB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,iBAAiB;IACjB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CACtB;AAED,gFAAgF;AAChF,MAAM,MAAM,yBAAyB,GAAG,IAAI,CAAC,iBAAiB,EAAE,WAAW,CAAC,GAAG;IAC7E,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB,CAAA;AAED,8EAA8E;AAC9E,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC,eAAe,EAAE,WAAW,CAAC,GAAG;IACzE,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB,CAAA;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,8DAA8D;IAC9D,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACtD,0EAA0E;IAC1E,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAA;IAClD,8EAA8E;IAC9E,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CACpD"}

package/dist/services/nameservices/ens/types.js

@@ -0,0 +1,14 @@
+/**
+ * Type guard for EnsName. Mirrors the pattern of viem's isAddress.
+ * Rejects obviously invalid forms (leading/trailing dots, consecutive dots)
+ * but does not run full ENSIP-15 normalization — use normalize() for that.
+ * @param value - String to check
+ * @returns True if the value satisfies the EnsName structural constraint
+ */
+export function isEnsName(value) {
+    return (value.includes('.') &&
+        !value.startsWith('.') &&
+        !value.endsWith('.') &&
+        !value.includes('..'));
+}
+//# sourceMappingURL=types.js.map

package/dist/services/nameservices/ens/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/services/nameservices/ens/types.ts"],"names":[],"mappings":"AAgBA;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,OAAO,CACL,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC;QACnB,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC;QACtB,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC;QACpB,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CACtB,CAAA;AACH,CAAC"}

package/dist/services/nameservices/ens/utils.d.ts

@@ -0,0 +1,25 @@
+import type { Address, PublicClient } from 'viem';
+import type { EnsName } from './types.js';
+export { type EnsName, isEnsName } from './types.js';
+/** Resolves an ENS name or address to a checksummed hex Address, or returns undefined. */
+export type RecipientResolver = (recipient: Address | EnsName | undefined) => Promise<Address | undefined>;
+/** Pass-through resolver used when no ENS resolution is configured. Throws on ENS names. */
+export declare const passthroughResolver: RecipientResolver;
+/**
+ * Low-level utility to resolve an ENS name or hex address to a checksummed hex address.
+ * Use this when you manage your own viem PublicClient (e.g. inside providers or scripts).
+ *
+ * If you have an {@link Actions} instance, prefer `actions.ens.getAddress()` instead —
+ * it handles client lookup and fallback automatically from your chain configuration.
+ *
+ * Hex addresses (0x...) are returned as-is after format validation.
+ * ENS names require a mainnet public client for on-chain resolution.
+ * @param input - Hex address (0x...) or ENS name (e.g. "vitalik.eth")
+ * @param mainnetClient - Public client connected to Ethereum mainnet (required for ENS names)
+ * @returns Resolved hex address
+ * @throws {EnsNotConfiguredError} If mainnet client is not provided
+ * @throws {EnsResolutionError} If the name is invalid or cannot be resolved
+ * @throws {EnsRpcError} If the RPC call fails
+ */
+export declare function resolveAddress(input: Address | EnsName, mainnetClient?: PublicClient): Promise<Address>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/services/nameservices/ens/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../src/services/nameservices/ens/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,MAAM,CAAA;AASjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sCAAsC,CAAA;AAEnE,OAAO,EAAE,KAAK,OAAO,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAA;AAE9E,0FAA0F;AAC1F,MAAM,MAAM,iBAAiB,GAAG,CAC9B,SAAS,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,KACrC,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAAA;AAEjC,4FAA4F;AAC5F,eAAO,MAAM,mBAAmB,EAAE,iBAKjC,CAAA;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,OAAO,GAAG,OAAO,EACxB,aAAa,CAAC,EAAE,YAAY,GAC3B,OAAO,CAAC,OAAO,CAAC,CAuClB"}

package/dist/services/nameservices/ens/utils.js

@@ -0,0 +1,53 @@
+import { isAddress, isAddressEqual, zeroAddress } from 'viem';
+import { normalize } from 'viem/ens';
+import { EnsNotConfiguredError, EnsResolutionError, EnsRpcError, } from './errors.js';
+export { isEnsName } from './types.js';
+/** Pass-through resolver used when no ENS resolution is configured. Throws on ENS names. */
+export const passthroughResolver = (r) => {
+    if (r !== undefined && !isAddress(r, { strict: false })) {
+        throw new Error(`ENS resolution is not configured; received "${r}"`);
+    }
+    return Promise.resolve(r);
+};
+/**
+ * Low-level utility to resolve an ENS name or hex address to a checksummed hex address.
+ * Use this when you manage your own viem PublicClient (e.g. inside providers or scripts).
+ *
+ * If you have an {@link Actions} instance, prefer `actions.ens.getAddress()` instead —
+ * it handles client lookup and fallback automatically from your chain configuration.
+ *
+ * Hex addresses (0x...) are returned as-is after format validation.
+ * ENS names require a mainnet public client for on-chain resolution.
+ * @param input - Hex address (0x...) or ENS name (e.g. "vitalik.eth")
+ * @param mainnetClient - Public client connected to Ethereum mainnet (required for ENS names)
+ * @returns Resolved hex address
+ * @throws {EnsNotConfiguredError} If mainnet client is not provided
+ * @throws {EnsResolutionError} If the name is invalid or cannot be resolved
+ * @throws {EnsRpcError} If the RPC call fails
+ */
+export async function resolveAddress(input, mainnetClient) {
+    if (isAddress(input, { strict: false }))
+        return input;
+    if (!mainnetClient)
+        throw new EnsNotConfiguredError();
+    const normalized = (() => {
+        try {
+            return normalize(input);
+        }
+        catch (cause) {
+            throw new EnsResolutionError(`Invalid address or ENS name: "${input}"`, input, { cause });
+        }
+    })();
+    const resolved = await mainnetClient
+        .getEnsAddress({ name: normalized })
+        .catch((cause) => {
+        throw new EnsRpcError(`ENS resolution failed for "${input}": RPC error`, input, { cause });
+    });
+    if (!resolved)
+        throw new EnsResolutionError(`ENS name "${input}" could not be resolved`, input);
+    if (isAddressEqual(resolved, zeroAddress)) {
+        throw new EnsResolutionError(`ENS name "${input}" resolved to the zero address`, input);
+    }
+    return resolved;
+}
+//# sourceMappingURL=utils.js.map

package/dist/services/nameservices/ens/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../src/services/nameservices/ens/utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,MAAM,CAAA;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAEpC,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,WAAW,GACZ,MAAM,uCAAuC,CAAA;AAG9C,OAAO,EAAgB,SAAS,EAAE,MAAM,sCAAsC,CAAA;AAO9E,4FAA4F;AAC5F,MAAM,CAAC,MAAM,mBAAmB,GAAsB,CAAC,CAAC,EAAE,EAAE;IAC1D,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;QACxD,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,GAAG,CAAC,CAAA;IACtE,CAAC;IACD,OAAO,OAAO,CAAC,OAAO,CAAC,CAAwB,CAAC,CAAA;AAClD,CAAC,CAAA;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,KAAwB,EACxB,aAA4B;IAE5B,IAAI,SAAS,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QAAE,OAAO,KAAK,CAAA;IAErD,IAAI,CAAC,aAAa;QAAE,MAAM,IAAI,qBAAqB,EAAE,CAAA;IAErD,MAAM,UAAU,GAAG,CAAC,GAAG,EAAE;QACvB,IAAI,CAAC;YACH,OAAO,SAAS,CAAC,KAAK,CAAC,CAAA;QACzB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,kBAAkB,CAC1B,iCAAiC,KAAK,GAAG,EACzC,KAAK,EACL,EAAE,KAAK,EAAE,CACV,CAAA;QACH,CAAC;IACH,CAAC,CAAC,EAAE,CAAA;IAEJ,MAAM,QAAQ,GAAG,MAAM,aAAa;SACjC,aAAa,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;SACnC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;QACxB,MAAM,IAAI,WAAW,CACnB,8BAA8B,KAAK,cAAc,EACjD,KAAK,EACL,EAAE,KAAK,EAAE,CACV,CAAA;IACH,CAAC,CAAC,CAAA;IAEJ,IAAI,CAAC,QAAQ;QACX,MAAM,IAAI,kBAAkB,CAC1B,aAAa,KAAK,yBAAyB,EAC3C,KAAK,CACN,CAAA;IACH,IAAI,cAAc,CAAC,QAAQ,EAAE,WAAW,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,kBAAkB,CAC1B,aAAa,KAAK,gCAAgC,EAClD,KAAK,CACN,CAAA;IACH,CAAC;IACD,OAAO,QAAQ,CAAA;AACjB,CAAC"}

package/dist/services/tokenBalance.d.ts

@@ -1,15 +1,18 @@
 import type { Address } from 'viem';
 import type { ChainManager } from './ChainManager.js';
-import type { Asset, TokenBalance } from '../types/asset.js';
+import type { Asset, BalanceFetchOptions, TokenBalance } from '../types/asset.js';
 /**
- * Fetch ETH balance across all supported chains
+ * Fetch ETH balance across the requested chains (or all supported chains).
  * @param chainManager - The chain manager
  * @param walletAddress - The wallet address
+ * @param options - Optional `chainIds` filter (caller-validated)
  * @returns Promise resolving to ETH balance
  */
-export declare function fetchETHBalance(chainManager: ChainManager, walletAddress: Address): Promise<TokenBalance>;
+export declare function fetchETHBalance(chainManager: ChainManager, walletAddress: Address, options?: BalanceFetchOptions): Promise<TokenBalance>;
 /**
- * Fetch total balance for this asset across all supported chains
+ * Fetch total balance for this asset across the requested chains (or all
+ * supported chains). Chains where the asset has no configured address are
+ * silently skipped, matching the unfiltered behavior.
  */
-export declare function fetchERC20Balance(chainManager: ChainManager, walletAddress: Address, asset: Asset): Promise<TokenBalance>;
+export declare function fetchERC20Balance(chainManager: ChainManager, walletAddress: Address, asset: Asset, options?: BalanceFetchOptions): Promise<TokenBalance>;
 //# sourceMappingURL=tokenBalance.d.ts.map

package/dist/services/tokenBalance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tokenBalance.d.ts","sourceRoot":"","sources":["../../src/services/tokenBalance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAKnC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAC9D,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAE3D;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,YAAY,EAAE,YAAY,EAC1B,aAAa,EAAE,OAAO,GACrB,OAAO,CAAC,YAAY,CAAC,CA8BvB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,YAAY,EAAE,YAAY,EAC1B,aAAa,EAAE,OAAO,EACtB,KAAK,EAAE,KAAK,GACX,OAAO,CAAC,YAAY,CAAC,CAuCvB"}
+{"version":3,"file":"tokenBalance.d.ts","sourceRoot":"","sources":["../../src/services/tokenBalance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAKnC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAC9D,OAAO,KAAK,EAAE,KAAK,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAEhF;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,YAAY,EAAE,YAAY,EAC1B,aAAa,EAAE,OAAO,EACtB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,YAAY,CAAC,CAgCvB;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,YAAY,EAAE,YAAY,EAC1B,aAAa,EAAE,OAAO,EACtB,KAAK,EAAE,KAAK,EACZ,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,YAAY,CAAC,CAyCvB"}

package/dist/services/tokenBalance.js

@@ -1,14 +1,17 @@
 import { erc20Abi, formatEther, formatUnits } from 'viem';
 import { ETH } from '../constants/assets.js';
 /**
- * Fetch ETH balance across all supported chains
+ * Fetch ETH balance across the requested chains (or all supported chains).
  * @param chainManager - The chain manager
  * @param walletAddress - The wallet address
+ * @param options - Optional `chainIds` filter (caller-validated)
  * @returns Promise resolving to ETH balance
  */
-export async function fetchETHBalance(chainManager, walletAddress) {
-    const supportedChains = chainManager.getSupportedChains();
-    const chainBalancePromises = supportedChains.map(async (chainId) => {
+export async function fetchETHBalance(chainManager, walletAddress, options) {
+    const targetChains = [
+        ...new Set(options?.chainIds ?? chainManager.getSupportedChains()),
+    ];
+    const chainBalancePromises = targetChains.map(async (chainId) => {
         const publicClient = chainManager.getPublicClient(chainId);
         const balanceRaw = await publicClient.getBalance({
             address: walletAddress,
@@ -33,11 +36,15 @@ export async function fetchETHBalance(chainManager, walletAddress) {
     };
 }
 /**
- * Fetch total balance for this asset across all supported chains
+ * Fetch total balance for this asset across the requested chains (or all
+ * supported chains). Chains where the asset has no configured address are
+ * silently skipped, matching the unfiltered behavior.
  */
-export async function fetchERC20Balance(chainManager, walletAddress, asset) {
-    const supportedChains = chainManager.getSupportedChains();
-    const chainsWithToken = supportedChains.filter((chainId) => asset.address[chainId]);
+export async function fetchERC20Balance(chainManager, walletAddress, asset, options) {
+    const targetChains = [
+        ...new Set(options?.chainIds ?? chainManager.getSupportedChains()),
+    ];
+    const chainsWithToken = targetChains.filter((chainId) => asset.address[chainId]);
     const chainBalancePromises = chainsWithToken.map(async (chainId) => {
         const balanceRaw = await fetchBalanceForChain(asset, chainId, walletAddress, chainManager);
         return {

package/dist/services/tokenBalance.js.map

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