User Guide

Synapse-Blockchair User Guide

Synapse-Blockchair adds new Storm commands to allow you to query the Blockchair API using your existing API key.

Getting Started

Check with your Admin to enable permissions and find out if you need a personal API key.

Examples

Setting your personal API key

To set-up a personal use API key:

> blockchair.setup.apikey --self myapikey
Setting Blockchair API key for the current user.

Load smart contract effects for an Ethereum transaction

Enrich a crypto:currency:transaction node with blockchair.enrich:

> crypto:currency:transaction#mytx | blockchair.enrich
crypto:currency:transaction=7450670ecaac113b6bd45a8b9ac87b60
        .created = 2024/12/20 17:52:24.936
        :block:coin = eth
        :hash = b9eb57bce55b5a44514a1f3c2f69972e34f73141f1d3dc9a65f7218991687c8a
        #mytx

Pivot to crypto:smart:effect:minttoken nodes:

> $hash=0xb9eb57bce55b5a44514a1f3c2f69972e34f73141f1d3dc9a65f7218991687c8a
  crypto:currency:transaction:hash=$hash
  -> crypto:smart:effect:minttoken

Pivot to the crypto:smart:token nodes which were minted in the transaction:

> $hash=0xb9eb57bce55b5a44514a1f3c2f69972e34f73141f1d3dc9a65f7218991687c8a
  crypto:currency:transaction:hash=$hash
  -> crypto:smart:effect:minttoken
  -> crypto:smart:token

Pivot to crypto:smart:effect:transfertoken nodes:

> $hash=0xb9eb57bce55b5a44514a1f3c2f69972e34f73141f1d3dc9a65f7218991687c8a
  crypto:currency:transaction:hash=$hash
  -> crypto:smart:effect:transfertoken

Use of `meta:source` nodes

Synapse-Blockchair uses a meta:source node and -(seen)> light weight edges to track nodes observed from the Blockchair API.

> meta:source=620834fa2b5684b63fb12b48352b17d5
meta:source=620834fa2b5684b63fb12b48352b17d5
        .created = 2024/12/20 17:52:25.074
        :name = blockchair api

Storm can be used to filter nodes to include/exclude nodes which have been observed by Synapse-Blockchair. The following example shows how to filter the results of a query to include only results observed by Synapse-Blockchair:

> crypto:smart:effect:minttoken +{ <(seen)- meta:source=620834fa2b5684b63fb12b48352b17d5 }