viem 0.0.0-portable-types-20230523145621 → 0.0.0-refactor-generics-20230831161903

package/dist/esm/accounts/mnemonicToAccount.js

@@ -1,6 +1,11 @@
 import { HDKey } from '@scure/bip32';
 import { mnemonicToSeedSync } from '@scure/bip39';
 import { hdKeyToAccount } from './hdKeyToAccount.js';
+/**
+ * @description Creates an Account from a mnemonic phrase.
+ *
+ * @returns A HD Account.
+ */
 export function mnemonicToAccount(mnemonic, opts = {}) {
     const seed = mnemonicToSeedSync(mnemonic);
     return hdKeyToAccount(HDKey.fromMasterSeed(seed), opts);

package/dist/esm/accounts/mnemonicToAccount.js.map

@@ -1 +1 @@
-{"version":3,"file":"mnemonicToAccount.js","sourceRoot":"","sources":["../../../src/accounts/mnemonicToAccount.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAA;AACpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAEjD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAQpD,MAAM,UAAU,iBAAiB,CAC/B,QAAgB,EAChB,OAAkB,EAAE;IAEpB,MAAM,IAAI,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAA;IACzC,OAAO,cAAc,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAA;AACzD,CAAC"}
+{"version":3,"file":"mnemonicToAccount.js","sourceRoot":"","sources":["../../../src/accounts/mnemonicToAccount.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAA;AACpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAEjD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAGpD;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC/B,QAAgB,EAChB,OAAkB,EAAE;IAEpB,MAAM,IAAI,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAA;IACzC,OAAO,cAAc,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAA;AACzD,CAAC"}

package/dist/esm/accounts/privateKeyToAccount.js

@@ -5,6 +5,11 @@ import { publicKeyToAddress } from './utils/publicKeyToAddress.js';
 import { signMessage } from './utils/signMessage.js';
 import { signTransaction } from './utils/signTransaction.js';
 import { signTypedData } from './utils/signTypedData.js';
+/**
+ * @description Creates an Account from a private key.
+ *
+ * @returns A Private Key Account.
+ */
 export function privateKeyToAccount(privateKey) {
     const publicKey = toHex(secp256k1.getPublicKey(privateKey.slice(2), false));
     const address = publicKeyToAddress(publicKey);
@@ -13,8 +18,8 @@ export function privateKeyToAccount(privateKey) {
         async signMessage({ message }) {
             return signMessage({ message, privateKey });
         },
-        async signTransaction(transaction) {
-            return signTransaction({ privateKey, transaction });
+        async signTransaction(transaction, { serializer } = {}) {
+            return signTransaction({ privateKey, transaction, serializer });
         },
         async signTypedData(typedData) {
             return signTypedData({ ...typedData, privateKey });

package/dist/esm/accounts/privateKeyToAccount.js.map

@@ -1 +1 @@
-{"version":3,"file":"privateKeyToAccount.js","sourceRoot":"","sources":["../../../src/accounts/privateKeyToAccount.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAGnD,OAAO,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAA;AAElD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAA;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAOxD,MAAM,UAAU,mBAAmB,CAAC,UAAe;IACjD,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC,YAAY,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAA;IAC3E,MAAM,OAAO,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAA;IAE7C,MAAM,OAAO,GAAG,SAAS,CAAC;QACxB,OAAO;QACP,KAAK,CAAC,WAAW,CAAC,EAAE,OAAO,EAAE;YAC3B,OAAO,WAAW,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAA;QAC7C,CAAC;QACD,KAAK,CAAC,eAAe,CAAC,WAAW;YAC/B,OAAO,eAAe,CAAC,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC,CAAA;QACrD,CAAC;QACD,KAAK,CAAC,aAAa,CAAC,SAAS;YAC3B,OAAO,aAAa,CAAC,EAAE,GAAG,SAAS,EAAE,UAAU,EAAE,CAAC,CAAA;QACpD,CAAC;KACF,CAAC,CAAA;IAEF,OAAO;QACL,GAAG,OAAO;QACV,SAAS;QACT,MAAM,EAAE,YAAY;KACrB,CAAA;AACH,CAAC"}
+{"version":3,"file":"privateKeyToAccount.js","sourceRoot":"","sources":["../../../src/accounts/privateKeyToAccount.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAGnD,OAAO,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAA;AAElD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAA;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAExD;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,UAAe;IACjD,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC,YAAY,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAA;IAC3E,MAAM,OAAO,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAA;IAE7C,MAAM,OAAO,GAAG,SAAS,CAAC;QACxB,OAAO;QACP,KAAK,CAAC,WAAW,CAAC,EAAE,OAAO,EAAE;YAC3B,OAAO,WAAW,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAA;QAC7C,CAAC;QACD,KAAK,CAAC,eAAe,CAAC,WAAW,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE;YACpD,OAAO,eAAe,CAAC,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,CAAA;QACjE,CAAC;QACD,KAAK,CAAC,aAAa,CAAC,SAAS;YAC3B,OAAO,aAAa,CAAC,EAAE,GAAG,SAAS,EAAE,UAAU,EAAE,CAAC,CAAA;QACpD,CAAC;KACF,CAAC,CAAA;IAEF,OAAO;QACL,GAAG,OAAO;QACV,SAAS;QACT,MAAM,EAAE,YAAY;KACrB,CAAA;AACH,CAAC"}

package/dist/esm/accounts/toAccount.js

@@ -1,5 +1,10 @@
 import { InvalidAddressError } from '../errors/address.js';
 import { isAddress } from '../utils/address/isAddress.js';
+/**
+ * @description Creates an Account from a custom signing implementation.
+ *
+ * @returns A Local Account.
+ */
 export function toAccount(source) {
     if (typeof source === 'string') {
         if (!isAddress(source))

package/dist/esm/accounts/toAccount.js.map

@@ -1 +1 @@
-{"version":3,"file":"toAccount.js","sourceRoot":"","sources":["../../../src/accounts/toAccount.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAA;AAkBzD,MAAM,UAAU,SAAS,CACvB,MAAsB;IAEtB,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE;QAC9B,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;YAAE,MAAM,IAAI,mBAAmB,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAA;QAC1E,OAAO;YACL,OAAO,EAAE,MAAM;YACf,IAAI,EAAE,UAAU;SACuB,CAAA;KAC1C;IAED,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC;QAC5B,MAAM,IAAI,mBAAmB,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAA;IAC5D,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,eAAe,EAAE,MAAM,CAAC,eAAe;QACvC,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,MAAM,EAAE,QAAQ;QAChB,IAAI,EAAE,OAAO;KAC0B,CAAA;AAC3C,CAAC"}
+{"version":3,"file":"toAccount.js","sourceRoot":"","sources":["../../../src/accounts/toAccount.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAA;AAazD;;;;GAIG;AACH,MAAM,UAAU,SAAS,CACvB,MAAsB;IAEtB,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE;QAC9B,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;YAAE,MAAM,IAAI,mBAAmB,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAA;QAC1E,OAAO;YACL,OAAO,EAAE,MAAM;YACf,IAAI,EAAE,UAAU;SACuB,CAAA;KAC1C;IAED,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC;QAC5B,MAAM,IAAI,mBAAmB,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAA;IAC5D,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,eAAe,EAAE,MAAM,CAAC,eAAe;QACvC,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,MAAM,EAAE,QAAQ;QAChB,IAAI,EAAE,OAAO;KAC0B,CAAA;AAC3C,CAAC"}

package/dist/esm/accounts/utils/privateKeyToAddress.js

@@ -0,0 +1,15 @@
+import { secp256k1 } from '@noble/curves/secp256k1';
+import { bytesToHex } from '../../utils/encoding/toHex.js';
+import { publicKeyToAddress } from './publicKeyToAddress.js';
+/**
+ * @description Converts an ECDSA private key to an address.
+ *
+ * @param privateKey The private key to convert.
+ *
+ * @returns The address.
+ */
+export function privateKeyToAddress(privateKey) {
+    const publicKey = bytesToHex(secp256k1.getPublicKey(privateKey.slice(2), false));
+    return publicKeyToAddress(publicKey);
+}
+//# sourceMappingURL=privateKeyToAddress.js.map

package/dist/esm/accounts/utils/privateKeyToAddress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"privateKeyToAddress.js","sourceRoot":"","sources":["../../../../src/accounts/utils/privateKeyToAddress.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAInD,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAA;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAE5D;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,UAAe;IACjD,MAAM,SAAS,GAAG,UAAU,CAC1B,SAAS,CAAC,YAAY,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CACnD,CAAA;IACD,OAAO,kBAAkB,CAAC,SAAS,CAAC,CAAA;AACtC,CAAC"}

package/dist/esm/accounts/utils/publicKeyToAddress.js

@@ -1,5 +1,12 @@
 import { checksumAddress } from '../../utils/address/getAddress.js';
 import { keccak256 } from '../../utils/hash/keccak256.js';
+/**
+ * @description Converts an ECDSA public key to an address.
+ *
+ * @param publicKey The public key to convert.
+ *
+ * @returns The address.
+ */
 export function publicKeyToAddress(publicKey) {
     const address = keccak256(`0x${publicKey.substring(4)}`).substring(26);
     return checksumAddress(`0x${address}`);

package/dist/esm/accounts/utils/publicKeyToAddress.js.map

@@ -1 +1 @@
-{"version":3,"file":"publicKeyToAddress.js","sourceRoot":"","sources":["../../../../src/accounts/utils/publicKeyToAddress.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAA;AACnE,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAA;AASzD,MAAM,UAAU,kBAAkB,CAAC,SAAc;IAC/C,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,CAAA;IACtE,OAAO,eAAe,CAAC,KAAK,OAAO,EAAE,CAAY,CAAA;AACnD,CAAC"}
+{"version":3,"file":"publicKeyToAddress.js","sourceRoot":"","sources":["../../../../src/accounts/utils/publicKeyToAddress.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAA;AACnE,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAA;AAEzD;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAAc;IAC/C,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,CAAA;IACtE,OAAO,eAAe,CAAC,KAAK,OAAO,EAAE,CAAY,CAAA;AACnD,CAAC"}

package/dist/esm/accounts/utils/sign.js

@@ -1,5 +1,13 @@
 import { secp256k1 } from '@noble/curves/secp256k1';
 import { toHex } from '../../utils/encoding/toHex.js';
+/**
+ * @description Signs a hash with a given private key.
+ *
+ * @param hash The hash to sign.
+ * @param privateKey The private key to sign with.
+ *
+ * @returns The signature.
+ */
 export async function sign({ hash, privateKey, }) {
     const { r, s, recovery } = secp256k1.sign(hash.slice(2), privateKey.slice(2));
     return {

package/dist/esm/accounts/utils/sign.js.map

@@ -1 +1 @@
-{"version":3,"file":"sign.js","sourceRoot":"","sources":["../../../../src/accounts/utils/sign.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAGnD,OAAO,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAA;AAgBrD,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,EACzB,IAAI,EACJ,UAAU,GACK;IACf,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;IAC7E,OAAO;QACL,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;QACX,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;QACX,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;KACxB,CAAA;AACH,CAAC"}
+{"version":3,"file":"sign.js","sourceRoot":"","sources":["../../../../src/accounts/utils/sign.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAGnD,OAAO,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAA;AAQrD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,EACzB,IAAI,EACJ,UAAU,GACK;IACf,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;IAC7E,OAAO;QACL,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;QACX,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;QACX,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;KACxB,CAAA;AACH,CAAC"}

package/dist/esm/accounts/utils/signMessage.js

@@ -1,6 +1,12 @@
 import { hashMessage } from '../../utils/signature/hashMessage.js';
+import { signatureToHex } from '../../utils/signature/signatureToHex.js';
 import { sign } from './sign.js';
-import { signatureToHex } from './signatureToHex.js';
+/**
+ * @description Calculates an Ethereum-specific signature in [EIP-191 format](https://eips.ethereum.org/EIPS/eip-191):
+ * `keccak256("\x19Ethereum Signed Message:\n" + len(message) + message))`.
+ *
+ * @returns The signature.
+ */
 export async function signMessage({ message, privateKey, }) {
     const signature = await sign({ hash: hashMessage(message), privateKey });
     return signatureToHex(signature);

package/dist/esm/accounts/utils/signMessage.js.map

@@ -1 +1 @@
-{"version":3,"file":"signMessage.js","sourceRoot":"","sources":["../../../../src/accounts/utils/signMessage.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAA;AAElE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAgBpD,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,EAChC,OAAO,EACP,UAAU,GACY;IACtB,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC,CAAA;IACxE,OAAO,cAAc,CAAC,SAAS,CAAC,CAAA;AAClC,CAAC"}
+{"version":3,"file":"signMessage.js","sourceRoot":"","sources":["../../../../src/accounts/utils/signMessage.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAA;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAA;AAExE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAUhC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,EAChC,OAAO,EACP,UAAU,GACY;IACtB,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC,CAAA;IACxE,OAAO,cAAc,CAAC,SAAS,CAAC,CAAA;AAClC,CAAC"}

package/dist/esm/accounts/utils/signTransaction.js

@@ -1,11 +1,11 @@
 import { keccak256 } from '../../utils/hash/keccak256.js';
-import { serializeTransaction } from '../../utils/transaction/serializeTransaction.js';
+import { serializeTransaction, } from '../../utils/transaction/serializeTransaction.js';
 import { sign } from './sign.js';
-export async function signTransaction({ privateKey, transaction, }) {
+export async function signTransaction({ privateKey, transaction, serializer = serializeTransaction, }) {
     const signature = await sign({
-        hash: keccak256(serializeTransaction(transaction)),
+        hash: keccak256(serializer(transaction)),
         privateKey,
     });
-    return serializeTransaction(transaction, signature);
+    return serializer(transaction, signature);
 }
 //# sourceMappingURL=signTransaction.js.map

package/dist/esm/accounts/utils/signTransaction.js.map

@@ -1 +1 @@
-{"version":3,"file":"signTransaction.js","sourceRoot":"","sources":["../../../../src/accounts/utils/signTransaction.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAA;AAEzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iDAAiD,CAAA;AAEtF,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAahC,MAAM,CAAC,KAAK,UAAU,eAAe,CAEnC,EACA,UAAU,EACV,WAAW,GACmC;IAG9C,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC;QAC3B,IAAI,EAAE,SAAS,CAAC,oBAAoB,CAAC,WAAW,CAAC,CAAC;QAClD,UAAU;KACX,CAAC,CAAA;IACF,OAAO,oBAAoB,CAAC,WAAW,EAAE,SAAS,CAAC,CAAA;AACrD,CAAC"}
+{"version":3,"file":"signTransaction.js","sourceRoot":"","sources":["../../../../src/accounts/utils/signTransaction.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAA;AAEzD,OAAO,EAEL,oBAAoB,GACrB,MAAM,iDAAiD,CAAA;AAExD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAehC,MAAM,CAAC,KAAK,UAAU,eAAe,CAEnC,EACA,UAAU,EACV,WAAW,EACX,UAAU,GAAG,oBAAoB,GACmB;IAGpD,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC;QAC3B,IAAI,EAAE,SAAS,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;QACxC,UAAU;KACX,CAAC,CAAA;IACF,OAAO,UAAU,CACf,WAAW,EACX,SAAS,CAC6C,CAAA;AAC1D,CAAC"}

package/dist/esm/accounts/utils/signTypedData.js

@@ -1,6 +1,12 @@
 import { hashTypedData, } from '../../utils/signature/hashTypedData.js';
+import { signatureToHex } from '../../utils/signature/signatureToHex.js';
 import { sign } from './sign.js';
-import { signatureToHex } from './signatureToHex.js';
+/**
+ * @description Signs typed data and calculates an Ethereum-specific signature in [EIP-191 format](https://eips.ethereum.org/EIPS/eip-191):
+ * `keccak256("\x19Ethereum Signed Message:\n" + len(message) + message))`.
+ *
+ * @returns The signature.
+ */
 export async function signTypedData({ privateKey, ...typedData }) {
     const signature = await sign({
         hash: hashTypedData(typedData),

package/dist/esm/accounts/utils/signTypedData.js.map

@@ -1 +1 @@
-{"version":3,"file":"signTypedData.js","sourceRoot":"","sources":["../../../../src/accounts/utils/signTypedData.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,aAAa,GACd,MAAM,wCAAwC,CAAA;AAE/C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAkBpD,MAAM,CAAC,KAAK,UAAU,aAAa,CAGjC,EACA,UAAU,EACV,GAAG,SAAS,EAIb;IACC,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC;QAC3B,IAAI,EAAE,aAAa,CAAC,SAAoC,CAAC;QACzD,UAAU;KACX,CAAC,CAAA;IACF,OAAO,cAAc,CAAC,SAAS,CAAC,CAAA;AAClC,CAAC"}
+{"version":3,"file":"signTypedData.js","sourceRoot":"","sources":["../../../../src/accounts/utils/signTypedData.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,aAAa,GACd,MAAM,wCAAwC,CAAA;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAA;AAExE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAYhC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAGjC,EACA,UAAU,EACV,GAAG,SAAS,EAIb;IACC,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC;QAC3B,IAAI,EAAE,aAAa,CAAC,SAAoC,CAAC;QACzD,UAAU;KACX,CAAC,CAAA;IACF,OAAO,cAAc,CAAC,SAAS,CAAC,CAAA;AAClC,CAAC"}

package/dist/esm/actions/ens/getEnsAddress.js

@@ -1,13 +1,42 @@
-import { singleAddressResolverAbi, universalResolverAbi, } from '../../constants/abis.js';
+import { addressResolverAbi, universalResolverResolveAbi, } from '../../constants/abis.js';
 import { decodeFunctionResult } from '../../utils/abi/decodeFunctionResult.js';
 import { encodeFunctionData } from '../../utils/abi/encodeFunctionData.js';
 import { getChainContractAddress } from '../../utils/chain.js';
 import { trim } from '../../utils/data/trim.js';
 import { toHex } from '../../utils/encoding/toHex.js';
+import { isNullUniversalResolverError } from '../../utils/ens/errors.js';
 import { namehash } from '../../utils/ens/namehash.js';
 import { packetToBytes } from '../../utils/ens/packetToBytes.js';
 import { readContract, } from '../public/readContract.js';
-export async function getEnsAddress(client, { blockNumber, blockTag, name, universalResolverAddress: universalResolverAddress_, }) {
+/**
+ * Gets address for ENS name.
+ *
+ * - Docs: https://viem.sh/docs/ens/actions/getEnsAddress.html
+ * - Examples: https://stackblitz.com/github/wagmi-dev/viem/tree/main/examples/ens
+ *
+ * Calls `resolve(bytes, bytes)` on ENS Universal Resolver Contract.
+ *
+ * Since ENS names prohibit certain forbidden characters (e.g. underscore) and have other validation rules, you likely want to [normalize ENS names](https://docs.ens.domains/contract-api-reference/name-processing#normalising-names) with [UTS-46 normalization](https://unicode.org/reports/tr46) before passing them to `getEnsAddress`. You can use the built-in [`normalize`](https://viem.sh/docs/ens/utilities/normalize.html) function for this.
+ *
+ * @param client - Client to use
+ * @param parameters - {@link GetEnsAddressParameters}
+ * @returns Address for ENS name or `null` if not found. {@link GetEnsAddressReturnType}
+ *
+ * @example
+ * import { createPublicClient, http } from 'viem'
+ * import { mainnet } from 'viem/chains'
+ * import { getEnsAddress, normalize } from 'viem/ens'
+ *
+ * const client = createPublicClient({
+ *   chain: mainnet,
+ *   transport: http(),
+ * })
+ * const ensAddress = await getEnsAddress(client, {
+ *   name: normalize('wagmi-dev.eth'),
+ * })
+ * // '0xd2135CfB216b74109775236E36d4b433F1DF507B'
+ */
+export async function getEnsAddress(client, { blockNumber, blockTag, coinType, name, universalResolverAddress: universalResolverAddress_, }) {
     let universalResolverAddress = universalResolverAddress_;
     if (!universalResolverAddress) {
         if (!client.chain)
@@ -18,28 +47,40 @@ export async function getEnsAddress(client, { blockNumber, blockTag, name, unive
             contract: 'ensUniversalResolver',
         });
     }
-    const res = await readContract(client, {
-        address: universalResolverAddress,
-        abi: universalResolverAbi,
-        functionName: 'resolve',
-        args: [
-            toHex(packetToBytes(name)),
-            encodeFunctionData({
-                abi: singleAddressResolverAbi,
-                functionName: 'addr',
-                args: [namehash(name)],
-            }),
-        ],
-        blockNumber,
-        blockTag,
-    });
-    if (res[0] === '0x')
-        return null;
-    const address = decodeFunctionResult({
-        abi: singleAddressResolverAbi,
-        functionName: 'addr',
-        data: res[0],
-    });
-    return trim(address) === '0x00' ? null : address;
+    try {
+        const functionData = encodeFunctionData({
+            abi: addressResolverAbi,
+            functionName: 'addr',
+            ...(coinType != null
+                ? { args: [namehash(name), BigInt(coinType)] }
+                : { args: [namehash(name)] }),
+        });
+        const res = await readContract(client, {
+            address: universalResolverAddress,
+            abi: universalResolverResolveAbi,
+            functionName: 'resolve',
+            args: [toHex(packetToBytes(name)), functionData],
+            blockNumber,
+            blockTag,
+        });
+        if (res[0] === '0x')
+            return null;
+        const address = decodeFunctionResult({
+            abi: addressResolverAbi,
+            args: coinType != null ? [namehash(name), BigInt(coinType)] : undefined,
+            functionName: 'addr',
+            data: res[0],
+        });
+        if (address === '0x')
+            return null;
+        if (trim(address) === '0x00')
+            return null;
+        return address;
+    }
+    catch (err) {
+        if (isNullUniversalResolverError(err, 'resolve'))
+            return null;
+        throw err;
+    }
 }
 //# sourceMappingURL=getEnsAddress.js.map

package/dist/esm/actions/ens/getEnsAddress.js.map

@@ -1 +1 @@
-{"version":3,"file":"getEnsAddress.js","sourceRoot":"","sources":["../../../../src/actions/ens/getEnsAddress.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,yBAAyB,CAAA;AAGhC,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAA;AAC9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAA;AAC1E,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAA;AAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAA;AAC/C,OAAO,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAA;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAA;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAA;AAChE,OAAO,EAEL,YAAY,GACb,MAAM,2BAA2B,CAAA;AAyClC,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAuC,EACvC,EACE,WAAW,EACX,QAAQ,EACR,IAAI,EACJ,wBAAwB,EAAE,yBAAyB,GAC3B;IAE1B,IAAI,wBAAwB,GAAG,yBAAyB,CAAA;IACxD,IAAI,CAAC,wBAAwB,EAAE;QAC7B,IAAI,CAAC,MAAM,CAAC,KAAK;YACf,MAAM,IAAI,KAAK,CACb,oEAAoE,CACrE,CAAA;QAEH,wBAAwB,GAAG,uBAAuB,CAAC;YACjD,WAAW;YACX,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,QAAQ,EAAE,sBAAsB;SACjC,CAAC,CAAA;KACH;IAED,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,MAAM,EAAE;QACrC,OAAO,EAAE,wBAAwB;QACjC,GAAG,EAAE,oBAAoB;QACzB,YAAY,EAAE,SAAS;QACvB,IAAI,EAAE;YACJ,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;YAC1B,kBAAkB,CAAC;gBACjB,GAAG,EAAE,wBAAwB;gBAC7B,YAAY,EAAE,MAAM;gBACpB,IAAI,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;aACvB,CAAC;SACH;QACD,WAAW;QACX,QAAQ;KACT,CAAC,CAAA;IAEF,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI;QAAE,OAAO,IAAI,CAAA;IAEhC,MAAM,OAAO,GAAG,oBAAoB,CAAC;QACnC,GAAG,EAAE,wBAAwB;QAC7B,YAAY,EAAE,MAAM;QACpB,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;KACb,CAAC,CAAA;IAEF,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAA;AAClD,CAAC"}
+{"version":3,"file":"getEnsAddress.js","sourceRoot":"","sources":["../../../../src/actions/ens/getEnsAddress.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,kBAAkB,EAClB,2BAA2B,GAC5B,MAAM,yBAAyB,CAAA;AAGhC,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAA;AAC9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAA;AAC1E,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAA;AAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAA;AAC/C,OAAO,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAA;AACrD,OAAO,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAA;AACxE,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAA;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAA;AAChE,OAAO,EAEL,YAAY,GACb,MAAM,2BAA2B,CAAA;AAelC;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAiC,EACjC,EACE,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,IAAI,EACJ,wBAAwB,EAAE,yBAAyB,GAC3B;IAE1B,IAAI,wBAAwB,GAAG,yBAAyB,CAAA;IACxD,IAAI,CAAC,wBAAwB,EAAE;QAC7B,IAAI,CAAC,MAAM,CAAC,KAAK;YACf,MAAM,IAAI,KAAK,CACb,oEAAoE,CACrE,CAAA;QAEH,wBAAwB,GAAG,uBAAuB,CAAC;YACjD,WAAW;YACX,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,QAAQ,EAAE,sBAAsB;SACjC,CAAC,CAAA;KACH;IAED,IAAI;QACF,MAAM,YAAY,GAAG,kBAAkB,CAAC;YACtC,GAAG,EAAE,kBAAkB;YACvB,YAAY,EAAE,MAAM;YACpB,GAAG,CAAC,QAAQ,IAAI,IAAI;gBAClB,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE;gBAC9C,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;SAChC,CAAC,CAAA;QAEF,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,MAAM,EAAE;YACrC,OAAO,EAAE,wBAAwB;YACjC,GAAG,EAAE,2BAA2B;YAChC,YAAY,EAAE,SAAS;YACvB,IAAI,EAAE,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,EAAE,YAAY,CAAC;YAChD,WAAW;YACX,QAAQ;SACT,CAAC,CAAA;QAEF,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI;YAAE,OAAO,IAAI,CAAA;QAEhC,MAAM,OAAO,GAAG,oBAAoB,CAAC;YACnC,GAAG,EAAE,kBAAkB;YACvB,IAAI,EAAE,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS;YACvE,YAAY,EAAE,MAAM;YACpB,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;SACb,CAAC,CAAA;QAEF,IAAI,OAAO,KAAK,IAAI;YAAE,OAAO,IAAI,CAAA;QACjC,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,MAAM;YAAE,OAAO,IAAI,CAAA;QACzC,OAAO,OAAO,CAAA;KACf;IAAC,OAAO,GAAG,EAAE;QACZ,IAAI,4BAA4B,CAAC,GAAG,EAAE,SAAS,CAAC;YAAE,OAAO,IAAI,CAAA;QAC7D,MAAM,GAAG,CAAA;KACV;AACH,CAAC"}

package/dist/esm/actions/ens/getEnsAvatar.js

@@ -1,5 +1,33 @@
 import { parseAvatarRecord } from '../../utils/ens/avatar/parseAvatarRecord.js';
 import { getEnsText } from './getEnsText.js';
+/**
+ * Gets the avatar of an ENS name.
+ *
+ * - Docs: https://viem.sh/docs/ens/actions/getEnsAvatar.html
+ * - Examples: https://stackblitz.com/github/wagmi-dev/viem/tree/main/examples/ens
+ *
+ * Calls [`getEnsText`](https://viem.sh/docs/ens/actions/getEnsText.html) with `key` set to `'avatar'`.
+ *
+ * Since ENS names prohibit certain forbidden characters (e.g. underscore) and have other validation rules, you likely want to [normalize ENS names](https://docs.ens.domains/contract-api-reference/name-processing#normalising-names) with [UTS-46 normalization](https://unicode.org/reports/tr46) before passing them to `getEnsAddress`. You can use the built-in [`normalize`](https://viem.sh/docs/ens/utilities/normalize.html) function for this.
+ *
+ * @param client - Client to use
+ * @param parameters - {@link GetEnsAvatarParameters}
+ * @returns Avatar URI or `null` if not found. {@link GetEnsAvatarReturnType}
+ *
+ * @example
+ * import { createPublicClient, http } from 'viem'
+ * import { mainnet } from 'viem/chains'
+ * import { getEnsAvatar, normalize } from 'viem/ens'
+ *
+ * const client = createPublicClient({
+ *   chain: mainnet,
+ *   transport: http(),
+ * })
+ * const ensAvatar = await getEnsAvatar(client, {
+ *   name: normalize('wagmi-dev.eth'),
+ * })
+ * // 'https://ipfs.io/ipfs/Qma8mnp6xV3J2cRNf3mTth5C8nV11CAnceVinc3y8jSbio'
+ */
 export async function getEnsAvatar(client, { blockNumber, blockTag, gatewayUrls, name, universalResolverAddress, }) {
     const record = await getEnsText(client, {
         blockNumber,

package/dist/esm/actions/ens/getEnsAvatar.js.map

@@ -1 +1 @@
-{"version":3,"file":"getEnsAvatar.js","sourceRoot":"","sources":["../../../../src/actions/ens/getEnsAvatar.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,iBAAiB,EAAE,MAAM,6CAA6C,CAAA;AAE/E,OAAO,EAA6B,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAuCvE,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAuC,EACvC,EACE,WAAW,EACX,QAAQ,EACR,WAAW,EACX,IAAI,EACJ,wBAAwB,GACD;IAEzB,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,MAAM,EAAE;QACtC,WAAW;QACX,QAAQ;QACR,GAAG,EAAE,QAAQ;QACb,IAAI;QACJ,wBAAwB;KACzB,CAAC,CAAA;IACF,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAA;IACxB,IAAI;QACF,OAAO,MAAM,iBAAiB,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAA;KAChE;IAAC,MAAM;QACN,OAAO,IAAI,CAAA;KACZ;AACH,CAAC"}
+{"version":3,"file":"getEnsAvatar.js","sourceRoot":"","sources":["../../../../src/actions/ens/getEnsAvatar.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,iBAAiB,EAAE,MAAM,6CAA6C,CAAA;AAE/E,OAAO,EAA6B,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAWvE;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAiC,EACjC,EACE,WAAW,EACX,QAAQ,EACR,WAAW,EACX,IAAI,EACJ,wBAAwB,GACD;IAEzB,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,MAAM,EAAE;QACtC,WAAW;QACX,QAAQ;QACR,GAAG,EAAE,QAAQ;QACb,IAAI;QACJ,wBAAwB;KACzB,CAAC,CAAA;IACF,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAA;IACxB,IAAI;QACF,OAAO,MAAM,iBAAiB,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAA;KAChE;IAAC,MAAM;QACN,OAAO,IAAI,CAAA;KACZ;AACH,CAAC"}

package/dist/esm/actions/ens/getEnsName.js

@@ -1,9 +1,35 @@
-import { panicReasons } from '../../constants/solidity.js';
-import { ContractFunctionExecutionError, } from '../../errors/contract.js';
+import { universalResolverReverseAbi } from '../../constants/abis.js';
 import { getChainContractAddress } from '../../utils/chain.js';
 import { toHex } from '../../utils/encoding/toHex.js';
+import { isNullUniversalResolverError } from '../../utils/ens/errors.js';
 import { packetToBytes } from '../../utils/ens/packetToBytes.js';
 import { readContract, } from '../public/readContract.js';
+/**
+ * Gets primary name for specified address.
+ *
+ * - Docs: https://viem.sh/docs/ens/actions/getEnsName.html
+ * - Examples: https://stackblitz.com/github/wagmi-dev/viem/tree/main/examples/ens
+ *
+ * Calls `reverse(bytes)` on ENS Universal Resolver Contract to "reverse resolve" the address to the primary ENS name.
+ *
+ * @param client - Client to use
+ * @param parameters - {@link GetEnsNameParameters}
+ * @returns Name or `null` if not found. {@link GetEnsNameReturnType}
+ *
+ * @example
+ * import { createPublicClient, http } from 'viem'
+ * import { mainnet } from 'viem/chains'
+ * import { getEnsName } from 'viem/ens'
+ *
+ * const client = createPublicClient({
+ *   chain: mainnet,
+ *   transport: http(),
+ * })
+ * const ensName = await getEnsName(client, {
+ *   address: '0xd2135CfB216b74109775236E36d4b433F1DF507B',
+ * })
+ * // 'wagmi-dev.eth'
+ */
 export async function getEnsName(client, { address, blockNumber, blockTag, universalResolverAddress: universalResolverAddress_, }) {
     let universalResolverAddress = universalResolverAddress_;
     if (!universalResolverAddress) {
@@ -19,20 +45,7 @@ export async function getEnsName(client, { address, blockNumber, blockTag, unive
     try {
         const res = await readContract(client, {
             address: universalResolverAddress,
-            abi: [
-                {
-                    name: 'reverse',
-                    type: 'function',
-                    stateMutability: 'view',
-                    inputs: [{ type: 'bytes', name: 'reverseName' }],
-                    outputs: [
-                        { type: 'string', name: 'resolvedName' },
-                        { type: 'address', name: 'resolvedAddress' },
-                        { type: 'address', name: 'reverseResolver' },
-                        { type: 'address', name: 'resolver' },
-                    ],
-                },
-            ],
+            abi: universalResolverReverseAbi,
             functionName: 'reverse',
             args: [toHex(packetToBytes(reverseNode))],
             blockNumber,
@@ -40,11 +53,10 @@ export async function getEnsName(client, { address, blockNumber, blockTag, unive
         });
         return res[0];
     }
-    catch (error) {
-        if (error instanceof ContractFunctionExecutionError &&
-            error.cause.reason === panicReasons[50])
+    catch (err) {
+        if (isNullUniversalResolverError(err, 'reverse'))
             return null;
-        throw error;
+        throw err;
     }
 }
 //# sourceMappingURL=getEnsName.js.map

package/dist/esm/actions/ens/getEnsName.js.map

@@ -1 +1 @@
-{"version":3,"file":"getEnsName.js","sourceRoot":"","sources":["../../../../src/actions/ens/getEnsName.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAC1D,OAAO,EACL,8BAA8B,GAE/B,MAAM,0BAA0B,CAAA;AAGjC,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAA;AAC9D,OAAO,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAA;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAA;AAChE,OAAO,EAEL,YAAY,GACb,MAAM,2BAA2B,CAAA;AAuClC,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,MAAuC,EACvC,EACE,OAAO,EACP,WAAW,EACX,QAAQ,EACR,wBAAwB,EAAE,yBAAyB,GAC9B;IAEvB,IAAI,wBAAwB,GAAG,yBAAyB,CAAA;IACxD,IAAI,CAAC,wBAAwB,EAAE;QAC7B,IAAI,CAAC,MAAM,CAAC,KAAK;YACf,MAAM,IAAI,KAAK,CACb,oEAAoE,CACrE,CAAA;QAEH,wBAAwB,GAAG,uBAAuB,CAAC;YACjD,WAAW;YACX,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,QAAQ,EAAE,sBAAsB;SACjC,CAAC,CAAA;KACH;IAED,MAAM,WAAW,GAAG,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,eAAe,CAAA;IACxE,IAAI;QACF,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,MAAM,EAAE;YACrC,OAAO,EAAE,wBAAwB;YACjC,GAAG,EAAE;gBACH;oBACE,IAAI,EAAE,SAAS;oBACf,IAAI,EAAE,UAAU;oBAChB,eAAe,EAAE,MAAM;oBACvB,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;oBAChD,OAAO,EAAE;wBACP,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,EAAE;wBACxC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,iBAAiB,EAAE;wBAC5C,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,iBAAiB,EAAE;wBAC5C,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE;qBACtC;iBACF;aACF;YACD,YAAY,EAAE,SAAS;YACvB,IAAI,EAAE,CAAC,KAAK,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC;YACzC,WAAW;YACX,QAAQ;SACT,CAAC,CAAA;QACF,OAAO,GAAG,CAAC,CAAC,CAAC,CAAA;KACd;IAAC,OAAO,KAAK,EAAE;QACd,IACE,KAAK,YAAY,8BAA8B;YAC9C,KAAK,CAAC,KAAuC,CAAC,MAAM,KAAK,YAAY,CAAC,EAAE,CAAC;YAG1E,OAAO,IAAI,CAAA;QACb,MAAM,KAAK,CAAA;KACZ;AACH,CAAC"}
+{"version":3,"file":"getEnsName.js","sourceRoot":"","sources":["../../../../src/actions/ens/getEnsName.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAA;AAGrE,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAA;AAC9D,OAAO,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAA;AACrD,OAAO,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAA;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAA;AAChE,OAAO,EAEL,YAAY,GACb,MAAM,2BAA2B,CAAA;AAalC;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,MAAiC,EACjC,EACE,OAAO,EACP,WAAW,EACX,QAAQ,EACR,wBAAwB,EAAE,yBAAyB,GAC9B;IAEvB,IAAI,wBAAwB,GAAG,yBAAyB,CAAA;IACxD,IAAI,CAAC,wBAAwB,EAAE;QAC7B,IAAI,CAAC,MAAM,CAAC,KAAK;YACf,MAAM,IAAI,KAAK,CACb,oEAAoE,CACrE,CAAA;QAEH,wBAAwB,GAAG,uBAAuB,CAAC;YACjD,WAAW;YACX,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,QAAQ,EAAE,sBAAsB;SACjC,CAAC,CAAA;KACH;IAED,MAAM,WAAW,GAAG,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,eAAe,CAAA;IACxE,IAAI;QACF,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,MAAM,EAAE;YACrC,OAAO,EAAE,wBAAwB;YACjC,GAAG,EAAE,2BAA2B;YAChC,YAAY,EAAE,SAAS;YACvB,IAAI,EAAE,CAAC,KAAK,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC;YACzC,WAAW;YACX,QAAQ;SACT,CAAC,CAAA;QACF,OAAO,GAAG,CAAC,CAAC,CAAC,CAAA;KACd;IAAC,OAAO,GAAG,EAAE;QACZ,IAAI,4BAA4B,CAAC,GAAG,EAAE,SAAS,CAAC;YAAE,OAAO,IAAI,CAAA;QAC7D,MAAM,GAAG,CAAA;KACV;AACH,CAAC"}

package/dist/esm/actions/ens/getEnsResolver.js

@@ -2,6 +2,34 @@ import { getChainContractAddress } from '../../utils/chain.js';
 import { toHex } from '../../utils/encoding/toHex.js';
 import { packetToBytes } from '../../utils/ens/packetToBytes.js';
 import { readContract, } from '../public/readContract.js';
+/**
+ * Gets resolver for ENS name.
+ *
+ * - Docs: https://viem.sh/docs/ens/actions/getEnsResolver.html
+ * - Examples: https://stackblitz.com/github/wagmi-dev/viem/tree/main/examples/ens
+ *
+ * Calls `findResolver(bytes)` on ENS Universal Resolver Contract to retrieve the resolver of an ENS name.
+ *
+ * Since ENS names prohibit certain forbidden characters (e.g. underscore) and have other validation rules, you likely want to [normalize ENS names](https://docs.ens.domains/contract-api-reference/name-processing#normalising-names) with [UTS-46 normalization](https://unicode.org/reports/tr46) before passing them to `getEnsAddress`. You can use the built-in [`normalize`](https://viem.sh/docs/ens/utilities/normalize.html) function for this.
+ *
+ * @param client - Client to use
+ * @param parameters - {@link GetEnsResolverParameters}
+ * @returns Address for ENS resolver. {@link GetEnsResolverReturnType}
+ *
+ * @example
+ * import { createPublicClient, http } from 'viem'
+ * import { mainnet } from 'viem/chains'
+ * import { getEnsResolver, normalize } from 'viem/ens'
+ *
+ * const client = createPublicClient({
+ *   chain: mainnet,
+ *   transport: http(),
+ * })
+ * const resolverAddress = await getEnsResolver(client, {
+ *   name: normalize('wagmi-dev.eth'),
+ * })
+ * // '0x4976fb03C32e5B8cfe2b6cCB31c09Ba78EBaBa41'
+ */
 export async function getEnsResolver(client, { blockNumber, blockTag, name, universalResolverAddress: universalResolverAddress_, }) {
     let universalResolverAddress = universalResolverAddress_;
     if (!universalResolverAddress) {

package/dist/esm/actions/ens/getEnsResolver.js.map

@@ -1 +1 @@
-{"version":3,"file":"getEnsResolver.js","sourceRoot":"","sources":["../../../../src/actions/ens/getEnsResolver.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAA;AAC9D,OAAO,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAA;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAA;AAChE,OAAO,EAEL,YAAY,GACb,MAAM,2BAA2B,CAAA;AAyClC,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAuC,EACvC,EACE,WAAW,EACX,QAAQ,EACR,IAAI,EACJ,wBAAwB,EAAE,yBAAyB,GAC1B;IAE3B,IAAI,wBAAwB,GAAG,yBAAyB,CAAA;IACxD,IAAI,CAAC,wBAAwB,EAAE;QAC7B,IAAI,CAAC,MAAM,CAAC,KAAK;YACf,MAAM,IAAI,KAAK,CACb,oEAAoE,CACrE,CAAA;QAEH,wBAAwB,GAAG,uBAAuB,CAAC;YACjD,WAAW;YACX,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,QAAQ,EAAE,sBAAsB;SACjC,CAAC,CAAA;KACH;IAED,MAAM,CAAC,eAAe,CAAC,GAAG,MAAM,YAAY,CAAC,MAAM,EAAE;QACnD,OAAO,EAAE,wBAAwB;QACjC,GAAG,EAAE;YACH;gBACE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;gBAC3B,IAAI,EAAE,cAAc;gBACpB,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;gBACnD,eAAe,EAAE,MAAM;gBACvB,IAAI,EAAE,UAAU;aACjB;SACF;QACD,YAAY,EAAE,cAAc;QAC5B,IAAI,EAAE,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;QAClC,WAAW;QACX,QAAQ;KACT,CAAC,CAAA;IACF,OAAO,eAAe,CAAA;AACxB,CAAC"}
+{"version":3,"file":"getEnsResolver.js","sourceRoot":"","sources":["../../../../src/actions/ens/getEnsResolver.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAA;AAC9D,OAAO,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAA;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAA;AAChE,OAAO,EAEL,YAAY,GACb,MAAM,2BAA2B,CAAA;AAalC;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAiC,EACjC,EACE,WAAW,EACX,QAAQ,EACR,IAAI,EACJ,wBAAwB,EAAE,yBAAyB,GAC1B;IAE3B,IAAI,wBAAwB,GAAG,yBAAyB,CAAA;IACxD,IAAI,CAAC,wBAAwB,EAAE;QAC7B,IAAI,CAAC,MAAM,CAAC,KAAK;YACf,MAAM,IAAI,KAAK,CACb,oEAAoE,CACrE,CAAA;QAEH,wBAAwB,GAAG,uBAAuB,CAAC;YACjD,WAAW;YACX,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,QAAQ,EAAE,sBAAsB;SACjC,CAAC,CAAA;KACH;IAED,MAAM,CAAC,eAAe,CAAC,GAAG,MAAM,YAAY,CAAC,MAAM,EAAE;QACnD,OAAO,EAAE,wBAAwB;QACjC,GAAG,EAAE;YACH;gBACE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;gBAC3B,IAAI,EAAE,cAAc;gBACpB,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;gBACnD,eAAe,EAAE,MAAM;gBACvB,IAAI,EAAE,UAAU;aACjB;SACF;QACD,YAAY,EAAE,cAAc;QAC5B,IAAI,EAAE,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;QAClC,WAAW;QACX,QAAQ;KACT,CAAC,CAAA;IACF,OAAO,eAAe,CAAA;AACxB,CAAC"}

package/dist/esm/actions/ens/getEnsText.js

@@ -1,11 +1,41 @@
-import { textResolverAbi, universalResolverAbi } from '../../constants/abis.js';
+import { textResolverAbi, universalResolverResolveAbi, } from '../../constants/abis.js';
 import { decodeFunctionResult } from '../../utils/abi/decodeFunctionResult.js';
 import { encodeFunctionData } from '../../utils/abi/encodeFunctionData.js';
 import { getChainContractAddress } from '../../utils/chain.js';
 import { toHex } from '../../utils/encoding/toHex.js';
+import { isNullUniversalResolverError } from '../../utils/ens/errors.js';
 import { namehash } from '../../utils/ens/namehash.js';
 import { packetToBytes } from '../../utils/ens/packetToBytes.js';
 import { readContract, } from '../public/readContract.js';
+/**
+ * Gets a text record for specified ENS name.
+ *
+ * - Docs: https://viem.sh/docs/ens/actions/getEnsResolver.html
+ * - Examples: https://stackblitz.com/github/wagmi-dev/viem/tree/main/examples/ens
+ *
+ * Calls `resolve(bytes, bytes)` on ENS Universal Resolver Contract.
+ *
+ * Since ENS names prohibit certain forbidden characters (e.g. underscore) and have other validation rules, you likely want to [normalize ENS names](https://docs.ens.domains/contract-api-reference/name-processing#normalising-names) with [UTS-46 normalization](https://unicode.org/reports/tr46) before passing them to `getEnsAddress`. You can use the built-in [`normalize`](https://viem.sh/docs/ens/utilities/normalize.html) function for this.
+ *
+ * @param client - Client to use
+ * @param parameters - {@link GetEnsTextParameters}
+ * @returns Address for ENS resolver. {@link GetEnsTextReturnType}
+ *
+ * @example
+ * import { createPublicClient, http } from 'viem'
+ * import { mainnet } from 'viem/chains'
+ * import { getEnsText, normalize } from 'viem/ens'
+ *
+ * const client = createPublicClient({
+ *   chain: mainnet,
+ *   transport: http(),
+ * })
+ * const twitterRecord = await getEnsText(client, {
+ *   name: normalize('wagmi-dev.eth'),
+ *   key: 'com.twitter',
+ * })
+ * // 'wagmi_sh'
+ */
 export async function getEnsText(client, { blockNumber, blockTag, name, key, universalResolverAddress: universalResolverAddress_, }) {
     let universalResolverAddress = universalResolverAddress_;
     if (!universalResolverAddress) {
@@ -17,28 +47,35 @@ export async function getEnsText(client, { blockNumber, blockTag, name, key, uni
             contract: 'ensUniversalResolver',
         });
     }
-    const res = await readContract(client, {
-        address: universalResolverAddress,
-        abi: universalResolverAbi,
-        functionName: 'resolve',
-        args: [
-            toHex(packetToBytes(name)),
-            encodeFunctionData({
-                abi: textResolverAbi,
-                functionName: 'text',
-                args: [namehash(name), key],
-            }),
-        ],
-        blockNumber,
-        blockTag,
-    });
-    if (res[0] === '0x')
-        return null;
-    const record = decodeFunctionResult({
-        abi: textResolverAbi,
-        functionName: 'text',
-        data: res[0],
-    });
-    return record === '' ? null : record;
+    try {
+        const res = await readContract(client, {
+            address: universalResolverAddress,
+            abi: universalResolverResolveAbi,
+            functionName: 'resolve',
+            args: [
+                toHex(packetToBytes(name)),
+                encodeFunctionData({
+                    abi: textResolverAbi,
+                    functionName: 'text',
+                    args: [namehash(name), key],
+                }),
+            ],
+            blockNumber,
+            blockTag,
+        });
+        if (res[0] === '0x')
+            return null;
+        const record = decodeFunctionResult({
+            abi: textResolverAbi,
+            functionName: 'text',
+            data: res[0],
+        });
+        return record === '' ? null : record;
+    }
+    catch (err) {
+        if (isNullUniversalResolverError(err, 'resolve'))
+            return null;
+        throw err;
+    }
 }
 //# sourceMappingURL=getEnsText.js.map

package/dist/esm/actions/ens/getEnsText.js.map

@@ -1 +1 @@
-{"version":3,"file":"getEnsText.js","sourceRoot":"","sources":["../../../../src/actions/ens/getEnsText.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAA;AAG/E,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAA;AAC9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAA;AAC1E,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAA;AAC9D,OAAO,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAA;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAA;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAA;AAChE,OAAO,EAEL,YAAY,GACb,MAAM,2BAA2B,CAAA;AA4ClC,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,MAAuC,EACvC,EACE,WAAW,EACX,QAAQ,EACR,IAAI,EACJ,GAAG,EACH,wBAAwB,EAAE,yBAAyB,GAC9B;IAEvB,IAAI,wBAAwB,GAAG,yBAAyB,CAAA;IACxD,IAAI,CAAC,wBAAwB,EAAE;QAC7B,IAAI,CAAC,MAAM,CAAC,KAAK;YACf,MAAM,IAAI,KAAK,CACb,oEAAoE,CACrE,CAAA;QAEH,wBAAwB,GAAG,uBAAuB,CAAC;YACjD,WAAW;YACX,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,QAAQ,EAAE,sBAAsB;SACjC,CAAC,CAAA;KACH;IAED,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,MAAM,EAAE;QACrC,OAAO,EAAE,wBAAwB;QACjC,GAAG,EAAE,oBAAoB;QACzB,YAAY,EAAE,SAAS;QACvB,IAAI,EAAE;YACJ,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;YAC1B,kBAAkB,CAAC;gBACjB,GAAG,EAAE,eAAe;gBACpB,YAAY,EAAE,MAAM;gBACpB,IAAI,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC;aAC5B,CAAC;SACH;QACD,WAAW;QACX,QAAQ;KACT,CAAC,CAAA;IAEF,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI;QAAE,OAAO,IAAI,CAAA;IAEhC,MAAM,MAAM,GAAG,oBAAoB,CAAC;QAClC,GAAG,EAAE,eAAe;QACpB,YAAY,EAAE,MAAM;QACpB,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;KACb,CAAC,CAAA;IAEF,OAAO,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAA;AACtC,CAAC"}
+{"version":3,"file":"getEnsText.js","sourceRoot":"","sources":["../../../../src/actions/ens/getEnsText.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,eAAe,EACf,2BAA2B,GAC5B,MAAM,yBAAyB,CAAA;AAGhC,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAA;AAC9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAA;AAC1E,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAA;AAC9D,OAAO,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAA;AACrD,OAAO,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAA;AACxE,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAA;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAA;AAChE,OAAO,EAEL,YAAY,GACb,MAAM,2BAA2B,CAAA;AAelC;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,MAAiC,EACjC,EACE,WAAW,EACX,QAAQ,EACR,IAAI,EACJ,GAAG,EACH,wBAAwB,EAAE,yBAAyB,GAC9B;IAEvB,IAAI,wBAAwB,GAAG,yBAAyB,CAAA;IACxD,IAAI,CAAC,wBAAwB,EAAE;QAC7B,IAAI,CAAC,MAAM,CAAC,KAAK;YACf,MAAM,IAAI,KAAK,CACb,oEAAoE,CACrE,CAAA;QAEH,wBAAwB,GAAG,uBAAuB,CAAC;YACjD,WAAW;YACX,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,QAAQ,EAAE,sBAAsB;SACjC,CAAC,CAAA;KACH;IAED,IAAI;QACF,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,MAAM,EAAE;YACrC,OAAO,EAAE,wBAAwB;YACjC,GAAG,EAAE,2BAA2B;YAChC,YAAY,EAAE,SAAS;YACvB,IAAI,EAAE;gBACJ,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;gBAC1B,kBAAkB,CAAC;oBACjB,GAAG,EAAE,eAAe;oBACpB,YAAY,EAAE,MAAM;oBACpB,IAAI,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC;iBAC5B,CAAC;aACH;YACD,WAAW;YACX,QAAQ;SACT,CAAC,CAAA;QAEF,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI;YAAE,OAAO,IAAI,CAAA;QAEhC,MAAM,MAAM,GAAG,oBAAoB,CAAC;YAClC,GAAG,EAAE,eAAe;YACpB,YAAY,EAAE,MAAM;YACpB,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;SACb,CAAC,CAAA;QAEF,OAAO,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAA;KACrC;IAAC,OAAO,GAAG,EAAE;QACZ,IAAI,4BAA4B,CAAC,GAAG,EAAE,SAAS,CAAC;YAAE,OAAO,IAAI,CAAA;QAC7D,MAAM,GAAG,CAAA;KACV;AACH,CAAC"}