diff --git a/docs/developers/communication.md b/docs/about/communication.md similarity index 91% rename from docs/developers/communication.md rename to docs/about/communication.md index 391795e5..077a8c37 100644 --- a/docs/developers/communication.md +++ b/docs/about/communication.md @@ -1,8 +1,7 @@ --- -sidebar_position: 8 +title: Gnosis Chain Communication description: A list of official communication channels for Gnosis keywords: [gnosis, gnosis twitter, gnosis telegram, gnosis discord, governance forum] -title: Communication --- ## News @@ -19,6 +18,8 @@ title: Communication - [Telegram - Unofficial](https://t.me/gnosischain) - [GitHub](https://github.com/gnosischain) - [Governance Forum](https://forum.gnosis.io/) +- [Governance Summary Docs](https://gnosisdao.ghost.io/) + ## Support diff --git a/docs/about/specs/hard-forks/dencun.md b/docs/about/specs/hard-forks/dencun.md index 443be3f6..2b621fc3 100644 --- a/docs/about/specs/hard-forks/dencun.md +++ b/docs/about/specs/hard-forks/dencun.md @@ -57,7 +57,7 @@ Gnosis chain has both a lower `CHURN_LIMIT_QUOTIENT` and faster epoch times. A ` | Network | Timestamp | Date & Time (UTC) | Fork Hash | Beacon Chain Epoch | | ------- | ---------- | --------------------------------- | --------- | ------------------ | | Chiado | 1706724940 | Wed Jan 31 2024 18:15:40 GMT+0000 | - | 516608 | -| Mainnet | TBD | TBD | - | TBD | +| Mainnet | 1710181820 | Monday March 11 202418:30:20 +UTC | - | 889856 | ## How to Prepare diff --git a/docs/faq/Node FAQs/depositWithdrawalReward.md b/docs/faq/Node FAQs/depositWithdrawalReward.md index c74182ef..6bc832d7 100644 --- a/docs/faq/Node FAQs/depositWithdrawalReward.md +++ b/docs/faq/Node FAQs/depositWithdrawalReward.md @@ -7,7 +7,7 @@ title: Deposit, Withdrawals, and Rewards ::: :::info -** :bulb: This document is continuously being improved.** +**:bulb: This document is continuously being improved.** ::: # Deposit, Withdrawals and Rewards diff --git a/docs/faq/Node FAQs/generalQuestions.md b/docs/faq/Node FAQs/generalQuestions.md index 5db82158..57033858 100644 --- a/docs/faq/Node FAQs/generalQuestions.md +++ b/docs/faq/Node FAQs/generalQuestions.md @@ -9,7 +9,7 @@ title: General Questions ::: :::info -** :bulb: This document is continuously being improved.** +**:bulb: This document is continuously being improved.** ::: # General Questions @@ -18,18 +18,15 @@ title: General Questions Validators propose and vote on blocks to include in the chain. The chain is secured by a staked amount of GNO. Validators stake GNO and receive additional GNO as rewards for correct behavior (proposing and attesting blocks) and a slashed balance as penalties for incorrect behavior (offline node, attesting invalid blocks). -2. **What is Shapella?** +2. **What is PoS (Proof-of-Stake)?** - Shapella refers to the combination of both Shanghai and Capella. Shanghai enables GNO staking withdrawals for Gnosis Chain, unlike the previous model that doesn’t allow for staked GNO to be withdrawn. Shanghai is the name given to the execution layer (EL) upgrade, while Capella is the name of the coinciding consensus layer (CL) upgrade. + Proof-of-Stake (PoS) is a consensus mechanism for processing transactions and creating new blocks in a blockchain. Staking is when you pledge your coins to be used for verifying transactions. The same PoS implementation underlies both Gnosis Chain and Ethereum's consensus mechanism, except for a few differences outlined [here](https://docs.gnosischain.com/about/). -3. **I have a problem with connect Safe to deposit.gnosischain.com since there is new walletconnect in UI. When will it be fixed?** +3. **What is Gnosis Chain?** - Devs are currently working on it, currently a workaround is to use the wallet extension Rabby and import your Safe in it then to connect it to the page like if it was a Metamask wallet. + Gnosis Chain is an EVM-compatible Layer-1 blockchain that aspires to be the most secure, resilient and credibly neutral blockchain, buttressed by a deeply decentralized network secured by over 200K validators. -4. **What tax software has integrated GC?** +5. **What tax software has integrated GC?** [Cryptio](https://cryptio.co/) is available for German users. -5. **When is this Gnosis Execution Layer to Gnosis Beacon Chain merge scheduled for?** - - The merge happened in December 2022. diff --git a/docs/node/Node Tools/_category_.json b/docs/node/Node Tools/_category_.json new file mode 100644 index 00000000..79d5dc20 --- /dev/null +++ b/docs/node/Node Tools/_category_.json @@ -0,0 +1,7 @@ +{ + "position": 2, + "collapsible": true, + "link": { + "type": "generated-index" + } + } \ No newline at end of file diff --git a/docs/node/README.md b/docs/node/README.md index 06597044..83eaf5b1 100644 --- a/docs/node/README.md +++ b/docs/node/README.md @@ -1,5 +1,6 @@ --- title: Run a Node +sidebar_position : 1 --- # Run a Node @@ -23,7 +24,7 @@ Gnosis is persistently committed to building the open infrastructure for a decen - Gnosis runs the same composite client software and tooling stack as Ethereum - In some cases, Gnosis clients are just Ethereum clients run with a `--network` flag! (e.g. [Nethermind](https://downloads.nethermind.io/), [Lighthouse](https://lighthouse.sigmaprime.io/), etc) -- Gnosis aims to be a learning ground for a new generation of node runners, requiring only 1 GNO (~400 at March 2024) instead of the 32 ETH (~$120.000 at Feb 2024) minimum required for Ethereum +- Gnosis aims to be a learning ground for a new generation of node runners, requiring only 1 GNO (around $350 at March 2024) instead of the 32 ETH (around $100.000 at March 2024) minimum required for Ethereum - Gnosis Chain runs the same client software as Ethereum, with minor parameter tweaks. As such, Gnosis is a Proof-of-Stake network that uses Ethereum's Beacon Chain consensus. ## Choosing an Approach @@ -56,6 +57,7 @@ Gnosis clients are able to run on consumer grade computers and don't require any - Because of the required storage size for full node, the price of a rented server might get high - Own hardware + - More trustless and sovereign approach - One time investment - An option to buy preconfigured machines @@ -94,6 +96,7 @@ The size of the database and speed of the initial synchronization depends on the Also make sure your internet connection is not limited by a bandwidth cap. It's recommended to use an unmetered connection since initial sync and data broadcasted to the network could exceed your limit. **Operating System** + All clients support major operating systems - Linux, MacOS, Windows. This means you can run nodes on regular desktop or server machines with the operating system (OS) that suits you the best. Make sure your OS is up to date to avoid potential issues and security vulnerabilities. **Requirements** @@ -111,7 +114,7 @@ Requirements vary client to client, for more detail see the associated system re | Erigon | [Erigon: System Requirements](https://github.com/ledgerwatch/erigon#system-requirements) | | Geth | [Geth: Hardware](https://geth.ethereum.org/docs/interface/hardware) | -\*\* Gnosis chain only supports Nethermind and Erigon at the moment. +**Gnosis Chain only supports Nethermind and Erigon at the moment.** | Consensus Layer | | | --------------- | ------------------------------------------------------------------------------------------------------------------------------------- | @@ -121,11 +124,11 @@ Requirements vary client to client, for more detail see the associated system re | Teku | TBD | | Prysm | [Prysm: Prerequisites](https://docs.prylabs.network/docs/install/install-with-script/#step-1-review-prerequisites-and-best-practices) | -\*\* Gnosis chain doesn't support Prysm at the moment. +**Gnosis Chain doesn't support Prysm at the moment.** Check out [Rocketpool's excellent guide](https://docs.rocketpool.net/guides/node/local/hardware.html) that explains hardware requirements for running a node. -**Gnosis in Ethereumverse** +### **Gnosis in Ethereumverse** Running a Gnosis node requires no different hardware configuration from other nodes in Ethereum universe. @@ -158,7 +161,7 @@ Validators are advised to consider those numbers when planning their infrastruct | 128 | 4.6 MB/s | 3.8 MB/s | 21.5 TB | | >256 | 4.6 MB/s | 3.9 MB/s | 21.7 TB | -#### **Plug-and-play solutions** +### **Plug-and-play solutions** The easiest option for running a node with your own hardware is using plug-and-play boxes. Preconfigured machines from vendors offer the most straightforward experience: order, connect, run. Everything is preconfigured and runs automatically with an intuitive guide and dashboard for monitoring and controlling the software. @@ -227,7 +230,7 @@ sha256sum teku-22.6.1.tar.gz 9b2f8c1f8d4dab0404ce70ea314ff4b3c77e9d27aff9d1e4c1933a5439767dde ``` -#### Client setup +### **Client setup** After installing, downloading, or compiling the client software, you are ready to run it. This only means it has to be executed with the proper configuration. Clients offer rich configuration options, which can enable various features. @@ -237,7 +240,7 @@ Other basic configuration options are, e.g. choosing a network - Mainnet or test For testing purposes, you might prefer to run a client on Chiado testnet. -##### Starting the execution client +#### **Starting the execution client** Before starting the Gnosis client software, perform a last check that your environment is ready. For example, make sure: @@ -290,7 +293,7 @@ Nethermind docs offer a [complete guide](https://docs.nethermind.io/nethermind/f An execution client will initiate its core functions, chosen endpoints, and start looking for peers. After successfully discovering peers, the client starts synchronization. The execution client will await a connection from consensus client. Current blockchain data will be available once the client is successfully synced to the current state. -##### **Starting the consensus client** +#### **Starting the consensus client** The consensus client must be started with the right port configuration to establish a local RPC connection to the execution client. The consensus clients have to be run with the exposed execution client port as configuration argument. @@ -340,7 +343,7 @@ teku \ --ee-jwt-secret-file "/path/to/jwtsecret" \ ``` -### Adding Validators +### **Adding Validators** A consensus client serves as a Beacon Node for validators to connect. Each consensus client has its own validator software described in detail in its respective documentation. diff --git a/docs/node/management/_category_.json b/docs/node/management/_category_.json new file mode 100644 index 00000000..af7e7d39 --- /dev/null +++ b/docs/node/management/_category_.json @@ -0,0 +1,9 @@ +{ + "position": 4, + "label": "Management", + "collapsible": true, + "collapsed":true, + "link": { + "type": "generated-index" + } + } \ No newline at end of file diff --git a/docs/node/manual/README.md b/docs/node/manual/README.md index 5ac8637b..c58b02ce 100644 --- a/docs/node/manual/README.md +++ b/docs/node/manual/README.md @@ -1,5 +1,6 @@ --- title: "Interactive Guide" +sidebar_position : 3 --- :::tip Before you start @@ -20,7 +21,7 @@ import InstallIntroPartial from '@site/docs/node/manual/\_partials/\_install-int
-## Step 0: Review prerequisites and best practices +## Review prerequisites and best practices import InstallPrereqsPartial from '@site/docs/node/manual/server/\_partials/\_install-prereqs.md'; diff --git a/docs/node/manual/beacon/_category_.json b/docs/node/manual/beacon/_category_.json new file mode 100644 index 00000000..8616b863 --- /dev/null +++ b/docs/node/manual/beacon/_category_.json @@ -0,0 +1,9 @@ +{ + "position": 3, + "label": "Step : 3 - Run Consensus Client", + "collapsible": true, + "collapsed": true, + "link": { + "type": "generated-index" + } + } \ No newline at end of file diff --git a/docs/node/manual/beacon/lighthouse.md b/docs/node/manual/beacon/lighthouse.md index 5cf18b68..15dfc41c 100644 --- a/docs/node/manual/beacon/lighthouse.md +++ b/docs/node/manual/beacon/lighthouse.md @@ -1,7 +1,6 @@ --- title: Lighthouse --- - import BeaconFolderStructurePartial from '@site/docs/node/manual/beacon/\_partials/\_beacon_folder_structure.md'; # Run Beacon Node: Lighthouse diff --git a/docs/node/manual/beacon/lodestar.md b/docs/node/manual/beacon/lodestar.md index 4b226d14..d4fe2018 100644 --- a/docs/node/manual/beacon/lodestar.md +++ b/docs/node/manual/beacon/lodestar.md @@ -1,8 +1,7 @@ --- title: Lodestar --- - -import BeaconFolderStructurePartial from '@site/docs/node/manual/beacon/_partials/_beacon_folder_structure.md'; +import BeaconFolderStructurePartial from '@site/docs/node/manual/beacon/\_partials/\_beacon_folder_structure.md'; # Run Beacon Node: Lodestar diff --git a/docs/node/manual/beacon/nimbus.md b/docs/node/manual/beacon/nimbus.md index 62256b47..ec8aa1a1 100644 --- a/docs/node/manual/beacon/nimbus.md +++ b/docs/node/manual/beacon/nimbus.md @@ -1,7 +1,6 @@ --- title: Nimbus --- - import BeaconFolderStructurePartial from '@site/docs/node/manual/beacon/\_partials/\_beacon_folder_structure.md'; # Run Beacon Node + Validator: Nimbus diff --git a/docs/node/manual/beacon/teku.md b/docs/node/manual/beacon/teku.md index 287872fa..66f02bc8 100644 --- a/docs/node/manual/beacon/teku.md +++ b/docs/node/manual/beacon/teku.md @@ -1,8 +1,7 @@ --- title: Teku --- - -import BeaconFolderStructurePartial from '@site/docs/node/manual/beacon/_partials/_beacon_folder_structure.md'; +import BeaconFolderStructurePartial from '@site/docs/node/manual/beacon/\_partials/\_beacon_folder_structure.md'; # Run Beacon Node: Teku diff --git a/docs/node/manual/configure-server.md b/docs/node/manual/configure-server.md index 7c8a4bce..a5134591 100644 --- a/docs/node/manual/configure-server.md +++ b/docs/node/manual/configure-server.md @@ -1,5 +1,6 @@ --- -title: "Step 1: Configure Server" +sidebar_position: 1 +title: "Step : 1 - Configure Server" --- # Configure Server diff --git a/docs/node/manual/execution/_category_.json b/docs/node/manual/execution/_category_.json new file mode 100644 index 00000000..7721d71a --- /dev/null +++ b/docs/node/manual/execution/_category_.json @@ -0,0 +1,9 @@ +{ + "position": 2, + "label": "Step : 2 - Run Execution Client", + "collapsible": true, + "collapsed": true, + "link": { + "type": "generated-index" + } + } \ No newline at end of file diff --git a/docs/node/manual/validator/_category_.json b/docs/node/manual/validator/_category_.json new file mode 100644 index 00000000..696c6f20 --- /dev/null +++ b/docs/node/manual/validator/_category_.json @@ -0,0 +1,9 @@ +{ + "position": 4, + "label": "Step : 4 - Run Validator", + "collapsible": true, + "collapsed": true, + "link": { + "type": "generated-index" + } + } diff --git a/docs/node/manual/validator/run/lighthouse.md b/docs/node/manual/validator/run/lighthouse.md index c9316cb3..203a878b 100644 --- a/docs/node/manual/validator/run/lighthouse.md +++ b/docs/node/manual/validator/run/lighthouse.md @@ -60,7 +60,7 @@ services: lighthouse validator_client --network=gnosis - --datadir=/data/validators + --validators-dir=/data/validators --beacon-nodes=http://consensus:4000 --graffiti=$GRAFFITI --debug-level=info diff --git a/docusaurus.config.js b/docusaurus.config.js index 5086638e..04b3a777 100644 --- a/docusaurus.config.js +++ b/docusaurus.config.js @@ -265,8 +265,8 @@ const config = { from: "/about/networks/mainnet", }, { - to: "/developers/communication", - from: "/about/overview/media-kit" + to: "/about/communication", + from: "/developers/communication" } ], diff --git a/updates/2024/03-20-core-devs-call.md b/updates/2024/03-20-core-devs-call.md new file mode 100644 index 00000000..5b3f0746 --- /dev/null +++ b/updates/2024/03-20-core-devs-call.md @@ -0,0 +1,107 @@ +--- +title: Core Devs Call - 2024/03/20 +authors: [dapplion, armaganercan, filoozom] +tags: [CoreDevsCall, gnosis] +--- + +# Gnosis Core Devs Call Notes + +Welcome to the Gnosis Core Devs weekly gathering. Every Wednesday, key members from the Gnosis team, contributors, and various team representatives convene to discuss, collaborate, and update one another on the Gnosis ecosystem's progression. + +Participants represent teams: + +Erigon, Gateway, Nethermind, Geth, Gnosis DevOps, Gnosis Core Devs, Gnosis Comms team. + +With a diverse set of voices present, our discussions are rich, multifaceted, and aim to foster innovation within the community. + +Missed the meeting? Catch the [full recording on Gnosis Chain YouTube channel.](https://www.youtube.com/watch?v=rLSc62dy92A) + +March 20, 2024 + +# Client Team Updates +## EL + +* **Nethermind**: + * Nothing in particular + * Starting to think about the next release + * Might potentially include half-path and a snap sync server + * Expected in a few weeks + * Progressive on paprika as well, which can’t fast sync and would thus require snap sync servers + +* **Erigon**: + * Going to make a new release with post-dencun fixes today + * Includes a feature for more aggressive pruning of logs and receipts + * Will only be enabled for new nodes (i.e. synced from scratch) + * Existing nodes will have to resync + * Transaction logs are filling the network quite a lot, at least in the last 1-2m blocks + * This behavior doesn’t happen in Chiado / Sepolia + * This causes the bloating issue + * With the default pruning flags, full nodes should be around ~500 GB and archive nodes should be ~1.3 TB + * One can also use a more aggressive pruning strategy (i.e. last 1k - 5k blocks), which of course would also result in a smaller node. Default is 90k blocks. + + + +* **Geth**: + * Not present + +# Chain Infra + +* **Gateway** + * Deployed Erigon + Lighthouse on mainnet before Dencun and went fine + +# Hive Tests + +* No updates + +# Innovation + +* Shutter + * Managed to register the validators + * Looking into a couple of issues + * Race condition + * Libp2p library on MacOS specifically + * 2 week ETA should still be realistic + +# Mainnet + +* 95% attestations immediately after the hard fork + * Some issues with the Gateway RPC + * Might be fixed, Alex will double check + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +