@towns-labs/web3 2.0.1

package/dist/cache/SimpleCache.js

@@ -0,0 +1,84 @@
+import { createDefaultStorage } from './TTLCacheStorage';
+export class SimpleCache {
+    storage;
+    pendingFetches = new Map();
+    /**
+     * @param options.ttlSeconds Optional time-to-live for cache entries in seconds. If not provided, cache entries do not expire.
+     * @param options.maxSize Optional maximum number of entries in the cache.
+     * @param options.createStorageFn Optional factory to create storage backend. Defaults to in-memory TTLCache.
+     */
+    constructor(options) {
+        const ttlMs = options.ttlSeconds !== undefined ? options.ttlSeconds * 1000 : undefined;
+        const createFn = options.createStorageFn ?? createDefaultStorage;
+        this.storage = createFn({
+            ttlMs,
+            maxSize: options.maxSize,
+        });
+    }
+    async get(key) {
+        return this.storage.get(key.toKey());
+    }
+    async add(key, value) {
+        return this.storage.set(key.toKey(), value);
+    }
+    async remove(key) {
+        const cacheKey = key.toKey();
+        // Clear pending fetch first to prevent returning stale in-flight data
+        this.pendingFetches.delete(cacheKey);
+        return this.storage.delete(cacheKey);
+    }
+    async clear() {
+        // Clear all pending fetches first to prevent returning stale in-flight data
+        this.pendingFetches.clear();
+        if (this.storage.clear) {
+            return this.storage.clear();
+        }
+    }
+    /**
+     * Executes a function to fetch a value if it's not in the cache,
+     * stores the result, and returns it.
+     */
+    async executeUsingCache(key, fetchFn, opts) {
+        const cacheKey = key.toKey();
+        const skipCache = opts?.skipCache === true;
+        // 1. Check for pending fetch FIRST (synchronous check before any await)
+        // This prevents race conditions where concurrent calls interleave
+        // Skip deduplication when skipCache is true - caller explicitly wants fresh data
+        if (!skipCache) {
+            const pendingPromise = this.pendingFetches.get(cacheKey);
+            if (pendingPromise) {
+                return pendingPromise;
+            }
+        }
+        // 2. Create promise that checks cache then fetches if needed
+        // Store it synchronously BEFORE any await to prevent races
+        const operationPromise = (async () => {
+            // Check main cache
+            if (!skipCache) {
+                const cachedValue = await this.storage.get(cacheKey);
+                if (cachedValue !== undefined) {
+                    return cachedValue;
+                }
+            }
+            // No cached value: Initiate fetch
+            const fetchedValue = await fetchFn(key);
+            // Add to main cache only on successful fetch
+            await this.storage.set(cacheKey, fetchedValue);
+            return fetchedValue;
+        })();
+        // Only track in pendingFetches if not skipping cache
+        // skipCache calls run independently and don't deduplicate
+        if (!skipCache) {
+            this.pendingFetches.set(cacheKey, operationPromise);
+        }
+        try {
+            return await operationPromise;
+        }
+        finally {
+            if (!skipCache) {
+                this.pendingFetches.delete(cacheKey);
+            }
+        }
+    }
+}
+//# sourceMappingURL=SimpleCache.js.map

