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_log_free¶

void eth_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

in3_register_eth_api¶

void in3_register_eth_api();

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

Module api/ipfs¶

ipfs_api.h¶

IPFS API.

This header-file defines easy to use function, which are preparing the JSON-RPC-Request, which is then executed and verified by the incubed-client.

File: c/src/api/ipfs/ipfs_api.h

ipfs_put¶

char* ipfs_put(in3_t *in3, const bytes_t *content);

Returns the IPFS multihash of stored content on success OR NULL on error (check api_last_error()).

Result must be freed by caller.

arguments:

in3_t *	in3
bytes_tconst , *	content

returns: char *

ipfs_get¶

bytes_t* ipfs_get(in3_t *in3, const char *multihash);

Returns the content associated with specified multihash on success OR NULL on error (check api_last_error()).

Result must be freed by caller.

arguments:

in3_t *	in3
`const char *`	multihash

returns: bytes_t *

Module api/usn¶

usn_api.h¶

USN API.

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

File: c/src/api/usn/usn_api.h

usn_msg_type_t¶

The enum type contains the following values:

USN_ACTION	0
USN_REQUEST	1
USN_RESPONSE	2

usn_event_type_t¶

The enum type contains the following values:

BOOKING_NONE	0
BOOKING_START	1
BOOKING_STOP	2

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 api/utils¶

api_utils.h¶

Ethereum API utils.

This header-file helper utils for use with API modules.

File: c/src/api/utils/api_utils.h

set_error_fn¶

function to set error.

Will only be called internally. default implementation is NOT MT safe!

typedef void(* set_error_fn) (int err, const char *msg)

get_error_fn¶

function to get last error message.

default implementation is NOT MT safe!

typedef char*(* get_error_fn) (void)

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)

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)

api_set_error_fn¶

void api_set_error_fn(set_error_fn fn);

arguments:

set_error_fn

fn

api_get_error_fn¶

void api_get_error_fn(get_error_fn fn);

arguments:

get_error_fn

fn

api_last_error¶

char* api_last_error();

returns current error or null if all is ok

returns: char *

Module core/client¶

client.h¶

this file defines the incubed configuration struct and it registration.

File: c/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_BTC¶

chain_id for btc

#define ETH_CHAIN_ID_BTC 0x99

ETH_CHAIN_ID_LOCAL¶

chain_id for local chain

#define ETH_CHAIN_ID_LOCAL 0xFFFF

DEF_REPL_LATEST_BLK¶

default replace_latest_block

#define DEF_REPL_LATEST_BLK 6

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

in3_for_chain (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 ...

#define in3_for_chain (chain_id) in3_for_chain_default(chain_id)

in3_chain_type_t¶

the type of the chain.

for incubed a chain can be any distributed network or database with incubed support. Depending on this chain-type the previously registered verifyer will be choosen and used.

The enum type contains the following values:

CHAIN_ETH	0	Ethereum chain.
CHAIN_SUBSTRATE	1	substrate chain
CHAIN_IPFS	2	ipfs verifiaction
CHAIN_BTC	3	Bitcoin chain.
CHAIN_EOS	4	EOS chain.
CHAIN_IOTA	5	IOTA chain.
CHAIN_GENERIC	6	other chains

in3_proof_t¶

the type of proof.

Depending on the proof-type different levels of proof will be requested from the node.

The enum type contains the following values:

PROOF_NONE	0	No Verification.
PROOF_STANDARD	1	Standard Verification of the important properties.
PROOF_FULL	2	All field will be validated including uncles.

in3_verification_t¶

verification as delivered by the server.

This will be part of the in3-request and will be generated based on the prooftype.

The enum type contains the following values:

VERIFICATION_NEVER	0	No Verifacation.
VERIFICATION_PROOF	1	Includes the proof of the data.

in3_node_props_type_t¶

The enum type contains the following values:

NODE_PROP_PROOF	0x1	filter out nodes which are providing no proof
NODE_PROP_MULTICHAIN	0x2	filter out nodes other then which have capability of the same RPC endpoint may also accept requests for different chains
NODE_PROP_ARCHIVE	0x4	filter out non-archive supporting nodes
NODE_PROP_HTTP	0x8	filter out non-http nodes
NODE_PROP_BINARY	0x10	filter out nodes that don’t support binary encoding
NODE_PROP_ONION	0x20	filter out non-onion nodes
NODE_PROP_SIGNER	0x40	filter out non-signer nodes
NODE_PROP_DATA	0x80	filter out non-data provider nodes
NODE_PROP_STATS	0x100	filter out nodes that do not provide stats
NODE_PROP_MIN_BLOCK_HEIGHT	0x400	filter out nodes that will sign blocks with lower min block height than specified

in3_flags_type_t¶

a list of flags definiing the behavior of the incubed client.

They should be used as bitmask for the flags-property.

The enum type contains the following values:

FLAGS_KEEP_IN3	0x1	the in3-section with the proof will also returned
FLAGS_AUTO_UPDATE_LIST	0x2	the nodelist will be automaticly updated if the last_block is newer
FLAGS_INCLUDE_CODE	0x4	the code is included when sending eth_call-requests
FLAGS_BINARY	0x8	the client will use binary format
FLAGS_HTTP	0x10	the client will try to use http instead of https
FLAGS_STATS	0x20	nodes will keep track of the stats (default=true)
FLAGS_NODE_LIST_NO_SIG	0x40	nodelist update request will not automatically ask for signatures and proof

in3_node_attr_type_t¶

a list of node attributes (mostly used internally)

The enum type contains the following values:

ATTR_WHITELISTED	1	indicates if node exists in whiteList
ATTR_BOOT_NODE	2	used to avoid filtering manually added nodes before first nodeList update

d_signature_type_t¶

type of the requested signature

The enum type contains the following values:

SIGN_EC_RAW	0	sign the data directly
SIGN_EC_HASH	1	hash and sign the data

in3_filter_type_t¶

Filter type used internally when managing filters.

The enum type contains the following values:

FILTER_EVENT	0	Event filter.
FILTER_BLOCK	1	Block filter.
FILTER_PENDING	2	Pending filter (Unsupported)

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.
`uint_fast8_t`	flags	the current flags from the client.
`uint8_t`	use_full_proof	this flaqg is set, if the proof is set to “PROOF_FULL”
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
`uint8_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 *	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_attr_t¶

typedef uint8_t in3_node_attr_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
`uint8_t`	attrs	bitmask of internal attributes

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.
`uint16_t`	avg_block_time	average block time (seconds) for this chain (calculated internally)
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
`uint64_t`	timestamp	approx. time when nodelist must be updated (i.e. when reported last_block will be considered final)
`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.
`void *`	key	the client key to sign requests (pointer to 32bytes private key seed)
`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.
`uint8_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.
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
`uint_fast8_t`	flags	a bit mask with flags defining the behavior of the incubed client. See the FLAG…-defines
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_default¶

in3_t* in3_for_chain_default(chain_id_t chain_id);

arguments:

chain_id_t

chain_id

the chain_id (see ETH_CHAIN_ID_… constants).

returns: in3_t *

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_rpc_raw¶

in3_ret_t in3_client_rpc_raw(in3_t *c, char *request, 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 *`	request	the rpc request including method and params.
`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 Returns NULL on success, and error string on failure (to be freed by caller) - in which case the client state is undefined

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: c/src/core/client/context.h

ctx_type¶

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

state¶

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_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

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_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_raw¶

in3_ctx_t* in3_client_rpc_ctx_raw(in3_t *c, char *request);

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 client config.
`char *`	request	rpc request.

returns: in3_ctx_t *

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: c/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)

Module core/util¶

bytes.h¶

util helper on byte arrays.

File: c/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: c/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_type_t¶

type of a token.

The enum type contains the following values:

T_BYTES	0	content is stored as data ptr.
T_STRING	1	content is stored a c-str
T_ARRAY	2	the node is an array with the length stored in length
T_OBJECT	3	the node is an object with properties
T_BOOLEAN	4	boolean with the value stored in len
T_INTEGER	5	a integer with the value stored
T_NULL	6	a NULL-value

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: c/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: c/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_ret_t¶

ERROR types used as return values.

All values (except IN3_OK) indicate an error. IN3_WAITING may be treated like an error, since we have stop executing until the response has arrived, but it is a valid return value.

The enum type contains the following values:

IN3_OK	0	Success.
IN3_EUNKNOWN	-1	Unknown error - usually accompanied with specific error msg.
IN3_ENOMEM	-2	No memory.
IN3_ENOTSUP	-3	Not supported.
IN3_EINVAL	-4	Invalid value.
IN3_EFIND	-5	Not found.
IN3_ECONFIG	-6	Invalid config.
IN3_ELIMIT	-7	Limit reached.
IN3_EVERS	-8	Version mismatch.
IN3_EINVALDT	-9	Data invalid, eg. invalid/incomplete JSON
IN3_EPASS	-10	Wrong password.
IN3_ERPC	-11	RPC error (i.e. in3_ctx_t::error set)
IN3_ERPCNRES	-12	RPC no response.
IN3_EUSNURL	-13	USN URL parse error.
IN3_ETRANS	-14	Transport error.
IN3_ERANGE	-15	Not in range.
IN3_WAITING	-16	the process can not be finished since we are waiting for responses
IN3_EIGNORE	-17	Ignorable error.

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: c/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: c/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: c/src/core/util/utils.h

_strtoull (str,endptr,base)¶

#define _strtoull (str,endptr,base) strtoull(str, endptr, base)

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

STR_IMPL_ (x)¶

simple macro to stringify other macro defs eg.

usage - to concatenate a const with a string at compile time -> define SOME_CONST_UINT 10U printf(“Using default value of “ STR(SOME_CONST_UINT));

#define STR_IMPL_ (x) #x

STR (x)¶

#define STR (x) STR_IMPL_(x)

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; \
  }

time_func¶

Pluggable functions: Mechanism to replace library functions with custom alternatives.

This is particularly useful for embedded systems which have their own time or rand functions.

eg. // define function with specified signature uint64_t my_time(void* t) { // … }

// then call in3_set_func_*() int main() { in3_set_func_time(my_time); // Henceforth, all library calls will use my_time() instead of the platform default time function } time function defaults to k_uptime_get() for zeohyr and time(NULL) for other platforms expected to return a u64 value representative of time (from epoch/start)

typedef uint64_t(* time_func) (void *t)

