ParallelChain F Rich API JavaScript Client Library (pchain-client-js).
This crate is a library that wraps networked interactions with ParallelChain F Rich APIs so that user code does not have to manually produce request bodies and hit HTTP endpoints.
Usage Example
let client = new RichAPIClient("http://node.digitial-transaction.net");Methods
RichAPIClient implements methods which queries blockchain information by sending HTTP request to the Rich API endpoint.
Blocks
let order = "asc";
let block_hash = "2jdtP11Mco8Fk1zwzl1Ivi5q1wnyRrUT0d6CfSHA3kY";
let tx_hash = "c72Q4KpwDFVsRurgD_U_rzYi_A05qvZHM8Qma4nyfyc";
let block_height = 451;
let blocks = await rich_api_client.blocks.get_blocks("block_number", block_height.toString(), 5, order);
println!(blocks);
// Output
[
{
"header": {
"app_id": 0,
"block_hash": "EWPT6rZ7wvttVMkJK9QCYyAbpGQw9fWUD9YaDeZTC9k",
"height": 0,
"justify": {
"view_number": 0,
"block_hash": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
"sigs": {
"signatures": [
null,
null,
null,
null
],
"count_some": 0
}
},
"data_hash": "DzqBDlw4PuQWq_0TsMKCs0WxuPmhJwgMPBU-IrylVIo",
"version_number": 0,
"timestamp": 1672531200,
"txs_hash": "B-6jdrGxeH-2BXunZVwh5oOE4Wjk4UPM4xO9LKqzgIk",
"state_hash": "nWM0MM310GhtsTbAsiy36NhA5VoR7moGZIPfCYXqAGE",
"receipts_hash": "BmgP8vssG41IAfsU9f7BskmNeY64IiYpzJvfDruLGtI"
},
"transactions": [
{
"from_address": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
"to_address": "v7d8cqWDNt4uqpsSO1mDsK5KFnzmoC07k_uk6j7WSMc",
"value": 100000000000000000,
"tip": 0,
"gas_limit": 0,
"gas_price": 0,
"data": "",
"n_txs_on_chain_from_address": 0,
"hash": "du4tRb5NGd1Mz_vR0n5iampNwe2D7zduVls7ap_UeBg",
"signature": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA"
},
{
"from_address": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
"to_address": "YESSKvjZvHI9MH_RMMLsqrSBoHZ_56OA5IMsCwpu8lQ",
"value": 100000000000000000,
"tip": 0,
"gas_limit": 0,
"gas_price": 0,
"data": "",
"n_txs_on_chain_from_address": 0,
"hash": "_66srKnRx9o4WzN9aREIW467BpEwLkJbp_xFtb2bRQo",
"signature": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA"
}
],
"receipts": [
{
"status_code": 0,
"gas_consumed": 0,
"return_value": [],
"events": []
},
{
"status_code": 0,
"gas_consumed": 0,
"return_value": [],
"events": []
}
]
}
]Transactions
let order = "asc".to_string();
let tx_hash = "c72Q4KpwDFVsRurgD_U_rzYi_A05qvZHM8Qma4nyfyc";
const txn_status_code = await richAPI.transactions.getTxnByStatusCode('latest', 'true', 0, 'all', 1, 'asc')
println!(txn_status_code);
// Output
{
"transactions": [{
"tx_num": 2,
"transaction": {
"from_address": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
"to_address": "YESSKvjZvHI9MH_RMMLsqrSBoHZ_56OA5IMsCwpu8lQ",
"value": 100000000000000000,
"tip": 0,
"gas_limit": 0,
"gas_price": 0,
"data": "",
"n_txs_on_chain_from_address": 0,
"hash": "_66srKnRx9o4WzN9aREIW467BpEwLkJbp_xFtb2bRQo",
"signature": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA"
},
"receipt": {
"status_code": 0,
"gas_consumed": 0,
"return_value": [],
"events": []
}
}]
}
const public_address = 'YESSKvjZvHI9MH_RMMLsqrSBoHZ_56OA5IMsCwpu8lQ';
let filter_map = new Map();
filter_map.set("to_address", public_address)
const txs = await richAPI.transactions.getTransactions('latest', 'true', filter_map, 'all', 1, 'asc')
console.log(txs);
// Output
{
"transactions": [
{
"tx_num": 2,
"transaction": {
"from_address": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
"to_address": "YESSKvjZvHI9MH_RMMLsqrSBoHZ_56OA5IMsCwpu8lQ",
"value": 100000000000000000,
"tip": 0,
"gas_limit": 0,
"gas_price": 0,
"data": "",
"n_txs_on_chain_from_address": 0,
"hash": "_66srKnRx9o4WzN9aREIW467BpEwLkJbp_xFtb2bRQo",
"signature": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA"
},
"receipt": {
"status_code": 0,
"gas_consumed": 0,
"return_value": [],
"events": []
}
}
]
}Summary of methods provided by RichAPIClient:
| Method | Description |
|---|---|
getBlocks |
filters blocks by identifier |
getBlockSummaries |
filters block summaries by identifier |
getBlockHeaders |
filters block headers by identifier |
getTxnByEventTopic |
filters transactions by event topic |
getTxnSummariesByEventTopic |
filter transaction summaries by event topic |
getTxnByStatusCode |
get transactions by status code |
getTxnSummariesByStatusCode |
filters transaction summaries by status code |
getTransactions |
filters transactions by identifier |
getTxnSummariesByIdentifier |
filters transaction summaries by identifier |