package/dist/cache/SimpleCache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SimpleCache.js","sourceRoot":"","sources":["../../src/cache/SimpleCache.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAA;AASxD,MAAM,OAAO,WAAW;IACH,OAAO,CAAkB;IAClC,cAAc,GAA4B,IAAI,GAAG,EAAE,CAAA;IAE3D;;;;OAIG;IACH,YAAY,OAA8B;QACtC,MAAM,KAAK,GAAG,OAAO,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC,CAAC,SAAS,CAAA;QACtF,MAAM,QAAQ,GAAG,OAAO,CAAC,eAAe,IAAI,oBAAoB,CAAA;QAChE,IAAI,CAAC,OAAO,GAAG,QAAQ,CAAC;YACpB,KAAK;YACL,OAAO,EAAE,OAAO,CAAC,OAAO;SAC3B,CAAC,CAAA;IACN,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAY;QAClB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAA;IACxC,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAY,EAAE,KAAQ;QAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,KAAK,CAAC,CAAA;IAC/C,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAY;QACrB,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,EAAE,CAAA;QAC5B,sEAAsE;QACtE,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;QACpC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;IACxC,CAAC;IAED,KAAK,CAAC,KAAK;QACP,4EAA4E;QAC5E,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAA;QAC3B,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YACrB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAA;QAC/B,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,iBAAiB,CACnB,GAAY,EACZ,OAAqC,EACrC,IAA8B;QAE9B,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,EAAE,CAAA;QAC5B,MAAM,SAAS,GAAG,IAAI,EAAE,SAAS,KAAK,IAAI,CAAA;QAE1C,wEAAwE;QACxE,kEAAkE;QAClE,iFAAiF;QACjF,IAAI,CAAC,SAAS,EAAE,CAAC;YACb,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;YACxD,IAAI,cAAc,EAAE,CAAC;gBACjB,OAAO,cAAc,CAAA;YACzB,CAAC;QACL,CAAC;QAED,6DAA6D;QAC7D,2DAA2D;QAC3D,MAAM,gBAAgB,GAAG,CAAC,KAAK,IAAgB,EAAE;YAC7C,mBAAmB;YACnB,IAAI,CAAC,SAAS,EAAE,CAAC;gBACb,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;gBACpD,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;oBAC5B,OAAO,WAAW,CAAA;gBACtB,CAAC;YACL,CAAC;YAED,kCAAkC;YAClC,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAA;YACvC,6CAA6C;YAC7C,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAA;YAC9C,OAAO,YAAY,CAAA;QACvB,CAAC,CAAC,EAAE,CAAA;QAEJ,qDAAqD;QACrD,0DAA0D;QAC1D,IAAI,CAAC,SAAS,EAAE,CAAC;YACb,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAA;QACvD,CAAC;QAED,IAAI,CAAC;YACD,OAAO,MAAM,gBAAgB,CAAA;QACjC,CAAC;gBAAS,CAAC;YACP,IAAI,CAAC,SAAS,EAAE,CAAC;gBACb,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;YACxC,CAAC;QACL,CAAC;IACL,CAAC;CACJ"}

package/dist/cache/TTLCacheStorage.d.ts

@@ -0,0 +1,19 @@
+import { ICacheStorage, CacheStorageConfig } from './ICacheStorage';
+/**
+ * In-memory cache storage implementation using TTLCache
+ * This is the default storage backend for SimpleCache and EntitlementCache
+ */
+export declare class TTLCacheStorage<V> implements ICacheStorage<V> {
+    private readonly cache;
+    private readonly defaultTtlMs;
+    constructor(config?: CacheStorageConfig);
+    get(key: string): Promise<V | undefined>;
+    set(key: string, value: V, ttlMs?: number): Promise<void>;
+    delete(key: string): Promise<void>;
+    clear(): Promise<void>;
+}
+/**
+ * Default factory function that creates in-memory TTLCacheStorage
+ */
+export declare function createDefaultStorage<V>(config: CacheStorageConfig): ICacheStorage<V>;
+//# sourceMappingURL=TTLCacheStorage.d.ts.map

package/dist/cache/TTLCacheStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TTLCacheStorage.d.ts","sourceRoot":"","sources":["../../src/cache/TTLCacheStorage.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAEnE;;;GAGG;AACH,qBAAa,eAAe,CAAC,CAAC,CAAE,YAAW,aAAa,CAAC,CAAC,CAAC;IACvD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;IAC3C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAQ;gBAEzB,MAAM,CAAC,EAAE,kBAAkB;IAQjC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAIxC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQzD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG/B;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,MAAM,EAAE,kBAAkB,GAAG,aAAa,CAAC,CAAC,CAAC,CAEpF"}

package/dist/cache/TTLCacheStorage.js

@@ -0,0 +1,40 @@
+import TTLCache from '@isaacs/ttlcache';
+/**
+ * In-memory cache storage implementation using TTLCache
+ * This is the default storage backend for SimpleCache and EntitlementCache
+ */
+export class TTLCacheStorage {
+    cache;
+    defaultTtlMs;
+    constructor(config) {
+        this.defaultTtlMs = config?.ttlMs ?? Infinity;
+        this.cache = new TTLCache({
+            ttl: this.defaultTtlMs,
+            max: config?.maxSize ?? 10_000,
+        });
+    }
+    async get(key) {
+        return this.cache.get(key);
+    }
+    async set(key, value, ttlMs) {
+        if (ttlMs !== undefined) {
+            this.cache.set(key, value, { ttl: ttlMs });
+        }
+        else {
+            this.cache.set(key, value);
+        }
+    }
+    async delete(key) {
+        this.cache.delete(key);
+    }
+    async clear() {
+        this.cache.clear();
+    }
+}
+/**
+ * Default factory function that creates in-memory TTLCacheStorage
+ */
+export function createDefaultStorage(config) {
+    return new TTLCacheStorage(config);
+}
+//# sourceMappingURL=TTLCacheStorage.js.map

