All skills
paulrberg avatar

/evm-atlas

@592682c
by Paul Bergpaulrberg/agent-skills94 stars
7

Use for targeted EVM chain, account, transaction, RPC, explorer, bridge, and DEX evidence: chain name/ID, native symbol, RouteMesh, wallet balances via Blockscan in Chromium, token/NFT holdings/transfers, tx history, funding origin via Etherscan/Blockscout/Chainscout; Across, Bungee, deBridge, Hop, Layerswap, LayerZero, LI.FI, Relay, Socket, Symbiosis; Uniswap v1-v4, Universal Router, Permit2, 1inch Classic/Fusion/Fusion+, and CoW Swap, CoWSwap, CoW Protocol, or GPv2 swaps, orders, liquidity, approvals, permits, rewards, migrations, wrapping, cancellations, and refunds.

Use this Skill: https://skilld.dev/gh/paulrberg/agent-skills/evm-atlas

This session only. Nothing lands on disk.

referencesexplorersoptimism-pre-regenesis.md

≈2.5k tokens on demand. Your agent reads this file only when SKILL.md points to it.

OP Mainnet Pre-Regenesis History

Evidence Boundary

Use this reference for OP Mainnet (chain_id=10) queries that target activity before the final regenesis on 2021-11-11.

Current OP Mainnet JSON-RPC cannot return a canonical eth_getTransactionReceipt response for an OVM1 transaction removed by the final regenesis. A current-RPC null, provider archive failure, or explorer omission proves only native receipt unavailability; it is not negative evidence that the historical transaction occurred.

Dune's optimism_legacy_ovm1 transaction, log, and trace rows are historical execution evidence. When the required components agree, reconstruct a legacy execution packet. Never call that packet a receipt: it is neither an authenticated JSON-RPC receipt nor a historical state-trie proof. Preserve its Dune provenance and every missing component.

Exact-Transaction Workflow

  1. Establish that the target is on OP Mainnet and predates the final regenesis. Use supplied context, another dated source, or the exact Dune transaction row. Do not infer nonexistence when current OP Mainnet routes cannot resolve the hash.

  2. Query all three legacy tables by the exact hash. Replace <TX_HASH_HEX> with the 64 hexadecimal digits while retaining DuneSQL's 0x varbinary prefix:

    SELECT *
    FROM optimism_legacy_ovm1.transactions
    WHERE hash = 0x<TX_HASH_HEX>;
    
    SELECT *
    FROM optimism_legacy_ovm1.logs
    WHERE tx_hash = 0x<TX_HASH_HEX>
    ORDER BY "index";
    
    SELECT *
    FROM optimism_legacy_ovm1.traces
    WHERE tx_hash = 0x<TX_HASH_HEX>
    ORDER BY trace_address;
  3. Require exactly one transaction row. Preserve zero rows or duplicate rows as a coverage outcome; do not choose a row heuristically.

  4. Verify the transaction hash, block number, block hash, and block time agree across every returned component. Verify transaction from/to against each log's tx_from/tx_to; verify transaction success against each trace's tx_success. A trace's own from, to, and success describe that call, so reconcile them through the call hierarchy rather than forcing them to equal the root transaction fields.

  5. Preserve log indices exactly in ascending order. Preserve trace-address arrays in ascending hierarchy order, including the root when present. Record duplicate, missing, or contradictory ordering metadata as a coverage gap; never renumber rows.

  6. Use the address dashboard only to discover candidate hashes for an address-wide request. An exact-hash request uses the table workflow above.

Legacy Execution Packet

Return exact values; do not truncate identifiers or normalize away nulls.

Component Dune provenance Required packet fields
Transaction optimism_legacy_ovm1.transactions success, from, to, value, data, gas fields, block_number, block_hash, block_time, transaction index/hash
Logs optimism_legacy_ovm1.logs, ordered by index contract_address, topics, data, index, transaction index/hash, block fields, tx_from, tx_to
Traces optimism_legacy_ovm1.traces, ordered by path call from/to, type, call_type, input, output, value, success, error, tx_success, trace_address

Attach the namespace and table name to each component, plus an explicit coverage_gaps list. A packet is complete only for the requested determination; complete execution rows do not independently prove historical contract state, deployment identity, wallet ownership, or an LP principal/fee split.

Coverage Outcomes

Record native-receipt availability separately from packet coverage:

Outcome Record when
Native receipt unavailable Current RPC returns null, an archive route fails, or the current explorer omits the transaction.
Historical execution evidence absent The exact transaction row is absent. This is absence from Dune, not proof the transaction never existed.
Legacy execution packet partial The transaction exists but zero log rows return and non-emission is not otherwise proven.
Legacy execution packet partial Transaction and logs exist but traces are absent, contradictory, or structurally incomplete.
Legacy execution packet partial Optimism's known January-July 2021 execution-effects loss may cover a required component.
Execution packet complete, state gap Execution is reconstructable, but required historical contract, wallet, or position state is unavailable.
Complete enough for determination Transaction, ordering, logs, traces, identity, state, and wallet deltas needed by the request are proven.

