Guides
Connect with web3.js
Testnet 122606
Section
Guides
Documentation category
Type
Guide
Technical reference
Summary
Full setup guide for web3.js v4 — providers, accounts, contracts, and WebSocket subscriptions.
Article Content

Installation

npm install web3@^4

Connecting

import { Web3 } from 'web3'

const web3 = new Web3('https://testnet.swssrpc.swss.io')

// Verify connection
const chainId = await web3.eth.getChainId()
console.log('Chain ID:', chainId.toString()) // 789n

Reading Chain Data

// Block number
const blockNum = await web3.eth.getBlockNumber()
console.log('Block:', blockNum)

// Balance
const balance = await web3.eth.getBalance('0xYourAddress...')
console.log('Balance:', web3.utils.fromWei(balance, 'ether'), 'SWSS')

// Gas price
const gasPrice = await web3.eth.getGasPrice()
console.log('Gas:', web3.utils.fromWei(gasPrice, 'gwei'), 'Gwei')

Signing Transactions

const account = web3.eth.accounts.privateKeyToAccount(process.env.PRIVATE_KEY!)
web3.eth.accounts.wallet.add(account)

const tx = await web3.eth.sendTransaction({
  from:  account.address,
  to:    '0xRecipient...',
  value: web3.utils.toWei('1', 'ether'),
})

console.log('Hash:', tx.transactionHash)

Contract Calls

const ABI = [
  { type: 'function', name: 'totalSupply', inputs: [], outputs: [{ type: 'uint256' }], stateMutability: 'view' },
]

const contract = new web3.eth.Contract(ABI, '0xContractAddress...')
const supply   = await contract.methods.totalSupply().call()
console.log('Supply:', supply)

Using WebSocket Provider (optional)

const web3ws = new Web3('wss://testnet.swssrpc.swss.io/ws')

// Subscribe to new blocks
const subscription = await web3ws.eth.subscribe('newBlockHeaders')
subscription.on('data', block => {
  console.log('New block:', block.number)
})