package/dist/cache/TTLCacheStorage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TTLCacheStorage.js","sourceRoot":"","sources":["../../src/cache/TTLCacheStorage.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,kBAAkB,CAAA;AAGvC;;;GAGG;AACH,MAAM,OAAO,eAAe;IACP,KAAK,CAAqB;IAC1B,YAAY,CAAQ;IAErC,YAAY,MAA2B;QACnC,IAAI,CAAC,YAAY,GAAG,MAAM,EAAE,KAAK,IAAI,QAAQ,CAAA;QAC7C,IAAI,CAAC,KAAK,GAAG,IAAI,QAAQ,CAAC;YACtB,GAAG,EAAE,IAAI,CAAC,YAAY;YACtB,GAAG,EAAE,MAAM,EAAE,OAAO,IAAI,MAAM;SACjC,CAAC,CAAA;IACN,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW;QACjB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IAC9B,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,KAAQ,EAAE,KAAc;QAC3C,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACtB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAA;QAC9C,CAAC;aAAM,CAAC;YACJ,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;QAC9B,CAAC;IACL,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACpB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IAC1B,CAAC;IAED,KAAK,CAAC,KAAK;QACP,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAA;IACtB,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAI,MAA0B;IAC9D,OAAO,IAAI,eAAe,CAAI,MAAM,CAAC,CAAA;AACzC,CAAC"}

package/dist/chain.d.ts

@@ -0,0 +1,89 @@
+export declare const towns: {
+    blockExplorers: {
+        readonly default: {
+            readonly name: "Towns Chain Explorer";
+            readonly url: "https://explorer.towns.com/";
+        };
+    };
+    blockTime?: number | undefined | undefined;
+    contracts: {
+        readonly multicall3: {
+            readonly address: "0x4920EF7722b73Fdc9f6391829cfB3844f39393B3";
+            readonly blockCreated: 12653370;
+        };
+    };
+    ensTlds?: readonly string[] | undefined;
+    id: 550;
+    name: "Towns Mainnet";
+    nativeCurrency: {
+        readonly decimals: 18;
+        readonly name: "Ether";
+        readonly symbol: "ETH";
+    };
+    experimental_preconfirmationTime?: number | undefined | undefined;
+    rpcUrls: {
+        readonly default: {
+            readonly http: readonly ["https://mainnet.rpc.towns.com/"];
+        };
+    };
+    sourceId?: number | undefined | undefined;
+    testnet?: boolean | undefined | undefined;
+    custom?: Record<string, unknown> | undefined;
+    extendSchema?: Record<string, unknown> | undefined;
+    fees?: import("viem").ChainFees<undefined> | undefined;
+    formatters?: undefined;
+    prepareTransactionRequest?: ((args: import("viem").PrepareTransactionRequestParameters, options: {
+        phase: "beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters";
+    }) => Promise<import("viem").PrepareTransactionRequestParameters>) | [fn: ((args: import("viem").PrepareTransactionRequestParameters, options: {
+        phase: "beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters";
+    }) => Promise<import("viem").PrepareTransactionRequestParameters>) | undefined, options: {
+        runAt: readonly ("beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters")[];
+    }] | undefined;
+    serializers?: import("viem").ChainSerializers<undefined, import("viem").TransactionSerializable> | undefined;
+    verifyHash?: ((client: import("viem").Client, parameters: import("viem").VerifyHashActionParameters) => Promise<import("viem").VerifyHashActionReturnType>) | undefined;
+};
+export declare const townsTestnet: {
+    blockExplorers: {
+        readonly default: {
+            readonly name: "Towns Chain Explorer";
+            readonly url: "https://testnet.explorer.towns.com/";
+        };
+    };
+    blockTime?: number | undefined | undefined;
+    contracts: {
+        readonly multicall3: {
+            readonly address: "0xcaBdE26Efcf78d31040Dc57F85484e786E0a1E13";
+            readonly blockCreated: 20137781;
+        };
+    };
+    ensTlds?: readonly string[] | undefined;
+    id: 6524490;
+    name: "Towns Testnet";
+    nativeCurrency: {
+        readonly decimals: 18;
+        readonly name: "Ether";
+        readonly symbol: "ETH";
+    };
+    experimental_preconfirmationTime?: number | undefined | undefined;
+    rpcUrls: {
+        readonly default: {
+            readonly http: readonly ["https://testnet.rpc.towns.com/http"];
+        };
+    };
+    sourceId?: number | undefined | undefined;
+    testnet?: boolean | undefined | undefined;
+    custom?: Record<string, unknown> | undefined;
+    extendSchema?: Record<string, unknown> | undefined;
+    fees?: import("viem").ChainFees<undefined> | undefined;
+    formatters?: undefined;
+    prepareTransactionRequest?: ((args: import("viem").PrepareTransactionRequestParameters, options: {
+        phase: "beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters";
+    }) => Promise<import("viem").PrepareTransactionRequestParameters>) | [fn: ((args: import("viem").PrepareTransactionRequestParameters, options: {
+        phase: "beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters";
+    }) => Promise<import("viem").PrepareTransactionRequestParameters>) | undefined, options: {
+        runAt: readonly ("beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters")[];
+    }] | undefined;
+    serializers?: import("viem").ChainSerializers<undefined, import("viem").TransactionSerializable> | undefined;
+    verifyHash?: ((client: import("viem").Client, parameters: import("viem").VerifyHashActionParameters) => Promise<import("viem").VerifyHashActionReturnType>) | undefined;
+};
+//# sourceMappingURL=chain.d.ts.map

