Skip to content

Commit c83d916

Browse files
isabelleweialinobrasilSahilAujlaemilyJLin95jlin27
authored
Merge to prod (#349)
* Darwinv2 changes (#332) * darwinv2 changes * oops * note on reorgs and finality * formatting * added guide for the graph (#334) * add alchemy to scroll tools * update text in alchemy.mdx * add 0x to dev tooling explorer * fix feedback --------- Co-authored-by: AK <alikim@gmail.com> Co-authored-by: Sahil Aujla <sahilaujla15@gmail.com> Co-authored-by: emilyJLin95 <17280653+emilyJLin95@users.noreply.github.com> Co-authored-by: Jessica Lin <jlin2700@gmail.com>
1 parent 8316232 commit c83d916

File tree

4 files changed

+59
-1
lines changed

4 files changed

+59
-1
lines changed

src/content/docs/en/developers/ethereum-and-scroll-differences.mdx

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -99,6 +99,10 @@ Similarly to Ethereum, the Scroll sequencer aims to prioritize executable transa
9999

100100
However, just like in Ethereum, this ordering is not guaranteed by the protocol, and some blocks might diverge from it. In particular, during periods of low mempool congestion, the sequencer will process transactions on a first-come-first-served basis, so some transactions might precede others with higher tip in the same block.
101101

102+
## Reorgs and Finality
103+
104+
Starting from our [DarwinV2 upgrade](/technology/overview/scroll-upgrades#darwinv2-upgrade), the maximum reorg depth has been set to 17 blocks. Transaction ordering should be unchanged after this threshold, however the only absolute guarantee is for transactions to be finalized (proof submitted to L1).
105+
102106
## Future EIPs
103107

104108
We keep a close eye on all emerging EIPs adopted by Ethereum and adopt them when suitable. If you’re interested in more specifics, reach out in [our community forum](https://community.scroll.io) or on the [Scroll Discord](https://discord.gg/scroll).

src/content/docs/en/developers/guides/running-a-scroll-node.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ For most developers, using [our official RPC endpoint](/en/developers/developer-
1818

1919
We recommend using the latest release at https://github.com/scroll-tech/go-ethereum/releases. The required version for Scroll Mainnet is `scroll-v5.5.0` or higher, and for Scroll Sepolia it is `scroll-v5.4.2` or higher. If you'd like to keep up with new node releases, go to https://github.com/scroll-tech/go-ethereum, click on **Watch**, **Custom**, and make sure that **Releases** is selected.
2020

21-
For the remainder of this guide, `VERSION` will denote the version tag. For example, `scroll-v5.6.0`.
21+
For the remainder of this guide, `VERSION` will denote the version tag. For example, `scroll-v5.7.0`.
2222

2323
### Hardware Requirements
2424

src/content/docs/en/technology/overview/scroll-upgrades.mdx

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -19,6 +19,35 @@ The following contracts are used to initiate upgrades and execute upgrades after
1919

2020
You can join our [Telegram channel for technical updates](https://t.me/scroll_tech_updates), which includes future upgrade announcements and on-chain operation events.
2121

22+
## DarwinV2 Upgrade
23+
24+
### Overview
25+
26+
During internal testing, we identified that blocks may not always be compressible under certain conditions, which leads to unprovable chunks and batches.
27+
To fix this issue, a minor upgrade has been conducted so that uncompressed blobs will be enabled when this special case is detected.
28+
29+
### Timeline
30+
31+
As this is a security related patch, we bypassed the 7-day timelock mechanism.
32+
33+
- **Scroll Sepolia**: August 28th, 2024
34+
- **Scroll Mainnet**: September 2nd, 2024
35+
36+
### Compatibility
37+
38+
#### Sequencer and Follower Nodes (l2geth)
39+
40+
The new node version is `v5.7.0`. See the [release notes](https://github.com/scroll-tech/go-ethereum/releases/tag/scroll-v5.7.0) for more information.
41+
42+
This upgrade does not change Scroll's state transition function, so it is backward compatible. However, the format of the batch data committed to Ethereum changes. As a result, nodes that enabled rollup verification (`--rollup.verify`) must upgrade to be able to follow the chain.
43+
44+
#### Dapps and Indexers
45+
46+
A change has been implemented to Scroll Mainnet to enhance sequencer throughput, which adjusted the maximum reorg depth to 17 blocks. Previously, the system performed thorough capacity checks within the signer thread to determine whether transactions exceed the circuit limit. While this ensures that all transactions within a block are compliant, it also requires additional CPU resources.
47+
We introduced a new circuit capacity checking scheme on Mainnet. The sequencer thread now will continue to perform capacity checks, but in a more approximate manner. In parallel, 16 worker threads will accurately verify the capacity of previous blocks. As a result, a reorg could occur with a maximum depth of 17 blocks, although the likelihood of this is low.
48+
49+
For indexers, the `BatchHeader` version has been upgraded to 4. This is backward compatible (the only exception is for developers decoding the blob payload, which has changed slightly).
50+
2251
## Darwin Upgrade
2352

2453
### Overview

src/content/tools/en/thegraph.mdx

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
---
2+
name: "The Graph"
3+
category: ["Debug", "Data"]
4+
excerpt: "Getting historical data on a smart contract can be frustrating when you’re building a dapp. The Graph provides an easy way to query smart contract data through APIs known as subgraphs."
5+
logo: { src: "https://pbs.twimg.com/profile_images/1735767195567730688/goqgFT93_400x400.jpg", alt: "The Graph Logo" }
6+
website: "https://thegraph.com"
7+
network: ["Mainnet", "Testnet"]
8+
---
9+
10+
Getting historical data on a smart contract can be frustrating when you’re building a dapp. [The Graph](https://thegraph.com/) provides an easy way to query smart contract data through APIs known as subgraphs. The Graph’s infrastructure relies on a decentralized network of indexers, enabling your dapp to become truly decentralized.
11+
12+
The Graph supports both Scroll mainnet & testnet.
13+
14+
#### Quick Start
15+
16+
These subgraphs only take a few minutes to set up. To get started, follow these three steps:
17+
18+
1. Initialize your subgraph project
19+
2. Deploy & Publish
20+
3. Query from your dapp
21+
22+
Pricing: **All developers receive 100K free queries per month on the decentralized network**. After these free queries, you only pay based on usage at $4 for every 100K queries.
23+
24+
Here’s a step by step walk through that includes screenshots:
25+
[The Graph Quick Start](https://edgeandnode.notion.site/The-Graph-Quick-Start-cd924d4d17674c5492216ef7c5e0503d?pvs=74)

0 commit comments

Comments
 (0)