Welcome to Incubed’s documentation!¶

in3

returns: uint64_t

eth_gasPrice¶

uint64_t eth_gasPrice(in3_t *in3);

Returns the current blockNumber, if bn==0 an error occured and you should check eth_last_error()

arguments:

in3

returns: uint64_t

eth_getBlockByNumber¶

eth_block_t* eth_getBlockByNumber(in3_t *in3, eth_blknum_t number, bool include_tx);

Returns the block for the given number (if number==0, the latest will be returned).

If result is null, check eth_last_error()! otherwise make sure to free the result after using it!

arguments:

in3_t *	in3
eth_blknum_t	number
`bool`	include_tx

returns: eth_block_t *

eth_getBlockByHash¶

eth_block_t* eth_getBlockByHash(in3_t *in3, bytes32_t hash, bool include_tx);

Returns the block for the given hash.

If result is null, check eth_last_error()! otherwise make sure to free the result after using it!

arguments:

in3_t *	in3
bytes32_t	hash
`bool`	include_tx

returns: eth_block_t *

eth_getLogs¶

eth_log_t* eth_getLogs(in3_t *in3, char *fopt);

Returns a linked list of logs.

If result is null, check eth_last_error()! otherwise make sure to free the log, its topics and data after using it!

arguments:

in3_t *	in3
`char *`	fopt

returns: eth_log_t *

eth_newFilter¶

in3_ret_t eth_newFilter(in3_t *in3, json_ctx_t *options);

Creates a new event filter with specified options and returns its id (>0) on success or 0 on failure.

arguments:

in3_t *	in3
json_ctx_t *	options

returns: in3_ret_t the result-status of the function.

Please make sure you check if it was successfull (==IN3_OK)

eth_newBlockFilter¶

in3_ret_t eth_newBlockFilter(in3_t *in3);

Creates a new block filter with specified options and returns its id (>0) on success or 0 on failure.

arguments:

in3

returns: in3_ret_t the result-status of the function.

Please make sure you check if it was successfull (==IN3_OK)

eth_newPendingTransactionFilter¶

in3_ret_t eth_newPendingTransactionFilter(in3_t *in3);

Creates a new pending txn filter with specified options and returns its id on success or 0 on failure.

arguments:

in3

returns: in3_ret_t the result-status of the function.

Please make sure you check if it was successfull (==IN3_OK)

eth_uninstallFilter¶

bool eth_uninstallFilter(in3_t *in3, size_t id);

Uninstalls a filter and returns true on success or false on failure.

arguments:

in3_t *	in3
`size_t`	id

returns: bool

eth_getFilterChanges¶

in3_ret_t eth_getFilterChanges(in3_t *in3, size_t id, bytes32_t **block_hashes, eth_log_t **logs);

Sets the logs (for event filter) or blockhashes (for block filter) that match a filter; returns <0 on error, otherwise no.

of block hashes matched (for block filter) or 0 (for log filter)

arguments:

in3_t *	in3
`size_t`	id
bytes32_t **	block_hashes
eth_log_t **	logs

returns: in3_ret_t the result-status of the function.

Please make sure you check if it was successfull (==IN3_OK)

eth_getFilterLogs¶

in3_ret_t eth_getFilterLogs(in3_t *in3, size_t id, eth_log_t **logs);

Sets the logs (for event filter) or blockhashes (for block filter) that match a filter; returns <0 on error, otherwise no.

of block hashes matched (for block filter) or 0 (for log filter)

arguments:

in3_t *	in3
`size_t`	id
eth_log_t **	logs

returns: in3_ret_t the result-status of the function.

Please make sure you check if it was successfull (==IN3_OK)

eth_chainId¶

uint64_t eth_chainId(in3_t *in3);

Returns the currently configured chain id.

arguments:

in3

returns: uint64_t

eth_getBlockTransactionCountByHash¶

uint64_t eth_getBlockTransactionCountByHash(in3_t *in3, bytes32_t hash);

Returns the number of transactions in a block from a block matching the given block hash.

arguments:

in3_t *	in3
bytes32_t	hash

returns: uint64_t

eth_getBlockTransactionCountByNumber¶

uint64_t eth_getBlockTransactionCountByNumber(in3_t *in3, eth_blknum_t block);

Returns the number of transactions in a block from a block matching the given block number.

arguments:

in3_t *	in3
eth_blknum_t	block

returns: uint64_t

eth_call_fn¶

json_ctx_t* eth_call_fn(in3_t *in3, address_t contract, eth_blknum_t block, char *fn_sig,...);

Returns the result of a function_call.

If result is null, check eth_last_error()! otherwise make sure to free the result after using it with json_free()!

arguments:

in3_t *	in3
address_t	contract
eth_blknum_t	block
`char *`	fn_sig
`...`

returns: json_ctx_t *

eth_estimate_fn¶

uint64_t eth_estimate_fn(in3_t *in3, address_t contract, eth_blknum_t block, char *fn_sig,...);

Returns the result of a function_call.

If result is null, check eth_last_error()! otherwise make sure to free the result after using it with json_free()!

arguments:

in3_t *	in3
address_t	contract
eth_blknum_t	block
`char *`	fn_sig
`...`

returns: uint64_t

eth_getTransactionByHash¶

eth_tx_t* eth_getTransactionByHash(in3_t *in3, bytes32_t tx_hash);

Returns the information about a transaction requested by transaction hash.

If result is null, check eth_last_error()! otherwise make sure to free the result after using it!

arguments:

in3_t *	in3
bytes32_t	tx_hash

returns: eth_tx_t *

eth_getTransactionByBlockHashAndIndex¶

eth_tx_t* eth_getTransactionByBlockHashAndIndex(in3_t *in3, bytes32_t block_hash, size_t index);

Returns the information about a transaction by block hash and transaction index position.

If result is null, check eth_last_error()! otherwise make sure to free the result after using it!

arguments:

in3_t *	in3
bytes32_t	block_hash
`size_t`	index

returns: eth_tx_t *

eth_getTransactionByBlockNumberAndIndex¶

eth_tx_t* eth_getTransactionByBlockNumberAndIndex(in3_t *in3, eth_blknum_t block, size_t index);

Returns the information about a transaction by block number and transaction index position.

If result is null, check eth_last_error()! otherwise make sure to free the result after using it!

arguments:

in3_t *	in3
eth_blknum_t	block
`size_t`	index

returns: eth_tx_t *

eth_getTransactionCount¶

uint64_t eth_getTransactionCount(in3_t *in3, address_t address, eth_blknum_t block);

Returns the number of transactions sent from an address.

arguments:

in3_t *	in3
address_t	address
eth_blknum_t	block

returns: uint64_t

eth_getUncleByBlockNumberAndIndex¶

eth_block_t* eth_getUncleByBlockNumberAndIndex(in3_t *in3, eth_blknum_t block, size_t index);

Returns information about a uncle of a block by number and uncle index position.

If result is null, check eth_last_error()! otherwise make sure to free the result after using it!

arguments:

in3_t *	in3
eth_blknum_t	block
`size_t`	index

returns: eth_block_t *

eth_getUncleCountByBlockHash¶

uint64_t eth_getUncleCountByBlockHash(in3_t *in3, bytes32_t hash);

Returns the number of uncles in a block from a block matching the given block hash.

arguments:

in3_t *	in3
bytes32_t	hash

returns: uint64_t

eth_getUncleCountByBlockNumber¶

uint64_t eth_getUncleCountByBlockNumber(in3_t *in3, eth_blknum_t block);

Returns the number of uncles in a block from a block matching the given block number.

arguments:

in3_t *	in3
eth_blknum_t	block

returns: uint64_t

eth_sendTransaction¶

bytes_t* eth_sendTransaction(in3_t *in3, address_t from, address_t to, OPTIONAL_T(uint64_t) gas, OPTIONAL_T(uint64_t) gas_price, OPTIONAL_T(uint256_t) value, OPTIONAL_T(bytes_t) data, OPTIONAL_T(uint64_t) nonce);

Creates new message call transaction or a contract creation.

Returns (32 Bytes) - the transaction hash, or the zero hash if the transaction is not yet available. Free result after use with b_free().

arguments:

in3_t *	in3
address_t	from
address_t	to
OPTIONAL_T(uint64_t)	gas
OPTIONAL_T(uint64_t)	gas_price
`(,)`	value
`(,)`	data
OPTIONAL_T(uint64_t)	nonce

returns: bytes_t *

eth_sendRawTransaction¶

bytes_t* eth_sendRawTransaction(in3_t *in3, bytes_t data);

Creates new message call transaction or a contract creation for signed transactions.

Returns (32 Bytes) - the transaction hash, or the zero hash if the transaction is not yet available. Free after use with b_free().

arguments:

in3_t *	in3
bytes_t	data

returns: bytes_t *

eth_getTransactionReceipt¶

eth_tx_receipt_t* eth_getTransactionReceipt(in3_t *in3, bytes32_t tx_hash);

Returns the receipt of a transaction by transaction hash.

Free result after use with eth_tx_receipt_free()

arguments:

in3_t *	in3
bytes32_t	tx_hash

returns: eth_tx_receipt_t *

eth_wait_for_receipt¶

char* eth_wait_for_receipt(in3_t *in3, bytes32_t tx_hash);

Waits for receipt of a transaction requested by transaction hash.

arguments:

in3_t *	in3
bytes32_t	tx_hash

returns: char *

eth_last_error¶

char* eth_last_error();

The current error or null if all is ok.

returns: char *

as_double¶

long double as_double(uint256_t d);

Converts a uint256_t in a long double.

Important: since a long double stores max 16 byte, there is no guarantee to have the full precision.

Converts a uint256_t in a long double.

arguments:

uint256_t

d

returns: long double

as_long¶

uint64_t as_long(uint256_t d);

Converts a uint256_t in a long .

Important: since a long double stores 8 byte, this will only use the last 8 byte of the value.

Converts a uint256_t in a long .

arguments:

uint256_t

d

returns: uint64_t

to_uint256¶

uint256_t to_uint256(uint64_t value);

Converts a uint64_t into its uint256_t representation.

arguments:

uint64_t value

returns: uint256_t

decrypt_key¶

in3_ret_t decrypt_key(d_token_t *key_data, char *password, bytes32_t dst);

Decrypts the private key from a json keystore file using PBKDF2 or SCRYPT (if enabled)

arguments:

d_token_t *	key_data
`char *`	password
bytes32_t	dst

returns: in3_ret_t the result-status of the function.

Please make sure you check if it was successfull (==IN3_OK)

log_free¶

void log_free(eth_log_t *log);

Frees a eth_log_t object.

arguments:

eth_log_t *

log

eth_tx_receipt_free¶

void eth_tx_receipt_free(eth_tx_receipt_t *txr);

Frees a eth_tx_receipt_t object.

arguments:

eth_tx_receipt_t *

txr

to_checksum¶

in3_ret_t to_checksum(address_t adr, chain_id_t chain_id, char out[43]);

converts the given address to a checksum address.

If chain_id is passed, it will use the EIP1191 to include it as well.

arguments:

address_t	adr
chain_id_t	chain_id
`char`	out

returns: in3_ret_t the result-status of the function.

Please make sure you check if it was successfull (==IN3_OK)

in3_register_eth_api¶

void in3_register_eth_api();

Module api/usn¶

usn_api.h¶

USN API.

This header-file defines easy to use function, which are verifying USN-Messages.

File: src/api/usn/usn_api.h

usn_booking_handler¶

typedef int(* usn_booking_handler) (usn_event_t *)

