chore!: deprecate FUEL_NETWORK_URL and LOCAL_NETWORK_URL

.changeset/nervous-shirts-know.md

@@ -0,0 +1,6 @@
+---
+"@fuel-ts/account": patch
+"fuels": patch
+---
+
+chore: deprecate `FUEL_NETWORK_URL` and `LOCAL_NETWORK_URL`

.changeset/plenty-apples-type.md

@@ -0,0 +1,5 @@
+---
+"@fuel-ts/account": minor
+---
+
+chore!: integrate `launchTestNode` in remaining packages

.env.example

@@ -1,3 +1,3 @@
-FUEL_NETWORK_URL=
-TEST_WALLET_PVT_KEY=
+DEVNET_WALLET_PVT_KEY=
+TESTNET_WALLET_PVT_KEY=
 PUBLISHED_NPM_TAG=

.github/workflows/test.yaml

@@ -38,8 +38,11 @@ jobs:
       - name: Validate Tests
         run: pnpm test:validate
 
+      - name: Pretest
+        run: pnpm pretest
+
       - name: Run Tests - ${{ matrix.env.name }}
-        run: pnpm ci:test --${{ matrix.env.name }}
+        run: pnpm test:${{ matrix.env.name }}
 
       - name: Upload Coverage - ${{ matrix.env.name }}
         uses: actions/upload-artifact@v4

.knip.json

