Skip to main content

Tokenomics Inspection Cheatsheet

Bash RC helpers​

There are a handful of useful bash helpers in the tools/rc_helpers directory.

source ./tools/rc_helpers/queries.sh
Available commands:
  shannon_query_unique_tx_msgs_and_events  - Get unique message and event types
  shannon_query_unique_block_events        - Get unique block events
  shannon_query_tx_messages                - Query transactions by message type
  shannon_query_tx_events                  - Query transactions by event type
  shannon_query_block_events               - Query block events
  shannon_query_unique_claim_suppliers     - Get unique claim supplier addresses
  shannon_query_supplier_tx_events         - Get supplier-specific transaction events
  shannon_query_supplier_block_events      - Get supplier-specific block events
  shannon_query_application_block_events   - Get application-specific block events

pocketd CLI queries​

To inspect various tokenomics params, you can query the tokenomics module

pocketd q tokenomics --help

To inspect onchain claims & proofs, you can query the proofs module

pocketd q proofs --help

Available Onchain Events​

You can find all available events by running

grep -r "message Event" ./proto/pocket/tokenomics

And filtering for the events you're interested in inspecting either onchain txs:

pocketd q txs --help

Or onchain blocks:

pocketd q block-results --help

Viewing Account Balance over time​

The following is an example of how to view the balance of pokt1lla0yhjf2fhzrlgu6le3ymw9aqayepxlx3lf4q grow from height 205950 to 210000 in 30 height increments.

for ((h=205950; h<=210000; h+=30)); do echo -n "Height $h: "; curl -s -H "x-cosmos-block-height: $h" https://shannon-grove-api.mainnet.poktroll.com/cosmos/bank/v1beta1/balances/pokt1lla0yhjf2fhzrlgu6le3ymw9aqayepxlx3lf4q | jq -r '.balances[0].amount // "0"'; done

Inspecting Claim settlement in a specific block​

If some block was used for claim settlemend (e.g. 210033), you can download it like so:

pocketd query block-results 210033 --network=main --grpc-insecure=false -o json >> block_210033.json

And identify all the events related to token transfers associated with a particular account (e.g. pokt1lla0yhjf2fhzrlgu6le3ymw9aqayepxlx3lf4q)

cat block_210033.json | jq -r '.finalize_block_events[]
  | select(.type == "transfer")
  | select(.attributes[]?
      | select(.key == "recipient" and .value == "pokt1lla0yhjf2fhzrlgu6le3ymw9aqayepxlx3lf4q"))
  | .attributes[]
  | select(.key == "amount")
  | .value'