returns: uint64_t(*

rand_func¶

rand function defaults to k_uptime_get() for zeohyr and rand() for other platforms expected to return a random number

typedef int(* rand_func) (void *s)

returns: int(*

srand_func¶

srand function defaults to NOOP for zephyr and srand() for other platforms expected to set the seed for a new sequence of random numbers to be returned by in3_rand()

typedef void(* srand_func) (unsigned int s)

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 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 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(char *orig, const char *rep, const char *with);

replaces a string and returns a copy.

arguments:

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

returns: char *

str_replace_pos¶

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

replaces a string at the given position.

arguments:

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

returns: char *

str_find¶

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

lightweight strstr() replacements

arguments:

`char *`	haystack
`const char *`	needle

returns: char *

str_remove_html¶

char* str_remove_html(char *data);

remove all html-tags in the text.

arguments:

char * data

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

in3_set_func_time¶

void in3_set_func_time(time_func fn);

arguments:

time_func

fn

in3_time¶

uint64_t in3_time(void *t);

arguments:

void * t

returns: uint64_t

in3_set_func_rand¶

void in3_set_func_rand(rand_func fn);

arguments:

rand_func

fn

in3_rand¶

int in3_rand(void *s);

arguments:

void * s

returns: int

in3_set_func_srand¶

void in3_set_func_srand(srand_func fn);

arguments:

srand_func

fn

in3_srand¶

void in3_srand(unsigned int s);

arguments:

unsigned int s

Module transport/curl¶

in3_curl.h¶

transport-handler using libcurl.

File: c/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: c/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/btc¶

btc.h¶

Bitcoin verification.

File: c/src/verifier/btc/btc.h

in3_verify_btc¶

in3_ret_t in3_verify_btc(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)

in3_register_btc¶

void in3_register_btc();

this function should only be called once and will register the bitcoin verifier.

Module verifier/eth1/basic¶

eth_basic.h¶

Ethereum Nanon verification.

File: c/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)

eth_verify_eth_getBlockTransactionCount¶

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

verifies block transaction count by number or hash

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: c/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: c/src/verifier/eth1/basic/trie.h

trie_node_type_t¶

Node types.

The enum type contains the following values:

NODE_EMPTY	0	empty node
NODE_BRANCH	1	a Branch
NODE_LEAF	2	a leaf containing the value.
NODE_EXT	3	a extension

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: c/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: c/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: c/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 (...) exit_zero()

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¶

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_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

exit_zero¶

int exit_zero(void);

arguments:

`void`¶

returns: int

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: c/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

UPDATE_ACCOUNT_CODE (…)¶

Module verifier/eth1/full¶

eth_full.h¶

Ethereum Nanon verification.

File: c/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: c/src/verifier/eth1/nano/chainspec.h

BLOCK_LATEST¶

#define BLOCK_LATEST 0xFFFFFFFFFFFFFFFF

eth_consensus_type_t¶

the consensus type.

The enum type contains the following values:

ETH_POW	0	Pro of Work (Ethash)
ETH_POA_AURA	1	Proof of Authority using Aura.
ETH_POA_CLIQUE	2	Proof of Authority using clique.

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: c/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: c/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: c/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: c/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.

Module verifier¶

in3_init.h¶

IN3 init module for auto initializing verifiers and transport based on build config.

File: c/src/verifier/in3_init.h

in3_for_chain_auto_init¶

in3_t* in3_for_chain_auto_init(chain_id_t chain_id);

arguments:

chain_id_t

chain_id

returns: in3_t *

Module verifier/ipfs¶

ipfs.h¶

IPFS verification.

File: c/src/verifier/ipfs/ipfs.h

ipfs_verify_hash¶

in3_ret_t ipfs_verify_hash(const char *content, const char *encoding, const char *requsted_hash);

verifies an IPFS hash.

Supported encoding schemes - hex, utf8 and base64

arguments:

`const char *`	content
`const char *`	encoding
`const char *`	requsted_hash

returns: in3_ret_t the result-status of the function.

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

in3_verify_ipfs¶

in3_ret_t in3_verify_ipfs(in3_vctx_t *vc);

entry-function to execute the verification context.

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_ipfs¶

void in3_register_ipfs();

this function should only be called once and will register the IPFS verifier.

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¶

Buffer[] of the header = Buffer []

Package types¶

Type RPCRequest¶

Source: types/types.ts

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: types/types.ts

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 IN3RPCRequestConfig¶

Source: types/types.ts

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)

Type IN3ResponseConfig¶

Source: types/types.ts

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 gthe last change of the validatorList (optional)

Proof

proof

the Proof-data (optional)

string

version

the in3 protocol version.

example: 1.0.0 (optional)

Type IN3NodeConfig¶

Source: types/types.ts

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 Proof¶

Source: types/types.ts

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 LogProof¶

Source: types/types.ts

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

Type Signature¶

Source: types/types.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.

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

Package util¶

Type AxiosTransport¶

Source: util/transport.ts

Default Transport impl sending http-requests.

AxiosTransport

constructor (

format:'json'

| 'cbor'

| 'jsonRef')

Default Transport impl sending http-requests.

'json' | 'cbor' | 'jsonRef'

format

the format

Promise<>

handle (

url:string,

data:RPCRequest

| RPCRequest [],

timeout:number)

handle

Promise<boolean>

isOnline ()

is online

number []

random (

count:number)

random

Type cbor¶

Source: util/cbor.ts

any

convertToBuffer (

val:any)

convert to buffer

any

convertToHex (

val:any)

convert to hex

T

createRefs (

val:T ,

cache:string [])

create refs

RPCRequest []

decodeRequests (

request:Buffer )

decode requests

RPCResponse []

decodeResponses (

responses:Buffer )

decode responses

Buffer

encodeRequests (

requests:RPCRequest [])

turn

Buffer

encodeResponses (

responses:RPCResponse [])

encode responses

T

resolveRefs (

val:T ,

cache:string [])

resolve refs

Type transport¶

Source: util/transport.ts

Class

AxiosTransport

Default Transport impl sending http-requests.

Interface

Transport

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

Type util¶

Source: util/util.ts

BN

BN

the BN

value= ethUtil.BN

any

Buffer

This file is part of the Incubed project.

Sources: https://github.com/slockit/in3-common

value= require('buffer').Buffer

T

checkForError (

res:T )

check a RPC-Response for errors and rejects the promise if found

number []

createRandomIndexes (

len:number,

limit:number,

seed:Buffer ,

result:number [])

create random indexes

string

fixLength (

hex:string)

fix length

string

getAddress (

pk:string)

returns a address from a private key

Buffer

getSigner (

data:Block )

get signer

string

padEnd (

val:string,

minLength:number,

fill:string)

padEnd for legacy

string

padStart (

val:string,

minLength:number,

fill:string)

padStart for legacy

Promise<any>

promisify (

self:any,

fn:any,

args:any [])

simple promisy-function

BN

toBN (

val:any)

convert to BigNumber

any

toBuffer (

val:any,

len:number)

converts any value as Buffer

if len === 0 it will return an empty Buffer if the value is 0 or ‘0x00’, since this is the way rlpencode works wit 0-values.

string

toHex (

val:any,

bytes:number)

converts any value as hex-string

string

toMinHex (

key:string

| Buffer

| number)

removes all leading 0 in the hexstring

number

toNumber (

val:any)

converts to a js-number

string

toSimpleHex (

val:string)

removes all leading 0 in a hex-string

string

toUtf8 (

val:any)

to utf8

JSON

``object``

the aliases

Type validate¶

Source: util/validate.ts

Ajv

ajv

the ajv instance with custom formatters and keywords

value= new Ajv()

void

validate (

ob:any,

def:any)

validate

void

validateAndThrow (

fn:Ajv.ValidateFunction ,

ob:any)

validates the data and throws an error in case they are not valid.

API Reference WASM¶

Even though the incubed client is written in C, we are using emscripten to build wasm. Together with some binding-code incubed runs in any Javascript-Runtime. Using WASM gives us 3 important features:

Performance. Since WASM runs at almost native speed it is very fast
Security Since the WASM-Module has no dependencies it reduces the risk of using a malicious dependency, which would be able to manipulate Prototypes. Also, since the real work is happening inside the wasm, trying to change Prototype would not work.
Size The current wasm-file is about 200kb. This is smaller then most other libraries and can easily be used in any app or website.

Installing¶

This client uses the in3-core sources compiled to wasm. The wasm is included into the js-file wich makes it easier to include the data. This module has no dependencies! All it needs is included inta a wasm of about 300kB.

Installing incubed is as easy as installing any other module:

npm install --save in3-wasm

WASM-support¶

Even though most browsers and javascript enviroment such as nodejs, have full support for wasm, there are ocasions, where WASM is fully supported. In case you want to run incubed within a react native app, you might face such issues. In this case you can use in3-asmjs, which has the same API, but runs on pure javascript (a bit slower and bigger, but full support everywhere).

Examples¶

get_block_rpc¶

source : in3-c/wasm/examples/get_block_rpc.js

read block as rpc

/// read block as rpc

const IN3 = require('in3-wasm')

async function showLatestBlock() {
    // create new incubed instance
    var c = new IN3()

    await c.setConfig({
        chainId: 0x5 // use goerli
    })

    // send raw RPC-Request
    const lastBlockResponse = await c.send({ method: 'eth_getBlockByNumber', params: ['latest', false] })

    if (lastBlockResponse.error)
        console.error("Error getting the latest block : ", lastBlockResponse.error)
    else
        console.log("latest Block: ", JSON.stringify(lastBlockResponse.result, null, 2))

    // clean up
    c.free()

}

showLatestBlock().catch(console.error)

get_block_api¶

source : in3-c/wasm/examples/get_block_api.ts

read block with API

/// read block with API

import { IN3 } from 'in3-wasm'

async function showLatestBlock() {
  // create new incubed instance
  const client = new IN3({
    chainId: 'goerli'
  })

  // send raw RPC-Request
  const lastBlock = await client.eth.getBlockByNumber()

  console.log("latest Block: ", JSON.stringify(lastBlock, null, 2))

  // clean up
  client.free()

}

showLatestBlock().catch(console.error)

use_web3¶

source : in3-c/wasm/examples/use_web3.ts

use incubed as Web3Provider in web3js

/// use incubed as Web3Provider in web3js 

// import in3-Module
import { IN3 } from 'in3-wasm'
const Web3 = require('web3')

const in3 = new IN3({
    proof: 'standard',
    signatureCount: 1,
    requestCount: 1,
    chainId: 'mainnet',
    replaceLatestBlock: 10
})

// use the In3Client as Http-Provider
const web3 = new Web3(in3.createWeb3Provider());

(async () => {

    // use the web3
    const block = await web3.eth.getBlock('latest')
    console.log("Block : ", block)

})().catch(console.error);

in3_in_browser¶

source : in3-c/wasm/examples/in3_in_browser.html

use incubed directly in html

<!-- use incubed directly in html -->
<html>
    <head>
        <script src="node_modules/in3-wasm/index.js"></script>
    </head>

    <body>
        IN3-Demo
        <div>
            result:
            <pre id="result"> ...waiting... </pre>
        </div>
        <script>
            var in3 = new IN3({ chainId: 0x1, replaceLatestBlock: 6 });
            in3.eth.getBlockByNumber('latest', false)
                .then(block => document.getElementById('result').innerHTML = JSON.stringify(block, null, 2))
                .catch(alert)
        </script>
    </body>

</html>

Building¶

In order to run those examples, you need to install in3-wasm and typescript first. The build.sh will do this and the run the tsc-compiler

./build.sh

In order to run a example use

node build/get_block_api.ts

Incubed Module¶

This page contains a list of all Datastructures and Classes used within the IN3 WASM-Client

Importing incubed is as easy as

import {IN3} from "in3-wasm"

BufferType and BigIntType¶

The WASM-Module comes with no dependencies. This means per default it uses the standard classes provided as part of the EMCAScript-Standard.

If you work with a library which expects different types, you can change the generic-type and giving a converter:

Type BigIntType¶

Per default we use bigint. This is used whenever we work with number too big to be stored as a number-type.

If you want to change this type, use setConverBigInt() function.

Type Buffer¶

Per default we use UInt8Array. This is used whenever we work with raw bytes.

If you want to change this type, use setConverBuffer() function.

Generics¶

import {IN3Generic} from 'in3-wasm'
import BN from 'bn.js'

// create a new client by setting the Generic Types
const c = new IN3Generic<BN,Buffer>()

// set the converter-functions
IN3Generic.setConverBuffer(val => Buffer.from(val))
IN3Generic.setConverBigInt(val => new BN(val))

Package¶

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

IN3

Class

default Incubed client with

bigint for big numbers

Uint8Array for bytes

IN3Generic

Class

the IN3Generic

SimpleSigner

Class

the SimpleSigner

EthAPI

Interface

the EthAPI

IN3Config

Interface

the configuration of the IN3-Client. This can be changed at any time.

All properties are optional and will be verified when sending the next request.

IN3NodeConfig

Interface

a configuration of a in3-server.

IN3NodeWeight

Interface

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

IpfsAPI

Interface

API for storing and retrieving IPFS-data.

RPCRequest

Interface

a JSONRPC-Request with N3-Extension

RPCResponse

Interface

a JSONRPC-Responset with N3-Extension

Signer

Interface

the Signer

Utils

Interface

Collection of different util-functions.

ABI

Type literal

the ABI

ABIField

