Download OpenAPI specification:Download
A REST layer over the TrueBlocks chifra command line. With chifra daemon
, you can run this on your own machine, and make calls to localhost
.
The endpoints in this API are exact translations of the commands used by the chifra CLI application, and the query parameters mirror the commands' options and flags. If you want details, the commands have their own documentation page. For detailed descriptions of data returned by each command, see the data model reference.
chifra daemon
By default, all calls are to localhost:8080
.
All options and flags are passed through query parameters.
For example, to get block 100
, make a call to /blocks
and specify
the block you want in the query parameter:
curl "http://localhost:8080/blocks?blocks=100"
Some parameters support ranges:
curl "http://localhost:8080/blocks?blocks=100-120"
Other parameters let you filter your responses. For example, to get only the unique addresses from that block range:
curl "http://localhost:8080/blocks?blocks=100-110&uniq=true"
You might want to cache queries on your local machine.
"http://localhost:8080/blocks?blocks=100-110&cache=true"
Caching speeds up repeat queries significantly. The cache options are particularly useful for calls to data-rich endpoints, like most endpoints in the "Accounts" collection.
Of course, caches occupy local storage. So cache wisely.
List every appearance of an address anywhere on the chain. Corresponds to the chifra list command line.
addrs required | Array of strings <address> [ items <address > ] one or more addresses (0x...) to list |
count | boolean display only the count of records for each monitor |
noZero | boolean for the --count option only, suppress the display of zero appearance accounts |
bounds | boolean report first and last block this address appears |
unripe | boolean list transactions labeled unripe (i.e. less than 28 blocks old) |
silent | boolean freshen the monitor only (no reporting) |
firstRecord | number <uint64> the first record to process |
maxRecords | number <uint64> the maximum number of records to process |
reversed | boolean produce results in reverse chronological order |
firstBlock | number <blknum> first block to export (inclusive, ignored when freshening) |
lastBlock | number <blknum> last block to export (inclusive, ignored when freshening) |
chain | string the chain to use |
noHeader | boolean suppress the header in the output |
fmt | string export format, one of [ txt | csv | json ] |
{- "address": "0xff9387a9aae1f5daab1cd8eb0e92113ea9d19ca3",
- "blockNumber": 4037786,
- "transactionIndex": 47
}
Export full details of transactions for one or more addresses. Corresponds to the chifra export command line.
addrs required | Array of strings <address> [ items <address > ] one or more addresses (0x...) to export |
topics | Array of strings <topic> [ items <topic > ] filter by one or more log topics (only for --logs option) |
fourbytes | Array of strings <fourbyte> [ items <fourbyte > ] filter by one or more fourbytes (only for transactions and trace options) |
appearances | boolean export a list of appearances |
receipts | boolean export receipts instead of transactional data |
logs | boolean export logs instead of transactional data |
traces | boolean export traces instead of transactional data |
neighbors | boolean export the neighbors of the given address |
accounting | boolean attach accounting records to the exported data (applies to transactions export only) |
statements | boolean for the accounting options only, export only statements |
balances | boolean traverse the transaction history and show each change in ETH balances |
withdrawals | boolean export withdrawals for the given address |
articulate | boolean articulate transactions, traces, logs, and outputs |
cacheTraces | boolean force the transaction's traces into the cache |
count | boolean for --appearances mode only, display only the count of records |
firstRecord | number <uint64> the first record to process |
maxRecords | number <uint64> the maximum number of records to process |
relevant | boolean for log and accounting export only, export only logs relevant to one of the given export addresses |
emitter | Array of strings <address> [ items <address > ] for the --logs option only, filter logs to show only those logs emitted by the given address(es) |
topic | Array of strings <topic> [ items <topic > ] for the --logs option only, filter logs to show only those with this topic(s) |
reverted | boolean export only transactions that were reverted |
asset | Array of strings <address> [ items <address > ] for the accounting options only, export statements only for this asset |
flow | string Enum: "in" "out" "zero" for the accounting options only, export statements with incoming, outgoing, or zero value |
factory | boolean for --traces only, report addresses created by (or self-destructed by) the given address(es) |
unripe | boolean export transactions labeled unripe (i.e. less than 28 blocks old) |
reversed | boolean produce results in reverse chronological order |
noZero | boolean for the --count option only, suppress the display of zero appearance accounts |
firstBlock | number <blknum> first block to process (inclusive) |
lastBlock | number <blknum> last block to process (inclusive) |
chain | string the chain to use |
noHeader | boolean suppress the header in the output |
cache | boolean force the results of the query into the cache |
decache | boolean removes related items from the cache |
ether | boolean export values in ether |
fmt | string export format, one of [ txt | csv | json ] |
{- "hash": "0x78a17b79e638190d72a3030a79645c32cf3420a133ea2835206778e5ab63fdc7",
- "blockHash": "0xdf551eb24dd5275c22d497b9076f1111f483b71ca37002bee51d5db55d20d2fa",
- "blockNumber": 4037786,
- "transactionIndex": 47,
- "timestamp": 1500352888,
- "from": "0x29205869522cc9d1f84b0ad5279a8e74a7c66c15",
- "to": "0xff9387a9aae1f5daab1cd8eb0e92113ea9d19ca3",
- "value": 84353870000000000,
- "gas": 90000,
- "gasPrice": 20000000000,
- "maxFeePerGas": 0,
- "maxPriorityFeePerGas": 0,
- "isError": 0,
- "hasToken": 0,
- "receipt": {
- "contractAddress": "0x0",
- "gasUsed": 21000,
- "effectiveGasPrice": 20000000000,
- "status": null
}, - "compressedTx": "0x()",
- "gasCost": 420000000000000,
- "gasUsed": 21000,
- "date": "2017-07-18 04:41:28 UTC",
- "ether": 0.08435387
}
Add, remove, clean, and list address monitors. Corresponds to the chifra monitors command line.
addrs | Array of strings <address> [ items <address > ] one or more addresses (0x...) to process |
delete | boolean delete a monitor, but do not remove it |
undelete | boolean undelete a previously deleted monitor |
remove | boolean remove a previously deleted monitor |
clean | boolean clean (i.e. remove duplicate appearances) from monitors, optionally clear stage |
list | boolean list monitors in the cache (--verbose for more detail) |
count | boolean show the number of active monitors (included deleted but not removed monitors) |
staged | boolean for --clean, --list, and --count options only, include staged monitors |
chain | string the chain to use |
noHeader | boolean suppress the header in the output |
cache | boolean force the results of the query into the cache |
decache | boolean removes related items from the cache |
fmt | string export format, one of [ txt | csv | json ] |
{- "data": [
- {
- "msg": "string",
- "num": 0
}
]
}
Query addresses or names of well-known accounts. Corresponds to the chifra names command line.
terms required | Array of strings <string> [ items <string > ] a space separated list of one or more search terms |
expand | boolean expand search to include all fields (search name, address, and symbol otherwise) |
matchCase | boolean do case-sensitive search |
all | boolean include all (including custom) names in the search |
custom | boolean include only custom named accounts in the search |
prefund | boolean include prefund accounts in the search |
addr | boolean display only addresses in the results (useful for scripting, assumes --no_header) |
tags | boolean export the list of tags and subtags only |
clean | boolean clean the data (addrs to lower case, sort by addr) |
regular | boolean only available with --clean, cleans regular names database |
dryRun | boolean only available with --clean or --autoname, outputs changes to stdout instead of updating databases |
autoname | string <address> an address assumed to be a token, added automatically to names database if true |
create | string create a new item |
update | string update an existing item |
delete | string delete the item, but do not remove it |
undelete | string undelete a previously deleted item |
remove | string remove a previously deleted item |
chain | string the chain to use |
noHeader | boolean suppress the header in the output |
fmt | string export format, one of [ txt | csv | json ] |
{- "tags": "50-Tokens:ERC20",
- "address": "0xfe5f141bf94fe84bc28ded0ab966c16b17490657",
- "name": "LibraToken",
- "symbol": "LBA",
- "source": "On chain",
- "decimals": 18
}
Fetches the ABI for a smart contract. Corresponds to the chifra abis command line.
addrs required | Array of strings <address> [ items <address > ] a list of one or more smart contracts whose ABIs to display |
known | boolean load common 'known' ABIs from cache |
proxyFor | string <address> redirects the query to this implementation |
list | boolean a list of downloaded abi files |
count | boolean show the number of abis downloaded |
find | Array of strings <string> [ items <string > ] search for function or event declarations given a four- or 32-byte code(s) |
hint | Array of strings <string> [ items <string > ] for the --find option only, provide hints to speed up the search |
encode | string generate the 32-byte encoding for a given cannonical function or event signature |
chain | string the chain to use |
noHeader | boolean suppress the header in the output |
cache | boolean force the results of the query into the cache |
decache | boolean removes related items from the cache |
fmt | string export format, one of [ txt | csv | json ] |
{- "name": "PairCreated",
- "type": "event",
- "stateMutability": "nonpayable",
- "signature": "PairCreated(address,address,address,uint256)",
- "encoding": "0x0d3648bd0f6ba80134a33ba9275ac585d9d315f0ad8355cddefde31afa28d0e9",
- "inputs": [
- {
- "type": "address",
- "name": "token0",
- "indexed": true,
- "internalType": "address"
}, - {
- "type": "address",
- "name": "token1",
- "indexed": true,
- "internalType": "address"
}, - {
- "type": "address",
- "name": "pair",
- "internalType": "address"
}, - {
- "type": "uint256",
- "name": "val_0",
- "internalType": "uint256"
}
]
}
Retrieve one or more blocks from the chain or local cache. Corresponds to the chifra blocks command line.
blocks required | Array of strings <blknum> [ items <blknum > ] a space-separated list of one or more block identifiers |
hashes | boolean display only transaction hashes, default is to display full transaction detail |
uncles | boolean display uncle blocks (if any) instead of the requested block |
traces | boolean export the traces from the block as opposed to the block data |
uniq | boolean display a list of uniq address appearances per transaction |
flow | string Enum: "from" "to" "reward" for the --uniq option only, export only from or to (including trace from or to) |
logs | boolean display only the logs found in the block(s) |
emitter | Array of strings <address> [ items <address > ] for the --logs option only, filter logs to show only those logs emitted by the given address(es) |
topic | Array of strings <topic> [ items <topic > ] for the --logs option only, filter logs to show only those with this topic(s) |
withdrawals | boolean export the withdrawals from the block as opposed to the block data |
articulate | boolean for the --logs option only, articulate the retrieved data if ABIs can be found |
count | boolean display only the count of appearances for --addrs or --uniq |
cacheTxs | boolean force a write of the block's transactions to the cache (slow) |
cacheTraces | boolean force a write of the block's traces to the cache (slower) |
chain | string the chain to use |
noHeader | boolean suppress the header in the output |
cache | boolean force the results of the query into the cache |
decache | boolean removes related items from the cache |
ether | boolean export values in ether |
fmt | string export format, one of [ txt | csv | json ] |
{- "blockNumber": 3141592,
- "hash": "0x0b4c6fb75ded4b90218cf0346b0885e442878f104e1b60bf75d5b6860eeacd53",
- "...": "...",
- "transactions": [ ]
}
Retrieve one or more transactions from the chain or local cache. Corresponds to the chifra transactions command line.
transactions required | Array of strings <tx_id> [ items <tx_id > ] a space-separated list of one or more transaction identifiers |
articulate | boolean articulate the retrieved data if ABIs can be found |
traces | boolean include the transaction's traces in the results |
uniq | boolean display a list of uniq addresses found in the transaction |
flow | string Enum: "from" "to" for the uniq option only, export only from or to (including trace from or to) |
logs | boolean display only the logs found in the transaction(s) |
emitter | Array of strings <address> [ items <address > ] for the --logs option only, filter logs to show only those logs emitted by the given address(es) |
topic | Array of strings <topic> [ items <topic > ] for the --logs option only, filter logs to show only those with this topic(s) |
cacheTraces | boolean force the transaction's traces into the cache |
chain | string the chain to use |
noHeader | boolean suppress the header in the output |
cache | boolean force the results of the query into the cache |
decache | boolean removes related items from the cache |
ether | boolean export values in ether |
fmt | string export format, one of [ txt | csv | json ] |
{- "blockHash": "0x3a1fba5abd9d41457944e91ed097e039b7b12d3d7ba324a3f422db2277a48e28",
- "blockNumber": 52029,
- "date": "2015-08-08 06:22:55 UTC",
- "ether": "0",
- "from": "0x3d0768da09ce77d25e2d998e6a7b6ed4b9116c2d",
- "gas": 90000,
- "gasCost": 2516291173295740,
- "gasPrice": 57380137580,
- "gasUsed": 43853,
- "hash": "0x218b632d932371478d1ae5a01620ebab1a2030f9dad6f8fba4a044ea6335a57e",
- "input": "0x432ced044d794669727374436f696e000000000000000000000000000000000000000000",
- "nonce": 31,
- "receipt": {
- "contractAddress": "0x0",
- "effectiveGasPrice": 57380137580,
- "gasUsed": 43853,
- "logs": [
- {
- "address": "0x5564886ca2c518d1964e5fcea4f423b41db9f561",
- "data": "0x",
- "date": "2015-08-08 06:22:55 UTC",
- "logIndex": 0,
- "timestamp": 1439014975,
- "topics": [
- "0xa6697e974e6a320f454390be03f74955e8978f1a6971ea6730542e37b66179bc",
- "0x4d794669727374436f696e000000000000000000000000000000000000000000"
]
}
], - "status": null
}, - "timestamp": 1439014975,
- "to": "0x5564886ca2c518d1964e5fcea4f423b41db9f561",
- "traces": [ ],
- "transactionIndex": 0,
- "value": "0"
}
Retrieve receipts for the given transaction(s). Corresponds to the chifra receipts command line.
transactions required | Array of strings <tx_id> [ items <tx_id > ] a space-separated list of one or more transaction identifiers |
articulate | boolean articulate the retrieved data if ABIs can be found |
chain | string the chain to use |
noHeader | boolean suppress the header in the output |
cache | boolean force the results of the query into the cache |
decache | boolean removes related items from the cache |
fmt | string export format, one of [ txt | csv | json ] |
{- "blockNumber": 52029,
- "from": "0x3d0768da09ce77d25e2d998e6a7b6ed4b9116c2d",
- "gasUsed": 43853,
- "logs": [
- {
- "address": "0x5564886ca2c518d1964e5fcea4f423b41db9f561",
- "blockHash": "0x3a1fba5abd9d41457944e91ed097e039b7b12d3d7ba324a3f422db2277a48e28",
- "blockNumber": 52029,
- "date": "2015-08-08 06:22:55 UTC",
- "logIndex": 0,
- "timestamp": 1439014975,
- "topics": [
- "0xa6697e974e6a320f454390be03f74955e8978f1a6971ea6730542e37b66179bc",
- "0x4d794669727374436f696e000000000000000000000000000000000000000000"
], - "transactionHash": "0x218b632d932371478d1ae5a01620ebab1a2030f9dad6f8fba4a044ea6335a57e",
- "transactionIndex": 0
}
], - "status": 1,
- "to": "0x5564886ca2c518d1964e5fcea4f423b41db9f561",
- "transactionHash": "0x218b632d932371478d1ae5a01620ebab1a2030f9dad6f8fba4a044ea6335a57e",
- "transactionIndex": 0
}
Retrieve logs for the given transaction(s). Corresponds to the chifra logs command line.
transactions required | Array of strings <tx_id> [ items <tx_id > ] a space-separated list of one or more transaction identifiers |
emitter | Array of strings <address> [ items <address > ] filter logs to show only those logs emitted by the given address(es) |
topic | Array of strings <topic> [ items <topic > ] filter logs to show only those with this topic(s) |
articulate | boolean articulate the retrieved data if ABIs can be found |
chain | string the chain to use |
noHeader | boolean suppress the header in the output |
cache | boolean force the results of the query into the cache |
decache | boolean removes related items from the cache |
fmt | string export format, one of [ txt | csv | json ] |
{- "address": "0x5564886ca2c518d1964e5fcea4f423b41db9f561",
- "blockHash": "0x3a1fba5abd9d41457944e91ed097e039b7b12d3d7ba324a3f422db2277a48e28",
- "blockNumber": 52029,
- "date": "2015-08-08 06:22:55 UTC",
- "logIndex": 0,
- "timestamp": 1439014975,
- "topics": [
- "0xa6697e974e6a320f454390be03f74955e8978f1a6971ea6730542e37b66179bc",
- "0x4d794669727374436f696e000000000000000000000000000000000000000000"
], - "transactionHash": "0x218b632d932371478d1ae5a01620ebab1a2030f9dad6f8fba4a044ea6335a57e",
- "transactionIndex": 0
}
Retrieve traces for the given transaction(s). Corresponds to the chifra traces command line.
transactions required | Array of strings <tx_id> [ items <tx_id > ] a space-separated list of one or more transaction identifiers |
articulate | boolean articulate the retrieved data if ABIs can be found |
filter | string call the node's trace_filter routine with bang-separated filter |
count | boolean display only the number of traces for the transaction (fast) |
chain | string the chain to use |
noHeader | boolean suppress the header in the output |
cache | boolean force the results of the query into the cache |
decache | boolean removes related items from the cache |
ether | boolean export values in ether |
fmt | string export format, one of [ txt | csv | json ] |
{- "action": {
- "callType": "call",
- "from": "0x3d0768da09ce77d25e2d998e6a7b6ed4b9116c2d",
- "gas": 67896,
- "input": "0x432ced044d794669727374436f696e000000000000000000000000000000000000000000",
- "to": "0x5564886ca2c518d1964e5fcea4f423b41db9f561",
- "value": "0"
}, - "blockHash": "0x3a1fba5abd9d41457944e91ed097e039b7b12d3d7ba324a3f422db2277a48e28",
- "blockNumber": 52029,
- "date": "2015-08-08 06:22:55 UTC",
- "result": {
- "gasUsed": 21749
}, - "subtraces": 0,
- "timestamp": 1439014975,
- "traceAddress": [ ],
- "transactionHash": "0x218b632d932371478d1ae5a01620ebab1a2030f9dad6f8fba4a044ea6335a57e",
- "transactionIndex": 0,
- "type": "call"
}
Find block(s) based on date, blockNum, timestamp, or 'special'. Corresponds to the chifra when command line.
blocks | Array of strings <string> [ items <string > ] one or more dates, block numbers, hashes, or special named blocks (see notes) |
list | boolean export a list of the 'special' blocks |
timestamps | boolean display or process timestamps |
count | boolean with --timestamps only, returns the number of timestamps in the cache |
repair | boolean with --timestamps only, repairs block(s) in the block range by re-querying from the chain |
check | boolean with --timestamps only, checks the validity of the timestamp data |
update | boolean with --timestamps only, bring the timestamp database forward to the latest block |
deep | boolean with --timestamps --check only, verifies timestamps from on chain (slow) |
chain | string the chain to use |
noHeader | boolean suppress the header in the output |
cache | boolean force the results of the query into the cache |
decache | boolean removes related items from the cache |
fmt | string export format, one of [ txt | csv | json ] |
{- "blockNumber": 52029,
- "date": "2015-08-08 06:22:55 UTC",
- "name": "firstLog",
- "timestamp": 1439014975
}
Retrieve account balance(s) for one or more addresses at given block(s). Corresponds to the chifra state command line.
addrs required | Array of strings <address> [ items <address > ] one or more addresses (0x...) from which to retrieve balances |
blocks | Array of strings <blknum> [ items <blknum > ] an optional list of one or more blocks at which to report balances, defaults to 'latest' |
parts | Array of strings Items Enum: "balance" "nonce" "code" "proxy" "deployed" "accttype" "some" "all" control which state to export |
changes | boolean only report a balance when it changes from one block to the next |
noZero | boolean suppress the display of zero balance accounts |
call | boolean write-only call (a query) to a smart contract |
calldata | string for commands (--call or --send), provides the call data (in various forms) for the command (may be empty for --send) |
articulate | boolean for commands only, articulate the retrieved data if ABIs can be found |
proxyFor | string <address> for commands only, redirects calls to this implementation |
chain | string the chain to use |
noHeader | boolean suppress the header in the output |
cache | boolean force the results of the query into the cache |
decache | boolean removes related items from the cache |
ether | boolean export values in ether |
fmt | string export format, one of [ txt | csv | json ] |
{- "blockNumber": 13176226,
- "balance": 258843698360318500,
- "nonce": 115,
- "code": "0x",
- "proxy": "0xd9db270c1b5e3bd161e8c8503c55ceabee709552",
- "address": "0xa1e4380a3b1f749673e270229993ee55f35663b4",
- "deployed": 0,
- "accttype": "EOA",
- "ether": 0.2588436983603185
}
Retrieve token balance(s) for one or more addresses at given block(s). Corresponds to the chifra tokens command line.
addrs required | Array of strings <address> [ items <address > ] two or more addresses (0x...), the first is an ERC20 token, balances for the rest are reported |
blocks | Array of strings <blknum> [ items <blknum > ] an optional list of one or more blocks at which to report balances, defaults to 'latest' |
parts | Array of strings Items Enum: "name" "symbol" "decimals" "totalSupply" "version" "some" "all" which parts of the token information to retrieve |
byAcct | boolean consider each address an ERC20 token except the last, whose balance is reported for each token |
changes | boolean only report a balance when it changes from one block to the next |
noZero | boolean suppress the display of zero balance accounts |
chain | string the chain to use |
noHeader | boolean suppress the header in the output |
cache | boolean force the results of the query into the cache |
decache | boolean removes related items from the cache |
fmt | string export format, one of [ txt | csv | json ] |
{- "holder": "0x2910543af39aba0cd09dbb2d50200b3e800a63d2",
- "balance": "624980000000000000",
- "address": "0xbb9bc244d798123fde783fcc1c72d3bb8c189413",
- "name": "The DAO Original",
- "decimals": 1,
- "isContract": true,
- "isErc20": true,
- "isErc721": true
}
Report on and edit the configuration of the TrueBlocks system. Corresponds to the chifra config command line.
mode | string Enum: "show" "edit" either show or edit the configuration |
paths | boolean show the configuration paths for the system |
dump | boolean dump the configuration to stdout |
chain | string the chain to use |
noHeader | boolean suppress the header in the output |
fmt | string export format, one of [ txt | csv | json ] |
{- "clientVersion": "erigon/2021.09.2/linux-amd64/go1.16.3",
- "trueblocksVersion": "GHC-TrueBlocks//0.12.1-alpha-7ac3196d7-20210903",
- "configPath": "~/Library/Application Support/TrueBlocks/",
- "cachePath": "~/Library/Application Support/TrueBlocks/cache/",
- "indexPath": "~/Library/Application Support/TrueBlocks/unchained/",
- "isTesting": false,
- "isArchive": true,
- "isTracing": true,
- "hasEskey": true,
- "hasPinkey": true,
- "date": "2021-09-03 19:38:19 UTC"
}
Report on the state of the internal binary caches. Corresponds to the chifra status command line.
modes | Array of strings Items Enum: "index" "blooms" "blocks" "transactions" "traces" "logs" "statements" "results" "state" "tokens" "monitors" "names" "abis" "slurps" "staging" "unripe" "maps" "some" "all" the (optional) name of the binary cache to report on, terse otherwise |
diagnose | boolean same as the default but with additional diagnostics |
firstRecord | number <uint64> the first record to process |
maxRecords | number <uint64> the maximum number of records to process |
chains | boolean include a list of chain configurations in the output |
healthcheck | boolean an alias for the diagnose endpoint |
chain | string the chain to use |
noHeader | boolean suppress the header in the output |
fmt | string export format, one of [ txt | csv | json ] |
{- "data": [
- {
- "type": "string",
- "items": [
- "string"
], - "lastCached": "string",
- "nFiles": 0,
- "nFolders": 0,
- "path": "string",
- "sizeInBytes": 0
}
]
}
Manage, investigate, and display the Unchained Index. Corresponds to the chifra chunks command line.
mode required | string Enum: "manifest" "index" "blooms" "pins" "addresses" "appearances" "stats" the type of data to process |
blocks | Array of strings <blknum> [ items <blknum > ] an optional list of blocks to intersect with chunk ranges |
check | boolean check the manifest, index, or blooms for internal consistency |
belongs | Array of strings <address> [ items <address > ] in index mode only, checks the address(es) for inclusion in the given index chunk |
firstBlock | number <blknum> first block to process (inclusive) |
lastBlock | number <blknum> last block to process (inclusive) |
maxAddrs | number <uint64> the max number of addresses to process in a given chunk |
deep | boolean if true, dig more deeply during checking (manifest only) |
rewrite | boolean for the --pin --deep mode only, writes the manifest back to the index folder (see notes) |
count | boolean for certain modes only, display the count of records |
sleep | number <float64> for --remote pinning only, seconds to sleep between API calls |
chain | string the chain to use |
noHeader | boolean suppress the header in the output |
fmt | string export format, one of [ txt | csv | json ] |
{- "fileName": "000000000-000000000",
- "bloomHash": "QmbCQaYmfTR3sGNAvASoVjPynaY9UD31Hfxv7dGtzsptkb",
- "indexHash": "QmPmfSrYT5HDpfjj4uYSycaFECo9EqPSuADQ3YPbVp3yu4"
}
Initialize the TrueBlocks system by downloading the Unchained Index from IPFS. Corresponds to the chifra init command line.
all | boolean in addition to Bloom filters, download full index chunks (recommended) |
example | string create an example for the SDK with the given name |
dryRun | boolean display the results of the download without actually downloading |
firstBlock | number <blknum> do not download any chunks earlier than this block |
sleep | number <float64> seconds to sleep between downloads |
chain | string the chain to use |
{- "data": [
- {
- "range": "string",
- "bloomHash": "string",
- "indexHash": "string",
- "bloomSize": 0,
- "indexSize": 0,
- "rangeDates": { }
}
]
}
Fetch data from Etherscan and other APIs for any address. Corresponds to the chifra slurp command line.
addrs required | Array of strings <address> [ items <address > ] one or more addresses to slurp from Etherscan |
blocks | Array of strings <blknum> [ items <blknum > ] an optional range of blocks to slurp |
parts | Array of strings Items Enum: "ext" "int" "token" "nfts" "1155" "miner" "uncles" "withdrawals" "some" "all" which types of transactions to request |
appearances | boolean show only the blocknumber.tx_id appearances of the exported transactions |
articulate | boolean articulate the retrieved data if ABIs can be found |
source | string Enum: "etherscan" "key" "covalent" "alchemy" the source of the slurped data |
count | boolean for --appearances mode only, display only the count of records |
page | number <uint64> the page to retrieve (page number) |
pageId | string the page to retrieve (page ID) |
perPage | number <uint64> the number of records to request on each page |
sleep | number <float64> seconds to sleep between requests |
chain | string the chain to use |
noHeader | boolean suppress the header in the output |
cache | boolean force the results of the query into the cache |
decache | boolean removes related items from the cache |
ether | boolean export values in ether |
fmt | string export format, one of [ txt | csv | json ] |
{- "hash": "0x2ec382949ba0b22443aa4cb38267b1fb5e68e188109ac11f7a82f67571a0adf3",
- "blockHash": "0xeab8fe9da0b41b2c003db620bb9adbedd5fcc7222cc50d53431aa1df47a20dda",
- "blockNumber": "46217",
- "transactionIndex": "0",
- "timestamp": "1438919451",
- "from": "0xc8ebccc5f5689fa8659d83713341e5ad19349448",
- "to": "0xc8ebccc5f5689fa8659d83713341e5ad19349448",
- "value": "0",
- "gas": "21000",
- "gasPrice": "65334370444",
- "maxFeePerGas": "0",
- "maxPriorityFeePerGas": "0",
- "input": "0x",
- "isError": "0",
- "hasToken": "0",
- "gasUsed": "21000",
- "date": "2015-08-07 03:50:51 UTC",
- "ether": "0.000000000000000000"
}