feat: create a wallet without a provider

.changeset/happy-days-repeat.md

@@ -0,0 +1,5 @@
+---
+"@fuel-ts/wallet": minor
+---
+
+Made provider argument optional for wallet instantiation

.changeset/witty-beds-vanish.md

@@ -0,0 +1,2 @@
+---
+---

packages/program/src/contract.test.ts

@@ -67,7 +67,7 @@ describe('Contract', () => {
     // but without reference to the BaseWalletLocked class
     const BaseWalletLockedCustom = Object.assign(Account);
     expect(BaseWalletLockedCustom).not.toBeInstanceOf(Account);
-    const wallet = new BaseWalletLockedCustom(generatedWallet.address);
+    const wallet = new BaseWalletLockedCustom(generatedWallet.address, generatedWallet.provider);
     const contract = new Contract(CONTRACT_ID, ABI, wallet);
     expect(contract.provider).toBe(wallet.provider);
     expect(contract.account).toBe(wallet);

packages/wallet/src/account.test.ts

@@ -44,7 +44,7 @@ describe('Account', () => {
     '0x0000000000000000000000000000000000000000000000000000000000000000',
   ];
 
-  it('Create wallet using a address', () => {
+  it('should create account using an address, with a provider', () => {
     const account = new Account(
       '0x09c0b2d1a486c439a87bcba6b46a7a1a23f3897cc83a94521a96da5c23bc58db',
       provider
@@ -54,6 +54,22 @@ describe('Account', () => {
     );
   });
 
+  it('should create account using an address, without a provider', () => {
+    const account = new Account(
+      '0x09c0b2d1a486c439a87bcba6b46a7a1a23f3897cc83a94521a96da5c23bc58db'
+    );
+    expect(account.address.toB256()).toEqual(
+      '0x09c0b2d1a486c439a87bcba6b46a7a1a23f3897cc83a94521a96da5c23bc58db'
+    );
+  });
+
+  it('should throw an error when using a provider dependent method, without a provider', async () => {
+    const account = new Account(
+      '0x09c0b2d1a486c439a87bcba6b46a7a1a23f3897cc83a94521a96da5c23bc58db'
+    );
+    await expect(() => account.getBalance()).rejects.toThrow(/Provider not set/);
+  });
+
   it('should get coins just fine', async () => {
     const account = new Account(
       '0x09c0b2d1a486c439a87bcba6b46a7a1a23f3897cc83a94521a96da5c23bc58db',
@@ -223,6 +239,21 @@ describe('Account', () => {
     expect(account.provider).not.toBe(provider);
   });
 
+  it('should be able to set a provider', async () => {
+    const account = new Account(
+      '0x09c0b2d1a486c439a87bcba6b46a7a1a23f3897cc83a94521a96da5c23bc58db',
+      provider
+    );
+    const newProviderInstance = await Provider.create(FUEL_NETWORK_URL);
+
+    expect(account.provider).not.toBe(newProviderInstance);
+
+    account.provider = newProviderInstance;
+
+    expect(account.provider).toBe(newProviderInstance);
+    expect(account.provider).not.toBe(provider);
+  });
+
   it('should execute fund just as fine', async () => {
     const quantities: CoinQuantity[] = [
       {

packages/wallet/src/account.ts

@@ -51,28 +51,52 @@ export class Account extends AbstractAccount {
   /**
    * The provider used to interact with the network.
    */
-  provider: Provider;
+  protected _provider?: Provider;
 
   /**
    * Creates a new Account instance.
    *
    * @param address - The address of the account.
-   * @param provider - A Provider instance.
+   * @param provider - A Provider instance  (optional).
    */
-  constructor(address: string | AbstractAddress, provider: Provider) {
+  constructor(address: string | AbstractAddress, provider?: Provider) {
     super();
-    this.provider = provider;
+    this._provider = provider;
     this.address = Address.fromDynamicInput(address);
   }
 
+  /**
+   * The provider used to interact with the network.
+   *
+   * @returns A Provider instance.
+   *
+   * @throws `FuelError` if the provider is not set.
+   */
+  get provider(): Provider {
+    if (!this._provider) {
+      throw new FuelError(ErrorCode.MISSING_PROVIDER, 'Provider not set');
+    }
+
+    return this._provider;
+  }
+
+  /**
+   * Sets the provider for the account.
+   *
+   * @param provider - A Provider instance.
+   */
+  set provider(provider: Provider) {
+    this._provider = provider;
+  }
+
   /**
    * Changes the provider connection for the account.
    *
    * @param provider - A Provider instance.
    * @returns The updated Provider instance.
    */
   connect(provider: Provider): Provider {
-    this.provider = provider;
+    this._provider = provider;
     return this.provider;
   }
 

packages/wallet/src/base-unlocked-wallet.ts

@@ -22,11 +22,6 @@ export class BaseWalletUnlocked extends Account {
    */
   static defaultPath = "m/44'/1179993420'/0'/0/0";
 
-  /**
-   * The provider used to interact with the Fuel network.
-   */
-  provider: Provider;
-
   /**
    * A function that returns the wallet's signer.
    */
@@ -36,13 +31,12 @@ export class BaseWalletUnlocked extends Account {
    * Creates a new BaseWalletUnlocked instance.
    *
    * @param privateKey - The private key of the wallet.
-   * @param provider - A Provider instance.
+   * @param provider - A Provider instance (optional).
    */
-  constructor(privateKey: BytesLike, provider: Provider) {
+  constructor(privateKey: BytesLike, provider?: Provider) {
     const signer = new Signer(privateKey);
     super(signer.address, provider);
     this.signer = () => signer;
-    this.provider = provider;
   }
 
   /**

packages/wallet/src/types/GenerateOptions.ts

@@ -4,5 +4,5 @@ import type { BytesLike } from 'ethers';
 export interface GenerateOptions {
   /** Additional entropy for the random bytes */
   entropy?: BytesLike;
-  provider: Provider;
+  provider?: Provider;
 }

packages/wallet/src/wallet-unlocked.test.ts

@@ -150,48 +150,75 @@ describe('WalletUnlocked', () => {
     expect(wallet.address).toEqual(recoveredAddress);
   });
 
-  it('Create wallet from seed', async () => {
-    const provider = await Provider.create(FUEL_NETWORK_URL);
-    const wallet = WalletUnlocked.fromSeed(walletSpec.seed, provider, walletSpec.account_1.path);
+  describe('WalletUnlocked.fromSeed', () => {
+    it('Create wallet from seed', async () => {
+      const provider = await Provider.create(FUEL_NETWORK_URL);
+      const wallet = WalletUnlocked.fromSeed(walletSpec.seed, provider, walletSpec.account_1.path);
 
-    expect(wallet.publicKey).toBe(walletSpec.account_1.publicKey);
-    expect(wallet.provider.url).toBe(walletSpec.providerUrl);
-  });
+      expect(wallet.publicKey).toBe(walletSpec.account_1.publicKey);
+      expect(wallet.provider.url).toBe(walletSpec.providerUrl);
+    });
 
-  it('Create wallet from mnemonic', async () => {
-    const provider = await Provider.create(FUEL_NETWORK_URL);
-    const wallet = WalletUnlocked.fromMnemonic(
-      walletSpec.mnemonic,
-      provider,
-      walletSpec.account_1.path,
-      undefined
-    );
+    it('Create wallet from seed with default path', async () => {
+      const provider = await Provider.create(FUEL_NETWORK_URL);
+      const wallet = WalletUnlocked.fromSeed(walletSpec.seed, provider);
 
-    expect(wallet.publicKey).toBe(walletSpec.account_1.publicKey);
-    expect(wallet.provider.url).toBe(walletSpec.providerUrl);
-  });
+      expect(wallet.publicKey).toBe(walletSpec.account_0.publicKey);
+      expect(wallet.provider.url).toBe(walletSpec.providerUrl);
+    });
 
-  it('Create wallet from mnemonic with default path', async () => {
-    const provider = await Provider.create(FUEL_NETWORK_URL);
-    const wallet = WalletUnlocked.fromMnemonic(walletSpec.mnemonic, provider);
+    it('Create wallet from seed with default path, without a provider', () => {
+      const wallet = WalletUnlocked.fromSeed(walletSpec.seed);
 
-    expect(wallet.publicKey).toBe(walletSpec.account_0.publicKey);
+      expect(wallet.publicKey).toBe(walletSpec.account_0.publicKey);
+      expect(() => wallet.provider).toThrowError('Provider not set');
+    });
   });
 
-  it('Create wallet from extendedKey', async () => {
-    const provider = await Provider.create(FUEL_NETWORK_URL);
-    const wallet = WalletUnlocked.fromExtendedKey(walletSpec.account_0.xprv, provider);
+  describe('WalletUnlocked.fromMnemonic', () => {
+    it('Create wallet from mnemonic', async () => {
+      const provider = await Provider.create(FUEL_NETWORK_URL);
+      const wallet = WalletUnlocked.fromMnemonic(
+        walletSpec.mnemonic,
+        provider,
+        walletSpec.account_1.path,
+        undefined
+      );
+
+      expect(wallet.publicKey).toBe(walletSpec.account_1.publicKey);
+      expect(wallet.provider.url).toBe(walletSpec.providerUrl);
+    });
+
+    it('Create wallet from mnemonic with default path', async () => {
+      const provider = await Provider.create(FUEL_NETWORK_URL);
+      const wallet = WalletUnlocked.fromMnemonic(walletSpec.mnemonic, provider);
+
+      expect(wallet.publicKey).toBe(walletSpec.account_0.publicKey);
+    });
+
+    it('Create wallet from mnemonic with default path, without a provider', () => {
+      const wallet = WalletUnlocked.fromMnemonic(walletSpec.mnemonic);
 
-    expect(wallet.publicKey).toBe(walletSpec.account_0.publicKey);
-    expect(wallet.provider.url).toBe(walletSpec.providerUrl);
+      expect(wallet.publicKey).toBe(walletSpec.account_0.publicKey);
+      expect(() => wallet.provider).toThrowError('Provider not set');
+    });
   });
 
-  it('Create wallet from seed with default path', async () => {
-    const provider = await Provider.create(FUEL_NETWORK_URL);
-    const wallet = WalletUnlocked.fromSeed(walletSpec.seed, provider);
+  describe('WalletUnlocked.extendedKey', () => {
+    it('Create wallet from extendedKey', async () => {
+      const provider = await Provider.create(FUEL_NETWORK_URL);
+      const wallet = WalletUnlocked.fromExtendedKey(walletSpec.account_0.xprv, provider);
+
+      expect(wallet.publicKey).toBe(walletSpec.account_0.publicKey);
+      expect(wallet.provider.url).toBe(walletSpec.providerUrl);
+    });
 
-    expect(wallet.publicKey).toBe(walletSpec.account_0.publicKey);
-    expect(wallet.provider.url).toBe(walletSpec.providerUrl);
+    it('Create wallet from extendedKey, without provider', () => {
+      const wallet = WalletUnlocked.fromExtendedKey(walletSpec.account_0.xprv);
+
+      expect(wallet.publicKey).toBe(walletSpec.account_0.publicKey);
+      expect(() => wallet.provider).toThrowError('Provider not set');
+    });
   });
 
   it('Create wallet and lock it', async () => {