Type literal

the ABIField

Address

Type alias

a 20 byte Address encoded as Hex (starting with 0x)

Block

Type literal

the Block

BlockType

Type

BlockNumber or predefined Block

Data

Type alias

data encoded as Hex (starting with 0x)

Hash

Type alias

a 32 byte Hash encoded as Hex (starting with 0x)

Hex

Type

a Hexcoded String (starting with 0x)

Log

Type literal

the Log

LogFilter

Type literal

the LogFilter

Quantity

Type

a BigInteger encoded as hex.

Signature

Type literal

Signature

Transaction

Type literal

the Transaction

TransactionDetail

Type literal

the TransactionDetail

TransactionReceipt

Type literal

the TransactionReceipt

TxRequest

Type literal

the TxRequest

Package in3¶

Type IN3¶

Source: in3.d.ts

default Incubed client with bigint for big numbers Uint8Array for bytes

default

IN3Generic

supporting both ES6 and UMD usage

util

Utils<any>

collection of util-functions.

config

IN3Config

IN3 config

eth

EthAPI<bigint,Uint8Array>

eth1 API.

ipfs

IpfsAPI<Uint8Array>

ipfs API.

signer

Signer<bigint,Uint8Array>

the signer, if specified this interface will be used to sign transactions, if not, sending transaction will not be possible.

util

Utils<Uint8Array>

collection of util-functions.

freeAll()¶

frees all Incubed instances.

static void freeAll ()

onInit()¶

registers a function to be called as soon as the wasm is ready. If it is already initialized it will call it right away.

static Promise<T> onInit (: fn:() => T )

Parameters:

fn

() => T

the function to call

Returns:

static Promise<T>

setConvertBigInt()¶

set convert big int

static any setConvertBigInt (: convert:(any) => any)

Parameters:

convert

(any) => any

convert

Returns:

static any

setConvertBuffer()¶

set convert buffer

static any setConvertBuffer (: convert:(any) => any)

Parameters:

convert

(any) => any

convert

Returns:

static any

setStorage()¶

changes the storage handler, which is called to read and write to the cache.

static void setStorage (: handler:)

Parameters:

handler

handler

setTransport()¶

changes the transport-function.

static void setTransport (: fn:(string , string , number) => Promise<string>)

Parameters:

fn

(string , string , number) => Promise<string>

the function to fetch the response for the given url

constructor()¶

creates a new client.

IN3 constructor (: config:Partial<IN3Config> )

Parameters:

config

Partial<IN3Config>

a optional config

Returns:

createWeb3Provider()¶

returns a Object, which can be used as Web3Provider.

const web3 = new Web3(new IN3().createWeb3Provider())

any createWeb3Provider ()

Returns:

any

free()¶

disposes the Client. This must be called in order to free allocated memory!

any free ()

Returns:

any

send()¶

sends a raw request. 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> send (: request:RPCRequest , callback:(Error , RPCResponse ) => void)

Parameters:

request

RPCRequest

a JSONRPC-Request with N3-Extension

callback

(Error , RPCResponse ) => void

callback

Returns:

Promise<RPCResponse>

sendRPC()¶

sends a RPC-Requests specified by name and params.

if the response contains an error, this will be thrown. if not the result will be returned.

Promise<any> sendRPC (: method:string, params:any [])

Parameters:

method

string

the method to call.

params

any []

params

Returns:

Promise<any>

setConfig()¶

sets configuration properties. You can pass a partial object specifieing any of defined properties.

void setConfig (: config:Partial<IN3Config> )

Parameters:

config

Partial<IN3Config>

config

Type IN3Generic¶

Source: in3.d.ts

default

IN3Generic

supporting both ES6 and UMD usage

util

Utils<any>

collection of util-functions.

config

IN3Config

IN3 config

eth

EthAPI<BigIntType,BufferType>

eth1 API.

ipfs

IpfsAPI<BufferType>

ipfs API.

signer

Signer<BigIntType,BufferType>

the signer, if specified this interface will be used to sign transactions, if not, sending transaction will not be possible.

util

Utils<BufferType>

collection of util-functions.

freeAll()¶

frees all Incubed instances.

static void freeAll ()

onInit()¶

registers a function to be called as soon as the wasm is ready. If it is already initialized it will call it right away.

static Promise<T> onInit (: fn:() => T )

Parameters:

fn

() => T

the function to call

Returns:

static Promise<T>

setConvertBigInt()¶

set convert big int

static any setConvertBigInt (: convert:(any) => any)

Parameters:

convert

(any) => any

convert

Returns:

static any

setConvertBuffer()¶

set convert buffer

static any setConvertBuffer (: convert:(any) => any)

Parameters:

convert

(any) => any

convert

Returns:

static any

setStorage()¶

changes the storage handler, which is called to read and write to the cache.

static void setStorage (: handler:)

Parameters:

handler

handler

setTransport()¶

changes the transport-function.

static void setTransport (: fn:(string , string , number) => Promise<string>)

Parameters:

fn

(string , string , number) => Promise<string>

the function to fetch the response for the given url

constructor()¶

creates a new client.

IN3Generic constructor (: config:Partial<IN3Config> )

Parameters:

config

Partial<IN3Config>

a optional config

Returns:

IN3Generic

createWeb3Provider()¶

returns a Object, which can be used as Web3Provider.

const web3 = new Web3(new IN3().createWeb3Provider())

any createWeb3Provider ()

Returns:

any

free()¶

disposes the Client. This must be called in order to free allocated memory!

any free ()

Returns:

any

send()¶

sends a raw request. 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> send (: request:RPCRequest , callback:(Error , RPCResponse ) => void)

Parameters:

request

RPCRequest

a JSONRPC-Request with N3-Extension

callback

(Error , RPCResponse ) => void

callback

Returns:

Promise<RPCResponse>

sendRPC()¶

sends a RPC-Requests specified by name and params.

if the response contains an error, this will be thrown. if not the result will be returned.

Promise<any> sendRPC (: method:string, params:any [])

Parameters:

method

string

the method to call.

params

any []

params

Returns:

Promise<any>

setConfig()¶

sets configuration properties. You can pass a partial object specifieing any of defined properties.

void setConfig (: config:Partial<IN3Config> )

Parameters:

config

Partial<IN3Config>

config

Type SimpleSigner¶

Source: in3.d.ts

accounts

the accounts

constructor()¶

constructor

SimpleSigner constructor (: pks:string | BufferType [])

Parameters:

pks

string | BufferType []

pks

Returns:

SimpleSigner

prepareTransaction()¶

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

Promise<Transaction> prepareTransaction (: client:IN3Generic<BigIntType,BufferType> , tx:Transaction )

Parameters:

client

IN3Generic<BigIntType,BufferType>

client

tx

Transaction

tx

Returns:

Promise<Transaction>

sign()¶

signing of any data. if hashFirst is true the data should be hashed first, otherwise the data is the hash.

Promise<BufferType> sign (: data:Hex , account:Address , hashFirst:boolean, ethV:boolean)

Parameters:

data

Hex

a Hexcoded String (starting with 0x)

account

Address

a 20 byte Address encoded as Hex (starting with 0x)

hashFirst

boolean

hash first

ethV

boolean

eth v

Returns:

addAccount()¶

add account

string addAccount (: pk:Hash )

Parameters:

pk

Hash

a 32 byte Hash encoded as Hex (starting with 0x)

Returns:

string

canSign()¶

returns true if the account is supported (or unlocked)

Promise<boolean> canSign (: address:Address )

Parameters:

address

Address

a 20 byte Address encoded as Hex (starting with 0x)

Returns:

Promise<boolean>

Type EthAPI¶

Source: in3.d.ts

client

IN3Generic<BigIntType,BufferType>

the client

signer

Signer<BigIntType,BufferType>

the signer (optional)

blockNumber()¶

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

Promise<number> blockNumber ()

Returns:

Promise<number>

call()¶

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

Promise<string> call (: tx:Transaction , block:BlockType )

Parameters:

tx

Transaction

tx

block

BlockType

BlockNumber or predefined Block

Returns:

Promise<string>

callFn()¶

Executes a function of a contract, by passing a method-signature and the arguments, which will then be ABI-encoded and send as eth_call.

Promise<any> callFn (: to:Address , method:string, args:any [])

Parameters:

to

Address

a 20 byte Address encoded as Hex (starting with 0x)

method

string

method

args

any []

args

Returns:

Promise<any>

chainId()¶

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

Promise<string> chainId ()

Returns:

Promise<string>

constructor()¶

constructor

any constructor (: client:IN3Generic<BigIntType,BufferType> )

Parameters:

client

IN3Generic<BigIntType,BufferType>

client

Returns:

any

contractAt()¶

contract at

contractAt (

abi:ABI [], address:Address )

Parameters:

abi

ABI []

abi

address

Address

a 20 byte Address encoded as Hex (starting with 0x)

decodeEventData()¶

decode event data

any decodeEventData (: log:Log , d:ABI )

Parameters:

log

Log

log

d

ABI

d

Returns:

any

estimateGas()¶

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> estimateGas (: tx:Transaction )

Parameters:

tx

Transaction

tx

Returns:

Promise<number>

gasPrice()¶

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

Promise<number> gasPrice ()

Returns:

Promise<number>

getBalance()¶

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

Promise<BigIntType> getBalance (: address:Address , block:BlockType )

Parameters:

address

Address

a 20 byte Address encoded as Hex (starting with 0x)

block

BlockType

BlockNumber or predefined Block

Returns:

Promise<BigIntType>

getBlockByHash()¶

Returns information about a block by hash.

Promise<Block> getBlockByHash (: hash:Hash , includeTransactions:boolean)

Parameters:

hash

Hash

a 32 byte Hash encoded as Hex (starting with 0x)

includeTransactions

boolean

include transactions

Returns:

getBlockByNumber()¶

Returns information about a block by block number.

Promise<Block> getBlockByNumber (: block:BlockType , includeTransactions:boolean)

Parameters:

block

BlockType

BlockNumber or predefined Block

includeTransactions

boolean

include transactions

Returns:

Promise<TransactionDetail>

getBlockTransactionCountByHash()¶

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

Promise<number> getBlockTransactionCountByHash (: block:Hash )

Parameters:

block

Hash

a 32 byte Hash encoded as Hex (starting with 0x)

Returns:

Promise<number>

getBlockTransactionCountByNumber()¶

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

Promise<number> getBlockTransactionCountByNumber (: block:Hash )

Parameters:

block

Hash

a 32 byte Hash encoded as Hex (starting with 0x)

Returns:

Promise<number>

getCode()¶

Returns code at a given address.

Promise<string> getCode (: address:Address , block:BlockType )

Parameters:

address

Address

a 20 byte Address encoded as Hex (starting with 0x)

block

BlockType

BlockNumber or predefined Block

Returns:

Promise<string>

getFilterChanges()¶

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

Promise<> getFilterChanges (: id:Quantity )

Parameters:

id

Quantity

a BigInteger encoded as hex.

Returns:

Promise<>

getFilterLogs()¶

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

Promise<> getFilterLogs (: id:Quantity )

Parameters:

id

Quantity

a BigInteger encoded as hex.

Returns:

Promise<>

getLogs()¶

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

Promise<> getLogs (: filter:LogFilter )

Parameters:

filter

LogFilter

filter

Returns:

Promise<>

getStorageAt()¶

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

Promise<string> getStorageAt (: address:Address , pos:Quantity , block:BlockType )

Parameters:

address

Address

a 20 byte Address encoded as Hex (starting with 0x)

pos

Quantity

a BigInteger encoded as hex.

block

BlockType

BlockNumber or predefined Block

Returns:

Promise<string>

getTransactionByBlockHashAndIndex()¶

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

Promise<TransactionDetail> getTransactionByBlockHashAndIndex (: hash:Hash , pos:Quantity )

Parameters:

hash

Hash

a 32 byte Hash encoded as Hex (starting with 0x)

pos