package/dist/chain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain.d.ts","sourceRoot":"","sources":["../src/chain.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsBhB,CAAA;AAEF,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsBvB,CAAA"}

package/dist/chain.js

@@ -0,0 +1,48 @@
+import { defineChain } from 'viem';
+export const towns = defineChain({
+    id: 550,
+    name: 'Towns Mainnet',
+    nativeCurrency: {
+        decimals: 18,
+        name: 'Ether',
+        symbol: 'ETH',
+    },
+    rpcUrls: {
+        default: {
+            http: [`https://mainnet.rpc.towns.com/`],
+        },
+    },
+    blockExplorers: {
+        default: { name: 'Towns Chain Explorer', url: 'https://explorer.towns.com/' },
+    },
+    contracts: {
+        multicall3: {
+            address: '0x4920EF7722b73Fdc9f6391829cfB3844f39393B3',
+            blockCreated: 12653370,
+        },
+    },
+});
+export const townsTestnet = defineChain({
+    id: 6524490,
+    name: 'Towns Testnet',
+    nativeCurrency: {
+        decimals: 18,
+        name: 'Ether',
+        symbol: 'ETH',
+    },
+    rpcUrls: {
+        default: {
+            http: [`https://testnet.rpc.towns.com/http`],
+        },
+    },
+    blockExplorers: {
+        default: { name: 'Towns Chain Explorer', url: 'https://testnet.explorer.towns.com/' },
+    },
+    contracts: {
+        multicall3: {
+            address: '0xcaBdE26Efcf78d31040Dc57F85484e786E0a1E13',
+            blockCreated: 20137781,
+        },
+    },
+});
+//# sourceMappingURL=chain.js.map

package/dist/chain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain.js","sourceRoot":"","sources":["../src/chain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,MAAM,CAAA;AAElC,MAAM,CAAC,MAAM,KAAK,GAAG,WAAW,CAAC;IAC7B,EAAE,EAAE,GAAG;IACP,IAAI,EAAE,eAAe;IACrB,cAAc,EAAE;QACZ,QAAQ,EAAE,EAAE;QACZ,IAAI,EAAE,OAAO;QACb,MAAM,EAAE,KAAK;KAChB;IACD,OAAO,EAAE;QACL,OAAO,EAAE;YACL,IAAI,EAAE,CAAC,gCAAgC,CAAC;SAC3C;KACJ;IACD,cAAc,EAAE;QACZ,OAAO,EAAE,EAAE,IAAI,EAAE,sBAAsB,EAAE,GAAG,EAAE,6BAA6B,EAAE;KAChF;IACD,SAAS,EAAE;QACP,UAAU,EAAE;YACR,OAAO,EAAE,4CAA4C;YACrD,YAAY,EAAE,QAAQ;SACzB;KACJ;CACJ,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,YAAY,GAAG,WAAW,CAAC;IACpC,EAAE,EAAE,OAAO;IACX,IAAI,EAAE,eAAe;IACrB,cAAc,EAAE;QACZ,QAAQ,EAAE,EAAE;QACZ,IAAI,EAAE,OAAO;QACb,MAAM,EAAE,KAAK;KAChB;IACD,OAAO,EAAE;QACL,OAAO,EAAE;YACL,IAAI,EAAE,CAAC,oCAAoC,CAAC;SAC/C;KACJ;IACD,cAAc,EAAE;QACZ,OAAO,EAAE,EAAE,IAAI,EAAE,sBAAsB,EAAE,GAAG,EAAE,qCAAqC,EAAE;KACxF;IACD,SAAS,EAAE;QACP,UAAU,EAAE;YACR,OAAO,EAAE,4CAA4C;YACrD,YAAY,EAAE,QAAQ;SACzB;KACJ;CACJ,CAAC,CAAA"}

