LogoLogo
Blockchain ExplorerWebsiteAirdrop
  • Welcome to Metacces
  • Overview
    • Mission & Vision
    • Market Analysis
    • Story
  • THE ECOSYSTEM
    • Unique Oli
      • Who is Oli
      • AI Integration
      • Blockchain Integration
    • Blacxes
      • What is Blacxes
      • Utilites
      • Unique DNA
      • DAO Governance
      • Technology
      • Distribution
      • Swap
    • Access Journey
      • Overview
      • Basic level
      • Intermediate level
      • Final level
    • Main App
      • Overview
      • Account
      • Assets
      • Use Acces Journey
    • Blockchain Layer 1
    • Acces Coin
      • Coin Utility
      • Smart-Contracts
      • Tokenomecs
      • Metacces Listings Roadmap
  • DEVELOPERS
    • Public Endpoints
    • MetaMask
    • Node Setup
    • JSON RPC Server
    • Connect to RPC
    • API Methods
    • Client Libraries
    • Smart Contracts
      • Deploy
      • Interact
      • Transfer
      • Fixed Cap Asset
      • Variable Cap Asset
  • MISC
    • Roadmap
      • Main Roadmap
        • ✔️2022
        • ✔️2023
        • 🔛2024
        • 2025
      • 🪙Coin Roadmap
        • 2022
        • 2023
        • 2024
    • Meet The Team
    • Be a partner With Metacces
    • Pitch Deck⁩
    • Social Links
      • Website
      • Telegram
      • X.Twitter
      • Discord
      • Youtube
      • Instagram
      • Facebook
Powered by GitBook
On this page

Was this helpful?

  1. DEVELOPERS

API Methods

PreviousConnect to RPCNextClient Libraries

Last updated 8 months ago

Was this helpful?

Run in Postman

View full API methods documentations in Metacces Postman fork.

The following objects are parameters for or returned by Metacces API methods.

Block object

Returned by eth_getBlockByHash and eth_getBlockByNumber.

Key
Type
Value

number

Quantity, Integer

Block number. null when block is pending.

hash

Data, 32 bytes

Hash of the block. null when block is pending.

parentHash

Data, 32 bytes

Hash of the parent block.

nonce

Data, 8 bytes

Hash of the generated proof of work. null when block is pending.

sha3Uncles

Data, 32 bytes

SHA3 of the uncle’s data in the block.

logsBloom

Data, 256 bytes

Bloom filter for the block logs. null when block is pending.

transactionsRoot

Data, 32 bytes

Root of the transaction trie for the block.

stateRoot

Data, 32 bytes

Root of the final state trie for the block.

receiptsRoot

Data, 32 bytes

Root of the receipts trie for the block.

miner

Data, 20 bytes

Address to pay mining rewards to.

difficulty

Quantity, Integer

Difficulty for this block.

totalDifficulty

Quantity, Integer

Total difficulty of the chain until this block.

size

Quantity, Integer

Size of block in bytes.

gasLimit

Quantity

Maximum gas allowed in this block.

gasUsed

Quantity

Total gas used by all transactions in this block.

timestamp

Quantity

Unix timestamp for block assembly.

transactions

Array

uncles

Array

Array of uncle hashes.

baseFeePerGas

Quantity

Fee history results object

Returned by eth_feeHistory for the requested block range. If blocks in the specified block range are not available, then only the fee history for available blocks is returned.

Key
Type
Value

oldestBlock

Quantity, Integer

Lowest number block of the returned range.

baseFeePerGas

Array

gasUsedRatio

Array

Array of block gas used ratios. These are calculated as the ratio of gasUsed and gasLimit.

Filter options object

Parameter for eth_newFilter, eth_getLogs, and priv_getLogs. Used to filter logs.

Key
Type
Optional
Value

fromBlock

Quantity | Tag

Optional

toBlock

Quantity | Tag

Optional

address

Data | Array

Optional

topics

Array of Data, 32 bytes each

Optional

Key
Type
Required/Optional
Value

blockHash

Data, 32 bytes

Optional.

Hash of block for which to return logs. If you specify blockHash, you cannot specify fromBlock and toBlock.

Log object

Returned by eth_getFilterChanges and priv_getLogs. Transaction receipt objects can contain an array of log objects.

Key
Type
Value

removed

Tag

true if log removed because of a chain reorganization. false if a valid log.

logIndex

Quantity, Integer

Log index position in the block. null when log is pending.

transactionIndex

Quantity, Integer

Index position of the starting transaction for the log. null when log is pending.

transactionHash

Data, 32 bytes

Hash of the starting transaction for the log. null when log is pending.

blockHash

Data, 32 bytes

Hash of the block that includes the log. null when log is pending.

blockNumber

Quantity

Number of block that includes the log. null when log is pending.

address

Data, 20 bytes

Address the log originated from.

data

Data

Non-indexed arguments of the log.

topics

Array of Data, 32 bytes each

Miner data object

Returned by eth_getMinerDataByBlockHash and eth_getMinerDataByBlockNumber.

Key
Type
Value

netBlockReward

Quantity, Integer

