/* 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 . */ /** @file main.js * @authors: * Jeffrey Wilcke * Marek Kotewicz * Marian Oancea * Gav Wood * @date 2014 */ /// Recursively resolves all promises in given object and replaces the resolved values with promises /// @param any object/array/promise/anything else.. /// @returns (resolves) object with replaced promises with their result function flattenPromise (obj) { if (obj instanceof Promise) { return Promise.resolve(obj); } if (obj instanceof Array) { return new Promise(function (resolve) { var promises = obj.map(function (o) { return flattenPromise(o); }); return Promise.all(promises).then(function (res) { for (var i = 0; i < obj.length; i++) { obj[i] = res[i]; } resolve(obj); }); }); } if (obj instanceof Object) { return new Promise(function (resolve) { var keys = Object.keys(obj); var promises = keys.map(function (key) { return flattenPromise(obj[key]); }); return Promise.all(promises).then(function (res) { for (var i = 0; i < keys.length; i++) { obj[keys[i]] = res[i]; } resolve(obj); }); }); } return Promise.resolve(obj); } /// @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: '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: 'account', getter: 'eth_account' }, { 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: 'getMessage', 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 () { return flattenPromise(Array.prototype.slice.call(arguments)).then(function (args) { var call = typeof method.call === "function" ? method.call(args) : method.call; return {call: call, args: args}; }).then(function (request) { return new Promise(function (resolve, reject) { web3.provider.send(request, function (err, result) { if (!err) { resolve(result); return; } reject(err); }); }); }).catch(function(err) { console.error(err); }); }; }); }; /// 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 new Promise(function(resolve, reject) { web3.provider.send({call: property.getter}, function(err, result) { if (!err) { resolve(result); return; } reject(err); }); }); }; if (property.setter) { proto.set = function (val) { return flattenPromise([val]).then(function (args) { return new Promise(function (resolve) { web3.provider.send({call: property.setter, args: args}, function (err, result) { if (!err) { resolve(result); return; } reject(err); }); }); }).catch(function (err) { console.error(err); }); }; } Object.defineProperty(obj, property.name, proto); }); }; // TODO: import from a dependency, don't duplicate. var hexToDec = function (hex) { return parseInt(hex, 16).toString(); }; var decToHex = function (dec) { return parseInt(dec).toString(16); }; /// setups web3 object, and it's in-browser executed methods var web3 = { _callbacks: {}, _events: {}, providers: {}, toHex: function(str) { var hex = ""; for(var i = 0; i < str.length; i++) { var n = str.charCodeAt(i).toString(16); hex += n.length < 2 ? '0' + n : n; } return hex; }, toAscii: function(hex) { // Find termination var str = ""; var i = 0, l = hex.length; if (hex.substring(0, 2) === '0x') i = 2; for(; i < l; i+=2) { var code = parseInt(hex.substr(i, 2), 16); if(code === 0) { break; } str += String.fromCharCode(code); } return str; }, fromAscii: function(str, pad) { pad = pad === undefined ? 0 : pad; var hex = this.toHex(str); while(hex.length < pad*2) hex += "00"; return "0x" + hex; }, toDecimal: function (val) { return hexToDec(val.substring(2)); }, fromDecimal: function (val) { return "0x" + decToHex(val); }, toEth: function(str) { var val = typeof str === "string" ? str.indexOf('0x') === 0 ? parseInt(str.substr(2), 16) : parseInt(str) : str; var unit = 0; var units = [ 'wei', 'Kwei', 'Mwei', 'Gwei', 'szabo', 'finney', 'ether', 'grand', 'Mether', 'Gether', 'Tether', 'Pether', 'Eether', 'Zether', 'Yether', 'Nether', 'Dether', 'Vether', 'Uether' ]; while (val > 3000 && unit < units.length - 1) { val /= 1000; unit++; } var s = val.toString().length < val.toFixed(2).length ? val.toString() : val.toFixed(2); var replaceFunction = function($0, $1, $2) { return $1 + ',' + $2; }; while (true) { var o = s; s = s.replace(/(\d)(\d\d\d[\.\,])/, replaceFunction); if (o === s) break; } return s + ' ' + units[unit]; }, eth: { prototype: Object(), // jshint ignore:line watch: function (params) { return new Filter(params, ethWatch); } }, db: { prototype: Object() // jshint ignore:line }, shh: { prototype: Object(), // jshint ignore:line watch: function (params) { return new Filter(params, shhWatch); } }, on: function(event, id, cb) { if(web3._events[event] === undefined) { web3._events[event] = {}; } web3._events[event][id] = cb; return this; }, off: function(event, id) { if(web3._events[event] !== undefined) { delete web3._events[event][id]; } return this; }, trigger: function(event, id, data) { var callbacks = web3._events[event]; if (!callbacks || !callbacks[id]) { return; } var cb = callbacks[id]; cb(data); } }; /// 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()); /// Provider manager object prototype var ProviderManager = function() { this.queued = []; this.polls = []; this.ready = false; this.provider = undefined; this.id = 1; var self = this; var poll = function () { if (self.provider && self.provider.poll) { self.polls.forEach(function (data) { data.data._id = self.id; self.id++; self.provider.poll(data.data, data.id); }); } setTimeout(poll, 12000); }; poll(); }; /// sends outgoing requests, if provider is not available, enqueue the request ProviderManager.prototype.send = function(data, cb) { data._id = this.id; if (cb) { web3._callbacks[data._id] = cb; } data.args = data.args || []; this.id++; if(this.provider !== undefined) { this.provider.send(data); } else { console.warn("provider is not set"); this.queued.push(data); } }; /// setups provider, which will be used for sending messages ProviderManager.prototype.set = function(provider) { if(this.provider !== undefined && this.provider.unload !== undefined) { this.provider.unload(); } this.provider = provider; this.ready = true; }; /// resends queued messages ProviderManager.prototype.sendQueued = function() { for(var i = 0; this.queued.length; i++) { // Resend this.send(this.queued[i]); } }; /// @returns true if the provider i properly set ProviderManager.prototype.installed = function() { return this.provider !== undefined; }; /// this method is only used, when we do not have native qt bindings and have to do polling on our own /// should be callled, on start watching for eth/shh changes ProviderManager.prototype.startPolling = function (data, pollId) { if (!this.provider || !this.provider.poll) { return; } this.polls.push({data: data, id: pollId}); }; /// should be called to stop polling for certain watch changes ProviderManager.prototype.stopPolling = function (pollId) { for (var i = this.polls.length; i--;) { var poll = this.polls[i]; if (poll.id === pollId) { this.polls.splice(i, 1); } } }; web3.provider = new ProviderManager(); web3.setProvider = function(provider) { provider.onmessage = messageHandler; web3.provider.set(provider); web3.provider.sendQueued(); }; /// returns true if provider is installed web3.haveProvider = function() { return !!web3.provider.provider; }; /// should be used when we want to watch something /// it's using inner polling mechanism and is notified about changes var Filter = function(options, impl) { this.impl = impl; this.callbacks = []; var self = this; this.promise = impl.newFilter(options); this.promise.then(function (id) { self.id = id; web3.on(impl.changed, id, self.trigger.bind(self)); web3.provider.startPolling({call: impl.changed, args: [id]}, id); }); }; /// alias for changed* Filter.prototype.arrived = function(callback) { this.changed(callback); }; /// gets called when there is new eth/shh message Filter.prototype.changed = function(callback) { var self = this; this.promise.then(function(id) { self.callbacks.push(callback); }); }; /// trigger calling new message from people Filter.prototype.trigger = function(messages) { for(var i = 0; i < this.callbacks.length; i++) { this.callbacks[i].call(this, messages); } }; /// should be called to uninstall current filter Filter.prototype.uninstall = function() { var self = this; this.promise.then(function (id) { self.impl.uninstallFilter(id); web3.provider.stopPolling(id); web3.off(impl.changed, id); }); }; /// should be called to manually trigger getting latest messages from the client Filter.prototype.messages = function() { var self = this; return this.promise.then(function (id) { return self.impl.getMessages(id); }); }; /// alias for messages Filter.prototype.logs = function () { return this.messages(); }; /// callled when there is new incoming message function messageHandler(data) { if(data._event !== undefined) { web3.trigger(data._event, data._id, data.data); return; } if(data._id) { var cb = web3._callbacks[data._id]; if (cb) { cb.call(this, data.error, data.data); delete web3._callbacks[data._id]; } } } if (typeof(module) !== "undefined") module.exports = web3;