## @aeternity/aepp-sdk/es/chain Chain module **Example** ```js import Chain from '@aeternity/aepp-sdk/es/chain' ``` * [@aeternity/aepp-sdk/es/chain](#module_@aeternity/aepp-sdk/es/chain) * [Chain([options])](#exp_module_@aeternity/aepp-sdk/es/chain--Chain) ⇒ `Object` ⏏ * _instance_ * _async_ * *[.sendTransaction(tx, [options])](#module_@aeternity/aepp-sdk/es/chain--Chain+sendTransaction) ⇒ `Object` \| `String`* * *[.height()](#module_@aeternity/aepp-sdk/es/chain--Chain+height) ⇒ `Number`* * *[.awaitHeight([options])](#module_@aeternity/aepp-sdk/es/chain--Chain+awaitHeight) ⇒ `Number`* * *[.poll([options])](#module_@aeternity/aepp-sdk/es/chain--Chain+poll) ⇒ `Object`* * *[.balance(address, [options])](#module_@aeternity/aepp-sdk/es/chain--Chain+balance) ⇒ `Object`* * *[.tx(hash, info)](#module_@aeternity/aepp-sdk/es/chain--Chain+tx) ⇒ `Object`* * *[.getTxInfo(hash)](#module_@aeternity/aepp-sdk/es/chain--Chain+getTxInfo) ⇒ `Object`* * *[.mempool()](#module_@aeternity/aepp-sdk/es/chain--Chain+mempool) ⇒ `Array.<Object>`* * *[.getCurrentGeneration()](#module_@aeternity/aepp-sdk/es/chain--Chain+getCurrentGeneration) ⇒ `Object`* * *[.getGeneration(hashOrHeight)](#module_@aeternity/aepp-sdk/es/chain--Chain+getGeneration) ⇒ `Object`* * *[.getMicroBlockTransactions()](#module_@aeternity/aepp-sdk/es/chain--Chain+getMicroBlockTransactions) ⇒ `Array.<Object>`* * *[.getKeyBlock()](#module_@aeternity/aepp-sdk/es/chain--Chain+getKeyBlock) ⇒ `Object`* * *[.getMicroBlockHeader()](#module_@aeternity/aepp-sdk/es/chain--Chain+getMicroBlockHeader) ⇒ `Object`* * *[.getAccount(address, [options])](#module_@aeternity/aepp-sdk/es/chain--Chain+getAccount) ⇒ `Object`* * *[.txDryRun(txs, accounts, hashOrHeight)](#module_@aeternity/aepp-sdk/es/chain--Chain+txDryRun) ⇒ `Object`* * *[.getInfo()](#module_@aeternity/aepp-sdk/es/chain--Chain+getInfo) ⇒ `Object`* * _static_ * [.waitMined(bool)](#module_@aeternity/aepp-sdk/es/chain--Chain.waitMined) ⇒ `Stamp` ### Chain([options]) ⇒ `Object` ⏏ Basic Chain Stamp Attempting to create instances from the Stamp without overwriting all abstract methods using composition will result in an exception. **Kind**: Exported function **Returns**: `Object` - Chain instance **rtype**: `Stamp` | Param | Type | Default | Description | | --- | --- | --- | --- | | [options] | `Object` | {} | Initializer object | #### *chain.sendTransaction(tx, [options]) ⇒ `Object` \| `String`* Submit a signed transaction for mining **Kind**: instance abstract method of [`Chain`](#exp_module_@aeternity/aepp-sdk/es/chain--Chain) **Returns**: `Object` \| `String` - Transaction or transaction hash **Category**: async **rtype**: `(tx: String, options?: Object) => tx: Promise[Object]|txHash: Promise[String]` | Param | Type | Default | Description | | --- | --- | --- | --- | | tx | `String` | | Transaction to submit | | [options] | `String` | {} | Options to pass to the implementation | | [options.verify] | `String` | false | Verify transaction before broadcast. | #### *chain.height() ⇒ `Number`* Obtain current height of the chain **Kind**: instance abstract method of [`Chain`](#exp_module_@aeternity/aepp-sdk/es/chain--Chain) **Returns**: `Number` - Current chain height **Category**: async **rtype**: `() => height: Number` #### *chain.awaitHeight([options]) ⇒ `Number`* Wait for the chain to reach a specific height **Kind**: instance abstract method of [`Chain`](#exp_module_@aeternity/aepp-sdk/es/chain--Chain) **Returns**: `Number` - Current chain height **Category**: async **rtype**: `(height: Number, options?: Object) => height: Number` | Param | Type | Default | Description | | --- | --- | --- | --- | | [options] | `Object` | {} | Options | | options.interval | `Number` | | Interval (in ms) at which to poll the chain | | options.attempts | `Number` | | Number of polling attempts after which to fail | #### *chain.poll([options]) ⇒ `Object`* Wait for a transaction to be mined **Kind**: instance abstract method of [`Chain`](#exp_module_@aeternity/aepp-sdk/es/chain--Chain) **Returns**: `Object` - The transaction as it was mined **Category**: async **rtype**: `(th: String, options?: Object) => tx: Object` | Param | Type | Default | Description | | --- | --- | --- | --- | | [options] | `Object` | {} | Options | | options.interval | `Number` | | Interval (in ms) at which to poll the chain | | options.blocks | `Number` | | Number of blocks mined after which to fail | #### *chain.balance(address, [options]) ⇒ `Object`* Request the balance of specified account **Kind**: instance abstract method of [`Chain`](#exp_module_@aeternity/aepp-sdk/es/chain--Chain) **Returns**: `Object` - The transaction as it was mined **Category**: async **rtype**: `(address: String, options?: Object) => balance: Number` | Param | Type | Default | Description | | --- | --- | --- | --- | | address | `String` | | The public account address to obtain the balance for | | [options] | `Object` | {} | Options | | options.height | `Number` | | The chain height at which to obtain the balance for (default: top of chain) | | options.hash | `String` | | The block hash on which to obtain the balance for (default: top of chain) | #### *chain.tx(hash, info) ⇒ `Object`* Obtain a transaction based on its hash **Kind**: instance abstract method of [`Chain`](#exp_module_@aeternity/aepp-sdk/es/chain--Chain) **Returns**: `Object` - Transaction **Category**: async **rtype**: `(hash: String, info = false) => tx: Object` | Param | Type | Description | | --- | --- | --- | | hash | `String` | Transaction hash | | info | `Boolean` | Retrieve additional transaction date. Works only for (ContractCreate and ContractCall transaction's) | #### *chain.getTxInfo(hash) ⇒ `Object`* Obtain a transaction info based on its hash **Kind**: instance abstract method of [`Chain`](#exp_module_@aeternity/aepp-sdk/es/chain--Chain) **Returns**: `Object` - Transaction **Category**: async **rtype**: `(hash: String) => tx: Object` | Param | Type | Description | | --- | --- | --- | | hash | `String` | Transaction hash | #### *chain.mempool() ⇒ `Array.<Object>`* Obtain transaction's from mempool **Kind**: instance abstract method of [`Chain`](#exp_module_@aeternity/aepp-sdk/es/chain--Chain) **Returns**: `Array.<Object>` - Transactions **Category**: async **rtype**: `() => txs: [...Object]` #### *chain.getCurrentGeneration() ⇒ `Object`* Obtain current generation **Kind**: instance abstract method of [`Chain`](#exp_module_@aeternity/aepp-sdk/es/chain--Chain) **Returns**: `Object` - Current Generation **Category**: async **rtype**: `() => generation: Object` #### *chain.getGeneration(hashOrHeight) ⇒ `Object`* Get generation by hash or height **Kind**: instance abstract method of [`Chain`](#exp_module_@aeternity/aepp-sdk/es/chain--Chain) **Returns**: `Object` - Generation **Category**: async **rtype**: `(hashOrHeight) => generation: Object` | Param | Type | Description | | --- | --- | --- | | hashOrHeight | `String` \| `Number` | Generation hash or height | #### *chain.getMicroBlockTransactions() ⇒ `Array.<Object>`* Get micro block transactions **Kind**: instance abstract method of [`Chain`](#exp_module_@aeternity/aepp-sdk/es/chain--Chain) **Returns**: `Array.<Object>` - Transactions **Category**: async **rtype**: `(hash) => txs: [...Object]` #### *chain.getKeyBlock() ⇒ `Object`* Get key block **Kind**: instance abstract method of [`Chain`](#exp_module_@aeternity/aepp-sdk/es/chain--Chain) **Returns**: `Object` - Key Block **Category**: async **rtype**: `(hashOrHeight) => keyBlock: Object` #### *chain.getMicroBlockHeader() ⇒ `Object`* Get micro block header **Kind**: instance abstract method of [`Chain`](#exp_module_@aeternity/aepp-sdk/es/chain--Chain) **Returns**: `Object` - Micro block header **Category**: async **rtype**: `(hash) => header: Object` #### *chain.getAccount(address, [options]) ⇒ `Object`* Get account by account public key **Kind**: instance abstract method of [`Chain`](#exp_module_@aeternity/aepp-sdk/es/chain--Chain) **Returns**: `Object` - Account **Category**: async **rtype**: `(address, { hash, height }) => account: Object` | Param | Type | Default | Description | | --- | --- | --- | --- | | address | `String` | | Account public key | | [options] | `Object` | {} | Options | | [options.height] | `Number` | | Get account on specific block by block height | | [options.hash] | `String` | | Get account on specific block by block hash | #### *chain.txDryRun(txs, accounts, hashOrHeight) ⇒ `Object`* Transaction dry-run **Kind**: instance abstract method of [`Chain`](#exp_module_@aeternity/aepp-sdk/es/chain--Chain) **Returns**: `Object` - Result **Category**: async **rtype**: `(txs, accounts, hashOrHeight) => result: Object` | Param | Type | Description | | --- | --- | --- | | txs | `Array` | Array of transaction's | | accounts | `Array` | Array of account's | | hashOrHeight | `String` \| `Number` | hash or height of block on which to make dry-run | #### *chain.getInfo() ⇒ `Object`* Get Node Info **Kind**: instance abstract method of [`Chain`](#exp_module_@aeternity/aepp-sdk/es/chain--Chain) **Returns**: `Object` - Result **Category**: async **rtype**: `() => result: Object` #### Chain.waitMined(bool) ⇒ `Stamp` Reconfigure Stamp to (not) wait until transactions are mined **Kind**: static method of [`Chain`](#exp_module_@aeternity/aepp-sdk/es/chain--Chain) **Returns**: `Stamp` - Reconfigured Chain Stamp **rtype**: `(bool: Boolean) => Stamp` | Param | Type | Description | | --- | --- | --- | | bool | `boolean` | Whether to wait for transactions |