The net block reward, in Wei, is staticBlockReward + transactionFee + uncleInclusionReward.

staticBlockReward

Quantity, Integer

The static block reward, in Wei, is preset on a hard fork.

transactionFee

Quantity, Integer

The transaction fee, in Wei, is sum of upfront cost - refund amount for all transactions.

uncleInclusionReward

Quantity, Integer

The uncle inclusion reward, in Wei, is static block reward * number of ommers/32.

uncleRewards

Map

Map of uncle block hashes and uncle miner coinbase addresses.

coinbase

Data, 20 bytes

Coinbase address.

extraData

Data

difficulty

Quantity, Integer

Difficulty of this block.

totalDifficulty

Quantity, Integer

Total difficulty of the chain until this block.

Pending transaction object

Returned by txpool_besuPendingTransactions.

Key
Type
Value

accessList

Array

from

Data, 20 bytes

Address of the sender.

gas

Quantity

Gas provided by the sender.

gasPrice

Quantity

maxPriorityFeePerGas

Quantity, Integer

maxFeePerGas

Quantity, Integer

hash

Data, 32 bytes

Hash of the transaction.

input

Data

Data sent with the transaction to create or invoke a contract.

nonce

Quantity

Number of transactions made by the sender before this one.

to

Data, 20 bytes

Address of the receiver. null if a contract creation transaction.

transactionType

String

value

Quantity

Value transferred, in Wei.

v

Quantity

ECDSA Recovery ID.

r

Data, 32 bytes

ECDSA signature r.

s

Data, 32 bytes

ECDSA signature s.

Private transaction object

Returned by priv_getPrivateTransaction.

Key
Type
Value

from

Data, 20 bytes

Address of the sender.

gas

Quantity

Gas provided by the sender.

gasPrice

Quantity

Gas price, in Wei, provided by the sender.

hash

Data, 32 bytes

Hash of the transaction.

input

Data

The data to create or invoke a contract.

nonce

Quantity

Number of transactions made by the sender to the privacy group before this one.

to

Data, 20 bytes

null if a contract creation transaction, otherwise, the contract address.

value

Quantity

null because private transactions cannot transfer Ether.

v

Quantity

ECDSA Recovery ID.

r

Data, 32 bytes

ECDSA signature r.

s

Data, 32 bytes

ECDSA signature s.

restriction

String

Range object

Returned by debug_storageRangeAt.

Key
Type
Value

storage

Object

Key hash and value. Pre-image key is null if it falls outside the cache.

nextKey

Hash

Hash of next key if further storage in range. Otherwise, not included.

Structured log object

Log information returned as part of the Trace object.

Key
Type
Value

pc

Integer

Current program counter.

op

String

Current OpCode.

gas

Integer

Gas remaining.

gasCost

Integer

Cost in wei of each gas unit.

depth

Integer

Execution depth.

exceptionalHaltReasons

Array

One or more strings representing an error condition causing the EVM execution to terminate. These strings suggest that EVM execution terminated for reasons such as running out of gas or attempting to execute an unknown instruction. Generally a single exceptional halt reason returns but it’s possible for more than one to occur at once.

stack

Array of 32 byte arrays

EVM execution stack before executing current operation.

memory

Array of 32 byte arrays

Memory space of the contract before executing current operation.

storage

Object

Storage entries changed by the current transaction.

Trace object

Returned by debug_traceBlock, debug_traceBlockByHash, debug_traceBlockByNumber, and debug_traceTransaction.

Key
Type
Value

gas

Integer

Gas used by the transaction.

failed

Boolean

True if transaction failed, otherwise, false.

returnValue

String

Bytes returned from transaction execution (without a 0x prefix).

structLogs

Array

Array of structured log objects.

Transaction object

Returned by eth_getTransactionByHash, eth_getTransactionByBlockHashAndIndex, and eth_getTransactionByBlockNumberAndIndex.

Key
Type
Value

accessList

Array

blockHash

Data, 32 bytes

Hash of the block containing this transaction. null when transaction is pending.

blockNumber

Quantity

Block number of the block containing this transaction. null when transaction is pending.

chainId

Quantity

from

Data, 20 bytes

Address of the sender.

gas

Quantity

Gas provided by the sender.

gasPrice

Quantity

maxPriorityFeePerGas

Quantity, Integer

maxFeePerGas

Quantity, Integer

hash

Data, 32 bytes

Hash of the transaction.

input

Data

nonce

Quantity

Number of transactions made by the sender before this one.

publicKey

Data, 64 bytes

Public key of the sender.

raw

Data

This signed transaction in Recursive Length Prefix (RLP) encoded form.

to

Data, 20 bytes

Address of the receiver. null if a contract creation transaction.

transactionIndex

Quantity, Integer

Index position of the transaction in the block. null when transaction is pending.

transactionType

String

value

Quantity

Value transferred, in Wei.

v

Quantity

ECDSA Recovery ID.

r

Data, 32 bytes

ECDSA signature r.

s

Data, 32 bytes

ECDSA signature s.

Transaction call object

Parameter for eth_call and eth_estimateGas.

