User Guide

Synapse-Etherscan User Guide

Synapse-Etherscan adds new Storm commands to allow you to query the Etherscan 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:

> etherscan.setup.apikey eth --self myapikey
Setting Etherscan (eth) API key for the current user.

Use Etherscan to enrich nodes

Enrich a crypto:currency:address node with etherscan.enrich and yield the results:

> [ crypto:currency:address=(eth, 0x32F1Af729bAa768fb9d30F5Dbc295B7737a3E210) ] | etherscan.enrich --yield --size 3
crypto:currency:transaction=3d60f43557d72b66f873d140f3541d6e
        .created = 2024/11/06 19:29:42.213
        :block = eth/12971814
        :block:coin = eth
        :block:offset = 12971814
        :eth:gaslimit = 207128
        :eth:gasprice = 0.000000062
        :eth:gasused = 21000
        :from = eth/0xDFd5293D8e347dFe59E90eFd55b2956a1343963d
        :hash = f45b8ff1335fad160e00cba42df67462101b1353eee96e21e2c5168a84a7a3a9
        :success = true
        :time = 2021/08/06 14:00:24.000
        :to = eth/0x32F1Af729bAa768fb9d30F5Dbc295B7737a3E210
        :value = 4.0965
crypto:currency:transaction=a416dc317462a38cc114f0574e0c9e16
        .created = 2024/11/06 19:29:42.269
        :block = eth/12971837
        :block:coin = eth
        :block:offset = 12971837
        :contract:input = sha256:27c28a1d7429e3db79ec1aebe196de7be355143c9bc9ad29d2712797099f79ee
        :eth:gaslimit = 215887
        :eth:gasprice = 0.000000052320218757
        :eth:gasused = 163754
        :from = eth/0x32F1Af729bAa768fb9d30F5Dbc295B7737a3E210
        :hash = 6ca2643fd1dbb23daa43b306fdc20f72db616be5e775cdf1c96e6352d139c59d
        :success = true
        :time = 2021/08/06 14:06:41.000
        :to = eth/0x1A2a1c938CE3eC39b6D47113c7955bAa9DD454F2
        :value = 2.4
crypto:currency:transaction=f192d0d056494c68aa07147a2f909903
        .created = 2024/11/06 19:29:42.336
        :block = eth/12971864
        :block:coin = eth
        :block:offset = 12971864
        :eth:gaslimit = 21000
        :eth:gasprice = 0.000000051
        :eth:gasused = 21000
        :from = eth/0x32F1Af729bAa768fb9d30F5Dbc295B7737a3E210
        :hash = 7e3df29a81e8ec78d7fb53194c3e9692e1fa88301a6ad900d7bbc52f40ca99eb
        :success = true
        :time = 2021/08/06 14:13:29.000
        :to = eth/0xc073D4d22C851c662A963E398022Bf138555303c
        :value = 1.55

Query multiple chains using a hash argument and yield the results:

> etherscan.enrich.hash 0xF0245F6251Bef9447A08766b9DA2B07b28aD80B0 --coin eth polygon --size 2 --yield
crypto:currency:transaction=5eb88169dbefb82ab32493f07a189e70
        .created = 2024/11/06 19:29:43.028
        :block = eth/13055340
        :block:coin = eth
        :block:offset = 13055340
        :eth:gaslimit = 21000
        :eth:gasprice = 0.000000029124495648
        :eth:gasused = 21000
        :from = eth/0xDDB833b9e0e3f2F521480e7Bcb3e676E0737047d
        :hash = 1f3fadee389f8393991e71974145a5fa2de049ed0a6264a9da879f1c97df3d51
        :success = true
        :time = 2021/08/19 11:08:52.000
        :to = eth/0xF0245F6251Bef9447A08766b9DA2B07b28aD80B0
        :value = 4.319765525314957809
