257 lines
8.0 KiB
JavaScript
257 lines
8.0 KiB
JavaScript
/*
|
|
This file is part of ethereum.js.
|
|
|
|
ethereum.js is free software: you can redistribute it and/or modify
|
|
it under the terms of the GNU Lesser General Public License as published by
|
|
the Free Software Foundation, either version 3 of the License, or
|
|
(at your option) any later version.
|
|
|
|
ethereum.js is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
GNU Lesser General Public License for more details.
|
|
|
|
You should have received a copy of the GNU Lesser General Public License
|
|
along with ethereum.js. If not, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
/** @file web3.js
|
|
* @authors:
|
|
* Jeffrey Wilcke <jeff@ethdev.com>
|
|
* Marek Kotewicz <marek@ethdev.com>
|
|
* Marian Oancea <marian@ethdev.com>
|
|
* Gav Wood <g@ethdev.com>
|
|
* @date 2014
|
|
*/
|
|
|
|
if (process.env.NODE_ENV !== 'build') {
|
|
var BigNumber = require('bignumber.js');
|
|
}
|
|
|
|
var utils = require('./utils');
|
|
|
|
/// @returns an array of objects describing web3 api methods
|
|
var web3Methods = function () {
|
|
return [
|
|
{ name: 'sha3', call: 'web3_sha3' }
|
|
];
|
|
};
|
|
|
|
/// @returns an array of objects describing web3.eth api methods
|
|
var ethMethods = function () {
|
|
var blockCall = function (args) {
|
|
return typeof args[0] === "string" ? "eth_blockByHash" : "eth_blockByNumber";
|
|
};
|
|
|
|
var transactionCall = function (args) {
|
|
return typeof args[0] === "string" ? 'eth_transactionByHash' : 'eth_transactionByNumber';
|
|
};
|
|
|
|
var uncleCall = function (args) {
|
|
return typeof args[0] === "string" ? 'eth_uncleByHash' : 'eth_uncleByNumber';
|
|
};
|
|
|
|
var methods = [
|
|
{ name: 'balanceAt', call: 'eth_balanceAt' },
|
|
{ name: 'stateAt', call: 'eth_stateAt' },
|
|
{ name: 'storageAt', call: 'eth_storageAt' },
|
|
{ name: 'countAt', call: 'eth_countAt'},
|
|
{ name: 'codeAt', call: 'eth_codeAt' },
|
|
{ name: 'transact', call: 'eth_transact' },
|
|
{ name: 'call', call: 'eth_call' },
|
|
{ name: 'block', call: blockCall },
|
|
{ name: 'transaction', call: transactionCall },
|
|
{ name: 'uncle', call: uncleCall },
|
|
{ name: 'compilers', call: 'eth_compilers' },
|
|
{ name: 'flush', call: 'eth_flush' },
|
|
{ name: 'lll', call: 'eth_lll' },
|
|
{ name: 'solidity', call: 'eth_solidity' },
|
|
{ name: 'serpent', call: 'eth_serpent' },
|
|
{ name: 'logs', call: 'eth_logs' }
|
|
];
|
|
return methods;
|
|
};
|
|
|
|
/// @returns an array of objects describing web3.eth api properties
|
|
var ethProperties = function () {
|
|
return [
|
|
{ name: 'coinbase', getter: 'eth_coinbase', setter: 'eth_setCoinbase' },
|
|
{ name: 'listening', getter: 'eth_listening', setter: 'eth_setListening' },
|
|
{ name: 'mining', getter: 'eth_mining', setter: 'eth_setMining' },
|
|
{ name: 'gasPrice', getter: 'eth_gasPrice' },
|
|
{ name: 'accounts', getter: 'eth_accounts' },
|
|
{ name: 'peerCount', getter: 'eth_peerCount' },
|
|
{ name: 'defaultBlock', getter: 'eth_defaultBlock', setter: 'eth_setDefaultBlock' },
|
|
{ name: 'number', getter: 'eth_number'}
|
|
];
|
|
};
|
|
|
|
/// @returns an array of objects describing web3.db api methods
|
|
var dbMethods = function () {
|
|
return [
|
|
{ name: 'put', call: 'db_put' },
|
|
{ name: 'get', call: 'db_get' },
|
|
{ name: 'putString', call: 'db_putString' },
|
|
{ name: 'getString', call: 'db_getString' }
|
|
];
|
|
};
|
|
|
|
/// @returns an array of objects describing web3.shh api methods
|
|
var shhMethods = function () {
|
|
return [
|
|
{ name: 'post', call: 'shh_post' },
|
|
{ name: 'newIdentity', call: 'shh_newIdentity' },
|
|
{ name: 'haveIdentity', call: 'shh_haveIdentity' },
|
|
{ name: 'newGroup', call: 'shh_newGroup' },
|
|
{ name: 'addToGroup', call: 'shh_addToGroup' }
|
|
];
|
|
};
|
|
|
|
/// @returns an array of objects describing web3.eth.watch api methods
|
|
var ethWatchMethods = function () {
|
|
var newFilter = function (args) {
|
|
return typeof args[0] === 'string' ? 'eth_newFilterString' : 'eth_newFilter';
|
|
};
|
|
|
|
return [
|
|
{ name: 'newFilter', call: newFilter },
|
|
{ name: 'uninstallFilter', call: 'eth_uninstallFilter' },
|
|
{ name: 'getMessages', call: 'eth_filterLogs' }
|
|
];
|
|
};
|
|
|
|
/// @returns an array of objects describing web3.shh.watch api methods
|
|
var shhWatchMethods = function () {
|
|
return [
|
|
{ name: 'newFilter', call: 'shh_newFilter' },
|
|
{ name: 'uninstallFilter', call: 'shh_uninstallFilter' },
|
|
{ name: 'getMessages', call: 'shh_getMessages' }
|
|
];
|
|
};
|
|
|
|
/// creates methods in a given object based on method description on input
|
|
/// setups api calls for these methods
|
|
var setupMethods = function (obj, methods) {
|
|
methods.forEach(function (method) {
|
|
obj[method.name] = function () {
|
|
var args = Array.prototype.slice.call(arguments);
|
|
var call = typeof method.call === 'function' ? method.call(args) : method.call;
|
|
return web3.provider.send({
|
|
method: call,
|
|
params: args
|
|
});
|
|
};
|
|
});
|
|
};
|
|
|
|
/// creates properties in a given object based on properties description on input
|
|
/// setups api calls for these properties
|
|
var setupProperties = function (obj, properties) {
|
|
properties.forEach(function (property) {
|
|
var proto = {};
|
|
proto.get = function () {
|
|
return web3.provider.send({
|
|
method: property.getter
|
|
});
|
|
};
|
|
|
|
if (property.setter) {
|
|
proto.set = function (val) {
|
|
return web3.provider.send({
|
|
method: property.setter,
|
|
params: [val]
|
|
});
|
|
};
|
|
}
|
|
Object.defineProperty(obj, property.name, proto);
|
|
});
|
|
};
|
|
|
|
/// setups web3 object, and it's in-browser executed methods
|
|
var web3 = {
|
|
_callbacks: {},
|
|
_events: {},
|
|
providers: {},
|
|
|
|
/// @returns ascii string representation of hex value prefixed with 0x
|
|
toAscii: utils.toAscii,
|
|
|
|
/// @returns hex representation (prefixed by 0x) of ascii string
|
|
fromAscii: utils.fromAscii,
|
|
|
|
/// @returns decimal representaton of hex value prefixed by 0x
|
|
toDecimal: function (val) {
|
|
// remove 0x and place 0, if it's required
|
|
val = val.length > 2 ? val.substring(2) : "0";
|
|
return (new BigNumber(val, 16).toString(10));
|
|
},
|
|
|
|
/// @returns hex representation (prefixed by 0x) of decimal value
|
|
fromDecimal: function (val) {
|
|
return "0x" + (new BigNumber(val).toString(16));
|
|
},
|
|
|
|
/// used to transform value/string to eth string
|
|
toEth: utils.toEth,
|
|
|
|
/// eth object prototype
|
|
eth: {
|
|
contractFromAbi: function (abi) {
|
|
return function(addr) {
|
|
// Default to address of Config. TODO: rremove prior to genesis.
|
|
addr = addr || '0xc6d9d2cd449a754c494264e1809c50e34d64562b';
|
|
var ret = web3.eth.contract(addr, abi);
|
|
ret.address = addr;
|
|
return ret;
|
|
};
|
|
},
|
|
|
|
/// @param filter may be a string, object or event
|
|
/// @param indexed is optional, this is an object with optional event indexed params
|
|
/// @param options is optional, this is an object with optional event options ('max'...)
|
|
watch: function (filter, indexed, options) {
|
|
if (filter._isEvent) {
|
|
return filter(indexed, options);
|
|
}
|
|
return new web3.filter(filter, ethWatch);
|
|
}
|
|
},
|
|
|
|
/// db object prototype
|
|
db: {},
|
|
|
|
/// shh object prototype
|
|
shh: {
|
|
|
|
/// @param filter may be a string, object or event
|
|
watch: function (filter, indexed) {
|
|
return new web3.filter(filter, shhWatch);
|
|
}
|
|
},
|
|
};
|
|
|
|
/// setups all api methods
|
|
setupMethods(web3, web3Methods());
|
|
setupMethods(web3.eth, ethMethods());
|
|
setupProperties(web3.eth, ethProperties());
|
|
setupMethods(web3.db, dbMethods());
|
|
setupMethods(web3.shh, shhMethods());
|
|
|
|
var ethWatch = {
|
|
changed: 'eth_changed'
|
|
};
|
|
|
|
setupMethods(ethWatch, ethWatchMethods());
|
|
|
|
var shhWatch = {
|
|
changed: 'shh_changed'
|
|
};
|
|
|
|
setupMethods(shhWatch, shhWatchMethods());
|
|
|
|
web3.setProvider = function(provider) {
|
|
web3.provider.set(provider);
|
|
};
|
|
|
|
module.exports = web3;
|
|
|