@@ -1,5 +1,6 @@
 {
   "ignore": [
+    ".github/**",
     "**/*/fuels.config.*",
     "**/*/.vitepress/*",
     "/apps/docs/*",

CONTRIBUTING.md

@@ -111,20 +111,18 @@ See also:
 
 # Testing
 
-In order to run tests locally, you need `fuel-core` running locally.
-
-To do that run this command in your terminal:
+In order to run tests locally, you can run the following commands:
 
 ```sh
-pnpm node:run
-```
-
-And then run the tests in another terminal tab:
+# run pretest to ensure all test dependencies are built
+pnpm pretest
 
-```sh
-# run all tests
+# run all tests in a node environment
 pnpm test
 
+# you may also run tests in a browser environment
+pnpm test:browser
+
 # watch all tests
 pnpm test:watch
 
@@ -138,17 +136,6 @@ pnpm test:filter packages/my-desired-package/src/my.test.ts
 pnpm test -- --coverage --my-other-flag
 ```
 
-Or if you want to start a local Fuel-Core node and run all tests serially you can do:
-
-```sh
-pnpm ci:test
-```
-
-This will run `node:run`, `test` and then `node:clean`
-
-> The tests may break if you are running your tests locally using `node:run` in a separate terminal.
-> To reset your local fuel-core node data and start from scratch, run `node:clean`
-
 ### CI Test
 
 During the CI process an automated end-to-end (e2e) test is executed. This test is crucial as it simulates real-world scenarios on the current test-net, ensuring that the changeset maintains the expected functionality and stability.
@@ -169,8 +156,8 @@ cp .env.example .env.test
 And changing the below variables:
 
 ```sh
-FUEL_NETWORK_URL=https://testnet.fuel.network/v1/graphql
-TEST_WALLET_PVT_KEY=0x...
+DEVNET_WALLET_PVT_KEY=0x...
+TESTNET_WALLET_PVT_KEY=0x...
 ```
 
 <!-- TODO: add/fix block explorer URL after testnet support- Checking Wallet Balance: https://fuellabs.github.io/block-explorer-v2/beta-5/?#/address/fuel1x33ajpj0jy5p2wcqqu45e32r75zrwfeh6hwqfv5un670rv4p0mns58enjg -->
@@ -245,7 +232,7 @@ Manually edit the `internal/fuel-core/VERSION` file, add the right version, and
 
 ```sh
 pnpm install # will download new binaries
-pnpm test:ci
+pnpm test
 ```
 
 If all tests pass, that's it.

apps/demo-bun-fuels/src/bun.test.ts

@@ -5,25 +5,21 @@
  * It ensures that built code is fully working.
  */
 
-import { Provider, toHex, Wallet, FUEL_NETWORK_URL } from 'fuels';
-import { generateTestWallet, safeExec } from 'fuels/test-utils';
+import { toHex, Wallet } from 'fuels';
+import { launchTestNode, safeExec } from 'fuels/test-utils';
 
 import { Sample, SampleFactory } from './sway-programs-api';
 
-let baseAssetId: string;
-
 /**
  * @group node
+ * @group browser
  */
 describe('ExampleContract', () => {
-  beforeAll(async () => {
-    const provider = await Provider.create(FUEL_NETWORK_URL);
-    baseAssetId = provider.getBaseAssetId();
-  });
-
   it('should return the input', async () => {
-    const provider = await Provider.create(FUEL_NETWORK_URL);
-    const wallet = await generateTestWallet(provider, [[500_000, baseAssetId]]);
+    using launched = await launchTestNode();
+    const {
+      wallets: [wallet],
+    } = launched;
 
     // Deploy
     const factory = new SampleFactory(wallet);
@@ -49,8 +45,10 @@ describe('ExampleContract', () => {
   });
 
   it('deploy method', async () => {
-    const provider = await Provider.create(FUEL_NETWORK_URL);
-    const wallet = await generateTestWallet(provider, [[500_000, baseAssetId]]);
+    using launched = await launchTestNode();
+    const {
+      wallets: [wallet],
+    } = launched;
 
     // Deploy
     const deploy = await SampleFactory.deploy(wallet);
@@ -67,8 +65,12 @@ describe('ExampleContract', () => {
   });
 
   it('should throw when simulating via contract factory with wallet with no resources', async () => {
-    const provider = await Provider.create(FUEL_NETWORK_URL);
-    const fundedWallet = await generateTestWallet(provider, [[500_000, baseAssetId]]);
+    using launched = await launchTestNode();
+    const {
+      provider,
+      wallets: [fundedWallet],
+    } = launched;
+
     const unfundedWallet = Wallet.generate({ provider });
 
     const deploy = await SampleFactory.deploy(fundedWallet);
@@ -84,8 +86,12 @@ describe('ExampleContract', () => {
   });
 
   it('should not throw when dry running via contract factory with wallet with no resources', async () => {
-    const provider = await Provider.create(FUEL_NETWORK_URL);
-    const fundedWallet = await generateTestWallet(provider, [[500_000, baseAssetId]]);
+    using launched = await launchTestNode();
+    const {
+      provider,
+      wallets: [fundedWallet],
+    } = launched;
+
     const unfundedWallet = Wallet.generate({ provider });
 
     const deploy = await SampleFactory.deploy(fundedWallet);
@@ -97,9 +103,13 @@ describe('ExampleContract', () => {
   });
 
   it('should demo how to use generated files just fine', async () => {
-    const provider = await Provider.create(FUEL_NETWORK_URL);
-    const wallet = await generateTestWallet(provider, [[500_000, baseAssetId]]);
+    using launched = await launchTestNode();
+    const {
+      wallets: [wallet],
+    } = launched;
+
     const { waitForResult } = await SampleFactory.deploy(wallet);
+
     const { contract: depoloyed } = await waitForResult();
     const contractsIds = {
       sample: depoloyed.id,

apps/demo-fuels/src/index.test.ts

@@ -5,25 +5,21 @@
  * It ensures that built code is fully working.
  */
 
-import { Provider, toHex, Wallet, FUEL_NETWORK_URL } from 'fuels';
-import { generateTestWallet, safeExec } from 'fuels/test-utils';
+import { toHex, Wallet } from 'fuels';
+import { launchTestNode, safeExec } from 'fuels/test-utils';
 
 import { SampleFactory, Sample } from './sway-programs-api';
 
-let baseAssetId: string;
-
 /**
  * @group node
+ * @group browser
  */
 describe('ExampleContract', () => {
-  beforeAll(async () => {
-    const provider = await Provider.create(FUEL_NETWORK_URL);
-    baseAssetId = provider.getBaseAssetId();
-  });
-
   it('should return the input', async () => {
-    const provider = await Provider.create(FUEL_NETWORK_URL);
-    const wallet = await generateTestWallet(provider, [[500_000, baseAssetId]]);
+    using launched = await launchTestNode();
+    const {
+      wallets: [wallet],
+    } = launched;
 
     // Deploy
     const deploy = await SampleFactory.deploy(wallet);
@@ -44,8 +40,10 @@ describe('ExampleContract', () => {
   });
 
   it('should deploy contract', async () => {
-    const provider = await Provider.create(FUEL_NETWORK_URL);
-    const wallet = await generateTestWallet(provider, [[500_000, baseAssetId]]);
+    using launched = await launchTestNode();
+    const {
+      wallets: [wallet],
+    } = launched;
 
     // Deploy
     const deploy = await SampleFactory.deploy(wallet);
@@ -60,8 +58,12 @@ describe('ExampleContract', () => {
   });
 
   it('should throw when simulating via contract factory with wallet with no resources', async () => {
-    const provider = await Provider.create(FUEL_NETWORK_URL);
-    const fundedWallet = await generateTestWallet(provider, [[500_000, baseAssetId]]);
+    using launched = await launchTestNode();
+    const {
+      provider,
+      wallets: [fundedWallet],
+    } = launched;
+
     const unfundedWallet = Wallet.generate({ provider });
 
     const deploy = await SampleFactory.deploy(fundedWallet);
@@ -77,8 +79,12 @@ describe('ExampleContract', () => {
   });
 
   it('should not throw when dry running via contract factory with wallet with no resources', async () => {
-    const provider = await Provider.create(FUEL_NETWORK_URL);
-    const fundedWallet = await generateTestWallet(provider, [[500_000, baseAssetId]]);
+    using launched = await launchTestNode();
+    const {
+      provider,
+      wallets: [fundedWallet],
+    } = launched;
+
     const unfundedWallet = Wallet.generate({ provider });
 
     const { waitForResult } = await SampleFactory.deploy(fundedWallet);
@@ -89,12 +95,16 @@ describe('ExampleContract', () => {
   });
 
   it('should demo how to use generated files just fine', async () => {
-    const provider = await Provider.create(FUEL_NETWORK_URL);
-    const wallet = await generateTestWallet(provider, [[500_000, baseAssetId]]);
+    using launched = await launchTestNode();
+    const {
+      wallets: [wallet],
+    } = launched;
+
     const deploy = await SampleFactory.deploy(wallet);
-    const { contract: depoloyed } = await deploy.waitForResult();
+    const { contract: deployed } = await deploy.waitForResult();
+
     const contractsIds = {
-      sample: depoloyed.id,
+      sample: deployed.id,
     };
 
     // #region using-generated-files

apps/demo-react-cra/src/App.test.tsx

@@ -1,5 +1,5 @@
 import React from "react";
-import { render, screen } from "@testing-library/react";
+import { render } from "@testing-library/react";
 import App from "./App";
 
 test("renders learn react link", () => {