admin: merged WIP branch

Author: ricmoo

CHANGELOG.md

@@ -3,6 +3,15 @@ Change Log
 
 This change log is maintained by `src.ts/_admin/update-changelog.ts` but may also be manually updated.
 
+ethers/v6.14.0 (2025-05-06 02:03)
+---------------------------------
+
+  - EIP-7702 support ([#4916](https://github.com/ethers-io/ethers.js/issues/4916); [db490e1](https://github.com/ethers-io/ethers.js/commit/db490e1afaaa139be9cb38e6b50a1bc4ef28e075), [e7c1bdf](https://github.com/ethers-io/ethers.js/commit/e7c1bdf6f0a5d6f976dddd6375e76445ac6851fc)).
+  - Added support for to override fetch init options in the Browser ([#3895](https://github.com/ethers-io/ethers.js/issues/3895); [844ae68](https://github.com/ethers-io/ethers.js/commit/844ae68a96deabc4d5f053dad5f1112b06f08d9a)).
+  - Added EIP-6963 discovery to BrowserProvider ([f5469dd](https://github.com/ethers-io/ethers.js/commit/f5469dd0e0719389d51e0106ee36d07a7ebef875)).
+  - Accept modern KZG library API while exposing legacy API ([#4841](https://github.com/ethers-io/ethers.js/issues/4841); [e5036e7](https://github.com/ethers-io/ethers.js/commit/e5036e778624fea957dd847f7be1a9f148b8997e)).
+  - Added CommunityResourcable to exports ([#4776](https://github.com/ethers-io/ethers.js/issues/4776); [bca8d1b](https://github.com/ethers-io/ethers.js/commit/bca8d1b549569e6f7793f07fcc46dfd731e37d2b)).
+
 ethers/v6.13.7 (2025-04-25 21:50)
 ---------------------------------
 

docs.wrm/links/projects.txt

@@ -1,5 +1,6 @@
 link-alchemy [Alchemy](https://alchemy.com/?a=ethers)
 link-ankr [Ankr](https://www.ankr.com)
+link-blockscout [Blockscout](https://www.blockscout.com)
 link-chainstack [Chainstack](https://chainstack.com)
 link-cloudflare [Cloudflare](https://developers.cloudflare.com/distributed-web/ethereum-gateway/)
 link-ens [ENS](https://ens.domains/)

docs.wrm/links/specs.txt

@@ -31,8 +31,10 @@ link-eip-2098 [EIP-2098](https://eips.ethereum.org/EIPS/eip-2098)
 link-eip-2304 [EIP-2304](https://eips.ethereum.org/EIPS/eip-2304)
 link-eip-2718 [EIP-2718](https://eips.ethereum.org/EIPS/eip-2718)
 link-eip-2930 [EIP-2930](https://eips.ethereum.org/EIPS/eip-2930)
-link-eip-4788 [EIP-4844](https://eips.ethereum.org/EIPS/eip-4788)
+link-eip-4788 [EIP-4788](https://eips.ethereum.org/EIPS/eip-4788)
 link-eip-4844 [EIP-4844](https://eips.ethereum.org/EIPS/eip-4844)
+link-eip-6963 [EIP-6963](https://eips.ethereum.org/EIPS/eip-6963)
+link-eip-7702 [EIP-7702](https://eips.ethereum.org/EIPS/eip-7702)
 
 # Open Standards
 link-base58 [Base58](https://en.bitcoinwiki.org/wiki/Base58)

src.ts/_tests/create-provider.ts

@@ -1,5 +1,6 @@
 import {
     AlchemyProvider,
+    BlockscoutProvider,
 //    AnkrProvider,
 //    CloudflareProvider,
     ChainstackProvider,
@@ -36,6 +37,15 @@ const ProviderCreators: Array<ProviderCreator> = [
             return new AlchemyProvider(network, "YrPw6SWb20vJDRFkhWq8aKnTQ8JRNRHM");
         }
     },
+    {
+        name: "BlockscoutProvider",
+        //networks: ethNetworks,  // @TODO: they are backfilling some Sepolia txs
+        networks: [ "mainnet" ],
+        create: function(network: string) {
+            //return new BlockscoutProvider(network);
+            return new BlockscoutProvider(network, "fdbfa288-1695-454e-a369-4501253a120");
+        }
+    },
     /*
     {
         name: "AnkrProvider",

src.ts/_tests/test-providers-data.ts

@@ -226,7 +226,7 @@ describe("Test Provider Transaction operations", function() {
             if (providerName === "CloudflareProvider" ||
               providerName === "AnkrProvider" ||
               providerName === "PocketProvider" ||
-              providerName === "AlchemyProvider") {
+              providerName === "BlockscoutProvider") {
                 test = Object.assign({ } , test, { root: undefined });
             }
 

src.ts/ethers.ts

@@ -49,6 +49,7 @@ export {
 export {
     id,
     ensNormalize, isValidName, namehash, dnsEncode,
+    hashAuthorization, verifyAuthorization,
     hashMessage, verifyMessage,
     solidityPacked, solidityPackedKeccak256, solidityPackedSha256,
     TypedDataEncoder,
@@ -69,9 +70,9 @@ export {
 
     BrowserProvider,
 
-    AlchemyProvider, AnkrProvider, ChainstackProvider, CloudflareProvider,
-    EtherscanProvider, InfuraProvider, InfuraWebSocketProvider, PocketProvider,
-    QuickNodeProvider,
+    AlchemyProvider, AnkrProvider, BlockscoutProvider, ChainstackProvider,
+    CloudflareProvider, EtherscanProvider, InfuraProvider,
+    InfuraWebSocketProvider, PocketProvider, QuickNodeProvider,
 
     IpcSocketProvider, SocketProvider, WebSocketProvider,
 
@@ -89,7 +90,7 @@ export {
 } from "./providers/index.js";
 
 export {
-    accessListify,
+    accessListify, authorizationify,
     computeAddress, recoverAddress,
     Transaction
 } from "./transaction/index.js";
@@ -159,26 +160,33 @@ export type {
 
 export type { ProgressCallback, SignatureLike } from "./crypto/index.js";
 
-export type { TypedDataDomain, TypedDataField } from "./hash/index.js";
+export type {
+    AuthorizationRequest, TypedDataDomain, TypedDataField
+} from "./hash/index.js";
 
 export type {
     Provider, Signer,
 
+    CommunityResourcable,
+
     AbstractProviderOptions, BrowserProviderOptions, FallbackProviderOptions,
 
-    AbstractProviderPlugin, BlockParams, BlockTag, ContractRunner, DebugEventBrowserProvider,
-    Eip1193Provider, EventFilter, Filter, FilterByBlockHash, GasCostParameters,
-    JsonRpcApiProviderOptions, JsonRpcError, JsonRpcPayload, JsonRpcResult,
-    JsonRpcTransactionRequest, LogParams, MinedBlock, MinedTransactionResponse, Networkish,
-    OrphanFilter, PerformActionFilter, PerformActionRequest, PerformActionTransaction,
-    PreparedTransactionRequest, ProviderEvent, Subscriber, Subscription, TopicFilter,
-    TransactionReceiptParams, TransactionRequest, TransactionResponseParams,
-    WebSocketCreator, WebSocketLike
+    AbstractProviderPlugin, BlockParams, BlockTag, BrowserDiscoverOptions,
+    ContractRunner, DebugEventBrowserProvider, Eip1193Provider,
+    Eip6963ProviderInfo, EventFilter, Filter, FilterByBlockHash,
+    GasCostParameters, JsonRpcApiProviderOptions, JsonRpcError,
+    JsonRpcPayload, JsonRpcResult, JsonRpcTransactionRequest, LogParams,
+    MinedBlock, MinedTransactionResponse, Networkish, OrphanFilter,
+    PerformActionFilter, PerformActionRequest, PerformActionTransaction,
+    PreparedTransactionRequest, ProviderEvent, Subscriber, Subscription,
+    TopicFilter, TransactionReceiptParams, TransactionRequest,
+    TransactionResponseParams, WebSocketCreator, WebSocketLike
 } from "./providers/index.js";
 
 export type {
     AccessList, AccessListish, AccessListEntry,
-    Blob, BlobLike, KzgLibrary,
+    Authorization, AuthorizationLike,
+    Blob, BlobLike, KzgLibrary, KzgLibraryLike,
     TransactionLike
 } from "./transaction/index.js";
 

src.ts/hash/authorization.ts

@@ -0,0 +1,38 @@
+import { getAddress } from "../address/index.js";
+import { keccak256 } from "../crypto/index.js";
+import { recoverAddress } from "../transaction/index.js";
+import {
+    assertArgument, concat, encodeRlp, toBeArray
+} from "../utils/index.js";
+
+import type { Addressable } from "../address/index.js";
+import type { SignatureLike } from "../crypto/index.js";
+import type { BigNumberish, Numeric } from "../utils/index.js";
+
+export interface AuthorizationRequest {
+    address: string | Addressable;
+    nonce?: Numeric;
+    chainId?: BigNumberish;
+}
+
+/**
+ *  Computes the [[link-eip-7702]] authorization digest to sign.
+ */
+export function hashAuthorization(auth: AuthorizationRequest): string {
+    assertArgument(typeof(auth.address) === "string", "invalid address for hashAuthorization", "auth.address", auth);
+    return keccak256(concat([
+        "0x05", encodeRlp([
+            (auth.chainId != null) ? toBeArray(auth.chainId): "0x",
+            getAddress(auth.address),
+            (auth.nonce != null) ? toBeArray(auth.nonce): "0x",
+        ])
+    ]));
+}
+
+/**
+ *  Return the address of the private key that produced
+ *  the signature %%sig%% during signing for %%message%%.
+ */
+export function verifyAuthorization(auth: AuthorizationRequest, sig: SignatureLike): string {
+    return recoverAddress(hashAuthorization(auth), sig);
+}

src.ts/hash/index.ts

@@ -5,6 +5,7 @@
  *  @_section: api/hashing:Hashing Utilities  [about-hashing]
  */
 
+export { hashAuthorization, verifyAuthorization } from "./authorization.js";
 export { id } from "./id.js"
 export { ensNormalize, isValidName, namehash, dnsEncode } from "./namehash.js";
 export { hashMessage, verifyMessage } from "./message.js";
@@ -13,4 +14,5 @@ export {
 } from "./solidity.js";
 export { TypedDataEncoder, verifyTypedData } from "./typed-data.js";
 
+export type { AuthorizationRequest } from "./authorization.js";
 export type { TypedDataDomain, TypedDataField } from "./typed-data.js";

src.ts/providers/abstract-signer.ts

@@ -14,15 +14,16 @@ import {
 
 import { copyRequest } from "./provider.js";
 
-import type { TypedDataDomain, TypedDataField } from "../hash/index.js";
-import type { TransactionLike } from "../transaction/index.js";
+import type {
+    AuthorizationRequest, TypedDataDomain, TypedDataField
+} from "../hash/index.js";
+import type { Authorization, TransactionLike } from "../transaction/index.js";
 
 import type {
     BlockTag, Provider, TransactionRequest, TransactionResponse
 } from "./provider.js";
 import type { Signer } from "./signer.js";
 
-
 function checkProvider(signer: AbstractSigner, operation: string): Provider {
     if (signer.provider) { return signer.provider; }
     assert(false, "missing provider", "UNSUPPORTED_OPERATION", { operation });
@@ -150,7 +151,11 @@ export abstract class AbstractSigner<P extends null | Provider = null | Provider
                     // The network supports EIP-1559!
 
                     // Upgrade transaction from null to eip-1559
-                    pop.type = 2;
+                    if (pop.authorizationList && pop.authorizationList.length) {
+                        pop.type = 4;
+                    } else {
+                        pop.type = 2;
+                    }
 
                     if (pop.gasPrice != null) {
                         // Using legacy gasPrice property on an eip-1559 network,
@@ -194,7 +199,7 @@ export abstract class AbstractSigner<P extends null | Provider = null | Provider
                         operation: "signer.getFeeData" });
                 }
 
-            } else if (pop.type === 2 || pop.type === 3) {
+            } else if (pop.type === 2 || pop.type === 3 || pop.type === 4) {
                 // Explicitly using EIP-1559 or EIP-4844
 
                 // Populate missing fee data
@@ -213,6 +218,21 @@ export abstract class AbstractSigner<P extends null | Provider = null | Provider
         return await resolveProperties(pop);
     }
 
+    async populateAuthorization(_auth: AuthorizationRequest): Promise<AuthorizationRequest> {
+        const auth = Object.assign({ }, _auth);
+
+        // Add a chain ID if not explicitly set to 0
+        if (auth.chainId == null) {
+            auth.chainId = (await checkProvider(this, "getNetwork").getNetwork()).chainId;
+        }
+
+        // @TODO: Take chain ID into account when populating noce?
+
+        if (auth.nonce == null) { auth.nonce = await this.getNonce(); }
+
+        return auth;
+    }
+
     async estimateGas(tx: TransactionRequest): Promise<bigint> {
         return checkProvider(this, "estimateGas").estimateGas(await this.populateCall(tx));
     }
@@ -235,6 +255,12 @@ export abstract class AbstractSigner<P extends null | Provider = null | Provider
         return await provider.broadcastTransaction(await this.signTransaction(txObj));
     }
 
+    // @TODO: in v7 move this to be abstract
+    authorize(authorization: AuthorizationRequest): Promise<Authorization> {
+        assert(false, "authorization not implemented for this signer",
+          "UNSUPPORTED_OPERATION", { operation: "authorize" });
+    }
+
     abstract signTransaction(tx: TransactionRequest): Promise<string>;
     abstract signMessage(message: string | Uint8Array): Promise<string>;
     abstract signTypedData(domain: TypedDataDomain, types: Record<string, Array<TypedDataField>>, value: Record<string, any>): Promise<string>;

src.ts/providers/default-provider.ts

@@ -3,6 +3,7 @@ import { assert } from "../utils/index.js";
 
 import { AnkrProvider } from "./provider-ankr.js";
 import { AlchemyProvider } from "./provider-alchemy.js";
+import { BlockscoutProvider } from "./provider-blockscout.js";
 import { ChainstackProvider } from "./provider-chainstack.js";
 import { CloudflareProvider } from "./provider-cloudflare.js";
 import { EtherscanProvider } from "./provider-etherscan.js";
@@ -121,6 +122,12 @@ export function getDefaultProvider(network?: string | Networkish | WebSocketLike
         } catch (error) { }
     }
 
+    if (allowService("blockscout")) {
+        try {
+            providers.push(new BlockscoutProvider(network, options.blockscout));
+        } catch (error) { }
+    }
+
     if (allowService("chainstack")) {
         try {
             providers.push(new ChainstackProvider(network, options.chainstack));

src.ts/providers/format.ts

@@ -214,6 +214,15 @@ export function formatTransactionResponse(value: any): TransactionResponseParams
         accessList: allowNull(accessListify, null),
         blobVersionedHashes: allowNull(arrayOf(formatHash, true), null),
 
+        authorizationList: allowNull(arrayOf((v: any) => {
+            return {
+                address: getAddress(v.address),
+                chainId: getBigInt(v.chainId),
+                nonce: getBigInt(v.nonce),
+                signature: Signature.from(v.signature ? v.signature: v)
+            };
+        }, false), null),
+
         blockHash: allowNull(formatHash, null),
         blockNumber: allowNull(getNumber, null),
         transactionIndex: allowNull(getNumber, null),

src.ts/providers/formatting.ts

@@ -5,7 +5,7 @@
  */
 
 import type { Signature } from "../crypto/index.js";
-import type { AccessList } from "../transaction/index.js";
+import type { Authorization, AccessList } from "../transaction/index.js";
 
 
 //////////////////////
@@ -283,6 +283,7 @@ export interface TransactionReceiptParams {
      *  post-byzantium blocks this is null.
      */
     root: null | string;
+
 }
 
 /*
@@ -406,7 +407,12 @@ export interface TransactionResponseParams {
     /**
      *  The [[link-eip-4844]] BLOb versioned hashes.
      */
-    blobVersionedHashes?: null | Array<string>;
+    blobVersionedHashes?: null | Array<string>;  // @TODO: drop the "?"? (v7)
+
+    /**
+     *  The [[link-eip-7702]] authorizations (if any).
+     */
+    authorizationList: null | Array<Authorization>;
 };
 
 

src.ts/providers/index.ts

@@ -60,6 +60,7 @@ export { JsonRpcApiProvider, JsonRpcProvider, JsonRpcSigner } from "./provider-j
 export { BrowserProvider } from "./provider-browser.js";
 
 export { AlchemyProvider } from "./provider-alchemy.js";
+export { BlockscoutProvider } from "./provider-blockscout.js";
 export { AnkrProvider } from "./provider-ankr.js";
 export { CloudflareProvider } from "./provider-cloudflare.js";
 export { ChainstackProvider } from "./provider-chainstack.js";
@@ -91,11 +92,11 @@ export type {
     TransactionResponseParams,
 } from "./formatting.js";
 
-/*
 export type {
     CommunityResourcable
 } from "./community.js";
 
+/*
 export type {
     AvatarLinkageType, AvatarLinkage, AvatarResult
 } from "./ens-resolver.js";
@@ -114,7 +115,8 @@ export type {
 } from "./provider.js";
 
 export type {
-    BrowserProviderOptions, DebugEventBrowserProvider, Eip1193Provider
+    BrowserDiscoverOptions, BrowserProviderOptions, DebugEventBrowserProvider,
+    Eip1193Provider, Eip6963ProviderInfo
 } from "./provider-browser.js";
 
 export type { FallbackProviderOptions } from "./provider-fallback.js";