'use strict'; import { getAddress, getContractAddress } from '../utils/address'; import { BigNumber, bigNumberify } from '../utils/bignumber'; import { hexDataLength, hexDataSlice, hexlify, hexStripZeros, isHexString, stripZeros } from '../utils/bytes'; import { namehash } from '../utils/hash'; import { getNetwork } from '../utils/networks'; import { defineReadOnly, inheritable, resolveProperties, shallowCopy } from '../utils/properties'; import { encode as rlpEncode } from '../utils/rlp'; import { parse as parseTransaction } from '../utils/transaction'; import { toUtf8String } from '../utils/utf8'; import { poll } from '../utils/web'; import * as errors from '../errors'; /////////////////////////////// // Imported Abstracts import { Provider } from './abstract-provider'; /////////////////////////////// // Imported Types import { Block, BlockTag, EventType, Filter, Listener, Log, TransactionReceipt, TransactionRequest, TransactionResponse } from './abstract-provider'; import { BigNumberish } from '../utils/bignumber'; import { Transaction } from '../utils/transaction'; import { Network, Networkish } from '../utils/networks'; ////////////////////////////// // Request and Response Checking // @TODO: not any? function check(format: any, object: any): any { var result: any = {}; for (var key in format) { try { var value = format[key](object[key]); if (value !== undefined) { result[key] = value; } } catch (error) { error.checkKey = key; error.checkValue = object[key]; throw error; } } return result; } type CheckFunc = (value: any) => any; function allowNull(check: CheckFunc, nullValue?: any): CheckFunc { return (function(value: any) { if (value == null) { return nullValue; } return check(value); }); } function allowFalsish(check: CheckFunc, replaceValue: any): CheckFunc { return (function(value) { if (!value) { return replaceValue; } return check(value); }); } function arrayOf(check: CheckFunc): CheckFunc { return (function(array: any): Array { if (!Array.isArray(array)) { throw new Error('not an array'); } var result: any = []; array.forEach(function(value) { result.push(check(value)); }); return result; }); } function checkHash(hash: any): string { if (typeof(hash) === 'string' && hexDataLength(hash) === 32) { return hash.toLowerCase(); } errors.throwError('invalid hash', errors.INVALID_ARGUMENT, { arg: 'hash', value: hash }); return null; } function checkNumber(number: any): number { return bigNumberify(number).toNumber(); } // Returns the difficulty as a number, or if too large (i.e. PoA network) null function checkDifficulty(value: BigNumberish): number { let v = bigNumberify(value); try { return v.toNumber(); } catch (error) { } return null; } function checkBoolean(value: any): boolean { if (typeof(value) === 'boolean') { return value; } if (typeof(value) === 'string') { if (value === 'true') { return true; } if (value === 'false') { return false; } } throw new Error('invaid boolean - ' + value); } function checkUint256(uint256: string): string { if (!isHexString(uint256)) { throw new Error('invalid uint256'); } while (uint256.length < 66) { uint256 = '0x0' + uint256.substring(2); } return uint256; } /* function checkString(string) { if (typeof(string) !== 'string') { throw new Error('invalid string'); } return string; } */ function checkBlockTag(blockTag: BlockTag): string { if (blockTag == null) { return 'latest'; } if (blockTag === 'earliest') { return '0x0'; } if (blockTag === 'latest' || blockTag === 'pending') { return blockTag; } if (typeof(blockTag) === 'number') { return hexStripZeros(hexlify(blockTag)); } if (isHexString(blockTag)) { return hexStripZeros(blockTag); } throw new Error('invalid blockTag'); } const formatTransaction = { hash: checkHash, blockHash: allowNull(checkHash, null), blockNumber: allowNull(checkNumber, null), transactionIndex: allowNull(checkNumber, null), confirmations: allowNull(checkNumber, null), from: getAddress, gasPrice: bigNumberify, gasLimit: bigNumberify, to: allowNull(getAddress, null), value: bigNumberify, nonce: checkNumber, data: hexlify, r: allowNull(checkUint256), s: allowNull(checkUint256), v: allowNull(checkNumber), creates: allowNull(getAddress, null), raw: allowNull(hexlify), }; function checkTransactionResponse(transaction: any): TransactionResponse { // Rename gas to gasLimit if (transaction.gas != null && transaction.gasLimit == null) { transaction.gasLimit = transaction.gas; } // Some clients (TestRPC) do strange things like return 0x0 for the // 0 address; correct this to be a real address if (transaction.to && bigNumberify(transaction.to).isZero()) { transaction.to = '0x0000000000000000000000000000000000000000'; } // Rename input to data if (transaction.input != null && transaction.data == null) { transaction.data = transaction.input; } // If to and creates are empty, populate the creates from the transaction if (transaction.to == null && transaction.creates == null) { transaction.creates = getContractAddress(transaction); } // @TODO: use transaction.serialize? Have to add support for including v, r, and s... if (!transaction.raw) { // Very loose providers (e.g. TestRPC) don't provide a signature or raw if (transaction.v && transaction.r && transaction.s) { var raw = [ stripZeros(hexlify(transaction.nonce)), stripZeros(hexlify(transaction.gasPrice)), stripZeros(hexlify(transaction.gasLimit)), (transaction.to || "0x"), stripZeros(hexlify(transaction.value || '0x')), hexlify(transaction.data || '0x'), stripZeros(hexlify(transaction.v || '0x')), stripZeros(hexlify(transaction.r)), stripZeros(hexlify(transaction.s)), ]; transaction.raw = rlpEncode(raw); } } var result = check(formatTransaction, transaction); var networkId = transaction.networkId; if (isHexString(networkId)) { networkId = bigNumberify(networkId).toNumber(); } if (typeof(networkId) !== 'number' && result.v != null) { networkId = (result.v - 35) / 2; if (networkId < 0) { networkId = 0; } networkId = parseInt(networkId); } if (typeof(networkId) !== 'number') { networkId = 0; } result.networkId = networkId; // 0x0000... should actually be null if (result.blockHash && result.blockHash.replace(/0/g, '') === 'x') { result.blockHash = null; } return result; } const formatBlock = { hash: checkHash, parentHash: checkHash, number: checkNumber, timestamp: checkNumber, nonce: allowNull(hexlify), difficulty: checkDifficulty, gasLimit: bigNumberify, gasUsed: bigNumberify, miner: getAddress, extraData: hexlify, transactions: allowNull(arrayOf(checkHash)), }; const formatBlockWithTransactions = shallowCopy(formatBlock); formatBlockWithTransactions.transactions = allowNull(arrayOf(checkTransactionResponse)); function checkBlock(block: any, includeTransactions: boolean): Block { if (block.author != null && block.miner == null) { block.miner = block.author; } return check(includeTransactions ? formatBlockWithTransactions: formatBlock, block); } const formatTransactionRequest = { from: allowNull(getAddress), nonce: allowNull(checkNumber), gasLimit: allowNull(bigNumberify), gasPrice: allowNull(bigNumberify), to: allowNull(getAddress), value: allowNull(bigNumberify), data: allowNull(hexlify), }; function checkTransactionRequest(transaction: any): any { return check(formatTransactionRequest, transaction); } const formatTransactionReceiptLog = { transactionLogIndex: allowNull(checkNumber), transactionIndex: checkNumber, blockNumber: checkNumber, transactionHash: checkHash, address: getAddress, topics: arrayOf(checkHash), data: hexlify, logIndex: checkNumber, blockHash: checkHash, }; function checkTransactionReceiptLog(log: any): any { return check(formatTransactionReceiptLog, log); } const formatTransactionReceipt = { contractAddress: allowNull(getAddress, null), transactionIndex: checkNumber, root: allowNull(checkHash), gasUsed: bigNumberify, logsBloom: allowNull(hexlify), blockHash: checkHash, transactionHash: checkHash, logs: arrayOf(checkTransactionReceiptLog), blockNumber: checkNumber, cumulativeGasUsed: bigNumberify, status: allowNull(checkNumber) }; function checkTransactionReceipt(transactionReceipt: any): TransactionReceipt { //var status = transactionReceipt.status; //var root = transactionReceipt.root; var result: TransactionReceipt = check(formatTransactionReceipt, transactionReceipt); result.logs.forEach(function(entry, index) { if (entry.transactionLogIndex == null) { entry.transactionLogIndex = index; } }); if (transactionReceipt.status != null) { result.byzantium = true; } return result; } function checkTopics(topics: any): any { if (Array.isArray(topics)) { topics.forEach(function(topic) { checkTopics(topic); }); } else if (topics != null) { checkHash(topics); } return topics; } const formatFilter = { fromBlock: allowNull(checkBlockTag, undefined), toBlock: allowNull(checkBlockTag, undefined), address: allowNull(getAddress, undefined), topics: allowNull(checkTopics, undefined), }; function checkFilter(filter: any): any { return check(formatFilter, filter); } const formatLog = { blockNumber: allowNull(checkNumber), blockHash: allowNull(checkHash), transactionIndex: checkNumber, removed: allowNull(checkBoolean), address: getAddress, data: allowFalsish(hexlify, '0x'), topics: arrayOf(checkHash), transactionHash: checkHash, logIndex: checkNumber, } function checkLog(log: any): any { return check(formatLog, log); } ////////////////////////////// // Event Serializeing function serializeTopics(topics: Array>): string { return topics.map((topic) => { if (typeof(topic) === 'string') { return topic; } else if (Array.isArray(topic)) { topic.forEach((topic) => { if (topic !== null && hexDataLength(topic) !== 32) { errors.throwError('invalid topic', errors.INVALID_ARGUMENT, { argument: 'topic', value: topic }); } }); return topic.join(','); } else if (topic === null) { return ''; } return errors.throwError('invalid topic value', errors.INVALID_ARGUMENT, { argument: 'topic', value: topic }); }).join('&'); } function deserializeTopics(data: string): Array> { return data.split(/&/g).map((topic) => { let comps = topic.split(','); if (comps.length === 1) { if (comps[0] === '') { return null; } return topic; } return comps.map((topic) => { if (topic === '') { return null; } return topic; }); }); } function getEventTag(eventName: EventType): string { if (typeof(eventName) === 'string') { if (hexDataLength(eventName) === 20) { return 'address:' + getAddress(eventName); } eventName = eventName.toLowerCase(); if (eventName === 'block' || eventName === 'pending' || eventName === 'error') { return eventName; } else if (hexDataLength(eventName) === 32) { return 'tx:' + eventName; } } else if (Array.isArray(eventName)) { return 'filter::' + serializeTopics(eventName); } else if (eventName && typeof(eventName) === 'object') { return 'filter:' + (eventName.address || '') + ':' + serializeTopics(eventName.topics || []); } throw new Error('invalid event - ' + eventName); } ////////////////////////////// // Helper Object function getTime() { return (new Date()).getTime(); } ////////////////////////////// // Provider Object /** * EventType * - "block" * - "pending" * - "error" * - address * - filter * - topics array * - transaction hash */ type _Event = { listener: Listener; once: boolean; tag: string; } export class BaseProvider extends Provider { private _network: Network; private _events: Array<_Event>; protected _emitted: any; private _pollingInterval: number; private _poller: any; // @TODO: what does TypeScript thing setInterval returns? private _lastBlockNumber: number; // string => BigNumber private _balances: any; private _fastBlockNumber: number; private _fastBlockNumberPromise: Promise; private _fastQueryDate: number; /** * ready * * A Promise that resolves only once the provider is ready. * * Sub-classes that call the super with a network without a chainId * MUST set this. Standard named networks have a known chainId. * */ protected ready: Promise; constructor(network: Networkish | Promise) { super(); errors.checkNew(this, Provider); if (network instanceof Promise) { defineReadOnly(this, 'ready', network.then((network) => { defineReadOnly(this, '_network', network); return network; })); } else { let knownNetwork = getNetwork((network == null) ? 'homestead': network); if (knownNetwork) { defineReadOnly(this, '_network', knownNetwork); defineReadOnly(this, 'ready', Promise.resolve(this._network)); } else { errors.throwError('invalid network', errors.INVALID_ARGUMENT, { arg: 'network', value: network }); } } this._lastBlockNumber = -2; // Balances being watched for changes this._balances = {}; // Events being listened to this._events = []; this._pollingInterval = 4000; // We use this to track recent emitted events; for example, if we emit a "block" of 100 // and we get a `getBlock(100)` request which would result in null, we should retry // until we get a response. This provides devs with a consistent view. Similarly for // transaction hashes. this._emitted = { block: this._lastBlockNumber }; this._fastQueryDate = 0; } private _doPoll(): void { this.getBlockNumber().then((blockNumber) => { this._setFastBlockNumber(blockNumber); // If the block hasn't changed, meh. if (blockNumber === this._lastBlockNumber) { return; } if (this._lastBlockNumber === -2) { this._lastBlockNumber = blockNumber - 1; } // Notify all listener for each block that has passed for (var i = this._lastBlockNumber + 1; i <= blockNumber; i++) { if (this._emitted.block < i) { this._emitted.block = i; // Evict any transaction hashes or block hashes over 12 blocks // old, since they should not return null anyways Object.keys(this._emitted).forEach((key) => { if (key === 'block') { return; } if (this._emitted[key] > i + 12) { delete this._emitted[key]; } }); } this.emit('block', i); } // Sweep balances and remove addresses we no longer have events for var newBalances: any = {}; // Find all transaction hashes we are waiting on this._events.forEach((event) => { let comps = event.tag.split(':'); switch (comps[0]) { case 'tx': { let hash = comps[1]; this.getTransactionReceipt(hash).then((receipt) => { if (!receipt || receipt.blockNumber == null) { return null; } this._emitted['t:' + hash] = receipt.blockNumber; this.emit(hash, receipt); return null; }).catch((error: Error) => { this.emit('error', error); }); break; } case 'address': { let address = comps[1]; if (this._balances[address]) { newBalances[address] = this._balances[address]; } this.getBalance(address, 'latest').then(function(balance) { var lastBalance = this._balances[address]; if (lastBalance && balance.eq(lastBalance)) { return; } this._balances[address] = balance; this.emit(address, balance); return null; }).catch((error: Error) => { this.emit('error', error); }); break; } case 'filter': { let address = comps[1]; let topics = deserializeTopics(comps[2]); let filter = { address: address, fromBlock: this._lastBlockNumber + 1, toBlock: blockNumber, topics: topics } this.getLogs(filter).then((logs) => { if (logs.length === 0) { return; } logs.forEach((log: Log) => { this._emitted['b:' + log.blockHash] = log.blockNumber; this._emitted['t:' + log.transactionHash] = log.blockNumber; this.emit(filter, log); }); return null; }).catch((error: Error) => { this.emit('error', error); }); break; } } }); this._lastBlockNumber = blockNumber; this._balances = newBalances; return null; }).catch((error: Error) => { }); this.doPoll(); } resetEventsBlock(blockNumber: number): void { this._lastBlockNumber = blockNumber; this._doPoll(); } get network(): Network { return this._network; } getNetwork(): Promise { return this.ready; } get blockNumber(): number { if (this._lastBlockNumber < 0) { return null; } return this._lastBlockNumber; } get polling(): boolean { return (this._poller != null); } set polling(value: boolean) { setTimeout(() => { if (value && !this._poller) { this._poller = setInterval(this._doPoll.bind(this), this.pollingInterval); } else if (!value && this._poller) { clearInterval(this._poller); this._poller = null; } }, 0); } get pollingInterval(): number { return this._pollingInterval; } set pollingInterval(value: number) { if (typeof(value) !== 'number' || value <= 0 || parseInt(String(value)) != value) { throw new Error('invalid polling interval'); } this._pollingInterval = value; if (this._poller) { clearInterval(this._poller); this._poller = setInterval(() => { this._doPoll() }, this._pollingInterval); } } _getFastBlockNumber(): Promise { let now = getTime(); // Stale block number, request a newer value if ((now - this._fastQueryDate) > 2 * this._pollingInterval) { console.log('re-poll fbn'); this._fastQueryDate = now; this._fastBlockNumberPromise = this.getBlockNumber().then((blockNumber) => { if (this._fastBlockNumber == null || blockNumber > this._fastBlockNumber) { this._fastBlockNumber = blockNumber; } return this._fastBlockNumber; }); } return this._fastBlockNumberPromise; } _setFastBlockNumber(blockNumber: number): void { // Older block, maybe a stale request if (blockNumber < this._fastBlockNumber) { return; } // Update the time we updated the blocknumber this._fastQueryDate = getTime(); // Newer block number, use it if (blockNumber > this._fastBlockNumber) { this._fastBlockNumber = blockNumber; this._fastBlockNumberPromise = Promise.resolve(blockNumber); } } // @TODO: Add .poller which must be an event emitter with a 'start', 'stop' and 'block' event; // this will be used once we move to the WebSocket or other alternatives to polling waitForTransaction(transactionHash: string, timeout?: number): Promise { return poll(() => { return this.getTransactionReceipt(transactionHash).then((receipt) => { if (receipt == null) { return undefined; } return receipt; }); }, { onceBlock: this }); } getBlockNumber(): Promise { return this.ready.then(() => { return this.perform('getBlockNumber', { }).then((result) => { let value = parseInt(result); if (value != result) { throw new Error('invalid response - getBlockNumber'); } this._setFastBlockNumber(value); return value; }); }); } getGasPrice(): Promise { return this.ready.then(() => { return this.perform('getGasPrice', { }).then((result) => { return bigNumberify(result); }); }); } getBalance(addressOrName: string | Promise, blockTag?: BlockTag | Promise): Promise { return this.ready.then(() => { return resolveProperties({ addressOrName: addressOrName, blockTag: blockTag }).then(({ addressOrName, blockTag }) => { return this.resolveName(addressOrName).then((address) => { var params = { address: address, blockTag: checkBlockTag(blockTag) }; return this.perform('getBalance', params).then((result) => { return bigNumberify(result); }); }); }); }); } getTransactionCount(addressOrName: string | Promise, blockTag?: BlockTag | Promise): Promise { return this.ready.then(() => { return resolveProperties({ addressOrName: addressOrName, blockTag: blockTag }).then(({ addressOrName, blockTag }) => { return this.resolveName(addressOrName).then((address) => { var params = { address: address, blockTag: checkBlockTag(blockTag) }; return this.perform('getTransactionCount', params).then((result) => { return bigNumberify(result).toNumber(); }); }); }); }); } getCode(addressOrName: string | Promise, blockTag?: BlockTag | Promise): Promise { return this.ready.then(() => { return resolveProperties({ addressOrName: addressOrName, blockTag: blockTag }).then(({ addressOrName, blockTag }) => { return this.resolveName(addressOrName).then((address) => { var params = {address: address, blockTag: checkBlockTag(blockTag)}; return this.perform('getCode', params).then((result) => { return hexlify(result); }); }); }); }); } getStorageAt(addressOrName: string | Promise, position: BigNumberish | Promise, blockTag?: BlockTag | Promise): Promise { return this.ready.then(() => { return resolveProperties({ addressOrName: addressOrName, position: position, blockTag: blockTag }).then(({ addressOrName, position, blockTag }) => { return this.resolveName(addressOrName).then((address) => { var params = { address: address, blockTag: checkBlockTag(blockTag), position: hexStripZeros(hexlify(position)), }; return this.perform('getStorageAt', params).then((result) => { return hexlify(result); }); }); }); }); } sendTransaction(signedTransaction: string | Promise): Promise { return this.ready.then(() => { return resolveProperties({ signedTransaction: signedTransaction }).then(({ signedTransaction }) => { var params = { signedTransaction: hexlify(signedTransaction) }; return this.perform('sendTransaction', params).then((hash) => { return this._wrapTransaction(parseTransaction(signedTransaction), hash); }, function (error) { error.transaction = parseTransaction(signedTransaction); if (error.transaction.hash) { (error).transactionHash = error.transaction.hash; } throw error; }); }); }); } // This should be called by any subclass wrapping a TransactionResponse _wrapTransaction(tx: Transaction, hash?: string): TransactionResponse { if (hexDataLength(hash) !== 32) { throw new Error('invalid response - sendTransaction'); } let result: TransactionResponse = tx; // Check the hash we expect is the same as the hash the server reported if (hash != null && tx.hash !== hash) { errors.throwError('Transaction hash mismatch from Provider.sendTransaction.', errors.UNKNOWN_ERROR, { expectedHash: tx.hash, returnedHash: hash }); } this._emitted['t:' + tx.hash] = 'pending'; // @TODO: (confirmations? number, timeout? number) result.wait = () => { return this.waitForTransaction(hash).then((receipt) => { if (receipt.status === 0) { errors.throwError('transaction failed', errors.CALL_EXCEPTION, { transactionHash: hash, transaction: tx }); } return receipt; }); }; return result; } call(transaction: TransactionRequest): Promise { let tx: TransactionRequest = shallowCopy(transaction); return this.ready.then(() => { return resolveProperties(tx).then((tx) => { return this._resolveNames(tx, [ 'to', 'from' ]).then((tx) => { var params = { transaction: checkTransactionRequest(tx) }; return this.perform('call', params).then((result) => { return hexlify(result); }); }); }); }); } estimateGas(transaction: TransactionRequest) { let tx: TransactionRequest = { to: transaction.to, from: transaction.from, data: transaction.data, gasPrice: transaction.gasPrice, value: transaction.value }; return this.ready.then(() => { return resolveProperties(tx).then((tx) => { return this._resolveNames(tx, [ 'to', 'from' ]).then((tx) => { var params = { transaction: checkTransactionRequest(tx) }; return this.perform('estimateGas', params).then((result) => { return bigNumberify(result); }); }); }); }); } getBlock(blockHashOrBlockTag: BlockTag | string | Promise, includeTransactions?: boolean): Promise { return this.ready.then(() => { return resolveProperties({ blockHashOrBlockTag: blockHashOrBlockTag }).then(({ blockHashOrBlockTag }) => { try { var blockHash = hexlify(blockHashOrBlockTag); if (hexDataLength(blockHash) === 32) { return poll(() => { return this.perform('getBlock', { blockHash: blockHash, includeTransactions: !!includeTransactions }).then((block) => { if (block == null) { if (this._emitted['b:' + blockHash] == null) { return null; } return undefined; } return checkBlock(block, includeTransactions); }); }, { onceBlock: this }); } } catch (error) { } try { let blockNumber = -128; let blockTag = checkBlockTag(blockHashOrBlockTag); if (isHexString(blockTag)) { blockNumber = parseInt(blockTag.substring(2), 16); } return poll(() => { return this.perform('getBlock', { blockTag: blockTag, includeTransactions: !!includeTransactions }).then((block) => { if (block == null) { if (blockNumber > this._emitted.block) { return undefined; } return null; } return checkBlock(block, includeTransactions); }); }, { onceBlock: this }); } catch (error) { } throw new Error('invalid block hash or block tag'); }); }); } getTransaction(transactionHash: string): Promise { return this.ready.then(() => { return resolveProperties({ transactionHash: transactionHash }).then(({ transactionHash }) => { let params = { transactionHash: checkHash(transactionHash) }; return poll(() => { return this.perform('getTransaction', params).then((result) => { if (result == null) { if (this._emitted['t:' + transactionHash] == null) { return null; } return undefined; } let tx = BaseProvider.checkTransactionResponse(result); if (tx.blockNumber == null) { tx.confirmations = 0; } else if (tx.confirmations == null) { return this._getFastBlockNumber().then((blockNumber) => { // Add the confirmations using the fast block number (pessimistic) let confirmations = (blockNumber - tx.blockNumber) + 1; if (confirmations <= 0) { confirmations = 1; } tx.confirmations = confirmations; return tx; }); } return tx; }); }, { onceBlock: this }); }); }); } getTransactionReceipt(transactionHash: string): Promise { return this.ready.then(() => { return resolveProperties({ transactionHash: transactionHash }).then(({ transactionHash }) => { let params = { transactionHash: checkHash(transactionHash) }; return poll(() => { return this.perform('getTransactionReceipt', params).then((result) => { if (result == null) { if (this._emitted['t:' + transactionHash] == null) { return null; } return undefined; } return checkTransactionReceipt(result); }); }, { onceBlock: this }); }); }); } getLogs(filter: Filter): Promise> { return this.ready.then(() => { return resolveProperties(filter).then((filter) => { return this._resolveNames(filter, ['address']).then((filter) => { var params = { filter: checkFilter(filter) }; return this.perform('getLogs', params).then((result) => { return arrayOf(checkLog)(result); }); }); }); }); } getEtherPrice(): Promise { return this.ready.then(() => { return this.perform('getEtherPrice', {}).then((result) => { // @TODO: Check valid float return result; }); }); } // @TODO: Could probably use resolveProperties instead? private _resolveNames(object: any, keys: Array): Promise<{ [key: string]: string }> { var promises: Array> = []; var result: { [key: string ]: string } = shallowCopy(object); keys.forEach(function(key) { if (result[key] == null) { return; } promises.push(this.resolveName(result[key]).then((address: string) => { result[key] = address; return; })); }, this); return Promise.all(promises).then(function() { return result; }); } private _getResolver(name: string): Promise { // Get the resolver from the blockchain return this.getNetwork().then((network) => { // No ENS... if (!network.ensAddress) { errors.throwError( 'network does support ENS', errors.UNSUPPORTED_OPERATION, { operation: 'ENS', network: network.name } ); } // keccak256('resolver(bytes32)') var data = '0x0178b8bf' + namehash(name).substring(2); var transaction = { to: network.ensAddress, data: data }; return this.call(transaction).then((data) => { // extract the address from the data if (hexDataLength(data) !== 32) { return null; } return getAddress(hexDataSlice(data, 12)); }); }); } resolveName(name: string | Promise): Promise { // If it is a promise, resolve it then recurse if (name instanceof Promise) { return name.then((addressOrName) => { return this.resolveName(addressOrName); }); } // If it is already an address, nothing to resolve try { return Promise.resolve(getAddress(name)); } catch (error) { } var self = this; var nodeHash = namehash(name); // Get the addr from the resovler return this._getResolver(name).then(function(resolverAddress) { // keccak256('addr(bytes32)') var data = '0x3b3b57de' + nodeHash.substring(2); var transaction = { to: resolverAddress, data: data }; return self.call(transaction); // extract the address from the data }).then(function(data) { if (hexDataLength(data) !== 32) { return null; } var address = getAddress(hexDataSlice(data, 12)); if (address === '0x0000000000000000000000000000000000000000') { return null; } return address; }); } lookupAddress(address: string | Promise): Promise { if (address instanceof Promise) { return address.then((address) => { return this.lookupAddress(address); }); } address = getAddress(address); var name = address.substring(2) + '.addr.reverse' var nodehash = namehash(name); var self = this; return this._getResolver(name).then(function(resolverAddress) { if (!resolverAddress) { return null; } // keccak('name(bytes32)') var data = '0x691f3431' + nodehash.substring(2); var transaction = { to: resolverAddress, data: data }; return self.call(transaction); }).then(function(data) { // Strip off the "0x" data = data.substring(2); // Strip off the dynamic string pointer (0x20) if (data.length < 64) { return null; } data = data.substring(64); if (data.length < 64) { return null; } var length = bigNumberify('0x' + data.substring(0, 64)).toNumber(); data = data.substring(64); if (2 * length > data.length) { return null; } var name = toUtf8String('0x' + data.substring(0, 2 * length)); // Make sure the reverse record matches the foward record return self.resolveName(name).then(function(addr) { if (addr != address) { return null; } return name; }); }); } static checkTransactionResponse(transaction: any): TransactionResponse { return checkTransactionResponse(transaction); } doPoll(): void { } perform(method: string, params: any): Promise { errors.throwError(method + ' not implemented', errors.NOT_IMPLEMENTED, { operation: method }); return null; } protected _startPending(): void { console.log('WARNING: this provider does not support pending events'); } protected _stopPending(): void { } private _addEventListener(eventName: EventType, listener: Listener, once: boolean): void { this._events.push({ tag: getEventTag(eventName), listener: listener, once: once, }); if (eventName === 'pending') { this._startPending(); } this.polling = true; } on(eventName: EventType, listener: Listener): Provider { this._addEventListener(eventName, listener, false); return this; } once(eventName: EventType, listener: Listener): Provider { this._addEventListener(eventName, listener, true); return this; } addEventListener(eventName: EventType, listener: Listener): Provider { return this.on(eventName, listener); } emit(eventName: EventType, ...args: Array): boolean { let result = false; let eventTag = getEventTag(eventName); this._events = this._events.filter((event) => { if (event.tag !== eventTag) { return true; } setTimeout(() => { event.listener.apply(this, args); }, 0); result = true; return !(event.once); }); return result; } listenerCount(eventName?: EventType): number { if (!eventName) { return this._events.length; } let eventTag = getEventTag(eventName); return this._events.filter((event) => { return (event.tag === eventTag); }).length; } listeners(eventName: EventType): Array { let eventTag = getEventTag(eventName); return this._events.filter((event) => { return (event.tag === eventTag); }).map((event) => { return event.listener; }); } removeAllListeners(eventName: EventType): Provider { let eventTag = getEventTag(eventName); this._events = this._events.filter((event) => { return (event.tag !== eventTag); }); if (eventName === 'pending') { this._stopPending(); } if (this._events.length === 0) { this.polling = false; } return this; } removeListener(eventName: EventType, listener: Listener): Provider { let found = false; let eventTag = getEventTag(eventName); this._events = this._events.filter((event) => { if (event.tag !== eventTag) { return true; } if (found) { return true; } found = false; return false; }); if (eventName === 'pending' && this.listenerCount('pending') === 0) { this._stopPending(); } if (this.listenerCount() === 0) { this.polling = false; } return this; } } defineReadOnly(Provider, 'inherits', inheritable(Provider));