Quantity

a BigInteger encoded as hex.

Returns:

getTransactionByBlockNumberAndIndex()¶

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

Promise<TransactionDetail> getTransactionByBlockNumberAndIndex (: block:BlockType , pos:Quantity )

Parameters:

block

BlockType

BlockNumber or predefined Block

pos

Quantity

a BigInteger encoded as hex.

Returns:

Promise<TransactionDetail>

getTransactionByHash()¶

Returns the information about a transaction requested by transaction hash.

Promise<TransactionDetail> getTransactionByHash (: hash:Hash )

Parameters:

hash

Hash

a 32 byte Hash encoded as Hex (starting with 0x)

Returns:

Promise<TransactionDetail>

getTransactionCount()¶

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

Promise<number> getTransactionCount (: address:Address , block:BlockType )

Parameters:

address

Address

a 20 byte Address encoded as Hex (starting with 0x)

block

BlockType

BlockNumber or predefined Block

Returns:

Promise<number>

getTransactionReceipt()¶

Returns the receipt of a transaction by transaction hash. Note That the receipt is available even for pending transactions.

Promise<TransactionReceipt> getTransactionReceipt (: hash:Hash )

Parameters:

hash

Hash

a 32 byte Hash encoded as Hex (starting with 0x)

Returns:

Promise<TransactionReceipt>

getUncleByBlockHashAndIndex()¶

Returns information about a uncle of a block by hash and uncle index position. Note: An uncle doesn’t contain individual transactions.

Promise<Block> getUncleByBlockHashAndIndex (: hash:Hash , pos:Quantity )

Parameters:

hash

Hash

a 32 byte Hash encoded as Hex (starting with 0x)

pos

Quantity

a BigInteger encoded as hex.

Returns:

getUncleByBlockNumberAndIndex()¶

Returns information about a uncle of a block number and uncle index position. Note: An uncle doesn’t contain individual transactions.

Promise<Block> getUncleByBlockNumberAndIndex (: block:BlockType , pos:Quantity )

Parameters:

block

BlockType

BlockNumber or predefined Block

pos

Quantity

a BigInteger encoded as hex.

Returns:

getUncleCountByBlockHash()¶

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

Promise<number> getUncleCountByBlockHash (: hash:Hash )

Parameters:

hash

Hash

a 32 byte Hash encoded as Hex (starting with 0x)

Returns:

Promise<number>

getUncleCountByBlockNumber()¶

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

Promise<number> getUncleCountByBlockNumber (: block:BlockType )

Parameters:

block

BlockType

BlockNumber or predefined Block

Returns:

Promise<number>

hashMessage()¶

a Hexcoded String (starting with 0x)

Hex hashMessage (: data:Data )

Parameters:

data

Data

data encoded as Hex (starting with 0x)

Returns:

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> newBlockFilter ()

Returns:

Promise<string>

newFilter()¶

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.

A note on specifying topic filters: Topics are order-dependent. A transaction with a log with topics [A, B] will be matched by the following topic filters:

[] “anything” [A] “A in first position (and anything after)” [null, B] “anything in first position AND B in second position (and anything after)” [A, B] “A in first position AND B in second position (and anything after)” [[A, B], [A, B]] “(A OR B) in first position AND (A OR B) in second position (and anything after)”

Promise<string> newFilter (: filter:LogFilter )

Parameters:

filter

LogFilter

filter

Returns:

Promise<string>

newPendingTransactionFilter()¶

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

To check if the state has changed, call eth_getFilterChanges.

Promise<string> newPendingTransactionFilter ()

Returns:

Promise<string>

protocolVersion()¶

Returns the current ethereum protocol version.

Promise<string> protocolVersion ()

Returns:

Promise<string>

resolveENS()¶

resolves a name as an ENS-Domain.

Promise<Address> resolveENS (: name:string, type:Address , registry:string)

Parameters:

name

string

the domain name

type

Address

the type (currently only addr is supported)

registry

string

optionally the address of the registry (default is the mainnet ens registry)

Returns:

Promise<Address>

sendRawTransaction()¶

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

Promise<string> sendRawTransaction (: data:Data )

Parameters:

data

Data

data encoded as Hex (starting with 0x)

Returns:

Promise<string>

sendTransaction()¶

sends a Transaction

Promise<> sendTransaction (: args:TxRequest )

Parameters:

args

TxRequest

args

Returns:

Promise<>

sign()¶

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

Promise<BufferType> sign (: account:Address , data:Data )

Parameters:

account

Address

the address to sign the message with (if this is a 32-bytes hex-string it will be used as private key)

data

Data

the data to sign (Buffer, hexstring or utf8-string)

Returns:

syncing()¶

Returns the current ethereum protocol version.

Promise<> syncing ()

Returns:

Promise<>

uninstallFilter()¶

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.

Promise<Quantity> uninstallFilter (: id:Quantity )

Parameters:

id

Quantity

a BigInteger encoded as hex.

Returns:

Promise<Quantity>

Type IN3Config¶

Source: in3.d.ts

the configuration of the IN3-Client. This can be changed at any time. All properties are optional and will be verified when sending the next request.

autoUpdateList

boolean

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

default: true

(optional)

chainId

string

The chain-id based on EIP-155.

or the name of the supported chain.

Currently we support ‘mainnet’, ‘goerli’, ‘kovan’, ‘ipfs’ and ‘local’

While most of the chains use preconfigured chain settings,

‘local’ actually uses the local running client turning of proof.

example: ‘0x1’ or ‘mainnet’ or ‘goerli’

default: ‘mainnet’

chainRegistry

string

main chain-registry contract

example: 0xe36179e2286ef405e929C90ad3E70E649B22a945 (optional)

finality

number

the number in percent needed in order reach finality if you run on a POA-Chain.

(% of signature of the validators)

default: 0

(optional)

includeCode

boolean

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

default: false

(optional)

keepIn3

boolean

if true, the in3-section of the response will be kept and returned.

Otherwise it will be removed after validating the data.

This is useful for debugging or if the proof should be used afterwards.

default: false

(optional)

key

Hash

the key to sign requests. This is required for payments. (optional)

mainChain

string

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

example: 0x1 (optional)

maxAttempts

number

max number of attempts in case a response is rejected.

Incubed will retry to find a different node giving a verified response.

default: 5

(optional)

maxCodeCache

number

number of max bytes used to cache the code in memory.

default: 0

(optional)

minDeposit

number

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

default: 0

nodeLimit

number

the limit of nodes to store in the client. If set a random seed will be picked, which is the base for a deterministic verifiable partial nodelist.

default: 0

(optional)

nodeProps

number | Hex

a bitmask-value combining the minimal properties as filter for the selected nodes. See https://in3.readthedocs.io/en/develop/spec.html#node-structure for details.

nodes

the nodelists per chain. the chain_id will be used as key within the object. (optional)

proof

'none' | 'standard' | 'full'

if true the nodes should send a proof of the response

default: ‘standard’

(optional)

replaceLatestBlock

number

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

default: 6

(optional)

requestCount

number

the number of request send when getting a first answer

default: 1

rpc

string

url of a rpc-endpoints to use. If this is set proof will be turned off and it will be treated like local_chain. (optional)

signatureCount

number

number of signatures requested. The more signatures, the more security you get, but responses may take longer.

default: 0

(optional)

stats

boolean

if false, the requests will not be included in the stats of the nodes ( or marked as intern ).

default: true

(optional)

timeout

number

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

default: 5000

(optional)

Type IN3NodeConfig¶

Source: in3.d.ts

a configuration of a in3-server.

address

string

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

example: 0x6C1a01C2aB554930A937B0a2E8105fB47946c679

capacity

number

the capacity of the node.

example: 100 (optional)

chainIds

string []

the list of supported chains

example: 0x1

deposit

number

the deposit of the node in wei

example: 12350000

index

number

the index within the contract

example: 13 (optional)

props

number

the properties of the node.

example: 3 (optional)

registerTime

number

the UNIX-timestamp when the node was registered

example: 1563279168 (optional)

timeout

number

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

example: 3600 (optional)

unregisterTime

number

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

example: 1563279168 (optional)

url

string

the endpoint to post to

example: https://in3.slock.it

Type IN3NodeWeight¶

Source: in3.d.ts

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

avgResponseTime

number

average time of a response in ms

example: 240 (optional)

blacklistedUntil

number

blacklisted because of failed requests until the timestamp

example: 1529074639623 (optional)

lastRequest

number

timestamp of the last request in ms

example: 1529074632623 (optional)

pricePerRequest

number

last price (optional)

responseCount

number

number of uses.

example: 147 (optional)

weight

number

factor the weight this noe (default 1.0)

example: 0.5 (optional)

Type IpfsAPI¶

Source: in3.d.ts

API for storing and retrieving IPFS-data.

get()¶

retrieves the content for a hash from IPFS.

Promise<BufferType> get (: multihash:string)

Parameters:

multihash

string

the IPFS-hash to fetch

Returns:

put()¶

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

Promise<string> put (: content:BufferType )

Parameters:

content

BufferType

puts a IPFS content

Returns:

Promise<string>

Type RPCRequest¶

Source: in3.d.ts

a JSONRPC-Request with N3-Extension

id

number | string

the identifier of the request

example: 2 (optional)

jsonrpc

'2.0'

the version

method

string

the method to call

example: eth_getBalance

params

any []

the params

example: 0xe36179e2286ef405e929C90ad3E70E649B22a945,latest (optional)

Type RPCResponse¶

Source: in3.d.ts

a JSONRPC-Responset with N3-Extension

error

string

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

id

string | number

the id matching the request

example: 2

jsonrpc

'2.0'

the version

result

any

the params

example: 0xa35bc (optional)

Type Signer¶

Source: in3.d.ts

prepareTransaction()¶

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

Promise<Transaction> prepareTransaction (: client:IN3Generic<BigIntType,BufferType> , tx:Transaction )

Parameters:

client

IN3Generic<BigIntType,BufferType>

client

tx

Transaction

tx

Returns:

Promise<Transaction>

sign()¶

signing of any data. if hashFirst is true the data should be hashed first, otherwise the data is the hash.

Promise<BufferType> sign (: data:Hex , account:Address , hashFirst:boolean, ethV:boolean)

Parameters:

data

Hex

a Hexcoded String (starting with 0x)

account

Address

a 20 byte Address encoded as Hex (starting with 0x)

hashFirst

boolean

hash first

ethV

boolean

eth v

Returns:

canSign()¶

returns true if the account is supported (or unlocked)

Promise<boolean> canSign (: address:Address )

Parameters:

address

Address

a 20 byte Address encoded as Hex (starting with 0x)

Returns:

Promise<boolean>

Type Utils¶

Source: in3.d.ts

Collection of different util-functions.

abiDecode()¶

decodes the given data as ABI-encoded (without the methodHash)

any [] abiDecode (: signature:string, data:Data )

Parameters:

signature

string

the method signature, which must contain a return description

data

Data

the data to decode

Returns:

any []

abiEncode()¶

encodes the given arguments as ABI-encoded (including the methodHash)

Hex abiEncode (: signature:string, args:any [])

Parameters:

signature

string

the method signature

args

any []

the arguments

Returns:

createSignatureHash()¶

a Hexcoded String (starting with 0x)

Hex createSignatureHash (: def:ABI )

Parameters:

def

ABI

def

Returns:

decodeEvent()¶

decode event

any decodeEvent (: log:Log , d:ABI )

Parameters:

log

Log

log

d

ABI

d

Returns:

any

ecSign()¶

create a signature (65 bytes) for the given message and kexy

BufferType ecSign (: pk:Hex | BufferType , msg:Hex | BufferType , hashFirst:boolean, adjustV:boolean)

Parameters:

pk

Hex

| BufferType

the private key

msg

Hex

| BufferType

the message

hashFirst

boolean

if true the message will be hashed first (default:true), if not the message is the hash.

adjustV

boolean

if true (default) the v value will be adjusted by adding 27

