You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
793 lines
24 KiB
793 lines
24 KiB
from .rpc.request import (
|
|
rpc_request
|
|
)
|
|
from .exceptions import (
|
|
TxConfirmationTimedoutError,
|
|
InvalidRPCReplyError
|
|
)
|
|
import time
|
|
import random
|
|
|
|
_default_endpoint = 'http://localhost:9500'
|
|
_default_timeout = 30
|
|
|
|
|
|
#########################
|
|
# Transaction Pool RPCs #
|
|
#########################
|
|
def get_pending_transactions(endpoint=_default_endpoint, timeout=_default_timeout) -> list:
|
|
"""
|
|
Get list of pending transactions
|
|
|
|
Parameters
|
|
----------
|
|
endpoint: :obj:`str`, optional
|
|
Endpoint to send request to
|
|
timeout: :obj:`int`, optional
|
|
Timeout in seconds
|
|
|
|
Returns
|
|
-------
|
|
list of transactions in the pool, see get_transaction_by_hash for a description
|
|
|
|
Raises
|
|
------
|
|
InvalidRPCReplyError
|
|
If received unknown result from endpoint
|
|
|
|
API Reference
|
|
-------------
|
|
https://api.hmny.io/#de6c4a12-fa42-44e8-972f-801bfde1dd18
|
|
"""
|
|
method = 'hmyv2_pendingTransactions'
|
|
try:
|
|
return rpc_request(method, endpoint=endpoint, timeout=timeout)['result']
|
|
except KeyError as e:
|
|
raise InvalidRPCReplyError(method, endpoint) from e
|
|
|
|
def get_transaction_error_sink(endpoint=_default_endpoint, timeout=_default_timeout) -> list:
|
|
"""
|
|
Get current transactions error sink
|
|
|
|
Parameters
|
|
----------
|
|
endpoint: :obj:`str`, optional
|
|
Endpoint to send request to
|
|
timeout: :obj:`int`, optional
|
|
Timeout in seconds
|
|
|
|
Returns
|
|
-------
|
|
list of transaction failure dictionaries with the following keys:
|
|
tx-hash-id: :obj:`str` Transaction hash
|
|
time-at-rejection: :obj:`int` Unix time when the transaction was rejected from the pool
|
|
error-message: :obj:`str` Reason for transaction rejection (for example insufficient funds)
|
|
|
|
Raises
|
|
------
|
|
InvalidRPCReplyError
|
|
If received unknown result from endpoint
|
|
|
|
API Reference
|
|
-------------
|
|
https://api.hmny.io/#9aedbc22-6262-44b1-8276-cd8ae19fa600
|
|
"""
|
|
method = 'hmyv2_getCurrentTransactionErrorSink'
|
|
try:
|
|
return rpc_request(method, endpoint=endpoint, timeout=timeout)['result']
|
|
except KeyError as e:
|
|
raise InvalidRPCReplyError(method, endpoint) from e
|
|
|
|
def get_pending_staking_transactions(endpoint=_default_endpoint, timeout=_default_timeout) -> list:
|
|
"""
|
|
Get list of pending staking transactions
|
|
|
|
Parameters
|
|
----------
|
|
endpoint: :obj:`str`, optional
|
|
Endpoint to send request to
|
|
timeout: :obj:`int`, optional
|
|
Timeout in seconds
|
|
|
|
Returns
|
|
-------
|
|
list of staking transactions in the pool, see get_staking_transaction_by_hash for a description
|
|
|
|
Raises
|
|
------
|
|
InvalidRPCReplyError
|
|
If received unknown result from endpoint
|
|
|
|
API Reference
|
|
-------------
|
|
https://api.hmny.io/#de0235e4-f4c9-4a69-b6d2-b77dc1ba7b12
|
|
"""
|
|
method = 'hmyv2_pendingStakingTransactions'
|
|
try:
|
|
return rpc_request(method, endpoint=endpoint, timeout=timeout)['result']
|
|
except KeyError as e:
|
|
raise InvalidRPCReplyError(method, endpoint) from e
|
|
|
|
|
|
def get_staking_transaction_error_sink(endpoint=_default_endpoint, timeout=_default_timeout) -> list:
|
|
"""
|
|
Get current staking transactions error sink
|
|
|
|
Parameters
|
|
----------
|
|
endpoint: :obj:`str`, optional
|
|
Endpoint to send request to
|
|
timeout: :obj:`int`, optional
|
|
Timeout in seconds
|
|
|
|
Returns
|
|
-------
|
|
list of transaction failure dictionaries with the following keys:
|
|
tx-hash-id: :obj:`str` Transaction hash
|
|
time-at-rejection: :obj:`int` Unix time when the transaction was rejected from the pool
|
|
error-message: :obj:`str` Reason for transaction rejection (for example insufficient funds)
|
|
directive-kind: :obj:`str` Tope of staking transaction
|
|
|
|
Raises
|
|
------
|
|
InvalidRPCReplyError
|
|
If received unknown result from endpoint
|
|
|
|
API Reference
|
|
-------------
|
|
https://api.hmny.io/#bdd00e0f-2ba0-480e-b996-2ef13f10d75a
|
|
"""
|
|
method = 'hmyv2_getCurrentStakingErrorSink'
|
|
try:
|
|
return rpc_request(method, endpoint=endpoint, timeout=timeout)['result']
|
|
except KeyError as e:
|
|
raise InvalidRPCReplyError(method, endpoint) from e
|
|
|
|
def get_pool_stats(endpoint=_default_endpoint, timeout=_default_timeout) -> dict:
|
|
"""
|
|
Get stats of the pool, that is, number of pending and queued (non-executable) transactions
|
|
|
|
Parameters
|
|
----------
|
|
endpoint: :obj:`str`, optional
|
|
Endpoint to send request to
|
|
timeout: :obj:`int`, optional
|
|
Timeout in seconds
|
|
|
|
Returns
|
|
-------
|
|
dict with the following keys:
|
|
executable-count: :obj:`int` Number of pending transactions
|
|
non-executable-count: :obj:`int` Number of queued (non-executable) transactions
|
|
|
|
Raises
|
|
------
|
|
InvalidRPCReplyError
|
|
If received unknown result from endpoint
|
|
|
|
API Reference
|
|
-------------
|
|
https://api.hmny.io/#7c2b9395-8f5e-4eb5-a687-2f1be683d83e
|
|
"""
|
|
method = 'hmyv2_getPoolStats'
|
|
try:
|
|
return rpc_request(method, endpoint=endpoint, timeout=timeout)['result']
|
|
except KeyError as e:
|
|
raise InvalidRPCReplyError(method, endpoint) from e
|
|
|
|
####################
|
|
# Transaction RPCs #
|
|
####################
|
|
def get_transaction_by_hash(tx_hash, endpoint=_default_endpoint, timeout=_default_timeout) -> dict:
|
|
"""
|
|
Get transaction by hash
|
|
|
|
Parameters
|
|
----------
|
|
tx_hash: str
|
|
Transaction hash to fetch
|
|
endpoint: :obj:`str`, optional
|
|
Endpoint to send request to
|
|
timeout: :obj:`int`, optional
|
|
Timeout in seconds
|
|
|
|
Returns
|
|
-------
|
|
dict with the following keys
|
|
blockHash: :obj:`str` Block hash that transaction was finalized;
|
|
"0x0000000000000000000000000000000000000000000000000000000000000000" if tx is pending
|
|
blockNumber: :obj:`int` Block number that transaction was finalized; None if tx is pending
|
|
ethHash: :obj:`str` legacy from Ethereum; unused
|
|
from: :obj:`str` Wallet address
|
|
timestamp: :obj:`int` Timestamp in Unix time when transaction was finalized
|
|
gas: :obj:`int` Gas limit in Atto
|
|
gasPrice :obj:`int` Gas price in Atto
|
|
hash: :obj:`str` Transaction hash
|
|
input: :obj:`str` Transaction data, used for smart contracts
|
|
nonce: :obj:`int` Wallet nonce for the transaction
|
|
to: :obj:`str` Wallet address of the receiver
|
|
transactionIndex: :obj:`int` Index of transaction in block; None if tx is pending
|
|
value: :obj:`int` Amount transferred in Atto
|
|
shardID: :obj:`int` Shard where amount if from
|
|
toShardID: :obj:`int` Shard where the amount is sent
|
|
r: :obj:`str` First 32 bytes of the transaction signature
|
|
s: :obj:`str` Next 32 bytes of the transaction signature
|
|
v: :obj:`str` Recovery value + 27, as hex string
|
|
or None if the transaction is not found
|
|
|
|
Raises
|
|
------
|
|
InvalidRPCReplyError
|
|
If received unknown result from endpoint
|
|
|
|
API Reference
|
|
-------------
|
|
https://api.hmny.io/#117e84f6-a0ec-444e-abe0-455701310389
|
|
"""
|
|
method = 'hmyv2_getTransactionByHash'
|
|
params = [
|
|
tx_hash
|
|
]
|
|
try:
|
|
return rpc_request(method, params=params, endpoint=endpoint, timeout=timeout)['result']
|
|
except KeyError as e:
|
|
raise InvalidRPCReplyError(method, endpoint) from e
|
|
|
|
def get_transaction_by_block_hash_and_index(block_hash, tx_index,
|
|
endpoint=_default_endpoint, timeout=_default_timeout
|
|
) -> dict:
|
|
"""
|
|
Get transaction based on index in list of transactions in a block by block hash
|
|
|
|
Parameters
|
|
----------
|
|
block_hash: str
|
|
Block hash for transaction
|
|
tx_index: int
|
|
Transaction index to fetch (starts from 0)
|
|
endpoint: :obj:`str`, optional
|
|
Endpoint to send request to
|
|
timeout: :obj:`int`, optional
|
|
Timeout in seconds
|
|
|
|
Returns
|
|
-------
|
|
dict, see get_transaction_by_hash for description
|
|
|
|
Raises
|
|
------
|
|
InvalidRPCReplyError
|
|
If received unknown result from endpoint
|
|
|
|
API Reference
|
|
-------------
|
|
https://api.hmny.io/#7c7e8d90-4984-4ebe-bb7e-d7adec167503
|
|
"""
|
|
method = 'hmyv2_getTransactionByBlockHashAndIndex'
|
|
params = [
|
|
block_hash,
|
|
tx_index
|
|
]
|
|
try:
|
|
return rpc_request(method, params=params, endpoint=endpoint, timeout=timeout)['result']
|
|
except KeyError as e:
|
|
raise InvalidRPCReplyError(method, endpoint) from e
|
|
|
|
def get_transaction_by_block_number_and_index(block_num, tx_index,
|
|
endpoint=_default_endpoint, timeout=_default_timeout
|
|
) -> dict:
|
|
"""
|
|
Get transaction based on index in list of transactions in a block by block number
|
|
|
|
Parameters
|
|
----------
|
|
block_num: int
|
|
Block number for transaction
|
|
tx_index: int
|
|
Transaction index to fetch (starts from 0)
|
|
endpoint: :obj:`str`, optional
|
|
Endpoint to send request to
|
|
timeout: :obj:`int`, optional
|
|
Timeout in seconds
|
|
|
|
Returns
|
|
-------
|
|
dict, see get_transaction_by_hash for description
|
|
|
|
Raises
|
|
------
|
|
InvalidRPCReplyError
|
|
If received unknown result from endpoint
|
|
|
|
API Reference
|
|
-------------
|
|
https://api.hmny.io/#bcde8b1c-6ab9-4950-9835-3c7564e49c3e
|
|
"""
|
|
method = 'hmyv2_getTransactionByBlockNumberAndIndex'
|
|
params = [
|
|
block_num,
|
|
tx_index
|
|
]
|
|
try:
|
|
return rpc_request(method, params=params, endpoint=endpoint, timeout=timeout)['result']
|
|
except KeyError as e:
|
|
raise InvalidRPCReplyError(method, endpoint) from e
|
|
|
|
def get_transaction_receipt(tx_hash, endpoint=_default_endpoint, timeout=_default_timeout) -> dict:
|
|
"""
|
|
Get transaction receipt corresponding to tx_hash
|
|
|
|
Parameters
|
|
----------
|
|
tx_hash: str
|
|
Transaction receipt to fetch
|
|
endpoint: :obj:`str`, optional
|
|
Endpoint to send request to
|
|
timeout: :obj:`int`, optional
|
|
Timeout in seconds
|
|
|
|
Returns
|
|
-------
|
|
dict with the following keys:
|
|
blockHash: :obj:`str` Block hash
|
|
blockNumber: :obj:`int` Block number
|
|
contractAddress: :obj:`str` Smart contract address
|
|
culmulativeGasUsed: :obj:`int` Gas used for transaction
|
|
from: :obj:`str` Sender wallet address
|
|
gasUsed: :obj:`int` Gas used for the transaction
|
|
logs: :obj:`list` List of logs, each being a dict with keys as follows:
|
|
address, blockHash, blockNumber, data, logIndex, removed, topics, transactionHash, transactionIndex
|
|
logsBloom :obj:`str` Bloom logs
|
|
shardID :obj:`int` Shard ID
|
|
status :obj:`int` Status of transaction (0: pending, 1: success)
|
|
to :obj:`str` Receiver wallet address
|
|
transactionHash :obj:`str` Transaction hash
|
|
transactionIndex :obj:`int` Transaction index within block
|
|
|
|
Raises
|
|
------
|
|
InvalidRPCReplyError
|
|
If received unknown result from endpoint
|
|
|
|
API Reference
|
|
-------------
|
|
https://api.hmny.io/#0c2799f8-bcdc-41a4-b362-c3a6a763bb5e
|
|
"""
|
|
method = 'hmyv2_getTransactionReceipt'
|
|
params = [
|
|
tx_hash
|
|
]
|
|
try:
|
|
return rpc_request(method, params=params, endpoint=endpoint, timeout=timeout)['result']
|
|
except KeyError as e:
|
|
raise InvalidRPCReplyError(method, endpoint) from e
|
|
|
|
def send_raw_transaction(signed_tx, endpoint=_default_endpoint, timeout=_default_timeout) -> str:
|
|
"""
|
|
Send signed transaction
|
|
|
|
Parameters
|
|
----------
|
|
signed_tx: str
|
|
Hex representation of signed transaction
|
|
endpoint: :obj:`str`, optional
|
|
Endpoint to send request to
|
|
timeout: :obj:`int`, optional
|
|
Timeout in seconds
|
|
|
|
Returns
|
|
-------
|
|
str
|
|
Transaction hash
|
|
|
|
Raises
|
|
------
|
|
InvalidRPCReplyError
|
|
If received unknown result from endpoint, or
|
|
RPCError
|
|
If transaction failed to be added to the pool
|
|
|
|
API Reference
|
|
-------------
|
|
https://api.hmny.io/#f40d124a-b897-4b7c-baf3-e0dedf8f40a0
|
|
"""
|
|
params = [
|
|
signed_tx
|
|
]
|
|
method = 'hmyv2_sendRawTransaction'
|
|
try:
|
|
return rpc_request(method, params=params, endpoint=endpoint, timeout=timeout)['result']
|
|
except KeyError as e:
|
|
raise InvalidRPCReplyError(method, endpoint) from e
|
|
|
|
def send_and_confirm_raw_transaction(signed_tx, endpoint=_default_endpoint, timeout=_default_timeout) -> list:
|
|
"""
|
|
Send signed transaction and wait for it to be confirmed
|
|
|
|
Parameters
|
|
----------
|
|
signed_tx: str
|
|
Hex representation of signed transaction
|
|
endpoint: :obj:`str`, optional
|
|
Endpoint to send request to
|
|
timeout: :obj:`int`, optional
|
|
Timeout in seconds
|
|
|
|
Returns
|
|
-------
|
|
str
|
|
Transaction, see get_transaction_by_hash for structure
|
|
|
|
Raises
|
|
------
|
|
InvalidRPCReplyError
|
|
If received unknown result from endpoint, or
|
|
RPCError
|
|
If transaction failed to be added to the pool
|
|
TxConfirmationTimedoutError
|
|
If transaction could not be confirmed within the timeout period
|
|
|
|
API Reference
|
|
-------------
|
|
https://api.hmny.io/#f40d124a-b897-4b7c-baf3-e0dedf8f40a0
|
|
"""
|
|
tx_hash = send_raw_transaction(signed_tx, endpoint=endpoint)
|
|
start_time = time.time()
|
|
while((time.time() - start_time) <= timeout):
|
|
tx_response = get_transaction_by_hash(tx_hash, endpoint=endpoint)
|
|
if tx_response is not None:
|
|
block_hash = tx_response.get( "blockHash", "0x00" )
|
|
unique_chars = "".join( set( list( block_hash[ 2 : ] ) ) )
|
|
if unique_chars != "0":
|
|
return tx_response
|
|
time.sleep(random.uniform(0.2, 0.5))
|
|
raise TxConfirmationTimedoutError("Could not confirm transactions on-chain.")
|
|
|
|
###############################
|
|
# CrossShard Transaction RPCs #
|
|
###############################
|
|
def get_pending_cx_receipts(endpoint=_default_endpoint, timeout=_default_timeout) -> list:
|
|
"""
|
|
Get list of pending cross shard transactions
|
|
|
|
Parameters
|
|
----------
|
|
endpoint: :obj:`str`, optional
|
|
Endpoint to send request to
|
|
timeout: :obj:`int`, optional
|
|
Timeout in seconds
|
|
|
|
Returns
|
|
-------
|
|
list of CX receipts, each a dict with the following keys
|
|
commitBitmap: :obj:`str` Hex represenation of aggregated signature bitmap
|
|
commitSig: :obj:`str` Hex representation of aggregated signature
|
|
receipts: :obj:`list` list of dictionaries, each representing a cross shard transaction receipt
|
|
amount: :obj:`int` Amount in ATTO
|
|
from: :obj:`str` From address
|
|
to: :obj:`str` From address
|
|
shardId: :obj:`int` Originating shard ID
|
|
toShardId: :obj:`int` Destination shard ID
|
|
txHash: :obj:`str` Transation hash
|
|
merkleProof: :obj:`dict` dictionary with the following keys:
|
|
blockHash: :obj:`str` Block hash
|
|
blockNum: :obj:`int` Block number
|
|
receiptHash: :obj:`str` Transaction receipt hash
|
|
shardHashes: :obj:`list` Shard hashes for shardIDs
|
|
shardID: :obj:`int` Shard ID of originating block
|
|
shardIDs: :obj:`list` To shard(s)
|
|
header: :obj:`dict` with the following keys (those not noted below are legacy)
|
|
shardID: :obj:`int` Originating shard ID
|
|
hash: :obj:`str` Block header hash
|
|
number: :obj:`int` Block number
|
|
viewID: :obj:`int` View ID
|
|
epoch: :obj:`int` Epoch number
|
|
|
|
Raises
|
|
------
|
|
InvalidRPCReplyError
|
|
If received unknown result from endpoint, or
|
|
if transaction failed to be added to the pool
|
|
|
|
API Reference
|
|
-------------
|
|
https://api.hmny.io/#fe60070d-97b4-458d-9365-490b44c18851
|
|
"""
|
|
method = 'hmyv2_getPendingCXReceipts'
|
|
try:
|
|
return rpc_request(method, endpoint=endpoint, timeout=timeout)['result']
|
|
except KeyError as e:
|
|
raise InvalidRPCReplyError(method, endpoint) from e
|
|
|
|
def get_cx_receipt_by_hash(cx_hash, endpoint = _default_endpoint, timeout = _default_timeout) -> dict:
|
|
"""
|
|
Get cross shard receipt by hash on the receiving shard end point
|
|
|
|
Parameters
|
|
----------
|
|
cx_hash: str
|
|
Hash of cross shard transaction receipt
|
|
endpoint: :obj:`str`, optional
|
|
Receiving endpoint for the RPC query
|
|
timeout: :obj:`int`, optional
|
|
Timeout in seconds
|
|
|
|
Returns
|
|
-------
|
|
dict with the following keys
|
|
blockHash: :obj:`str` Block hash
|
|
blockNumber: :obj:`int` Block number
|
|
hash: :obj:`str` Transaction hash
|
|
from: :obj:`str` Sender wallet address
|
|
to: :obj:`str` Receiver wallet address
|
|
shardID: :obj:`int` From shard
|
|
toShardID: :obj:`int` To shard
|
|
value: :obj:`int` Amount transferred in Atto
|
|
None if cx receipt hash not found
|
|
|
|
Raises
|
|
------
|
|
InvalidRPCReplyError
|
|
If received unknown result from endpoint
|
|
|
|
API Reference
|
|
-------------
|
|
https://api.hmny.io/#3d6ad045-800d-4021-aeb5-30a0fbf724fe
|
|
"""
|
|
params = [
|
|
cx_hash
|
|
]
|
|
method = 'hmyv2_getCXReceiptByHash'
|
|
try:
|
|
return rpc_request(method, params=params, endpoint=endpoint, timeout=timeout)['result']
|
|
except KeyError as e:
|
|
raise InvalidRPCReplyError(method, endpoint) from e
|
|
|
|
def resend_cx_receipt(cx_hash, endpoint=_default_endpoint, timeout=_default_timeout) -> bool:
|
|
"""
|
|
Resend the cross shard receipt to the receiving shard to re-process if the transaction did not pay out
|
|
|
|
Parameters
|
|
----------
|
|
cx_hash: :obj:`str`
|
|
Hash of cross shard transaction receipt
|
|
endpoint: :obj:`str`, optional
|
|
Endpoint to send request to
|
|
timeout: :obj:`int`, optional
|
|
Timeout in seconds
|
|
|
|
Returns
|
|
-------
|
|
bool
|
|
True if the cross shard receipt was succesfully resent
|
|
|
|
Raises
|
|
------
|
|
InvalidRPCReplyError
|
|
If received unknown result from endpoint
|
|
|
|
API Reference
|
|
-------------
|
|
https://api.hmny.io/#c658b56b-d20b-480d-b71a-b0bc505d2164
|
|
"""
|
|
method = 'hmyv2_resendCx'
|
|
params = [
|
|
cx_hash
|
|
]
|
|
try:
|
|
return rpc_request(method, params=params, endpoint=endpoint, timeout=timeout)['result']
|
|
except KeyError as e:
|
|
raise InvalidRPCReplyError(method, endpoint) from e
|
|
|
|
############################
|
|
# Staking Transaction RPCs #
|
|
############################
|
|
def get_staking_transaction_by_hash(tx_hash, endpoint=_default_endpoint, timeout=_default_timeout) -> dict:
|
|
"""
|
|
Get staking transaction by hash
|
|
|
|
Parameters
|
|
----------
|
|
tx_hash: str
|
|
Hash of staking transaction to fetch
|
|
endpoint: :obj:`str`, optional
|
|
Endpoint to send request to
|
|
timeout: :obj:`int`, optional
|
|
Timeout in seconds
|
|
|
|
Returns
|
|
-------
|
|
dict with the following keys
|
|
blockHash: :obj:`str` Block hash in which transaction was finalized
|
|
blockNumber: :obj:`int` Block number in which transaction was finalized
|
|
from: :obj:`str` Sender wallet address
|
|
timestamp: :obj:`int` Unix time at which transaction was finalized
|
|
gas: :obj:`int` Gas limit of transaction
|
|
gasPrice: :obj:`int` Gas price of transaction in Atto
|
|
hash: :obj:`str` Transaction hash
|
|
nonce: :obj:`int` Wallet nonce of transaction
|
|
transactionIndex: :obj:`int` Staking transaction index within block
|
|
type: :obj:`str` Type of staking transaction
|
|
msg: :obj:`dict` Staking transaction data, depending on the type of staking transaction
|
|
r: :obj:`str` First 32 bytes of the transaction signature
|
|
s: :obj:`str` Next 32 bytes of the transaction signature
|
|
v: :obj:`str` Recovery value + 27, as hex string
|
|
|
|
Raises
|
|
------
|
|
InvalidRPCReplyError
|
|
If received unknown result from endpoint
|
|
|
|
API Reference
|
|
-------------
|
|
https://api.hmny.io/#296cb4d0-bce2-48e3-bab9-64c3734edd27
|
|
"""
|
|
method = 'hmyv2_getStakingTransactionByHash'
|
|
params = [
|
|
tx_hash
|
|
]
|
|
try:
|
|
return rpc_request(method, params=params, endpoint=endpoint, timeout=timeout)['result']
|
|
except KeyError as e:
|
|
raise InvalidRPCReplyError(method, endpoint) from e
|
|
|
|
def get_staking_transaction_by_block_hash_and_index(block_hash, tx_index,
|
|
endpoint=_default_endpoint, timeout=_default_timeout
|
|
) -> dict:
|
|
"""
|
|
Get staking transaction by block hash and transaction index
|
|
|
|
Parameters
|
|
----------
|
|
block_hash: str
|
|
Block hash for transaction
|
|
tx_index: int
|
|
Staking transaction index to fetch (starts at 0)
|
|
endpoint: :obj:`str`, optional
|
|
Endpoint to send request to
|
|
timeout: :obj:`int`, optional
|
|
Timeout in seconds
|
|
|
|
Returns
|
|
-------
|
|
dict, see get_staking_transaction_by_hash for description
|
|
|
|
Raises
|
|
------
|
|
InvalidRPCReplyError
|
|
If received unknown result from endpoint
|
|
|
|
API Reference
|
|
-------------
|
|
https://api.hmny.io/#ba96cf61-61fe-464a-aa06-2803bb4b358f
|
|
"""
|
|
method = 'hmyv2_getStakingTransactionByBlockHashAndIndex'
|
|
params = [
|
|
block_hash,
|
|
tx_index
|
|
]
|
|
try:
|
|
return rpc_request(method, params=params, endpoint=endpoint, timeout=timeout)['result']
|
|
except KeyError as e:
|
|
raise InvalidRPCReplyError(method, endpoint) from e
|
|
|
|
def get_staking_transaction_by_block_number_and_index(block_num, tx_index,
|
|
endpoint=_default_endpoint, timeout=_default_timeout
|
|
) -> dict:
|
|
"""
|
|
Get staking transaction by block number and transaction index
|
|
|
|
Parameters
|
|
----------
|
|
block_num: int
|
|
Block number for transaction
|
|
tx_index: int
|
|
Staking transaction index to fetch
|
|
endpoint: :obj:`str`, optional
|
|
Endpoint to send request to
|
|
timeout: :obj:`int`, optional
|
|
Timeout in seconds
|
|
|
|
Returns
|
|
-------
|
|
dict, see get_staking_transaction_by_hash for description
|
|
|
|
Raises
|
|
------
|
|
InvalidRPCReplyError
|
|
If received unknown result from endpoint
|
|
|
|
API Reference
|
|
-------------
|
|
https://api.hmny.io/#fb41d717-1645-4d3e-8071-6ce8e1b65dd3
|
|
"""
|
|
method = 'hmyv2_getStakingTransactionByBlockNumberAndIndex'
|
|
params = [
|
|
block_num,
|
|
tx_index
|
|
]
|
|
try:
|
|
return rpc_request(method, params=params, endpoint=endpoint, timeout=timeout)['result']
|
|
except KeyError as e:
|
|
raise InvalidRPCReplyError(method, endpoint) from e
|
|
|
|
def send_raw_staking_transaction(raw_tx, endpoint=_default_endpoint, timeout=_default_timeout) -> str:
|
|
"""
|
|
Send signed staking transaction
|
|
|
|
Parameters
|
|
----------
|
|
raw_tx: str
|
|
Hex representation of signed transaction
|
|
endpoint: :obj:`str`, optional
|
|
Endpoint to send request to
|
|
timeout: :obj:`int`, optional
|
|
Timeout in seconds
|
|
|
|
Returns
|
|
-------
|
|
str
|
|
Transaction hash
|
|
|
|
Raises
|
|
------
|
|
InvalidRPCReplyError
|
|
If received unknown result from endpoint, or
|
|
RPCError
|
|
If transaction failed to be added to the pool
|
|
|
|
API Reference
|
|
-------------
|
|
https://api.hmny.io/#e8c17fe9-e730-4c38-95b3-6f1a5b1b9401
|
|
"""
|
|
method = 'hmyv2_sendRawStakingTransaction'
|
|
params = [
|
|
raw_tx
|
|
]
|
|
try:
|
|
return rpc_request(method, params=params, endpoint=endpoint, timeout=timeout)['result']
|
|
except KeyError as e:
|
|
raise InvalidRPCReplyError(method, endpoint) from e
|
|
|
|
def send_and_confirm_raw_staking_transaction(signed_tx, endpoint=_default_endpoint, timeout=_default_timeout) -> list:
|
|
"""
|
|
Send signed staking transaction and wait for it to be confirmed
|
|
|
|
Parameters
|
|
----------
|
|
signed_tx: str
|
|
Hex representation of signed staking transaction
|
|
endpoint: :obj:`str`, optional
|
|
Endpoint to send request to
|
|
timeout: :obj:`int`, optional
|
|
Timeout in seconds
|
|
|
|
Returns
|
|
-------
|
|
str
|
|
Transaction, see get_transaction_by_hash for structure
|
|
|
|
Raises
|
|
------
|
|
InvalidRPCReplyError
|
|
If received unknown result from endpoint, or
|
|
RPCError
|
|
If transaction failed to be added to the pool
|
|
TxConfirmationTimedoutError
|
|
If transaction could not be confirmed within the timeout period
|
|
|
|
API Reference
|
|
-------------
|
|
https://api.hmny.io/#e8c17fe9-e730-4c38-95b3-6f1a5b1b9401
|
|
"""
|
|
tx_hash = send_raw_staking_transaction(signed_tx, endpoint=endpoint)
|
|
start_time = time.time()
|
|
while((time.time() - start_time) <= timeout):
|
|
tx_response = get_staking_transaction_by_hash(tx_hash, endpoint=endpoint)
|
|
if tx_response is not None:
|
|
block_hash = tx_response.get( "blockHash", "0x00" )
|
|
unique_chars = "".join( set( list( block_hash[ 2 : ] ) ) )
|
|
if unique_chars != "0":
|
|
return tx_response
|
|
time.sleep(random.uniform(0.2, 0.5))
|
|
raise TxConfirmationTimedoutError("Could not confirm transactions on-chain.") |