Zero logs can be a legitimate execution result. Promote that outcome beyond partial only when verified calldata, traces, and contract semantics show that no relevant event should exist. Likewise, trace rows are not complete merely because at least one row returned; reconcile their hierarchy, transaction status, errors, and required internal value movement.

Concentrated-Liquidity Reconstruction

When the accounting result depends on a concentrated-liquidity position:

  1. Identify the position token and prove the exact position-manager deployment used historically. Do not substitute a current explorer label or a same-interface deployment.
  2. Retrieve the full prior lifecycle for that position, from creation through the target transaction. Include every position transfer, liquidity increase/decrease, collection, and other state-changing action supported by the exact deployment's events and calls.
  3. Reconstruct the last pre-transaction liquidity state and whether principal or fees were already owed. Never infer historical state from a current position lookup. Treat an unproven zero balance as unknown, not zero.
  4. Decode the target's exact command order and maximum collect bounds. Bounds and calldata express intent; ordered logs, traces, and wallet movements establish execution.
  5. Reconcile decrease, collect, unwrap, sweep, refund, and final transfer evidence using exact integer amounts. Keep native and wrapped legs distinct.
  6. Verify a principal/fee split only when the complete lifecycle and target execution support the residual. Otherwise report the combined collection and name the missing pre-state or lifecycle evidence.

Browser and Persistence Boundary

Chrome DevTools may run bounded, read-only Dune queries. Executing a query may consume Dune credits. Leave queries unsaved by default; saving, publishing, scheduling, or otherwise externally persisting one requires explicit authority. Never put a private hash, wallet, position identifier, or financial value into this installable reference.

As of 2026-09-10, Dune's Free plan is view-only: public dashboards, query source, and data collections remain viewable, but exact-hash table lookups and parameterized address-dashboard results require query execution on a paid plan. Affected existing accounts received temporary Plus access through 2026-09-24, with 2,500 trial credits. The unsaved browser workflow needs only query execution, so Dune advertises Analyst as sufficient; Plus is not required for this route. Never purchase or upgrade without explicit authority.

Treat a missing execution entitlement or exhausted credit balance as a provider-plan coverage gap, not historical absence. Chromium does not bypass server-side plan enforcement, and viewing or copying a public query does not produce fresh address-parameterized or exact-hash results. Dune's older pricing FAQ and the OVM1 dashboard copy may still mention free executions or free credits; resolve entitlement from the live pricing page and the credentialed account.

Separately, Dune's Application Service Addendum directs programmatic interaction to its API service. Chrome DevTools automation may be considered programmatic even when it drives the graphical site. Do not represent a paid browser workflow as terms-cleared; prefer a supported API or MCP route for repeated automation, or obtain Dune clarification.

Deeper Fallback

For the January-July 2021 period, Optimism documents partial loss of transaction execution effects, including emitted events and success state. When Dune genuinely lacks the exact transaction or a required lifecycle event, the raw inputs published through Ethereum's CanonicalTransactionChain are a deeper reconstruction path. Re-execution is laborious, costly, and may remain incomplete. Do not require it when the Dune packet already answers the requested question.

Sources

  • Optimism, "Accessing pre-regenesis history": https://docs.optimism.io/op-mainnet/pre-bedrock-history/regenesis-history
  • Optimism, "Lost pre-regenesis data": https://docs.optimism.io/op-mainnet/pre-bedrock-history/lost-pre-regenesis-data
  • Dune catalog: https://dune.com/data/optimism_legacy_ovm1.transactions, https://dune.com/data/optimism_legacy_ovm1.logs, and https://dune.com/data/optimism_legacy_ovm1.traces
  • DuneSQL varbinary literals: https://docs.dune.com/query-engine/datatypes#varbinary
  • Dune query execution and credit behavior: https://docs.dune.com/query-engine/query-executions
  • OVM1 address dashboard: https://dune.com/optimismfnd/OVM1.0-User-Address-Transactions
  • Dune pricing: https://dune.com/pricing
  • Dune Application Service Addendum: https://dune.com/application-terms

Source: SKILL.md on GitHub

No alerts1d3 checks · Risk SAFE
  • Gen Agent Trust Hub1d

    The skill is a comprehensive toolkit for exploring EVM blockchain data across multiple networks, bridges, and DEXes. It utilizes local shell and Python scripts to process API responses from well-known cryptocurrency services like Etherscan and Blockscout. While the skill possesses an attack surface for indirect prompt injection via the processing of externally controlled blockchain data, it includes robust instructions and deterministic logic to mitigate these risks.

  • Socket1d

    No alerts

  • Snyk1d

    Risk: LOW · No issues

Signed by skilld at 592682c. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated 2 weeks ago
argument-hint
<chain-name-or-id|address|transaction-hash|order-id>
coordination
exempt
skill-dependencies
[
  "chromium-browser",
  "cli-cast"
]
Other metadata
compatibility
Requires the `routemesh` CLI initialized on macOS with `routemesh init` for RouteMesh requests.

README badge

README badge for paulrberg/agent-skills/evm-atlas