substreams_evm_precompiles_popularity

maoueh

v0.3.1/2 downloads

Package ref

substreams-evm-precompiles-popularity@v0.3.1

Download .spkg

Run package

CLI

Run map_counts from the command line.

substreams run substreams-evm-precompiles-popularity@v0.3.1 map_counts -e mainnet

Authenticate by running substreams auth or directly on thegraph.market (see docs).

README

Substreams EVM Precompiles Popularity

This project leverages Substreams to calculate the popularity of Ethereum precompiled contracts from call data.

Overview

Processes Ethereum call events using Substreams.
Counts and maps occurrences of precompiles.
Outputs results using Protocol Buffers.

Getting Started

substreams gui substreams-evm-precompiles-popularity@v0.2.0

Results

Ethereum Mainnet

At block #21 996 000:

0x0000000000000000000000000000000000000001 => 247543455 (ecrecover)
0x0000000000000000000000000000000000000002 => 128524392 (sha256Hash)
0x0000000000000000000000000000000000000004 => 46295370 (dataCopy)
0x0000000000000000000000000000000000000006 => 44480667 (bn256Add)
0x0000000000000000000000000000000000000007 => 44330095 (bn256ScalarMul)
0x0000000000000000000000000000000000000005 => 16939742 (bigModExp)
0x0000000000000000000000000000000000000008 => 2504972 (bn256Pairing)
0x0000000000000000000000000000000000000003 => 618211 (ripemd160Hash)
0x000000000000000000000000000000000000000a => 570252 (kzgPointEvaluation)
0x0000000000000000000000000000000000000009 => 161695 (blake2F)

Compute Results

substreams run substreams-evm-precompiles-popularity@v0.2.0 map_counts -s 21996000 -t +1 -o jsonl | skip 1 | head -n1 | jq -rc '."@data".entries | sort_by(-(.count|tonumber)) | .[] | "0x\(.address) => \(.count) (\(.name))"'

License

Apache 2.0

Modules

Execution graph

5 modules

mapMain

map_counts

Output

contract.v1.PrecompilesPopularity

Inputs

store_counts store_counts

store

store_counts

Store value

int64

Update policy

add

Inputs

ethcommon:filtered_calls

Show 3 dependencies

map

ethcommon:all_calls

`all_calls` gives you all the calls in a block (including internal calls), with basic block hash/number/timestamp and transaction hash

Output

sf.substreams.ethereum.v1.Calls

Inputs

sf.ethereum.type.v2.Block

map

ethcommon:filtered_calls

`filtered_calls` reads from `all_calls` and applies a filter on the called contract, the caller and the method 4-bytes signature Supported operators are: logical or `||`, logical and `&&` and parenthesis: `()` Addresses to match must be written as 0x-prefixed hexadecimal, lowercase, prefixed by `call_to:` or `call_from:`, methods by `call_method:`. Example: `(call_to:0x1234... || call_from:0x1234...) && call_method:0xdeadbeef...`

Output

sf.substreams.ethereum.v1.Calls

Inputs

paramsethcommon:all_calls

blockIndex

ethcommon:index_calls

`index_calls` sets the following keys on the block: * Call contract call_to:0x0123456789abcdef0123456789abcdef01234567 (contract address in hex, prefixed by 0x) * Caller call_from:0x0123456789abcdef0123456789abcdef01234567 (caller address in hex, prefixed by 0x) * Call method call_method:0x01234567 (4 bytes of method signature in hex, prefixed by 0x)

Output

sf.substreams.index.v1.Keys

Inputs

ethcommon:all_calls

Protobuf

contract.v1

PrecompilesPopularitymain

contract.v1.PrecompilesPopularity

Entry[]entries = 1

Entry

contract.v1.Entry

stringname = 1

stringaddress = 2

int64count = 3

Show 14 dependencies

sf.ethereum.substreams.v1

RpcCall

sf.ethereum.substreams.v1.RpcCall

bytesto_addr = 1

bytesdata = 2

RpcCalls

sf.ethereum.substreams.v1.RpcCalls

RpcCall[]calls = 1

RpcResponse

sf.ethereum.substreams.v1.RpcResponse

bytesraw = 1

boolfailed = 2

RpcResponses

sf.ethereum.substreams.v1.RpcResponses