Returns:

keccak()¶

calculates the keccack hash for the given data.

BufferType keccak (: data:BufferType | Data )

Parameters:

data

BufferType

| Data

the data as Uint8Array or hex data.

Returns:

private2address()¶

generates the public address from the private key.

Address private2address (: pk:Hex | BufferType )

Parameters:

pk

Hex

| BufferType

the private key.

Returns:

Address

soliditySha3()¶

solidity sha3

string soliditySha3 (: args:any [])

Parameters:

args

any []

args

Returns:

string

splitSignature()¶

takes raw signature (65 bytes) and splits it into a signature object.

Signature splitSignature (: signature:Hex | BufferType , message:BufferType | Hex , hashFirst:boolean)

Parameters:

signature

Hex

| BufferType

the 65 byte-signature

message

BufferType

| Hex

the message

hashFirst

boolean

if true (default) this will be taken as raw-data and will be hashed first.

Returns:

Signature

toBuffer()¶

converts any value to a Buffer. optionally the target length can be specified (in bytes)

BufferType toBuffer (: data:Hex | BufferType | number | bigint, len:number)

Parameters:

data

Hex

| BufferType

| number

| bigint

data

len

number

len

Returns:

toChecksumAddress()¶

generates a checksum Address for the given address. If the chainId is passed, it will be included accord to EIP 1191

Address toChecksumAddress (: address:Address , chainId:number)

Parameters:

address

Address

the address (as hex)

chainId

number

the chainId (if supported)

Returns:

Address

toHex()¶

converts any value to a hex string (with prefix 0x). optionally the target length can be specified (in bytes)

Hex toHex (: data:Hex | BufferType | number | bigint, len:number)

Parameters:

data

Hex

| BufferType

| number

| bigint

data

len

number

len

Returns:

toMinHex()¶

removes all leading 0 in the hexstring

string toMinHex (: key:string | BufferType | number)

Parameters:

key

string

| BufferType

| number

key

Returns:

string

toNumber()¶

converts any value to a hex string (with prefix 0x). optionally the target length can be specified (in bytes)

number toNumber (: data:string | BufferType | number | bigint)

Parameters:

data

string

| BufferType

| number

| bigint

data

Returns:

number

toUint8Array()¶

converts any value to a Uint8Array. optionally the target length can be specified (in bytes)

BufferType toUint8Array (: data:Hex | BufferType | number | bigint, len:number)

Parameters:

data

Hex

| BufferType

| number

| bigint

data

len

number

len

Returns:

https://github.com/slockit/in3-example-android

toUtf8()¶

convert to String

string toUtf8 (: val:any)

Parameters:

val

any

val

Returns:

string

Type ABI¶

Source: in3.d.ts

anonymous

boolean

the anonymous (optional)

constant

boolean

the constant (optional)

inputs

ABIField []

the inputs (optional)

name

string

the name (optional)

outputs

ABIField []

the outputs (optional)

payable

boolean

the payable (optional)

stateMutability

'nonpayable'

| 'payable'

| 'view'

| 'pure'

the stateMutability (optional)

type

'event'

| 'function'

| 'constructor'

| 'fallback'

the type

Type ABIField¶

Source: in3.d.ts

indexed

boolean

the indexed (optional)

name

string

the name

type

string

the type

Type Address¶

Source: in3.d.ts

a 20 byte Address encoded as Hex (starting with 0x) a Hexcoded String (starting with 0x) = string

Type Block¶

Source: in3.d.ts

author

Address

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

difficulty

Quantity

integer of the difficulty for this block

extraData

Data

the ‘extra data’ field of this block

gasLimit

Quantity

the maximum gas allowed in this block

gasUsed

Quantity

the total used gas by all transactions in this block

hash

Hash

hash of the block. null when its pending block

logsBloom

Data

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

miner

Address

20 Bytes - alias of ‘author’

nonce

Data

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

number

Quantity

The block number. null when its pending block

parentHash

Hash

hash of the parent block

receiptsRoot

Data

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

sealFields

Data []

PoA-Fields

sha3Uncles

Data

SHA3 of the uncles data in the block

size

Quantity

integer the size of this block in bytes

stateRoot

Data

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

timestamp

Quantity

the unix timestamp for when the block was collated

totalDifficulty

Quantity

integer of the total difficulty of the chain until this block

transactions

string | []

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

transactionsRoot

Data

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

uncles

Hash []

Array of uncle hashes

Type Data¶

Source: in3.d.ts

data encoded as Hex (starting with 0x) a Hexcoded String (starting with 0x) = string

Type Hash¶

Source: in3.d.ts

a 32 byte Hash encoded as Hex (starting with 0x) a Hexcoded String (starting with 0x) = string

Type Log¶

Source: in3.d.ts

address

Address

20 Bytes - address from which this log originated.

blockHash

Hash

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

blockNumber

Quantity

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

data

Data

contains the non-indexed arguments of the log.

logIndex

Quantity

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

removed

boolean

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

topics

Data []

- Array of 0 to 4 32 Bytes DATA of indexed log arguments. (In solidity: The first topic is the hash of the signature of the event (e.g. Deposit(address,bytes32,uint256)), except you declared the event with the anonymous specifier.)

transactionHash

Hash

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

transactionIndex

Quantity

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

Type LogFilter¶

Source: in3.d.ts

address

Address

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

fromBlock

BlockType

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

limit

Quantity

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

toBlock

BlockType

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

topics

string | string [] []

