This page will guide you through some basic interactions with your node. This guide should guide you to the proper tools, not be seen as canonical reference. Always refer to the proper documentation for the tool you are using:
Polkadot-JS RPC is a JavaScript library for interacting with the Substrate RPC API endpoint, distributed as @polkadot/api Node.js package.
Substrate API Sidecar is using the Polkadot-JS RPC to provide separately runnable REST services.
Polkadot RPC
The Parity Polkadot client exposes HTTP and WS endpoints for RPC connections. The default ports are 9933 for HTTP and 9944 for WS.
To get a list of all RPC methods, the node has an RPC endpoint called rpc_methods.
Some return values may not appear meaningful at first glance. Polkadot uses as a format that is suitable for resource-constrained execution environments. You will need to decode the information and use the chain (state_getMetadata) to obtain human-readable information.
Tracking the Chain Head
Use the RPC endpoint chain_subscribeFinalizedHeads to subscribe to a stream of hashes of finalized headers, or chain_FinalizedHeads to fetch the latest hash of the finalized header. Use chain_getBlock to get the block associated with a given hash. chain_getBlock only accepts block hashes, so if you need to query intermediate blocks, use chain_getBlockHash to get the block hash from a block number.
Parity maintains an RPC client, written in TypeScript, that exposes a limited set of endpoints. It handles the metadata and codec logic so that you are always dealing with decoded information. It also aggregates information that an infrastructure business may need for accounting and auditing, e.g. transaction fees.
The client runs on an HTTP host. The following examples use python3, but you can query any way you prefer at http://HOST:PORT/. The default is http://127.0.0.1:8080.
Fetch a block using the block/number endpoint. To get the chain tip, omit the block number.
When tracking transaction fees, the extrinsics.paysFee value is not sufficient for determining if the extrinsic had a fee. This field only means that it would require a fee if submitted as a transaction. In order to charge a fee, a transaction also needs to be signed. So in the following example, the timestamp.set extrinsic does not pay a fee because it is an inherent, put in the block by the block author.
If successful, this endpoint returns a JSON with the transaction hash. In case of error, it will return an error report, e.g.:
{ "error": "Failed to parse a tx" | "Failed to submit a tx", "cause": "Upstream error description"}
Substrate API Sidecar
The sidecar can fetch blocks, get the balance of an address atomically (i.e., with a corresponding block number), get the chain's metadata, get a transaction fee prediction, calculate outstanding staking rewards for an address, submit transactions to a node's transaction queue, and .
Fetching a Block
In the balances.transfer extrinsic, the partialFee item is the transaction fee. It is called "partial fee" because the would include the tip field. Notice that some extrinsics do not have a signature. These are .