crypto:currency:transaction=df23226f953c4cac2acacbb2664a47a4
        .created = 2024/11/06 19:29:43.081
        :block = eth/13056982
        :block:coin = eth
        :block:offset = 13056982
        :contract:input = sha256:e8c05ca256a4cece99a2da695899ecdf753b7995cd124a0189f1e57886c8e415
        :eth:gaslimit = 2156471
        :eth:gasprice = 0.000000073534170823
        :eth:gasused = 2078783
        :from = eth/0xF0245F6251Bef9447A08766b9DA2B07b28aD80B0
        :hash = be9d1e2c39412f3a5d31e6083b1c8ac84d56c4ee6e3ba29dd94f6f449f6618db
        :success = true
        :time = 2021/08/19 17:10:55.000
        :to = eth/0x86E4Dc95c7FBdBf52e33D563BbDB00823894C287
        :value = 0
crypto:currency:transaction=0b41ee119d6f4e8d6577b55d8b61434c
        .created = 2024/11/06 19:29:43.291
        :block = polygon/18654325
        :block:coin = polygon
        :block:offset = 18654325
        :eth:gaslimit = 21000
        :eth:gasprice = 0.00000003
        :eth:gasused = 21000
        :from = polygon/0xF0245F6251Bef9447A08766b9DA2B07b28aD80B0
        :hash = edf831328291b404b69b0b41360fdafbb7e8f98beb87b916d5415a90df316306
        :success = true
        :time = 2021/09/02 07:41:44.000
        :to = polygon/0x2b563420722cBcFC84857129Bef775e0dC5F1401
        :value = 44211.438807197944577722
crypto:currency:transaction=485ecfba1adb90cc4791ff35549218af
        .created = 2024/11/06 19:29:43.344
        :block = polygon/18711859
        :block:coin = polygon
        :block:offset = 18711859
        :eth:gaslimit = 21000
        :eth:gasprice = 0.000000001000000001
        :eth:gasused = 21000
        :from = polygon/0xF0245F6251Bef9447A08766b9DA2B07b28aD80B0
        :hash = 9d3b0b478fcc62d62328ab92038809e0b0417ecaa24d381d4d6b8749fcebaaff
        :success = true
        :time = 2021/09/03 19:31:25.000
        :to = polygon/0x2b563420722cBcFC84857129Bef775e0dC5F1401
        :value = 4407.901439470710765904

Use of meta:source nodes

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

> meta:source=2dddff51304a19ce0bc77a1c9cfd22bb
meta:source=2dddff51304a19ce0bc77a1c9cfd22bb
        .created = 2024/11/06 19:29:42.072
        :name = etherscan api

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

> crypto:currency:coin=polygon -> crypto:currency:transaction +{ <(seen)- meta:source=2dddff51304a19ce0bc77a1c9cfd22bb }
crypto:currency:transaction=485ecfba1adb90cc4791ff35549218af
        .created = 2024/11/06 19:29:43.344
        :block = polygon/18711859
        :block:coin = polygon
        :block:offset = 18711859
        :eth:gaslimit = 21000
        :eth:gasprice = 0.000000001000000001
        :eth:gasused = 21000
        :from = polygon/0xF0245F6251Bef9447A08766b9DA2B07b28aD80B0
        :hash = 9d3b0b478fcc62d62328ab92038809e0b0417ecaa24d381d4d6b8749fcebaaff
        :success = true
        :time = 2021/09/03 19:31:25.000
        :to = polygon/0x2b563420722cBcFC84857129Bef775e0dC5F1401
        :value = 4407.901439470710765904
crypto:currency:transaction=0b41ee119d6f4e8d6577b55d8b61434c
        .created = 2024/11/06 19:29:43.291
        :block = polygon/18654325
        :block:coin = polygon
        :block:offset = 18654325
        :eth:gaslimit = 21000
        :eth:gasprice = 0.00000003
        :eth:gasused = 21000
        :from = polygon/0xF0245F6251Bef9447A08766b9DA2B07b28aD80B0
        :hash = edf831328291b404b69b0b41360fdafbb7e8f98beb87b916d5415a90df316306
        :success = true
        :time = 2021/09/02 07:41:44.000
        :to = polygon/0x2b563420722cBcFC84857129Bef775e0dC5F1401
        :value = 44211.438807197944577722