Skip to content

BlockRunAI/onchain-settlements

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

BlockRun on-chain settlement data

Raw, per-transfer records of every USDC payment received by a BlockRun treasury on Base, published daily. This is public blockchain data — released here so anyone can reconcile their BlockRun usage against actual on-chain settlements without needing their own indexer or API key.

Every row is independently verifiable: paste the txHash into basescan.org.

Layout

data/base/YYYY/MM/DD.ndjson.gz   one gzipped NDJSON file per UTC day
data/base/latest.json            { lastPublishedDay, updatedAt }

Row shape:

{
  "txHash": "0x…",
  "from": "0x… payer wallet (lowercase)",
  "treasury": "0x… receiving treasury (lowercase)",
  "amountUsdc": 0.290352,
  "blockNum": 31873921,
  "blockTimestamp": "2026-06-10T08:00:01.000Z"
}

Treasuries covered

  • 0xe9030014F5DAe217d0A152f02A043567b16c1aBf (primary)
  • 0x6E007731870EDe419CfB31889Cd5C4493CEcb04c
  • 0x1b092B21BC07076E3adEDe7bAc8216daEa115e99

Reconciling your wallet

Filter any day file by from == your wallet (lowercase) and compare against the per-call ledger from the gateway:

GET https://blockrun.ai/api/v1/wallet/<address>/reconciliation?days=…

…or just use the accounting MCP, which does the matching automatically (and falls back to this dataset when no local RPC key is configured).

Freshness & caveats

  • Published daily at ~00:30 UTC for the previous UTC day (GitHub Action).
  • The current (partial) day is not in the dataset yet — use the gateway's ?onchain=1 cross-check for intraday totals.
  • Solana settlements are not yet included.
  • Source: Alchemy getAssetTransfers over the USDC contract, filtered to the treasuries above. Days are pulled with generous block-range margins and filtered precisely by block timestamp.

About

Raw on-chain USDC settlement data for BlockRun treasuries (Base) — daily NDJSON, independently verifiable on Basescan

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors