Icon LinkTest Node Options

This reference describes all the options of the launchTestNode utility:

• walletsConfig
• contractsConfigs
• nodeOptions
• providerOptions

const customLaunchTestNode = await launchTestNode(/* options */);

Check out the API reference Icon Link for usage information on the Test Node Options.

Icon LinkwalletsConfig

Used to set the node's genesis block state (coins and messages).

• count: number of wallets/addresses to generate on the genesis block.
• assets: configure how many unique assets each wallet will own with the base asset included. Can be number or TestAssetId[].
  • The TestAssetId utility simplifies testing when different assets are necessary.
• coinsPerAsset: number of coins (UTXOs) per asset id.
• amountPerCoin: for each coin, the amount it'll contain.
• messages: messages to assign to the wallets.

Icon LinkwalletsConfig.assets

The TestAssetId utility integrates with walletsConfig and gives you an easy way to generate multiple random asset ids via the TestAssetId.random static method.

const randomAssetIds = TestAssetId.random();
 
const nodeWithCustomAssetIds = await launchTestNode({
  walletsConfig: {
    assets: randomAssetIds,
  },
});
 
const {
  wallets: [walletWithCustomAssetIds],
} = nodeWithCustomAssetIds;
 
const { coins } = await walletWithCustomAssetIds.getCoins(
  randomAssetIds[0].value
);

Icon LinkwalletsConfig.messages

The TestMessage helper class is used to create messages for testing purposes. When passed via walletsConfig.messages, the recipient field of the message is overriden to be the wallet's address.

const testMessage = new TestMessage({ amount: 1000 });
 
const nodeWithTestMessages = await launchTestNode({
  walletsConfig: {
    messages: [testMessage],
  },
});
 
const {
  wallets: [walletWithTestMessages],
} = nodeWithTestMessages;
 
const {
  messages: [messageWithTestMessages],
} = await walletWithTestMessages.getMessages();
 

It can also be used standalone and passed into the initial state of the chain via the TestMessage.toChainMessage instance method.

const recipient = WalletUnlocked.generate();
const testMessageOnChain = new TestMessage({
  amount: 1000,
  recipient: recipient.address,
});
 
using launchedWithTestMessagesOnChain = await launchTestNode({
  nodeOptions: {
    snapshotConfig: {
      stateConfig: {
        messages: [testMessageOnChain.toChainMessage()],
      },
    },
  },
});
 
const { provider: providerWithTestMessagesOnChain } =
  launchedWithTestMessagesOnChain;
 
recipient.provider = providerWithTestMessagesOnChain;
 
const {
  messages: [messageOnChain],
} = await recipient.getMessages();

Icon LinkcontractsConfigs

Used to deploy contracts on the node the launchTestNode utility launches. It's an array of objects with the following properties:

• factory: contract factory class outputted by pnpm fuels typegen.
• walletIndex: the index of the wallets generated by walletsConfig that you want to deploy the contract with.
• options: options for contract deployment that get passed to the ContractFactory.deploy Icon Link method.

Icon LinknodeOptions

Options to modify the behavior of the node.

For example, you can specify your own base asset id of the chain like below:

const [baseAssetId] = TestAssetId.random();
 
const nodeWithCustomBaseAssetId = await launchTestNode({
  nodeOptions: {
    snapshotConfig: {
      chainConfig: {
        consensus_parameters: {
          V2: {
            base_asset_id: baseAssetId.value,
          },
        },
      },
    },
  },
});

Note: The API for these options is still not fully complete and better documentation will come in the future.

Icon LinkproviderOptions

Provider options passed on Provider instantiation. More on them here .