Note

All transaction call object parameters are optional for eth_estimateGas. Only the to parameter is required for eth_call.

Key
Type
Value

from

Data, 20 bytes

Address of the sender.

to

Data, 20 bytes

Address of the action receiver.

gas

Quantity, Integer

Gas provided by the sender. eth_call consumes zero gas, but other executions might need this parameter. eth_estimateGas ignores this value.

gasPrice

Quantity, Integer

maxPriorityFeePerGas

Quantity, Integer

maxFeePerGas

Quantity, Integer

value

Quantity, Integer

Value transferred, in Wei.

data

Data

strict

Tag

If true, checks that the from account’s ether balance is sufficient to cover the transaction and gas fee. If false, this balance is not checked. The default is false.

Transaction receipt object

Returned by eth_getTransactionReceipt.

Key
Type
Value

blockHash

Data, 32 bytes

Hash of block containing this transaction.

blockNumber

Quantity

Block number of block containing this transaction.

contractAddress

Data, 20 bytes

Contract address created, if contract creation transaction, otherwise, null.

cumulativeGasUsed

Quantity

Total amount of gas used by previous transactions in the block and this transaction.

effectiveGasPrice

Quantity

from

Data, 20 bytes

Address of the sender.

gasUsed

Quantity

Amount of gas used by this specific transaction.

logs

Array

logsBloom

Data, 256 bytes

Bloom filter for light clients to quickly retrieve related logs.

status

Quantity

Either 0x0 (failure), 0x1 (success), or 0x2 (invalid).

to

Data, 20 bytes

Address of the receiver, if sending ether, otherwise, null.

transactionHash

Data, 32 bytes

Hash of the transaction.

transactionIndex

Quantity, Integer

Index position of transaction in the block.

transactionType

String

revertReason

String

Note

For pre-Byzantium transactions, the transaction receipt object includes the following instead of status:

Key
Type
Value

root

Data, 32 bytes

Post-transaction state root

Transaction trace object

Returned by trace_replayBlockTransactions.

Key
Type
Value

output

Boolean

Transaction result. 1 for success and 0 for failure.

stateDiff

Object

trace

Array

vmTrace

Object

transactionHash

Data, 32 bytes

Hash of the replayed transaction.

Array of , or 32 byte transaction hashes depending on the specified boolean parameter.

The block’s . This field is empty for blocks created before .

Array of block base fees per gas, including an extra block value. The extra value is the next block after the newest block in the returned range. Returns zeroes for blocks created before .

Integer block number or latest, pending, earliest. See . Default is latest.

Integer block number or latest, pending, earliest. See . Default is latest.

Contract address or array of addresses from which originate.

Array of topics by which to .

and have an extra key.

and 0 to 3 .

Extra data field for this block. The first 32 bytes is vanity data you can set using the command line option.

(Optional) List of addresses and storage keys the transaction plans to access. Used in and may be used in .

(Optional) Gas price, in Wei, provided by the sender. Not used only in .

(Optional) Maximum fee, in Wei, the sender is willing to pay per gas above the base fee. Used only in .

(Optional) Maximum total fee (base fee + priority fee), in Wei, the sender is willing to pay per gas. Used only in .

.

Must be .

(Optional) List of addresses and storage keys the transaction plans to access. Used in and may be used in .

.

(Optional) Gas price, in Wei, provided by the sender. Not used only in .

(Optional) Maximum fee, in Wei, the sender is willing to pay per gas above the base fee. Used only in .

(Optional) Maximum total fee (base fee + priority fee), in Wei, the sender is willing to pay per gas. Used only in .

Data sent with the transaction to create or invoke a contract. For , it’s a pointer to the transaction location in .

.

Gas price, in Wei, provided by the sender. The default is 0. Can’t be used only in .

Maximum fee, in Wei, the sender is willing to pay per gas above the base fee. Can be used only in . If used, must specify maxFeePerGas.

Maximum total fee (base fee + priority fee), in Wei, the sender is willing to pay per gas. Can be used only in . If used, must specify maxPriorityFeePerGas.

Hash of the method signature and encoded parameters. For details, see .

The from the sender’s account.

Array of generated by this transaction.

.

ABI-encoded string that displays the . Only available if revert reason is .

.

.

.

eth_getLogs
priv_getLogs
transaction objects
base fee per gas
EIP-1559
EIP-1559
Block Parameter
Block Parameter
logs
filter logs
Event signature hash
indexed log arguments
--miner-extra-data
ACCESS_LIST transactions
EIP1559 transactions
EIP1559 transactions
EIP1559 transactions
EIP1559 transactions
Transaction type
restricted
ACCESS_LIST transactions
EIP1559 transactions
Chain ID
EIP1559 transactions
EIP1559 transactions
EIP1559 transactions
private transactions
Tessera
Transaction type
EIP1559 transactions
EIP1559 transactions
EIP1559 transactions
Ethereum Contract ABI
actual value per gas deducted
log objects
Transaction type
reason for reverting the transaction
enabled
State changes in the requested block
Ordered list of calls to other contracts
Ordered list of EVM actions