npx-hayabusa-net

A local four-node Hayabusa network for VeChain development and testing.

Overview

This package provides a pre-configured local Hayabusa network that runs four nodes, making it perfect for:

• Smart contract development and testing
• DApp development
• Network simulation
• Integration testing

Installation

Using npx (Recommended)

npm install hayabusa-net
npx hayabusa-net

Global Installation

npm install -g hayabusa-net
hayabusa-net

Usage

Quick Start

1. Run the network:

   npx hayabusa-net

2. The tool will display a mnemonic phrase and ask for confirmation:

   =================================================================
   This is a local four-node Hayabusa network.
   Use the following mnemonic to deploy and write to custom contracts:
   
           denial kitchen pet squirrel other broom bar gas better priority spoil cross
   
   Proceed ? [y/n]:

3. After confirming, you'll see the network configuration:

   _________________________________________________________________
       Node 1
       - HTTP Address:     localhost:8669
       - Node Address:     0x...
       - Private Key:      0x...
      
   _________________________________________________________________
       Node 2
       - HTTP Address:     localhost:8670
       - Node Address:     0x...
       - Private Key:      0x...
      
   _________________________________________________________________
       Node 3
       - HTTP Address:     localhost:8671
       - Node Address:     0x...
       - Private Key:      0x...
      
   _________________________________________________________________
       Node 4
       - HTTP Address:     localhost:8672
       - Node Address:     0x...
       - Private Key:      0x...

4. Confirm to start the network:

   Start network ? [y/n]:

Network Configuration

The network runs with the following configuration:

• 4 Nodes: Each running on different ports
• HTTP RPC Ports: 8669, 8670, 8671, 8672
• P2P Ports: 11235, 11236, 11237, 11238
• Genesis Accounts: Pre-funded with 1 billion VET and Energy
• Mnemonic: denial kitchen pet squirrel other broom bar gas better priority spoil cross

Development Accounts

The network includes pre-funded development accounts that you can use for testing:

• Mnemonic: denial kitchen pet squirrel other broom bar gas better priority spoil cross
• Balance: 1 billion VET per account
• Energy: 1 billion Energy per account

Stopping the Network

To stop the network, press Ctrl+C in the terminal where the network is running.

Requirements

• Node.js >= 14.0.0
• Supported operating systems: macOS, Linux, Windows
• Supported architectures: x64, arm64

Creating a hardhat project

npx create-vechain-dapp@latest

Follow the instructions, eg:

[email protected]
Ok to proceed? (y) y

✔ Select template › VeChain Hardhat Template
✔ Enter your project name … my-project
Target directory doesn't exist
Creating directory...
Finished creating directory
Finished generating your project my-project
cd my-project
npm install