Practical overview
When it fits
Use it when building JavaScript software that needs Web3 interaction with Aion, especially when working with the documented AVM contract bindings.
Who it is for
- JavaScript developers building applications that interact with the Aion network.
- Developers working with AVM contracts who need method bindings, read-only calls, transactions, gas estimates or event logs.
Documented uses
- Add Aion Web3 functionality to a Node.js application.
- Build a browser bundle for use in an HTML-based application.
- Create an interface from an AVM contract ABI and use it to call contract methods.
- Request past AVM contract event logs or estimate gas for a method.
Requirements & limits
- The README recommends Node.js 10.x or later and npm 6.x or later; other versions are not thoroughly tested according to the project.
- The documented browser path produces
dist/web3.min.jswith Browserify, while the Node.js example initializes Web3 with an HTTP provider. - AVM binding notes say automatic binding is not included and warn that Java/JavaScript float conversion can change precision.
- The repository identifies its license as GPL-3.0.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Install Aion WEB3 in a Node.js project
Add the Aion Web3 package to a project using the README's documented npm setup.
Before you start
- Node.js; version 10.x or later is recommended.
- npm; version 6.x or later is recommended.
Steps
Install the package with the command below.
npm install --save aion-web3In Node.js code, require
aion-web3and create a Web3 instance with an HTTP provider.
Expected outcome
The project has the library installed and the README's documented pattern for initializing a Web3 instance.
Guide limitations
- Other Node.js and npm versions may work, but the README says they have not been thoroughly tested.
- The example provider URL is localhost; the README does not establish a network endpoint for other environments.
Prepare the browser bundle
Build the documented JavaScript bundle for inclusion in an HTML file.
Before you start
- Node.js; version 10.x or later is recommended.
- npm; version 6.x or later is recommended.
Steps
Install the repository dependencies with the command below.
npm installRun the command below to produce
dist/web3.min.js.npm run browserifyInclude the generated file in the HTML file.
Expected outcome
A browser bundle is produced at `dist/web3.min.js` for inclusion in a web page.
Guide limitations
- Other Node.js and npm versions may work, but the README says they have not been thoroughly tested.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 16 October 2026
- Original website title
- aionnetwork/aion_web3 · Official homepage title · retained in its source language