(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 Signature¶

Source: in3.d.ts

Signature

message

Data

the message

messageHash

Hash

the messageHash

r

Hash

the r

s

Hash

the s

signature

Data

the signature (optional)

v

Hex

the v

Type Transaction¶

Source: in3.d.ts

chainId

any

optional chain id (optional)

data

string

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

from

Address

20 Bytes - The address the transaction is send from.

gas

Quantity

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

gasPrice

Quantity

Integer of the gas price used for each paid gas.

nonce

Quantity

nonce

to

Address

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

value

Quantity

Integer of the value sent with this transaction.

Type TransactionDetail¶

Source: in3.d.ts

blockHash

Hash

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

blockNumber

BlockType

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

chainId

Quantity

the chain id of the transaction, if any.

condition

any

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

creates

Address

creates contract address

from

Address

20 Bytes - address of the sender.

gas

Quantity

gas provided by the sender.

gasPrice

Quantity

gas price provided by the sender in Wei.

hash

Hash

32 Bytes - hash of the transaction.

input

Data

the data send along with the transaction.

nonce

Quantity

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

pk

any

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

publicKey

Hash

public key of the signer.

r

Quantity

the R field of the signature.

raw

Data

raw transaction data

standardV

Quantity

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

to

Address

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

transactionIndex

Quantity

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

v

Quantity

the standardised V field of the signature.

value

Quantity

value transferred in Wei.

Type TransactionReceipt¶

Source: in3.d.ts

blockHash

Hash

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

blockNumber

BlockType

block number where this transaction was in.

contractAddress

Address

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

cumulativeGasUsed

Quantity

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

from

Address

20 Bytes - The address of the sender.

gasUsed

Quantity

The amount of gas used by this specific transaction alone.

logs

Log []

Array of log objects, which this transaction generated.

logsBloom

Data

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

root

Hash

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

status

Quantity

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

to

Address

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

transactionHash

Hash

32 Bytes - hash of the transaction.

transactionIndex

Quantity

Integer of the transactions index position in the block.

Type TxRequest¶

Source: in3.d.ts

args

any []

the argument to pass to the method (optional)

confirmations

number

number of block to wait before confirming (optional)

data

Data

the data to send (optional)

from

Address

address of the account to use (optional)

gas

number

the gas needed (optional)

gasPrice

number

the gasPrice used (optional)

method

string

the ABI of the method to be used (optional)

nonce

number

the nonce (optional)

pk

Hash

raw private key in order to sign (optional)

to

Address

contract (optional)

value

Quantity

the value in wei (optional)

Type Hex¶

Source: in3.d.ts

a Hexcoded String (starting with 0x) = string

Type BlockType¶

Source: in3.d.ts

BlockNumber or predefined Block = number | 'latest' | 'earliest' | 'pending'

Type Quantity¶

Source: in3.d.ts

a BigInteger encoded as hex. = number | Hex

API Reference Java¶

Installing¶

The Incubed Java client uses JNI in order to call native functions. But all the native-libraries are bundled inside the jar-file. This jar file ha no dependencies and can even be used standalone:

like

java -cp in3.jar in3.IN3 eth_getBlockByNumber latest false

Downloading¶

The jar file can be downloaded from the latest release. here.

Alternatively, If you wish to download Incubed using the maven package manager, add this to your pom.xml

<dependency>
  <groupId>it.slock</groupId>
  <artifactId>in3</artifactId>
  <version>2.21</version>
</dependency> 

After which, install in3 with mvn install.

Building¶

For building the shared library you need to enable java by using the -DJAVA=true flag:

git clone git@github.com:slockit/in3-c.git
mkdir -p in3-c/build
cd in3-c/build
cmake -DJAVA=true .. && make

You will find the in3.jar in the build/lib - folder.

Android¶

In order to use Incubed in android simply follow these steps:

Step 1: Create a top-level CMakeLists.txt in android project inside app folder and link this to gradle. Follow the steps using this guide on howto link.

The Content of the CMakeLists.txt should look like this:

cmake_minimum_required(VERSION 3.4.1)

# turn off FAST_MATH in the evm.
ADD_DEFINITIONS(-DIN3_MATH_LITE)

# loop through the required module and cretae the build-folders
foreach(module 
  c/src/core 
  c/src/verifier/eth1/nano 
  c/src/verifier/eth1/evm 
  c/src/verifier/eth1/basic 
  c/src/verifier/eth1/full 
  java/src
  c/src/third-party/crypto 
  c/src/third-party/tommath 
  c/src/api/eth1)
        file(MAKE_DIRECTORY in3-c/${module}/outputs)
        add_subdirectory( in3-c/${module} in3-c/${module}/outputs )
endforeach()

Step 2: clone in3-c into the app-folder or use this script to clone and update in3:

#!/usr/bin/env sh

#github-url for in3-c
IN3_SRC=https://github.com/slockit/in3-c.git

cd app

# if it exists we only call git pull
if [ -d in3-c ]; then
    cd in3-c
    git pull
    cd ..
else
# if not we clone it
    git clone $IN3_SRC
fi


# copy the java-sources to the main java path
cp -r in3-c/java/src/in3 src/main/java/

Step 3: Use methods available in app/src/main/java/in3/IN3.java from android activity to access IN3 functions.

Here is example how to use it:

Examples¶

CallFunction¶

source : in3-c/java/examples/CallFunction.java

Calling Functions of Contracts

// This Example shows how to call functions and use the decoded results. Here we get the struct from the registry.

import in3.*;
import in3.eth1.*;

public class CallFunction {
  //
  public static void main(String[] args) {
    // create incubed
    IN3 in3 = IN3.forChain(Chain.MAINNET); // set it to mainnet (which is also dthe default)

    // call a contract, which uses eth_call to get the result.
    Object[] result = (Object[]) in3.getEth1API().call(                      // call a function of a contract
        "0x2736D225f85740f42D17987100dc8d58e9e16252",                        // address of the contract
        "servers(uint256):(string,address,uint256,uint256,uint256,address)", // function signature
        1);                                                                  // first argument, which is the index of the node we are looking for.

    System.out.println("url     : " + result[0]);
    System.out.println("owner   : " + result[1]);
    System.out.println("deposit : " + result[2]);
    System.out.println("props   : " + result[3]);
  }
}

Configure¶

source : in3-c/java/examples/Configure.java

Changing the default configuration

// In order to change the default configuration, just use the classes inside in3.config package.

package in3;

import in3.*;
import in3.config.*;
import in3.eth1.Block;

public class Configure {
  //
  public static void main(String[] args) {
    // create incubed client
    IN3 in3 = IN3.forChain(Chain.GOERLI); // set it to goerli

    // Setup a Configuration object for the client
    ClientConfiguration clientConfig = in3.getConfig();
    clientConfig.setReplaceLatestBlock(6); // define that latest will be -6
    clientConfig.setAutoUpdateList(false); // prevents node automatic update
    clientConfig.setMaxAttempts(1);        // sets max attempts to 1 before giving up
    clientConfig.setProof(Proof.none);     // does not require proof (not recommended)

    // Setup the ChainConfiguration object for the nodes on a certain chain
    ChainConfiguration chainConfiguration = new ChainConfiguration(Chain.GOERLI, clientConfig);
    chainConfiguration.setNeedsUpdate(false);
    chainConfiguration.setContract("0xac1b824795e1eb1f6e609fe0da9b9af8beaab60f");
    chainConfiguration.setRegistryId("0x23d5345c5c13180a8080bd5ddbe7cde64683755dcce6e734d95b7b573845facb");

    in3.setConfig(clientConfig);

    Block block = in3.getEth1API().getBlockByNumber(Block.LATEST, true);
    System.out.println(block.getHash());
  }
}

GetBalance¶

source : in3-c/java/examples/GetBalance.java

getting the Balance with or without API

import in3.*;
import in3.eth1.*;
import java.math.BigInteger;
import java.util.*;

public class GetBalance {

  static String AC_ADDR = "0xc94770007dda54cF92009BFF0dE90c06F603a09f";

  public static void main(String[] args) throws Exception {
    // create incubed
    IN3 in3 = IN3.forChain(Chain.MAINNET); // set it to mainnet (which is also dthe default)

    System.out.println("Balance API" + getBalanceAPI(in3).longValue());

    System.out.println("Balance RPC " + getBalanceRPC(in3));
  }

  static BigInteger getBalanceAPI(IN3 in3) {
    return in3.getEth1API().getBalance(AC_ADDR, Block.LATEST);
  }

  static String getBalanceRPC(IN3 in3) {
    return in3.sendRPC("eth_getBalance", new Object[] {AC_ADDR, "latest"});
  }
}

GetBlockAPI¶

source : in3-c/java/examples/GetBlockAPI.java

getting a block with API

import in3.*;
import in3.eth1.*;
import java.math.BigInteger;
import java.util.*;

public class GetBlockAPI {
  //
  public static void main(String[] args) throws Exception {
    // create incubed
    IN3 in3 = IN3.forChain(Chain.MAINNET); // set it to mainnet (which is also dthe default)

    // read the latest Block including all Transactions.
    Block latestBlock = in3.getEth1API().getBlockByNumber(Block.LATEST, true);

    // Use the getters to retrieve all containing data
    System.out.println("current BlockNumber : " + latestBlock.getNumber());
    System.out.println("minded at : " + new Date(latestBlock.getTimeStamp()) + " by " + latestBlock.getAuthor());

    // get all Transaction of the Block
    Transaction[] transactions = latestBlock.getTransactions();

    BigInteger sum = BigInteger.valueOf(0);
    for (int i = 0; i < transactions.length; i++)
      sum = sum.add(transactions[i].getValue());

    System.out.println("total Value transfered in all Transactions : " + sum + " wei");
  }
}

GetBlockRPC¶

source : in3-c/java/examples/GetBlockRPC.java

getting a block without API

import in3.*;
import in3.eth1.*;
import java.math.BigInteger;
import java.util.*;

public class GetBlockRPC {
  //
  public static void main(String[] args) throws Exception {
    // create incubed
    IN3 in3 = IN3.forChain(Chain.MAINNET); // set it to mainnet (which is also the default)

    // read the latest Block without the Transactions.
    String result = in3.sendRPC("eth_getBlockByNumber", new Object[] {"latest", false});

    // print the json-data
    System.out.println("current Block : " + result);
  }
}

GetTransaction¶

source : in3-c/java/examples/GetTransaction.java

getting a Transaction with or without API

import in3.*;
import in3.eth1.*;
import java.math.BigInteger;
import java.util.*;

public class GetTransaction {

  static String TXN_HASH = "0xdd80249a0631cf0f1593c7a9c9f9b8545e6c88ab5252287c34bc5d12457eab0e";

  public static void main(String[] args) throws Exception {
    // create incubed
    IN3 in3 = IN3.forChain(Chain.MAINNET); // set it to mainnet (which is also dthe default)

    Transaction txn = getTransactionAPI(in3);
    System.out.println("Transaction API #blockNumber: " + txn.getBlockNumber());

    System.out.println("Transaction RPC :" + getTransactionRPC(in3));
  }

  static Transaction getTransactionAPI(IN3 in3) {
    return in3.getEth1API().getTransactionByHash(TXN_HASH);
  }

  static String getTransactionRPC(IN3 in3) {
    return in3.sendRPC("eth_getTransactionByHash", new Object[] {TXN_HASH});
  }
}

GetTransactionReceipt¶

source : in3-c/java/examples/GetTransactionReceipt.java

getting a TransactionReceipt with or without API

import in3.*;
import in3.eth1.*;
import java.math.BigInteger;
import java.util.*;

public class GetTransactionReceipt {
  static String TRANSACTION_HASH = "0xdd80249a0631cf0f1593c7a9c9f9b8545e6c88ab5252287c34bc5d12457eab0e";

  //
  public static void main(String[] args) throws Exception {
    // create incubed
    IN3 in3 = IN3.forChain(Chain.MAINNET); // set it to mainnet (which is also the default)

    TransactionReceipt txn = getTransactionReceiptAPI(in3);
    System.out.println("TransactionRerceipt API : for txIndex " + txn.getTransactionIndex() + " Block num " + txn.getBlockNumber() + " Gas used " + txn.getGasUsed() + " status " + txn.getStatus());

    System.out.println("TransactionReceipt RPC : " + getTransactionReceiptRPC(in3));
  }

  static TransactionReceipt getTransactionReceiptAPI(IN3 in3) {
    return in3.getEth1API().getTransactionReceipt(TRANSACTION_HASH);
  }

  static String getTransactionReceiptRPC(IN3 in3) {
    return in3.sendRPC("eth_getTransactionReceipt", new Object[] {TRANSACTION_HASH});
  }
}

SendTransaction¶

source : in3-c/java/examples/SendTransaction.java

Sending Transactions

// In order to send, you need a Signer. The SimpleWallet class is a basic implementation which can be used.

package in3;

import in3.*;
import in3.eth1.*;
import java.io.IOException;
import java.math.BigInteger;
import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.nio.file.Paths;

public class SendTransaction {
  //
  public static void main(String[] args) throws IOException {
    // create incubed
    IN3 in3 = IN3.forChain(Chain.MAINNET); // set it to mainnet (which is also dthe default)

    // create a wallet managing the private keys
    SimpleWallet wallet = new SimpleWallet();

    // add accounts by adding the private keys
    String keyFile      = "myKey.json";
    String myPassphrase = "<secrect>";

    // read the keyfile and decoded the private key
    String account = wallet.addKeyStore(
        Files.readString(Paths.get(keyFile)),
        myPassphrase);

    // use the wallet as signer
    in3.setSigner(wallet);

    String     receipient = "0x1234567890123456789012345678901234567890";
    BigInteger value      = BigInteger.valueOf(100000);

    // create a Transaction
    TransactionRequest tx = new TransactionRequest();
    tx.setFrom(account);
    tx.setTo("0x1234567890123456789012345678901234567890");
    tx.setFunction("transfer(address,uint256)");
    tx.setParams(new Object[] {receipient, value});

    String txHash = in3.getEth1API().sendTransaction(tx);

    System.out.println("Transaction sent with hash = " + txHash);
  }
}

Building¶

In order to run those examples, you only need a Java SDK installed.

./build.sh

will build all examples in this directory.

In order to run a example use

java -cp $IN3/build/lib/in3.jar:. GetBlockAPI

Package in3¶

class BlockID¶

fromHash¶

public static BlockID fromHash(String hash);

arguments:

String hash

fromNumber¶

public static BlockID fromNumber(long number);

arguments:

long number

getNumber¶

public Long getNumber();

setNumber¶

public void setNumber(long block);

arguments:

long block

getHash¶

public String getHash();

setHash¶

public void setHash(String hash);

arguments:

String hash

toJSON¶

public String toJSON();

toString¶

public String toString();

class Chain¶

Constants for Chain-specs.

MULTICHAIN¶

support for multiple chains, a client can then switch between different chains (but consumes more memory)

Type: static final long

MAINNET¶

use mainnet

Type: static final long

KOVAN¶

use kovan testnet

Type: static final long

TOBALABA¶

use tobalaba testnet

Type: static final long

GOERLI¶

use goerli testnet

Type: static final long

EVAN¶

use evan testnet

Type: static final long

IPFS¶

use ipfs

Type: static final long

VOLTA¶

use volta test net

Type: static final long

LOCAL¶

use local client

Type: static final long

class IN3¶

This is the main class creating the incubed client.

The client can then be configured.

IN3¶

public IN3();

getKey¶

the client key to sign requests

public native byte[] getKey();

setKey¶

sets the client key to sign requests

public native void setKey(byte[] val);

arguments:

byte[] val

getConfig¶

returns the current configuration.

any changes to the configuration will be applied witth the next request.

public ClientConfiguration getConfig();

setKey¶

sets the client key as hexstring to sign requests

public void setKey(String val);

arguments:

String val

setSigner¶

sets the signer or wallet.

public void setSigner(Signer signer);

arguments:

Signer

signer

getSigner¶

returns the signer or wallet.

public Signer getSigner();

getIpfs¶

gets the ipfs-api

public in3.ipfs.API getIpfs();

getEth1API¶

gets the ethereum-api

public in3.eth1.API getEth1API();

getCrypto¶

gets the utils/crypto-api

public Crypto getCrypto();

setStorageProvider¶

provides the ability to cache content like nodelists, contract codes and validatorlists

public void setStorageProvider(StorageProvider val);

arguments:

StorageProvider

val

getStorageProvider¶

provides the ability to cache content

public StorageProvider getStorageProvider();

setTransport¶

sets The transport interface.

This allows to fetch the result of the incubed in a different way.

public void setTransport(IN3Transport newTransport);

arguments:

IN3Transport newTransport

getTransport¶

returns the current transport implementation.

public IN3Transport getTransport();

getChainId¶

servers to filter for the given chain.

The chain-id based on EIP-155.

public native long getChainId();

setChainId¶

sets the chain to be used.

The chain-id based on EIP-155.

public native void setChainId(long val);

arguments:

long val

send¶

send a request.

The request must a valid json-string with method and params

public String send(String request);

arguments:

String request

sendobject¶

send a request but returns a object like array or map with the parsed response.

The request must a valid json-string with method and params

public Object sendobject(String request);

arguments:

String request

sendRPC¶

send a RPC request by only passing the method and params.

It will create the raw request from it and return the result.

public String sendRPC(String method, Object[] params);

arguments:

`String`	method
`Object[]`	params

sendRPCasObject¶

public Object sendRPCasObject(String method, Object[] params, boolean useEnsResolver);

arguments:

`String`	method
`Object[]`	params
`boolean`	useEnsResolver

sendRPCasObject¶

send a RPC request by only passing the method and params.

It will create the raw request from it and return the result.

public Object sendRPCasObject(String method, Object[] params);

arguments:

`String`	method
`Object[]`	params

cacheClear¶

clears the cache.

public boolean cacheClear();

nodeList¶

restrieves the node list

public IN3Node[] nodeList();

sign¶

request for a signature of an already verified hash.

public SignedBlockHash[] sign(BlockID[] blocks, String[] dataNodeAdresses);

arguments:

BlockID[]	blocks
`String[]`	dataNodeAdresses

forChain¶

create a Incubed client using the chain-config.

if chainId is Chain.MULTICHAIN, the client can later be switched between different chains, for all other chains, it will be initialized only with the chainspec for this one chain (safes memory)

public static IN3 forChain(long chainId);

arguments:

long chainId

getVersion¶

returns the current incubed version.

public static native String getVersion();

main¶

public static void main(String[] args);

arguments:

String[] args

class IN3DefaultTransport¶

handle¶

public byte[][] handle(String[] urls, byte[] payload);

arguments:

`String[]`	urls
`byte[]`	payload

class IN3Node¶

getUrl¶

public String getUrl();

getAddress¶

public String getAddress();

getIndex¶

public int getIndex();

getDeposit¶

public String getDeposit();

getProps¶

public long getProps();

getTimeout¶

public int getTimeout();

getRegisterTime¶

public int getRegisterTime();

getWeight¶

public int getWeight();

class IN3Props¶

IN3Props¶

public IN3Props();

setDataNodes¶

public void setDataNodes(String[] adresses);

arguments:

String[] adresses

setSignerNodes¶

public void setSignerNodes(String[] adresses);

arguments:

String[] adresses

toString¶

public String toString();

toJSON¶

public String toJSON();

class Loader¶

loadLibrary¶

public static void loadLibrary();

class NodeList¶

getNodes¶

returns an array of IN3Node

public IN3Node[] getNodes();

class NodeProps¶

NODE_PROP_PROOF¶

Type: static final long

NODE_PROP_MULTICHAIN¶

Type: static final long

NODE_PROP_ARCHIVE¶

Type: static final long

NODE_PROP_HTTP¶

Type: static final long

NODE_PROP_BINARY¶

Type: static final long

NODE_PROP_ONION¶

Type: static final long

NODE_PROP_STATS¶

Type: static final long

class SignedBlockHash¶

getBlockHash¶

public String getBlockHash();

getBlock¶

public long getBlock();

getR¶

public String getR();

getS¶

public String getS();

getV¶

public long getV();

getMsgHash¶

public String getMsgHash();

enum Proof¶

The Proof type indicating how much proof is required.

The enum type contains the following values:

none	0	No Verification.
standard	1	Standard Verification of the important properties.
full	2	Full Verification including even uncles wich leads to higher payload.

interface IN3Transport¶

handle¶

public byte[][] handle(String[] urls, byte[] payload);

arguments:

`String[]`	urls
`byte[]`	payload

Package in3.config¶

class ChainConfiguration¶

Part of the configuration hierarchy for IN3 Client.

Holds the configuration a node group in a particular Chain.

nodesConfig¶

Type: NodeConfigurationArrayList< , >

ChainConfiguration¶

public ChainConfiguration(long chain, ClientConfiguration config);

arguments:

`long`	chain
ClientConfiguration	config

getChain¶

public long getChain();

isNeedsUpdate¶

public Boolean isNeedsUpdate();

setNeedsUpdate¶

public void setNeedsUpdate(boolean needsUpdate);

arguments:

boolean needsUpdate

getContract¶

public String getContract();

setContract¶

public void setContract(String contract);

arguments:

String contract

getRegistryId¶

public String getRegistryId();

setRegistryId¶

public void setRegistryId(String registryId);

arguments:

String registryId

getWhiteListContract¶

public String getWhiteListContract();

setWhiteListContract¶

public void setWhiteListContract(String whiteListContract);

arguments:

String whiteListContract

getWhiteList¶

public String[] getWhiteList();

setWhiteList¶

public void setWhiteList(String[] whiteList);

arguments:

String[] whiteList

toJSON¶

generates a json-string based on the internal data.

public String toJSON();

toString¶

public String toString();

class ClientConfiguration¶

Configuration Object for Incubed Client.

It holds the state for the root of the configuration tree. Should be retrieved from the client instance as IN3::getConfig()

getRequestCount¶

public Integer getRequestCount();

setRequestCount¶

sets the number of requests send when getting a first answer

public void setRequestCount(int requestCount);

arguments:

int requestCount

isAutoUpdateList¶

public Boolean isAutoUpdateList();

setAutoUpdateList¶

activates the auto update.if true the nodelist will be automaticly updated if the lastBlock is newer

public void setAutoUpdateList(boolean autoUpdateList);

arguments:

boolean autoUpdateList

getProof¶

public Proof getProof();

setProof¶

sets the type of proof used

public void setProof(Proof proof);

arguments:

Proof

proof

getMaxAttempts¶

public Integer getMaxAttempts();

setMaxAttempts¶

sets the max number of attempts before giving up

public void setMaxAttempts(int maxAttempts);

arguments:

int maxAttempts

getSignatureCount¶

public Integer getSignatureCount();

setSignatureCount¶

sets the number of signatures used to proof the blockhash.

public void setSignatureCount(int signatureCount);

arguments:

int signatureCount

isStats¶

public Boolean isStats();

setStats¶

if true (default) the request will be counted as part of the regular stats, if not they are not shown as part of the dashboard.

public void setStats(boolean stats);

arguments:

boolean stats

getFinality¶

public Integer getFinality();

setFinality¶

sets the number of signatures in percent required for the request

public void setFinality(int finality);

arguments:

int finality

isIncludeCode¶

public Boolean isIncludeCode();

setIncludeCode¶

public void setIncludeCode(boolean includeCode);

arguments:

boolean includeCode

isKeepIn3¶

public Boolean isKeepIn3();

setKeepIn3¶

public void setKeepIn3(boolean keepIn3);

arguments:

boolean keepIn3

isUseBinary¶

public Boolean isUseBinary();

setUseBinary¶

public void setUseBinary(boolean useBinary);

arguments:

boolean useBinary

isUseHttp¶

public Boolean isUseHttp();

setUseHttp¶

public void setUseHttp(boolean useHttp);

arguments:

boolean useHttp

getMaxCodeCache¶

public Long getMaxCodeCache();

setMaxCodeCache¶

sets number of max bytes used to cache the code in memory

public void setMaxCodeCache(long maxCodeCache);

arguments:

long maxCodeCache

getTimeout¶

public Long getTimeout();

setTimeout¶

specifies the number of milliseconds before the request times out.

increasing may be helpful if the device uses a slow connection.

public void setTimeout(long timeout);

arguments:

long timeout

getMinDeposit¶

public Long getMinDeposit();

setMinDeposit¶

sets min stake of the server.

Only nodes owning at least this amount will be chosen.

public void setMinDeposit(long minDeposit);

arguments:

long minDeposit

getNodeProps¶

public Long getNodeProps();

setNodeProps¶

public void setNodeProps(long nodeProps);

arguments:

long nodeProps

getNodeLimit¶

public Long getNodeLimit();

setNodeLimit¶

sets the limit of nodes to store in the client.

public void setNodeLimit(long nodeLimit);

arguments:

long nodeLimit

getReplaceLatestBlock¶

public Integer getReplaceLatestBlock();

setReplaceLatestBlock¶

replaces the latest with blockNumber- specified value

public void setReplaceLatestBlock(int replaceLatestBlock);

arguments:

int replaceLatestBlock

getRpc¶

public String getRpc();

setRpc¶

setup an custom rpc source for requests by setting Chain to local and proof to none

public void setRpc(String rpc);

arguments:

String rpc

getMaxBlockCache¶

public Long getMaxBlockCache();

setMaxBlockCache¶

sets the number of blocks cached in memory

public void setMaxBlockCache(long maxBlockCache);

arguments:

long maxBlockCache

getNodesConfig¶

public ChainConfigurationHashMap< Long, , > getNodesConfig();

setChainsConfig¶

public void setChainsConfig(HashMap< Long, ChainConfiguration >);

arguments:

ChainConfigurationHashMap< Long, , >

chainsConfig

markAsSynced¶

public void markAsSynced();

isSynced¶

public boolean isSynced();

toString¶

public String toString();

toJSON¶

generates a json-string based on the internal data.

public String toJSON();

class NodeConfiguration¶

Configuration Object for Incubed Client.

It represents the node of a nodelist.

NodeConfiguration¶

public NodeConfiguration(ChainConfiguration config);

arguments:

ChainConfiguration

config

getUrl¶

public String getUrl();

setUrl¶

public void setUrl(String url);

arguments:

String url

getProps¶

public long getProps();

setProps¶

public void setProps(long props);

arguments:

long props

getAddress¶

public String getAddress();

setAddress¶

public void setAddress(String address);

arguments:

String address

toString¶

public String toString();

interface Configuration¶

an Interface class, which is able to generate a JSON-String.

toJSON¶

generates a json-string based on the internal data.

public String toJSON();

Package in3.eth1¶

class API¶

a Wrapper for the incubed client offering Type-safe Access and additional helper functions.

API¶

creates an eth1.API using the given incubed instance.

public API(IN3 in3);

arguments:

in3

getBlockByNumber¶

finds the Block as specified by the number.

use Block.LATEST for getting the lastest block.

public Block getBlockByNumber(long block, boolean includeTransactions);

arguments:

`long`	block
`boolean`	includeTransactions	< the Blocknumber < if true all Transactions will be includes, if not only the transactionhashes

getBlockByHash¶

Returns information about a block by hash.

public Block getBlockByHash(String blockHash, boolean includeTransactions);

arguments:

`String`	blockHash
`boolean`	includeTransactions	< the Blocknumber < if true all Transactions will be includes, if not only the transactionhashes

getBlockNumber¶

the current BlockNumber.

public long getBlockNumber();

getGasPrice¶

the current Gas Price.

public long getGasPrice();

getChainId¶

Returns the EIP155 chain ID used for transaction signing at the current best block.

Null is returned if not available.

public String getChainId();

call¶

calls a function of a smart contract and returns the result.

public Object call(TransactionRequest request, long block);

arguments:

TransactionRequest	request
`long`	block	< the transaction to call. < the Block used to for the state.

returns: Object : the decoded result. if only one return value is expected the Object will be returned, if not an array of objects will be the result.

estimateGas¶

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.

public long estimateGas(TransactionRequest request, long block);

arguments:

TransactionRequest	request
`long`	block	< the transaction to call. < the Block used to for the state.

returns: long : the gas required to call the function.

getBalance¶

Returns the balance of the account of given address in wei.

public BigInteger getBalance(String address, long block);

arguments:

`String`	address
`long`	block

getCode¶

Returns code at a given address.

public String getCode(String address, long block);

arguments:

`String`	address
`long`	block

getStorageAt¶

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

public String getStorageAt(String address, BigInteger position, long block);

arguments:

`String`	address
`BigInteger`	position
`long`	block

getBlockTransactionCountByHash¶

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

public long getBlockTransactionCountByHash(String blockHash);

arguments:

String blockHash

getBlockTransactionCountByNumber¶

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

public long getBlockTransactionCountByNumber(long block);

arguments:

long block

getFilterChangesFromLogs¶

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

public Log[] getFilterChangesFromLogs(long id);

arguments:

long id

getFilterChangesFromBlocks¶

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

public String[] getFilterChangesFromBlocks(long id);

arguments:

long id

getFilterLogs¶

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

public Log[] getFilterLogs(long id);

arguments:

long id

getLogs¶

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

public Log[] getLogs(LogFilter filter);

arguments:

LogFilter

filter

getTransactionByBlockHashAndIndex¶

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

public Transaction getTransactionByBlockHashAndIndex(String blockHash, int index);

arguments:

`String`	blockHash
`int`	index

getTransactionByBlockNumberAndIndex¶

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

public Transaction getTransactionByBlockNumberAndIndex(long block, int index);

arguments:

`long`	block
`int`	index

getTransactionByHash¶

Returns the information about a transaction requested by transaction hash.

public Transaction getTransactionByHash(String transactionHash);

arguments:

String transactionHash

getTransactionCount¶

Returns the number of transactions sent from an address.

public BigInteger getTransactionCount(String address, long block);

arguments:

`String`	address
`long`	block

getTransactionReceipt¶

Returns the number of transactions sent from an address.

public TransactionReceipt getTransactionReceipt(String transactionHash);

arguments:

String transactionHash

getUncleByBlockNumberAndIndex¶

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

Note: An uncle doesn’t contain individual transactions.

public Block getUncleByBlockNumberAndIndex(long block, int pos);

arguments:

`long`	block
`int`	pos

getUncleCountByBlockHash¶

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

public long getUncleCountByBlockHash(String block);

arguments:

String block

getUncleCountByBlockNumber¶

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

public long getUncleCountByBlockNumber(long block);

arguments:

long block

newBlockFilter¶

Creates a filter in the node, to notify when a new block arrives.

To check if the state has changed, call eth_getFilterChanges.

public long newBlockFilter();

newLogFilter¶

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.

A note on specifying topic filters: Topics are order-dependent. A transaction with a log with topics [A, B] will be matched by the following topic filters:

[] “anything” [A] “A in first position (and anything after)” [null, B] “anything in first position AND B in second position (and anything after)” [A, B] “A in first position AND B in second position (and anything after)” [[A, B], [A, B]] “(A OR B) in first position AND (A OR B) in second position (and anything after)”

public long newLogFilter(LogFilter filter);

arguments:

LogFilter

filter

uninstallFilter¶

uninstall filter.

public boolean uninstallFilter(long filter);

arguments:

long filter

sendRawTransaction¶

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

public String sendRawTransaction(String data);

arguments:

String data

returns: String : transactionHash

abiEncode¶

encodes the arguments as described in the method signature using ABI-Encoding.

public String abiEncode(String signature, String[] params);

arguments:

`String`	signature
`String[]`	params

abiDecode¶

decodes the data based on the signature.

public String[] abiDecode(String signature, String encoded);

arguments:

`String`	signature
`String`	encoded

checksumAddress¶

converts the given address to a checksum address.

public String checksumAddress(String address);

arguments:

String address

checksumAddress¶

converts the given address to a checksum address.

Second parameter includes the chainId.

public String checksumAddress(String address, Boolean useChainId);

arguments:

`String`	address
`Boolean`	useChainId

ens¶

resolve ens-name.

public String ens(String name);

arguments:

String name

ens¶

resolve ens-name.

Second parameter especifies if it is an address, owner, resolver or hash.

public String ens(String name, ENSMethod type);

arguments:

`String`	name
ENSMethod	type

sendTransaction¶

sends a Transaction as described by the TransactionRequest.

This will require a signer to be set in order to sign the transaction.

public String sendTransaction(TransactionRequest tx);

arguments:

TransactionRequest

tx

call¶

the current Gas Price.

public Object call(String to, String function, Object... params);

arguments:

`String`	to
`String`	function
`Object...`	params

returns: Object : the decoded result. if only one return value is expected the Object will be returned, if not an array of objects will be the result.

class Block¶

represents a Block in ethereum.

LATEST¶

The latest Block Number.

Type: static long

EARLIEST¶

The Genesis Block.

Type: static long

getTotalDifficulty¶

returns the total Difficulty as a sum of all difficulties starting from genesis.

public BigInteger getTotalDifficulty();

getGasLimit¶

the gas limit of the block.

public BigInteger getGasLimit();

getExtraData¶

the extra data of the block.

public String getExtraData();

getDifficulty¶

the difficulty of the block.

public BigInteger getDifficulty();

getAuthor¶

the author or miner of the block.

public String getAuthor();

getTransactionsRoot¶

the roothash of the merkletree containing all transaction of the block.

public String getTransactionsRoot();

getTransactionReceiptsRoot¶

the roothash of the merkletree containing all transaction receipts of the block.

public String getTransactionReceiptsRoot();

getStateRoot¶

the roothash of the merkletree containing the complete state.

public String getStateRoot();

getTransactionHashes¶

the transaction hashes of the transactions in the block.

public String[] getTransactionHashes();

getTransactions¶

the transactions of the block.

public Transaction[] getTransactions();

getTimeStamp¶

the unix timestamp in seconds since 1970.

public long getTimeStamp();

getSha3Uncles¶

the roothash of the merkletree containing all uncles of the block.

public String getSha3Uncles();

getSize¶

the size of the block.

public long getSize();

getSealFields¶

the seal fields used for proof of authority.

public String[] getSealFields();

getHash¶

the block hash of the of the header.

public String getHash();

getLogsBloom¶

the bloom filter of the block.

public String getLogsBloom();

getMixHash¶

the mix hash of the block.

(only valid of proof of work)

public String getMixHash();

getNonce¶

the mix hash of the block.

(only valid of proof of work)

public String getNonce();

getNumber¶

the block number

public long getNumber();

getParentHash¶

the hash of the parent-block.

public String getParentHash();

getUncles¶

returns the blockhashes of all uncles-blocks.

public String[] getUncles();

hashCode¶

public int hashCode();

equals¶

public boolean equals(Object obj);

arguments:

Object obj

class Log¶

a log entry of a transaction receipt.

isRemoved¶

true when the log was removed, due to a chain reorganization.

false if its a valid log.

public boolean isRemoved();

getLogIndex¶

integer of the log index position in the block.

null when its pending log.

public int getLogIndex();

gettTansactionIndex¶

integer of the transactions index position log was created from.

null when its pending log.

public int gettTansactionIndex();

getTransactionHash¶

Hash, 32 Bytes - hash of the transactions this log was created from.

null when its pending log.

public String getTransactionHash();

getBlockHash¶

Hash, 32 Bytes - hash of the block where this log was in.

null when its pending. null when its pending log.

public String getBlockHash();

getBlockNumber¶

the block number where this log was in.

null when its pending. null when its pending log.

public long getBlockNumber();

getAddress¶

20 Bytes - address from which this log originated.

public String getAddress();

getTopics¶

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

public String[] getTopics();

class LogFilter¶

Log configuration for search logs.

getFromBlock¶

public long getFromBlock();

setFromBlock¶

public void setFromBlock(long fromBlock);

arguments:

long fromBlock

getToBlock¶

public long getToBlock();

setToBlock¶

public void setToBlock(long toBlock);

arguments:

long toBlock

getAddress¶

public String getAddress();

setAddress¶

public void setAddress(String address);

arguments:

String address

getTopics¶

public Object[] getTopics();

setTopics¶

public void setTopics(Object[] topics);

arguments:

Object[] topics

getLimit¶

public int getLimit();

setLimit¶

public void setLimit(int limit);

arguments:

int limit

toString¶

creates a JSON-String.

public String toString();

class SimpleWallet¶

a simple Implementation for holding private keys to sing data or transactions.

addRawKey¶

adds a key to the wallet and returns its public address.

public String addRawKey(String data);

arguments:

String data

addKeyStore¶

adds a key to the wallet and returns its public address.

public String addKeyStore(String jsonData, String passphrase);

arguments:

`String`	jsonData
`String`	passphrase

prepareTransaction¶

optiional method which allows to change the transaction-data before sending it.

This can be used for redirecting it through a multisig.

public TransactionRequest prepareTransaction(IN3 in3, TransactionRequest tx);

arguments:

IN3	in3
TransactionRequest	tx

canSign¶

returns true if the account is supported (or unlocked)

public boolean canSign(String address);

arguments:

String address

sign¶

signing of the raw data.

public String sign(String data, String address);

arguments:

`String`	data
`String`	address

class Transaction¶

represents a Transaction in ethereum.

getBlockHash¶

the blockhash of the block containing this transaction.

public String getBlockHash();

getBlockNumber¶

the block number of the block containing this transaction.

public long getBlockNumber();

getChainId¶

the chainId of this transaction.

public String getChainId();

getCreatedContractAddress¶

the address of the deployed contract (if successfull)

public String getCreatedContractAddress();

getFrom¶

the address of the sender.

public String getFrom();

getHash¶

the Transaction hash.

public String getHash();

getData¶

the Transaction data or input data.

public String getData();

getNonce¶

the nonce used in the transaction.

public long getNonce();

getPublicKey¶

the public key of the sender.

public String getPublicKey();

getValue¶

the value send in wei.

public BigInteger getValue();

getRaw¶

the raw transaction as rlp encoded data.

public String getRaw();

getTo¶

the address of the receipient or contract.

public String getTo();

getSignature¶

the signature of the sender - a array of the [ r, s, v]

public String[] getSignature();

getGasPrice¶

the gas price provided by the sender.

public long getGasPrice();

getGas¶

the gas provided by the sender.

public long getGas();

class TransactionReceipt¶

represents a Transaction receipt in ethereum.

getBlockHash¶

the blockhash of the block containing this transaction.

public String getBlockHash();

getBlockNumber¶

the block number of the block containing this transaction.

public long getBlockNumber();

getCreatedContractAddress¶

the address of the deployed contract (if successfull)

public String getCreatedContractAddress();

getFrom¶

the address of the sender.

public String getFrom();

getTransactionHash¶

the Transaction hash.

public String getTransactionHash();

getTransactionIndex¶

the Transaction index.

public int getTransactionIndex();

getTo¶

20 Bytes - The address of the receiver.

null when it’s a contract creation transaction.

public String getTo();

getGasUsed¶

The amount of gas used by this specific transaction alone.

public long getGasUsed();

getLogs¶

Array of log objects, which this transaction generated.

public Log[] getLogs();

getLogsBloom¶

256 Bytes - A bloom filter of logs/events generated by contracts during transaction execution.

Used to efficiently rule out transactions without expected logs

public String getLogsBloom();

getRoot¶

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

public String getRoot();

getStatus¶

success of a Transaction.

true indicates transaction failure , false indicates transaction success. Set for blocks mined after Byzantium hard fork EIP609, null before.

public boolean getStatus();

class TransactionRequest¶

represents a Transaction Request which should be send or called.

getFrom¶

public String getFrom();

setFrom¶

public void setFrom(String from);

arguments:

String from

getTo¶

public String getTo();

setTo¶

public void setTo(String to);

arguments:

String to

getValue¶

public BigInteger getValue();

setValue¶

public void setValue(BigInteger value);

arguments:

BigInteger value

getNonce¶

public long getNonce();

setNonce¶

public void setNonce(long nonce);

arguments:

long nonce

getGas¶

public long getGas();

setGas¶

public void setGas(long gas);

arguments:

long gas

getGasPrice¶

public long getGasPrice();

setGasPrice¶

public void setGasPrice(long gasPrice);

arguments:

long gasPrice

getFunction¶

public String getFunction();

setFunction¶

public void setFunction(String function);

arguments:

String function

getParams¶

public Object[] getParams();

setParams¶

public void setParams(Object[] params);

arguments:

Object[] params

setData¶

public void setData(String data);

arguments:

String data

getData¶

creates the data based on the function/params values.

public String getData();

getTransactionJson¶

public String getTransactionJson();

getResult¶

public Object getResult(String data);

arguments:

String data

enum ENSMethod¶

The enum type contains the following values:

addr	0
resolver	1
hash	2
owner	3

Package in3.ipfs¶

class API¶

API for ipfs custom methods.

To be used along with “Chain.IPFS” on in3 instance.

API¶

creates a ipfs.API using the given incubed instance.

public API(IN3 in3);

arguments:

in3

get¶

Returns the content associated with specified multihash on success OR NULL on error.

public byte[] get(String multihash);

arguments:

String multihash

put¶

Returns the IPFS multihash of stored content on success OR NULL on error.

public String put(String content);

arguments:

String content

put¶

Returns the IPFS multihash of stored content on success OR NULL on error.

public String put(byte[] content);

arguments:

byte[] content

Package in3.ipfs.API¶

enum Enconding¶

The enum type contains the following values:

base64	0
hex	1
utf8	2

Package in3.utils¶

class Account¶

Pojo that represents the result of an ecrecover operation (see: Crypto class).

getAddress¶

address from ecrecover operation.

public String getAddress();

getPublicKey¶

public key from ecrecover operation.

public String getPublicKey();

class Crypto¶

a Wrapper for crypto-related helper functions.

Crypto¶

public Crypto(IN3 in3);

arguments: