Official Go implementation of the Ethereum protocol
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
Marek Kotewicz 589c4fb30f formatInput && formatOutput simplified 10 years ago
dist formatInput && formatOutput simplified 10 years ago
example events 10 years ago
lib formatInput && formatOutput simplified 10 years ago
test few methods moved to utils 10 years ago
.bowerrc Converted to node module 10 years ago
.editorconfig Updated bower.json & Readme 10 years ago
.gitignore merged subprotocol prefix 10 years ago
.jshintrc Converted to node module 10 years ago
.npmignore Refactoring 10 years ago
.travis.yml Merge commit 'ab745d3b0eb89d67db1ed953020c665be3d072ed' into develop 10 years ago
LICENSE Converted to node module 10 years ago
README.md removed promise dependency, updated readme, fixed node.js version of lib 10 years ago
bower.json removed promise dependency, updated readme, fixed node.js version of lib 10 years ago
gulpfile.js BigNumber support 10 years ago
index.js qt sync provider 10 years ago
package.json removed promise dependency, updated readme, fixed node.js version of lib 10 years ago

README.md

Ethereum JavaScript API

This is the Ethereum compatible JavaScript API which implements the Generic JSON RPC spec. It's available on npm as a node module and also for bower and component as an embeddable js

NPM version Build Status dependency status dev dependency status

Installation

Node.js

npm install ethereum.js

For browser

Bower

bower install ethereum.js

Component

component install ethereum/ethereum.js
  • Include ethereum.min.js in your html file.
  • Include bignumber.js

Usage

Require the library:

var web3 = require('web3');

Set a provider (QtProvider, WebSocketProvider, HttpRpcProvider)

var web3.setProvider(new web3.providers.WebSocketProvider('ws://localhost:40404/eth'));

There you go, now you can use it:

var coinbase = web3.eth.coinbase;
var balance = web3.eth.balanceAt(coinbase);

For another example see example/index.html.

Contribute!

Requirements

  • Node.js
  • npm
  • gulp (build)
  • mocha (tests)
sudo apt-get update
sudo apt-get install nodejs
sudo apt-get install npm
sudo apt-get install nodejs-legacy

Building (gulp)

npm run-script build

Testing (mocha)

npm test

Please note this repo is in it's early stage.

If you'd like to run a WebSocket ethereum node check out go-ethereum.

To install ethereum and spawn a node:

go get github.com/ethereum/go-ethereum/ethereum
ethereum -ws -loglevel=4