mirror of
https://github.com/codex-storage/nim-json-rpc.git
synced 2025-02-23 16:38:22 +00:00
125 lines
9.3 KiB
Nim
125 lines
9.3 KiB
Nim
import stint
|
|
|
|
type
|
|
SyncObject* = object
|
|
startingBlock*: int
|
|
currentBlock*: int
|
|
highestBlock*: int
|
|
|
|
EthSend* = object
|
|
source*: array[20, byte] # the address the transaction is send from.
|
|
to*: array[20, byte] # (optional when creating new contract) the address the transaction is directed to.
|
|
gas*: int # (optional, default: 90000) integer of the gas provided for the transaction execution. It will return unused gas.
|
|
gasPrice*: int # (optional, default: To-Be-Determined) integer of the gasPrice used for each paid gas.
|
|
value*: int # (optional) integer of the value sent with this transaction.
|
|
data*: int # the compiled code of a contract OR the hash of the invoked method signature and encoded parameters. For details see Ethereum Contract ABI.
|
|
nonce*: int # (optional) integer of a nonce. This allows to overwrite your own pending transactions that use the same nonce
|
|
|
|
EthCall* = object
|
|
source*: array[20, byte] # (optional) The address the transaction is send from.
|
|
to*: array[20, byte] # The address the transaction is directed to.
|
|
gas*: int # (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*: int # (optional) Integer of the gasPrice used for each paid gas.
|
|
value*: int # (optional) Integer of the value sent with this transaction.
|
|
data*: int # (optional) Hash of the method signature and encoded parameters. For details see Ethereum Contract ABI.
|
|
|
|
## A block object, or null when no block was found
|
|
BlockObject* = ref object
|
|
number*: int # the block number. null when its pending block.
|
|
hash*: UInt256 # hash of the block. null when its pending block.
|
|
parentHash*: UInt256 # hash of the parent block.
|
|
nonce*: int64 # hash of the generated proof-of-work. null when its pending block.
|
|
sha3Uncles*: UInt256 # SHA3 of the uncles data in the block.
|
|
logsBloom*: array[256, byte] # the bloom filter for the logs of the block. null when its pending block.
|
|
transactionsRoot*: UInt256 # the root of the transaction trie of the block.
|
|
stateRoot*: UInt256 # the root of the final state trie of the block.
|
|
receiptsRoot*: UInt256 # the root of the receipts trie of the block.
|
|
miner*: array[20, byte] # the address of the beneficiary to whom the mining rewards were given.
|
|
difficulty*: int # integer of the difficulty for this block.
|
|
totalDifficulty*: int # integer of the total difficulty of the chain until this block.
|
|
extraData*: string # the "extra data" field of this block.
|
|
size*: int # integer the size of this block in bytes.
|
|
gasLimit*: int # the maximum gas allowed in this block.
|
|
gasUsed*: int # the total used gas by all transactions in this block.
|
|
timestamp*: int # the unix timestamp for when the block was collated.
|
|
transactions*: seq[Uint256] # list of transaction objects, or 32 Bytes transaction hashes depending on the last given parameter.
|
|
uncles*: seq[Uint256] # list of uncle hashes.
|
|
|
|
TransactionObject* = object # A transaction object, or null when no transaction was found:
|
|
hash*: UInt256 # hash of the transaction.
|
|
nonce*: int64 # TODO: Is int? the number of transactions made by the sender prior to this one.
|
|
blockHash*: UInt256 # hash of the block where this transaction was in. null when its pending.
|
|
blockNumber*: int64 # block number where this transaction was in. null when its pending.
|
|
transactionIndex*: int64 # integer of the transactions index position in the block. null when its pending.
|
|
source*: array[20, byte] # address of the sender.
|
|
to*: array[20, byte] # address of the receiver. null when its a contract creation transaction.
|
|
value*: int64 # value transferred in Wei.
|
|
gasPrice*: int64 # gas price provided by the sender in Wei.
|
|
gas*: int64 # gas provided by the sender.
|
|
input*: seq[byte] # the data send along with the transaction.
|
|
|
|
ReceiptKind* = enum rkRoot, rkStatus
|
|
ReceiptObject* = object
|
|
# A transaction receipt object, or null when no receipt was found:
|
|
transactionHash*: UInt256 # hash of the transaction.
|
|
transactionIndex*: int # integer of the transactions index position in the block.
|
|
blockHash*: UInt256 # hash of the block where this transaction was in.
|
|
blockNumber*: int # block number where this transaction was in.
|
|
cumulativeGasUsed*: int # the total amount of gas used when this transaction was executed in the block.
|
|
gasUsed*: int # the amount of gas used by this specific transaction alone.
|
|
contractAddress*: array[20, byte] # the contract address created, if the transaction was a contract creation, otherwise null.
|
|
logs*: seq[string] # TODO: See Wiki for details. list of log objects, which this transaction generated.
|
|
logsBloom*: array[256, byte] # bloom filter for light clients to quickly retrieve related logs.
|
|
# TODO:
|
|
#case kind*: ReceiptKind
|
|
#of rkRoot: root*: UInt256 # post-transaction stateroot (pre Byzantium).
|
|
#of rkStatus: status*: int # 1 = success, 0 = failure.
|
|
|
|
FilterDataKind* = enum fkItem, fkList
|
|
FilterData* = object
|
|
# Difficult to process variant objects in input data, as kind is immutable.
|
|
# TODO: This might need more work to handle "or" options
|
|
kind*: FilterDataKind
|
|
items*: seq[FilterData]
|
|
item*: UInt256
|
|
# TODO: I don't think this will work as input, need only one value that is either UInt256 or seq[UInt256]
|
|
|
|
FilterOptions* = object
|
|
fromBlock*: string # (optional, default: "latest") integer block number, or "latest" for the last mined block or "pending", "earliest" for not yet mined transactions.
|
|
toBlock*: string # (optional, default: "latest") integer block number, or "latest" for the last mined block or "pending", "earliest" for not yet mined transactions.
|
|
address*: seq[array[20, byte]] # (optional) contract address or a list of addresses from which logs should originate.
|
|
topics*: seq[FilterData] # (optional) list of DATA topics. Topics are order-dependent. Each topic can also be a list of DATA with "or" options.
|
|
|
|
LogObject* = object
|
|
removed*: bool # true when the log was removed, due to a chain reorganization. false if its a valid log.
|
|
logIndex*: int # integer of the log index position in the block. null when its pending log.
|
|
transactionIndex*: ref int # integer of the transactions index position log was created from. null when its pending log.
|
|
transactionHash*: UInt256 # hash of the transactions this log was created from. null when its pending log.
|
|
blockHash*: ref UInt256 # hash of the block where this log was in. null when its pending. null when its pending log.
|
|
blockNumber*: ref int64 # the block number where this log was in. null when its pending. null when its pending log.
|
|
address*: array[20, byte] # address from which this log originated.
|
|
data*: seq[UInt256] # contains one or more 32 Bytes non-indexed arguments of the log.
|
|
topics*: array[4, UInt256] # 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.)
|
|
|
|
WhisperPost* = object
|
|
# The whisper post object:
|
|
source*: array[60, byte] # (optional) the identity of the sender.
|
|
to*: array[60, byte] # (optional) the identity of the receiver. When present whisper will encrypt the message so that only the receiver can decrypt it.
|
|
topics*: seq[UInt256] # TODO: Correct type? list of DATA topics, for the receiver to identify messages.
|
|
payload*: UInt256 # TODO: Correct type - maybe string? the payload of the message.
|
|
priority*: int # integer of the priority in a rang from ... (?).
|
|
ttl*: int # integer of the time to live in seconds.
|
|
|
|
WhisperMessage* = object
|
|
# (?) are from the RPC Wiki, indicating uncertainty in type format.
|
|
hash*: UInt256 # (?) the hash of the message.
|
|
source*: array[60, byte] # the sender of the message, if a sender was specified.
|
|
to*: array[60, byte] # the receiver of the message, if a receiver was specified.
|
|
expiry*: int # integer of the time in seconds when this message should expire (?).
|
|
ttl*: int # integer of the time the message should float in the system in seconds (?).
|
|
sent*: int # integer of the unix timestamp when the message was sent.
|
|
topics*: seq[UInt256] # list of DATA topics the message contained.
|
|
payload*: string # TODO: Correct type? the payload of the message.
|
|
workProved*: int # integer of the work this message required before it was send (?). |