Skip to content

Commit 2aae097

Browse files
los-xyzlos-xyz
authored
Add Flow EVM blockchain documentation (#801)
- Create complete Flow EVM blockchain documentation structure - Add overview with EVM equivalence and performance benchmarks - Include raw data tables (blocks, transactions, logs, traces, creation-traces) - Include decoded data tables (call-tables, event-logs, contracts, logs-decoded, traces-decoded) - Add Flow EVM to navigation in mint.json alphabetically between Flare and Gnosis - Based on official Flow EVM documentation at https://developers.flow.com/build/evm/about
1 parent 60d0486 commit 2aae097

File tree

13 files changed

+219
-0
lines changed

13 files changed

+219
-0
lines changed

‎data-catalog/evm/flow-evm/decoded/call-tables.mdx‎

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
---
2+
title: Flow EVM Call Tables
3+
description: On Dune, we parse all message calls and transactions made to smart contracts on the Flow EVM network in their own tables.
4+
---
5+
6+
import CallTables from '/snippets/evm/decoded/call-tables-snippet.mdx'
7+
import { DuneEmbed } from '/snippets/dune-embed.mdx'
8+
9+
<CallTables />
10+

‎data-catalog/evm/flow-evm/decoded/contracts.mdx‎

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
---
2+
title: flow.contracts
3+
sidebarTitle: "Contracts"
4+
description: Description of the flow.contracts table on Dune
5+
---
6+
7+
import { ContractsSnippet } from '/snippets/evm/decoded/contracts-snippet.mdx';
8+
import { ColumnDescriptions } from "/snippets/column-descriptions.mdx";
9+
import { TableSample } from "/snippets/table-sample.mdx";
10+
11+
12+
<ContractsSnippet blockchain="flow" />

‎data-catalog/evm/flow-evm/decoded/event-logs.mdx‎

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
---
2+
title: flow.event_logs
3+
sidebarTitle: "Event Logs"
4+
description: Description of the flow.event_logs table on Dune
5+
---
6+
7+
import EventLogs from '/snippets/evm/decoded/event-logs-snippet.mdx'
8+
import { DuneEmbed } from '/snippets/dune-embed.mdx'
9+
10+
<EventLogs />

‎data-catalog/evm/flow-evm/decoded/logs-decoded.mdx‎

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
---
2+
title: flow.logs_decoded
3+
sidebarTitle: "Logs Decoded"
4+
description: Description of the flow.logs_decoded table on Dune
5+
---
6+
7+
import { LogsDecodedSnippet } from '/snippets/evm/decoded/logs-decoded-snippet.mdx';
8+
import { ColumnDescriptions } from "/snippets/column-descriptions.mdx";
9+
import { TableSample } from "/snippets/table-sample.mdx";
10+
11+
12+
<LogsDecodedSnippet blockchain="flow" />

‎data-catalog/evm/flow-evm/decoded/overview.mdx‎

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
---
2+
title: Flow EVM Decoded Overview
3+
description: Simplifying Flow EVM smart contract analysis through human-readable tables.
4+
icon: "star"
5+
---
6+
7+
import { OverviewDecodedDataApproach } from "/snippets/evm/decoded/decoded-overview-snippet.mdx"
8+
import { DuneEmbed } from '/snippets/dune-embed.mdx'
9+
10+
<OverviewDecodedDataApproach blockchain="flow"/>

‎data-catalog/evm/flow-evm/decoded/traces-decoded.mdx‎

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
---
2+
title: flow.traces_decoded
3+
sidebarTitle: "Traces Decoded"
4+
description: Description of the flow.traces_decoded table on Dune
5+
---
6+
7+
import { TracesDecodedSnippet } from '/snippets/evm/decoded/traces-decoded-snippet.mdx';
8+
import { ColumnDescriptions } from "/snippets/column-descriptions.mdx";
9+
import { TableSample } from "/snippets/table-sample.mdx";
10+
11+
12+
<TracesDecodedSnippet blockchain="flow" />

‎data-catalog/evm/flow-evm/overview.mdx‎

Lines changed: 64 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,64 @@
1+
---
2+
title: Flow EVM Overview
3+
sidebarTitle: "Overview"
4+
icon: "star"
5+
description: Flow EVM data on Dune
6+
---
7+
8+
9+
10+
## What is Flow EVM?
11+
12+
Flow EVM is a fast EVM equivalent blockchain with low fees, making it an ideal **Ethereum alternative for apps** that need both performance and affordability. With EVM equivalency, Solidity developers can deploy existing contracts on Flow without rewriting code, instantly gaining access to Flow's ultra-fast transactions, low costs, and mainstream scalability. Builders can tap into Flow's unique IPs and large user base with no implementation risk.
13+
14+
## Key Features
15+
16+
- **EVM Equivalence**: Full compatibility with Ethereum smart contracts and tooling
17+
- **Ultra-Fast Performance**: Transaction throughput peaked to 2M daily transactions during 2023
18+
- **Low Gas Fees**: Ultra-low cost gas fees with support for gasless experiences through sponsored transactions
19+
- **MEV Resilience**: Robust design offering improved market efficiency, fairness, and trust for DeFi apps
20+
- **Cross-VM Integration**: Seamless token transfers between EVM and Cadence environments
21+
- **Account Linking**: Advanced account abstraction model enabling smooth user onboarding
22+
23+
## Performance & Scalability
24+
25+
- **Daily Transaction Volume**: Sustained similar average transaction volume as Ethereum
26+
- **Scalability**: Currently scalable to 5x more transactions with further performance optimizations
27+
- **State Space**: Extensible to petabyte scale for onchain application data storage
28+
- **Multi-Node Architecture**: Innovative distributed consensus with flexible transaction model
29+
- **Parallel Execution**: Further throughput optimization capabilities coming soon
30+
31+
## Technical Architecture
32+
33+
- **EVM Transactions**: Composed and executed within Cadence transactions
34+
- **Native VM Token Bridge**: Instant cross-VM token transfers in single atomic transactions
35+
- **Shared Gas Token**: Both EVM and Cadence environments use FLOW as gas
36+
- **Hybrid Capabilities**: Expand EVM limitations using Cadence's powerful account model
37+
- **Multi-Role Node Architecture**: Heterogeneous node roles ensuring MEV resilience
38+
39+
## Ecosystem Highlights
40+
41+
- Seamless integration for Ethereum developers with existing toolchain
42+
- Best-in-class UX through Account Linking and account abstraction
43+
- Support for both EVM and Cadence smart contract environments
44+
- Novel use-cases through VM integration patterns
45+
- Strong economic disincentives for collusion and frontrunning attacks
46+
47+
## Data on Dune
48+
49+
<CardGroup cols={2}>
50+
<Card title="Raw Data" icon="database" href="/data-catalog/evm/flow-evm/raw/blocks">
51+
Access to raw blockchain data including blocks, transactions, logs, and traces
52+
</Card>
53+
<Card title="Decoded Data" icon="code" href="/data-catalog/evm/flow-evm/decoded/overview">
54+
Human-readable contract interactions and events
55+
</Card>
56+
</CardGroup>
57+
58+
## Resources
59+
60+
<CardGroup cols={1}>
61+
<Card title="Flow EVM Documentation" icon="link" href="https://developers.flow.com/build/evm/about">
62+
Official documentation for developers building on Flow EVM
63+
</Card>
64+
</CardGroup>

‎data-catalog/evm/flow-evm/raw/blocks.mdx‎

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
---
2+
title: flow.blocks
3+
sidebarTitle: "Blocks"
4+
description: Description of the flow.blocks table on Dune
5+
---
6+
7+
import { BlockSnippet } from '/snippets/evm/raw/blocks-snippet.mdx';
8+
import { ColumnDescriptions } from "/snippets/column-descriptions.mdx";
9+
import { TableSample } from "/snippets/table-sample.mdx";
10+
11+
12+
<BlockSnippet blockchain="flow" />

‎data-catalog/evm/flow-evm/raw/creation-traces.mdx‎

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
---
2+
title: flow.creation_traces
3+
sidebarTitle: "Creation Traces"
4+
description: Description of the flow.creation_traces table on Dune
5+
---
6+
7+
import { CreationTracesSnippet } from '/snippets/evm/raw/creation-traces-snippet.mdx';
8+
import { ColumnDescriptions } from "/snippets/column-descriptions.mdx";
9+
import { TableSample } from "/snippets/table-sample.mdx";
10+
11+
12+
<CreationTracesSnippet blockchain="flow" />

‎data-catalog/evm/flow-evm/raw/logs.mdx‎

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
---
2+
title: flow.logs
3+
sidebarTitle: "Logs"
4+
description: Description of the flow.logs table on Dune
5+
---
6+
7+
import { LogsSnippet } from '/snippets/evm/raw/logs-snippet.mdx';
8+
import { ColumnDescriptions } from "/snippets/column-descriptions.mdx";
9+
import { TableSample } from "/snippets/table-sample.mdx";
10+
11+
12+
<LogsSnippet blockchain="flow" />

0 commit comments

Comments
 (0)