returns: int(*

usn_verify_message¶

usn_msg_result_t usn_verify_message(usn_device_conf_t *conf, char *message);

arguments:

usn_device_conf_t *	conf
`char *`	message

returns: usn_msg_result_t

usn_register_device¶

in3_ret_t usn_register_device(usn_device_conf_t *conf, char *url);

arguments:

usn_device_conf_t *	conf
`char *`	url

returns: in3_ret_t the result-status of the function.

Please make sure you check if it was successfull (==IN3_OK)

usn_parse_url¶

usn_url_t usn_parse_url(char *url);

arguments:

char * url

returns: usn_url_t

usn_update_state¶

unsigned int usn_update_state(usn_device_conf_t *conf, unsigned int wait_time);

arguments:

usn_device_conf_t *	conf
`unsigned int`	wait_time

returns: unsigned int

usn_update_bookings¶

in3_ret_t usn_update_bookings(usn_device_conf_t *conf);

arguments:

usn_device_conf_t *

conf

returns: in3_ret_t the result-status of the function.

Please make sure you check if it was successfull (==IN3_OK)

usn_remove_old_bookings¶

void usn_remove_old_bookings(usn_device_conf_t *conf);

arguments:

usn_device_conf_t *

conf

usn_get_next_event¶

usn_event_t usn_get_next_event(usn_device_conf_t *conf);

arguments:

usn_device_conf_t *

conf

returns: usn_event_t

usn_rent¶

in3_ret_t usn_rent(in3_t *c, address_t contract, address_t token, char *url, uint32_t seconds, bytes32_t tx_hash);

arguments:

in3_t *	c
address_t	contract
address_t	token
`char *`	url
`uint32_t`	seconds
bytes32_t	tx_hash

returns: in3_ret_t the result-status of the function.

Please make sure you check if it was successfull (==IN3_OK)

usn_return¶

in3_ret_t usn_return(in3_t *c, address_t contract, char *url, bytes32_t tx_hash);

arguments:

in3_t *	c
address_t	contract
`char *`	url
bytes32_t	tx_hash

returns: in3_ret_t the result-status of the function.

Please make sure you check if it was successfull (==IN3_OK)

usn_price¶

in3_ret_t usn_price(in3_t *c, address_t contract, address_t token, char *url, uint32_t seconds, address_t controller, bytes32_t price);

arguments:

in3_t *	c
address_t	contract
address_t	token
`char *`	url
`uint32_t`	seconds
address_t	controller
bytes32_t	price

returns: in3_ret_t the result-status of the function.

Please make sure you check if it was successfull (==IN3_OK)

Module core¶

client.h¶

this file defines the incubed configuration struct and it registration.

File: src/core/client/client.h

IN3_PROTO_VER¶

the protocol version used when sending requests from the this client

#define IN3_PROTO_VER "2.1.0"

ETH_CHAIN_ID_MULTICHAIN¶

chain_id working with all known chains

#define ETH_CHAIN_ID_MULTICHAIN 0x0

ETH_CHAIN_ID_MAINNET¶

chain_id for mainnet

#define ETH_CHAIN_ID_MAINNET 0x01

ETH_CHAIN_ID_KOVAN¶

chain_id for kovan

#define ETH_CHAIN_ID_KOVAN 0x2a

ETH_CHAIN_ID_TOBALABA¶

chain_id for tobalaba

#define ETH_CHAIN_ID_TOBALABA 0x44d

ETH_CHAIN_ID_GOERLI¶

chain_id for goerlii

#define ETH_CHAIN_ID_GOERLI 0x5

ETH_CHAIN_ID_EVAN¶

chain_id for evan

#define ETH_CHAIN_ID_EVAN 0x4b1

ETH_CHAIN_ID_IPFS¶

chain_id for ipfs

#define ETH_CHAIN_ID_IPFS 0x7d0

ETH_CHAIN_ID_VOLTA¶

chain_id for volta

#define ETH_CHAIN_ID_VOLTA 0x12046

ETH_CHAIN_ID_LOCAL¶

chain_id for local chain

#define ETH_CHAIN_ID_LOCAL 0xFFFF

in3_node_props_init (np)¶

Initializer for in3_node_props_t.

#define in3_node_props_init (np) *(np) = 0

IN3_SIGN_ERR_REJECTED¶

return value used by the signer if the the signature-request was rejected.

#define IN3_SIGN_ERR_REJECTED -1

IN3_SIGN_ERR_ACCOUNT_NOT_FOUND¶

return value used by the signer if the requested account was not found.

#define IN3_SIGN_ERR_ACCOUNT_NOT_FOUND -2

IN3_SIGN_ERR_INVALID_MESSAGE¶

return value used by the signer if the message was invalid.

#define IN3_SIGN_ERR_INVALID_MESSAGE -3

IN3_SIGN_ERR_GENERAL_ERROR¶

return value used by the signer for unspecified errors.

#define IN3_SIGN_ERR_GENERAL_ERROR -4

chain_id_t¶

type for a chain_id.

typedef uint32_t chain_id_t

in3_request_config_t¶

the configuration as part of each incubed request.

This will be generated for each request based on the client-configuration. the verifier may access this during verification in order to check against the request.

The stuct contains following fields:

chain_id_t	chain_id	the chain to be used. this is holding the integer-value of the hexstring.
`uint8_t`	include_code	if true the code needed will always be devlivered.
`uint8_t`	use_full_proof	this flaqg is set, if the proof is set to “PROOF_FULL”
`uint8_t`	use_binary	this flaqg is set, the client should use binary-format
bytes_t *	verified_hashes	a list of blockhashes already verified. The Server will not send any proof for them again .
`uint16_t`	verified_hashes_length	number of verified blockhashes
`uint16_t`	latest_block	the last blocknumber the nodelistz changed
`uint16_t`	finality	number of signatures( in percent) needed in order to reach finality.
in3_verification_t	verification	Verification-type.
bytes_t *	client_signature	the signature of the client with the client key
bytes_t *	signers	the addresses of servers requested to sign the blockhash
`uint8_t`	signers_length	number or addresses
`uint32_t`	time	meassured time in ms for the request

in3_node_props_t¶

Node capabilities.

typedef uint64_t in3_node_props_t

in3_node_t¶

incubed node-configuration.

These information are read from the Registry contract and stored in this struct representing a server or node.

The stuct contains following fields:

bytes_t *	address	address of the server
`uint64_t`	deposit	the deposit stored in the registry contract, which this would lose if it sends a wrong blockhash
`uint32_t`	index	index within the nodelist, also used in the contract as key
`uint32_t`	capacity	the maximal capacity able to handle
in3_node_props_t	props	used to identify the capabilities of the node. See in3_node_props_type_t in nodelist.h
`char *`	url	the url of the node
`bool`	whitelisted	boolean indicating if node exists in whiteList

in3_node_weight_t¶

Weight or reputation of a node.

Based on the past performance of the node a weight is calculated given faster nodes a higher weight and chance when selecting the next node from the nodelist. These weights will also be stored in the cache (if available)

The stuct contains following fields:

uint32_t response_count counter for responses

uint32_t total_response_time total of all response times

uint64_t

blacklisted_until

if >0 this node is blacklisted until k.

k is a unix timestamp

in3_whitelist_t¶

defines a whitelist structure used for the nodelist.

The stuct contains following fields:

address_t	contract	address of whiteList contract. If specified, whiteList is always auto-updated and manual whiteList is overridden
bytes_t	addresses	serialized list of node addresses that constitute the whiteList
`uint64_t`	last_block	last blocknumber the whiteList was updated, which is used to detect changed in the whitelist
`bool`	needs_update	if true the nodelist should be updated and will trigger a in3_nodeList-request before the next request is send.

in3_verified_hash_t¶

represents a blockhash which was previously verified

The stuct contains following fields:

`uint64_t`	block_number	the number of the block
bytes32_t	hash	the blockhash

in3_chain_t¶

Chain definition inside incubed.

for incubed a chain can be any distributed network or database with incubed support.

The stuct contains following fields:

chain_id_t	chain_id	chain_id, which could be a free or based on the public ethereum networkId
in3_chain_type_t	type	chaintype
`uint64_t`	last_block	last blocknumber the nodeList was updated, which is used to detect changed in the nodelist
`int`	nodelist_length	number of nodes in the nodeList
in3_node_t *	nodelist	array of nodes
in3_node_weight_t *	weights	stats and weights recorded for each node
bytes_t **	init_addresses	array of addresses of nodes that should always part of the nodeList
bytes_t *	contract	the address of the registry contract
bytes32_t	registry_id	the identifier of the registry
`uint8_t`	version	version of the chain
in3_verified_hash_t *	verified_hashes	contains the list of already verified blockhashes
in3_whitelist_t *	whitelist	if set the whitelist of the addresses.
address_t	node	node that reported the last_block which necessitated a nodeList update
`uint64_t`	exp_last_block	the last_block when the nodelist last changed reported by this node
`struct in3_chain::@2 *`	nodelist_upd8_params

in3_storage_get_item¶

storage handler function for reading from cache.

typedef bytes_t*(* in3_storage_get_item) (void *cptr, char *key)

returns: bytes_t *(* : the found result. if the key is found this function should return the values as bytes otherwise NULL.

in3_storage_set_item¶

storage handler function for writing to the cache.

typedef void(* in3_storage_set_item) (void *cptr, char *key, bytes_t *value)

in3_storage_clear¶

storage handler function for clearing the cache.

typedef void(* in3_storage_clear) (void *cptr)

in3_storage_handler_t¶

storage handler to handle cache.

The stuct contains following fields:

in3_storage_get_item	get_item	function pointer returning a stored value for the given key.
in3_storage_set_item	set_item	function pointer setting a stored value for the given key.
in3_storage_clear	clear	function pointer clearing all contents of cache.
`void *`	cptr	custom pointer which will be passed to functions

in3_sign¶

signing function.

signs the given data and write the signature to dst. the return value must be the number of bytes written to dst. In case of an error a negativ value must be returned. It should be one of the IN3_SIGN_ERR… values.

typedef in3_ret_t(* in3_sign) (void *ctx, d_signature_type_t type, bytes_t message, bytes_t account, uint8_t *dst)

returns: in3_ret_t(* the result-status of the function.

Please make sure you check if it was successfull (==IN3_OK)

in3_prepare_tx¶

transform transaction function.

for multisigs, we need to change the transaction to gro through the ms. if the new_tx is not set within the function, it will use the old_tx.

typedef in3_ret_t(* in3_prepare_tx) (void *ctx, d_token_t *old_tx, json_ctx_t **new_tx)

returns: in3_ret_t(* the result-status of the function.

Please make sure you check if it was successfull (==IN3_OK)

in3_signer_t¶

The stuct contains following fields:

in3_sign	sign
in3_prepare_tx	prepare_tx
`void *`	wallet

in3_response_t¶

response-object.

if the error has a length>0 the response will be rejected

The stuct contains following fields:

sb_t	error	a stringbuilder to add any errors!
sb_t	result	a stringbuilder to add the result

in3_request_t¶

request-object.

represents a RPC-request

The stuct contains following fields:

`char *`	payload	the payload to send
`char **`	urls	array of urls
`int`	urls_len	number of urls
in3_response_t *	results	the responses
`uint32_t`	timeout	the timeout 0= no timeout
`uint32_t *`	times	measured times (in ms) which will be used for ajusting the weights

in3_transport_send¶

the transport function to be implemented by the transport provider.

typedef in3_ret_t(* in3_transport_send) (in3_request_t *request)

returns: in3_ret_t(* the result-status of the function.

Please make sure you check if it was successfull (==IN3_OK)

in3_filter_t¶

The stuct contains following fields:

in3_filter_type_t	type	filter type: (event, block or pending)
`char *`	options	associated filter options
`uint64_t`	last_block	block no. when filter was created OR eth_getFilterChanges was called
`bool`	is_first_usage	if true the filter was not used previously
`void(*`	release	method to release owned resources

in3_filter_handler_t¶

Handler which is added to client config in order to handle filter.

The stuct contains following fields:

in3_filter_t **	array
`size_t`	count	array of filters

in3_t¶

Incubed Configuration.

This struct holds the configuration and also point to internal resources such as filters or chain configs.

The stuct contains following fields:

`uint32_t`	cache_timeout	number of seconds requests can be cached.
`uint16_t`	node_limit	the limit of nodes to store in the client.
bytes_t *	key	the client key to sign requests
`uint32_t`	max_code_cache	number of max bytes used to cache the code in memory
`uint32_t`	max_block_cache	number of number of blocks cached in memory
in3_proof_t	proof	the type of proof used
`uint8_t`	request_count	the number of request send when getting a first answer
`uint8_t`	signature_count	the number of signatures used to proof the blockhash.
`uint64_t`	min_deposit	min stake of the server. Only nodes owning at least this amount will be chosen.
`uint16_t`	replace_latest_block	if specified, the blocknumber latest will be replaced by blockNumber- specified value
`uint16_t`	finality	the number of signatures in percent required for the request
`uint_fast16_t`	max_attempts	the max number of attempts before giving up
`uint_fast16_t`	max_verified_hashes	max number of verified hashes to cache
`uint32_t`	timeout	specifies the number of milliseconds before the request times out. increasing may be helpful if the device uses a slow connection.
chain_id_t	chain_id	servers to filter for the given chain. The chain-id based on EIP-155.
`uint8_t`	auto_update_list	if true the nodelist will be automaticly updated if the last_block is newer
in3_storage_handler_t *	cache	a cache handler offering 2 functions ( setItem(string,string), getItem(string) )
in3_signer_t *	signer	signer-struct managing a wallet
in3_transport_send	transport	the transporthandler sending requests
`uint8_t`	include_code	includes the code when sending eth_call-requests
`uint8_t`	use_binary	if true the client will use binary format
`uint8_t`	use_http	if true the client will try to use http instead of https
`uint8_t`	keep_in3	if true the in3-section with the proof will also returned
in3_chain_t *	chains	chain spec and nodeList definitions
`uint16_t`	chains_length	number of configured chains
in3_filter_handler_t *	filters	filter handler
in3_node_props_t	node_props	used to identify the capabilities of the node.

in3_node_props_set¶

void in3_node_props_set(in3_node_props_t *node_props, in3_node_props_type_t type, uint8_t value);

setter method for interacting with in3_node_props_t.

arguments:

in3_node_props_t *	node_props
`in3_node_props_type_t`	type
`uint8_t`	value

in3_node_props_get¶

static uint32_t in3_node_props_get(in3_node_props_t np, in3_node_props_type_t t);

returns the value of the specified propertytype.

arguments:

in3_node_props_t	np
`in3_node_props_type_t`	t

returns: uint32_t : value as a number

in3_node_props_matches¶

static bool in3_node_props_matches(in3_node_props_t np, in3_node_props_type_t t);

checkes if the given type is set in the properties

arguments:

in3_node_props_t	np
`in3_node_props_type_t`	t

returns: bool : true if set

in3_new¶

in3_t* in3_new() __attribute__((deprecated("use in3_for_chain(ETH_CHAIN_ID_MULTICHAIN)")));

creates a new Incubes configuration and returns the pointer.

This Method is depricated. you should use in3_for_chain(ETH_CHAIN_ID_MULTICHAIN) instead.

you need to free this instance with in3_free after use!

Before using the client you still need to set the tramsport and optional the storage handlers:

example of initialization:

// register verifiers
in3_register_eth_full();

// create new client
in3_t* client = in3_new();

// configure storage...
in3_storage_handler_t storage_handler;
storage_handler.get_item = storage_get_item;
storage_handler.set_item = storage_set_item;
storage_handler.clear = storage_clear;

// configure transport
client->transport    = send_curl;

// configure storage
client->cache = &storage_handler;

// init cache
in3_cache_init(client);

// ready to use ...

returns: in3_t * : the incubed instance.

in3_for_chain¶

in3_t* in3_for_chain(chain_id_t chain_id);

creates a new Incubes configuration for a specified chain and returns the pointer.

when creating the client only the one chain will be configured. (saves memory). but if you pass ETH_CHAIN_ID_MULTICHAIN as argument all known chains will be configured allowing you to switch between chains within the same client or configuring your own chain.

you need to free this instance with in3_free after use!

Before using the client you still need to set the tramsport and optional the storage handlers:

example of initialization: , ** This Method is depricated. you should use in3_for_chain instead.**

// register verifiers
in3_register_eth_full();

// create new client
in3_t* client = in3_for_chain(ETH_CHAIN_ID_MAINNET);

// configure storage...
in3_storage_handler_t storage_handler;
storage_handler.get_item = storage_get_item;
storage_handler.set_item = storage_set_item;
storage_handler.clear = storage_clear;

// configure transport
client->transport    = send_curl;

// configure storage
client->cache = &storage_handler;

// init cache
in3_cache_init(client);

// ready to use ...

arguments:

chain_id_t

chain_id

the chain_id (see ETH_CHAIN_ID_… constants).

returns: in3_t * : the incubed instance.

in3_client_rpc¶

in3_ret_t in3_client_rpc(in3_t *c, char *method, char *params, char **result, char **error);

sends a request and stores the result in the provided buffer

arguments:

in3_t *	c	the pointer to the incubed client config.
`char *`	method	the name of the rpc-funcgtion to call.
`char *`	params	docs for input parameter v.
`char **`	result	pointer to string which will be set if the request was successfull. This will hold the result as json-rpc-string. (make sure you free this after use!)
`char **`	error	pointer to a string containg the error-message. (make sure you free it after use!)

returns: in3_ret_t the result-status of the function.

Please make sure you check if it was successfull (==IN3_OK)

in3_client_exec_req¶

char* in3_client_exec_req(in3_t *c, char *req);

executes a request and returns result as string.

in case of an error, the error-property of the result will be set. The resulting string must be free by the the caller of this function!

arguments:

in3_t *	c	the pointer to the incubed client config.
`char *`	req	the request as rpc.

returns: char *

in3_req_add_response¶

void in3_req_add_response(in3_response_t *res, int index, bool is_error, void *data, int data_len);

adds a response for a request-object.

This function should be used in the transport-function to set the response.

arguments:

in3_response_t *	res	the response-pointer
`int`	index	the index of the url, since this request could go out to many urls
`bool`	is_error	if true this will be reported as error. the message should then be the error-message
`void *`	data	the data or the the string
`int`	data_len	the length of the data or the the string (use -1 if data is a null terminated string)

in3_client_register_chain¶

in3_ret_t in3_client_register_chain(in3_t *client, chain_id_t chain_id, in3_chain_type_t type, address_t contract, bytes32_t registry_id, uint8_t version, address_t wl_contract);

registers a new chain or replaces a existing (but keeps the nodelist)

arguments:

in3_t *	client	the pointer to the incubed client config.
chain_id_t	chain_id	the chain id.
in3_chain_type_t	type	the verification type of the chain.
address_t	contract	contract of the registry.
bytes32_t	registry_id	the identifier of the registry.
`uint8_t`	version	the chain version.
address_t	wl_contract	contract of whiteList.

returns: in3_ret_t the result-status of the function.

Please make sure you check if it was successfull (==IN3_OK)

in3_client_add_node¶

in3_ret_t in3_client_add_node(in3_t *client, chain_id_t chain_id, char *url, in3_node_props_t props, address_t address);

adds a node to a chain ore updates a existing node

[in] public address of the signer.

arguments:

in3_t *	client	the pointer to the incubed client config.
chain_id_t	chain_id	the chain id.
`char *`	url	url of the nodes.
in3_node_props_t	props	properties of the node.
address_t	address

returns: in3_ret_t the result-status of the function.

Please make sure you check if it was successfull (==IN3_OK)

in3_client_remove_node¶

in3_ret_t in3_client_remove_node(in3_t *client, chain_id_t chain_id, address_t address);

removes a node from a nodelist

[in] public address of the signer.

arguments:

in3_t *	client	the pointer to the incubed client config.
chain_id_t	chain_id	the chain id.
address_t	address

returns: in3_ret_t the result-status of the function.

Please make sure you check if it was successfull (==IN3_OK)

in3_client_clear_nodes¶

in3_ret_t in3_client_clear_nodes(in3_t *client, chain_id_t chain_id);

removes all nodes from the nodelist

[in] the chain id.

arguments:

in3_t *	client	the pointer to the incubed client config.
chain_id_t	chain_id

returns: in3_ret_t the result-status of the function.

Please make sure you check if it was successfull (==IN3_OK)

in3_free¶

void in3_free(in3_t *a);

frees the references of the client

arguments:

a

the pointer to the incubed client config to free.

in3_cache_init¶

in3_ret_t in3_cache_init(in3_t *c);

inits the cache.

this will try to read the nodelist from cache.

arguments:

c

the incubed client

returns: in3_ret_t the result-status of the function.

Please make sure you check if it was successfull (==IN3_OK)

in3_find_chain¶

in3_chain_t* in3_find_chain(in3_t *c, chain_id_t chain_id);

finds the chain-config for the given chain_id.

My return NULL if not found.

arguments:

in3_t *	c	the incubed client
chain_id_t	chain_id	chain_id

returns: in3_chain_t *

in3_configure¶

char* in3_configure(in3_t *c, const char *config);

configures the clent based on a json-config.

For details about the structure of ther config see https://in3.readthedocs.io/en/develop/api-ts.html#type-in3config

arguments:

in3_t *	c	the incubed client
`const char *`	config	JSON-string with the configuration to set.

returns: char *

in3_set_default_transport¶

void in3_set_default_transport(in3_transport_send transport);

defines a default transport which is used when creating a new client.

arguments:

in3_transport_send

transport

the default transport-function.

in3_set_default_storage¶

void in3_set_default_storage(in3_storage_handler_t *cacheStorage);

defines a default storage handler which is used when creating a new client.

arguments:

in3_storage_handler_t *

cacheStorage

pointer to the handler-struct

in3_set_default_signer¶

void in3_set_default_signer(in3_signer_t *signer);

defines a default signer which is used when creating a new client.

arguments:

in3_signer_t *

signer

default signer-function.

in3_create_signer¶

in3_signer_t* in3_create_signer(in3_sign sign, in3_prepare_tx prepare_tx, void *wallet);

create a new signer-object to be set on the client.

the caller will need to free this pointer after usage.

arguments:

in3_sign	sign	function pointer returning a stored value for the given key.
in3_prepare_tx	prepare_tx	function pointer returning capable of manipulating the transaction before signing it. This is needed in order to support multisigs.
`void *`	wallet	custom object whill will be passed to functions

returns: in3_signer_t *

in3_create_storage_handler¶

in3_storage_handler_t* in3_create_storage_handler(in3_storage_get_item get_item, in3_storage_set_item set_item, in3_storage_clear clear, void *cptr);

create a new storage handler-object to be set on the client.

the caller will need to free this pointer after usage.

arguments:

in3_storage_get_item	get_item	function pointer returning a stored value for the given key.
in3_storage_set_item	set_item	function pointer setting a stored value for the given key.
in3_storage_clear	clear	function pointer clearing all contents of cache.
`void *`	cptr	custom pointer which will will be passed to functions

returns: in3_storage_handler_t *

context.h¶

Request Context. This is used for each request holding request and response-pointers but also controls the execution process.

File: src/core/client/context.h

ctx_set_error (c,msg,err)¶

#define ctx_set_error (c,msg,err) ctx_set_error_intern(c, NULL, err)

ctx_type_t¶

type of the request context,

The enum type contains the following values:

CT_RPC	0	a json-rpc request, which needs to be send to a incubed node
CT_SIGN	1	a sign request

node_match_t¶

the weight of a certain node as linked list.

This will be used when picking the nodes to send the request to. A linked list of these structs desribe the result.

The stuct contains following fields:

in3_node_t *	node	the node definition including the url
in3_node_weight_t *	weight	the current weight and blacklisting-stats
`float`	s	The starting value.
`float`	w	weight value
weightstruct , *	next	next in the linkedlist or NULL if this is the last element

in3_ctx_t¶

The Request config.

This is generated for each request and represents the current state. it holds the state until the request is finished and must be freed afterwards.

The stuct contains following fields:

ctx_type_t	type	the type of the request
in3_t *	client	reference to the client
json_ctx_t *	request_context	the result of the json-parser for the request.
json_ctx_t *	response_context	the result of the json-parser for the response.
`char *`	error	in case of an error this will hold the message, if not it points to NULL
`int`	len	the number of requests
`unsigned int`	attempt	the number of attempts
d_token_t **	responses	references to the tokens representring the parsed responses
d_token_t **	requests	references to the tokens representring the requests
in3_request_config_t *	requests_configs	array of configs adjusted for each request.
node_match_t *	nodes
cache_entry_t *	cache	optional cache-entries. These entries will be freed when cleaning up the context.
in3_response_t *	raw_response	the raw response-data, which should be verified.
in3_ctxstruct , *	required	pointer to the next required context. if not NULL the data from this context need get finished first, before being able to resume this context.
in3_ret_t	verification_state	state of the verification

in3_ctx_state_t¶

The current state of the context.

you can check this state after each execute-call.

The enum type contains the following values:

CTX_SUCCESS	0	The ctx has a verified result.
CTX_WAITING_FOR_REQUIRED_CTX	1	there are required contexts, which need to be resolved first
CTX_WAITING_FOR_RESPONSE	2	the response is not set yet
CTX_ERROR	-1	the request has a error

ctx_new¶

in3_ctx_t* ctx_new(in3_t *client, char *req_data);

creates a new context.

the request data will be parsed and represented in the context. calling this function will only parse the request data, but not send anything yet.

Important: the req_data will not be cloned but used during the execution. The caller of the this function is also responsible for freeing this string afterwards.

arguments:

in3_t *	client	the client-config.
`char *`	req_data	the rpc-request as json string.

returns: in3_ctx_t *

in3_send_ctx¶

in3_ret_t in3_send_ctx(in3_ctx_t *ctx);

sends a previously created context to nodes and verifies it.

The execution happens within the same thread, thich mean it will be blocked until the response ha beedn received and verified. In order to handle calls asynchronously, you need to call the in3_ctx_execute function and provide the data as needed.

arguments:

ctx

the request context.

returns: in3_ret_t the result-status of the function.

Please make sure you check if it was successfull (==IN3_OK)

in3_ctx_execute¶

in3_ret_t in3_ctx_execute(in3_ctx_t *ctx);

tries to execute the context, but stops whenever data are required.

This function should be used in order to call data in a asyncronous way, since this function will not use the transport-function to actually send it.

The caller is responsible for delivering the required responses. After calling you need to check the return-value:

IN3_WAITING : provide the required data and then call in3_ctx_execute again.
IN3_OK : success, we have a result.
any other status = error

Here is a example how to use this function:

 in3_ret_t in3_send_ctx(in3_ctx_t* ctx) {
  in3_ret_t ret;
  // execute the context and store the return value.
  // if the return value is 0 == IN3_OK, it was successful and we return,
  // if not, we keep on executing
  while ((ret = in3_ctx_execute(ctx))) {
    // error we stop here, because this means we got an error
    if (ret != IN3_WAITING) return ret;

    // handle subcontexts first, if they have not been finished
    while (ctx->required && in3_ctx_state(ctx->required) != CTX_SUCCESS) {
      // exxecute them, and return the status if still waiting or error
      if ((ret = in3_send_ctx(ctx->required))) return ret;

      // recheck in order to prepare the request.
      // if it is not waiting, then it we cannot do much, becaus it will an error or successfull.
      if ((ret = in3_ctx_execute(ctx)) != IN3_WAITING) return ret;
    }

    // only if there is no response yet...
    if (!ctx->raw_response) {

      // what kind of request do we need to provide?
      switch (ctx->type) {

        // RPC-request to send to the nodes
        case CT_RPC: {

            // build the request
            in3_request_t* request = in3_create_request(ctx);

            // here we use the transport, but you can also try to fetch the data in any other way.
            ctx->client->transport(request);

            // clean up
            request_free(request, ctx, false);
            break;
        }

        // this is a request to sign a transaction
        case CT_SIGN: {
            // read the data to sign from the request
            d_token_t* params = d_get(ctx->requests[0], K_PARAMS);
            // the data to sign
            bytes_t    data   = d_to_bytes(d_get_at(params, 0));
            // the account to sign with
            bytes_t    from   = d_to_bytes(d_get_at(params, 1));

            // prepare the response
            ctx->raw_response = _malloc(sizeof(in3_response_t));
            sb_init(&ctx->raw_response[0].error);
            sb_init(&ctx->raw_response[0].result);

            // data for the signature 
            uint8_t sig[65];
            // use the signer to create the signature
            ret = ctx->client->signer->sign(ctx, SIGN_EC_HASH, data, from, sig);
            // if it fails we report this as error
            if (ret < 0) return ctx_set_error(ctx, ctx->raw_response->error.data, ret);
            // otherwise we simply add the raw 65 bytes to the response.
            sb_add_range(&ctx->raw_response->result, (char*) sig, 0, 65);
        }
      }
    }
  }
  // done...
  return ret;
}

arguments:

ctx

the request context.

returns: in3_ret_t the result-status of the function.

Please make sure you check if it was successfull (==IN3_OK)

in3_ctx_state¶

in3_ctx_state_t in3_ctx_state(in3_ctx_t *ctx);

returns the current state of the context.

arguments:

ctx

the request context.

returns: in3_ctx_state_t

in3_create_request¶

in3_request_t* in3_create_request(in3_ctx_t *ctx);

creates a request-object, which then need to be filled with the responses.

each request object contains a array of reponse-objects. In order to set the response, you need to call

// set a succesfull response
sb_add_chars(&request->results[0].result, my_response);
// set a error response
sb_add_chars(&request->results[0].error, my_error);

arguments:

ctx

the request context.

returns: in3_request_t *

request_free¶

void request_free(in3_request_t *req, const in3_ctx_t *ctx, bool response_free);

frees a previuosly allocated request.

arguments:

in3_request_t *	req	the request.
in3_ctx_tconst , *	ctx	the request context.
`bool`	response_free	if true the responses will freed also, but usually this is done when the ctx is freed.

ctx_free¶

void ctx_free(in3_ctx_t *ctx);

frees all resources allocated during the request.

But this will not free the request string passed when creating the context!

arguments:

ctx

the request context.

ctx_add_required¶

in3_ret_t ctx_add_required(in3_ctx_t *parent, in3_ctx_t *ctx);

adds a new context as a requirment.

Whenever a verifier needs more data and wants to send a request, we should create the request and add it as dependency and stop.

If the function is called again, we need to search and see if the required status is now useable.

Here is an example of how to use it:

in3_ret_t get_from_nodes(in3_ctx_t* parent, char* method, char* params, bytes_t* dst) {
  // check if the method is already existing
  in3_ctx_t* ctx = ctx_find_required(parent, method);
  if (ctx) {
    // found one - so we check if it is useable.
    switch (in3_ctx_state(ctx)) {
      // in case of an error, we report it back to the parent context
      case CTX_ERROR:
        return ctx_set_error(parent, ctx->error, IN3_EUNKNOWN);
      // if we are still waiting, we stop here and report it.
      case CTX_WAITING_FOR_REQUIRED_CTX:
      case CTX_WAITING_FOR_RESPONSE:
        return IN3_WAITING;

      // if it is useable, we can now handle the result.
      case CTX_SUCCESS: {
        d_token_t* r = d_get(ctx->responses[0], K_RESULT);
        if (r) {
          // we have a result, so write it back to the dst
          *dst = d_to_bytes(r);
          return IN3_OK;
        } else
          // or check the error and report it
          return ctx_check_response_error(parent, 0);
      }
    }
  }

  // no required context found yet, so we create one:

  // since this is a subrequest it will be freed when the parent is freed.
  // allocate memory for the request-string
  char* req = _malloc(strlen(method) + strlen(params) + 200);
  // create it
  sprintf(req, "{\"method\":\"%s\",\"jsonrpc\":\"2.0\",\"id\":1,\"params\":%s}", method, params);
  // and add the request context to the parent.
  return ctx_add_required(parent, ctx_new(parent->client, req));
}

arguments:

in3_ctx_t *	parent	the current request context.
in3_ctx_t *	ctx	the new request context to add.

returns: in3_ret_t the result-status of the function.

Please make sure you check if it was successfull (==IN3_OK)

ctx_find_required¶

in3_ctx_t* ctx_find_required(const in3_ctx_t *parent, const char *method);

searches within the required request contextes for one with the given method.

This method is used internaly to find a previously added context.

arguments:

in3_ctx_tconst , *	parent	the current request context.
`const char *`	method	the method of the rpc-request.

returns: in3_ctx_t *

ctx_remove_required¶

in3_ret_t ctx_remove_required(in3_ctx_t *parent, in3_ctx_t *ctx);

removes a required context after usage.

removing will also call free_ctx to free resources.

arguments:

in3_ctx_t *	parent	the current request context.
in3_ctx_t *	ctx	the request context to remove.

returns: in3_ret_t the result-status of the function.

Please make sure you check if it was successfull (==IN3_OK)

ctx_check_response_error¶

in3_ret_t ctx_check_response_error(in3_ctx_t *c, int i);

check if the response contains a error-property and reports this as error in the context.

arguments:

in3_ctx_t *	c	the current request context.
`int`	i	the index of the request to check (if this is a batch-request, otherwise 0).

returns: in3_ret_t the result-status of the function.

Please make sure you check if it was successfull (==IN3_OK)

ctx_set_error_intern¶

in3_ret_t ctx_set_error_intern(in3_ctx_t *c, char *msg, in3_ret_t errnumber);

sets the error message in the context.

If there is a previous error it will append it. the return value will simply be passed so you can use it like

return ctx_set_error(ctx, "wrong number of arguments", IN3_EINVAL)

arguments:

in3_ctx_t *	c	the current request context.
`char *`	msg	the error message. (This string will be copied)
in3_ret_t	errnumber	the error code to return

returns: in3_ret_t the result-status of the function.

Please make sure you check if it was successfull (==IN3_OK)

ctx_get_error¶

in3_ret_t ctx_get_error(in3_ctx_t *ctx, int id);

determins the errorcode for the given request.

arguments:

in3_ctx_t *	ctx	the current request context.
`int`	id	the index of the request to check (if this is a batch-request, otherwise 0).

returns: in3_ret_t the result-status of the function.

Please make sure you check if it was successfull (==IN3_OK)

in3_client_rpc_ctx¶

in3_ctx_t* in3_client_rpc_ctx(in3_t *c, char *method, char *params);

sends a request and returns a context used to access the result or errors.

This context MUST be freed with ctx_free(ctx) after usage to release the resources.

arguments:

in3_t *	c	the clientt config.
`char *`	method	rpc method.
`char *`	params	params as string.

returns: in3_ctx_t *

verifier.h¶

Verification Context. This context is passed to the verifier.

File: src/core/client/verifier.h

vc_err (vc,msg)¶

#define vc_err (vc,msg) vc_set_error(vc, NULL)

in3_verify¶

function to verify the result.

typedef in3_ret_t(* in3_verify) (in3_vctx_t *c)

returns: in3_ret_t(* the result-status of the function.

Please make sure you check if it was successfull (==IN3_OK)

in3_pre_handle¶

function which is called to fill the response before a request is triggered.

This can be used to handle requests which don’t need a node to response.

typedef in3_ret_t(* in3_pre_handle) (in3_ctx_t *ctx, in3_response_t **response)

returns: in3_ret_t(* the result-status of the function.

Please make sure you check if it was successfull (==IN3_OK)

in3_verifier_t¶

The stuct contains following fields:

in3_verify	verify
in3_pre_handle	pre_handle
in3_chain_type_t	type
verifierstruct , *	next

in3_get_verifier¶

in3_verifier_t* in3_get_verifier(in3_chain_type_t type);

returns the verifier for the given chainType

arguments:

in3_chain_type_t

type

returns: in3_verifier_t *

in3_register_verifier¶

void in3_register_verifier(in3_verifier_t *verifier);

arguments:

in3_verifier_t *

verifier

vc_set_error¶

in3_ret_t vc_set_error(in3_vctx_t *vc, char *msg);

arguments:

in3_vctx_t *	vc
`char *`	msg

returns: in3_ret_t the result-status of the function.

Please make sure you check if it was successfull (==IN3_OK)

bytes.h¶

util helper on byte arrays.

File: src/core/util/bytes.h

bb_new ()¶

creates a new bytes_builder with a initial size of 32 bytes

#define bb_new () bb_newl(32)

bb_read (bb,i,vptr)¶

#define bb_read (_bb_,_i_,_vptr_) bb_readl((_bb_), (_i_), (_vptr_), sizeof(*_vptr_))

bb_read_next (bb,iptr,vptr)¶

#define bb_read_next (_bb_,_iptr_,_vptr_) do {                                          \
    size_t _l_ = sizeof(*_vptr_);               \
    bb_readl((_bb_), *(_iptr_), (_vptr_), _l_); \
    *(_iptr_) += _l_;                           \
  } while (0)

bb_readl (bb,i,vptr,l)¶

#define bb_readl (_bb_,_i_,_vptr_,_l_) memcpy((_vptr_), (_bb_)->b.data + (_i_), _l_)

b_read (b,i,vptr)¶

#define b_read (_b_,_i_,_vptr_) b_readl((_b_), (_i_), _vptr_, sizeof(*_vptr_))

b_readl (b,i,vptr,l)¶

#define b_readl (_b_,_i_,_vptr_,_l_) memcpy(_vptr_, (_b_)->data + (_i_), (_l_))

address_t¶

pointer to a 20byte address

typedef uint8_t address_t[20]

bytes32_t¶

pointer to a 32byte word

typedef uint8_t bytes32_t[32]

wlen_t¶

number of bytes within a word (min 1byte but usually a uint)

typedef uint_fast8_t wlen_t

bytes_t¶

a byte array

The stuct contains following fields:

`uint8_t *`	data	the byte-data
`uint32_t`	len	the length of the array ion bytes

b_new¶

bytes_t* b_new(const char *data, int len);

allocates a new byte array with 0 filled

arguments:

`const char *`	data
`int`	len

returns: bytes_t *

b_print¶

void b_print(const bytes_t *a);

prints a the bytes as hex to stdout

arguments:

a

ba_print¶

void ba_print(const uint8_t *a, size_t l);

prints a the bytes as hex to stdout

arguments:

`const uint8_t *`	a
`size_t`	l

b_cmp¶

int b_cmp(const bytes_t *a, const bytes_t *b);

compares 2 byte arrays and returns 1 for equal and 0 for not equal

arguments:

bytes_tconst , *	a
bytes_tconst , *	b

returns: int

bytes_cmp¶

int bytes_cmp(const bytes_t a, const bytes_t b);

compares 2 byte arrays and returns 1 for equal and 0 for not equal

arguments:

bytes_tconst	a
bytes_tconst	b

returns: int

b_free¶

void b_free(bytes_t *a);

frees the data

arguments:

bytes_t *

a

b_dup¶

bytes_t* b_dup(const bytes_t *a);

clones a byte array

arguments:

a

returns: bytes_t *

b_read_byte¶

uint8_t b_read_byte(bytes_t *b, size_t *pos);

reads a byte on the current position and updates the pos afterwards.

arguments:

bytes_t *	b
`size_t *`	pos

returns: uint8_t

b_read_int¶

uint32_t b_read_int(bytes_t *b, size_t *pos);

reads a integer on the current position and updates the pos afterwards.

arguments:

bytes_t *	b
`size_t *`	pos

returns: uint32_t

b_read_long¶

uint64_t b_read_long(bytes_t *b, size_t *pos);

reads a long on the current position and updates the pos afterwards.

arguments:

bytes_t *	b
`size_t *`	pos

returns: uint64_t

b_new_chars¶

char* b_new_chars(bytes_t *b, size_t *pos);

creates a new string (needs to be freed) on the current position and updates the pos afterwards.

arguments:

bytes_t *	b
`size_t *`	pos

returns: char *

b_new_fixed_bytes¶

bytes_t* b_new_fixed_bytes(bytes_t *b, size_t *pos, int len);

reads bytes with a fixed length on the current position and updates the pos afterwards.

arguments:

bytes_t *	b
`size_t *`	pos
`int`	len

returns: bytes_t *

bb_newl¶

bytes_builder_t* bb_newl(size_t l);

creates a new bytes_builder

arguments:

size_t l

returns: bytes_builder_t *

bb_free¶

void bb_free(bytes_builder_t *bb);

frees a bytebuilder and its content.

arguments:

bb

bb_check_size¶

int bb_check_size(bytes_builder_t *bb, size_t len);

internal helper to increase the buffer if needed

arguments:

bytes_builder_t *	bb
`size_t`	len

returns: int

bb_write_chars¶

void bb_write_chars(bytes_builder_t *bb, char *c, int len);

writes a string to the builder.

arguments:

bytes_builder_t *	bb
`char *`	c
`int`	len

bb_write_dyn_bytes¶

void bb_write_dyn_bytes(bytes_builder_t *bb, const bytes_t *src);

writes bytes to the builder with a prefixed length.

arguments:

bytes_builder_t *	bb
bytes_tconst , *	src

bb_write_fixed_bytes¶

void bb_write_fixed_bytes(bytes_builder_t *bb, const bytes_t *src);

writes fixed bytes to the builder.

arguments:

bytes_builder_t *	bb
bytes_tconst , *	src

bb_write_int¶

void bb_write_int(bytes_builder_t *bb, uint32_t val);

writes a ineteger to the builder.

arguments:

bytes_builder_t *	bb
`uint32_t`	val

bb_write_long¶

void bb_write_long(bytes_builder_t *bb, uint64_t val);

writes s long to the builder.

arguments:

bytes_builder_t *	bb
`uint64_t`	val

bb_write_long_be¶

void bb_write_long_be(bytes_builder_t *bb, uint64_t val, int len);

writes any integer value with the given length of bytes

arguments:

bytes_builder_t *	bb
`uint64_t`	val
`int`	len

bb_write_byte¶

void bb_write_byte(bytes_builder_t *bb, uint8_t val);

writes a single byte to the builder.

arguments:

bytes_builder_t *	bb
`uint8_t`	val

bb_write_raw_bytes¶

void bb_write_raw_bytes(bytes_builder_t *bb, void *ptr, size_t len);

writes the bytes to the builder.

arguments:

bytes_builder_t *	bb
`void *`	ptr
`size_t`	len

bb_clear¶

void bb_clear(bytes_builder_t *bb);

resets the content of the builder.

arguments:

bb

bb_replace¶

void bb_replace(bytes_builder_t *bb, int offset, int delete_len, uint8_t *data, int data_len);

replaces or deletes a part of the content.

arguments:

bytes_builder_t *	bb
`int`	offset
`int`	delete_len
`uint8_t *`	data
`int`	data_len

bb_move_to_bytes¶

bytes_t* bb_move_to_bytes(bytes_builder_t *bb);

frees the builder and moves the content in a newly created bytes struct (which needs to be freed later).

arguments:

bb

returns: bytes_t *

bb_read_long¶

uint64_t bb_read_long(bytes_builder_t *bb, size_t *i);

reads a long from the builder

arguments:

bytes_builder_t *	bb
`size_t *`	i

returns: uint64_t

bb_read_int¶

uint32_t bb_read_int(bytes_builder_t *bb, size_t *i);

reads a int from the builder

arguments:

bytes_builder_t *	bb
`size_t *`	i

returns: uint32_t

bytes¶

static bytes_t bytes(uint8_t *a, uint32_t len);

converts the given bytes to a bytes struct

arguments:

`uint8_t *`	a
`uint32_t`	len

returns: bytes_t

cloned_bytes¶

bytes_t cloned_bytes(bytes_t data);

cloned the passed data

arguments:

bytes_t

data

returns: bytes_t

b_optimize_len¶

static void b_optimize_len(bytes_t *b);

< changed the data and len to remove leading 0-bytes

arguments:

bytes_t *

b

data.h¶

json-parser.

The parser can read from :

json
bin

When reading from json all ‘0x’… values will be stored as bytes_t. If the value is lower than 0xFFFFFFF, it is converted as integer.

File: src/core/util/data.h

DATA_DEPTH_MAX¶

the max DEPTH of the JSON-data allowed.

It will throw an error if reached.

#define DATA_DEPTH_MAX 11

printX¶

#define printX printf

fprintX¶

#define fprintX fprintf

snprintX¶

#define snprintX snprintf

vprintX¶

#define vprintX vprintf

d_key_t¶

typedef uint16_t d_key_t

d_token_t¶

a token holding any kind of value.

use d_type, d_len or the cast-function to get the value.

The stuct contains following fields:

`uint8_t *`	data	the byte or string-data
`uint32_t`	len	the length of the content (or number of properties) depending + type.
`d_key_t`	key	the key of the property.

str_range_t¶

internal type used to represent the a range within a string.

The stuct contains following fields:

`char *`	data	pointer to the start of the string
`size_t`	len	len of the characters

json_ctx_t¶

parser for json or binary-data.

it needs to freed after usage.

The stuct contains following fields:

d_token_t *	result	the list of all tokens. the first token is the main-token as returned by the parser.
`char *`	c
`size_t`	allocated	pointer to the src-data
`size_t`	len	amount of tokens allocated result
`size_t`	depth	number of tokens in result

d_iterator_t¶

iterator over elements of a array opf object.

usage:

for (d_iterator_t iter = d_iter( parent ); iter.left ; d_iter_next(&iter)) {
  uint32_t val = d_int(iter.token);
}

The stuct contains following fields:

d_token_t *	token	current token
`int`	left	number of result left

d_to_bytes¶

bytes_t d_to_bytes(d_token_t *item);

returns the byte-representation of token.

In case of a number it is returned as bigendian. booleans as 0x01 or 0x00 and NULL as 0x. Objects or arrays will return 0x.

arguments:

item

returns: bytes_t

d_bytes_to¶

int d_bytes_to(d_token_t *item, uint8_t *dst, const int max);

writes the byte-representation to the dst.

details see d_to_bytes.

arguments:

d_token_t *	item
`uint8_t *`	dst
`const int`	max

returns: int

d_bytes¶

bytes_t* d_bytes(const d_token_t *item);

returns the value as bytes (Carefully, make sure that the token is a bytes-type!)

arguments:

item

returns: bytes_t *

d_bytesl¶

bytes_t* d_bytesl(d_token_t *item, size_t l);

returns the value as bytes with length l (may reallocates)

arguments:

d_token_t *	item
`size_t`	l

returns: bytes_t *

d_string¶

char* d_string(const d_token_t *item);

converts the value as string.

Make sure the type is string!

arguments:

item

returns: char *

d_int¶

int32_t d_int(const d_token_t *item);

returns the value as integer.

only if type is integer

arguments:

item

returns: int32_t

d_intd¶

int32_t d_intd(const d_token_t *item, const uint32_t def_val);

returns the value as integer or if NULL the default.

only if type is integer

arguments:

d_token_tconst , *	item
`const uint32_t`	def_val

returns: int32_t

d_long¶

uint64_t d_long(const d_token_t *item);

returns the value as long.

only if type is integer or bytes, but short enough

arguments:

item

returns: uint64_t

d_longd¶

uint64_t d_longd(const d_token_t *item, const uint64_t def_val);

returns the value as long or if NULL the default.

only if type is integer or bytes, but short enough

arguments:

d_token_tconst , *	item
`const uint64_t`	def_val

returns: uint64_t

d_create_bytes_vec¶

bytes_t** d_create_bytes_vec(const d_token_t *arr);

arguments:

arr

returns: bytes_t **

d_type¶

static d_type_t d_type(const d_token_t *item);

creates a array of bytes from JOSN-array

type of the token

arguments:

item

returns: d_type_t

d_len¶

static int d_len(const d_token_t *item);

number of elements in the token (only for object or array, other will return 0)

arguments:

item

returns: int

d_eq¶

bool d_eq(const d_token_t *a, const d_token_t *b);

compares 2 token and if the value is equal

arguments:

d_token_tconst , *	a
d_token_tconst , *	b

returns: bool

keyn¶

d_key_t keyn(const char *c, const size_t len);

generates the keyhash for the given stringrange as defined by len

arguments:

`const char *`	c
`const size_t`	len

returns: d_key_t

d_get¶

d_token_t* d_get(d_token_t *item, const uint16_t key);

returns the token with the given propertyname (only if item is a object)

arguments:

d_token_t *	item
`const uint16_t`	key

returns: d_token_t *

d_get_or¶

d_token_t* d_get_or(d_token_t *item, const uint16_t key1, const uint16_t key2);

returns the token with the given propertyname or if not found, tries the other.

(only if item is a object)

arguments:

d_token_t *	item
`const uint16_t`	key1
`const uint16_t`	key2

returns: d_token_t *

d_get_at¶

d_token_t* d_get_at(d_token_t *item, const uint32_t index);

returns the token of an array with the given index

arguments:

d_token_t *	item
`const uint32_t`	index

returns: d_token_t *

d_next¶

d_token_t* d_next(d_token_t *item);

returns the next sibling of an array or object

arguments:

item

returns: d_token_t *

d_serialize_binary¶

void d_serialize_binary(bytes_builder_t *bb, d_token_t *t);

write the token as binary data into the builder

arguments:

bytes_builder_t *	bb
d_token_t *	t

parse_binary¶

json_ctx_t* parse_binary(const bytes_t *data);

parses the data and returns the context with the token, which needs to be freed after usage!

arguments:

data

returns: json_ctx_t *

parse_binary_str¶

json_ctx_t* parse_binary_str(const char *data, int len);

parses the data and returns the context with the token, which needs to be freed after usage!

arguments:

`const char *`	data
`int`	len

returns: json_ctx_t *

parse_json¶

json_ctx_t* parse_json(char *js);

parses json-data, which needs to be freed after usage!

arguments:

char * js

returns: json_ctx_t *

json_free¶

void json_free(json_ctx_t *parser_ctx);

frees the parse-context after usage

arguments:

parser_ctx

d_to_json¶

str_range_t d_to_json(const d_token_t *item);

returns the string for a object or array.

This only works for json as string. For binary it will not work!

arguments:

item

returns: str_range_t

d_create_json¶

char* d_create_json(d_token_t *item);

creates a json-string.

It does not work for objects if the parsed data were binary!

arguments:

item

returns: char *

json_create¶

json_ctx_t* json_create();

returns: json_ctx_t *

json_create_null¶

d_token_t* json_create_null(json_ctx_t *jp);

arguments:

jp

returns: d_token_t *

json_create_bool¶

d_token_t* json_create_bool(json_ctx_t *jp, bool value);

arguments:

json_ctx_t *	jp
`bool`	value

returns: d_token_t *

json_create_int¶

d_token_t* json_create_int(json_ctx_t *jp, uint64_t value);

arguments:

json_ctx_t *	jp
`uint64_t`	value

returns: d_token_t *

json_create_string¶

d_token_t* json_create_string(json_ctx_t *jp, char *value);

arguments:

json_ctx_t *	jp
`char *`	value

returns: d_token_t *

json_create_bytes¶

d_token_t* json_create_bytes(json_ctx_t *jp, bytes_t value);

arguments:

json_ctx_t *	jp
bytes_t	value

returns: d_token_t *

json_create_object¶

d_token_t* json_create_object(json_ctx_t *jp);

arguments:

jp

returns: d_token_t *

json_create_array¶

d_token_t* json_create_array(json_ctx_t *jp);

arguments:

jp

returns: d_token_t *

json_object_add_prop¶

d_token_t* json_object_add_prop(d_token_t *object, d_key_t key, d_token_t *value);

arguments:

d_token_t *	object
`d_key_t`	key
d_token_t *	value

returns: d_token_t *

json_array_add_value¶

d_token_t* json_array_add_value(d_token_t *object, d_token_t *value);

arguments:

d_token_t *	object
d_token_t *	value

returns: d_token_t *

d_get_keystr¶

char* d_get_keystr(d_key_t k);

returns the string for a key.

This only works track_keynames was activated before!

arguments:

d_key_t k

returns: char *

d_track_keynames¶

void d_track_keynames(uint8_t v);

activates the keyname-cache, which stores the string for the keys when parsing.

arguments:

uint8_t v

d_clear_keynames¶

void d_clear_keynames();

delete the cached keynames

key¶

static d_key_t key(const char *c);

arguments:

const char * c

returns: d_key_t

d_get_stringk¶

static char* d_get_stringk(d_token_t *r, d_key_t k);

reads token of a property as string.

arguments:

d_token_t *	r
`d_key_t`	k

returns: char *

d_get_string¶

static char* d_get_string(d_token_t *r, char *k);

reads token of a property as string.

arguments:

d_token_t *	r
`char *`	k

returns: char *

d_get_string_at¶

static char* d_get_string_at(d_token_t *r, uint32_t pos);

reads string at given pos of an array.

arguments:

d_token_t *	r
`uint32_t`	pos

returns: char *

d_get_intk¶

static int32_t d_get_intk(d_token_t *r, d_key_t k);

reads token of a property as int.

arguments:

d_token_t *	r
`d_key_t`	k

returns: int32_t

d_get_intkd¶

static int32_t d_get_intkd(d_token_t *r, d_key_t k, uint32_t d);

reads token of a property as int.

arguments:

d_token_t *	r
`d_key_t`	k
`uint32_t`	d

returns: int32_t

d_get_int¶

static int32_t d_get_int(d_token_t *r, char *k);

reads token of a property as int.

arguments:

d_token_t *	r
`char *`	k

returns: int32_t

d_get_int_at¶

static int32_t d_get_int_at(d_token_t *r, uint32_t pos);

reads a int at given pos of an array.

arguments:

d_token_t *	r
`uint32_t`	pos

returns: int32_t

d_get_longk¶

static uint64_t d_get_longk(d_token_t *r, d_key_t k);

reads token of a property as long.

arguments:

d_token_t *	r
`d_key_t`	k

returns: uint64_t

d_get_longkd¶

static uint64_t d_get_longkd(d_token_t *r, d_key_t k, uint64_t d);

reads token of a property as long.

arguments:

d_token_t *	r
`d_key_t`	k
`uint64_t`	d

returns: uint64_t

d_get_long¶

static uint64_t d_get_long(d_token_t *r, char *k);

reads token of a property as long.

arguments:

d_token_t *	r
`char *`	k

returns: uint64_t

d_get_long_at¶

static uint64_t d_get_long_at(d_token_t *r, uint32_t pos);

reads long at given pos of an array.

arguments:

d_token_t *	r
`uint32_t`	pos

returns: uint64_t

d_get_bytesk¶

static bytes_t* d_get_bytesk(d_token_t *r, d_key_t k);

reads token of a property as bytes.

arguments:

d_token_t *	r
`d_key_t`	k

returns: bytes_t *

d_get_bytes¶

static bytes_t* d_get_bytes(d_token_t *r, char *k);

reads token of a property as bytes.

arguments:

d_token_t *	r
`char *`	k

returns: bytes_t *

d_get_bytes_at¶

static bytes_t* d_get_bytes_at(d_token_t *r, uint32_t pos);

reads bytes at given pos of an array.

arguments:

d_token_t *	r
`uint32_t`	pos

returns: bytes_t *

d_is_binary_ctx¶

static bool d_is_binary_ctx(json_ctx_t *ctx);

check if the parser context was created from binary data.

arguments:

ctx

returns: bool

d_get_byteskl¶

bytes_t* d_get_byteskl(d_token_t *r, d_key_t k, uint32_t minl);

arguments:

d_token_t *	r
`d_key_t`	k
`uint32_t`	minl

returns: bytes_t *

d_getl¶

d_token_t* d_getl(d_token_t *item, uint16_t k, uint32_t minl);

arguments:

d_token_t *	item
`uint16_t`	k
`uint32_t`	minl

returns: d_token_t *

d_iter¶

static d_iterator_t d_iter(d_token_t *parent);

creates a iterator for a object or array

arguments:

parent

returns: d_iterator_t

d_iter_next¶

static bool d_iter_next(d_iterator_t *const iter);

fetched the next token an returns a boolean indicating whther there is a next or not.

arguments:

d_iterator_t *const

iter

returns: bool

debug.h¶

logs debug data only if the DEBUG-flag is set.

File: src/core/util/debug.h

IN3_EXPORT_TEST¶

#define IN3_EXPORT_TEST static

dbg_log (msg,…)¶

logs a debug-message including file and linenumber

dbg_log_raw (msg,…)¶

logs a debug-message without the filename

msg_dump¶

void msg_dump(const char *s, const unsigned char *data, unsigned len);

dumps the given data as hex coded bytes to stdout

arguments:

`const char *`	s
`const unsigned char *`	data
`unsigned`	len

error.h¶

defines the return-values of a function call.

File: src/core/util/error.h

DEPRECATED¶

depreacted-attribute

#define DEPRECATED __attribute__((deprecated))

OPTIONAL_T (t)¶

Optional type similar to C++ std::optional Optional types must be defined prior to usage (e.g.

DEFINE_OPTIONAL_T(int)) Use OPTIONAL_T_UNDEFINED(t) & OPTIONAL_T_VALUE(t, v) for easy initialization (rvalues) Note: Defining optional types for pointers is ill-formed by definition. This is because redundant

#define OPTIONAL_T (t) opt_##t

DEFINE_OPTIONAL_T (t)¶

Optional types must be defined prior to usage (e.g.

DEFINE_OPTIONAL_T(int)) Use OPTIONAL_T_UNDEFINED(t) & OPTIONAL_T_VALUE(t, v) for easy initialization (rvalues)

#define DEFINE_OPTIONAL_T (t) typedef struct {           \
    t    value;              \
    bool defined;            \
  } OPTIONAL_T(t)

OPTIONAL_T_UNDEFINED (t)¶

marks a used value as undefined.

#define OPTIONAL_T_UNDEFINED (t) ((OPTIONAL_T(t)){.defined = false})

OPTIONAL_T_VALUE (t,v)¶

sets the value of an optional type.

#define OPTIONAL_T_VALUE (t,v) ((OPTIONAL_T(t)){.value = v, .defined = true})

in3_errmsg¶

char* in3_errmsg(in3_ret_t err);

converts a error code into a string.

These strings are constants and do not need to be freed.

arguments:

in3_ret_t

err

the error code

returns: char *

scache.h¶

util helper on byte arrays.

File: src/core/util/scache.h

cache_entry_t¶

represents a single cache entry in a linked list.

These are used within a request context to cache values and automaticly free them.

The stuct contains following fields:

bytes_t	key	an optional key of the entry
bytes_t	value	the value
`uint8_t`	buffer	the buffer is used to store extra data, which will be cleaned when freed.
`bool`	must_free	if true, the cache-entry will be freed when the request context is cleaned up.
cache_entrystruct , *	next	pointer to the next entry.

in3_cache_get_entry¶

bytes_t* in3_cache_get_entry(cache_entry_t *cache, bytes_t *key);

get the entry for a given key.

arguments:

cache_entry_t *	cache	the root entry of the linked list.
bytes_t *	key	the key to compare with

returns: bytes_t *

in3_cache_add_entry¶

cache_entry_t* in3_cache_add_entry(cache_entry_t **cache, bytes_t key, bytes_t value);

adds an entry to the linked list.

arguments:

cache_entry_t **	cache	the root entry of the linked list.
bytes_t	key	an optional key
bytes_t	value	the value of the entry

returns: cache_entry_t *

in3_cache_free¶

void in3_cache_free(cache_entry_t *cache);

clears all entries in the linked list.

arguments:

cache_entry_t *

cache

the root entry of the linked list.

in3_cache_add_ptr¶

static cache_entry_t* in3_cache_add_ptr(cache_entry_t **cache, void *ptr);

adds a pointer, which should be freed when the context is freed.

arguments:

cache_entry_t **	cache	the root entry of the linked list.
`void *`	ptr	pointer to memory which shold be freed.

returns: cache_entry_t *

stringbuilder.h¶

simple string buffer used to dynamicly add content.

File: src/core/util/stringbuilder.h

sb_add_hexuint (sb,i)¶

shortcut macro for adding a uint to the stringbuilder using sizeof(i) to automaticly determine the size

#define sb_add_hexuint (sb,i) sb_add_hexuint_l(sb, i, sizeof(i))

sb_t¶

string build struct, which is able to hold and modify a growing string.

The stuct contains following fields:

`char *`	data	the current string (null terminated)
`size_t`	allocted	number of bytes currently allocated
`size_t`	len	the current length of the string

sb_new¶

sb_t* sb_new(const char *chars);

creates a new stringbuilder and copies the inital characters into it.

arguments:

const char * chars

returns: sb_t *

sb_init¶

sb_t* sb_init(sb_t *sb);

initializes a stringbuilder by allocating memory.

arguments:

sb_t *

sb

returns: sb_t *

sb_free¶

void sb_free(sb_t *sb);

frees all resources of the stringbuilder

arguments:

sb_t *

sb

sb_add_char¶

sb_t* sb_add_char(sb_t *sb, char c);

add a single character

arguments:

sb_t *	sb
`char`	c

returns: sb_t *

sb_add_chars¶

sb_t* sb_add_chars(sb_t *sb, const char *chars);

adds a string

arguments:

sb_t *	sb
`const char *`	chars

returns: sb_t *

sb_add_range¶

sb_t* sb_add_range(sb_t *sb, const char *chars, int start, int len);

add a string range

arguments:

sb_t *	sb
`const char *`	chars
`int`	start
`int`	len

returns: sb_t *

sb_add_key_value¶

sb_t* sb_add_key_value(sb_t *sb, const char *key, const char *value, int value_len, bool as_string);

adds a value with an optional key.

if as_string is true the value will be quoted.

arguments:

sb_t *	sb
`const char *`	key
`const char *`	value
`int`	value_len
`bool`	as_string

returns: sb_t *

sb_add_bytes¶

sb_t* sb_add_bytes(sb_t *sb, const char *prefix, const bytes_t *bytes, int len, bool as_array);

add bytes as 0x-prefixed hexcoded string (including an optional prefix), if len>1 is passed bytes maybe an array ( if as_array==true)

arguments:

sb_t *	sb
`const char *`	prefix
bytes_tconst , *	bytes
`int`	len
`bool`	as_array

returns: sb_t *

sb_add_hexuint_l¶

sb_t* sb_add_hexuint_l(sb_t *sb, uintmax_t uint, size_t l);

add a integer value as hexcoded, 0x-prefixed string

Other types not supported

arguments:

sb_t *	sb
`uintmax_t`	uint
`size_t`	l

returns: sb_t *

utils.h¶

utility functions.

File: src/core/util/utils.h

SWAP (a,b)¶

simple swap macro for integral types

#define SWAP (a,b) {                \
    void* p = a;   \
    a       = b;   \
    b       = p;   \
  }

min (a,b)¶

simple min macro for interagl types

#define min (a,b) ((a) < (b) ? (a) : (b))

max (a,b)¶

simple max macro for interagl types

#define max (a,b) ((a) > (b) ? (a) : (b))

IS_APPROX (n1,n2,err)¶

Check if n1 & n2 are at max err apart Expects n1 & n2 to be integral types.

#define IS_APPROX (n1,n2,err) ((n1 > n2) ? ((n1 - n2) <= err) : ((n2 - n1) <= err))

optimize_len (a,l)¶

changes to pointer (a) and it length (l) to remove leading 0 bytes.

#define optimize_len (a,l) while (l > 1 && *a == 0) { \
    l--;                     \
    a++;                     \
  }

TRY (exp)¶

executes the expression and expects the return value to be a int indicating the error.

if the return value is negative it will stop and return this value otherwise continue.

#define TRY (exp) {                        \
    int _r = (exp);        \
    if (_r < 0) return _r; \
  }

TRY_SET (var,exp)¶

executes the expression and expects the return value to be a int indicating the error.

the return value will be set to a existing variable (var). if the return value is negative it will stop and return this value otherwise continue.

#define TRY_SET (var,exp) {                          \
    var = (exp);             \
    if (var < 0) return var; \
  }

TRY_GOTO (exp)¶

executes the expression and expects the return value to be a int indicating the error.

if the return value is negative it will stop and jump (goto) to a marked position “clean”. it also expects a previously declared variable “in3_ret_t res”.

#define TRY_GOTO (exp) {                          \
    res = (exp);             \
    if (res < 0) goto clean; \
  }