package/dist/delegate-registry/DelegateRegistry.d.ts

@@ -0,0 +1,3 @@
+import { ethers } from 'ethers';
+export declare function computeDelegatorsForProvider(provider: ethers.providers.BaseProvider, wallets: string[]): Promise<string[]>;
+//# sourceMappingURL=DelegateRegistry.d.ts.map

package/dist/delegate-registry/DelegateRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DelegateRegistry.d.ts","sourceRoot":"","sources":["../../src/delegate-registry/DelegateRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAS,MAAM,QAAQ,CAAA;AAqEtC,wBAAsB,4BAA4B,CAC9C,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,YAAY,EACvC,OAAO,EAAE,MAAM,EAAE,GAClB,OAAO,CAAC,MAAM,EAAE,CAAC,CAwBnB"}

package/dist/delegate-registry/DelegateRegistry.js

@@ -0,0 +1,72 @@
+import { ethers, utils } from 'ethers';
+const v1RegistryContractAddress = '0x00000000000076a84fef008cdabe6409d2fe638b';
+const delegationTypeAll = 1;
+const delegateRegistryJsonAbi = `
+[
+  {
+    "type": "function",
+    "name": "getDelegationsByDelegate",
+    "inputs": [
+      {
+        "name": "delegate",
+        "type": "address",
+        "internalType": "address"
+      }
+    ],
+    "outputs": [
+      {
+        "name": "",
+        "type": "tuple[]",
+        "internalType": "struct IDelegateRegistryV1.DelegationInfo[]",
+        "components": [
+          {
+            "name": "type_",
+            "type": "uint8",
+            "internalType": "enum IDelegateRegistryV1.DelegationType"
+          },
+          {
+            "name": "vault",
+            "type": "address",
+            "internalType": "address"
+          },
+          {
+            "name": "delegate",
+            "type": "address",
+            "internalType": "address"
+          },
+          {
+            "name": "contract_",
+            "type": "address",
+            "internalType": "address"
+          },
+          {
+            "name": "tokenId",
+            "type": "uint256",
+            "internalType": "uint256"
+          }
+        ]
+      }
+    ],
+    "stateMutability": "view"
+  }
+]`;
+function newDelegateContract(provider) {
+    const iface = new utils.Interface(delegateRegistryJsonAbi);
+    const humanReadableAbi = iface.format(utils.FormatTypes.full);
+    return new ethers.Contract(v1RegistryContractAddress, humanReadableAbi, provider);
+}
+export async function computeDelegatorsForProvider(provider, wallets) {
+    const contract = newDelegateContract(provider);
+    const delegatorWallets = (await Promise.all(wallets.map(async (wallet) => {
+        return ((await contract.callStatic.getDelegationsByDelegate(wallet))
+            // Keep only delegations that cede the entire wallet
+            .filter((info) => info.type_ == delegationTypeAll)
+            // The 'vault' is the delegator wallet that cedes to one of wallets
+            // passed in via the parameters
+            .map((info) => info.vault));
+    }))).reduce((left, right) => [...left, ...right]);
+    // Return de-duped list of wallets, in case delegate wallets occur >1x across
+    // ethereum mainnet and testnets.
+    return [...new Set(delegatorWallets)];
+}
+//# sourceMappingURL=DelegateRegistry.js.map

package/dist/delegate-registry/DelegateRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DelegateRegistry.js","sourceRoot":"","sources":["../../src/delegate-registry/DelegateRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAA;AAEtC,MAAM,yBAAyB,GAAG,4CAA4C,CAAA;AAC9E,MAAM,iBAAiB,GAAG,CAAC,CAAA;AAE3B,MAAM,uBAAuB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgD9B,CAAA;AAEF,SAAS,mBAAmB,CAAC,QAAuC;IAChE,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,SAAS,CAAC,uBAAuB,CAAC,CAAA;IAC1D,MAAM,gBAAgB,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAA;IAC7D,OAAO,IAAI,MAAM,CAAC,QAAQ,CAAC,yBAAyB,EAAE,gBAAgB,EAAE,QAAQ,CAAC,CAAA;AACrF,CAAC;AAUD,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAC9C,QAAuC,EACvC,OAAiB;IAEjB,MAAM,QAAQ,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAA;IAC9C,MAAM,gBAAgB,GAAG,CACrB,MAAM,OAAO,CAAC,GAAG,CACb,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;QACzB,OAAO,CAEC,CAAC,MAAM,QAAQ,CAAC,UAAU,CAAC,wBAAwB,CAC/C,MAAM,CACT,CACJ;YACG,oDAAoD;aACnD,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,IAAI,iBAAiB,CAAC;YAClD,mEAAmE;YACnE,+BAA+B;aAC9B,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CACjC,CAAA;IACL,CAAC,CAAC,CACL,CACJ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC,CAAC,CAAA;IAE9C,6EAA6E;IAC7E,iCAAiC;IACjC,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAA;AACzC,CAAC"}

