Package Logo
xarb
xarb@v0.1.0
Total Downloads
1
Published
10 hours ago
Publisher
User Avatar rladyd818

Readme

xarb-substreams-hub

Substreams package for xArb hub-side events on Base Sepolia (84532).

Directory

xarb-substreams-hub/
  substreams.yaml
  .env.example
  src/
  build.rs

Build

cd /Users/kd/substreams/xarb-substreams/xarb-substreams-hub
cp -n .env.example .env
substreams build

Run (Events Only)

map_events_only is the default output module used by current propagator flow.

cd /Users/kd/substreams/xarb-substreams/xarb-substreams-hub
substreams run substreams.yaml map_events_only

Optional Run (Events + Calls)

Use map_events_calls only when you need call-level output.

cd /Users/kd/substreams/xarb-substreams/xarb-substreams-hub
set -a
source .env
set +a

substreams run substreams.yaml map_events_calls \
  -p "map_calls=${XARB_HUB_TRACKED_CONTRACTS}"

Tracked Address Sync

When contracts are re-deployed, run the monorepo sync script:

cd /Users/kd/substreams/xarb-substreams
./scripts/redeploy_and_sync_contracts.sh

It updates .env, deployment JSONs, and substreams.yaml filters to latest addresses.

Notes

  • substreams.yaml has static blockFilter values for call indexing modules.
  • If manual edits are made to tracked addresses, rebuild with substreams build.

Documentation

Modules

Maps icon
Maps

map
map_tx_indices

a76f0867c700e89ea0a430d1add22c223271d7c4
map map_tx_indices (
blocksf.ethereum.type.v2.Block
)  -> contract.v1.TxIndices
substreams gui xarb@v0.1.0 map_tx_indices

map
map_events

d12cd82c4e64e1bbedf41d72524bdb3546e16c48
substreams gui xarb@v0.1.0 map_events

map
map_calls

c719f69eb5477c4d58027e8cb70a9c3f6c7690a5
map map_calls (
paramsstring
)  -> contract.v1.Calls
substreams gui xarb@v0.1.0 map_calls

map
map_events_calls

b5ae2e171181fcbee9fb15a191f2d3e2f468bc49
substreams gui xarb@v0.1.0 map_events_calls

map
map_events_only

7bd2270e659cc115b631294a8fe480bfd1ba3dd9
substreams gui xarb@v0.1.0 map_events_only

map
ethcommon:all_events

433686393b184c57628660f7dbe6cfed4d72a9e9
map ethcommon:all_events (
)  -> sf.substreams.ethereum.v1.Events

all_events gives you all the events in a block (from successful transactions), with basic block hash/number/timestamp and transaction hash

substreams gui xarb@v0.1.0 ethcommon:all_events

map
ethcommon:all_calls

24025f6e747a1e5fcee9a308f132a566d7a3e771
map ethcommon:all_calls (
)  -> sf.substreams.ethereum.v1.Calls

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

substreams gui xarb@v0.1.0 ethcommon:all_calls
Block Indexes icon
Block Indexes

blockIndex
ethcommon:index_calls

3905aca0b839f90a6e4a024f963c327839e71143

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)
substreams gui xarb@v0.1.0 ethcommon:index_calls
Protobuf

Protobuf Docs Explorer

sf.ethereum.substreams.v1
sf.ethereum.type.v2
sf.ethereum.transform.v1
contract.v1