![](\"https://i.imgur.com/BF1JBPa.png\")
Harmony is a fast and secure blockchain for decentralized applications. Our production Mainnet supports 2 shards of 500 nodes, producing blocks in 2 seconds with finality.
\nOur Effective Proof-of-Stake (EPoS) reduces centralization while supporting stake delegation, reward compounding, and double-sign slashing.
\nThere are 2 API frameworks to interact with the nodes on the Harmony network:
\nRPCs (Remote Procedure Calls)
\nRosetta
\nHarmony has several SDKs that you can use to interact with the network.
\nHarmony is in the process of updating the main SDKs to use the Harmony Rosetta API.
Rosetta and the community has full SDKs for any Rosetta enabled network, including Harmony.
\n\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"API Frameworks","slug":"api-frameworks"},{"content":"SDKs","slug":"sdks"},{"content":"Rosetta SDKs","slug":"rosetta-sdks"}],"owner":"8725027","collectionId":"51f825dd-7a4f-4316-a6ce-15f2d8f1dc65","publishedId":"TVYM3F6h","public":true,"customColor":{"top-bar":"FFFF","right-sidebar":"1B295E","highlight":"00AEE9"},"publishDate":"2020-11-01T14:45:55.000Z"},"item":[{"name":"RPC","item":[{"name":"Smart Contract","item":[{"name":"hmyv2_call","event":[{"listen":"test","script":{"id":"6720d1ad-f45d-47da-a5de-6979211c6144","exec":["console.log(\"Request Body\")","console.log(pm.request.body.raw)","console.log()","console.log(\"Response\")","console.log(pm.response.json())","","pm.test(\"Response should not contain errors.\", () => {"," pm.expect('error' in pm.response.json()).to.equal(false);","})","","pm.test(\"Response should have non-null result field.\", () => {"," pm.expect('result' in pm.response.json()).to.equal(true);"," pm.expect(pm.response.json().result).not.equal(null);","})"],"type":"text/javascript","packages":{}}}],"id":"d34b1f82-9b29-4b68-bac7-52fa0a8884b1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"jsonrpc\": \"2.0\",\n \"id\": 1,\n \"method\": \"hmyv2_call\",\n \"params\": [\n {\n \"to\": \"0x08AE1abFE01aEA60a47663bCe0794eCCD5763c19\"\n },\n \"latest\"\n ]\n}","options":{"raw":{"language":"json"}}},"url":"https://rpc.s0.t.hmny.io","description":"Any Harmony specific details for Rosetta is documented in the section below.
\n
Executes a smart contract code without saving state
\nObject - Smart contract call object
to - String : Smart contract address
from - String : Wallet address, optional
gas - Number : Gas to execute the smart contract call, optional
gasPrice - Number : Gas price to execute smart contract call, optional
value - Number : Value sent with the smart contract call, optional
data - String : Hash of smart contract method and parameters, optional
Number: Block number in decimal, or string tag \"latest\"
String - Return value of the executed smart contract
Executes a smart contract transction without created a transaction and saving data
\nObject - Smart contract call object
to - String : Smart contract addressfrom - String : Wallet address, optionalgas - Number : Gas to execute the smart contract call, optionalgasPrice - Number : Gas price to execute smart contract call, optionalvalue - Number : Value sent with the smart contract call, optionaldata - String : Hash of smart contract method and parameters, optionalNumber : Block number
String - Hex of estimated gas price of smart contract call
String : Smart contract address
String : Hex representation of storage location
Number : Block number
String - Data stored at the smart contract location
Contracts are created via a transaction on-chain. Reference the Transaction sections for more details.
\n","_postman_id":"99e8449b-788d-4b96-8b0e-c7efabccd20f"},{"name":"Staking","item":[{"name":"Delegation","item":[{"name":"hmyv2_getDelegationsByDelegator","event":[{"listen":"test","script":{"id":"b941505a-0bc8-47fa-b19d-9f9875e408ff","exec":["console.log(\"Request Body\")","console.log(pm.request.body.raw)","console.log()","console.log(\"Response\")","console.log(pm.response.json())","","pm.test(\"Response should not contain errors.\", () => {"," pm.expect('error' in pm.response.json()).to.equal(false);","})","","pm.test(\"Response should have non-null result field.\", () => {"," pm.expect('result' in pm.response.json()).to.equal(true);"," pm.expect(pm.response.json().result).not.equal(null);","})"],"type":"text/javascript"}}],"id":"454b032c-6072-4ecb-bf24-38b3d6d2af69","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"jsonrpc\": \"2.0\",\n \"id\": 1,\n \"method\": \"hmyv2_getDelegationsByDelegator\",\n \"params\": [\n \"one1t593eqff9h2cjxz2k7d6q4cg4zmmgtm9veeyd9\"\n ]\n}"},"url":"https://rpc.s0.t.hmny.io","description":"String : Delegator address
JSON Array of JSON Object
validator_address - String : Validator wallet addressdelegator_address - String : Delegator wallet addressamount - Number : Amount delegated in attoreward - Number : Unclaimed rewards in AttoUndelegations - JSON Array : List of pending undelegationsString : Delegator wallet addressNumber : Block numberSee hmyv2_getDelegationsByDelegator for Delegator field descriptions
String : Validator wallet addressArray of Object
validator_address - String : Validator wallet addressdelegator_address - String : Delegator wallet addressamount - Number : Amount delegated in Attoreward - Number : Unclaimed rewards in AttoUndelegations - JSON Array : List of pending undelegationsNone
\nArray of String : List of wallet addresses that have created validators on the network
Number : Page to request (page size is 100). Note, it's not possible to get all data at once.
Array of Object
See hmyv2_getValidatorInformation for Validator field descriptions
Number : Page number. All data at once is no longer possible
Number : Block number
See hmyv2_getValidatorInformation for Validator field descriptions
metrics field is overwritten & will always display current epoch data
None
\nArray of String : List of wallet addresses that are currently elected
String : Validator wallet address
Object
validator - Objectbls-public-keys - Array : List of public BLS keys associated with the validator wallet addresslast-epoch-in-committee - Number : Last epoch any key of the validator was electedmin-self-delegation - Number : Amount that validator must delegate to self in Attomax-total-delegation - Number : Total amount that validator will accept delegations until in Attorate - String : Current commission ratemax-rate - String : Max commission rate a validator can chargemax-change-rate - String : Maximum amount the commission rate can increase in one epochupdate-height - Number : Last block validator editted their validator informationname - String : Validator name, displayed on the Staking Dashboardidentity - String : Validator identity, must be uniquewebsite - String : Validator website, displayed on the Staking Dashboardsecurity-contact - String : Method to contact the validatordetails - String : Validator details, displayed on the Staking Dashboardcreation-height - Number : Block in which the validator was createdaddress - String : Validator wallet addressdelegations - Array : List of delegations\n See hmyv2_getDelegationsByDelegator for delegation object formatmetrics - Object : BLS key earning metrics for current epochby-bls-key - Array of Objectkey - Objectbls-public-key - String : BLS public keygroup-percent - String : Key voting power in shardeffective-stake - String : Effective stake of keyraw-stake - String : Actual stake of keyearning-account - String : Validator wallet addressoverall-percent - String : Percent of effective stakeshard-id - Number : Shard ID that key is onearned-reward - Number : Lifetime reward key has earnedtotal-delegation - Number : Total amount delegated to validatorcurrently-in-committee - Bool : If key is currently electedepos-status - String : Currently elected, eligible to be elected next epoch, or not eligible to be elected next epochepos-winning-stake - String : Total effective stake of the validatorbooted-status - String : Banned statusactive-status - String : Active or Inactivelifetime - Objectreward-accumulated - Number : Lifetime reward accumulated by the validatorblocks - Objectto-sign - Number : Number of blocks available to the validator to signsigned - Number : Number of blocks the validator has signedapr - String : Approximate Return Rateepoch-apr - Array : List of APR per epochEpoch - Number : Epoch numberValue - String : Calculated APR for that epochNumber : Block numberArray of Object
Validator_address - String: total validator stake at the given block in weiNone
\nAccumulatorSnapshot - Number : Total block reward given out in Atto
CurrentStakedPercentage - String : Percent of circulating supply staked
Deviation - String : Change in percent of circulating supply staked
Adjustment - String : Change in circulating supply staked
None
\nepos-median-stake - String : Effective median stakemax-external-slots - Number : Number of available committee slotsepos-slot-winners - Array of Object : Details for each slot winnerslot-owner - String : Wallet address of BLS keybls-public-key - String : BLS public keyraw-stake - String : Actual stakeeposed-stake - String : Effective stakeepos-slot-candidates - Array of Object : Details for each candidatestake - Number : Actual stake in Attokeys-at-auction - Array : List of BLS public keyspercentage-of-total-auction-stake - String : Percent of total network stakestake-per-key - Number : Stake per BLS key in Attovalidator - String : Wallet address of validatorNone
\ntotal-supply - String : Total number of pre-mined tokens
circulating-supply - String : Number of tokens available in the network
epoch-last-block - Number : Last block of epoch
total-staking - Number : Total amount staked in Atto
median-raw-stake - String : Effective median stake in Atto
None
\nprevious - Object : Previously elected committeequorum-deciders - Objectshard-X - Object : Shard of committeepolicy - String : Current election policycount - Number : Number of BLS keys on shardexternal-validator-slot-count - Number : Number of external BLS keys in committeecommittee-members - Objectis-harmony-slot - Boolean : If slot is Harmony ownedearning-account - String : Wallet address that rewards are being paid tobls-public-key - String : BLS public keyvoting-power-unnormalized - String : Voting power of keyvoting-power-% - String : Normalized voting power of keycurrent - Ojbect : Currently elected committee, same format as previous aboveAll staking related RPCs
\n","_postman_id":"cb814338-a4b3-4603-a98f-f569dd4ff1e2"},{"name":"Transaction","item":[{"name":"Cross Shard","item":[{"name":"hmyv2_getCXReceiptByHash","event":[{"listen":"test","script":{"id":"527d616a-1a73-4340-9c6d-5f03aad48e1d","exec":["console.log(\"Request Body\")","console.log(pm.request.body.raw)","console.log()","console.log(\"Response\")","console.log(pm.response.json())","","pm.test(\"Response should not contain errors.\", () => {"," pm.expect('error' in pm.response.json()).to.equal(false);","})","","pm.test(\"Response should have non-null result field.\", () => {"," pm.expect('result' in pm.response.json()).to.equal(true);"," pm.expect(pm.response.json().result).not.equal(null);","})"],"type":"text/javascript"}}],"id":"3d6ad045-800d-4021-aeb5-30a0fbf724fe","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"jsonrpc\": \"2.0\",\n \"id\": 1,\n \"method\": \"hmyv2_getCXReceiptByHash\",\n \"params\": [\n \"0xd324cc57280411dfac5a7ec2987d0b83e25e27a3d5bb5d3531262387331d692b\"\n ]\n}"},"url":"https://rpc.s1.t.hmny.io","description":"Query the CX receipt hash on the receiving shard endpoint
\nString : Cross shard receipt hash
Object
blockHash - String : Block hashblockNumber - Number : Block numberhash - String : Transaction hashfrom - String : Sender wallet addressto - String : Receiver wallet addressshardID - Number : From shardtoShardID - Number : To shardvalue - Number : Amount transferred in AttoNone
\nArray of Object`
receipts - Array of ObjecttxHash - String : Transaction hashfrom - String : Sender wallet addressto - String : Receiver wallet addressshardID - Number : From shardtoShardID - Number : To shardamount - Number : Amount transferred in AttomerkleProof - ObjectblockNum - Number : Block numberblockHash - String : Block hashshardID - Number : Shard ID of originating blockreceiptHash - String : Transaction receipt hashshardIDs - Array of Number : To shardshardHashes - Array of String :header - Objectshard-id - Number : Shard IDblock-header-hash - String : Block header hashblock-number - Number : Block numberview-id - Number : View IDepoch - Number : Epoch numbercommitSig - String : Hex representation of aggregated signaturecommigBitmap - String : Hex representation of aggregated signature bitmapUse this API call to resend the cross shard receipt to the receiving shard to re-process if the transaction did not pay out
\nString : Cross shard receipt hash
Bool : If cross shard receipt was successfully resent or not
None
\nObject
executable-count - String : Staking transaction hashnon-executable-count - String : Type of staking transactionNone
\nArray of Object : List of staking transactions in the transaction pool
See hmyv2_getStakingTransactionByHash for staking transaction object structure.
None
\nArray of Object : List of regular & smart contract transactions in the transaction pool
See hmyv2_getTransactionByHash for transaction object definition
None
\nArray of Object
tx-hash-id - String : Staking transaction hashdirective-kind - String : Type of staking transactiontime-at-rejection - Number : Unix time when the staking transaction was rejected from the poolerror-message - String : Reason for staking transaction rejectionNumber : Block numberNumber : Staking transaction indexSee hmyv2_getStakingTransactionByHash for reply structure
String : Block hashNumber : Staking transaction indexSee hmyv2_getStakingTransactionByHash for reply structure
String : Staking transaction hash
Object
blockHash - String : Block hash in which transaction was finalizedblockNumber - Number : Block number in which transaction was finalizedfrom - String : Sender wallet addresstimestamp - Number : Unix time at which transaction was finalizedgas - Number : Gas limit of transactiongasPrice - Number : Gas price of transaction in Attohash - String : Transaction hashnonce - Number : Wallet nonce of transactiontransactionIndex - Number : Staking transaction index within blocktype - String : Type of staking transactionmsg - Object : Staking transaction data, depending on the type of staking transactionString : Hex representation of signed staking transaction
If transaction has been added to the pool
\nString : Staking transaction hash
If transaction failed to be added to the transaction pool, it will return an error.
\n","urlObject":{"protocol":"https","host":["rpc","s0","t","hmny","io"],"query":[],"variable":[]}},"response":[{"id":"bcf42971-318f-4e71-af39-07a412def968","name":"hmyv2_sendRawStakingTransaction","originalRequest":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"jsonrpc\": \"2.0\",\n \"id\": 1,\n \"method\": \"hmyv2_sendRawStakingTransaction\",\n \"params\": [\n \"0xDEADBEEF\"\n ]\n}"},"url":"https://rpc.s0.t.hmny.io"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Tue, 27 Oct 2020 13:07:49 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"118"},{"key":"Connection","value":"keep-alive"},{"key":"Content-Encoding","value":"gzip"},{"key":"Vary","value":"Origin"}],"cookie":[],"responseTime":null,"body":"{\n \"jsonrpc\": \"2.0\",\n \"id\": 1,\n \"result\": \"0xDEADBEEF\"\n}"}],"_postman_id":"e8c17fe9-e730-4c38-95b3-6f1a5b1b9401"}],"id":"9486208d-2e75-42bc-b5da-9769d338b403","_postman_id":"9486208d-2e75-42bc-b5da-9769d338b403","description":""},{"name":"Transfer","item":[{"name":"hmyv2_getCurrentTransactionErrorSink","event":[{"listen":"test","script":{"id":"4df11ebb-a101-41bd-9364-b460f93a66b9","exec":["console.log(\"Request Body\")","console.log(pm.request.body.raw)","console.log()","console.log(\"Response\")","console.log(pm.response.json())","","pm.test(\"Response should not contain errors.\", () => {"," pm.expect('error' in pm.response.json()).to.equal(false);","})","","pm.test(\"Response should have non-null result field.\", () => {"," pm.expect('result' in pm.response.json()).to.equal(true);"," pm.expect(pm.response.json().result).not.equal(null);","})"],"type":"text/javascript"}}],"id":"9aedbc22-6262-44b1-8276-cd8ae19fa600","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"jsonrpc\": \"2.0\",\n \"id\": 1,\n \"method\": \"hmyv2_getCurrentTransactionErrorSink\",\n \"params\": []\n}"},"url":"https://rpc.s0.t.hmny.io","description":"None
\nArray of Object
tx-hash-id - String : Transaction hashtime-at-rejection - Number : Unix time when the transaction was rejected from the poolerror-message - String : Reason for transaction rejectionString : Block hashNumber : Transaction indexSee hmyv2_getTransactionByHash for reply structure
Number : Block number
Number : Transaction index
See hmyv2_getTransactionByHash for reply structure
String : Transaction hash
blockHash - String : Block hashblockNumber - Number : Block numberfrom - String : Sender wallet addresstimestamp - Number : Unix time at which transaction was finalizedgas - Number : Gas limitgasPrice - Number : Gas price in Attohash - String : Transaction hashinput - String : Transaction data, used for smart contractsnonce - Number : Sender wallet nonceto - String : Receiver wallet addresstransactionIndex - Number : Transaction index in blockvalue - Number : Amount transferredshardID - Number : From shardtoShardID - Number : To shardString : Transaction receipt hash
Object
blockHash - String : Block hash
blockNumber - Number : Block number
contractAddress - String: Smart contract address
cumulativeGasUsed - Number: Gas used for transaction
effectiveGasPrice - Number : Value per Gas and equal to GasPrice
from - String : Sender wallet address
gasUsed - Number : Gas used for the transaction
logs - Array
logsBloom - String : Bloom logs
shardID - Number : Shard ID
status - Number : Status of transaction (0: pending, 1: success)
to - String : Receiver wallet address
transactionHash - String : Transaction hash
transactionIndex - Number : Transaction index within block
String : Hex representation of signed transaction
If transaction has been added to the pool
\nString : Transaction hash
If transaction failed to be added to the transaction pool, it will return an error.
\n","urlObject":{"protocol":"https","host":["rpc","s0","t","hmny","io"],"query":[],"variable":[]}},"response":[{"id":"a6d00bdf-3817-4cef-97f6-00d4cb2a74c4","name":"hmyv2_sendRawTransaction","originalRequest":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"jsonrpc\": \"2.0\",\n \"id\": 1,\n \"method\": \"hmyv2_sendRawTransaction\",\n \"params\": [\n \"0xDEADBEEF\"\n ]\n}"},"url":"https://rpc.s0.t.hmny.io"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Tue, 27 Oct 2020 13:10:30 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"118"},{"key":"Connection","value":"keep-alive"},{"key":"Content-Encoding","value":"gzip"},{"key":"Vary","value":"Origin"}],"cookie":[],"responseTime":null,"body":"{\n \"jsonrpc\": \"2.0\",\n \"id\": 1,\n \"result\": \"0xDEADBEEF\"\n}"}],"_postman_id":"f40d124a-b897-4b7c-baf3-e0dedf8f40a0"}],"id":"8c9746bf-acc3-4d46-baee-52a2d294bc5e","_postman_id":"8c9746bf-acc3-4d46-baee-52a2d294bc5e","description":""}],"id":"e98fee14-f5f7-4296-92ff-5734deedb906","description":"Transaction related RPCs
\n","_postman_id":"e98fee14-f5f7-4296-92ff-5734deedb906"},{"name":"Blockchain","item":[{"name":"Network","item":[{"name":"hmyv2_blockNumber","event":[{"listen":"test","script":{"id":"d155d294-af06-4a85-bacd-1c84ea954ef4","exec":["console.log(\"Request Body\")","console.log(pm.request.body.raw)","console.log()","console.log(\"Response\")","console.log(pm.response.json())","","pm.test(\"Response should not contain errors.\", () => {"," pm.expect('error' in pm.response.json()).to.equal(false);","})","","pm.test(\"Response should have non-null result field.\", () => {"," pm.expect('result' in pm.response.json()).to.equal(true);"," pm.expect(pm.response.json().result).not.equal(null);","})"],"type":"text/javascript"}}],"id":"2602b6c4-a579-4b7c-bce8-85331e0db1a7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"jsonrpc\": \"2.0\",\n \"id\": 1,\n \"method\": \"hmyv2_blockNumber\",\n \"params\": []\n}"},"url":"https://rpc.s0.t.hmny.io","description":"None
\nNumber - Current block number
None
\nNumber : Circulation supply of tokens in ONE
None
\nNumber - Current block number
Number - epoch number
Number - Last block number of given epoch
None
\nArray of Object
hash - String : Parent block hashblock-number - Number : Block numberview-id - Number : View IDsignature - String : Hex representation of aggregated signaturesignature-bitmap - String : Hex representation of aggregated signature bitmapshard-id - Number : Shard IDepoch-number - Number : Block epochNone
\nString - Wallet address of current leader
None
\nNumber - Current average gas price of transactions
None
\nArray of Object
current - Bool : If this node is currently on this shard IDhttp - String : HTTPS API endpoint for this shard IDshardID - Number : Shard IDws - String : Websocket API endpoint for this shard IDNone
\nNumber : Total number of pre-mined tokens
Number : Epoch number
Object
shardID - Number : Shard IDvalidators - Array of Objectaddress : Wallet addressbalance : Balance of walletNumber : Epoch Number
Array : List of public BLS keys in the elected committee
Known issues with RPC not returning correctly
\nNone
\nArray : List of bad blocks in node memoryNone
\nObject
blskey - Array : List of BLS keys on the nodeversion - String : Harmony binary versionnetwork - String : Network name that the node is on (Mainnet or Testnet)chain-config - Objectchain-id - Number : Chain ID for the networkcross-tx-epoch - Number : Epoch at which cross cross shard transactions were enabledcross-link-epoch - Number : Epoch at which cross links were enabledstaking-epoch - Number : Epoch at which staking was enabledprestaking-epoch - Number : Epoch at which pre-staking beganquick-unlock-epoch - Number : Epoch at which undelegations unlocked in one epocheip155-epoch - Number : Epoch at with EIP155 was enableds3-epoch - Number : Epoch at which Mainnet V0 was launchedreceipt-log-epoch - Number : Epoch at which receipt logs were enabledis-leader - Bool : Whether the node is currently leader or notshard-id - Number : Shard that the node is oncurrent-epoch - Number : Current epochblocks-per-epoch - Number : Number of blocks per epoch (only available on Shard 0)role - String : Node type (Validator or ExplorerNode)dns-zone - String : Name of the DNS zoneis-archival - Bool : Whether the node is currently in state pruning mode or notnode-unix-start-time - Number : Start time of node in Unix timep2p-connectivity - Objecttotal-known-peers - Number : Number of known peersconnected - Number : Number of connected peersnot-connected - Number : Number known peers not connectedNone
\nNumber : Protocol version
None
\nString - Number of peers represented as a Hex string
Number : Start block
Number : End block
Object
withSigners - Bool : Include block signer wallet addressesfullTx - Bool : Include full transaction datainclStaking - Bool : Include full staking transactionsArray : List of blocks
See hmy_getBlockByNumber for block structure
Number : Block number
Object
fullTx - Bool : Include full transaction datainclTx - Bool : Include regular transactionsInclStaking - Bool : Include staking transactionsObject
difficulty - Number : Unused, legacy from Ethepoch - Number : Epoch number of blockextraData - String : Hex representation of extra data in the blockgasLimit - Number : Maximum gas that can be used for transactions in the blockgasUsed - Number : Amount of gas used for transactions in the blockhash - String : Block hashlogsBloom - String : Bloom logsminer - String : Wallet address of the leader that proposed this blockmixHash - String : Unused, legacy from Ethnonce - Number : Unused, legacy from Ethnumber - Number : Block numberparentHash - String : Hash of parent blockreceiptsRoot - String : Hash of transaction receipt rootsize - Number : Block size in bytesstakingTransactions - JSON Array: List of staking transactions finalized in this blockstateRoot - String : Hash of state roottimestamp - Number : Unix timestamp of the blocktransactions - JSON Array : List of transactions finalized in this blocktransactionsRoot - String : Hash of transactions rootuncles - JSON Array : Unused, legacy from EthviewID - Number : View IDString : Block hash
Object
fullTx - Bool : Include full transaction datainclTx - Bool : Include regular transactionsInclStaking - Bool : Include staking transactionsSee hmyv2_getBlockByNumber for block structure.
Number : Start block
Number : End block
Object
withSigners - Bool : Include block signer wallet addressesfullTx - Bool : Include full transaction datainclStaking - Bool : Include full staking transactionsArray : List of block signer wallet addresses
Number : Block number
Array : List of block signer public BLS keys
Number : Block number
Number : Number of transactions in block
String : Block hash
Number : Number of transactions in block
Number : Block number
See hmyv2_latestHeader for reply structure
None
\nObject
beacon-chain-header - Objectshard-id - Number : Shard IDblock-header-hash - String : Block header hashblock-number - Number : Block numberview-id - Number : View IDepoch - Number : Epoch numbershard-chain-header - Objectshard-id - Number : Shard IDblock-header-hash - String : Block header hashblock-number - Number : Block numberview-id - Number : View IDepoch - Number : Epoch numberNone
\nObject
blockHash - String : Block hashblockNumber - Number : Block numbershardID - Number : Shard IDleader - String : Wallet address of leader that proposed this block if prestaking, otherwise sha256 hash of leader's public bls keyviewID - Number : View ID of the blockepoch - Number : Epoch of blocktimestamp - String : Timestamp that the block was finalizedunixtime - Number : Timestamp that the block was finalized in Unix timelastCommitSig - String : Hex representation of aggregated signatures of the previous blocklastCommitBitmap - String : Hex representatino of the aggregated signature bitmap of the previous blockHarmony network and node related RPCs
\n","_postman_id":"dc5d625e-7357-46c2-8009-16ca3460b748"},{"name":"Account","item":[{"name":"hmyv2_getBalance","event":[{"listen":"test","script":{"id":"fcc46cab-c096-4a86-8c0f-409b5c6862a6","exec":["console.log(\"Request Body\")","console.log(pm.request.body.raw)","console.log()","console.log(\"Response\")","console.log(pm.response.json())","","pm.test(\"Response should not contain errors.\", () => {"," pm.expect('error' in pm.response.json()).to.equal(false);","})","","pm.test(\"Response should have non-null result field.\", () => {"," pm.expect('result' in pm.response.json()).to.equal(true);"," pm.expect(pm.response.json().result).not.equal(null);","})"],"type":"text/javascript"}}],"id":"da8901d2-d237-4c3b-9d7d-10af9def05c4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"jsonrpc\": \"2.0\",\n \"id\": 1,\n \"method\": \"hmyv2_getBalance\",\n \"params\": [\n \"one15vlc8yqstm9algcf6e94dxqx6y04jcsqjuc3gt\"\n ]\n}\n\n\n"},"url":"https://rpc.s0.t.hmny.io","description":"String - Wallet address
Number - Wallet balance at given block in Atto
String - Wallet address
Number - Block to get balance at
Number - Wallet balance at given block in Atto
String - Wallet address
String - Type of staking transaction (SENT, RECEIVED, ALL)
Number - Number of staking transactions
Object - Transaction history args
address - String : Wallet addresspageIndex - Number : Optional, which page of transactinos to return, default 0pageSize - Number : Optional, how many transactions to display per page, default 1000fullTx - Bool : Optional, return full transaction data or just transaction hashes, default falsetxType - String: Optional, which type of transactions to display (\"ALL\", \"RECEIVED\", or \"SENT\"), default \"ALL\"order - String: Optional, sort transactions in ascending or descending order based on timestamp (\"ASC\" or \"DESC\"), default \"ASC\"If fullTx is true
Array of Object : List of staking transactions
blockHash - String: Block hash that transaction was finalized. null if the transaction is pending.blockNumber - Number: Block number that transaction was finalized. null if the transaction is pending.from - String: Wallet address of sendertimestamp - Number : Timestamp in Unixtime when transaction was finalizedgasPrice - Number: Gas price in Attogas - Number: Gas limit in Attohash - String: Transaction hashnonce - Number: Wallet nonce for the transactiontransactionIndex - Number: Index of transaction in block. null if the transaction is pending.type - String : Type of staking transactionmsg - Object: Staking transaction dataIf fullTx is false
Array of String : List of staking transaction hashes
String - Wallet address
String - Type of staking transaction (SENT, RECEIVED, ALL)
Number - Number of transactions
Object - Transaction history args
address - String : Wallet addresspageIndex - Number : Optional, which page of transactions to return, default 0pageSize - Number : Optional, how many transactions to display per page, default 1000fullTx - Bool : Optional, return full transaction data or just transaction hashes, default falsetxType - String: Optional, which type of transactions to display (\"ALL\", \"RECEIVED\", or \"SENT\"), default \"ALL\"order - String: Optional, sort transactions in ascending or descending order based on timestamp (\"ASC\" or \"DESC\"), default \"ASC\"If fullTx true
Array of Object
blockHash - String: Block hash that transaction was finalized. null if the transaction is pending.blockNumber - Number: Block number that transaction was finalized. null if the transaction is pending.from - String : Wallet addresstimestamp - Number : Timestamp in Unix time when transaction was finalizedgas - Number: Gas limit in AttogasPrice - Number: Gas price in Attohash - String: Transaction hashinput - String: Transaction data, used for smart contractsnonce - Number: Wallet nonce for the transactionto - String: Wallet address of receivertransactionIndex - Number: Index of transaction in block. null if the transaction is pending.value - Number: Amount transfered in AttoshardID - Number : Shard where amount is fromtoShardID - Number : Shard where the amount is sentIf fullTx is false
Array of String : List of transaction hashesWallet related RPCs
\n","_postman_id":"e1554965-be49-4e63-9d1a-193147fb4037"}],"id":"2cd1b3c9-2e76-4362-865b-24a95819cf44","description":"A Remote Procedure Call (RPC) executes a procedure/method in a different address-space or machine — in this context, it is a node on the Harmony network.
\nFor reference, all RPC methods that can be called on a Harmony node (along with implementation details) can be seen here.
\nS1 nodes behind the endpoints are running in archival mode with a full archival DB. Please take note on Shard 0 difference.
\nAll nodes behind the endpoints are running in archival mode with a full archival DB.
\nAll requests are POST
All request data follow the standard JSON RPC 2.0 format with the following 4 fields in the data object
\nThe endpoint URL can be your own node or one of the endpoints (listed above) ran by Harmony
\nWhen developing on a local network, the endpoint URLs are:
\nAn easy tool you can use to interact with the RPC Methods is Postman. When using Postman, ensure that you have the following things configured:
\nPOST to the correct endpoint. Note that the local network uses http not https![](\"https://i.imgur.com/iL4pETt.png\")
\n\nContent-Type with the value application/json![](\"https://i.imgur.com/du4UMbx.png\")
\n\n![](\"https://i.imgur.com/ItdqK1E.png\")
\n\nThis endpoint returns a list of NetworkIdentifiers that the Rosetta server supports.
Reference Rosetta Documentation
\nThe Harmony network identifier has the following values:
\nblockchain - String: Always \"Harmony\"network - String: Either \"Testnet\" or \"Mainnet\"sub_network_identifier - SubNetworkIdentifier: network - String: Either \"shard 0\" or \"shard 1\" or \"shard 2\" or \"shard 3\" depending on the shardmetadata - Object:is_beacon - Bool: true for shard 0, false in all other casesThis endpoint returns the version information and allowed network-specific types for a shard's NetworkIdentifier on Harmony.
Note that not all shards support the same types/options.
Reference Rosetta Documentation
\nrosetta_version is the spec version that the node currently implements.node_version is the version of the node program that is running the Rosetta service.operation_types contains all the operations that can be done on the Harmony network:
\n\n
operation_statuses contains all of the on-chain status for any of the operation_types on Harmony:
\n\n
errors contains all of the supported Rosetta errors:
\n\n
historical_balance_lookup is only true for nodes running in archival mode.
This endpoint returns the current status of the network.
\nReference Rosetta Documentation
\nOnly a node running in archival mode can ensure full Rosetta functionality on any block. Nodes running in state-pruned mode (most validators) can only ensure full Rosetta functionality on the last 50-ish synced blocks.
\nYou may see up to what block is supported with the oldest_block_identifier in this response. A node that supports all blocks will not have the oldest_block_identifier in the response.
There are 3 sync stages:
\n\n\n
This endpoint returns all of the connected peers along with what p2p topic each peer is connected with. The p2p topics for a peer can be found in the metadata of each Peer object under the topics key. The topics are an array of strings where each string is a topic the node is connected with for the Peer.
This endpoint gets an array of all AccountBalances for an AccountIdentifier and the BlockIdentifier at which the balance lookup was performed.
Reference Rosetta Documentation
\nOnly a node running in archival mode (with a full archival DB) can fetch the balance of an account at any block. Nodes running in state-pruned mode (most validators) can only fetch account balance at the last 50-ish synced blocks. For state-pruned nodes, any block after the oldest_block_identifier (from the /network/status endpoint) will return the balance at that block.
This endpoint gets a block by its BlockIdentifier. Requests to this endpoint are idempotent.
Reference Rosetta Documentation
\nFor Harmony, an epoch is an interval of consecutive blocks that are validated with a fixed committee of validators. Every epoch, a new committee of validators is elected.
\nThe epoch of the block can be found in the metadata of the block.
This endpoint gets a transaction in a block by its Transaction Identifier and Block Identifier.
\nReference Rosetta Documentation
\nEach type of transaction on Harmony executes a certain set of operations (from /network/options). This relationship is mapped below:
\n\n
Some internal workings of the chain are expressed as special transactions since it changes the native token balance of accounts in the network. They are considered special since they cannot be directly created by a user, instead, they are the effects of previous transactions or derived from genesis settings.
\nAll special transactions have the following identifier format to guarantee uniqueness: <block_hash>_<address>_<special_tx_type>. For example, here is a pre-staking block reward transaction identifier: 0x996be9b22c329f7b4e2f9a794414d9f6eec49ad40d28730ee085c8a9291ae91a_one14e5ffwdejnt7njgq54d9w8gltwrggdusyw7y5p_reward.
All of the special transaction types:
\n\n\n","urlObject":{"protocol":"https","path":["block","transaction"],"host":["rosetta","s0","b","hmny","io"],"query":[],"variable":[]}},"response":[{"id":"51fdb9ea-b569-406c-bfe5-3108fd8e42fb","name":"/block/transaction (Staking - CollectRewards)","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"network_identifier\": {\n \"blockchain\": \"Harmony\",\n \"network\": \"Testnet\",\n \"sub_network_identifier\": {\n \"network\": \"shard 0\",\n \"metadata\": {\n \"is_beacon\": true\n }\n }\n },\n \"transaction_identifier\": {\n \"hash\": \"0x345f32782f17ff593a1e8dbb4f69fbb27a17bfb5d0beada8112644b2d0de8e45\"\n },\n \"block_identifier\": {\n \"index\": 2242196,\n \"hash\": \"0x984c994cf5598926d324762c53f305b91d44c61f8bb2f9796549cb43cb5ab55e\"\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://rosetta.s0.b.hmny.io/block/transaction"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.14.0 (Ubuntu)"},{"key":"Date","value":"Fri, 30 Oct 2020 08:02:05 GMT"},{"key":"Content-Type","value":"application/json; charset=UTF-8"},{"key":"Content-Length","value":"838"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Headers","value":"Origin, X-Requested-With, Content-Type, Accept"},{"key":"Access-Control-Allow-Methods","value":"GET, POST,OPTIONS"},{"key":"Access-Control-Allow-Origin","value":"*"}],"cookie":[],"responseTime":null,"body":"{\n \"transaction\": {\n \"transaction_identifier\": {\n \"hash\": \"0x345f32782f17ff593a1e8dbb4f69fbb27a17bfb5d0beada8112644b2d0de8e45\"\n },\n \"operations\": [\n {\n \"operation_identifier\": {\n \"index\": 0\n },\n \"type\": \"Gas\",\n \"status\": \"success\",\n \"account\": {\n \"address\": \"one1ru5znrwvrqg3caysp8pfugx4t9uj4wyz99pv0f\",\n \"metadata\": {\n \"hex_address\": \"0x1f28298Dcc18111c749009C29E20d559792aB882\"\n }\n },\n \"amount\": {\n \"value\": \"-21352000000000\",\n \"currency\": {\n \"symbol\": \"ONE\",\n \"decimals\": 18\n }\n }\n },\n {\n \"operation_identifier\": {\n \"index\": 1\n },\n \"related_operations\": [\n {\n \"index\": 0\n }\n ],\n \"type\": \"CollectRewards\",\n \"status\": \"success\",\n \"account\": {\n \"address\": \"one1ru5znrwvrqg3caysp8pfugx4t9uj4wyz99pv0f\",\n \"metadata\": {\n \"hex_address\": \"0x1f28298Dcc18111c749009C29E20d559792aB882\"\n }\n },\n \"amount\": {\n \"value\": \"33205856599775202310\",\n \"currency\": {\n \"symbol\": \"ONE\",\n \"decimals\": 18\n }\n },\n \"metadata\": {\n \"delegatorAddress\": \"one1ru5znrwvrqg3caysp8pfugx4t9uj4wyz99pv0f\"\n }\n }\n ]\n }\n}"},{"id":"8ac66fa2-6cbd-49e4-9034-e17cf7af7c50","name":"/block/transaction (Staking - Delegate)","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"network_identifier\": {\n \"blockchain\": \"Harmony\",\n \"network\": \"Testnet\",\n \"sub_network_identifier\": {\n \"network\": \"shard 0\",\n \"metadata\": {\n \"is_beacon\": true\n }\n }\n },\n \"transaction_identifier\": {\n \"hash\": \"0x398c63f6958547bf65f7055175fb9428a9c644de205c8fc19e8deadc41104201\"\n },\n \"block_identifier\": {\n \"index\": 2241386,\n \"hash\": \"0x0376f64e703a25d41b4af91da402183f3b8cc9ab8b8c3f781377d99dd2c67555\"\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://rosetta.s0.b.hmny.io/block/transaction"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.14.0 (Ubuntu)"},{"key":"Date","value":"Fri, 30 Oct 2020 08:04:09 GMT"},{"key":"Content-Type","value":"application/json; charset=UTF-8"},{"key":"Content-Length","value":"936"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Headers","value":"Origin, X-Requested-With, Content-Type, Accept"},{"key":"Access-Control-Allow-Methods","value":"GET, POST,OPTIONS"},{"key":"Access-Control-Allow-Origin","value":"*"}],"cookie":[],"responseTime":null,"body":"{\n \"transaction\": {\n \"transaction_identifier\": {\n \"hash\": \"0x398c63f6958547bf65f7055175fb9428a9c644de205c8fc19e8deadc41104201\"\n },\n \"operations\": [\n {\n \"operation_identifier\": {\n \"index\": 0\n },\n \"type\": \"Gas\",\n \"status\": \"success\",\n \"account\": {\n \"address\": \"one1kh6ypdwxy90wmsdjuy45h9j05v0h47nam9l4l4\",\n \"metadata\": {\n \"hex_address\": \"0xB5f440B5c6215eEDc1b2E12b4b964fa31f7afa7d\"\n }\n },\n \"amount\": {\n \"value\": \"-218520000000000\",\n \"currency\": {\n \"symbol\": \"ONE\",\n \"decimals\": 18\n }\n }\n },\n {\n \"operation_identifier\": {\n \"index\": 1\n },\n \"related_operations\": [\n {\n \"index\": 0\n }\n ],\n \"type\": \"Delegate\",\n \"status\": \"success\",\n \"account\": {\n \"address\": \"one1kh6ypdwxy90wmsdjuy45h9j05v0h47nam9l4l4\",\n \"metadata\": {\n \"hex_address\": \"0xB5f440B5c6215eEDc1b2E12b4b964fa31f7afa7d\"\n }\n },\n \"amount\": {\n \"value\": \"-178889020491000000000000\",\n \"currency\": {\n \"symbol\": \"ONE\",\n \"decimals\": 18\n }\n },\n \"metadata\": {\n \"amount\": 1.78889020491e+23,\n \"delegatorAddress\": \"one1kh6ypdwxy90wmsdjuy45h9j05v0h47nam9l4l4\",\n \"validatorAddress\": \"one1ru5znrwvrqg3caysp8pfugx4t9uj4wyz99pv0f\"\n }\n }\n ]\n }\n}"},{"id":"90aef103-d25a-47ba-bcb3-773d4cb47257","name":"/block/transaction (Staking - EditValidator)","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"network_identifier\": {\n \"blockchain\": \"Harmony\",\n \"network\": \"Testnet\",\n \"sub_network_identifier\": {\n \"network\": \"shard 0\",\n \"metadata\": {\n \"is_beacon\": true\n }\n }\n },\n \"transaction_identifier\": {\n \"hash\": \"0x938441b681fc0df7cba343367b584a458f66bf187cee7906857ff4ac8e1191ca\"\n },\n \"block_identifier\": {\n \"index\": 2242209,\n \"hash\": \"0x5b632da5af25a1b68433e71f271f6ecbf9f74ebdbeafaab3fe9e35e838636819\"\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://rosetta.s0.b.hmny.io/block/transaction"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.14.0 (Ubuntu)"},{"key":"Date","value":"Fri, 30 Oct 2020 08:03:13 GMT"},{"key":"Content-Type","value":"application/json; charset=UTF-8"},{"key":"Content-Length","value":"1002"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Headers","value":"Origin, X-Requested-With, Content-Type, Accept"},{"key":"Access-Control-Allow-Methods","value":"GET, POST,OPTIONS"},{"key":"Access-Control-Allow-Origin","value":"*"}],"cookie":[],"responseTime":null,"body":"{\n \"transaction\": {\n \"transaction_identifier\": {\n \"hash\": \"0x938441b681fc0df7cba343367b584a458f66bf187cee7906857ff4ac8e1191ca\"\n },\n \"operations\": [\n {\n \"operation_identifier\": {\n \"index\": 0\n },\n \"type\": \"Gas\",\n \"status\": \"success\",\n \"account\": {\n \"address\": \"one170xqsfzm4xdmuyax54t5pvtp5l5yt66u50ctrp\",\n \"metadata\": {\n \"hex_address\": \"0xf3Cc08245BA99BBE13A6A55740b161A7E845eB5c\"\n }\n },\n \"amount\": {\n \"value\": \"-21560000000000\",\n \"currency\": {\n \"symbol\": \"ONE\",\n \"decimals\": 18\n }\n }\n },\n {\n \"operation_identifier\": {\n \"index\": 1\n },\n \"related_operations\": [\n {\n \"index\": 0\n }\n ],\n \"type\": \"EditValidator\",\n \"status\": \"success\",\n \"account\": {\n \"address\": \"one170xqsfzm4xdmuyax54t5pvtp5l5yt66u50ctrp\",\n \"metadata\": {\n \"hex_address\": \"0xf3Cc08245BA99BBE13A6A55740b161A7E845eB5c\"\n }\n },\n \"amount\": {\n \"value\": \"0\",\n \"currency\": {\n \"symbol\": \"ONE\",\n \"decimals\": 18\n }\n },\n \"metadata\": {\n \"commissionRate\": 0,\n \"details\": \"\",\n \"identity\": \"\",\n \"maxTotalDelegation\": 0,\n \"minSelfDelegation\": 0,\n \"name\": \"\",\n \"securityContact\": \"\",\n \"slotPubKeyToAdd\": null,\n \"slotPubKeyToRemove\": null,\n \"validatorAddress\": \"one170xqsfzm4xdmuyax54t5pvtp5l5yt66u50ctrp\",\n \"website\": \"\"\n }\n }\n ]\n }\n}"},{"id":"bb34e2d6-44dd-4ced-8ee7-3b84c565e066","name":"/block/transaction (Native Transfer)","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"network_identifier\": {\n \"blockchain\": \"Harmony\",\n \"network\": \"Testnet\",\n \"sub_network_identifier\": {\n \"network\": \"shard 0\",\n \"metadata\": {\n \"is_beacon\": true\n }\n }\n },\n \"transaction_identifier\": {\n \"hash\": \"0x133a3ac6d8a9f0ffb377d4c8bb805dbfbafe876eb3a2cd72142bafb23ea93a4f\"\n },\n \"block_identifier\": {\n \"index\": 2241709,\n \"hash\": \"0x9480debdba5755ede7545d886793fa141ad8ae9ec76cc9ecef81da8fb8ebdd02\"\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://rosetta.s0.b.hmny.io/block/transaction"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.14.0 (Ubuntu)"},{"key":"Date","value":"Fri, 30 Oct 2020 08:00:56 GMT"},{"key":"Content-Type","value":"application/json; charset=UTF-8"},{"key":"Content-Length","value":"1070"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Headers","value":"Origin, X-Requested-With, Content-Type, Accept"},{"key":"Access-Control-Allow-Methods","value":"GET, POST,OPTIONS"},{"key":"Access-Control-Allow-Origin","value":"*"}],"cookie":[],"responseTime":null,"body":"{\n \"transaction\": {\n \"transaction_identifier\": {\n \"hash\": \"0x133a3ac6d8a9f0ffb377d4c8bb805dbfbafe876eb3a2cd72142bafb23ea93a4f\"\n },\n \"operations\": [\n {\n \"operation_identifier\": {\n \"index\": 0\n },\n \"type\": \"Gas\",\n \"status\": \"success\",\n \"account\": {\n \"address\": \"one1ru5znrwvrqg3caysp8pfugx4t9uj4wyz99pv0f\",\n \"metadata\": {\n \"hex_address\": \"0x1f28298Dcc18111c749009C29E20d559792aB882\"\n }\n },\n \"amount\": {\n \"value\": \"-2100000000000000\",\n \"currency\": {\n \"symbol\": \"ONE\",\n \"decimals\": 18\n }\n }\n },\n {\n \"operation_identifier\": {\n \"index\": 1\n },\n \"related_operations\": [\n {\n \"index\": 0\n }\n ],\n \"type\": \"NativeTransfer\",\n \"status\": \"success\",\n \"account\": {\n \"address\": \"one1ru5znrwvrqg3caysp8pfugx4t9uj4wyz99pv0f\",\n \"metadata\": {\n \"hex_address\": \"0x1f28298Dcc18111c749009C29E20d559792aB882\"\n }\n },\n \"amount\": {\n \"value\": \"-2423\",\n \"currency\": {\n \"symbol\": \"ONE\",\n \"decimals\": 18\n }\n }\n },\n {\n \"operation_identifier\": {\n \"index\": 2\n },\n \"related_operations\": [\n {\n \"index\": 1\n }\n ],\n \"type\": \"NativeTransfer\",\n \"status\": \"success\",\n \"account\": {\n \"address\": \"one18nxqvxhvq0vy9a4ql2tzfz7uauwh6q2sauhjeh\",\n \"metadata\": {\n \"hex_address\": \"0x3cCC061AEC03D842F6a0fa96248bDceF1d7d0150\"\n }\n },\n \"amount\": {\n \"value\": \"2423\",\n \"currency\": {\n \"symbol\": \"ONE\",\n \"decimals\": 18\n }\n }\n }\n ]\n }\n}"}],"_postman_id":"6e1ccb83-7869-4e96-9a62-aa2bafc58f5e"},{"name":"/mempool","id":"33f0cdc6-5f94-4fbe-b794-c53c0af4ce15","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"network_identifier\": {\n \"blockchain\": \"Harmony\",\n \"network\": \"Testnet\",\n \"sub_network_identifier\": {\n \"network\": \"shard 0\",\n \"metadata\": {\n \"is_beacon\": true\n }\n }\n },\n \"metadata\": {}\n}","options":{"raw":{"language":"json"}}},"url":"https://rosetta.s0.b.hmny.io/mempool","description":"
This endpoint gets all Transaction Identifiers in the mempool.
\nReference Rosetta Documentation
\nThe Harmony transaction pool contains 'pending' transactions (transactions that can be added to the next block) and 'queued' transactions (transactions that can only be added to some block after the next block). Due to the short block time, this endpoint returns all of the mempool transactions without any easy way to discern which list it was from. In general, transactions that are always in the mempool across multiple blocks, tend to be these 'queued' transactions.
\nNormally, stuck transactions tend to be 'queued' transaction because they were submitted with a wrong nonce or some previous transaction from the same account got rejected (for insufficient funds, nonce to low, etc...). All 'queued' transactions will be dropped after an hour if the sender's account does not submit any more transactions. Alternatively, you can replace the 'queued' transaction (say to have it transfer 0 tokens) by paying double the gas fee for that transaction, then submit a new (correct) transaction afterward.
\n","urlObject":{"protocol":"https","path":["mempool"],"host":["rosetta","s0","b","hmny","io"],"query":[],"variable":[]}},"response":[{"id":"6be754dc-cd8b-4e7c-885a-ee2773683150","name":"/mempool","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"network_identifier\": {\n \"blockchain\": \"Harmony\",\n \"network\": \"Testnet\",\n \"sub_network_identifier\": {\n \"network\": \"shard 0\",\n \"metadata\": {\n \"is_beacon\": true\n }\n }\n },\n \"metadata\": {}\n}","options":{"raw":{"language":"json"}}},"url":"https://rosetta.s0.b.hmny.io/mempool"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.14.0 (Ubuntu)"},{"key":"Date","value":"Fri, 30 Oct 2020 08:25:29 GMT"},{"key":"Content-Type","value":"application/json; charset=UTF-8"},{"key":"Content-Length","value":"108"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Headers","value":"Origin, X-Requested-With, Content-Type, Accept"},{"key":"Access-Control-Allow-Methods","value":"GET, POST,OPTIONS"},{"key":"Access-Control-Allow-Origin","value":"*"}],"cookie":[],"responseTime":null,"body":"{\n \"transaction_identifiers\": [\n {\n \"hash\": \"0x7c4e7cb00d0f8d88a5198e17f8223390e3dd7355a6f1444744f214d4e3e81b53\"\n }\n ]\n}"}],"_postman_id":"33f0cdc6-5f94-4fbe-b794-c53c0af4ce15"},{"name":"/mempool/transaction","id":"9a6b2616-11bb-4f28-a851-ac554456c571","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"network_identifier\": {\n \"blockchain\": \"Harmony\",\n \"network\": \"Testnet\",\n \"sub_network_identifier\": {\n \"network\": \"shard 0\",\n \"metadata\": {\n \"is_beacon\": true\n }\n }\n },\n \"transaction_identifier\": {\n \"hash\": \"0xd30e75e68c6f4d28e81848805edf1d79baa7d3a8a08028b09077df2b319a296d\"\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://rosetta.s0.b.hmny.io/mempool/transaction","description":"This endpoint gets a transaction in the mempool by its Transaction Identifier.
Note that transactions may not be fully parsable until they are in a block.
Reference Rosetta Documentation
\nMost contract related transactions will not have any EVM related information (logs, status, contract code, etc..) until they are finalized on-chain.
\n","urlObject":{"protocol":"https","path":["mempool","transaction"],"host":["rosetta","s0","b","hmny","io"],"query":[],"variable":[]}},"response":[{"id":"d61e7f01-0bc9-4bdd-a1cd-5f09066e33fc","name":"/mempool/transaction","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"network_identifier\": {\n \"blockchain\": \"Harmony\",\n \"network\": \"Testnet\",\n \"sub_network_identifier\": {\n \"network\": \"shard 0\",\n \"metadata\": {\n \"is_beacon\": true\n }\n }\n },\n \"transaction_identifier\": {\n \"hash\": \"0xd30e75e68c6f4d28e81848805edf1d79baa7d3a8a08028b09077df2b319a296d\"\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://rosetta.s0.b.hmny.io/mempool/transaction"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.14.0 (Ubuntu)"},{"key":"Date","value":"Fri, 30 Oct 2020 08:31:18 GMT"},{"key":"Content-Type","value":"application/json; charset=UTF-8"},{"key":"Content-Length","value":"1100"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Headers","value":"Origin, X-Requested-With, Content-Type, Accept"},{"key":"Access-Control-Allow-Methods","value":"GET, POST,OPTIONS"},{"key":"Access-Control-Allow-Origin","value":"*"}],"cookie":[],"responseTime":null,"body":"{\n \"transaction\": {\n \"transaction_identifier\": {\n \"hash\": \"0xd30e75e68c6f4d28e81848805edf1d79baa7d3a8a08028b09077df2b319a296d\"\n },\n \"operations\": [\n {\n \"operation_identifier\": {\n \"index\": 0\n },\n \"type\": \"Gas\",\n \"status\": \"success\",\n \"account\": {\n \"address\": \"one1zksj3evekayy90xt4psrz8h6j2v3hla4qwz4ur\",\n \"metadata\": {\n \"hex_address\": \"0x15a128e599b74842BCcBa860311Efa92991bffb5\"\n }\n },\n \"amount\": {\n \"value\": \"-21000000000000\",\n \"currency\": {\n \"symbol\": \"ONE\",\n \"decimals\": 18\n }\n }\n },\n {\n \"operation_identifier\": {\n \"index\": 1\n },\n \"related_operations\": [\n {\n \"index\": 0\n }\n ],\n \"type\": \"NativeTransfer\",\n \"status\": \"success\",\n \"account\": {\n \"address\": \"one1zksj3evekayy90xt4psrz8h6j2v3hla4qwz4ur\",\n \"metadata\": {\n \"hex_address\": \"0x15a128e599b74842BCcBa860311Efa92991bffb5\"\n }\n },\n \"amount\": {\n \"value\": \"-69000000000000000000\",\n \"currency\": {\n \"symbol\": \"ONE\",\n \"decimals\": 18\n }\n }\n },\n {\n \"operation_identifier\": {\n \"index\": 2\n },\n \"related_operations\": [\n {\n \"index\": 1\n }\n ],\n \"type\": \"NativeTransfer\",\n \"status\": \"success\",\n \"account\": {\n \"address\": \"one1r3dk2zzyzttd4q07zvqh7rwuuk2ch5rdsx6sfd\",\n \"metadata\": {\n \"hex_address\": \"0x1C5b65084412d6da81Fe13017f0DdCE5958Bd06D\"\n }\n },\n \"amount\": {\n \"value\": \"69000000000000000000\",\n \"currency\": {\n \"symbol\": \"ONE\",\n \"decimals\": 18\n }\n }\n }\n ]\n }\n}"}],"_postman_id":"9a6b2616-11bb-4f28-a851-ac554456c571"}],"id":"ff5de66a-778b-4bf4-82a4-e9bc1d9ade70","description":"The Data API provides the ability to access blocks, transactions, and balances.
\nReference Rosetta Documentation
\nFor reference, here is a flow of operations for common 'read' operations:
\n Caller + Data API Implementation\n +----------------------------------------------------------------------------------+\n X |\n X Get Supported Networks +---------------------------------> /network/list\n X | +\n X +-----------+--------------------------------------------------------+\n Get supported networks, X | v |\n their supported options, X | Get Network Options +------------------------------------> /network/options\n and their status X | |\n X +-----------+ |\n X v |\n X Get Network Status +-------------------------------------> /network/status\n X |\n |\n X |\n X Get Block +----------------------------------------------> /block\n X | +\n +---------+X +-----------------------------------------------+\n | X v |\nEnsure balance computed | X [Optional] Get Additional Block Transactions +-----------> /block/transaction\nfrom block operations | X |\nequals balance on node | |\n | |\n +-----------> Get account balance for each +---------------------------> /account/balance\n account seen in a block |\n |\n |\n X |\n X Get Mempool Transactions +-------------------------------> /mempool\n Monitor the mempool for X | +\n broadcast transaction status X +-----------------------------------------------+\n and incoming deposits X v |\n X Get a Specific Mempool Transaction +---------------------> /mempool/transaction\n X |\n +\nThis endpoint is offline.
\nThis endpoint returns the AccountIdentifier associated with a public key.
\nReference Rosetta Documentation
\nHarmony only supports secp256k1 curve keys. The hex_bytes of the key is assumed to be the compressed public key.
This endpoint is offline.
\nThe endpoint is called prior to the /construction/payloads endpoint to construct a request for any metadata that is needed for transaction construction given (i.e. account nonce).
Reference Rosetta Documentation
\nIt is considered invalid to provide the Gas operation since (in most cases) the true gas fee is only known once the transaction is finalized. Instead, you must only provide the intended non-Gas operations.
You can optionally specify the priority of the transaction in the mempool by providing a suggested_fee_multiplier >= 1. Transactions with a higher fee multiplier will be prioritized over transactions with a lower fee multiplier when validators construct the next block. By default, the suggested_fee_multiplier is 1.
Currently, Harmony supports the construction of the following types of transactions:
\n\n\nReference the
\n/block/transactiondocumentation for more details on the operations of such transactions.\n
You can also view some examples of how to construct each transaction in the example Rosetta-CLI config here & here.
Relevant metadata fields for construction:
\n\n\n","urlObject":{"protocol":"https","path":["construction","preprocess"],"host":["rosetta","s0","b","hmny","io"],"query":[],"variable":[]}},"response":[{"id":"5daec508-4814-4714-9802-594da48b1a52","name":"/construction/preprocess","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"network_identifier\": {\n \"blockchain\": \"Harmony\",\n \"network\": \"Testnet\",\n \"sub_network_identifier\": {\n \"network\": \"shard 0\",\n \"metadata\": {\n \"is_beacon\": true\n }\n }\n },\n \"operations\": [\n {\n \"operation_identifier\": {\n \"index\": 0\n },\n \"type\": \"NativeTransfer\",\n \"status\": \"\",\n \"account\": {\n \"address\": \"one1kxkr9svezrwjgddh2fq2q3w49mjvvkadqkcfkw\",\n \"metadata\": {\n \"hex_address\": \"0xB1ac32C19910DD2435B75240A045D52EE4c65BAd\"\n }\n },\n \"amount\": {\n \"value\": \"-3347819199729047095735837923\",\n \"currency\": {\n \"symbol\": \"ONE\",\n \"decimals\": 18\n }\n }\n },\n {\n \"operation_identifier\": {\n \"index\": 1\n },\n \"related_operations\": [\n {\n \"index\": 0\n }\n ],\n \"type\": \"NativeTransfer\",\n \"status\": \"\",\n \"account\": {\n \"address\": \"one13lx3exmpfc446vsguc5d0mtgha2ff7h5uz85pk\",\n \"metadata\": {\n \"hex_address\": \"0x8fCD1C9B614E2b5D3208E628d7eD68bF5494faF4\"\n }\n },\n \"amount\": {\n \"value\": \"3347819199729047095735837923\",\n \"currency\": {\n \"symbol\": \"ONE\",\n \"decimals\": 18\n }\n }\n }\n ],\n \"suggested_fee_multiplier\": 2,\n \"metadata\": {\n \"from_shard\": 0,\n \"to_shard\": 0\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://rosetta.s0.b.hmny.io/construction/preprocess"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.14.0 (Ubuntu)"},{"key":"Date","value":"Fri, 30 Oct 2020 09:40:19 GMT"},{"key":"Content-Type","value":"application/json; charset=UTF-8"},{"key":"Content-Length","value":"280"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Headers","value":"Origin, X-Requested-With, Content-Type, Accept"},{"key":"Access-Control-Allow-Methods","value":"GET, POST,OPTIONS"},{"key":"Access-Control-Allow-Origin","value":"*"}],"cookie":[],"responseTime":null,"body":"{\n \"options\": {\n \"gas_price_multiplier\": 2,\n \"operation_type\": \"NativeTransfer\",\n \"transaction_metadata\": {\n \"to_shard\": 0,\n \"from_shard\": 0\n }\n },\n \"required_public_keys\": [\n {\n \"address\": \"one1kxkr9svezrwjgddh2fq2q3w49mjvvkadqkcfkw\",\n \"metadata\": {\n \"hex_address\": \"0xB1ac32C19910DD2435B75240A045D52EE4c65BAd\"\n }\n }\n ]\n}"}],"_postman_id":"bc5d1e6a-3ad7-421f-8a1a-4eb45afacdb8"},{"name":"/construction/metadata","id":"51a766ea-6593-403e-ab33-8b5eede09de5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"network_identifier\": {\n \"blockchain\": \"Harmony\",\n \"network\": \"Testnet\",\n \"sub_network_identifier\": {\n \"network\": \"shard 0\",\n \"metadata\": {\n \"is_beacon\": true\n }\n }\n },\n \"options\": {\n \"gas_price_multiplier\": 2,\n \"operation_type\": \"NativeTransfer\",\n \"transaction_metadata\": {\n \"to_shard\": 0,\n \"from_shard\": 0\n }\n },\n \"public_keys\": [\n {\n \"hex_bytes\": \"03f91adb1671a2430484441b591bdad19358458e938ba291bf9e717031b6c3330d\",\n \"curve_type\": \"secp256k1\"\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"https://rosetta.s0.b.hmny.io/construction/metadata","description":"
This endpoint is online.
\nThis endpoint gets any on-chain (live) information required to construct a transaction.
\nReference Rosetta Documentation
\nAll data fetch on-chain is returned in the metadata. Below is a brief explanation of each field that a client could consume for construction:
\n\n
The suggested_fee is an over estimation of how much it will cost to execute the operation(s) in a transaction.
In the case that your transaction's contract call has an infinite loop, you will see an error that says that you have exceeded the gas cap of the block.
\n","urlObject":{"protocol":"https","path":["construction","metadata"],"host":["rosetta","s0","b","hmny","io"],"query":[],"variable":[]}},"response":[{"id":"5073c1b6-86df-43e7-a502-cb6cef9ad82e","name":"/construction/metadata","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"network_identifier\": {\n \"blockchain\": \"Harmony\",\n \"network\": \"Testnet\",\n \"sub_network_identifier\": {\n \"network\": \"shard 0\",\n \"metadata\": {\n \"is_beacon\": true\n }\n }\n },\n \"options\": {\n \"gas_price_multiplier\": 2,\n \"operation_type\": \"NativeTransfer\",\n \"transaction_metadata\": {\n \"to_shard\": 0,\n \"from_shard\": 0\n }\n },\n \"public_keys\": [\n {\n \"hex_bytes\": \"03f91adb1671a2430484441b591bdad19358458e938ba291bf9e717031b6c3330d\",\n \"curve_type\": \"secp256k1\"\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"https://rosetta.s0.b.hmny.io/construction/metadata"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.14.0 (Ubuntu)"},{"key":"Date","value":"Fri, 30 Oct 2020 10:17:41 GMT"},{"key":"Content-Type","value":"application/json; charset=UTF-8"},{"key":"Content-Length","value":"268"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Headers","value":"Origin, X-Requested-With, Content-Type, Accept"},{"key":"Access-Control-Allow-Methods","value":"GET, POST,OPTIONS"},{"key":"Access-Control-Allow-Origin","value":"*"}],"cookie":[],"responseTime":null,"body":"{\n \"metadata\": {\n \"contract_code\": \"0x\",\n \"evm_error_message\": \"\",\n \"evm_return\": \"0x\",\n \"gas_limit\": 21000,\n \"gas_price\": 2000000000,\n \"nonce\": 0,\n \"transaction_metadata\": {\n \"to_shard\": 0,\n \"from_shard\": 0\n }\n },\n \"suggested_fee\": [\n {\n \"value\": \"42000000000000\",\n \"currency\": {\n \"symbol\": \"ONE\",\n \"decimals\": 18\n }\n }\n ]\n}"}],"_postman_id":"51a766ea-6593-403e-ab33-8b5eede09de5"},{"name":"/construction/payloads","id":"d3844bf9-55f1-445e-8319-5077f9f77b3b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"network_identifier\": {\n \"blockchain\": \"Harmony\",\n \"network\": \"Testnet\",\n \"sub_network_identifier\": {\n \"network\": \"shard 0\",\n \"metadata\": {\n \"is_beacon\": true\n }\n }\n },\n \"operations\": [\n {\n \"operation_identifier\": {\n \"index\": 0\n },\n \"type\": \"NativeTransfer\",\n \"status\": \"\",\n \"account\": {\n \"address\": \"one13lx3exmpfc446vsguc5d0mtgha2ff7h5uz85pk\",\n \"metadata\": {\n \"hex_address\": \"0x8fCD1C9B614E2b5D3208E628d7eD68bF5494faF4\"\n }\n },\n \"amount\": {\n \"value\": \"-3347819199729047095735837923\",\n \"currency\": {\n \"symbol\": \"ONE\",\n \"decimals\": 18\n }\n }\n },\n {\n \"operation_identifier\": {\n \"index\": 1\n },\n \"related_operations\": [\n {\n \"index\": 0\n }\n ],\n \"type\": \"NativeTransfer\",\n \"status\": \"\",\n \"account\": {\n \"address\": \"one13lx3exmpfc446vsguc5d0mtgha2ff7h5uz85pk\",\n \"metadata\": {\n \"hex_address\": \"0x8fCD1C9B614E2b5D3208E628d7eD68bF5494faF4\"\n }\n },\n \"amount\": {\n \"value\": \"3347819199729047095735837923\",\n \"currency\": {\n \"symbol\": \"ONE\",\n \"decimals\": 18\n }\n }\n }\n ],\n \"metadata\": {\n \"contract_code\": \"0x\",\n \"evm_error_message\": \"\",\n \"evm_return\": \"0x\",\n \"gas_limit\": 21000,\n \"gas_price\": 2000000000,\n \"nonce\": 0,\n \"transaction_metadata\": {\n \"to_shard\": 0,\n \"from_shard\": 0\n }\n },\n \"public_keys\": [\n {\n \"hex_bytes\": \"03f91adb1671a2430484441b591bdad19358458e938ba291bf9e717031b6c3330d\",\n \"curve_type\": \"secp256k1\"\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"https://rosetta.s0.b.hmny.io/construction/payloads","description":"This endpoint is offline.
\nThis endpoint is called with an array of operations and the response from /construction/metadata. It returns an unsigned transaction blob and a collection of payloads that must be signed by particular AccountIdentifiers using a certain SignatureType.
Reference Rosetta Documentation
\nThe operations here share the same constraints as the operations given to the /construction/preprocess endpoint. The metadata is assumed to be unchanged from the /construction/metadata endpoint. It may be useful to know that the operations & metadata is all that is needed to construct a valid transaction on the Harmony network.
This implementation makes no guarantee that the unsiged_transaction string will remain legable/formatted the way it is now. It is possible that the unsiged_transaction becomes a hex-encoded byte string in a future patch or minor update.
Harmony only supports the ecdsa_recovery signature type. This is not the same as the ecdsa signature type.
This endpoint is offline.
\nThis endpoint is called on both unsigned and signed transactions to understand the intent of the formulated transaction. This is run as a sanity check before signing (after /construction/payloads) and before broadcast (after /construction/combine).
Reference Rosetta Documentation
\nThe transaction should be either the unsigned_transaction (unchanged) from the /construction/payloads endpoint, or the signed_transaction (unchanged) from the /construction/comdbine endpoint.
The Gas operation's value in the parsed operations is only an over estimation of the incurred gas of the transaction.
This endpoint is offline.
\nThis endpoint is called to create a transaction from an unsigned transaction and an array of provided signatures. The signed transaction returned from this method will be sent to the /construction/submit endpoint by the caller.
Reference Rosetta Documentation
\nSimilar to unsigned_transaction from the /construction/payloads endpoint, this implementation makes no guarantee that the signed_transaction string will remain legable/formatted the way it is now. It is possible that the signed_transaction becomes a hex-encoded byte string in a future patch or minor update.
Harmony only supports the ecdsa_recovery signature type. This is not the same as the ecdsa signature type.
This endpoint is offline.
\nThis endpoint returns the transaction hash for a signed transaction.
\nReference Rosetta Documentation
\n","urlObject":{"protocol":"https","path":["construction","hash"],"host":["rosetta","s0","b","hmny","io"],"query":[],"variable":[]}},"response":[{"id":"f4729faf-95e1-4873-bc1d-78da0f2f64e4","name":"/construction/hash","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"network_identifier\": {\n \"blockchain\": \"Harmony\",\n \"network\": \"Testnet\",\n \"sub_network_identifier\": {\n \"network\": \"shard 0\",\n \"metadata\": {\n \"is_beacon\": true\n }\n }\n },\n \"signed_transaction\": \"{\\\"rlp_bytes\\\":\\\"+HCAhDuaygCCUgiAAZSJLiYWgS7JDZVxotz0yDJCikdX8IuqbM9MpMi2avwjZ4AooGmW5TmKsTyFcWoHKxUV7FOzadF31b6c4vXf85KBvINVoHdJOzbRI1oooH72uTqEKAnVQFfkTOphgoJv6ID4bwsM\\\",\\\"is_staking\\\":false,\\\"contract_code\\\":\\\"0x\\\",\\\"from\\\":{\\\"address\\\":\\\"one1xsfk4wqnehzn8f3ejwy6tw4vc233hh9ytrmxmy\\\",\\\"metadata\\\":{\\\"hex_address\\\":\\\"0x34136Ab813CDC533A6399389a5BAAcc2A31bDca4\\\"}}}\"\n}","options":{"raw":{"language":"json"}}},"url":"https://rosetta.s0.b.hmny.io/construction/hash"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.14.0 (Ubuntu)"},{"key":"Date","value":"Fri, 30 Oct 2020 13:17:38 GMT"},{"key":"Content-Type","value":"application/json; charset=UTF-8"},{"key":"Content-Length","value":"105"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Headers","value":"Origin, X-Requested-With, Content-Type, Accept"},{"key":"Access-Control-Allow-Methods","value":"GET, POST,OPTIONS"},{"key":"Access-Control-Allow-Origin","value":"*"}],"cookie":[],"responseTime":null,"body":"{\n \"transaction_identifier\": {\n \"hash\": \"0xfcb59bcd59ca2fae526e3a1bfa161419122f037b5bfd45e331344a4ee4ab139a\"\n }\n}"}],"_postman_id":"c5e189a6-6419-4d57-b31a-12ebc3cde5e3"},{"name":"/construction/submit","id":"f5ed97ef-3c46-46cd-a016-be1a51cdd303","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"network_identifier\": {\n \"blockchain\": \"Harmony\",\n \"network\": \"Testnet\",\n \"sub_network_identifier\": {\n \"network\": \"shard 0\",\n \"metadata\": {\n \"is_beacon\": true\n }\n }\n },\n \"signed_transaction\": \"{\\\"rlp_bytes\\\":\\\"+HGAhDuaygCCUggBAZSxrDLBmRDdJDW3UkCgRdUu5MZbrYwO7O1MokLMSCB7aOqAJ6Dp98FOTB0xe8I0mhv7eJ45n2HRYar2EvLVUXpEEea+pqAIVlqD/BI04sV122jkgGE200K0oB+3nB6FFOVQogRj1A==\\\",\\\"is_staking\\\":false,\\\"contract_code\\\":\\\"0x\\\",\\\"from\\\":{\\\"address\\\":\\\"one155jp2y76nazx8uw5sa94fr0m4s5aj8e5xm6fu3\\\",\\\"metadata\\\":{\\\"hex_address\\\":\\\"0xA5241513DA9F4463F1d4874b548dFBAC29D91f34\\\"}}}\"\n}","options":{"raw":{"language":"json"}}},"url":"https://rosetta.s0.b.hmny.io/construction/submit","description":"This endpoint is online.
\nThis endpoint submits a pre-signed transaction to the node without waiting for the transaction to be finalized.
\nReference Rosetta Documentation
\nIt is possible that by the time a transaction is submitted to the mempool, some previously validated state may be invalid. Moreover, it is possible that some more intricate state consideration and/or verification (like other pending transactions) invalidates the construction transaction. This endpoint returns any such error upon submission, however, it is possible that the transaction is invalidated after the submission. Therefore, you should keep an eye out for the transaction using the /mempool endpoint and/or use the hmyv2_getCurrentTransactionErrorSink RPC method to fetch the reason why a transaction was dropped from the pool.
Just as the Data API provides the ability to read data from a blockchain in a standard format, the Construction API enables developers to write to a blockchain (i.e. construct transactions) in a standard format.
\nReference Rosetta Documentation
\nFor reference, here is a flow of the steps needed to create a valid transaction:
\n Caller + Construction API Implementation\n +----------------------------------------------------------------------------------+\n |\n Derive Address +----------------------------> /construction/derive\n from Public Key |\n |\n X |\n X Create Metadata Request +---------------------> /construction/preprocess\n X (array of operations) | +\n Get metadata needed X | |\n to construct transaction X +-----------------------------------------------+\n X v |\n X Fetch Online Metadata +-----------------------> /construction/metadata (online)\n X |\n |\n X |\n X Construct Payloads to Sign +------------------> /construction/payloads\n X (array of operations) | +\n X | |\n Create unsigned transaction X +------------------------------------------------+\n X v |\n X Parse Unsigned Transaction +------------------> /construction/parse\n X to Confirm Correctness |\n X |\n |\n X |\n X Sign Payload(s) +-----------------------------> /construction/combine\n X (using caller's own detached signer) | +\n X | |\n Create signed transaction X +-----------------------------------------------+\n X v |\n X Parse Signed Transaction +--------------------> /construction/parse\n X to Confirm Correctness |\n X |\n |\n X |\n X Get hash of signed transaction +--------------> /construction/hash\nBroadcast Signed Transaction X to monitor status |\n X |\n X Submit Transaction +--------------------------> /construction/submit (online)\n X |\n +\nRosetta is an open-source specification developed by Coinbase that makes integrating with blockchains simpler, faster, and more reliable by providing a universal layer for interacting with different blockchains. It does so by standardizing deployment, communication, and data formats.
\nIMPORTANT: This documentation will focus on the specifics of how to use Rosetta on Harmony. While some explanation of the Rosetta specification will be done here for context, please reference the official Rosetta documentation here for the best documentation on the general specification.
\nFor reference, implementation details about Harmony's integration of the Rosetta specification can be seen here.
\nRosetta is natively supported on the Harmony node program, meaning that a Harmony node is ran (with Rosetta option enabled) to provide the service.
\nIt is important to note that full Rosetta functionality is only supported for nodes running in archival mode with a full archival DB (such as the nodes behind the endpoints ran by Harmony). Nodes running in state pruned mode can only guarantee full functionality for the last ~50-ish synced blocks. Note that explorer nodes are by default running in archival mode.
\nAs of release 2.3.9 of the Harmony node, the implementation of staking and smart contract functionality via Rosetta is partially done.
hmyv2_call RPC method.\n\nAll of the missing features are present as an RPC and are integrated with our Javascript-SDK.
\n
Harmony is seeking developers to implement the missing features as a grant. Reach out to us if you are interested!
\nYou can choose to run your own Rosetta enabled explorer (non-validating) node using Docker. The Documentation for doing so can be found here. Since the docker deployment is compliant with the Rosetta deployment specification, the node binary is built from source and all data will be stored in one directory for easy data management between the host machine & docker container.
\nIf you would like to instead use an endpoint/node ran by Harmony, here are the URLs:
\nMainnet
\n\n\nAll nodes behind the endpoints are running in archival mode with a full archival DB.
\n
Testnet (could be unstable)
\n\n\nAll nodes behind the endpoints are running in archival mode with a full archival DB.
\n
Note that there are future plans to release a gateway middleware that will allow one endpoint to route to all of the different shards using the network_identifier. That said, the listed endpoints will be maintained for the foreseeable future — even after the release of the gateway.
POST to one of the Rosetta Data or Construction endpoints\n\n
An easy tool you can use to interact with the Rosetta Endpoints is Postman. When using Postman, ensure that you have the following things configured:
\nPOST to the correct Rosetta endpoint. Note that the local network uses http not https
![](\"https://i.imgur.com/hzwRkbX.png\")
A tool to probe or play with any Rosetta enabled network is the Rosetta-CLI. You can download it from the Coinbase repository here.
\nThere are a couple of things that must be set in the configuration file so that it can be used on the Harmony network.
\nblockchain is \"Harmony\", network set to either \"Mainnet\" or \"Testnet\", and sub_network_identifier set to the correct shard. For example:\"network\": {\n \"blockchain\": \"Harmony\",\n \"network\": \"Testnet\",\n \"sub_network_identifier\": {\n \"network\": \"shard 0\",\n \"metadata\": {\n \"is_beacon\": true\n }\n }\n}\nThe online_url must be set to either your own node's URL or to a Harmony ran URL. Note that you must not have a slash ('/') at the end of your URL.
(Optional) Set the offline_url in construction to your own node running in offline mode.
Example of simple Rosetta-CLI config:
\n{\n \"network\": {\n \"blockchain\": \"Harmony\",\n \"network\": \"Testnet\",\n \"sub_network_identifier\": {\n \"network\": \"shard 0\",\n \"metadata\": {\n \"is_beacon\": true\n }\n }\n },\n \"online_url\": \"https://rosetta.s0.b.hmny.io\",\n \"data_directory\": \"\",\n \"http_timeout\": 10,\n \"tip_delay\": 300,\n \"data\": {\n \"historical_balance_enabled\": false,\n \"reconciliation_disabled\": true,\n \"inactive_discrepency_search_disabled\": true,\n \"balance_tracking_disabled\": true,\n \"end_conditions\": {\n \"tip\": true\n }\n }\n}\n\n\n","event":[{"listen":"prerequest","script":{"id":"3923acba-6604-40bb-b3e6-38a8c6899201","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"98e97ab7-f22e-4ec2-b73b-677d46f27a97","type":"text/javascript","exec":[""]}}],"_postman_id":"290797a1-2593-44ff-b284-6a4c06b3cb77"}],"event":[{"listen":"prerequest","script":{"id":"d2ddf760-7b21-4c57-885c-ce4d124aa996","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"5f60f23a-95ca-4b00-b889-fefb5fd444f9","type":"text/javascript","exec":[""]}}]}You can view an example of some local network testing config, which includes some construction examples, here & here.
\n