package/dist/eip-712/EIP-712.d.ts

@@ -0,0 +1,35 @@
+import { BigNumber, TypedDataDomain, TypedDataField } from 'ethers';
+import { Address } from '../types/ContractTypes';
+/**
+ * https://github.com/ethereum/EIPs/blob/master/EIPS/eip-712.md
+ * */
+interface LinkedWalletValue {
+    message: string;
+    userID: Address;
+    nonce: BigNumber;
+}
+interface Eip712LinkedWalletArgs {
+    domain: TypedDataDomain;
+    nonce: BigNumber;
+    userID: Address;
+    message: string;
+}
+export declare function createEip712LinkedWalletdData({ domain, userID, nonce, message, }: Eip712LinkedWalletArgs): {
+    types: Record<string, TypedDataField[]>;
+    domain: TypedDataDomain;
+    value: LinkedWalletValue;
+};
+export declare function getDomainSeparator(domain: TypedDataDomain): string;
+export declare function toLinkedWalletHash(message: string, address: string, nonce: BigNumber): string;
+/**
+ * @dev Returns the keccak256 digest of an EIP-712 typed data (EIP-191 version `0x01`).
+ *
+ * The digest is calculated from a `domainSeparator` and a `structHash`, by prefixing them with
+ * `0x1901` and hashing the result. It corresponds to the hash signed by the
+ * https://eips.ethereum.org/EIPS/eip-712[`eth_signTypedData`] JSON-RPC method as part of EIP-712.
+ *
+ * See {ECDSA-recover}.
+ */
+export declare function toTypedDataHash(domain: TypedDataDomain, structHash: string): string;
+export {};
+//# sourceMappingURL=EIP-712.d.ts.map

package/dist/eip-712/EIP-712.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EIP-712.d.ts","sourceRoot":"","sources":["../../src/eip-712/EIP-712.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAA;AAEnE,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAA;AAEhD;;KAEK;AACL,UAAU,iBAAiB;IACvB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,OAAO,CAAA;IACf,KAAK,EAAE,SAAS,CAAA;CACnB;AAED,UAAU,sBAAsB;IAC5B,MAAM,EAAE,eAAe,CAAA;IACvB,KAAK,EAAE,SAAS,CAAA;IAChB,MAAM,EAAE,OAAO,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;CAClB;AAED,wBAAgB,6BAA6B,CAAC,EAC1C,MAAM,EACN,MAAM,EACN,KAAK,EACL,OAAO,GACV,EAAE,sBAAsB;;;;EAqBxB;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAmBlE;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,MAAM,CAa7F;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAOnF"}

package/dist/eip-712/EIP-712.js

