@fortmatic/fortmatic-web3

web3.js - Ethereum JavaScript API

This is the Ethereum JavaScript API which connects to the Generic JSON RPC spec.

You need to run a local or remote Ethereum node to use this library.

Please read the documentation for more.

Installation

Node

npm install web3

Yarn

yarn add web3

Meteor

Note: works only in the Browser for now. (PR welcome).

meteor add ethereum:web3

In the Browser

Use the prebuild dist/web3.min.js, or build using the web3.js repository:

npm run-script build

Then include dist/web3.js in your html file. This will expose Web3 on the window object.

Usage

// in node.js
var Web3 = require('web3');

var web3 = new Web3('ws://localhost:8546');
console.log(web3);
> {
    eth: ... ,
    shh: ... ,
    utils: ...,
    ...
}

Additionally you can set a provider using web3.setProvider() (e.g. WebsocketProvider):

web3.setProvider('ws://localhost:8546');
// or
web3.setProvider(new Web3.providers.WebsocketProvider('ws://localhost:8546'));

There you go, now you can use it:

web3.eth.getAccounts()
.then(console.log);

Usage with TypeScript

Type definitions are maintained at DefinitelyTyped by others. You can install them with:

npm install --dev @types/web3.js

You might need to install type definitions for bignumber.js and lodash too.

And then use web3.js as follows:

import Web3 = require("web3"); // Note the special syntax! Copy this line when in doubt!
const web3 = new Web3("ws://localhost:8546");

Please note: We do not support TypeScript ourselves. If you have any issue with TypeScript and web3.js do not create an issue here. Go over to DefinitelyTyped and do it there.

Documentation

Documentation can be found at read the docs.

Building

Requirements

• Node.js
• npm

sudo apt-get update
sudo apt-get install nodejs
sudo apt-get install npm

Building (gulp)

Build only the web3.js package

npm run-script build

Or build all sub packages as well:

npm run-script build-all

This will put all the browser build files into the dist folder.

Testing (mocha)

npm test

Contributing

• All contributions have to go into develop, or the 1.0 branch
• Please follow the code style of the other files, we use 4 spaces as tabs.

Community

• Gitter
• Forum

Similar libraries in other languages

• Python - Web3.py
• Haskell - hs-web3
• Java - web3j
• Scala - web3j-scala
• Purescript - purescript-web3
• PHP - web3.php

Changelog

[1.2.2]

Added

• localStorage support detection added (#3031)
• getNetworkType method extended with Görli testnet (#3095)
• supportsSubscriptions method added to providers (#3116)
• Add eth.getChainId method (#3113)
• Minified file added to web3 package (#3131)
• The transaction confirmation workflow can now be configured (#3130)
• Additional parameters for accounts.signTransaction added (docs) (#3141)
• Emit connected event on subscription creation (#3028)
• TypeScript type definitions added for all modules (#3132)
• Bloom filters added to web3.utils (#3137)

Fixed

• Fix allow 0 as a valid fromBlock or toBlock filter param (#1100)
• Fix randomHex returning inconsistent string lengths (#1490)
• Fix make isBN minification safe (#1777)
• Fix incorrect references to BigNumber in utils.fromWei and utils.toWei error messages (#2468)
• Fix error incorrectly thrown when receipt.status is null (#2183)
• Fix incorrectly populating chainId param with net_version when signing txs (#2378)
• regeneratorRuntime error fixed (#3058)
• Fix accessing event.name where event is undefined (#3014)
• fixed Web3Utils toHex() for Buffer input (#3021)
• Fix bubbling up tx signing errors (#2063, #3105)
• HttpProvider: CORS issue with Firefox and Safari (#2978)
• Ensure the immutability of the tx object passed to function signTransaction (#2190)
• Gas check fixed (#2381)
• Signing issues #1998, #2033, and #1074 fixed (#3125)
• Fix hexToNumber and hexToNumberString prefix validation (#3086)
• The receipt will now returned on a EVM error (this got removed on beta.18) (#3129)
• Fixes transaction confirmations with the HttpProvider (#3140)