@tetherto/wdk-wallet-evm 1.0.0-beta.11 → 1.0.0-beta.12

package/hardhat.config.cjs

@@ -4,6 +4,7 @@ require('@nomicfoundation/hardhat-ethers')
 module.exports = {
   networks: {
     hardhat: {
+      chainId: 1,
       hardfork: 'prague',
       accounts: {
         mnemonic: 'anger burst story spy face pattern whale quit delay fiction ball solve',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tetherto/wdk-wallet-evm",
-  "version": "1.0.0-beta.11",
+  "version": "1.0.0-beta.12",
   "description": "A simple package to manage BIP-32 wallets for evm blockchains.",
   "keywords": [
     "wdk",
@@ -30,7 +30,8 @@
     "@noble/curves": "1.9.2",
     "@noble/hashes": "1.8.0",
     "@noble/secp256k1": "2.2.3",
-    "@tetherto/wdk-wallet": "1.0.0-beta.7",
+    "@tetherto/wdk-failover-provider": "1.0.0-beta.2",
+    "@tetherto/wdk-wallet": "1.0.0-beta.8",
     "bare-node-runtime": "^1.1.4",
     "bip39": "3.1.0",
     "ethers": "6.14.4",
@@ -45,9 +46,14 @@
     "typescript": "5.8.3"
   },
   "overrides": {
+    "brace-expansion": "1.1.13",
     "cookie": "1.0.2",
+    "immutable": "4.3.8",
+    "picomatch@2": "2.3.2",
+    "serialize-javascript": ">=7.0.5",
     "tmp": "0.2.5",
-    "undici": "7.21.0"
+    "undici": ">=7.24.0",
+    "uuid": "14.0.0"
   },
   "exports": {
     ".": {

package/src/wallet-account-evm.js

@@ -147,6 +147,19 @@ export default class WalletAccountEvm extends WalletAccountReadOnlyEvm {
     return await this._account.signTypedData(domain, types, message)
   }
 
+  /**
+   * Signs a transaction.
+   *
+   * @param {EvmTransaction} tx - The transaction to sign.
+   * @returns {Promise<string>} The signed transaction as a hex string.
+   */
+  async signTransaction (tx) {
+    return await this._account.signTransaction({
+      from: await this.getAddress(),
+      ...tx
+    })
+  }
+
   /**
    * Sends a transaction.
    *
@@ -234,9 +247,11 @@ export default class WalletAccountEvm extends WalletAccountReadOnlyEvm {
    * @returns {Promise<WalletAccountReadOnlyEvm>} The read-only account.
    */
   async toReadOnlyAccount () {
-    const readOnlyAccount = new WalletAccountReadOnlyEvm(this._account.address, this._config)
+    if (!this._evmReadOnlyAccount) {
+      this._evmReadOnlyAccount = new WalletAccountReadOnlyEvm(this._account.address, this._config)
+    }
 
-    return readOnlyAccount
+    return this._evmReadOnlyAccount
   }
 
   /**

package/src/wallet-account-read-only-evm.js

@@ -20,6 +20,8 @@ import { BrowserProvider, Contract, Interface, JsonRpcProvider, Network, Signatu
 
 import { multicall } from './multicall.js'
 
+import FailoverProvider from '@tetherto/wdk-failover-provider'
+
 /** @typedef {import('ethers').Provider} Provider */
 /** @typedef {import('ethers').Eip1193Provider} Eip1193Provider */
 /** @typedef {import('ethers').TypedDataDomain} TypedDataDomain */
@@ -54,6 +56,7 @@ import { multicall } from './multicall.js'
  * @property {number | bigint} [maxPriorityFeePerGas] - The price (in wei) per unit of gas this transaction will allow in addition to the [EIP-1559](https://eips.ethereum.org/EIPS/eip-1559) block's base fee to bribe miners into giving this transaction priority. This is included in the maxFeePerGas, so this will not affect the total maximum cost set with maxFeePerGas.
  * @property {number} [type] - The transaction type (e.g. 4 for ERC-7702).
  * @property {number} [nonce] - The transaction nonce.
+ * @property {number | bigint} [chainId] - The chain ID of the network.
  * @property {AuthorizationLike[]} [authorizationList] - An optional list of ERC-7702 signed authorizations for type 4 transactions.
  */
 
@@ -67,7 +70,9 @@ import { multicall } from './multicall.js'
 
 /**
  * @typedef {Object} EvmWalletConfig
- * @property {string | Eip1193Provider} [provider] - The url of the rpc provider, or an instance of a class that implements eip-1193.
+ * @property {string | Eip1193Provider | Array<string | Eip1193Provider>} [provider] - The url of the rpc provider, or an instance of a class that implements eip-1193. It's also possible to provide an array of urls or EIP 1193 providers instead. In such case, connection errors will cause the wallet to automatically fallback on the next provider in the list.
+ * @property {number} [retries] - If set and if 'provider' is a list of urls or EIP 1193 providers, the number of additional retry attempts after the initial call fails. Total attempts = `1 + retries`. For example, `retries: 3` with 4 providers will try each provider once before throwing. If `retries` exceeds the number of providers, the failover will loop back and retry already-failed providers in round-robin order. Default: 3.
+ * @property {number} [chainId] - The chain ID of the network. When provided, skips automatic chain ID detection from the provider.
  * @property {number | bigint} [transferMaxFee] - The maximum fee amount for transfer operations.
  */
 
@@ -93,18 +98,36 @@ export default class WalletAccountReadOnlyEvm extends WalletAccountReadOnly {
      */
     this._config = config
 
-    const { provider } = config
-
-    if (provider) {
-      /**
-       * An ethers provider to interact with a node of the blockchain.
-       *
-       * @protected
-       * @type {Provider | undefined}
-       */
-      this._provider = typeof provider === 'string'
-        ? new JsonRpcProvider(provider, Network.from(config.chainId), { staticNetwork: true })
-        : new BrowserProvider(provider)
+    /**
+     * An ethers provider to interact with a node of the blockchain.
+     *
+     * @protected
+     * @type {Provider | undefined}
+     */
+    this._provider = undefined
+
+    const { provider, retries = 3 } = config
+    const network = config.chainId ? Network.from(config.chainId) : undefined
+    const providerOpts = config.chainId ? { staticNetwork: true } : undefined
+
+    if (Array.isArray(provider)) {
+      if (provider.length > 0) {
+        const failoverProvider = new FailoverProvider({ retries })
+
+        for (const entry of provider) {
+          const option = typeof entry === 'string'
+            ? new JsonRpcProvider(entry, network, providerOpts)
+            : new BrowserProvider(entry)
+          failoverProvider.addProvider(option)
+        }
+
+        this._provider = failoverProvider.initialize()
+      }
+    } else if (provider) {
+      this._provider =
+        typeof provider === 'string'
+          ? new JsonRpcProvider(provider, network, providerOpts)
+          : new BrowserProvider(provider)
     }
   }
 

package/src/wallet-manager-evm.js

@@ -18,6 +18,8 @@ import WalletManager from '@tetherto/wdk-wallet'
 
 import { BrowserProvider, JsonRpcProvider } from 'ethers'
 
+import FailoverProvider from '@tetherto/wdk-failover-provider'
+
 import WalletAccountEvm from './wallet-account-evm.js'
 
 /** @typedef {import('ethers').Provider} Provider */
@@ -60,18 +62,34 @@ export default class WalletManagerEvm extends WalletManager {
      */
     this._config = config
 
-    const { provider } = config
-
-    if (provider) {
-      /**
-       * An ethers provider to interact with a node of the blockchain.
-       *
-       * @protected
-       * @type {Provider | undefined}
-       */
-      this._provider = typeof provider === 'string'
-        ? new JsonRpcProvider(provider)
-        : new BrowserProvider(provider)
+    /**
+     * An ethers provider to interact with a node of the blockchain.
+     *
+     * @protected
+     * @type {Provider | undefined}
+     */
+    this._provider = undefined
+
+    const { provider, retries = 3 } = config
+
+    if (Array.isArray(provider)) {
+      if (provider.length > 0) {
+        const failoverProvider = new FailoverProvider({ retries })
+
+        for (const entry of provider) {
+          const option = typeof entry === 'string'
+            ? new JsonRpcProvider(entry)
+            : new BrowserProvider(entry)
+          failoverProvider.addProvider(option)
+        }
+
+        this._provider = failoverProvider.initialize()
+      }
+    } else if (provider) {
+      this._provider =
+        typeof provider === 'string'
+          ? new JsonRpcProvider(provider)
+          : new BrowserProvider(provider)
     }
   }
 

package/types/src/wallet-account-evm.d.ts

@@ -54,6 +54,13 @@ export default class WalletAccountEvm extends WalletAccountReadOnlyEvm implement
      * @returns {Promise<string>} The typed data signature.
      */
     signTypedData({ domain, types, message }: TypedData): Promise<string>;
+    /**
+     * Signs a transaction.
+     *
+     * @param {EvmTransaction} tx - The transaction to sign.
+     * @returns {Promise<string>} The signed transaction as a hex string.
+     */
+    signTransaction(tx: EvmTransaction): Promise<string>;
     /**
      * Sends a transaction.
      *

package/types/src/wallet-account-read-only-evm.d.ts

@@ -176,6 +176,10 @@ export type EvmTransaction = {
      * - The transaction nonce.
      */
     nonce?: number;
+    /**
+     * - The chain ID of the network.
+     */
+    chainId?: number | bigint;
     /**
      * - An optional list of ERC-7702 signed authorizations for type 4 transactions.
      */
@@ -201,9 +205,17 @@ export type EvmTransferOptions = {
 };
 export type EvmWalletConfig = {
     /**
-     * - The url of the rpc provider, or an instance of a class that implements eip-1193.
+     * - The url of the rpc provider, or an instance of a class that implements eip-1193. It's also possible to provide an array of urls or EIP 1193 providers instead. In such case, connection errors will cause the wallet to automatically fallback on the next provider in the list. 
+     */
+    provider?: string | Eip1193Provider | Array<string | Eip1193Provider>;
+    /**
+     * - If set and if 'provider' is a list of urls or EIP 1193 providers, the number of additional retry attempts after the initial call fails. Total attempts = `1 + retries`. For example, `retries: 3` with 4 providers will try each provider once before throwing. If `retries` exceeds the number of providers, the failover will loop back and retry already-failed providers in round-robin order. Default: 3. 
+     */
+    retries?: number;
+    /**
+     * - The chain ID of the network. When provided, skips automatic chain ID detection from the provider.
      */
-    provider?: string | Eip1193Provider;
+    chainId?: number;
     /**
      * - The maximum fee amount for transfer operations.
      */