web3-net

What is web3-net?

The web3-net package is a sub-package of the web3.js library that provides network-related functionalities for interacting with Ethereum nodes. It allows developers to retrieve information about the network, such as the network ID, peer count, and listening status.

What are web3-net's main functionalities?

Get Network ID

This feature allows you to retrieve the network ID of the connected Ethereum network. The network ID is a unique identifier for different Ethereum networks (e.g., Mainnet, Ropsten, Rinkeby).

const Web3 = require('web3');
const web3 = new Web3('http://localhost:8545');
web3.eth.net.getId().then(console.log);

Get Peer Count

This feature allows you to get the number of peers currently connected to the Ethereum node. This can be useful for monitoring the health and connectivity of your node.

const Web3 = require('web3');
const web3 = new Web3('http://localhost:8545');
web3.eth.net.getPeerCount().then(console.log);

Check if Node is Listening

This feature checks if the Ethereum node is currently listening for network connections. It returns a boolean value indicating the listening status.

const Web3 = require('web3');
const web3 = new Web3('http://localhost:8545');
web3.eth.net.isListening().then(console.log);

Other packages similar to web3-net

ethers

The ethers.js library is a complete and compact library for interacting with the Ethereum blockchain. It provides similar functionalities to web3-net, such as network information retrieval, but also includes additional features like contract interaction, wallet management, and utilities for working with Ethereum data structures.

ethjs

Ethjs is a highly modular and lightweight library for interacting with the Ethereum network. It offers similar network-related functionalities as web3-net, such as retrieving network ID and peer count, but is designed to be more modular and minimalistic, allowing developers to include only the parts they need.

web3

The web3.js library is the parent package of web3-net and provides a comprehensive suite of tools for interacting with the Ethereum blockchain. It includes all the functionalities of web3-net along with additional modules for contract interaction, account management, and more.

README

web3.js - Net

This is a sub-package of web3.js.

web3-net package allows to interact with an Ethereum node’s network properties.

Installation

You can install the package either using NPM or using Yarn

Using NPM

npm install web3-net

Using Yarn

yarn add web3-net

Getting Started

• :writing_hand: If you have questions submit an issue or join us on Discord

Prerequisites

• :gear: NodeJS (LTS/Fermium)
• :toolbox: Yarn/Lerna

Package.json Scripts

Script	Description
clean	Uses rimraf to remove dist/
build	Uses tsc to build package and dependent packages
lint	Uses eslint to lint package
lint:fix	Uses eslint to check and fix any warnings
format	Uses prettier to format the code
test	Uses jest to run unit tests
test:integration	Uses jest to run tests under /test/integration
test:unit	Uses jest to run tests under /test/unit