feat: Add batch ENS / Basename resolution with useAddresses hook and getAddresses utility

[cpcramer]

What changed? Why?
Added new multicall ENS resolution utilities with useAddresses hook and getAddresses utility function to efficiently resolve multiple ENS or Basenames to Ethereum addresses, reducing network requests and improving performance for batch resolution scenarios.

Notes to reviewers

Follow up from chore: Add bidirectional resolution validation when batching Basenames and ENS names. As an additional fast follow, I will be implementing this function into getNames.

How has it been tested?
Unit tests.

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Comments	Updated (UTC)
onchainkit-coverage	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Apr 11, 2025 9:40pm
onchainkit-playground	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Apr 11, 2025 9:40pm
onchainkit-routes	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Apr 11, 2025 9:40pm

[dgca]

nit: I'd recommend always putting defaults at the top of the object, otherwise if someone adds a default that conflicts with the keys above (unlikely in this case), things won't work as expected.

E.g. if someone added enabled: true to the default options, it'll take precedence over enabled: !!names.length

[dgca]

suggestion(non-blocking): 100% personal preference, but if you wanna save some variable declaraions...

queryKey: ['useAddresses', ...names, chain.id],

[dgca]

suggestion(non-blocking): Filtering before mapping lets you skip some operations. Super trivial in terms of perf gains in this case, but in some cases it can be meaningful

[dgca]

Nvm, I see why this is the way it is. The user can pass "" as a name and you wanna preserve index order.

In that case, you could go with something like this if you wanna be more succinct (this would replace lines 32-73)

  const addressPromises = names.map(async (name) => {
    if (!name) return null;

    try {
      const address = await client.getEnsAddress({
        name,
        universalResolverAddress: isBasename(name)
          ? RESOLVER_ADDRESSES_BY_CHAIN_ID[chain.id]
          : undefined,
      });
      return address;
    } catch (error) {
      console.error(`Error resolving address for ${name}:`, error);
      return null;
    }
  });

  try {
    return await Promise.all(addressPromises);
  } catch (err) {
    console.error('Error resolving addresses in batch:', err);
    return Array(names.length).fill(null);
  }

[cpcramer]

Saw this after merging, will look at refactoring!

[brendan-defi]

nice, love this