main.js 14 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494
  1. /*
  2. This file is part of ethereum.js.
  3. ethereum.js is free software: you can redistribute it and/or modify
  4. it under the terms of the GNU Lesser General Public License as published by
  5. the Free Software Foundation, either version 3 of the License, or
  6. (at your option) any later version.
  7. ethereum.js is distributed in the hope that it will be useful,
  8. but WITHOUT ANY WARRANTY; without even the implied warranty of
  9. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  10. GNU Lesser General Public License for more details.
  11. You should have received a copy of the GNU Lesser General Public License
  12. along with ethereum.js. If not, see <http://www.gnu.org/licenses/>.
  13. */
  14. /** @file main.js
  15. * @authors:
  16. * Jeffrey Wilcke <jeff@ethdev.com>
  17. * Marek Kotewicz <marek@ethdev.com>
  18. * Marian Oancea <marian@ethdev.com>
  19. * Gav Wood <g@ethdev.com>
  20. * @date 2014
  21. */
  22. function flattenPromise (obj) {
  23. if (obj instanceof Promise) {
  24. return Promise.resolve(obj);
  25. }
  26. if (obj instanceof Array) {
  27. return new Promise(function (resolve) {
  28. var promises = obj.map(function (o) {
  29. return flattenPromise(o);
  30. });
  31. return Promise.all(promises).then(function (res) {
  32. for (var i = 0; i < obj.length; i++) {
  33. obj[i] = res[i];
  34. }
  35. resolve(obj);
  36. });
  37. });
  38. }
  39. if (obj instanceof Object) {
  40. return new Promise(function (resolve) {
  41. var keys = Object.keys(obj);
  42. var promises = keys.map(function (key) {
  43. return flattenPromise(obj[key]);
  44. });
  45. return Promise.all(promises).then(function (res) {
  46. for (var i = 0; i < keys.length; i++) {
  47. obj[keys[i]] = res[i];
  48. }
  49. resolve(obj);
  50. });
  51. });
  52. }
  53. return Promise.resolve(obj);
  54. }
  55. var web3Methods = function () {
  56. return [
  57. { name: 'sha3', call: 'web3_sha3' }
  58. ];
  59. };
  60. var ethMethods = function () {
  61. var blockCall = function (args) {
  62. return typeof args[0] === "string" ? "eth_blockByHash" : "eth_blockByNumber";
  63. };
  64. var transactionCall = function (args) {
  65. return typeof args[0] === "string" ? 'eth_transactionByHash' : 'eth_transactionByNumber';
  66. };
  67. var uncleCall = function (args) {
  68. return typeof args[0] === "string" ? 'eth_uncleByHash' : 'eth_uncleByNumber';
  69. };
  70. var methods = [
  71. { name: 'balanceAt', call: 'eth_balanceAt' },
  72. { name: 'stateAt', call: 'eth_stateAt' },
  73. { name: 'storageAt', call: 'eth_storageAt' },
  74. { name: 'countAt', call: 'eth_countAt'},
  75. { name: 'codeAt', call: 'eth_codeAt' },
  76. { name: 'transact', call: 'eth_transact' },
  77. { name: 'call', call: 'eth_call' },
  78. { name: 'block', call: blockCall },
  79. { name: 'transaction', call: transactionCall },
  80. { name: 'uncle', call: uncleCall },
  81. { name: 'compilers', call: 'eth_compilers' },
  82. { name: 'lll', call: 'eth_lll' },
  83. { name: 'solidity', call: 'eth_solidity' },
  84. { name: 'serpent', call: 'eth_serpent' },
  85. { name: 'logs', call: 'eth_logs' }
  86. ];
  87. return methods;
  88. };
  89. var ethProperties = function () {
  90. return [
  91. { name: 'coinbase', getter: 'eth_coinbase', setter: 'eth_setCoinbase' },
  92. { name: 'listening', getter: 'eth_listening', setter: 'eth_setListening' },
  93. { name: 'mining', getter: 'eth_mining', setter: 'eth_setMining' },
  94. { name: 'gasPrice', getter: 'eth_gasPrice' },
  95. { name: 'account', getter: 'eth_account' },
  96. { name: 'accounts', getter: 'eth_accounts' },
  97. { name: 'peerCount', getter: 'eth_peerCount' },
  98. { name: 'defaultBlock', getter: 'eth_defaultBlock', setter: 'eth_setDefaultBlock' },
  99. { name: 'number', getter: 'eth_number'}
  100. ];
  101. };
  102. var dbMethods = function () {
  103. return [
  104. { name: 'put', call: 'db_put' },
  105. { name: 'get', call: 'db_get' },
  106. { name: 'putString', call: 'db_putString' },
  107. { name: 'getString', call: 'db_getString' }
  108. ];
  109. };
  110. var shhMethods = function () {
  111. return [
  112. { name: 'post', call: 'shh_post' },
  113. { name: 'newIdentity', call: 'shh_newIdentity' },
  114. { name: 'haveIdentity', call: 'shh_haveIdentity' },
  115. { name: 'newGroup', call: 'shh_newGroup' },
  116. { name: 'addToGroup', call: 'shh_addToGroup' }
  117. ];
  118. };
  119. var ethWatchMethods = function () {
  120. var newFilter = function (args) {
  121. return typeof args[0] === 'string' ? 'eth_newFilterString' : 'eth_newFilter';
  122. };
  123. return [
  124. { name: 'newFilter', call: newFilter },
  125. { name: 'uninstallFilter', call: 'eth_uninstallFilter' },
  126. { name: 'getMessages', call: 'eth_filterLogs' }
  127. ];
  128. };
  129. var shhWatchMethods = function () {
  130. return [
  131. { name: 'newFilter', call: 'shh_newFilter' },
  132. { name: 'uninstallFilter', call: 'shh_uninstallFilter' },
  133. { name: 'getMessage', call: 'shh_getMessages' }
  134. ];
  135. };
  136. var setupMethods = function (obj, methods) {
  137. methods.forEach(function (method) {
  138. obj[method.name] = function () {
  139. return flattenPromise(Array.prototype.slice.call(arguments)).then(function (args) {
  140. var call = typeof method.call === "function" ? method.call(args) : method.call;
  141. return {call: call, args: args};
  142. }).then(function (request) {
  143. return new Promise(function (resolve, reject) {
  144. web3.provider.send(request, function (err, result) {
  145. if (!err) {
  146. resolve(result);
  147. return;
  148. }
  149. reject(err);
  150. });
  151. });
  152. }).catch(function(err) {
  153. console.error(err);
  154. });
  155. };
  156. });
  157. };
  158. var setupProperties = function (obj, properties) {
  159. properties.forEach(function (property) {
  160. var proto = {};
  161. proto.get = function () {
  162. return new Promise(function(resolve, reject) {
  163. web3.provider.send({call: property.getter}, function(err, result) {
  164. if (!err) {
  165. resolve(result);
  166. return;
  167. }
  168. reject(err);
  169. });
  170. });
  171. };
  172. if (property.setter) {
  173. proto.set = function (val) {
  174. return flattenPromise([val]).then(function (args) {
  175. return new Promise(function (resolve) {
  176. web3.provider.send({call: property.setter, args: args}, function (err, result) {
  177. if (!err) {
  178. resolve(result);
  179. return;
  180. }
  181. reject(err);
  182. });
  183. });
  184. }).catch(function (err) {
  185. console.error(err);
  186. });
  187. };
  188. }
  189. Object.defineProperty(obj, property.name, proto);
  190. });
  191. };
  192. // TODO: import from a dependency, don't duplicate.
  193. var hexToDec = function (hex) {
  194. return parseInt(hex, 16).toString();
  195. };
  196. var decToHex = function (dec) {
  197. return parseInt(dec).toString(16);
  198. };
  199. var web3 = {
  200. _callbacks: {},
  201. _events: {},
  202. providers: {},
  203. toAscii: function(hex) {
  204. // Find termination
  205. var str = "";
  206. var i = 0, l = hex.length;
  207. if (hex.substring(0, 2) === '0x')
  208. i = 2;
  209. for(; i < l; i+=2) {
  210. var code = hex.charCodeAt(i);
  211. if(code === 0) {
  212. break;
  213. }
  214. str += String.fromCharCode(parseInt(hex.substr(i, 2), 16));
  215. }
  216. return str;
  217. },
  218. fromAscii: function(str, pad) {
  219. pad = pad === undefined ? 32 : pad;
  220. var hex = this.toHex(str);
  221. while(hex.length < pad*2)
  222. hex += "00";
  223. return "0x" + hex;
  224. },
  225. toDecimal: function (val) {
  226. return hexToDec(val.substring(2));
  227. },
  228. fromDecimal: function (val) {
  229. return "0x" + decToHex(val);
  230. },
  231. toEth: function(str) {
  232. var val = typeof str === "string" ? str.indexOf('0x') == 0 ? parseInt(str.substr(2), 16) : parseInt(str) : str;
  233. var unit = 0;
  234. var units = [ 'wei', 'Kwei', 'Mwei', 'Gwei', 'szabo', 'finney', 'ether', 'grand', 'Mether', 'Gether', 'Tether', 'Pether', 'Eether', 'Zether', 'Yether', 'Nether', 'Dether', 'Vether', 'Uether' ];
  235. while (val > 3000 && unit < units.length - 1)
  236. {
  237. val /= 1000;
  238. unit++;
  239. }
  240. var s = val.toString().length < val.toFixed(2).length ? val.toString() : val.toFixed(2);
  241. while (true) {
  242. var o = s;
  243. s = s.replace(/(\d)(\d\d\d[\.\,])/, function($0, $1, $2) { return $1 + ',' + $2; });
  244. if (o == s)
  245. break;
  246. }
  247. return s + ' ' + units[unit];
  248. },
  249. eth: {
  250. prototype: Object(), // jshint ignore:line
  251. watch: function (params) {
  252. return new Filter(params, ethWatch);
  253. }
  254. },
  255. db: {
  256. prototype: Object() // jshint ignore:line
  257. },
  258. shh: {
  259. prototype: Object(), // jshint ignore:line
  260. watch: function (params) {
  261. return new Filter(params, shhWatch);
  262. }
  263. },
  264. on: function(event, id, cb) {
  265. if(web3._events[event] === undefined) {
  266. web3._events[event] = {};
  267. }
  268. web3._events[event][id] = cb;
  269. return this;
  270. },
  271. off: function(event, id) {
  272. if(web3._events[event] !== undefined) {
  273. delete web3._events[event][id];
  274. }
  275. return this;
  276. },
  277. trigger: function(event, id, data) {
  278. var callbacks = web3._events[event];
  279. if (!callbacks || !callbacks[id]) {
  280. return;
  281. }
  282. var cb = callbacks[id];
  283. cb(data);
  284. }
  285. };
  286. setupMethods(web3, web3Methods());
  287. setupMethods(web3.eth, ethMethods());
  288. setupProperties(web3.eth, ethProperties());
  289. setupMethods(web3.db, dbMethods());
  290. setupMethods(web3.shh, shhMethods());
  291. var ethWatch = {
  292. changed: 'eth_changed'
  293. };
  294. setupMethods(ethWatch, ethWatchMethods());
  295. var shhWatch = {
  296. changed: 'shh_changed'
  297. };
  298. setupMethods(shhWatch, shhWatchMethods());
  299. var ProviderManager = function() {
  300. this.queued = [];
  301. this.polls = [];
  302. this.ready = false;
  303. this.provider = undefined;
  304. this.id = 1;
  305. var self = this;
  306. var poll = function () {
  307. if (self.provider && self.provider.poll) {
  308. self.polls.forEach(function (data) {
  309. data.data._id = self.id;
  310. self.id++;
  311. self.provider.poll(data.data, data.id);
  312. });
  313. }
  314. setTimeout(poll, 12000);
  315. };
  316. poll();
  317. };
  318. ProviderManager.prototype.send = function(data, cb) {
  319. data._id = this.id;
  320. if (cb) {
  321. web3._callbacks[data._id] = cb;
  322. }
  323. data.args = data.args || [];
  324. this.id++;
  325. if(this.provider !== undefined) {
  326. this.provider.send(data);
  327. } else {
  328. console.warn("provider is not set");
  329. this.queued.push(data);
  330. }
  331. };
  332. ProviderManager.prototype.set = function(provider) {
  333. if(this.provider !== undefined && this.provider.unload !== undefined) {
  334. this.provider.unload();
  335. }
  336. this.provider = provider;
  337. this.ready = true;
  338. };
  339. ProviderManager.prototype.sendQueued = function() {
  340. for(var i = 0; this.queued.length; i++) {
  341. // Resend
  342. this.send(this.queued[i]);
  343. }
  344. };
  345. ProviderManager.prototype.installed = function() {
  346. return this.provider !== undefined;
  347. };
  348. ProviderManager.prototype.startPolling = function (data, pollId) {
  349. if (!this.provider || !this.provider.poll) {
  350. return;
  351. }
  352. this.polls.push({data: data, id: pollId});
  353. };
  354. ProviderManager.prototype.stopPolling = function (pollId) {
  355. for (var i = this.polls.length; i--;) {
  356. var poll = this.polls[i];
  357. if (poll.id === pollId) {
  358. this.polls.splice(i, 1);
  359. }
  360. }
  361. };
  362. web3.provider = new ProviderManager();
  363. web3.setProvider = function(provider) {
  364. provider.onmessage = messageHandler;
  365. web3.provider.set(provider);
  366. web3.provider.sendQueued();
  367. };
  368. web3.haveProvider = function() {
  369. return !!web3.provider.provider;
  370. };
  371. var Filter = function(options, impl) {
  372. this.impl = impl;
  373. this.callbacks = [];
  374. var self = this;
  375. this.promise = impl.newFilter(options);
  376. this.promise.then(function (id) {
  377. self.id = id;
  378. web3.on(impl.changed, id, self.trigger.bind(self));
  379. web3.provider.startPolling({call: impl.changed, args: [id]}, id);
  380. });
  381. };
  382. Filter.prototype.arrived = function(callback) {
  383. this.changed(callback);
  384. };
  385. Filter.prototype.changed = function(callback) {
  386. var self = this;
  387. this.promise.then(function(id) {
  388. self.callbacks.push(callback);
  389. });
  390. };
  391. Filter.prototype.trigger = function(messages) {
  392. for(var i = 0; i < this.callbacks.length; i++) {
  393. this.callbacks[i].call(this, messages);
  394. }
  395. };
  396. Filter.prototype.uninstall = function() {
  397. var self = this;
  398. this.promise.then(function (id) {
  399. self.impl.uninstallFilter(id);
  400. web3.provider.stopPolling(id);
  401. web3.off(impl.changed, id);
  402. });
  403. };
  404. Filter.prototype.messages = function() {
  405. var self = this;
  406. return this.promise.then(function (id) {
  407. return self.impl.getMessages(id);
  408. });
  409. };
  410. Filter.prototype.logs = function () {
  411. return this.messages();
  412. };
  413. function messageHandler(data) {
  414. if(data._event !== undefined) {
  415. web3.trigger(data._event, data._id, data.data);
  416. return;
  417. }
  418. if(data._id) {
  419. var cb = web3._callbacks[data._id];
  420. if (cb) {
  421. cb.call(this, data.error, data.data);
  422. delete web3._callbacks[data._id];
  423. }
  424. }
  425. }
  426. module.exports = web3;