@@ -0,0 +1,57 @@
+import { defaultAbiCoder, keccak256, solidityPack, toUtf8Bytes } from 'ethers/lib/utils';
+export function createEip712LinkedWalletdData({ domain, userID, nonce, message, }) {
+    // should match the types and order of _LINKED_WALLET_TYPEHASH in
+    // river/contracts/src/factory/facets/wallet-link/WalletLinkBase.sol
+    const linkedWalletTypes = {
+        LinkedWallet: [
+            { name: 'message', type: 'string' },
+            { name: 'userID', type: 'address' },
+            { name: 'nonce', type: 'uint256' },
+        ],
+    };
+    const types = linkedWalletTypes;
+    const value = {
+        message,
+        userID,
+        nonce,
+    };
+    return {
+        types,
+        domain,
+        value,
+    };
+}
+export function getDomainSeparator(domain) {
+    // this hash should match _TYPE_HASH
+    // in river/contracts/src/diamond/utils/cryptography/signature/EIP712Base.sol
+    const DOMAIN_TYPE_HASH = keccak256(toUtf8Bytes('EIP712Domain(string name,string version,uint256 chainId,address verifyingContract)'));
+    // Compute the keccak256 hash of the name and version
+    const nameHash = keccak256(toUtf8Bytes(domain.name ?? ''));
+    const versionHash = keccak256(toUtf8Bytes(domain.version ?? ''));
+    // Encode the data
+    const encodedData = defaultAbiCoder.encode(['bytes32', 'bytes32', 'bytes32', 'uint256', 'address'], [DOMAIN_TYPE_HASH, nameHash, versionHash, domain.chainId, domain.verifyingContract]);
+    // Compute the keccak256 hash of the encoded data
+    return keccak256(encodedData);
+}
+export function toLinkedWalletHash(message, address, nonce) {
+    // this hash should match _LINKED_WALLET_TYPEHASH in
+    // river/contracts/src/factory/facets/wallet-link/WalletLinkBase.sol
+    const LINKED_WALLET_TYPE_HASH = keccak256(toUtf8Bytes('LinkedWallet(string message,address userID,uint256 nonce)'));
+    const structHash = keccak256(defaultAbiCoder.encode(['bytes32', 'string', 'address', 'uint256'], [LINKED_WALLET_TYPE_HASH, message, address, nonce]));
+    return structHash;
+}
+/**
+ * @dev Returns the keccak256 digest of an EIP-712 typed data (EIP-191 version `0x01`).
+ *
+ * The digest is calculated from a `domainSeparator` and a `structHash`, by prefixing them with
+ * `0x1901` and hashing the result. It corresponds to the hash signed by the
+ * https://eips.ethereum.org/EIPS/eip-712[`eth_signTypedData`] JSON-RPC method as part of EIP-712.
+ *
+ * See {ECDSA-recover}.
+ */
+export function toTypedDataHash(domain, structHash) {
+    const domainSeparator = getDomainSeparator(domain);
+    const encodedData = solidityPack(['bytes2', 'bytes32', 'bytes32'], ['0x1901', domainSeparator, structHash]);
+    return keccak256(encodedData);
+}
+//# sourceMappingURL=EIP-712.js.map

package/dist/eip-712/EIP-712.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EIP-712.js","sourceRoot":"","sources":["../../src/eip-712/EIP-712.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAmBxF,MAAM,UAAU,6BAA6B,CAAC,EAC1C,MAAM,EACN,MAAM,EACN,KAAK,EACL,OAAO,GACc;IACrB,iEAAiE;IACjE,oEAAoE;IACpE,MAAM,iBAAiB,GAAqC;QACxD,YAAY,EAAE;YACV,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE;YACnC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE;YACnC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;SACrC;KACJ,CAAA;IACD,MAAM,KAAK,GAAG,iBAAiB,CAAA;IAC/B,MAAM,KAAK,GAAsB;QAC7B,OAAO;QACP,MAAM;QACN,KAAK;KACR,CAAA;IACD,OAAO;QACH,KAAK;QACL,MAAM;QACN,KAAK;KACR,CAAA;AACL,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAuB;IACtD,oCAAoC;IACpC,6EAA6E;IAC7E,MAAM,gBAAgB,GAAG,SAAS,CAC9B,WAAW,CACP,oFAAoF,CACvF,CACJ,CAAA;IACD,qDAAqD;IACrD,MAAM,QAAQ,GAAG,SAAS,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAA;IAC1D,MAAM,WAAW,GAAG,SAAS,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAA;IAChE,kBAAkB;IAClB,MAAM,WAAW,GAAG,eAAe,CAAC,MAAM,CACtC,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,EACvD,CAAC,gBAAgB,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,iBAAiB,CAAC,CACtF,CAAA;IAED,iDAAiD;IACjD,OAAO,SAAS,CAAC,WAAW,CAAC,CAAA;AACjC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAAe,EAAE,OAAe,EAAE,KAAgB;IACjF,oDAAoD;IACpD,oEAAoE;IACpE,MAAM,uBAAuB,GAAG,SAAS,CACrC,WAAW,CAAC,2DAA2D,CAAC,CAC3E,CAAA;IACD,MAAM,UAAU,GAAG,SAAS,CACxB,eAAe,CAAC,MAAM,CAClB,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC,EAC3C,CAAC,uBAAuB,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,CACrD,CACJ,CAAA;IACD,OAAO,UAAU,CAAA;AACrB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAAC,MAAuB,EAAE,UAAkB;IACvE,MAAM,eAAe,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAA;IAClD,MAAM,WAAW,GAAG,YAAY,CAC5B,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC,EAChC,CAAC,QAAQ,EAAE,eAAe,EAAE,UAAU,CAAC,CAC1C,CAAA;IACD,OAAO,SAAS,CAAC,WAAW,CAAC,CAAA;AACjC,CAAC"}

