Official Go implementation of the Ethereum protocol

Marek Kotewicz 9d84609b3f Merge branch 'master' of https://github.com/ethereum/ethereum.js		10 years ago
dist	bring back jsonrpc single method calls in polling	10 years ago
example	event_inc example	10 years ago
lib	bring back jsonrpc single method calls in polling	10 years ago
test	fixed jsonrpc response 0 not handled properly	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	version upgrade	10 years ago
gulpfile.js	BigNumber support	10 years ago
index.js	qt sync provider	10 years ago
package.json	version upgrade	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

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