bytes_to_long¶

uint64_t bytes_to_long(const uint8_t *data, int len);

converts the bytes to a unsigned long (at least the last max len bytes)

arguments:

`const uint8_t *`	data
`int`	len

returns: uint64_t

bytes_to_int¶

static uint32_t bytes_to_int(const uint8_t *data, int len);

converts the bytes to a unsigned int (at least the last max len bytes)

arguments:

`const uint8_t *`	data
`int`	len

returns: uint32_t

char_to_long¶

uint64_t char_to_long(const char *a, int l);

converts a character into a uint64_t

arguments:

`const char *`	a
`int`	l

returns: uint64_t

hexchar_to_int¶

uint8_t hexchar_to_int(char c);

converts a hexchar to byte (4bit)

arguments:

char c

returns: uint8_t

u64_to_str¶

const unsigned char* u64_to_str(uint64_t value, char *pBuf, int szBuf);

converts a uint64_t to string (char*); buffer-size min.

21 bytes

arguments:

`uint64_t`	value
`char *`	pBuf
`int`	szBuf

returns: const unsigned char *

hex_to_bytes¶

int hex_to_bytes(const char *hexdata, int hexlen, uint8_t *out, int outlen);

convert a c hex string to a byte array storing it into an existing buffer.

arguments:

`const char *`	hexdata
`int`	hexlen
`uint8_t *`	out
`int`	outlen

returns: int

hex_to_new_bytes¶

bytes_t* hex_to_new_bytes(const char *buf, int len);

convert a c string to a byte array creating a new buffer

arguments:

`const char *`	buf
`int`	len

returns: bytes_t *

bytes_to_hex¶

int bytes_to_hex(const uint8_t *buffer, int len, char *out);

convefrts a bytes into hex

arguments:

`const uint8_t *`	buffer
`int`	len
`char *`	out

returns: int

sha3¶

bytes_t* sha3(const bytes_t *data);

hashes the bytes and creates a new bytes_t

arguments:

data

returns: bytes_t *

sha3_to¶

int sha3_to(bytes_t *data, void *dst);

writes 32 bytes to the pointer.

arguments:

bytes_t *	data
`void *`	dst

returns: int

long_to_bytes¶

void long_to_bytes(uint64_t val, uint8_t *dst);

converts a long to 8 bytes

arguments:

`uint64_t`	val
`uint8_t *`	dst

int_to_bytes¶

void int_to_bytes(uint32_t val, uint8_t *dst);

converts a int to 4 bytes

arguments:

`uint32_t`	val
`uint8_t *`	dst

_strdupn¶

char* _strdupn(const char *src, int len);

duplicate the string

arguments:

`const char *`	src
`int`	len

returns: char *

min_bytes_len¶

int min_bytes_len(uint64_t val);

calculate the min number of byte to represents the len

arguments:

uint64_t val

returns: int

uint256_set¶

void uint256_set(const uint8_t *src, wlen_t src_len, bytes32_t dst);

sets a variable value to 32byte word.

arguments:

`const uint8_t *`	src
wlen_t	src_len
bytes32_t	dst

str_replace¶

char* str_replace(const char *orig, const char *rep, const char *with);

replaces a string and returns a copy.

arguments:

`const char *`	orig
`const char *`	rep
`const char *`	with

returns: char *

str_replace_pos¶

char* str_replace_pos(const char *orig, size_t pos, size_t len, const char *rep);

replaces a string at the given position.

arguments:

`const char *`	orig
`size_t`	pos
`size_t`	len
`const char *`	rep

returns: char *

str_find¶

char* str_find(const char *haystack, const char *needle);

lightweight strstr() replacements

arguments:

`const char *`	haystack
`const char *`	needle

returns: char *

current_ms¶

uint64_t current_ms();

current timestamp in ms.

returns: uint64_t

memiszero¶

static bool memiszero(uint8_t *ptr, size_t l);

arguments:

`uint8_t *`	ptr
`size_t`	l

returns: bool

Module transport/curl¶

in3_curl.h¶

transport-handler using libcurl.

File: src/transport/curl/in3_curl.h

send_curl¶

in3_ret_t send_curl(in3_request_t *req);

a transport function using curl.

You can use it by setting the transport-function-pointer in the in3_t->transport to this function:

#include <in3/in3_curl.h>
...
c->transport = send_curl;

arguments:

in3_request_t *

req

returns: in3_ret_t the result-status of the function.

Please make sure you check if it was successfull (==IN3_OK)

in3_register_curl¶

void in3_register_curl();

registers curl as a default transport.

Module transport/http¶

in3_http.h¶

transport-handler using simple http.

File: src/transport/http/in3_http.h

send_http¶

in3_ret_t send_http(in3_request_t *req);

a very simple transport function, which allows to send http-requests without a dependency to curl.

Here each request will be transformed to http instead of https.

You can use it by setting the transport-function-pointer in the in3_t->transport to this function:

#include <in3/in3_http.h>
...
c->transport = send_http;

arguments:

in3_request_t *

req

returns: in3_ret_t the result-status of the function.

Please make sure you check if it was successfull (==IN3_OK)

Module verifier/eth1/basic¶

eth_basic.h¶

Ethereum Nanon verification.

File: src/verifier/eth1/basic/eth_basic.h

in3_verify_eth_basic¶

in3_ret_t in3_verify_eth_basic(in3_vctx_t *v);

entry-function to execute the verification context.

arguments:

v

returns: in3_ret_t the result-status of the function.

Please make sure you check if it was successfull (==IN3_OK)

eth_verify_tx_values¶

in3_ret_t eth_verify_tx_values(in3_vctx_t *vc, d_token_t *tx, bytes_t *raw);

verifies internal tx-values.

arguments:

in3_vctx_t *	vc
d_token_t *	tx
bytes_t *	raw

returns: in3_ret_t the result-status of the function.

Please make sure you check if it was successfull (==IN3_OK)

eth_verify_eth_getTransaction¶

in3_ret_t eth_verify_eth_getTransaction(in3_vctx_t *vc, bytes_t *tx_hash);

verifies a transaction.

arguments:

in3_vctx_t *	vc
bytes_t *	tx_hash

returns: in3_ret_t the result-status of the function.

Please make sure you check if it was successfull (==IN3_OK)

eth_verify_eth_getTransactionByBlock¶

in3_ret_t eth_verify_eth_getTransactionByBlock(in3_vctx_t *vc, d_token_t *blk, uint32_t tx_idx);

verifies a transaction by block hash/number and id.

arguments:

in3_vctx_t *	vc
d_token_t *	blk
`uint32_t`	tx_idx

returns: in3_ret_t the result-status of the function.

Please make sure you check if it was successfull (==IN3_OK)

eth_verify_account_proof¶

in3_ret_t eth_verify_account_proof(in3_vctx_t *vc);

verify account-proofs

arguments:

vc

returns: in3_ret_t the result-status of the function.

Please make sure you check if it was successfull (==IN3_OK)

eth_verify_eth_getBlock¶

in3_ret_t eth_verify_eth_getBlock(in3_vctx_t *vc, bytes_t *block_hash, uint64_t blockNumber);

verifies a block

arguments:

in3_vctx_t *	vc
bytes_t *	block_hash
`uint64_t`	blockNumber

returns: in3_ret_t the result-status of the function.

Please make sure you check if it was successfull (==IN3_OK)

in3_register_eth_basic¶

void in3_register_eth_basic();

this function should only be called once and will register the eth-nano verifier.

eth_verify_eth_getLog¶

in3_ret_t eth_verify_eth_getLog(in3_vctx_t *vc, int l_logs);

verify logs

arguments:

in3_vctx_t *	vc
`int`	l_logs

returns: in3_ret_t the result-status of the function.

Please make sure you check if it was successfull (==IN3_OK)

eth_handle_intern¶

in3_ret_t eth_handle_intern(in3_ctx_t *ctx, in3_response_t **response);

this is called before a request is send

arguments:

in3_ctx_t *	ctx
in3_response_t **	response

returns: in3_ret_t the result-status of the function.

Please make sure you check if it was successfull (==IN3_OK)

signer.h¶

Ethereum Nano verification.

File: src/verifier/eth1/basic/signer.h

eth_set_pk_signer¶

in3_ret_t eth_set_pk_signer(in3_t *in3, bytes32_t pk);

simply signer with one private key.

since the pk pointting to the 32 byte private key is not cloned, please make sure, you manage memory allocation correctly!

simply signer with one private key.

arguments:

in3_t *	in3
bytes32_t	pk

returns: in3_ret_t the result-status of the function.

Please make sure you check if it was successfull (==IN3_OK)

trie.h¶

Patricia Merkle Tree Imnpl

File: src/verifier/eth1/basic/trie.h

in3_hasher_t¶

hash-function

typedef void(* in3_hasher_t) (bytes_t *src, uint8_t *dst)

in3_codec_add_t¶

codec to organize the encoding of the nodes

typedef void(* in3_codec_add_t) (bytes_builder_t *bb, bytes_t *val)

in3_codec_finish_t¶

typedef void(* in3_codec_finish_t) (bytes_builder_t *bb, bytes_t *dst)

in3_codec_decode_size_t¶

typedef int(* in3_codec_decode_size_t) (bytes_t *src)