RpcResponse[]responses = 1

sf.ethereum.type.v2

BlockRef

sf.ethereum.type.v2.BlockRef

byteshash = 1

uint64number = 2

BlockWithRefs

sf.ethereum.type.v2.BlockWithRefs

BlockWithRefs is a lightweight block, with traces and transactions purged from the block within, and only. It is used in transports to pass block data around.

stringid = 1

Blockblock = 2

TransactionRefstransaction_trace_refs = 3

boolirreversible = 4

HeaderOnlyBlock

sf.ethereum.type.v2.HeaderOnlyBlock

HeaderOnlyBlock is used to optimally unpack the [Block] structure (note the corresponding message number for the header field) while consuming less memory, when only the header is desired.

WARN: this is a client-side optimization pattern and should be moved in the consuming code.

BlockHeaderheader = 5

TransactionRefs

sf.ethereum.type.v2.TransactionRefs

bytes[]hashes = 1

TransactionTraceWithBlockRef

sf.ethereum.type.v2.TransactionTraceWithBlockRef

TransactionTracetrace = 1

BlockRefblock_ref = 2

Reasonenum

sf.ethereum.type.v2.BalanceChange.Reason

REASON_UNKNOWN = 0

REASON_REWARD_MINE_UNCLE = 1

REASON_REWARD_MINE_BLOCK = 2

REASON_DAO_REFUND_CONTRACT = 3

REASON_DAO_ADJUST_BALANCE = 4

REASON_TRANSFER = 5

REASON_GENESIS_BALANCE = 6

REASON_GAS_BUY = 7

REASON_REWARD_TRANSACTION_FEE = 8

REASON_REWARD_FEE_RESET = 14

REASON_GAS_REFUND = 9

REASON_TOUCH_ACCOUNT = 10

REASON_SUICIDE_REFUND = 11

REASON_SUICIDE_WITHDRAW = 13

REASON_CALL_BALANCE_OVERRIDE = 12

REASON_BURN = 15

Used on chain(s) where some Ether burning happens

REASON_WITHDRAWAL = 16

CallTypeenum

sf.ethereum.type.v2.CallType

UNSPECIFIED = 0

CALL = 1

direct? what's the name for Call alone?

CALLCODE = 2

DELEGATE = 3

STATIC = 4

CREATE = 5

create2 ? any other form of calls?

Reasonenum

sf.ethereum.type.v2.GasChange.Reason

REASON_UNKNOWN = 0

REASON_CALL = 1

REASON_CALL_CODE = 2

REASON_CALL_DATA_COPY = 3

REASON_CODE_COPY = 4

REASON_CODE_STORAGE = 5

REASON_CONTRACT_CREATION = 6

REASON_CONTRACT_CREATION2 = 7

REASON_DELEGATE_CALL = 8

REASON_EVENT_LOG = 9

REASON_EXT_CODE_COPY = 10

REASON_FAILED_EXECUTION = 11

REASON_INTRINSIC_GAS = 12

REASON_PRECOMPILED_CONTRACT = 13

REASON_REFUND_AFTER_EXECUTION = 14

REASON_RETURN = 15

REASON_RETURN_DATA_COPY = 16

REASON_REVERT = 17

REASON_SELF_DESTRUCT = 18

REASON_STATIC_CALL = 19

REASON_STATE_COLD_ACCESS = 20

Added in Berlin fork (Geth 1.10+)

Typeenum

sf.ethereum.type.v2.TransactionTrace.Type

TRX_TYPE_LEGACY = 0

All transactions that ever existed prior Berlin fork before EIP-2718 was implemented.

TRX_TYPE_ACCESS_LIST = 1

Transaction that specicy an access list of contract/storage_keys that is going to be used in this transaction.

Added in Berlin fork (EIP-2930).

TRX_TYPE_DYNAMIC_FEE = 2

Transaction that specifis an access list just like TRX_TYPE_ACCESS_LIST but in addition defines the max base gas gee and max priority gas fee to pay for this transaction. Transaction's of those type are executed against EIP-1559 rules which dictates a dynamic gas cost based on the congestion of the network.

TransactionTraceStatusenum

sf.ethereum.type.v2.TransactionTraceStatus

UNKNOWN = 0

SUCCEEDED = 1

FAILED = 2

REVERTED = 3