Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
hmy_getBalanceByBlockNumber
Get the balance of an address at a given block.
String
- The address to get the balance of
String
- Block to get query for balance
String
- The current balance for the given address in ATTO.
Sample Curl Response
String
- The address to get the balance of
Number
- Block to get query for balance
String
- The big.Int balance for the given address on a particular block.
Sample Curl Response
GetTransactionCount
Given an account address, returns the number of transactions the account has made.
String
- Account address
String
- Block number to query for transaction count. Usually latest
, which uses the most recent block.
String
- Number of transactions the account has made.
String
- Account address
Number
- Block number to query for transaction count.
Number
- Number of transactions the account has made.
Parameters
None
Returns
QUANTITY
- A filter id.
Example
Parameters
None
Returns
QUANTITY
- A filter id.
Example
GetBalance
Get latest balance of an address.
String
- The address to get the balance of.
String
- Block to get query for balance
String
- The current balance for the given address in ATTO.
Sample Curl Response
String
- The address to get the balance of
String
- The current big.Int balance for the given address.
Sample Curl Response
If Node.js is installed on your system, one easy way to convert hexadecimal balances into a more readable decimal format is to run node -e "console.log(<balance> / 1e18)"
Creates a filter object, based on filter options, to notify when the state changes (logs). To check if the state has changed, call hmy_getFilterChanges
A note on specifying topic filters:
Topics are order-dependent. A transaction with a log with topics [A, B] will be matched by the following topic filters:
[]
"anything"
[A]
"A in first position (and anything after)"
[null, B]
"anything in first position AND B in second position (and anything after)"
[A, B]
"A in first position AND B in second position (and anything after)"
[[A, B], [A, B]]
"(A OR B) in first position AND (A OR B) in second position (and anything after)"
Parameters
Object
- The filter options:
fromBlock
: QUANTITY|TAG
- (optional, default: "latest"
) Integer block number, or "latest"
for the last mined block or "pending"
, "earliest"
for not yet mined transactions.
toBlock
: QUANTITY|TAG
- (optional, default: "latest"
) Integer block number, or "latest"
for the last mined block or "pending"
, "earliest"
for not yet mined transactions.
address
: DATA|Array
, 20 Bytes - (optional) Contract address or a list of addresses from which logs should originate.
topics
: Array of DATA
, - (optional) Array of 32 Bytes DATA
topics. Topics are order-dependent. Each topic can also be an array of DATA with "or" options.
Example Parameters
Returns
QUANTITY
- A filter id.
Example
hmy_getFilterLogs
Returns an array of all logs matching filter with given id.
Parameters
QUANTITY
- The filter id.
Example Parameters
Returns
See hmy_getFilterChanges
Example
Result see hmy_getFilterChanges
hmy_getFilterChanges
Parameters
QUANTITY
- the filter id.
Returns
Array
- Array of log objects, or an empty array if nothing has changed since last poll.
For filters created with eth_newBlockFilter
the return are block hashes (DATA
, 32 Bytes), e.g. ["0x3454645634534..."]
.
For filters created with eth_newPendingTransactionFilter
the return are transaction hashes (DATA
, 32 Bytes), e.g. ["0x6345343454645..."]
.
For filters created with eth_newFilter
logs are objects with following params:
removed
: TAG
- true
when the log was removed, due to a chain reorganization. false
if its a valid log.
logIndex
: QUANTITY
- integer of the log index position in the block. null
when its pending log.
transactionIndex
: QUANTITY
- integer of the transactions index position log was created from. null
when its pending log.
transactionHash
: DATA
, 32 Bytes - hash of the transactions this log was created from. null
when its pending log.
blockHash
: DATA
, 32 Bytes - hash of the block where this log was in. null
when its pending. null
when its pending log.
blockNumber
: QUANTITY
- the block number where this log was in. null
when its pending. null
when its pending log.
address
: DATA
, 20 Bytes - address from which this log originated.
data
: DATA
- contains the non-indexed arguments of the log.
topics
: Array of DATA
- Array of 0 to 4 32 Bytes DATA
of indexed log arguments. (In solidity: The first topic is the hash of the signature of the event (e.g. Deposit(address,bytes32,uint256)
), except you declared the event with the anonymous
specifier.)
hmy_getStakingTransactionByBlockNumberAndIndex
Get staking transaction at an index from a given block, specified by number.
String
- The block's index in the chain.
String
- The staking transactions index position.
hash
- String
: Hash of the transaction.
nonce
- Number
: The number of transactions made by the sender prior to this one.
blockHash
- String
: Hash of the block where this transaction was in. null
when its pending.
blockNumber
- Number
: Block number where this transaction was in. null
when its pending.
transactionIndex
- Number
: Integer of the transactions index position in the block. null
when its pending.
timestamp
- Number
: transaction timestamp
from
- String
: Address of the sender.
value
- String
: Value transferred in ATTO.
gasPrice
- String
: Gas price provided by the sender.
gas
- Number
: Gas provided by the sender.
v
- String
: signature V
r
- String
: signature R
s
-
: signature SString
type
- String
: staking transaction type ("CreateValidator", "EditValidator", "CollectRewards", "Undelegate", "Delegate")
msg
- StakingMsg:
CreateValidator:
validatorAddress
- String:
validator address
name
- String:
validator name
commissionRate
- Number
: validator commission rate
maxCommissionRate
- Number
: validator commission rate
maxChangeRate
- Number
: validator max commission rate change
minSelfDelegation
- Number
: min how much validator self delegates
maxTotalDelegation
- Number
: max total delegation to validator
amount
- Number
: stake amount for validator
website
- String
: validator website
identity
- String
: validator kyc identity
securityContact
- String
: validator security contact
details
- String
: additional validator info
slotPubKeys
- []String
: validator bls pub keys
EditValidator:
validatorAddress
- String:
validator address
name
- String
: validator name
commissionRate
- Number
: validator commission rate
minSelfDelegation
- Number
: min how much validator self delegates
maxTotalDelegation
- Number
: max total delegation to validator
website
- String
: validator website
identity
- String
: validator kyc identity
securityContact
- String
: validator security contact
details
- String
: additional validator info
slotPubKeyToAdd
- String
: validator bls pub key to add
slotPubKeyToRemove
- String
: validator bls pub key to remove
CollectRewards:
delegatorAddress
- String
: address to send rewards
Delegate:
delegatorAddress
- String:
delegation delegator address
validatorAddress
- String:
delegation validator address
amount
- Number
: big.Int amount for delegation to validator
Undelegate:
delegatorAddress
- String
: undelegation delegator address
validatorAddress
- String
: undelegation validator address
amount
- Number
: big.Int amount for undelegation to delegator
Sample Curl Request
Sample Curl Response
Number
- The block's index in the chain.
Number
- The transactions index position.
hash
- String
: Hash of the transaction.
nonce
- Number
: The number of transactions made by the sender prior to this one.
blockHash
- String
: Hash of the block where this transaction was in. null
when its pending.
blockNumber
- Number
: Block number where this transaction was in. null
when its pending.
transactionIndex
- Number
: Integer of the transactions index position in the block. null
when its pending.
timestamp
- Number
: transaction timestamp
from
- String
: Address of the sender.
value
- String
: Value transferred in ATTO.
gasPrice
- String
: Gas price provided by the sender.
gas
- Number
: Gas provided by the sender.
v
- String
: signature V
r
- String
: signature R
s
-
: signature SString
type
- String
: staking transaction type ("CreateValidator", "EditValidator", "CollectRewards", "Undelegate", "Delegate")
msg
- StakingMsg:
CreateValidator:
validatorAddress
- String:
validator address
name
- String:
validator name
commissionRate
- Number
: validator commission rate
maxCommissionRate
- Number
: validator commission rate
maxChangeRate
- Number
: validator max commission rate change
minSelfDelegation
- Number
: min how much validator self delegates
maxTotalDelegation
- Number
: max total delegation to validator
amount
- Number
: stake amount for validator
website
- String
: validator website
identity
- String
: validator kyc identity
securityContact
- String
: validator security contact
details
- String
: additional validator info
slotPubKeys
- []String
: validator bls pub keys
EditValidator:
validatorAddress
- String:
validator address
name
- String
: validator name
commissionRate
- Number
: validator commission rate
minSelfDelegation
- Number
: min how much validator self delegates
maxTotalDelegation
- Number
: max total delegation to validator
website
- String
: validator website
identity
- String
: validator kyc identity
securityContact
- String
: validator security contact
details
- String
: additional validator info
slotPubKeyToAdd
- String
: validator bls pub key to add
slotPubKeyToRemove
- String
: validator bls pub key to remove
CollectRewards:
delegatorAddress
- String
: address to send rewards
Delegate:
delegatorAddress
- String:
delegation delegator address
validatorAddress
- String:
delegation validator address
amount
- Number
: big.Int amount for delegation to validator
Undelegate:
delegatorAddress
- String
: undelegation delegator address
validatorAddress
- String
: undelegation validator address
amount
- Number
: big.Int amount for undelegation to delegator
Sample Curl Request
Sample Curl Response
hmy_getLogs
Get harmony logs for smart contracts or transactions
Object
- The filter options:
fromBlock
: QUANTITY|TAG
- (optional, default: "latest"
) Integer block number, or "latest"
for the last mined block or "pending"
, "earliest"
for not yet mined transactions.
toBlock
: QUANTITY|TAG
- (optional, default: "latest"
) Integer block number, or "latest"
for the last mined block or "pending"
, "earliest"
for not yet mined transactions.
address
: DATA|Array
, 20 Bytes - (optional) Contract address or a list of addresses from which logs should originate.
topics
: Array of DATA
, - (optional) Array of 32 Bytes DATA
topics. Topics are order-dependent. Each topic can also be an array of DATA with "or" options.
blockhash
: DATA
, 32 Bytes - (optional) , blockHash
is a new filter option which restricts the logs returned to the single block with the 32-byte hash blockHash
. Using blockHash
is equivalent to fromBlock
= toBlock
= the block number with hash blockHash
. If blockHash
is present in the filter criteria, then neither fromBlock
nor toBlock
are allowed.
For filters created with hmy_newBlockFilter
the return are block hashes (DATA
, 32 Bytes), e.g. ["0x3454645634534..."]
.
For filters created with hmy_newPendingTransactionFilter
the return are transaction hashes (DATA
, 32 Bytes), e.g. ["0x6345343454645..."]
.
For filters created with hmy_newFilter
logs are objects with following params:
removed
: TAG
- true
when the log was removed, due to a chain reorganization. false
if its a valid log.
logIndex
: QUANTITY
- integer of the log index position in the block. null
when its pending log.
transactionIndex
: QUANTITY
- integer of the transactions index position log was created from. null
when its pending log.
transactionHash
: DATA
, 32 Bytes - hash of the transactions this log was created from. null
when its pending log.
blockHash
: DATA
, 32 Bytes - hash of the block where this log was in. null
when its pending. null
when its pending log.
blockNumber
: QUANTITY
- the block number where this log was in. null
when its pending. null
when its pending log.
address
: DATA
, 20 Bytes - address from which this log originated.
data
: DATA
- contains the non-indexed arguments of the log.
topics
: Array of DATA
- Array of 0 to 4 32 Bytes DATA
of indexed log arguments. (In solidity: The first topic is the hash of the signature of the event (e.g. Deposit(address,bytes32,uint256)
), except you declared the event with the anonymous
specifier.)
Sample Curl Request
Sample Curl Response
hmy_getStakingTransactionByHash
Get staking transaction by its hash.
String
- The staking transaction hash.
hash
- String
: Hash of the transaction.
nonce
- Number
: The number of transactions made by the sender prior to this one.
blockHash
- String
: Hash of the block where this transaction was in. null
when its pending.
blockNumber
- Number
: Block number where this transaction was in. null
when its pending.
transactionIndex
- Number
: Integer of the transactions index position in the block. null
when its pending.
timestamp
- Number
: transaction timestamp
from
- String
: Address of the sender.
value
- String
: Value transferred in ATTO.
gasPrice
- String
: Gas price provided by the sender.
gas
- Number
: Gas provided by the sender.
v
- String
: signature V
r
- String
: signature R
s
-
: signature SString
type
- String
: staking transaction type ("CreateValidator", "EditValidator", "CollectRewards", "Undelegate", "Delegate")
msg
- StakingMsg:
CreateValidator:
validatorAddress
- String:
validator address
name
- String:
validator name
commissionRate
- Number
: validator commission rate
maxCommissionRate
- Number
: validator commission rate
maxChangeRate
- Number
: validator max commission rate change
minSelfDelegation
- Number
: min how much validator self delegates
maxTotalDelegation
- Number
: max total delegation to validator
amount
- Number
: stake amount for validator
website
- String
: validator website
identity
- String
: validator kyc identity
securityContact
- String
: validator security contact
details
- String
: additional validator info
slotPubKeys
- []String
: validator bls pub keys
EditValidator:
validatorAddress
- String:
validator address
name
- String
: validator name
commissionRate
- Number
: validator commission rate
minSelfDelegation
- Number
: min how much validator self delegates
maxTotalDelegation
- Number
: max total delegation to validator
website
- String
: validator website
identity
- String
: validator kyc identity
securityContact
- String
: validator security contact
details
- String
: additional validator info
slotPubKeyToAdd
- String
: validator bls pub key to add
slotPubKeyToRemove
- String
: validator bls pub key to remove
CollectRewards:
delegatorAddress
- String
: address to send rewards
Delegate:
delegatorAddress
- String:
delegation delegator address
validatorAddress
- String:
delegation validator address
amount
- Number
: big.Int amount for delegation to validator
Undelegate:
delegatorAddress
- String
: undelegation delegator address
validatorAddress
- String
: undelegation validator address
amount
- Number
: big.Int amount for undelegation to delegator
Sample Curl Request
Sample Curl Response
String
- The staking transaction hash.
hash
- String
: Hash of the transaction.
nonce
- Number
: The number of transactions made by the sender prior to this one.
blockHash
- String
: Hash of the block where this transaction was in. null
when its pending.
blockNumber
- Number
: Block number where this transaction was in. null
when its pending.
transactionIndex
- Number
: Integer of the transactions index position in the block. null
when its pending.
timestamp
- Number
: transaction timestamp
from
- String
: Address of the sender.
value
- String
: Value transferred in ATTO.
gasPrice
- String
: Gas price provided by the sender.
gas
- Number
: Gas provided by the sender.
v
- String
: signature V
r
- String
: signature R
s
-
: signature SString
type
- String
: staking transaction type ("CreateValidator", "EditValidator", "CollectRewards", "Undelegate", "Delegate")
msg
- StakingMsg:
CreateValidator:
validatorAddress
- String:
validator address
name
- String:
validator name
commissionRate
- Number
: validator commission rate
maxCommissionRate
- Number
: validator commission rate
maxChangeRate
- Number
: validator max commission rate change
minSelfDelegation
- Number
: min how much validator self delegates
maxTotalDelegation
- Number
: max total delegation to validator
amount
- Number
: stake amount for validator
website
- String
: validator website
identity
- String
: validator kyc identity
securityContact
- String
: validator security contact
details
- String
: additional validator info
slotPubKeys
- []String
: validator bls pub keys
EditValidator:
validatorAddress
- String:
validator address
name
- String
: validator name
commissionRate
- Number
: validator commission rate
minSelfDelegation
- Number
: min how much validator self delegates
maxTotalDelegation
- Number
: max total delegation to validator
website
- String
: validator website
identity
- String
: validator kyc identity
securityContact
- String
: validator security contact
details
- String
: additional validator info
slotPubKeyToAdd
- String
: validator bls pub key to add
slotPubKeyToRemove
- String
: validator bls pub key to remove
CollectRewards:
delegatorAddress
- String
: address to send rewards
Delegate:
delegatorAddress
- String:
delegation delegator address
validatorAddress
- String:
delegation validator address
amount
- Number
: big.Int amount for delegation to validator
Undelegate:
delegatorAddress
- String
: undelegation delegator address
validatorAddress
- String
: undelegation validator address
amount
- Number
: big.Int amount for undelegation to delegator
Sample Curl Request
Sample Curl Response
SendRawStakingTransaction
A staking transaction is like a plain sharded transaction, , but with a single field that is not known ahead of time. This field is the staking message itself, which in the harmony go code base, we refer to as StakeMsg
The input is a single RLP encoded version of a StakingTransaction
String
- Transaction encoded in bytes.
String
- Raw transaction's hash.
Sample Curl Request
Sample Curl Response
hmy_pendingTransactions
Returns list of pending transactions object. See hmy_getTransactionByHash for result format.
Returns list of pending transactions object. See hmy_getTransactionByHash for result format.
GetTransactionReceipt
Get transaction receipt from transaction hash.
String
- The transaction hash.
blockHash
32 Bytes - String
: Hash of the block where this transaction was in.
blockNumber
- Number
: Block number where this transaction was in.
transactionHash
32 Bytes - String
: Hash of the transaction.
transactionIndex
- Number
: Integer of the transactions index position in the block.
from
- String
: Address of the sender.
to
- String
: Address of the receiver. null
when its a contract creation transaction.
contractAddress
- String
: The contract address created, if the transaction was a contract creation, otherwise null
.
cumulativeGasUsed
- Number
: The total amount of gas used when this transaction was executed in the block.
gasUsed
- Number
: The amount of gas used by this specific transaction alone.
logs
- Array
: Array of log objects, which this transaction generated.
Sample Curl Request
Sample Curl Response
String
- The transaction hash.
blockHash
32 Bytes - String
: Hash of the block where this transaction was in.
blockNumber
- Number
: Block number where this transaction was in.
transactionHash
32 Bytes - String
: Hash of the transaction.
transactionIndex
- Number
: Integer of the transactions index position in the block.
from
- String
: Address of the sender.
to
- String
: Address of the receiver. null
when its a contract creation transaction.
contractAddress
- String
: The contract address created, if the transaction was a contract creation, otherwise null
.
cumulativeGasUsed
- Number
: The total amount of gas used when this transaction was executed in the block.
gasUsed
- Number
: The amount of gas used by this specific transaction alone.
logs
- Array
: Array of log objects, which this transaction generated.
Sample Curl Request
Sample Curl Response
GetBlockTransactionCount
Get the number of transactions in a block by the block's index in the chain.
Number
- The block number.
Number
- The number of transactions in the given block.
Sample Curl Request
Sample Curl Response
Number
- The block number.
Number
- The number of transactions in the given block.
Sample Curl Request
Sample Curl Response
hmy_getStakingTransactionByBlockHashAndIndex
Get staking transaction at an index from a given block, specified by block hash.
String
- The block hash.
Number
- The staking transaction index position.
hash
- String
: Hash of the transaction.
nonce
- Number
: The number of transactions made by the sender prior to this one.
blockHash
- String
: Hash of the block where this transaction was in. null
when its pending.
blockNumber
- Number
: Block number where this transaction was in. null
when its pending.
transactionIndex
- Number
: Integer of the transactions index position in the block. null
when its pending.
timestamp
- Number
: transaction timestamp
from
- String
: Address of the sender.
value
- String
: Value transferred in ATTO.
gasPrice
- String
: Gas price provided by the sender.
gas
- Number
: Gas provided by the sender.
v
- String
: signature V
r
- String
: signature R
s
-
: signature SString
type
- String
: staking transaction type ("CreateValidator", "EditValidator", "CollectRewards", "Undelegate", "Delegate")
msg
- StakingMsg:
CreateValidator:
validatorAddress
- String:
validator address
name
- String:
validator name
commissionRate
- Number
: validator commission rate
maxCommissionRate
- Number
: validator commission rate
maxChangeRate
- Number
: validator max commission rate change
minSelfDelegation
- Number
: min how much validator self delegates
maxTotalDelegation
- Number
: max total delegation to validator
amount
- Number
: stake amount for validator
website
- String
: validator website
identity
- String
: validator kyc identity
securityContact
- String
: validator security contact
details
- String
: additional validator info
slotPubKeys
- []String
: validator bls pub keys
EditValidator:
validatorAddress
- String:
validator address
name
- String
: validator name
commissionRate
- Number
: validator commission rate
minSelfDelegation
- Number
: min how much validator self delegates
maxTotalDelegation
- Number
: max total delegation to validator
website
- String
: validator website
identity
- String
: validator kyc identity
securityContact
- String
: validator security contact
details
- String
: additional validator info
slotPubKeyToAdd
- String
: validator bls pub key to add
slotPubKeyToRemove
- String
: validator bls pub key to remove
CollectRewards:
delegatorAddress
- String
: address to send rewards
Delegate:
delegatorAddress
- String:
delegation delegator address
validatorAddress
- String:
delegation validator address
amount
- Number
: big.Int amount for delegation to validator
Undelegate:
delegatorAddress
- String
: undelegation delegator address
validatorAddress
- String
: undelegation validator address
amount
- Number
: big.Int amount for undelegation to delegator
Sample Curl Request
Sample Curl Response
String
- The block hash.
Number
- The staking transaction index position.
hash
- String
: Hash of the transaction.
nonce
- Number
: The number of transactions made by the sender prior to this one.
blockHash
- String
: Hash of the block where this transaction was in. null
when its pending.
blockNumber
- Number
: Block number where this transaction was in. null
when its pending.
transactionIndex
- Number
: Integer of the transactions index position in the block. null
when its pending.
timestamp
- Number
: transaction timestamp
from
- String
: Address of the sender.
value
- String
: Value transferred in ATTO.
gasPrice
- String
: Gas price provided by the sender.
gas
- Number
: Gas provided by the sender.
v
- String
: signature V
r
- String
: signature R
s
-
: signature SString
type
- String
: staking transaction type ("CreateValidator", "EditValidator", "CollectRewards", "Undelegate", "Delegate")
msg
- StakingMsg:
CreateValidator:
validatorAddress
- String:
validator address
name
- String:
validator name
commissionRate
- Number
: validator commission rate
maxCommissionRate
- Number
: validator commission rate
maxChangeRate
- Number
: validator max commission rate change
minSelfDelegation
- Number
: min how much validator self delegates
maxTotalDelegation
- Number
: max total delegation to validator
amount
- Number
: stake amount for validator
website
- String
: validator website
identity
- String
: validator kyc identity
securityContact
- String
: validator security contact
details
- String
: additional validator info
slotPubKeys
- []String
: validator bls pub keys
EditValidator:
validatorAddress
- String:
validator address
name
- String
: validator name
commissionRate
- Number
: validator commission rate
minSelfDelegation
- Number
: min how much validator self delegates
maxTotalDelegation
- Number
: max total delegation to validator
website
- String
: validator website
identity
- String
: validator kyc identity
securityContact
- String
: validator security contact
details
- String
: additional validator info
slotPubKeyToAdd
- String
: validator bls pub key to add
slotPubKeyToRemove
- String
: validator bls pub key to remove
CollectRewards:
delegatorAddress
- String
: address to send rewards
Delegate:
delegatorAddress
- String:
delegation delegator address
validatorAddress
- String:
delegation validator address
amount
- Number
: big.Int amount for delegation to validator
Undelegate:
delegatorAddress
- String
: undelegation delegator address
validatorAddress
- String
: undelegation validator address
amount
- Number
: big.Int amount for undelegation to delegator
Sample Curl Request
Sample Curl Response
hmy_getPendingCXReceipts
Array of pending cx receipts in tx pool. See hmy_getCXReceiptByHash for format
See hmy_getCXReceiptByHash response
Array of pending cx receipts in tx pool. See hmy_getCXReceiptByHash for format
See hmy_getCXReceiptByHash response
hmy_getTransactionsHistory
hmy_getTransactionsHistory get transactions history for an address
String
- one address ("one1...")
txHistoryArgs
- json args
txType
- String
: optional, Received or Sent, shows all transactions by default
fullTx
- Bool
: optional, shows full transaction or just its hash, default is false
pageSize
- Number
: optional, pagination page size, how much tx to show in single page, default is 100
pageIndex
- Number
: optional, pagination which page to show, default is 0
txType
- String
: optional, "ALL", "RECEIVED", "SENT", default is "ALL"
order
- String
: optional, "ASC", "DESC", default is "ASC", order by timestamp
Returns
Array
- either returns list of transactions
hash
- String
: Hash of the transaction.
nonce
- Number
: The number of transactions made by the sender prior to this one.
blockHash
- String
: Hash of the block where this transaction was in. null
when it's pending.
blockNumber
- Number
: Block number where this transaction was in. null
when it's pending.
transactionIndex
- Number
: Integer of the transaction's index position in the block. null
when its pending.
from
- String
: Address of the sender.
to
- String
: Address of the receiver.
value
- String
: Value transferred in ATTO.
gasPrice
- String
: Gas price provided by the sender.
gas
- Number
: Gas provided by the sender.
input
- String
: The data sent along with the transaction.
Array
of String
- or list of transactions hashes
Sample Curl Request 0
Sample Curl Response 0
Sample Curl Request 1
Sample Curl Response 1
Returns
Array
- either returns list of transactions
hash
- String
: Hash of the transaction.
nonce
- Number
: The number of transactions made by the sender prior to this one.
blockHash
- String
: Hash of the block where this transaction was in. null
when it's pending.
blockNumber
- Number
: Block number where this transaction was in. null
when it's pending.
transactionIndex
- Number
: Integer of the transaction's index position in the block. null
when its pending.
from
- String
: Address of the sender.
to
- String
: Address of the receiver.
value
- Number
: Value transferred in ATTO.
gasPrice
- Number
: Gas price provided by the sender.
gas
- Number
: Gas provided by the sender.
input
- String
: The data sent along with the transaction.
Array
of String
- or list of transactions hashes
Sample Curl Request 0
Sample Curl Response 0
Sample Curl Request 1
Sample Curl Response 1
hmy_getCXReceiptByHash
String
- transactions hash for cx receipt
blockHash
- String
- block hash
blockNumber
- Number
- block number
hash
- String
- transaction hash
from
- String
- from one address
to
- String
- to one address
shardID
- Number
- shard id from where transaction sent
toShardID
- Number
- shard id to where transaction sent
value
- Number
- transaction sent value
String
- transactions hash for cx receipt
blockHash
- String
- block hash
blockNumber
- Number
- block number
hash
- String
- transaction hash
from
- String
- from one address
to
- String
- to one address
shardID
- Number
- shard id from where transaction sent
toShardID
- Number
- shard id to where transaction sent
value
- Number
- transaction sent value
GetBlockTransactionCount
Get the number of transactions in a block by the block's hash.
String
- The block hash.
Number
- The number of transactions in the given block.
Sample Curl Request
Sample Curl Response
String
- The block hash.
Number
- The number of transactions in the given block.
Sample Curl Request
Sample Curl Response
GetTransaction
Get transaction at an index from a given block, specified by number.
String
- The block's index in the chain.
String
- The transactions index position.
hash
- String
: Hash of the transaction.
nonce
- Number
: The number of transactions made by the sender prior to this one.
blockHash
- String
: Hash of the block where this transaction was in. null
when its pending.
blockNumber
- Number
: Block number where this transaction was in. null
when its pending.
transactionIndex
- Number
: Integer of the transactions index position in the block. null
when its pending.
from
- String
: Address of the sender.
to
- String
: Address of the receiver. null
when its a contract creation transaction.
value
- String
: Value transferred in ATTO.
gasPrice
- String
: Gas price provided by the sender.
gas
- Number
: Gas provided by the sender.
input
- String
: The data sent along with the transaction.
Sample Curl Request
Sample Curl Response
Number
- The block's index in the chain.
Number
- The transactions index position.
hash
- String
: Hash of the transaction.
nonce
- Number
: The number of transactions made by the sender prior to this one.
blockHash
- String
: Hash of the block where this transaction was in. null
when its pending.
blockNumber
- Number
: Block number where this transaction was in. null
when its pending.
transactionIndex
- Number
: Integer of the transactions index position in the block. null
when its pending.
from
- String
: Address of the sender.
to
- String
: Address of the receiver. null
when its a contract creation transaction.
value
- Number
: Value transferred in ATTO.
gasPrice
- Number
: Gas price provided by the sender.
gas
- Number
: Gas provided by the sender.
input
- String
: The data sent along with the transaction.
Sample Curl Request
Sample Curl Response
GetTransactionByBlockHashAndIndex
Get transaction at an index from a given block, specified by block hash.
String
- The block hash.
Number
- The transactions index position.
hash
- String
: Hash of the transaction.
nonce
- Number
: The number of transactions made by the sender prior to this one.
blockHash
- String
: Hash of the block where this transaction was in. null
when its pending.
blockNumber
- Number
: Block number where this transaction was in. null
when its pending.
transactionIndex
- Number
: Integer of the transactions index position in the block. null
when its pending.
from
- String
: Address of the sender.
to
- String
: Address of the receiver. null
when its a contract creation transaction.
value
- String
: Value transferred in ATTO.
gasPrice
- String
: Gas price provided by the sender.
gas
- Number
: Gas provided by the sender.
input
- String
: The data sent along with the transaction.
Sample Curl Request
Sample Curl Response
String
- The block hash.
Number
- The transactions index position.
hash
- String
: Hash of the transaction.
nonce
- Number
: The number of transactions made by the sender prior to this one.
blockHash
- String
: Hash of the block where this transaction was in. null
when its pending.
blockNumber
- Number
: Block number where this transaction was in. null
when its pending.
transactionIndex
- Number
: Integer of the transactions index position in the block. null
when its pending.
from
- String
: Address of the sender.
to
- String
: Address of the receiver. null
when its a contract creation transaction.
value
- Number
: Value transferred in ATTO.
gasPrice
- number
: Gas price provided by the sender.
gas
- Number
: Gas provided by the sender.
input
- String
: The data sent along with the transaction.
Sample Curl Request
Sample Curl Response
GetBlockByHash
Get block by its hash.
Parameters
String
- The block hash.
Boolean
- If true
, the returned block will contain all transactions in the block.
number
- Number
: The block number. null
when its pending block.
hash
32 Bytes - String
: Hash of the block. null
when its pending block.
parentHash
32 Bytes - String
: Hash of the parent block.
nonce
8 Bytes - String
: Hash of the generated proof-of-work. null
when its pending block.
logsBloom
256 Bytes - String
: The bloom filter for the logs of the block. null
when its pending block.
transactionsRoot
32 Bytes - String
: The root of the transaction trie of the block
stateRoot
32 Bytes - String
: The root of the final state trie of the block.
miner
- String
: The address of the beneficiary to whom the mining rewards were given.
difficulty
- String
: Integer of the difficulty for this block.
extraData
- String
: The “extra data” field of this block.
size
- Number
: Integer the size of this block in bytes.
gasLimit
- Number
: The maximum gas allowed in this block.
gasUsed
- Number
: The total used gas by all transactions in this block.
timestamp
- Number
: The unix timestamp for when the block was collated.
stakingTransactions
- Array
: Array of staking transactions object; are present by default
transactions
- Array
: Array of transaction objects; absent if second parameter is false
.
uncles
- Array
: Array of uncle hashes.
Sample Curl Request
Sample Curl Response
Parameters
String
- The block hash.
blockArgs
- optional args struct in json format (should be used just with { })
fullTx
- Bool
: To show full tx or not
withSigners
- Bool
: Include block signes in blocks or not
inclStaking
- Bool
: To show staking txs or not
number
- Number
: The block number. null
when its pending block.
hash
32 Bytes - String
: Hash of the block. null
when its pending block.
parentHash
32 Bytes - String
: Hash of the parent block.
nonce
8 Bytes - String
: Hash of the generated proof-of-work. null
when its pending block.
logsBloom
256 Bytes - String
: The bloom filter for the logs of the block. null
when its pending block.
transactionsRoot
32 Bytes - String
: The root of the transaction trie of the block
stateRoot
32 Bytes - String
: The root of the final state trie of the block.
miner
- String
: The address of the beneficiary to whom the mining rewards were given.
difficulty
- String
: Integer of the difficulty for this block.
extraData
- String
: The “extra data” field of this block.
size
- Number
: Integer the size of this block in bytes.
gasLimit
- Number
: The maximum gas allowed in this block.
gasUsed
- Number
: The total used gas by all transactions in this block.
timestamp
- Number
: The unix timestamp for when the block was collated.
stakingTransactions
- Array
: Array of staking transactions object; absent if inclStaking is false, are present by default
transactions
- Array
: Array of transaction objects; absent if second parameter is false
.
uncles
- Array
: Array of uncle hashes.
Sample Curl Request
Sample Curl Response
hmy_getBlocks returns blocks in range [from; to]
Parameters
String
- starting block number in 0x format
String
- ending block number in 0x format
blockArgs
- optional args struct in json format (should be used just with { })
fullTx
- Bool
: To show full tx or not
withSigners
- Bool
: Include block signes in blocks or not
Returns
Array
: returns blocks list in json format
number
- Number
: The block number. null
when its pending block.
hash
32 Bytes - String
: Hash of the block. null
when its pending block.
parentHash
32 Bytes - String
: Hash of the parent block.
nonce
8 Bytes - String
: Hash of the generated proof-of-work.null
when its pending block.
logsBloom
256 Bytes - String
: The bloom filter for the logs of the block. null
when its pending block.
transactionsRoot
32 Bytes - String
: The root of the transaction trie of the block
stateRoot
32 Bytes - String
: The root of the final state trie of the block.
miner
- String
: The address of the beneficiary to whom the mining rewards were given.
difficulty
- Number
: Integer of the difficulty for this block.
extraData
- String
: The “extra data” field of this block.
size
- Number
: Integer the size of this block in bytes.
gasLimit
- Number
: The maximum gas allowed in this block.
gasUsed
- Number
: The total used gas by all transactions in this block.
timestamp
- Number
: The unix timestamp for when the block was collated, 0x format.
stakingTransactions
- Array
: Array of staking transactions object; absent if inclStaking is false, are present by default.
transactions
- Array
: Array of transaction objects; absent if second parameter is false
.
signers
- Array
: Array of validators one addresses who signed this block
uncles
- Array
: Array of uncle hashes.
Sample Curl Request
Sample Curl Response
Parameters
Number
- starting block number
Number
- ending block number
blockArgs
- optional args struct in json format (should be used just with { })
fullTx
- Bool
: To show full tx or not
withSigners
- Bool
: Include block signes in blocks or not
inclStaking
- Bool
: To show staking txs or not
Returns
Array
: returns blocks list in json format
number
- Number
: The block number. null
when its pending block.
hash
32 Bytes - String
: Hash of the block. null
when its pending block.
parentHash
32 Bytes - String
: Hash of the parent block.
nonce
8 Bytes - String
: Hash of the generated proof-of-work. null
when its pending block.
logsBloom
256 Bytes - String
: The bloom filter for the logs of the block. null
when its pending block.
transactionsRoot
32 Bytes - String
: The root of the transaction trie of the block
stateRoot
32 Bytes - String
: The root of the final state trie of the block.
miner
- String
: The address of the beneficiary to whom the mining rewards were given.
difficulty
- String
: Integer of the difficulty for this block.
extraData
- String
: The “extra data” field of this block.
size
- Number
: Integer the size of this block in bytes.
gasLimit
- Number
: The maximum gas allowed in this block.
gasUsed
- Number
: The total used gas by all transactions in this block.
timestamp
- Number
: The unix timestamp for when the block was collated.
stakingTransactions
- Array
: Array of staking transactions object; absent if inclStaking is false, are present by default
transactions
- Array
: Array of transaction objects; only hashes if fullTx is false, are hashes by default
signers
- Array
: Array of validators one addresses who signed this block
uncles
- Array
: Array of uncle hashes.
Sample Curl Request
Sample Curl Response
GetCode
Get the code at a specific address.
String
- The address to get the code from.
String
- Block to query for information. Usually latest
, which specifies the most recent block.
Function
- (optional) Optional callback, returns an error object as first parameter and the result as second.
String
- The data at given address address
.
Sample Curl Request
Sample Curl Response
GetTransaction
Get a transaction by its hash.
String
- The transaction hash.
hash
- String
: Hash of the transaction.
nonce
- Number
: The number of transactions made by the sender prior to this one.
blockHash
- String
: Hash of the block where this transaction was in. null
when its pending.
blockNumber
- Number
: Block number where this transaction was in. null
when its pending.
transactionIndex
- Number
: Integer of the transactions index position in the block. null
when its pending.
from
- String
: Address of the sender.
to
- String
: Address of the receiver. null
when its a contract creation transaction.
value
- String
: Value transferred in ATTO.
gasPrice
- String
: Gas price provided by the sender.
gas
- Number
: Gas provided by the sender.
input
- String
: The data sent along with the transaction.
Sample Curl Request
Sample Curl Response
String
- The transaction hash.
hash
- String
: Hash of the transaction.
nonce
- Number
: The number of transactions made by the sender prior to this one.
blockHash
- String
: Hash of the block where this transaction was in. null
when its pending.
blockNumber
- Number
: Block number where this transaction was in. null
when its pending.
transactionIndex
- Number
: Integer of the transactions index position in the block. null
when its pending.
from
- String
: Address of the sender.
to
- String
: Address of the receiver. null
when its a contract creation transaction.
value
- Number
: Value transferred in ATTO.
gasPrice
- Number
: Gas price provided by the sender.
gas
- Number
: Gas provided by the sender.
input
- String
: The data sent along with the transaction.
Sample Curl Request
Sample Curl Response
GetBlockByNumber
Get block by its index in the blockchain.
Parameters
String
- The block number.
Boolean
- If true
, the returned block will contain all transactions in the block.
number
- Number
: The block number. null
when its pending block.
hash
32 Bytes - String
: Hash of the block. null
when its pending block.
parentHash
32 Bytes - String
: Hash of the parent block.
nonce
8 Bytes - String
: Hash of the generated proof-of-work. null
when its pending block.
logsBloom
256 Bytes - String
: The bloom filter for the logs of the block. null
when its pending block.
transactionsRoot
32 Bytes - String
: The root of the transaction trie of the block
stateRoot
32 Bytes - String
: The root of the final state trie of the block.
miner
- String
: The address of the beneficiary to whom the mining rewards were given.
difficulty
- String
: Integer of the difficulty for this block.
extraData
- String
: The “extra data” field of this block.
size
- Number
: Integer the size of this block in bytes.
gasLimit
- Number
: The maximum gas allowed in this block.
gasUsed
- Number
: The total used gas by all transactions in this block.
timestamp
- Number
: The unix timestamp for when the block was collated.
stakingTransactions
- Array
: Array of staking transactions object; are present by default
transactions
- Array
: Array of transaction objects; absent if second parameter is false
.
uncles
- Array
: Array of uncle hashes.
Sample Curl Request
Sample Curl Response
Parameters
Number
- The block number.
blockArgs
- optional args struct in json format (should be used just with { })
fullTx
- Bool
: To show full tx or not
withSigners
- Bool
: Include block signes in blocks or not
inclStaking
- Bool
: To show staking txs or not
number
- Number
: The block number. null
when its pending block.
hash
32 Bytes - String
: Hash of the block. null
when its pending block.
parentHash
32 Bytes - String
: Hash of the parent block.
nonce
8 Bytes - String
: Hash of the generated proof-of-work. null
when its pending block.
logsBloom
256 Bytes - String
: The bloom filter for the logs of the block. null
when its pending block.
transactionsRoot
32 Bytes - String
: The root of the transaction trie of the block
stateRoot
32 Bytes - String
: The root of the final state trie of the block.
miner
- String
: The address of the beneficiary to whom the mining rewards were given.
difficulty
- String
: Integer of the difficulty for this block.
extraData
- String
: The “extra data” field of this block.
size
- Number
: Integer the size of this block in bytes.
gasLimit
- Number
: The maximum gas allowed in this block.
gasUsed
- Number
: The total used gas by all transactions in this block.
timestamp
- Number
: The unix timestamp for when the block was collated.
stakingTransactions
- Array
: Array of staking transactions object; absent if inclStaking is false, are present by default
transactions
- Array
: Array of transaction objects; absent if second parameter is false
.
uncles
- Array
: Array of uncle hashes.
Sample Curl Request
Sample Curl Response
hmy_latestHeader
None
blockHash
- String
- block hash
blockNumber
- Number
- block number
shardID
- Number
- shard id
leader
- String
- leader address
viewID
- Number
- current blockchain view of validators
epoch
- Number
- blockchain epoch
timestamp
- Date
- block generation timestamp date
unixtime
- Number
- block generation time in Unix time
lastCommitSig
- String
- BLS validators signature for the block
lastCommitBitmap
- String
- last commit bitmap for block signers
hmy_getStorageAt
Returns the value from a storage position at a given address.
Parameters
DATA
, 20 Bytes - address of the storage.
QUANTITY
- integer of the position in the storage.
QUANTITY|TAG
- integer block number, or the string "latest"
, "earliest"
or "pending"
Returns
DATA
- the value at this storage position.
Example
Calculating the correct position depends on the storage to retrieve. Consider the following contract deployed at 0x295a70b2de5e3953354a6a8344e616ed314d7251
by address 0x391694e7e0b0cce554cb130d723a9d27458f9298
.
Retrieving the value of pos0 is straight forward:
hmy_estimateGas
Generates and returns an estimate of how much gas is necessary to allow the transaction to complete. The transaction will not be added to the blockchain.
Parameters
See hmy_call parameters, expect that all properties are optional. If no gas limit is specified geth uses the block gas limit from the pending block as an upper bound. As a result the returned estimate might not be enough to executed the call/transaction when the amount of gas is higher than the pending block gas limit.
Returns
QUANTITY
- the amount of gas used.
Example
hmy_getEpoch returns current epoch of shard
Returns
String
- Current requested node shard epoch 0x format
Sample Curl Request
Sample Curl Response
Returns
uint64
- Current requested node shard epoch decimal format
Sample Curl Request
Sample Curl Response
If Node.js is installed on your system, one easy way to convert hexadecimal balances into a more readable decimal format is to run node -e "console.log(<balance>)"
GetShardingStructure
Net_PeerCount
Gets the number of peers on the network.
Sample Curl Request
Sample Curl Response
hmy_getAllValidatorInformation
Get staking validator information for all validators.
Number
- page num default to page 1. Not possible to have all data at once.
Array of:
current-epoch-signing-percent
current-epoch-signed
- Number
- epoch when last block was signed by validator
current-epoch-to-sign
- Number
- current epoch
percentage
- Float
- percentage of blocks signed
current-epoch-voting-power
- Array of
effective-stake
- Float
- effective validator stake
shard-id
- Number
- shard id
voting-power-adjusted
- Float
- voting power adjusted
voting-power-raw
- Float
- voting power
validator
availability:
num-of-blocks-to-sign
- Number
- big.Int number of blocks validator should have signed in active mode
num-blocks-signed
- Number
- big.Int number of blocks validator actually signed
address
- String
- ECSDA validator address
bls-public-keys
- []String
- array of validator bls public keys
last-epoch-in-committee
- Number
- big.Int last epoch in committee
min-self-delegation
- Number
- big.Int min self delegation
max-total-delegation
- Number
- big.Int max total delegated to this validator
active
- Bool
- is valdiator currently active
rate
- Float
- validator current commission rate
max-rate
- Float
- max validator commission rate
max-change-rate
- Float
- max validator commission rate change
update-height
- Number
- big.Int last commission update block height
name
- String
- validator name
identity
- String
- validator text kyc identity
website
- String
- validator website
security-contact
- String
- validator security contact
details
- String
- additional info
creation-height
- Number
- big.Int block height when validator was created
banned
- Bool
- is validator banned
Delegations:
array of validator delegations, check out delegations format in hmy_getDelegationsBy...
Sample Curl Request
Sample Curl Response
hmy_getAllValidatorInformationByBlockNumber
Get staking validator information snapshot for all validators by blocknum.
Number
- page num default to page 1. Not possible to have all data at once.
Number
- block number
Array of:
current-epoch-signing-percent
current-epoch-signed
- Number
- epoch when last block was signed by validator
current-epoch-to-sign
- Number
- current epoch
percentage
- Float
- percentage of blocks signed
current-epoch-voting-power
- Array of
effective-stake
- Float
- effective validator stake
shard-id
- Number
- shard id
voting-power-adjusted
- Float
- voting power adjusted
voting-power-raw
- Float
- voting power
validator
availability:
num-of-blocks-to-sign
- Number
- big.Int number of blocks validator should have signed in active mode
num-blocks-signed
- Number
- big.Int number of blocks validator actually signed
address
- String
- ECSDA validator address
bls-public-keys
- []String
- array of validator bls public keys
last-epoch-in-committee
- Number
- big.Int last epoch in committee
min-self-delegation
- Number
- big.Int min self delegation
max-total-delegation
- Number
- big.Int max total delegated to this validator
active
- Bool
- is valdiator currently active
rate
- Float
- validator current commission rate
max-rate
- Float
- max validator commission rate
max-change-rate
- Float
- max validator commission rate change
update-height
- Number
- big.Int last commission update block height
name
- String
- validator name
identity
- String
- validator text kyc identity
website
- String
- validator website
security-contact
- String
- validator security contact
details
- String
- additional info
creation-height
- Number
- big.Int block height when validator was created
banned
- Bool
- is validator banned
Delegations:
array of validator delegations, check out delegations format in hmy_getDelegationsBy...
Sample Curl Request
Sample Curl Response
hmy_getValidatorInformation
Get staking validator information.
String
- validator bech32 address.
current-epoch-signing-percent
current-epoch-signed
- Number
- epoch when last block was signed by validator
current-epoch-to-sign
- Number
- current epoch
percentage
- Float
- percentage of blocks signed
current-epoch-voting-power
- Array of
effective-stake
- Float
- effective validator stake
shard-id
- Number
- shard id
voting-power-adjusted
- Float
- voting power adjusted
voting-power-raw
- Float
- voting power
validator
availability:
num-of-blocks-to-sign
- Number
- big.Int number of blocks validator should have signed in active mode
num-blocks-signed
- Number
- big.Int number of blocks validator actually signed
address
- String
- ECSDA validator address
bls-public-keys
- []String
- array of validator bls public keys
last-epoch-in-committee
- Number
- big.Int last epoch in committee
min-self-delegation
- Number
- big.Int min self delegation
max-total-delegation
- Number
- big.Int max total delegated to this validator
active
- Bool
- is valdiator currently active
rate
- Float
- validator current commission rate
max-rate
- Float
- max validator commission rate
max-change-rate
- Float
- max validator commission rate change
update-height
- Number
- big.Int last commission update block height
name
- String
- validator name
identity
- String
- validator text kyc identity
website
- String
- validator website
security-contact
- String
- validator security contact
details
- String
- additional info
creation-height
- Number
- big.Int block height when validator was created
banned
- Bool
- is validator banned
Delegations:
array of validator delegations, check out delegations format in hmy_getDelegationsBy...
Sample Curl Request
Sample Curl Response
Get global staking info.
total-staking
- Number
- big.Int total staking by validators
circulating-supply
- Float
- current circulating supply
total-supply
- Number
- total ONE supply (12600000000)
median-raw-stake
- Float
- median raw validators stake
epoch-last-block
- Number
- previous epoch last block
Sample Curl Request
Sample Curl Response
hmy_getCurrentUtilityMetrics
Works only for shard 0 (beacon chain).
AccumulatorSnapshot
- Number
- total staking
CurrentStakedPercentage
- Float
- total staking percentage from circulating supply now
Deviation
- Float
- deviation from average earned stake
Adjustment
- Float
- adjustment
Sample Curl Request
Sample Curl Response
hmy_getDelegationsByValidator
String
- validator bech32 address.
Array of:
validator_address
- String
- validator bech32 address
delegator_address
- String
- delegator bech32 address
amount
- Number
- big.Int amount delegated to validator
reward
- Number
- big.Int reward to validator for delegation
Undelegations
- []RPCUndelegation
:
amount
- Number
- big.Int amount returned to delegator
reward
- Number
- big.Int reward to validator
Sample Curl Request
Sample Curl Response
hmy_getDelegationsByDelegator
String
- delegator bech32 address.
Array of:
validator_address
- String
- validator bech32 address
delegator_address
- String
- delegator bech32 address
amount
- Number
- big.Int amount delegated to validator
reward
- Number
- big.Int reward to validator for delegation
Undelegations
- []RPCUndelegation
:
amount
- Number
- big.Int amount returned to delegator
reward
- Number
- big.Int reward to validator
Sample Curl Request
Sample Curl Response
hmy_getDelegationsByDelegatorAndValidator
String
- delegator bech32 address.
String
- validator bech32 address.
Array of:
validator_address
- String
- validator bech32 address
delegator_address
- String
- delegator bech32 address
amount
- Number
- big.Int amount delegated to validator
reward
- Number
- big.Int reward to validator for delegation
Undelegations
- []RPCUndelegation
:
amount
- Number
- big.Int amount returned to delegator
reward
- Number
- big.Int reward to validator
Sample Curl Request
Sample Curl Response
hmy_getValidatorMetrics
String
- validator bech32 address.
NumJailed
- Number
- big.Int number of times validator was banned due to downtime
TotalEffectiveStake - Float - total validator effective stake from delegations
VotingPowerPerShard
- []VotePerShard
:
shard-id
- Number
- shard id
voting-power
- Float
- valdator voting power for this shard
BLSKeyPerShard
- []KeyPerShard:
shard-id
- Number
- shard id
keys
- []String
- validator bls keys for this shard
Sample Curl Request
Sample Curl Response
hmy_getValidators returns list of validators for a particular epoch in corresponding shard
uint64
- epoch number
shardID
- Uint32
- shard id
validators
- Array
: list of validators in below format
address
- String
: one address
balance
- String
: validator current balance (will be replaced with stake soon) 0x format
uint64
- epoch number
shardID
- Uint32
- shard id
validators
- Array
: list of validators in below format
address
- String
: one address
balance
- Number
: validator current balance (will be replaced with stake soon)
hmy_isBlockSigner returns true is validator signed a particular block or not
String
- block number in string 0x format
String
- validator one address ("one1...")
Bool
- true if validator signed block, false otherwise
Sample Curl Response
Number
- block number
String
- validator one address ("one1...")
Bool
- true if validator signed block, false otherwise
Sample Curl Response
hmy_getBlocksSigners returns list of block signers
String
- block number in string 0x format
Array
of String
: one addresses list of validators who signed this block
Sample Curl Response
Number
- block number
Array
of String
: one addresses list of validators who signed this block
Sample Curl Response
hmy_call
Executes a new message call immediately without creating a transaction on the block chain.
Parameters
Object
- The transaction call object
from
: DATA
, 20 Bytes - (optional) The address the transaction is sent from.
to
: DATA
, 20 Bytes - The address the transaction is directed to.
gas
: QUANTITY
- (optional) Integer of the gas provided for the transaction execution. eth_call consumes zero gas, but this parameter may be needed by some executions.
gasPrice
: QUANTITY
- (optional) Integer of the gasPrice used for each paid gas
value
: QUANTITY
- (optional) Integer of the value sent with this transaction
data
: DATA
- (optional) Hash of the method signature and encoded parameters.
QUANTITY|TAG
- integer block number, or the string "latest"
, "earliest"
or "pending"
Returns
DATA
- the return value of executed contract.
Example