returns: int(*

in3_codec_decode_index_t¶

typedef int(* in3_codec_decode_index_t) (bytes_t *src, int index, bytes_t *dst)

returns: int(*

trie_node_t¶

single node in the merkle trie.

The stuct contains following fields:

`uint8_t`	hash	the hash of the node
bytes_t	data	the raw data
bytes_t	items	the data as list
`uint8_t`	own_memory	if true this is a embedded node with own memory
trie_node_type_t	type	type of the node
trie_nodestruct , *	next	used as linked list

trie_codec_t¶

the codec used to encode nodes.

The stuct contains following fields:

in3_codec_add_t	encode_add
`in3_codec_finish_t`	encode_finish
`in3_codec_decode_size_t`	decode_size
`in3_codec_decode_index_t`	decode_item

trie_t¶

a merkle trie implementation.

This is a Patricia Merkle Tree.

The stuct contains following fields:

in3_hasher_t	hasher	hash-function.
trie_codec_t *	codec	encoding of the nocds.
bytes32_t	root	The root-hash.
trie_node_t *	nodes	linked list of containes nodes

trie_new¶

trie_t* trie_new();

creates a new Merkle Trie.

returns: trie_t *

trie_free¶

void trie_free(trie_t *val);

frees all resources of the trie.

arguments:

trie_t *

val

trie_set_value¶

void trie_set_value(trie_t *t, bytes_t *key, bytes_t *value);

sets a value in the trie.

The root-hash will be updated automaticly.

arguments:

trie_t *	t
bytes_t *	key
bytes_t *	value

Module verifier/eth1/evm¶

big.h¶

Ethereum Nanon verification.

File: src/verifier/eth1/evm/big.h

big_is_zero¶

uint8_t big_is_zero(uint8_t *data, wlen_t l);

arguments:

`uint8_t *`	data
wlen_t	l

returns: uint8_t

big_shift_left¶

void big_shift_left(uint8_t *a, wlen_t len, int bits);

arguments:

`uint8_t *`	a
wlen_t	len
`int`	bits

big_shift_right¶

void big_shift_right(uint8_t *a, wlen_t len, int bits);

arguments:

`uint8_t *`	a
wlen_t	len
`int`	bits

big_cmp¶

int big_cmp(const uint8_t *a, const wlen_t len_a, const uint8_t *b, const wlen_t len_b);

arguments:

`const uint8_t *`	a
wlen_tconst	len_a
`const uint8_t *`	b
wlen_tconst	len_b

returns: int

big_signed¶

int big_signed(uint8_t *val, wlen_t len, uint8_t *dst);

returns 0 if the value is positive or 1 if negavtive.

in this case the absolute value is copied to dst.

arguments:

`uint8_t *`	val
wlen_t	len
`uint8_t *`	dst

returns: int

big_int¶

int32_t big_int(uint8_t *val, wlen_t len);

arguments:

`uint8_t *`	val
wlen_t	len

returns: int32_t

big_add¶

int big_add(uint8_t *a, wlen_t len_a, uint8_t *b, wlen_t len_b, uint8_t *out, wlen_t max);

arguments:

`uint8_t *`	a
wlen_t	len_a
`uint8_t *`	b
wlen_t	len_b
`uint8_t *`	out
wlen_t	max

returns: int

big_sub¶

int big_sub(uint8_t *a, wlen_t len_a, uint8_t *b, wlen_t len_b, uint8_t *out);

arguments:

`uint8_t *`	a
wlen_t	len_a
`uint8_t *`	b
wlen_t	len_b
`uint8_t *`	out

returns: int

big_mul¶

int big_mul(uint8_t *a, wlen_t la, uint8_t *b, wlen_t lb, uint8_t *res, wlen_t max);

arguments:

`uint8_t *`	a
wlen_t	la
`uint8_t *`	b
wlen_t	lb
`uint8_t *`	res
wlen_t	max

returns: int

big_div¶

int big_div(uint8_t *a, wlen_t la, uint8_t *b, wlen_t lb, wlen_t sig, uint8_t *res);

arguments:

`uint8_t *`	a
wlen_t	la
`uint8_t *`	b
wlen_t	lb
wlen_t	sig
`uint8_t *`	res

returns: int

big_mod¶

int big_mod(uint8_t *a, wlen_t la, uint8_t *b, wlen_t lb, wlen_t sig, uint8_t *res);

arguments:

`uint8_t *`	a
wlen_t	la
`uint8_t *`	b
wlen_t	lb
wlen_t	sig
`uint8_t *`	res

returns: int

big_exp¶

int big_exp(uint8_t *a, wlen_t la, uint8_t *b, wlen_t lb, uint8_t *res);

arguments:

`uint8_t *`	a
wlen_t	la
`uint8_t *`	b
wlen_t	lb
`uint8_t *`	res

returns: int

big_log256¶

int big_log256(uint8_t *a, wlen_t len);

arguments:

`uint8_t *`	a
wlen_t	len

returns: int

code.h¶

code cache.

File: src/verifier/eth1/evm/code.h

in3_get_code¶

in3_ret_t in3_get_code(in3_vctx_t *vc, address_t address, cache_entry_t **target);

fetches the code and adds it to the context-cache as cache_entry.

So calling this function a second time will take the result from cache.

arguments:

in3_vctx_t *	vc
address_t	address
cache_entry_t **	target

returns: in3_ret_t the result-status of the function.

Please make sure you check if it was successfull (==IN3_OK)

evm.h¶

main evm-file.

File: src/verifier/eth1/evm/evm.h

gas_options¶

EVM_ERROR_EMPTY_STACK¶

the no more elements on the stack

#define EVM_ERROR_EMPTY_STACK -20

EVM_ERROR_INVALID_OPCODE¶

the opcode is not supported

#define EVM_ERROR_INVALID_OPCODE -21

EVM_ERROR_BUFFER_TOO_SMALL¶

reading data from a position, which is not initialized

#define EVM_ERROR_BUFFER_TOO_SMALL -22

EVM_ERROR_ILLEGAL_MEMORY_ACCESS¶

the memory-offset does not exist

#define EVM_ERROR_ILLEGAL_MEMORY_ACCESS -23

EVM_ERROR_INVALID_JUMPDEST¶

the jump destination is not marked as valid destination

#define EVM_ERROR_INVALID_JUMPDEST -24

EVM_ERROR_INVALID_PUSH¶

the push data is empy

#define EVM_ERROR_INVALID_PUSH -25

EVM_ERROR_UNSUPPORTED_CALL_OPCODE¶

error handling the call, usually because static-calls are not allowed to change state

#define EVM_ERROR_UNSUPPORTED_CALL_OPCODE -26

EVM_ERROR_TIMEOUT¶

the evm ran into a loop

#define EVM_ERROR_TIMEOUT -27

EVM_ERROR_INVALID_ENV¶

the enviroment could not deliver the data

#define EVM_ERROR_INVALID_ENV -28

EVM_ERROR_OUT_OF_GAS¶

not enough gas to exewcute the opcode

#define EVM_ERROR_OUT_OF_GAS -29

EVM_ERROR_BALANCE_TOO_LOW¶

not enough funds to transfer the requested value.

#define EVM_ERROR_BALANCE_TOO_LOW -30

EVM_ERROR_STACK_LIMIT¶

stack limit reached

#define EVM_ERROR_STACK_LIMIT -31

EVM_ERROR_SUCCESS_CONSUME_GAS¶

write success but consume all gas

#define EVM_ERROR_SUCCESS_CONSUME_GAS -32

EVM_PROP_FRONTIER¶

#define EVM_PROP_FRONTIER 1

EVM_PROP_EIP150¶

#define EVM_PROP_EIP150 2

EVM_PROP_EIP158¶

#define EVM_PROP_EIP158 4

EVM_PROP_CONSTANTINOPL¶

#define EVM_PROP_CONSTANTINOPL 16

EVM_PROP_ISTANBUL¶

#define EVM_PROP_ISTANBUL 32

EVM_PROP_NO_FINALIZE¶

#define EVM_PROP_NO_FINALIZE 32768

EVM_PROP_STATIC¶

#define EVM_PROP_STATIC 256

EVM_ENV_BALANCE¶

#define EVM_ENV_BALANCE 1

EVM_ENV_CODE_SIZE¶

#define EVM_ENV_CODE_SIZE 2

EVM_ENV_CODE_COPY¶

#define EVM_ENV_CODE_COPY 3

EVM_ENV_BLOCKHASH¶

#define EVM_ENV_BLOCKHASH 4

EVM_ENV_STORAGE¶

#define EVM_ENV_STORAGE 5

EVM_ENV_BLOCKHEADER¶

#define EVM_ENV_BLOCKHEADER 6

EVM_ENV_CODE_HASH¶

#define EVM_ENV_CODE_HASH 7

EVM_ENV_NONCE¶

#define EVM_ENV_NONCE 8

MATH_ADD¶

#define MATH_ADD 1

MATH_SUB¶

#define MATH_SUB 2

MATH_MUL¶

#define MATH_MUL 3

MATH_DIV¶

#define MATH_DIV 4

MATH_SDIV¶

#define MATH_SDIV 5

MATH_MOD¶

#define MATH_MOD 6

MATH_SMOD¶

#define MATH_SMOD 7

MATH_EXP¶

#define MATH_EXP 8

MATH_SIGNEXP¶

#define MATH_SIGNEXP 9

CALL_CALL¶

#define CALL_CALL 0

CALL_CODE¶

#define CALL_CODE 1

CALL_DELEGATE¶

#define CALL_DELEGATE 2

CALL_STATIC¶

#define CALL_STATIC 3

OP_AND¶

#define OP_AND 0

OP_OR¶

#define OP_OR 1

OP_XOR¶

#define OP_XOR 2

EVM_DEBUG_BLOCK (…)¶

OP_LOG (…)¶

#define OP_LOG (...) EVM_ERROR_UNSUPPORTED_CALL_OPCODE

OP_SLOAD_GAS (…)¶

OP_CREATE (…)¶

#define OP_CREATE (...) EVM_ERROR_UNSUPPORTED_CALL_OPCODE

OP_ACCOUNT_GAS (…)¶

#define OP_ACCOUNT_GAS (...) 0

OP_SELFDESTRUCT (…)¶

#define OP_SELFDESTRUCT (...) EVM_ERROR_UNSUPPORTED_CALL_OPCODE

OP_EXTCODECOPY_GAS (evm)¶

OP_SSTORE (…)¶

#define OP_SSTORE (...) EVM_ERROR_UNSUPPORTED_CALL_OPCODE

EVM_CALL_MODE_STATIC¶

#define EVM_CALL_MODE_STATIC 1

EVM_CALL_MODE_DELEGATE¶

#define EVM_CALL_MODE_DELEGATE 2

EVM_CALL_MODE_CALLCODE¶

#define EVM_CALL_MODE_CALLCODE 3

EVM_CALL_MODE_CALL¶

#define EVM_CALL_MODE_CALL 4

evm_state_t¶

the current state of the evm

The enum type contains the following values:

EVM_STATE_INIT	0	just initialised, but not yet started
EVM_STATE_RUNNING	1	started and still running
EVM_STATE_STOPPED	2	successfully stopped
EVM_STATE_REVERTED	3	stopped, but results must be reverted

evm_get_env¶

This function provides data from the enviroment.

depending on the key the function will set the out_data-pointer to the result. This means the enviroment is responsible for memory management and also to clean up resources afterwards.

typedef int(* evm_get_env) (void *evm, uint16_t evm_key, uint8_t *in_data, int in_len, uint8_t **out_data, int offset, int len)

returns: int(*

storage_t¶

The stuct contains following fields:

bytes32_t	key
bytes32_t	value
account_storagestruct , *	next

logs_t¶

The stuct contains following fields:

bytes_t	topics
bytes_t	data
logsstruct , *	next

account_t¶

The stuct contains following fields:

address_t	address
bytes32_t	balance
bytes32_t	nonce
bytes_t	code
storage_t *	storage
accountstruct , *	next

evm_t¶

The stuct contains following fields:

bytes_builder_t	stack
bytes_builder_t	memory
`int`	stack_size
bytes_t	code
`uint32_t`	pos
evm_state_t	state
bytes_t	last_returned
bytes_t	return_data
`uint32_t *`	invalid_jumpdest
`uint32_t`	properties
evm_get_env	env
`void *`	env_ptr
`uint64_t`	chain_id	the chain_id as returned by the opcode
`uint8_t *`	address	the address of the current storage
`uint8_t *`	account	the address of the code
`uint8_t *`	origin	the address of original sender of the root-transaction
`uint8_t *`	caller	the address of the parent sender
bytes_t	call_value	value send
bytes_t	call_data	data send in the tx
bytes_t	gas_price	current gasprice
`uint64_t`	gas
	gas_options

evm_stack_push¶

int evm_stack_push(evm_t *evm, uint8_t *data, uint8_t len);

arguments:

evm_t *	evm
`uint8_t *`	data
`uint8_t`	len

returns: int

evm_stack_push_ref¶

int evm_stack_push_ref(evm_t *evm, uint8_t **dst, uint8_t len);

arguments:

evm_t *	evm
`uint8_t **`	dst
`uint8_t`	len

returns: int

evm_stack_push_int¶

int evm_stack_push_int(evm_t *evm, uint32_t val);

arguments:

evm_t *	evm
`uint32_t`	val

returns: int

evm_stack_push_long¶

int evm_stack_push_long(evm_t *evm, uint64_t val);

arguments:

evm_t *	evm
`uint64_t`	val

returns: int

evm_stack_get_ref¶

int evm_stack_get_ref(evm_t *evm, uint8_t pos, uint8_t **dst);

arguments:

evm_t *	evm
`uint8_t`	pos
`uint8_t **`	dst

returns: int

evm_stack_pop¶

int evm_stack_pop(evm_t *evm, uint8_t *dst, uint8_t len);

arguments:

evm_t *	evm
`uint8_t *`	dst
`uint8_t`	len

returns: int

evm_stack_pop_ref¶

int evm_stack_pop_ref(evm_t *evm, uint8_t **dst);

arguments:

evm_t *	evm
`uint8_t **`	dst

returns: int

evm_stack_pop_byte¶

int evm_stack_pop_byte(evm_t *evm, uint8_t *dst);

arguments:

evm_t *	evm
`uint8_t *`	dst

returns: int

evm_stack_pop_int¶

int32_t evm_stack_pop_int(evm_t *evm);

arguments:

evm

returns: int32_t

evm_stack_peek_len¶

int evm_stack_peek_len(evm_t *evm);

arguments:

evm

returns: int

evm_run¶

int evm_run(evm_t *evm, address_t code_address);

arguments:

evm_t *	evm
address_t	code_address

returns: int

evm_sub_call¶

int evm_sub_call(evm_t *parent, uint8_t address[20], uint8_t account[20], uint8_t *value, wlen_t l_value, uint8_t *data, uint32_t l_data, uint8_t caller[20], uint8_t origin[20], uint64_t gas, wlen_t mode, uint32_t out_offset, uint32_t out_len);

handle internal calls.

arguments:

evm_t *	parent
`uint8_t`	address
`uint8_t`	account
`uint8_t *`	value
wlen_t	l_value
`uint8_t *`	data
`uint32_t`	l_data
`uint8_t`	caller
`uint8_t`	origin
`uint64_t`	gas
wlen_t	mode
`uint32_t`	out_offset
`uint32_t`	out_len

returns: int

evm_ensure_memory¶

int evm_ensure_memory(evm_t *evm, uint32_t max_pos);

arguments:

evm_t *	evm
`uint32_t`	max_pos

returns: int

in3_get_env¶

int in3_get_env(void *evm_ptr, uint16_t evm_key, uint8_t *in_data, int in_len, uint8_t **out_data, int offset, int len);

arguments:

`void *`	evm_ptr
`uint16_t`	evm_key
`uint8_t *`	in_data
`int`	in_len
`uint8_t **`	out_data
`int`	offset
`int`	len

returns: int

evm_call¶

int evm_call(void *vc, uint8_t address[20], uint8_t *value, wlen_t l_value, uint8_t *data, uint32_t l_data, uint8_t caller[20], uint64_t gas, uint64_t chain_id, bytes_t **result);

run a evm-call

arguments:

`void *`	vc
`uint8_t`	address
`uint8_t *`	value
wlen_t	l_value
`uint8_t *`	data
`uint32_t`	l_data
`uint8_t`	caller
`uint64_t`	gas
`uint64_t`	chain_id
bytes_t **	result

returns: int

evm_print_stack¶

void evm_print_stack(evm_t *evm, uint64_t last_gas, uint32_t pos);

arguments:

evm_t *	evm
`uint64_t`	last_gas
`uint32_t`	pos

evm_free¶

void evm_free(evm_t *evm);

arguments:

evm

evm_execute¶

int evm_execute(evm_t *evm);

arguments:

evm

returns: int

gas.h¶

evm gas defines.

File: src/verifier/eth1/evm/gas.h

op_exec (m,gas)¶

#define op_exec (m,gas) return m;

subgas (g)¶

GAS_CC_NET_SSTORE_NOOP_GAS¶

Once per SSTORE operation if the value doesn’t change.

#define GAS_CC_NET_SSTORE_NOOP_GAS 200

GAS_CC_NET_SSTORE_INIT_GAS¶

Once per SSTORE operation from clean zero.

#define GAS_CC_NET_SSTORE_INIT_GAS 20000

GAS_CC_NET_SSTORE_CLEAN_GAS¶

Once per SSTORE operation from clean non-zero.

#define GAS_CC_NET_SSTORE_CLEAN_GAS 5000

GAS_CC_NET_SSTORE_DIRTY_GAS¶

Once per SSTORE operation from dirty.

#define GAS_CC_NET_SSTORE_DIRTY_GAS 200

GAS_CC_NET_SSTORE_CLEAR_REFUND¶

Once per SSTORE operation for clearing an originally existing storage slot.

#define GAS_CC_NET_SSTORE_CLEAR_REFUND 15000

GAS_CC_NET_SSTORE_RESET_REFUND¶

Once per SSTORE operation for resetting to the original non-zero value.

#define GAS_CC_NET_SSTORE_RESET_REFUND 4800

GAS_CC_NET_SSTORE_RESET_CLEAR_REFUND¶

Once per SSTORE operation for resetting to the original zero valuev.

#define GAS_CC_NET_SSTORE_RESET_CLEAR_REFUND 19800

G_ZERO¶

Nothing is paid for operations of the set Wzero.

#define G_ZERO 0

G_JUMPDEST¶

JUMP DEST.

#define G_JUMPDEST 1

G_BASE¶

This is the amount of gas to pay for operations of the set Wbase.

#define G_BASE 2

G_VERY_LOW¶

This is the amount of gas to pay for operations of the set Wverylow.

#define G_VERY_LOW 3

G_LOW¶

This is the amount of gas to pay for operations of the set Wlow.

#define G_LOW 5

G_MID¶

This is the amount of gas to pay for operations of the set Wmid.

#define G_MID 8

G_HIGH¶

This is the amount of gas to pay for operations of the set Whigh.

#define G_HIGH 10

G_EXTCODE¶

This is the amount of gas to pay for operations of the set Wextcode.

#define G_EXTCODE 700

G_BALANCE¶

This is the amount of gas to pay for a BALANCE operation.

#define G_BALANCE 400

G_SLOAD¶

This is paid for an SLOAD operation.

#define G_SLOAD 200

G_SSET¶

This is paid for an SSTORE operation when the storage value is set to non-zero from zero.

#define G_SSET 20000

G_SRESET¶

This is the amount for an SSTORE operation when the storage value’s zeroness remains unchanged or is set to zero.

#define G_SRESET 5000

R_SCLEAR¶

This is the refund given (added into the refund counter) when the storage value is set to zero from non-zero.

#define R_SCLEAR 15000

R_SELFDESTRUCT¶

This is the refund given (added into the refund counter) for self-destructing an account.

#define R_SELFDESTRUCT 24000

G_SELFDESTRUCT¶

This is the amount of gas to pay for a SELFDESTRUCT operation.

#define G_SELFDESTRUCT 5000

G_CREATE¶

This is paid for a CREATE operation.

#define G_CREATE 32000

G_CODEDEPOSIT¶

This is paid per byte for a CREATE operation to succeed in placing code into the state.

#define G_CODEDEPOSIT 200

G_CALL¶

This is paid for a CALL operation.

#define G_CALL 700

G_CALLVALUE¶

This is paid for a non-zero value transfer as part of the CALL operation.

#define G_CALLVALUE 9000

G_CALLSTIPEND¶

This is a stipend for the called contract subtracted from Gcallvalue for a non-zero value transfer.

#define G_CALLSTIPEND 2300

G_NEWACCOUNT¶

This is paid for a CALL or for a SELFDESTRUCT operation which creates an account.

#define G_NEWACCOUNT 25000

G_EXP¶

This is a partial payment for an EXP operation.

#define G_EXP 10

G_EXPBYTE¶

This is a partial payment when multiplied by dlog256(exponent)e for the EXP operation.

#define G_EXPBYTE 50

G_MEMORY¶

This is paid for every additional word when expanding memory.

#define G_MEMORY 3

G_TXCREATE¶

This is paid by all contract-creating transactions after the Homestead transition.

#define G_TXCREATE 32000

G_TXDATA_ZERO¶

This is paid for every zero byte of data or code for a transaction.

#define G_TXDATA_ZERO 4

G_TXDATA_NONZERO¶

This is paid for every non-zero byte of data or code for a transaction.

#define G_TXDATA_NONZERO 68

G_TRANSACTION¶

This is paid for every transaction.

#define G_TRANSACTION 21000

G_LOG¶

This is a partial payment for a LOG operation.

#define G_LOG 375

G_LOGDATA¶

This is paid for each byte in a LOG operation’s data.

#define G_LOGDATA 8

G_LOGTOPIC¶

This is paid for each topic of a LOG operation.

#define G_LOGTOPIC 375

G_SHA3¶

This is paid for each SHA3 operation.

#define G_SHA3 30

G_SHA3WORD¶

This is paid for each word (rounded up) for input data to a SHA3 operation.

#define G_SHA3WORD 6

G_COPY¶

This is a partial payment for *COPY operations, multiplied by the number of words copied, rounded up.

#define G_COPY 3

G_BLOCKHASH¶

This is a payment for a BLOCKHASH operation.

#define G_BLOCKHASH 20

G_PRE_EC_RECOVER¶

Precompile EC RECOVER.

#define G_PRE_EC_RECOVER 3000

G_PRE_SHA256¶

Precompile SHA256.

#define G_PRE_SHA256 60

G_PRE_SHA256_WORD¶

Precompile SHA256 per word.

#define G_PRE_SHA256_WORD 12

G_PRE_RIPEMD160¶

Precompile RIPEMD160.

#define G_PRE_RIPEMD160 600

G_PRE_RIPEMD160_WORD¶

Precompile RIPEMD160 per word.

#define G_PRE_RIPEMD160_WORD 120

G_PRE_IDENTITY¶

Precompile IDENTIY (copyies data)

#define G_PRE_IDENTITY 15

G_PRE_IDENTITY_WORD¶

Precompile IDENTIY per word.

#define G_PRE_IDENTITY_WORD 3

G_PRE_MODEXP_GQUAD_DIVISOR¶

Gquaddivisor from modexp precompile for gas calculation.

#define G_PRE_MODEXP_GQUAD_DIVISOR 20

G_PRE_ECADD¶

Gas costs for curve addition precompile.

#define G_PRE_ECADD 500

G_PRE_ECMUL¶

Gas costs for curve multiplication precompile.

#define G_PRE_ECMUL 40000

G_PRE_ECPAIRING¶

Base gas costs for curve pairing precompile.

#define G_PRE_ECPAIRING 100000

G_PRE_ECPAIRING_WORD¶

Gas costs regarding curve pairing precompile input length.

#define G_PRE_ECPAIRING_WORD 80000

EVM_STACK_LIMIT¶

max elements of the stack

#define EVM_STACK_LIMIT 1024

EVM_MAX_CODE_SIZE¶

max size of the code

#define EVM_MAX_CODE_SIZE 24576

FRONTIER_G_EXPBYTE¶

fork values

This is a partial payment when multiplied by dlog256(exponent)e for the EXP operation.

#define FRONTIER_G_EXPBYTE 10

FRONTIER_G_SLOAD¶

This is a partial payment when multiplied by dlog256(exponent)e for the EXP operation.

#define FRONTIER_G_SLOAD 50

FREE_EVM (…)¶

INIT_EVM (…)¶

INIT_GAS (…)¶

SUBGAS (…)¶

FINALIZE_SUBCALL_GAS (…)¶

UPDATE_SUBCALL_GAS (…)¶

FINALIZE_AND_REFUND_GAS (…)¶

KEEP_TRACK_GAS (evm)¶

#define KEEP_TRACK_GAS (evm) 0

SELFDESTRUCT_GAS (evm,g)¶

#define SELFDESTRUCT_GAS (evm,g) EVM_ERROR_UNSUPPORTED_CALL_OPCODE

UPDATE_ACCOUNT_CODE (…)¶

Module verifier/eth1/full¶

eth_full.h¶

Ethereum Nanon verification.

File: src/verifier/eth1/full/eth_full.h

in3_verify_eth_full¶

int in3_verify_eth_full(in3_vctx_t *v);

entry-function to execute the verification context.

arguments:

v

returns: int

in3_register_eth_full¶

void in3_register_eth_full();

this function should only be called once and will register the eth-full verifier.

Module verifier/eth1/nano¶

chainspec.h¶

Ethereum chain specification

File: src/verifier/eth1/nano/chainspec.h

BLOCK_LATEST¶

#define BLOCK_LATEST 0xFFFFFFFFFFFFFFFF

eip_transition_t¶

The stuct contains following fields:

`uint64_t`	transition_block
`eip_t`	eips

consensus_transition_t¶

The stuct contains following fields:

`uint64_t`	transition_block
eth_consensus_type_t	type
bytes_t	validators
`uint8_t *`	contract

chainspec_t¶

The stuct contains following fields:

`uint64_t`	network_id
`uint64_t`	account_start_nonce
`uint32_t`	eip_transitions_len
eip_transition_t *	eip_transitions
`uint32_t`	consensus_transitions_len
consensus_transition_t *	consensus_transitions

attribute¶

struct __attribute__((__packed__)) eip_;

defines the flags for the current activated EIPs.

Since it does not make sense to support a evm defined before Homestead, homestead EIP is always turned on!

< REVERT instruction

< Bitwise shifting instructions in EVM

< Gas cost changes for IO-heavy operations

< Simple replay attack protection

< EXP cost increase

< Contract code size limit

< Precompiled contracts for addition and scalar multiplication on the elliptic curve alt_bn128

< Precompiled contracts for optimal ate pairing check on the elliptic curve alt_bn128

< Big integer modular exponentiation

< New opcodes: RETURNDATASIZE and RETURNDATACOPY

< New opcode STATICCALL

< Embedding transaction status code in receipts

< Skinny CREATE2

< EXTCODEHASH opcode

< Net gas metering for SSTORE without dirty maps

arguments:

`(packed)`¶

returns: struct

chainspec_create_from_json¶

chainspec_t* chainspec_create_from_json(d_token_t *data);

arguments:

data

returns: chainspec_t *

chainspec_get_eip¶

eip_t chainspec_get_eip(chainspec_t *spec, uint64_t block_number);

arguments:

chainspec_t *	spec
`uint64_t`	block_number

returns: eip_t

chainspec_get_consensus¶

consensus_transition_t* chainspec_get_consensus(chainspec_t *spec, uint64_t block_number);

arguments:

chainspec_t *	spec
`uint64_t`	block_number

returns: consensus_transition_t *

chainspec_to_bin¶

in3_ret_t chainspec_to_bin(chainspec_t *spec, bytes_builder_t *bb);

arguments:

chainspec_t *	spec
bytes_builder_t *	bb

returns: in3_ret_t the result-status of the function.

Please make sure you check if it was successfull (==IN3_OK)

chainspec_from_bin¶

chainspec_t* chainspec_from_bin(void *raw);

arguments:

void * raw

returns: chainspec_t *

chainspec_get¶

chainspec_t* chainspec_get(chain_id_t chain_id);

arguments:

chain_id_t

chain_id

returns: chainspec_t *

chainspec_put¶

void chainspec_put(chain_id_t chain_id, chainspec_t *spec);

arguments:

chain_id_t	chain_id
chainspec_t *	spec

eth_nano.h¶

Ethereum Nanon verification.

File: src/verifier/eth1/nano/eth_nano.h

in3_verify_eth_nano¶

in3_ret_t in3_verify_eth_nano(in3_vctx_t *v);

entry-function to execute the verification context.

arguments:

v

returns: in3_ret_t the result-status of the function.

Please make sure you check if it was successfull (==IN3_OK)

eth_verify_blockheader¶

in3_ret_t eth_verify_blockheader(in3_vctx_t *vc, bytes_t *header, bytes_t *expected_blockhash);

verifies a blockheader.

arguments:

in3_vctx_t *	vc
bytes_t *	header
bytes_t *	expected_blockhash

returns: in3_ret_t the result-status of the function.

Please make sure you check if it was successfull (==IN3_OK)

eth_verify_signature¶

int eth_verify_signature(in3_vctx_t *vc, bytes_t *msg_hash, d_token_t *sig);

verifies a single signature blockheader.

This function will return a positive integer with a bitmask holding the bit set according to the address that signed it. This is based on the signatiures in the request-config.

arguments:

in3_vctx_t *	vc
bytes_t *	msg_hash
d_token_t *	sig

returns: int

ecrecover_signature¶

bytes_t* ecrecover_signature(bytes_t *msg_hash, d_token_t *sig);

returns the address of the signature if the msg_hash is correct

arguments:

bytes_t *	msg_hash
d_token_t *	sig

returns: bytes_t *

eth_verify_eth_getTransactionReceipt¶

in3_ret_t eth_verify_eth_getTransactionReceipt(in3_vctx_t *vc, bytes_t *tx_hash);

verifies a transaction receipt.

arguments:

in3_vctx_t *	vc
bytes_t *	tx_hash

returns: in3_ret_t the result-status of the function.

Please make sure you check if it was successfull (==IN3_OK)

eth_verify_in3_nodelist¶

in3_ret_t eth_verify_in3_nodelist(in3_vctx_t *vc, uint32_t node_limit, bytes_t *seed, d_token_t *required_addresses);

verifies the nodelist.

arguments:

in3_vctx_t *	vc
`uint32_t`	node_limit
bytes_t *	seed
d_token_t *	required_addresses

returns: in3_ret_t the result-status of the function.

Please make sure you check if it was successfull (==IN3_OK)

eth_verify_in3_whitelist¶

in3_ret_t eth_verify_in3_whitelist(in3_vctx_t *vc);

verifies the nodelist.

arguments:

vc

returns: in3_ret_t the result-status of the function.

Please make sure you check if it was successfull (==IN3_OK)

in3_register_eth_nano¶

void in3_register_eth_nano();

this function should only be called once and will register the eth-nano verifier.

create_tx_path¶

bytes_t* create_tx_path(uint32_t index);

helper function to rlp-encode the transaction_index.

The result must be freed after use!

arguments:

uint32_t index

returns: bytes_t *

merkle.h¶

Merkle Proof Verification.

File: src/verifier/eth1/nano/merkle.h

MERKLE_DEPTH_MAX¶

#define MERKLE_DEPTH_MAX 64

trie_verify_proof¶

int trie_verify_proof(bytes_t *rootHash, bytes_t *path, bytes_t **proof, bytes_t *expectedValue);

verifies a merkle proof.

expectedValue == NULL : value must not exist expectedValue.data ==NULL : please copy the data I want to evaluate it afterwards. expectedValue.data !=NULL : the value must match the data.

arguments:

bytes_t *	rootHash
bytes_t *	path
bytes_t **	proof
bytes_t *	expectedValue

returns: int

trie_path_to_nibbles¶

uint8_t* trie_path_to_nibbles(bytes_t path, int use_prefix);

helper function split a path into 4-bit nibbles.

The result must be freed after use!

arguments:

bytes_t	path
`int`	use_prefix

returns: uint8_t * : the resulting bytes represent a 4bit-number each and are terminated with a 0xFF.

trie_matching_nibbles¶

int trie_matching_nibbles(uint8_t *a, uint8_t *b);

helper function to find the number of nibbles matching both paths.

arguments:

`uint8_t *`	a
`uint8_t *`	b

returns: int

trie_free_proof¶

void trie_free_proof(bytes_t **proof);

used to free the NULL-terminated proof-array.

arguments:

bytes_t **

proof

rlp.h¶

RLP-En/Decoding as described in the Ethereum RLP-Spec.

This decoding works without allocating new memory.

File: src/verifier/eth1/nano/rlp.h

rlp_decode¶

int rlp_decode(bytes_t *b, int index, bytes_t *dst);

this function decodes the given bytes and returns the element with the given index by updating the reference of dst.

the bytes will only hold references and do not need to be freed!

bytes_t* tx_raw = serialize_tx(tx);

bytes_t item;

// decodes the tx_raw by letting the item point to range of the first element, which should be the body of a list.
if (rlp_decode(tx_raw, 0, &item) !=2) return -1 ;

// now decode the 4th element (which is the value) and let item point to that range.
if (rlp_decode(&item, 4, &item) !=1) return -1 ;

arguments:

bytes_t *	b
`int`	index
bytes_t *	dst

returns: int : - 0 : means item out of range

1 : item found
2 : list found ( you can then decode the same bytes again)

rlp_decode_in_list¶

int rlp_decode_in_list(bytes_t *b, int index, bytes_t *dst);

this function expects a list item (like the blockheader as first item and will then find the item within this list).

It is a shortcut for

// decode the list
if (rlp_decode(b,0,dst)!=2) return 0;
// and the decode the item
return rlp_decode(dst,index,dst);

arguments:

bytes_t *	b
`int`	index
bytes_t *	dst

returns: int : - 0 : means item out of range

1 : item found
2 : list found ( you can then decode the same bytes again)

rlp_decode_len¶

int rlp_decode_len(bytes_t *b);

returns the number of elements found in the data.

arguments:

bytes_t *

b

returns: int

rlp_encode_item¶

void rlp_encode_item(bytes_builder_t *bb, bytes_t *val);

encode a item as single string and add it to the bytes_builder.

arguments:

bytes_builder_t *	bb
bytes_t *	val

rlp_encode_list¶

void rlp_encode_list(bytes_builder_t *bb, bytes_t *val);

encode a the value as list of already encoded items.

arguments:

bytes_builder_t *	bb
bytes_t *	val

rlp_encode_to_list¶

bytes_builder_t* rlp_encode_to_list(bytes_builder_t *bb);

converts the data in the builder to a list.

This function is optimized to not increase the memory more than needed and is fastet than creating a second builder to encode the data.

arguments:

bb

returns: bytes_builder_t * : the same builder.

rlp_encode_to_item¶

bytes_builder_t* rlp_encode_to_item(bytes_builder_t *bb);

converts the data in the builder to a rlp-encoded item.

This function is optimized to not increase the memory more than needed and is fastet than creating a second builder to encode the data.

arguments:

bb

returns: bytes_builder_t * : the same builder.

rlp_add_length¶

void rlp_add_length(bytes_builder_t *bb, uint32_t len, uint8_t offset);

helper to encode the prefix for a value

arguments:

bytes_builder_t *	bb
`uint32_t`	len
`uint8_t`	offset

serialize.h¶

serialization of ETH-Objects.

This incoming tokens will represent their values as properties based on JSON-RPC.

File: src/verifier/eth1/nano/serialize.h

BLOCKHEADER_PARENT_HASH¶

#define BLOCKHEADER_PARENT_HASH 0

BLOCKHEADER_SHA3_UNCLES¶

#define BLOCKHEADER_SHA3_UNCLES 1

BLOCKHEADER_MINER¶

#define BLOCKHEADER_MINER 2

BLOCKHEADER_STATE_ROOT¶

#define BLOCKHEADER_STATE_ROOT 3

BLOCKHEADER_TRANSACTIONS_ROOT¶

#define BLOCKHEADER_TRANSACTIONS_ROOT 4

BLOCKHEADER_RECEIPT_ROOT¶

#define BLOCKHEADER_RECEIPT_ROOT 5

BLOCKHEADER_LOGS_BLOOM¶

#define BLOCKHEADER_LOGS_BLOOM 6

BLOCKHEADER_DIFFICULTY¶

#define BLOCKHEADER_DIFFICULTY 7

BLOCKHEADER_NUMBER¶

#define BLOCKHEADER_NUMBER 8

BLOCKHEADER_GAS_LIMIT¶

#define BLOCKHEADER_GAS_LIMIT 9

BLOCKHEADER_GAS_USED¶

#define BLOCKHEADER_GAS_USED 10

BLOCKHEADER_TIMESTAMP¶

#define BLOCKHEADER_TIMESTAMP 11

BLOCKHEADER_EXTRA_DATA¶

#define BLOCKHEADER_EXTRA_DATA 12

BLOCKHEADER_SEALED_FIELD1¶

#define BLOCKHEADER_SEALED_FIELD1 13

BLOCKHEADER_SEALED_FIELD2¶

#define BLOCKHEADER_SEALED_FIELD2 14

BLOCKHEADER_SEALED_FIELD3¶

#define BLOCKHEADER_SEALED_FIELD3 15

serialize_tx_receipt¶

bytes_t* serialize_tx_receipt(d_token_t *receipt);

creates rlp-encoded raw bytes for a receipt.

The bytes must be freed with b_free after use!

arguments:

receipt

returns: bytes_t *

serialize_tx¶

bytes_t* serialize_tx(d_token_t *tx);

creates rlp-encoded raw bytes for a transaction.

The bytes must be freed with b_free after use!

arguments:

tx

returns: bytes_t *

serialize_tx_raw¶

bytes_t* serialize_tx_raw(bytes_t nonce, bytes_t gas_price, bytes_t gas_limit, bytes_t to, bytes_t value, bytes_t data, uint64_t v, bytes_t r, bytes_t s);

creates rlp-encoded raw bytes for a transaction from direct values.

The bytes must be freed with b_free after use!

arguments:

bytes_t	nonce
bytes_t	gas_price
bytes_t	gas_limit
bytes_t	to
bytes_t	value
bytes_t	data
`uint64_t`	v
bytes_t	r
bytes_t	s

returns: bytes_t *

serialize_account¶

bytes_t* serialize_account(d_token_t *a);

creates rlp-encoded raw bytes for a account.

The bytes must be freed with b_free after use!

arguments:

a

returns: bytes_t *

serialize_block_header¶

bytes_t* serialize_block_header(d_token_t *block);

creates rlp-encoded raw bytes for a blockheader.

The bytes must be freed with b_free after use!

arguments:

block

returns: bytes_t *

rlp_add¶

int rlp_add(bytes_builder_t *rlp, d_token_t *t, int ml);

adds the value represented by the token rlp-encoded to the byte_builder.

arguments:

bytes_builder_t *	rlp
d_token_t *	t
`int`	ml

returns: int : 0 if added -1 if the value could not be handled.

API Reference TS¶

This page contains a list of all Datastructures and Classes used within the TypeScript IN3 Client.

Examples¶

This is a collection of different incubed-examples.

using Web3¶

Since incubed works with on a JSON-RPC-Level it can easily be used as Provider for Web3:

// import in3-Module
import In3Client from 'in3'
import * as web3 from 'web3'

// use the In3Client as Http-Provider
const web3 = new Web3(new In3Client({
    proof         : 'standard',
    signatureCount: 1,
    requestCount  : 2,
    chainId       : 'mainnet'
}).createWeb3Provider())

// use the web3
const block = await web.eth.getBlockByNumber('latest')
...

using Incubed API¶

Incubed includes a light API, allowinng not only to use all RPC-Methods in a typesafe way, but also to sign transactions and call funnctions of a contract without the web3-library.

For more details see the API-Doc

// import in3-Module
import In3Client from 'in3'

// use the In3Client
const in3 = new In3Client({
    proof         : 'standard',
    signatureCount: 1,
    requestCount  : 2,
    chainId       : 'mainnet'
})

// use the api to call a funnction..
const myBalance = await in3.eth.callFn(myTokenContract, 'balanceOf(address):uint', myAccount)

// ot to send a transaction..
const receipt = await in3.eth.sendTransaction({ 
  to           : myTokenContract, 
  method       : 'transfer(address,uint256)',
  args         : [target,amount],
  confirmations: 2,
  pk           : myKey
})

...

Reading event with incubed¶

// import in3-Module
import In3Client from 'in3'

// use the In3Client
const in3 = new In3Client({
    proof         : 'standard',
    signatureCount: 1,
    requestCount  : 2,
    chainId       : 'mainnet'
})

// use the ABI-String of the smart contract
abi = [{"anonymous":false,"inputs":[{"indexed":false,"name":"name","type":"string"},{"indexed":true,"name":"label","type":"bytes32"},{"indexed":true,"name":"owner","type":"address"},{"indexed":false,"name":"cost","type":"uint256"},{"indexed":false,"name":"expires","type":"uint256"}],"name":"NameRegistered","type":"event"}]

// create a contract-object for a given address
const contract = in3.eth.contractAt(abi, '0xF0AD5cAd05e10572EfcEB849f6Ff0c68f9700455') // ENS contract.

// read all events starting from a specified block until the latest
const logs = await c.events.NameRegistered.getLogs({fromBlock:8022948})) 

// print out the properties of the event.
for (const ev of logs) 
  console.log(`${ev.owner} registered ${ev.name} for ${ev.cost} wei until ${new Date(ev.expires.toNumber()*1000).toString()}`)

...

Main Module¶

Importing incubed is as easy as

import Client,{util} from "in3"

While the In3Client-class is the default import, the following imports can be used:

Type

ABI

the ABI

Interface

AccountProof

the AccountProof

Interface

AuraValidatoryProof

the AuraValidatoryProof

Type

BlockData

the BlockData

Type

BlockType

the BlockType

Interface

ChainSpec

the ChainSpec

Class

IN3Client

the IN3Client

Interface

IN3Config

the IN3Config

Interface

IN3NodeConfig

the IN3NodeConfig

Interface

IN3NodeWeight

the IN3NodeWeight

Interface

IN3RPCConfig

the IN3RPCConfig

Interface

IN3RPCHandlerConfig

the IN3RPCHandlerConfig

Interface

IN3RPCRequestConfig

the IN3RPCRequestConfig

Interface

IN3ResponseConfig

the IN3ResponseConfig

Type

Log

the Log

Type

LogData

the LogData

Interface

LogProof

the LogProof

Interface

Proof

the Proof

Interface

RPCRequest

the RPCRequest

Interface

RPCResponse

the RPCResponse

Type

ReceiptData

the ReceiptData

Interface

ServerList

the ServerList

Interface

Signature

the Signature

Type

Transaction

the Transaction

Type

TransactionData

the TransactionData

Type

TransactionReceipt

the TransactionReceipt

Type

Transport

the Transport

any

AxiosTransport

the AxiosTransport

value= transport.AxiosTransport

EthAPI

EthAPI

the EthAPI

value= _ethapi.default

any

cbor

the cbor

value= _cbor

chainAliases

the chainAliases

value= aliases

chainData

chainData

the chainData

value= _chainData

number []

createRandomIndexes (

len:number,

limit:number,

seed:Buffer ,

result:number [])

helper function creating deterministic random indexes used for limited nodelists

header

header

the header

value= _header

serialize

serialize

the serialize

value= _serialize

any

storage

the storage

value= _storage

any

transport

the transport

value= _transport

typeDefs

the typeDefs

value= types.validationDef

any

util

the util

value= _util

any

validate

the validate

value= validateOb.validate

Package client¶

Type Client¶

Source: client/Client.ts

Client for N3.

number

defaultMaxListeners

the defaultMaxListeners

number

listenerCount (

emitter:EventEmitter ,

event:string

| symbol)

listener count

Client

constructor (

config:Partial<IN3Config> ,

transport:Transport )

creates a new Client.

IN3Config

defConfig

the defConfig

EthAPI

eth

the eth

IpfsAPI

ipfs

the ipfs

IN3Config

config

config

this

addListener (

event:string

| symbol,

listener:)

add listener

Promise<any>

call (

method:string,

params:any,

chain:string,

config:Partial<IN3Config> )

sends a simply RPC-Request

void

clearStats ()

clears all stats and weights, like blocklisted nodes

any

createWeb3Provider ()

create web3 provider

boolean

emit (

event:string

| symbol,

args:any [])

emit

Array<>

eventNames ()

event names

ChainContext

getChainContext (

chainId:string)

Context for a specific chain including cache and chainSpecs.

number

getMaxListeners ()

get max listeners

number

listenerCount (

type:string

| symbol)

listener count

Function []

listeners (

event:string

| symbol)

listeners

this

off (

event:string

| symbol,

listener:)

off

this

on (

event:string

| symbol,

listener:)

on

this

once (

event:string

| symbol,

listener:)

once

this

prependListener (

event:string

| symbol,

listener:)

prepend listener

this

prependOnceListener (

event:string

| symbol,

listener:)

prepend once listener

Function []

rawListeners (

event:string

| symbol)

raw listeners

this

removeAllListeners (

event:string

| symbol)

remove all listeners

this

removeListener (

event:string

| symbol,

listener:)

remove listener

Promise<>

send (

request:RPCRequest []

| RPCRequest ,

callback:,

config:Partial<IN3Config> )

sends one or a multiple requests.

if the request is a array the response will be a array as well.

If the callback is given it will be called with the response, if not a Promise will be returned.

This function supports callback so it can be used as a Provider for the web3.

Promise<RPCResponse>

sendRPC (

method:string,

params:any [],

chain:string,

config:Partial<IN3Config> )

sends a simply RPC-Request

this

setMaxListeners (

n:number)

set max listeners

Promise<void>

updateNodeList (

chainId:string,

conf:Partial<IN3Config> ,

retryCount:number)

fetches the nodeList from the servers.

Promise<void>

updateWhiteListNodes (

config:IN3Config )

update white list nodes

Promise<boolean>

verifyResponse (

request:RPCRequest ,

response:RPCResponse ,

chain:string,

config:Partial<IN3Config> )

Verify the response of a request without any effect on the state of the client.

Note: The node-list will not be updated.

The method will either return true if its inputs could be verified.

Or else, it will throw an exception with a helpful message.

Type ChainContext¶

Source: client/ChainContext.ts

Context for a specific chain including cache and chainSpecs.

ChainContext

constructor (

client:Client ,

chainId:string,

chainSpec:ChainSpec [])

Context for a specific chain including cache and chainSpecs.

string

chainId

the chainId

ChainSpec []

chainSpec

the chainSpec

Client

client

the client

genericCache

the genericCache

number

lastValidatorChange

the lastValidatorChange

Module

module

the module

string

registryId

the registryId (optional)

void

clearCache (

prefix:string)

clear cache

ChainSpec

getChainSpec (

block:number)

returns the chainspec for th given block number

string

getFromCache (

key:string)

get from cache

Promise<RPCResponse>

handleIntern (

request:RPCRequest )

this function is calleds before the server is asked.

If it returns a promise than the request is handled internally otherwise the server will handle the response.

this function should be overriden by modules that want to handle calls internally

void

initCache ()

init cache

void

putInCache (

key:string,

value:string)

put in cache

void

updateCache (

whiteList:Set<string> ,

whiteListContract:string)

update cache

Type Module¶

Source: client/modules.ts

string

name

the name

ChainContext

createChainContext (

client:Client ,

chainId:string,

spec:ChainSpec [])

Context for a specific chain including cache and chainSpecs.

Promise<boolean>

verifyProof (

request:RPCRequest ,

response:RPCResponse ,

allowWithoutProof:boolean,

ctx:ChainContext )

general verification-function which handles it according to its given type.

Package index.ts¶

Type AccountProof¶

Source: index.ts

the Proof-for a single Account the Proof-for a single Account

string []

accountProof

the serialized merle-noodes beginning with the root-node

string

address

the address of this account

string

balance

the balance of this account as hex

string

code

the code of this account as hex ( if required) (optional)

string

codeHash

the codeHash of this account as hex

string

nonce

the nonce of this account as hex

string

storageHash

the storageHash of this account as hex

[]

storageProof

proof for requested storage-data

Type AuraValidatoryProof¶

Source: index.ts

a Object holding proofs for validator logs. The key is the blockNumber as hex a Object holding proofs for validator logs. The key is the blockNumber as hex

string

block

the serialized blockheader

example: 0x72804cfa0179d648ccbe6a65b01a6463a8f1ebb14f3aff6b19cb91acf2b8ec1ffee98c0437b4ac839d8a2ece1b18166da704b86d8f42c92bbda6463a8f1ebb14f3aff6b19cb91acf2b8ec1ffee98c0437b4ac839d8a2ece1b18166da704b

any []

finalityBlocks

the serialized blockheader as hex, required in case of finality asked

example: 0x72804cfa0179d648ccbe6a65b01a6463a8f1ebb14f3aff6b19cb91acf2b8ec1ffee98c0437b4ac839d8a2ece1b18166da704b86d8f42c92bbda6463a8f1ebb14f3aff6b19cb91acf2b8ec1ffee98c0437b4ac839d8a2ece1b18166da704b (optional)

number

logIndex

the transaction log index

string []

proof

the merkleProof

number

txIndex

the transactionIndex within the block

Type ChainSpec¶

Source: index.ts

describes the chainspecific consensus params describes the chainspecific consensus params

number

block

the blocknumnber when this configuration should apply (optional)

number

bypassFinality

Bypass finality check for transition to contract based Aura Engines

example: bypassFinality = 10960502 -> will skip the finality check and add the list at block 10960502 (optional)

string

contract

The validator contract at the block (optional)

'ethHash'

| 'authorityRound'

| 'clique'

engine

the engine type (like Ethhash, authorityRound, … ) (optional)

string []

list

The list of validators at the particular block (optional)

boolean

requiresFinality

indicates whether the transition requires a finality check

example: true (optional)

Type IN3Client¶

Source: index.ts

Client for N3. Client for N3.

number

defaultMaxListeners

the defaultMaxListeners

number

listenerCount (

emitter:EventEmitter ,

event:string

| symbol)

listener count

Client

constructor (

config:Partial<IN3Config> ,

transport:Transport )

creates a new Client.

IN3Config

defConfig

the defConfig

EthAPI

eth

the eth

IpfsAPI

ipfs

the ipfs

IN3Config

config

config

this

addListener (

event:string

| symbol,

listener:)

add listener

Promise<any>

call (

method:string,

params:any,

chain:string,

config:Partial<IN3Config> )

sends a simply RPC-Request

void

clearStats ()

clears all stats and weights, like blocklisted nodes

any

createWeb3Provider ()

create web3 provider

boolean

emit (

event:string

| symbol,

args:any [])

emit

Array<>

eventNames ()

event names

ChainContext

getChainContext (

chainId:string)

Context for a specific chain including cache and chainSpecs.

number

getMaxListeners ()

get max listeners

number

listenerCount (

type:string

| symbol)

listener count

Function []

listeners (

event:string

| symbol)

listeners

this

off (

event:string

| symbol,

listener:)

off

this

on (

event:string

| symbol,

listener:)

on

this

once (

event:string

| symbol,

listener:)

once

this

prependListener (

event:string

| symbol,

listener:)

prepend listener

this

prependOnceListener (

event:string

| symbol,

listener:)

prepend once listener

Function []

rawListeners (

event:string

| symbol)

raw listeners

this

removeAllListeners (

event:string

| symbol)

remove all listeners

this

removeListener (

event:string

| symbol,

listener:)

remove listener

Promise<>

send (

request:RPCRequest []

| RPCRequest ,

callback:,

config:Partial<IN3Config> )

sends one or a multiple requests.

if the request is a array the response will be a array as well.

If the callback is given it will be called with the response, if not a Promise will be returned.

This function supports callback so it can be used as a Provider for the web3.

Promise<RPCResponse>

sendRPC (

method:string,

params:any [],

chain:string,

config:Partial<IN3Config> )

sends a simply RPC-Request

this

setMaxListeners (

n:number)

set max listeners

Promise<void>

updateNodeList (

chainId:string,

conf:Partial<IN3Config> ,

retryCount:number)

fetches the nodeList from the servers.

Promise<void>

updateWhiteListNodes (

config:IN3Config )

update white list nodes

Promise<boolean>

verifyResponse (

request:RPCRequest ,

response:RPCResponse ,

chain:string,

config:Partial<IN3Config> )

Verify the response of a request without any effect on the state of the client.

Note: The node-list will not be updated.

The method will either return true if its inputs could be verified.

Or else, it will throw an exception with a helpful message.

Type IN3Config¶

Source: index.ts

the iguration of the IN3-Client. This can be paritally overriden for every request. the iguration of the IN3-Client. This can be paritally overriden for every request.

boolean

archiveNodes

if true the in3 client will filter out non archive supporting nodes

example: true (optional)

boolean

autoConfig

if true the config will be adjusted depending on the request (optional)

boolean

autoUpdateList

if true the nodelist will be automaticly updated if the lastBlock is newer

example: true (optional)

boolean

binaryNodes

if true the in3 client will only include nodes that support binary encording

example: true (optional)

any

cacheStorage

a cache handler offering 2 functions ( setItem(string,string), getItem(string) ) (optional)

number

cacheTimeout

number of seconds requests can be cached. (optional)

string

chainId

servers to filter for the given chain. The chain-id based on EIP-155.

example: 0x1

string

chainRegistry

main chain-registry contract

example: 0xe36179e2286ef405e929C90ad3E70E649B22a945 (optional)

number

depositTimeout

timeout after which the owner is allowed to receive its stored deposit. This information is also important for the client

example: 3000 (optional)

number

finality

the number in percent needed in order reach finality (% of signature of the validators)

example: 50 (optional)

'json' | 'jsonRef' | 'cbor'

format

the format for sending the data to the client. Default is json, but using cbor means using only 30-40% of the payload since it is using binary encoding

example: json (optional)

boolean

httpNodes

if true the in3 client will include http nodes

example: true (optional)

boolean

includeCode

if true, the request should include the codes of all accounts. otherwise only the the codeHash is returned. In this case the client may ask by calling eth_getCode() afterwards

example: true (optional)

boolean

keepIn3

if true, the in3-section of thr response will be kept. Otherwise it will be removed after validating the data. This is useful for debugging or if the proof should be used afterwards. (optional)

any

key

the client key to sign requests

example: 0x387a8233c96e1fc0ad5e284353276177af2186e7afa85296f106336e376669f7 (optional)

string

loggerUrl

a url of RES-Endpoint, the client will log all errors to. The client will post to this endpoint JSON like { id?, level, message, meta? } (optional)

string

mainChain

main chain-id, where the chain registry is running.

example: 0x1 (optional)

number

maxAttempts

max number of attempts in case a response is rejected

example: 10 (optional)

number

maxBlockCache

number of number of blocks cached in memory

example: 100 (optional)

number

maxCodeCache

number of max bytes used to cache the code in memory

example: 100000 (optional)

number

minDeposit

min stake of the server. Only nodes owning at least this amount will be chosen.

boolean

multichainNodes

if true the in3 client will filter out nodes other then which have capability of the same RPC endpoint may also accept requests for different chains

example: true (optional)

number

nodeLimit

the limit of nodes to store in the client.

example: 150 (optional)

'none' | 'standard' | 'full'

proof

if true the nodes should send a proof of the response

example: true (optional)

boolean

proofNodes

if true the in3 client will filter out nodes which are providing no proof

example: true (optional)

number

replaceLatestBlock

if specified, the blocknumber latest will be replaced by blockNumber- specified value

example: 6 (optional)

number

requestCount

the number of request send when getting a first answer

example: 3

boolean

retryWithoutProof

if true the the request may be handled without proof in case of an error. (use with care!) (optional)

string

rpc

url of one or more rpc-endpoints to use. (list can be comma seperated) (optional)

servers

the nodelist per chain (optional)

number

signatureCount

number of signatures requested

example: 2 (optional)

number

timeout

specifies the number of milliseconds before the request times out. increasing may be helpful if the device uses a slow connection.

example: 3000 (optional)

boolean

torNodes

if true the in3 client will filter out non tor nodes

example: true (optional)

string []

verifiedHashes

if the client sends a array of blockhashes the server will not deliver any signatures or blockheaders for these blocks, but only return a string with a number. This is automaticly updated by the cache, but can be overriden per request. (optional)

string []

whiteList

a list of in3 server addresses which are whitelisted manually by client

example: 0xe36179e2286ef405e929C90ad3E70E649B22a945,0x6d17b34aeaf95fee98c0437b4ac839d8a2ece1b1 (optional)

string

whiteListContract

White list contract address (optional)

Type IN3NodeConfig¶

Source: index.ts

a configuration of a in3-server. a configuration of a in3-server.

string

address

the address of the node, which is the public address it iis signing with.

example: 0x6C1a01C2aB554930A937B0a2E8105fB47946c679

number

capacity

the capacity of the node.

example: 100 (optional)

string []

chainIds

the list of supported chains

example: 0x1

number

deposit

the deposit of the node in wei

example: 12350000

number

index

the index within the contract

example: 13 (optional)

number

props

the properties of the node.

example: 3 (optional)

number

registerTime

the UNIX-timestamp when the node was registered

example: 1563279168 (optional)

number

timeout

the time (in seconds) until an owner is able to receive his deposit back after he unregisters himself

example: 3600 (optional)

number

unregisterTime

the UNIX-timestamp when the node is allowed to be deregister

example: 1563279168 (optional)

string

url

the endpoint to post to

example: https://in3.slock.it

Type IN3NodeWeight¶

Source: index.ts

a local weight of a n3-node. (This is used internally to weight the requests) a local weight of a n3-node. (This is used internally to weight the requests)

number

avgResponseTime

average time of a response in ms

example: 240 (optional)

number

blacklistedUntil

blacklisted because of failed requests until the timestamp

example: 1529074639623 (optional)

number

lastRequest

timestamp of the last request in ms

example: 1529074632623 (optional)

number

pricePerRequest

last price (optional)

number

responseCount

number of uses.

example: 147 (optional)

number

weight

factor the weight this noe (default 1.0)

example: 0.5 (optional)

Type IN3RPCConfig¶

Source: index.ts

the configuration for the rpc-handler the configuration for the rpc-handler

chains

a definition of the Handler per chain (optional)

db

the db (optional)

string

defaultChain

the default chainId in case the request does not contain one. (optional)

string

id

a identifier used in logfiles as also for reading the config from the database (optional)

logging

logger config (optional)

number

port

the listeneing port for the server (optional)

profile

the profile (optional)

Type IN3RPCHandlerConfig¶

Source: index.ts

the configuration for the rpc-handler the configuration for the rpc-handler

autoRegistry

the autoRegistry (optional)

string

clientKeys

a comma sepearted list of client keys to use for simulating clients for the watchdog (optional)

number

freeScore

the score for requests without a valid signature (optional)

'eth' | 'ipfs' | 'btc'

handler

the impl used to handle the calls (optional)

string

ipfsUrl

the url of the ipfs-client (optional)

number

maxThreads

the maximal number of threads ofr running parallel processes (optional)

number

minBlockHeight

the minimal blockheight in order to sign (optional)

string

persistentFile

the filename of the file keeping track of the last handled blocknumber (optional)

string

privateKey

the private key used to sign blockhashes. this can be either a 0x-prefixed string with the raw private key or the path to a key-file.

string

privateKeyPassphrase

the password used to decrpyt the private key (optional)

string

registry

the address of the server registry used in order to update the nodeList

string

registryRPC

the url of the client in case the registry is not on the same chain. (optional)

string

rpcUrl

the url of the client

number

startBlock

blocknumber to start watching the registry (optional)

number

timeout

number of milliseconds to wait before a request gets a timeout (optional)

number

watchInterval

the number of seconds of the interval for checking for new events (optional)

number

watchdogInterval

average time between sending requests to the same node. 0 turns it off (default) (optional)

Type IN3RPCRequestConfig¶

Source: index.ts

additional config for a IN3 RPC-Request additional config for a IN3 RPC-Request

string

chainId

the requested chainId

example: 0x1

any

clientSignature

the signature of the client (optional)

number

finality

if given the server will deliver the blockheaders of the following blocks until at least the number in percent of the validators is reached. (optional)

boolean

includeCode

if true, the request should include the codes of all accounts. otherwise only the the codeHash is returned. In this case the client may ask by calling eth_getCode() afterwards

example: true (optional)

number

latestBlock

if specified, the blocknumber latest will be replaced by blockNumber- specified value

example: 6 (optional)

string []

signatures

a list of addresses requested to sign the blockhash

example: 0x6C1a01C2aB554930A937B0a2E8105fB47946c679 (optional)

boolean

useBinary

if true binary-data will be used. (optional)

boolean

useFullProof

if true all data in the response will be proven, which leads to a higher payload. (optional)

boolean

useRef

if true binary-data (starting with a 0x) will be refered if occuring again. (optional)

'never'

| 'proof'

| 'proofWithSignature'

verification

defines the kind of proof the client is asking for

example: proof (optional)

string []

verifiedHashes

if the client sends a array of blockhashes the server will not deliver any signatures or blockheaders for these blocks, but only return a string with a number. (optional)

string

version

IN3 protocol version that client can specify explicitly in request

example: 1.0.0 (optional)

string

whiteList

address of whitelist contract if added in3 server will register it in watch

and will notify client the whitelist event block number in reponses it depends on cahce settings (optional)

Type IN3ResponseConfig¶

Source: index.ts

additional data returned from a IN3 Server additional data returned from a IN3 Server

number

currentBlock

the current blocknumber.

example: 320126478 (optional)

number

lastNodeList

the blocknumber for the last block updating the nodelist. If the client has a smaller blocknumber he should update the nodeList.

example: 326478 (optional)

number

lastValidatorChange

the blocknumber of the last change of the validatorList (optional)

number

lastWhiteList

The blocknumber of the last white list event (optional)

Proof

proof

the Proof-data (optional)

string

version

IN3 protocol version

example: 1.0.0 (optional)

Type LogProof¶

Source: index.ts

a Object holding proofs for event logs. The key is the blockNumber as hex a Object holding proofs for event logs. The key is the blockNumber as hex

Type Proof¶

Source: index.ts

the Proof-data as part of the in3-section the Proof-data as part of the in3-section

accounts

a map of addresses and their AccountProof (optional)

string

block

the serialized blockheader as hex, required in most proofs

example: 0x72804cfa0179d648ccbe6a65b01a6463a8f1ebb14f3aff6b19cb91acf2b8ec1ffee98c0437b4ac839d8a2ece1b18166da704b86d8f42c92bbda6463a8f1ebb14f3aff6b19cb91acf2b8ec1ffee98c0437b4ac839d8a2ece1b18166da704b (optional)

any []

finalityBlocks

the serialized blockheader as hex, required in case of finality asked

example: 0x72804cfa0179d648ccbe6a65b01a6463a8f1ebb14f3aff6b19cb91acf2b8ec1ffee98c0437b4ac839d8a2ece1b18166da704b86d8f42c92bbda6463a8f1ebb14f3aff6b19cb91acf2b8ec1ffee98c0437b4ac839d8a2ece1b18166da704b (optional)

LogProof

logProof

the Log Proof in case of a Log-Request (optional)

string []

merkleProof

the serialized merle-noodes beginning with the root-node (optional)

string []

merkleProofPrev

the serialized merkle-noodes beginning with the root-node of the previous entry (only for full proof of receipts) (optional)

Signature []

signatures

requested signatures (optional)

any []

transactions

the list of transactions of the block

example: (optional)

number

txIndex

the transactionIndex within the block

example: 4 (optional)

string []

txProof

the serialized merkle-nodes beginning with the root-node in order to prrof the transactionIndex (optional)

'transactionProof'

| 'receiptProof'

| 'blockProof'

| 'accountProof'

| 'callProof'

| 'logProof'

type

the type of the proof

example: accountProof

any []

uncles

the list of uncle-headers of the block

example: (optional)

Type RPCRequest¶

Source: index.ts

a JSONRPC-Request with N3-Extension a JSONRPC-Request with N3-Extension

number | string

id

the identifier of the request

example: 2 (optional)

IN3RPCRequestConfig

in3

the IN3-Config (optional)

'2.0'

jsonrpc

the version

string

method

the method to call

example: eth_getBalance

any []

params

the params

example: 0xe36179e2286ef405e929C90ad3E70E649B22a945,latest (optional)

Type RPCResponse¶

Source: index.ts

a JSONRPC-Responset with N3-Extension a JSONRPC-Responset with N3-Extension

string

error

in case of an error this needs to be set (optional)

string | number

id

the id matching the request

example: 2

IN3ResponseConfig

in3

the IN3-Result (optional)

IN3NodeConfig

in3Node

the node handling this response (internal only) (optional)

'2.0'

jsonrpc

the version

any

result

the params

example: 0xa35bc (optional)

Type ServerList¶

Source: index.ts

a List of nodes a List of nodes

string

contract

IN3 Registry (optional)

number

lastBlockNumber

last Block number (optional)

IN3NodeConfig []

nodes

the list of nodes

Proof

proof

the proof (optional)

string

registryId

registry id of the contract (optional)

number

totalServers

number of servers (optional)

Type Signature¶

Source: index.ts

Verified ECDSA Signature. Signatures are a pair (r, s). Where r is computed as the X coordinate of a point R, modulo the curve order n. Verified ECDSA Signature. Signatures are a pair (r, s). Where r is computed as the X coordinate of a point R, modulo the curve order n.

string

address

the address of the signing node

example: 0x6C1a01C2aB554930A937B0a2E8105fB47946c679 (optional)

number

block

the blocknumber

example: 3123874

string

blockHash

the hash of the block

example: 0x6C1a01C2aB554930A937B0a212346037E8105fB47946c679

string

msgHash

hash of the message

example: 0x9C1a01C2aB554930A937B0a212346037E8105fB47946AB5D

string

r

Positive non-zero Integer signature.r

example: 0x72804cfa0179d648ccbe6a65b01a6463a8f1ebb14f3aff6b19cb91acf2b8ec1f

string

s

Positive non-zero Integer signature.s

example: 0x6d17b34aeaf95fee98c0437b4ac839d8a2ece1b18166da704b86d8f42c92bbda

number

v

Calculated curve point, or identity element O.

example: 28

Type Transport¶

Source: index.ts

= _transporttype

Package modules/eth¶

Type EthAPI¶

Source: modules/eth/api.ts

EthAPI

constructor (

client:Client )

constructor

Client

client

the client

Signer

signer

the signer (optional)

Promise<number>

blockNumber ()

Returns the number of most recent block. (as number)

Promise<string>

call (

tx:Transaction ,

block:BlockType )

Executes a new message call immediately without creating a transaction on the block chain.

Promise<any>

callFn (

to:Address ,

method:string,

args:any [])

Executes a function of a contract, by passing a [method-signature](https://github.com/ethereumjs/ethereumjs-abi/blob/master/README.md#simple-encoding-and-decoding) and the arguments, which will then be ABI-encoded and send as eth_call.

Promise<string>

chainId ()

Returns the EIP155 chain ID used for transaction signing at the current best block. Null is returned if not available.

contractAt (

abi:ABI [],

address:Address )

contract at

any

decodeEventData (

log:Log ,

d:ABI )

decode event data

Promise<number>

estimateGas (

tx:Transaction )

Makes a call or transaction, which won’t be added to the blockchain and returns the used gas, which can be used for estimating the used gas.

Promise<number>

gasPrice ()

Returns the current price per gas in wei. (as number)

Promise<BN>

getBalance (

address:Address ,

block:BlockType )

Returns the balance of the account of given address in wei (as hex).

Promise<Block>

getBlockByHash (

hash:Hash ,

includeTransactions:boolean)

Returns information about a block by hash.

Promise<Block>

getBlockByNumber (

block:BlockType ,

includeTransactions:boolean)

Returns information about a block by block number.

Promise<number>

getBlockTransactionCountByHash (

block:Hash )

Returns the number of transactions in a block from a block matching the given block hash.

Promise<number>

getBlockTransactionCountByNumber (

block:Hash )

Returns the number of transactions in a block from a block matching the given block number.

Promise<string>

getCode (

address:Address ,

block:BlockType )

Returns code at a given address.

Promise<>

getFilterChanges (

id:Quantity )

Polling method for a filter, which returns an array of logs which occurred since last poll.

Promise<>

getFilterLogs (

id:Quantity )

Returns an array of all logs matching filter with given id.

Promise<>

getLogs (

filter:LogFilter )

Returns an array of all logs matching a given filter object.

Promise<string>

getStorageAt (

address:Address ,

pos:Quantity ,

block:BlockType )

Returns the value from a storage position at a given address.

Promise<TransactionDetail>

getTransactionByBlockHashAndIndex (

hash:Hash ,

pos:Quantity )

Returns information about a transaction by block hash and transaction index position.

Promise<TransactionDetail>

getTransactionByBlockNumberAndIndex (

block:BlockType ,

pos:Quantity )

Returns information about a transaction by block number and transaction index position.

Promise<TransactionDetail>

getTransactionByHash (

hash:Hash )

Returns the information about a transaction requested by transaction hash.

Promise<number>

getTransactionCount (

address:Address ,

block:BlockType )

Returns the number of transactions sent from an address. (as number)

Promise<TransactionReceipt>

getTransactionReceipt (

hash:Hash )

Returns the receipt of a transaction by transaction hash.

Note That the receipt is available even for pending transactions.

Promise<Block>

getUncleByBlockHashAndIndex (

hash:Hash ,

pos:Quantity )

Returns information about a uncle of a block by hash and uncle index position.

Note: An uncle doesn’t contain individual transactions.

Promise<Block>

getUncleByBlockNumberAndIndex (

block:BlockType ,

pos:Quantity )

Returns information about a uncle of a block number and uncle index position.

Note: An uncle doesn’t contain individual transactions.

Promise<number>

getUncleCountByBlockHash (

hash:Hash )

Returns the number of uncles in a block from a block matching the given block hash.

Promise<number>

getUncleCountByBlockNumber (

block:BlockType )

Returns the number of uncles in a block from a block matching the given block hash.

Buffer

hashMessage (

data:Data

| Buffer )

hash message

Promise<string>

newBlockFilter ()

Creates a filter in the node, to notify when a new block arrives. To check if the state has changed, call eth_getFilterChanges.

Promise<string>

newFilter (

filter:LogFilter )

Creates a filter object, based on filter options, to notify when the state changes (logs). To check if the state has changed, call eth_getFilterChanges.

Promise<string>

newPendingTransactionFilter ()

Creates a filter in the node, to notify when new pending transactions arrive.

Promise<string>

protocolVersion ()

Returns the current ethereum protocol version.

Promise<string>

sendRawTransaction (

data:Data )

Creates new message call transaction or a contract creation for signed transactions.

Promise<>

sendTransaction (

args:TxRequest )

sends a Transaction

Promise<Signature>

sign (

account:Address ,

data:Data )

signs any kind of message using the x19Ethereum Signed Message:n-prefix

Promise<>

syncing ()

Returns the current ethereum protocol version.

Promise<Quantity>

uninstallFilter (

id:Quantity )

Uninstalls a filter with given id. Should always be called when watch is no longer needed. Additonally Filters timeout when they aren’t requested with eth_getFilterChanges for a period of time.

Type chainData¶

Source: modules/eth/chainData.ts

Promise<any>

callContract (

client:Client ,

contract:string,

chainId:string,

signature:string,

args:any [],

config:IN3Config )

call contract

Promise<>

getChainData (

client:Client ,

chainId:string,

config:IN3Config )

get chain data

Type header¶

Source: modules/eth/header.ts

Interface

AuthSpec

Authority specification for proof of authority chains

Interface

HistoryEntry

the HistoryEntry

Promise<void>

addAuraValidators (

history:DeltaHistory<string> ,

ctx:ChainContext ,

states:HistoryEntry [],

contract:string)

add aura validators

void

addCliqueValidators (

history:DeltaHistory<string> ,

ctx:ChainContext ,

states:HistoryEntry [])

add clique validators

Promise<number>

checkBlockSignatures (

blockHeaders:any [],

getChainSpec:)

verify a Blockheader and returns the percentage of finality

void

checkForFinality (

stateBlockNumber:number,

proof:AuraValidatoryProof ,

current:Buffer [],

_finality:number)

check for finality

Promise<void>

checkForValidators (

ctx:ChainContext ,

validators:DeltaHistory<string> )

check for validators

Promise<AuthSpec>

getChainSpec (

b:Block ,

ctx:ChainContext )

get chain spec

Buffer

getCliqueSigner (

data:Block )

get clique signer

Buffer

getSigner (

data:Block )

get signer

Type Signer¶

Source: modules/eth/api.ts

Promise<Transaction>

prepareTransaction (

client:Client ,

tx:Transaction )

optiional method which allows to change the transaction-data before sending it. This can be used for redirecting it through a multisig.

Promise<Signature>

sign (

data:Buffer ,

account:Address )

signing of any data.

Promise<boolean>

hasAccount (

account:Address )

returns true if the account is supported (or unlocked)

Type Transaction¶

Source: modules/eth/api.ts

any

chainId

optional chain id (optional)

string

data

4 byte hash of the method signature followed by encoded parameters. For details see Ethereum Contract ABI.

Address

from

20 Bytes - The address the transaction is send from.

Quantity

gas

Integer of the gas provided for the transaction execution. eth_call consumes zero gas, but this parameter may be needed by some executions.

Quantity

gasPrice

Integer of the gas price used for each paid gas.

Quantity

nonce

nonce

Address

to

(optional when creating new contract) 20 Bytes - The address the transaction is directed to.

Quantity

value

Integer of the value sent with this transaction.

Type BlockType¶

Source: modules/eth/api.ts

= number | 'latest' | 'earliest' | 'pending'

Type Address¶

Source: modules/eth/api.ts

= string

Type ABI¶

Source: modules/eth/api.ts

boolean

anonymous

the anonymous (optional)

boolean

constant

the constant (optional)

ABIField []

inputs

the inputs (optional)

string

name

the name (optional)

ABIField []

outputs

the outputs (optional)

boolean

payable

the payable (optional)

'nonpayable'

| 'payable'

| 'view'

| 'pure'

stateMutability

the stateMutability (optional)

'event'

| 'function'

| 'constructor'

| 'fallback'

type

the type

Type Log¶

Source: modules/eth/api.ts

Address

address

20 Bytes - address from which this log originated.

Hash

blockHash

Hash, 32 Bytes - hash of the block where this log was in. null when its pending. null when its pending log.

Quantity

blockNumber

the block number where this log was in. null when its pending. null when its pending log.

Data

data

contains the non-indexed arguments of the log.

Quantity

logIndex

integer of the log index position in the block. null when its pending log.

boolean

removed

true when the log was removed, due to a chain reorganization. false if its a valid log.

Data []

topics

- 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.)

Hash

transactionHash

Hash, 32 Bytes - hash of the transactions this log was created from. null when its pending log.

Quantity

transactionIndex

integer of the transactions index position log was created from. null when its pending log.

Type Block¶

Source: modules/eth/api.ts

Address

author

20 Bytes - the address of the author of the block (the beneficiary to whom the mining rewards were given)

Quantity

difficulty

integer of the difficulty for this block

Data

extraData

the ‘extra data’ field of this block

Quantity

gasLimit

the maximum gas allowed in this block

Quantity

gasUsed

the total used gas by all transactions in this block

Hash

hash

hash of the block. null when its pending block

Data

logsBloom

256 Bytes - the bloom filter for the logs of the block. null when its pending block

Address

miner

20 Bytes - alias of ‘author’

Data

nonce

8 bytes hash of the generated proof-of-work. null when its pending block. Missing in case of PoA.

Quantity

number

The block number. null when its pending block

Hash

parentHash

hash of the parent block

Data

receiptsRoot

32 Bytes - the root of the receipts trie of the block

Data []

sealFields

PoA-Fields

Data

sha3Uncles

SHA3 of the uncles data in the block

Quantity

size

integer the size of this block in bytes

Data

stateRoot

32 Bytes - the root of the final state trie of the block

Quantity

timestamp

the unix timestamp for when the block was collated

Quantity

totalDifficulty

integer of the total difficulty of the chain until this block

string | []

transactions

Array of transaction objects, or 32 Bytes transaction hashes depending on the last given parameter

Data

transactionsRoot

32 Bytes - the root of the transaction trie of the block

Hash []

uncles

Array of uncle hashes

Type Hash¶

Source: modules/eth/api.ts

= string

Type Quantity¶

Source: modules/eth/api.ts

= number | Hex

Type LogFilter¶

Source: modules/eth/api.ts

Address

address

(optional) 20 Bytes - Contract address or a list of addresses from which logs should originate.

BlockType

fromBlock

Quantity or Tag - (optional) (default: latest) Integer block number, or ‘latest’ for the last mined block or ‘pending’, ‘earliest’ for not yet mined transactions.

Quantity

limit

å(optional) The maximum number of entries to retrieve (latest first).

BlockType

toBlock

Quantity or Tag - (optional) (default: latest) Integer block number, or ‘latest’ for the last mined block or ‘pending’, ‘earliest’ for not yet mined transactions.

string | string [] []

topics

(optional) Array of 32 Bytes Data topics. Topics are order-dependent. It’s possible to pass in null to match any topic, or a subarray of multiple topics of which one should be matching.

Type TransactionDetail¶

Source: modules/eth/api.ts

Hash

blockHash

32 Bytes - hash of the block where this transaction was in. null when its pending.

BlockType

blockNumber

block number where this transaction was in. null when its pending.

Quantity

chainId

the chain id of the transaction, if any.

any

condition

(optional) conditional submission, Block number in block or timestamp in time or null. (parity-feature)

Address

creates

creates contract address

Address

from

20 Bytes - address of the sender.

Quantity

gas

gas provided by the sender.

Quantity

gasPrice

gas price provided by the sender in Wei.

Hash

hash

32 Bytes - hash of the transaction.

Data

input

the data send along with the transaction.

Quantity

nonce

the number of transactions made by the sender prior to this one.

any

pk

optional: the private key to use for signing (optional)

Hash

publicKey

public key of the signer.

Quantity

r

the R field of the signature.

Data

raw

raw transaction data

Quantity

standardV

the standardised V field of the signature (0 or 1).

Address

to

20 Bytes - address of the receiver. null when its a contract creation transaction.

Quantity

transactionIndex

integer of the transactions index position in the block. null when its pending.

Quantity

v

the standardised V field of the signature.

Quantity

value

value transferred in Wei.

Type TransactionReceipt¶

Source: modules/eth/api.ts

Hash

blockHash

32 Bytes - hash of the block where this transaction was in.

BlockType

blockNumber

block number where this transaction was in.

Address

contractAddress

20 Bytes - The contract address created, if the transaction was a contract creation, otherwise null.

Quantity

cumulativeGasUsed

The total amount of gas used when this transaction was executed in the block.

Address

from

20 Bytes - The address of the sender.

Quantity

gasUsed

The amount of gas used by this specific transaction alone.

Log []

logs

Array of log objects, which this transaction generated.

Data

logsBloom

256 Bytes - A bloom filter of logs/events generated by contracts during transaction execution. Used to efficiently rule out transactions without expected logs.

Hash

root

32 Bytes - Merkle root of the state trie after the transaction has been executed (optional after Byzantium hard fork EIP609)

Quantity

status

0x0 indicates transaction failure , 0x1 indicates transaction success. Set for blocks mined after Byzantium hard fork EIP609, null before.

Address

to

20 Bytes - The address of the receiver. null when it’s a contract creation transaction.

Hash

transactionHash

32 Bytes - hash of the transaction.

Quantity

transactionIndex

Integer of the transactions index position in the block.

Type Data¶

Source: modules/eth/api.ts

= string

Type TxRequest¶

Source: modules/eth/api.ts

any []

args

the argument to pass to the method (optional)

number

confirmations

number of block to wait before confirming (optional)

Data

data

the data to send (optional)

Address

from

address of the account to use (optional)

number

gas

the gas needed (optional)

number

gasPrice

the gasPrice used (optional)

string

method

the ABI of the method to be used (optional)

number

nonce

the nonce (optional)

Hash

pk

raw private key in order to sign (optional)

Address

to

contract (optional)

Quantity

value

the value in wei (optional)

Type AuthSpec¶

Source: modules/eth/header.ts

Authority specification for proof of authority chains

Buffer []

authorities

List of validator addresses storead as an buffer array

Buffer

proposer

proposer of the block this authspec belongs

ChainSpec

spec

chain specification

Type HistoryEntry¶

Source: modules/eth/header.ts

number

block

the block

AuraValidatoryProof

| string []

proof

the proof

string []

validators

the validators

Type ABIField¶

Source: modules/eth/api.ts

boolean

indexed

the indexed (optional)

string

name

the name

string

type

the type

Type Hex¶

Source: modules/eth/api.ts

= string

Package modules/ipfs¶

Type IpfsAPI¶

Source: modules/ipfs/api.ts

simple API for IPFS

IpfsAPI

constructor (

_client:Client )

simple API for IPFS

Client

client

the client

Promise<Buffer>

get (

hash:string,

resultEncoding:string)

retrieves the conent for a hash from IPFS.

Promise<string>

put (

data:Buffer ,

dataEncoding:string)

stores the data on ipfs and returns the IPFS-Hash.

Package util¶

a collection of util classes inside incubed. They can be get directly through require('in3/js/srrc/util/util')

Type DeltaHistory¶

Source: util/DeltaHistory.ts

DeltaHistory

constructor (

init:T [],

deltaStrings:boolean)

constructor

Delta<T> []

data

the data

void

addState (

start:number,

data:T [])

add state

T []

getData (

index:number)

get data

number

getLastIndex ()

get last index

void

loadDeltaStrings (

deltas:string [])

load delta strings

string []

toDeltaStrings ()

to delta strings

Type Delta¶

Source: util/DeltaHistory.ts

This file is part of the Incubed project. Sources: https://github.com/slockit/in3

number

block

the block

T []

data

the data

number

len

the len

number

start

the start

Common Module¶

The common module (in3-common) contains all the typedefs used in the node and server.

Interface

BlockData

the BlockData

Interface

LogData

the LogData

Type

Receipt

the Receipt

Interface

ReceiptData

the ReceiptData

Type

Transaction

the Transaction

Interface

TransactionData

the TransactionData

Interface

Transport

the Transport

AxiosTransport

AxiosTransport

the AxiosTransport

value= _transport.AxiosTransport

Block

Block

the Block

value= _serialize.Block

any

address (

val:any)

converts it to a Buffer with 20 bytes length

Block

blockFromHex (

hex:string)

converts a hexstring to a block-object

any

bytes (

val:any)

converts it to a Buffer

any

bytes32 (

val:any)

converts it to a Buffer with 32 bytes length

any

bytes8 (

val:any)

converts it to a Buffer with 8 bytes length

cbor

cbor

the cbor

value= _cbor

chainAliases

the chainAliases

value= _util.aliases

number []

createRandomIndexes (

len:number,

limit:number,

seed:Buffer ,

result:number [])

create random indexes

any

createTx (

transaction:any)

creates a Transaction-object from the rpc-transaction-data

Buffer

getSigner (

data:Block )

get signer

Buffer

hash (

val:Block

| Transaction

| Receipt

| Account

| Buffer )

returns the hash of the object

index

rlp

the rlp

value= _serialize.rlp

serialize

serialize

the serialize

value= _serialize

storage

storage

the storage

value= _storage

Buffer []

toAccount (

account:AccountData )

to account

Buffer []

toBlockHeader (

block:BlockData )

create a Buffer[] from RPC-Response

Object

toReceipt (

r:ReceiptData )

create a Buffer[] from RPC-Response

Buffer []

toTransaction (

tx:TransactionData )

create a Buffer[] from RPC-Response

transport

transport

the transport

value= _transport

any

uint (

val:any)

converts it to a Buffer with a variable length. 0 = length 0

any

uint128 (

val:any)

uint128

any

uint64 (

val:any)

uint64

util

util

the util

value= _util

validate

validate

the validate

value= _validate

Package index.ts¶

Type BlockData¶

Source: index.ts

Block as returned by eth_getBlockByNumber Block as returned by eth_getBlockByNumber

string

coinbase

the coinbase (optional)

string | number

difficulty

the difficulty

string

extraData

the extraData

string | number

gasLimit

the gasLimit

string | number

gasUsed

the gasUsed

string

hash

the hash

string

logsBloom

the logsBloom

string

miner

the miner

string

mixHash

the mixHash (optional)

string | number

nonce

the nonce (optional)

string | number

number

the number

string

parentHash

the parentHash

string

receiptRoot

the receiptRoot (optional)

string

receiptsRoot

the receiptsRoot

string []

sealFields

the sealFields (optional)

string

sha3Uncles

the sha3Uncles

string

stateRoot

the stateRoot

string | number

timestamp

the timestamp

any []

transactions

the transactions (optional)

string

transactionsRoot

the transactionsRoot

string []

uncles

the uncles (optional)

Type LogData¶

Source: index.ts

LogData as part of the TransactionReceipt LogData as part of the TransactionReceipt

string

address

the address

string

blockHash

the blockHash

string

blockNumber

the blockNumber

string

data

the data

string

logIndex

the logIndex

boolean

removed

the removed

string []

topics

the topics

string

transactionHash

the transactionHash

string

transactionIndex

the transactionIndex

string

transactionLogIndex

the transactionLogIndex

Type ReceiptData¶

Source: index.ts

TransactionReceipt as returned by eth_getTransactionReceipt TransactionReceipt as returned by eth_getTransactionReceipt

string

blockHash

the blockHash (optional)

string | number

blockNumber

the blockNumber (optional)

string | number

cumulativeGasUsed

the cumulativeGasUsed (optional)

string | number

gasUsed

the gasUsed (optional)

LogData []

logs

the logs

string

logsBloom

the logsBloom (optional)

string

root

the root (optional)

string | boolean

status

the status (optional)

string

transactionHash

the transactionHash (optional)

number

transactionIndex

the transactionIndex (optional)

Type TransactionData¶

Source: index.ts

Transaction as returned by eth_getTransactionByHash Transaction as returned by eth_getTransactionByHash

string

blockHash

the blockHash (optional)

number | string

blockNumber

the blockNumber (optional)

number | string

chainId

the chainId (optional)

string

condition

the condition (optional)

string

creates

the creates (optional)

string

data

the data (optional)

string

from

the from (optional)

number | string

gas

the gas (optional)

number | string

gasLimit

the gasLimit (optional)

number | string

gasPrice

the gasPrice (optional)

string

hash

the hash

string

input

the input

number | string

nonce

the nonce

string

publicKey

the publicKey (optional)

string

r

the r (optional)

string

raw

the raw (optional)

string

s

the s (optional)

string

standardV

the standardV (optional)

string

to

the to

number

transactionIndex

the transactionIndex

string

v

the v (optional)

number | string

value

the value

Type Transport¶

Source: index.ts

A Transport-object responsible to transport the message to the handler. A Transport-object responsible to transport the message to the handler.

Promise<>

handle (

url:string,

data:RPCRequest

| RPCRequest [],

timeout:number)

handles a request by passing the data to the handler

Promise<boolean>

isOnline ()

check whether the handler is onlne.

number []

random (

count:number)

generates random numbers (between 0-1)

Package modules/eth¶

Type Block¶

encodes and decodes the blockheader

Block

constructor (

data:Buffer

| string

| BlockData )

creates a Block-Onject from either the block-data as returned from rpc, a buffer or a hex-string of the encoded blockheader

BlockHeader

raw

the raw Buffer fields of the BlockHeader

Tx []

transactions

the transaction-Object (if given)

Buffer

bloom

bloom

Buffer

coinbase

coinbase

Buffer

difficulty

difficulty

Buffer

extra

extra

Buffer

gasLimit

gas limit

Buffer

gasUsed

gas used

Buffer

number

number

Buffer

parentHash

parent hash

Buffer

receiptTrie

receipt trie

Buffer []

sealedFields

sealed fields

Buffer

stateRoot

state root

Buffer

timestamp

timestamp

Buffer

transactionsTrie

transactions trie

Buffer

uncleHash

uncle hash

Buffer

bareHash ()

the blockhash as buffer without the seal fields

Buffer

hash ()

the blockhash as buffer

Buffer

serializeHeader ()

the serialized header as buffer

Type Transaction¶

Buffer[] of the transaction = Buffer []

Type Receipt¶

Buffer[] of the Receipt = [ Buffer ,Buffer ,Buffer ,Buffer , Buffer [] , Buffer [] ]

Type Account¶

Buffer[] of the Account = Buffer []

Type serialize¶

Class

Block

encodes and decodes the blockheader

Interface

AccountData

Account-Object

Interface

BlockData

Block as returned by eth_getBlockByNumber

Interface

LogData

LogData as part of the TransactionReceipt

Interface

ReceiptData

TransactionReceipt as returned by eth_getTransactionReceipt

Interface

TransactionData

Transaction as returned by eth_getTransactionByHash

Type

Account

Buffer[] of the Account

Type

BlockHeader

Buffer[] of the header

Type

Receipt

Buffer[] of the Receipt

Type

Transaction

Buffer[] of the transaction

index

rlp

RLP-functions

value= ethUtil.rlp

any

address (

val:any)

converts it to a Buffer with 20 bytes length

Block

blockFromHex (

hex:string)

converts a hexstring to a block-object

string

blockToHex (

block:any)

converts blockdata to a hexstring

any

bytes (

val:any)

converts it to a Buffer

any

bytes256 (

val:any)

converts it to a Buffer with 256 bytes length

any

bytes32 (

val:any)

converts it to a Buffer with 32 bytes length

any

bytes8 (

val:any)

converts it to a Buffer with 8 bytes length

any

createTx (

transaction:any)

creates a Transaction-object from the rpc-transaction-data

Buffer

hash (

val:Block

| Transaction

| Receipt

| Account

| Buffer )

returns the hash of the object

Buffer

serialize (

val:Block

| Transaction

| Receipt

| Account

| any)

serialize the data

Buffer []

toAccount (

account:AccountData )

to account

Buffer []

toBlockHeader (

block:BlockData )

create a Buffer[] from RPC-Response

Object

toReceipt (

r:ReceiptData )

create a Buffer[] from RPC-Response

Buffer []

toTransaction (

tx:TransactionData )

create a Buffer[] from RPC-Response

any

uint (

val:any)

converts it to a Buffer with a variable length. 0 = length 0

any

uint128 (

val:any)

uint128

any

uint64 (

val:any)

uint64

Type storage¶

Source: modules/eth/storage.ts

any

getStorageArrayKey (

pos:number,

arrayIndex:number,

structSize:number,

structPos:number)

calc the storrage array key

any

getStorageMapKey (

pos:number,

key:string,

structPos:number)

calcs the storage Map key.

Promise<>

getStorageValue (

rpc:string,

contract:string,

pos:number,

type:'address'

| 'bytes32'

| 'bytes16'

| 'bytes4'

| 'int'

| 'string',

keyOrIndex:number

| string,

structSize:number,

structPos:number)

get a storage value from the server

string |

getStringValue (

data:Buffer ,

storageKey:Buffer )

creates a string from storage.

string

getStringValueFromList (

values:Buffer [],

len:number)

concats the storage values to a string.

BN

toBN (

val:any)

converts any value to BN

Type AccountData¶

Account-Object

string

balance

the balance

string

code

the code (optional)

string

codeHash

the codeHash

string

nonce

the nonce

string

storageHash

the storageHash

Type BlockHeader¶