package/dist/erc-721/IERC721AQueryableShim.d.ts

@@ -0,0 +1,9 @@
+import { ethers } from 'ethers';
+import { BaseContractShim } from '../BaseContractShim';
+import { IERC721AQueryable__factory } from '@towns-labs/generated/dev/typings/factories/IERC721AQueryable__factory';
+declare const connect: typeof IERC721AQueryable__factory.connect;
+export declare class IERC721AQueryableShim extends BaseContractShim<typeof connect> {
+    constructor(address: string, provider: ethers.providers.Provider);
+}
+export {};
+//# sourceMappingURL=IERC721AQueryableShim.d.ts.map

package/dist/erc-721/IERC721AQueryableShim.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IERC721AQueryableShim.d.ts","sourceRoot":"","sources":["../../src/erc-721/IERC721AQueryableShim.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,EAAE,0BAA0B,EAAE,MAAM,wEAAwE,CAAA;AAEnH,QAAA,MAAa,OAAO,2CAA+B,CAAA;AAEnD,qBAAa,qBAAsB,SAAQ,gBAAgB,CAAC,OAAO,OAAO,CAAC;gBAC3D,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ;CAGnE"}

package/dist/erc-721/IERC721AQueryableShim.js

@@ -0,0 +1,9 @@
+import { BaseContractShim } from '../BaseContractShim';
+import { IERC721AQueryable__factory } from '@towns-labs/generated/dev/typings/factories/IERC721AQueryable__factory';
+const { abi, connect } = IERC721AQueryable__factory;
+export class IERC721AQueryableShim extends BaseContractShim {
+    constructor(address, provider) {
+        super(address, provider, connect, abi);
+    }
+}
+//# sourceMappingURL=IERC721AQueryableShim.js.map

package/dist/erc-721/IERC721AQueryableShim.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IERC721AQueryableShim.js","sourceRoot":"","sources":["../../src/erc-721/IERC721AQueryableShim.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,EAAE,0BAA0B,EAAE,MAAM,wEAAwE,CAAA;AAEnH,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,0BAA0B,CAAA;AAEnD,MAAM,OAAO,qBAAsB,SAAQ,gBAAgC;IACvE,YAAY,OAAe,EAAE,QAAmC;QAC5D,KAAK,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,CAAC,CAAA;IAC1C,CAAC;CACJ"}

package/dist/erc-721/IERC721AShim.d.ts

@@ -0,0 +1,9 @@
+import { ethers } from 'ethers';
+import { IERC721A__factory } from '@towns-labs/generated/dev/typings/factories/IERC721A__factory';
+import { BaseContractShim } from '../BaseContractShim';
+declare const connect: typeof IERC721A__factory.connect;
+export declare class IERC721AShim extends BaseContractShim<typeof connect> {
+    constructor(address: string, provider: ethers.providers.Provider);
+}
+export {};
+//# sourceMappingURL=IERC721AShim.d.ts.map

package/dist/erc-721/IERC721AShim.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IERC721AShim.d.ts","sourceRoot":"","sources":["../../src/erc-721/IERC721AShim.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,EAAE,iBAAiB,EAAE,MAAM,+DAA+D,CAAA;AACjG,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAEtD,QAAA,MAAa,OAAO,kCAAsB,CAAA;AAE1C,qBAAa,YAAa,SAAQ,gBAAgB,CAAC,OAAO,OAAO,CAAC;gBAClD,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ;CAGnE"}

package/dist/erc-721/IERC721AShim.js

@@ -0,0 +1,9 @@
+import { IERC721A__factory } from '@towns-labs/generated/dev/typings/factories/IERC721A__factory';
+import { BaseContractShim } from '../BaseContractShim';
+const { abi, connect } = IERC721A__factory;
+export class IERC721AShim extends BaseContractShim {
+    constructor(address, provider) {
+        super(address, provider, connect, abi);
+    }
+}
+//# sourceMappingURL=IERC721AShim.js.map

package/dist/erc-721/IERC721AShim.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IERC721AShim.js","sourceRoot":"","sources":["../../src/erc-721/IERC721AShim.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,+DAA+D,CAAA;AACjG,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAEtD,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,iBAAiB,CAAA;AAE1C,MAAM,OAAO,YAAa,SAAQ,gBAAgC;IAC9D,YAAY,OAAe,EAAE,QAAmC;QAC5D,KAAK,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,CAAC,CAAA;IAC1C,CAAC;CACJ"}