diff --git a/docs/tutorials/join-dal-baker.md b/docs/tutorials/join-dal-baker.mdx similarity index 82% rename from docs/tutorials/join-dal-baker.md rename to docs/tutorials/join-dal-baker.mdx index 820832e14..57e6918fd 100644 --- a/docs/tutorials/join-dal-baker.md +++ b/docs/tutorials/join-dal-baker.mdx @@ -2,9 +2,11 @@ title: Join the DAL as a baker, in 5 steps authors: Tezos core developers last_update: - date: 23 January 2024 + date: 24 January 2024 --- +import LucidDiagram from '@site/src/components/LucidDiagram'; + The Tezos data availability layer (DAL) is a key component for the scalability of Tezos. In a nutshell, the DAL increases the data bandwidth available for Tezos Smart Rollups by providing a peer-to-peer network that they can use to fetch data without compromising security. @@ -24,6 +26,13 @@ In this tutorial you learn how to join Weeklynet as a baker and attest the publi For an introduction to how the DAL works, see the tutorial [Implement a file archive with the DAL and a Smart Rollup](./build-files-archive-with-dal). +## Tutorial diagram + +In this tutorial, you set up the Octez client and several Octez daemons, including a layer 1 node, a baker, and a DAL baking node. +The following diagram shows these daemons with a blue background: + + + :::warning This tutorial uses a very simple setup running all required daemons on the same machine. In a production environment, we advise against running a DAL attester node under the same IP address than a baker's node because the DAL node may leak the IP address and ease DOS attacks on the baker. See also [the DAL documentation page on baking](https://tezos.gitlab.io/shell/dal_bakers.html). ::: @@ -33,7 +42,7 @@ The UX of the DAL components will be subject to changes with the feedback from t ::: For more information about the DAL, see [Data-Availability Layer](https://tezos.gitlab.io/shell/dal.html) in the Octez documentation. - +{/* TODO link to page on DAL when it's available: https://github.com/trilitech/tezos-developer-docs/pull/270 */} - [Step 1: Get a Weeklynet-compatible Octez version](./join-dal-baker/get-octez) - [Step 2: Run an Octez node on Weeklynet](./join-dal-baker/run-node)