From 1eb6439fea13629571ca1b8f4f001b17a004caff Mon Sep 17 00:00:00 2001 From: d1onys1us <13951458+d1onys1us@users.noreply.github.com> Date: Thu, 6 Jun 2024 14:24:15 -0400 Subject: [PATCH] docs(docs-site): update taiko docs (#17510) --- .../content/docs/core-concepts/bridging.md | 2 +- .../docs/core-concepts/what-is-taiko.md | 44 ++++++++++--------- .../src/content/docs/resources/faqs.md | 4 +- 3 files changed, 26 insertions(+), 24 deletions(-) diff --git a/packages/docs-site/src/content/docs/core-concepts/bridging.md b/packages/docs-site/src/content/docs/core-concepts/bridging.md index 2a4c0c21afc..b6619138a2c 100644 --- a/packages/docs-site/src/content/docs/core-concepts/bridging.md +++ b/packages/docs-site/src/content/docs/core-concepts/bridging.md @@ -3,7 +3,7 @@ title: Bridging description: Core concept page for "Bridging". --- -Bridges are foundational for cross-chain users and applications. Users might come to another chain, such as Taiko (a ZK-rollup). To do this, they need to bridge over funds. Notoriously, bridging has been a dangerous operation. How do you make sure that this bridge is secure? +Bridges are foundational for cross-chain users and applications. Users might come to another chain, such as Taiko. To do this, they need to bridge over funds. Notoriously, bridging has been a dangerous operation. How do you make sure that this bridge is secure? Let's explain bridging on Taiko. We will answer the following questions: diff --git a/packages/docs-site/src/content/docs/core-concepts/what-is-taiko.md b/packages/docs-site/src/content/docs/core-concepts/what-is-taiko.md index a67868a7225..2380604a9c6 100644 --- a/packages/docs-site/src/content/docs/core-concepts/what-is-taiko.md +++ b/packages/docs-site/src/content/docs/core-concepts/what-is-taiko.md @@ -10,7 +10,9 @@ Taiko is a [based rollup](/core-concepts/based-sequencing) which makes Ethereum - [Based contestable rollup](/core-concepts/contestable-rollups): A configurable rollup to reduce transaction fees on Ethereum. - [Based booster rollup](/core-concepts/booster-rollups): An innovative approach to **native L1 scaling**. -Taiko is a **fully open source, permissionless, Ethereum-equivalent ZK-Rollup**. Using Taiko feels the same as using Ethereum. There are no centralized actors that operate the network; all operations are permissionlessly run by the community. +Taiko is a **highly configurable, fully open source, permissionless (based), Ethereum-equivalent rollup**. + +It can be easily configured as a fully ZK rollup, optimistic rollup, or anything in between. There are no centralized actors that operate the network; all operations are permissionlessly run by the community. ## The Taiko protocol @@ -18,23 +20,29 @@ Taiko is a **fully open source, permissionless, Ethereum-equivalent ZK-Rollup**. ## Organizations -- **Taiko Labs**: A research & development group that works on the Taiko protocol. -- **Taiko Treasury**: A treasury which is funded by the income generated by the Taiko protocol (L2 EIP-1559 congestion MEV). -- **Taiko DAO**: A group of Taiko Token (TAIKO) holders that have the voting rights to govern various parts of the Taiko Protocol including smart contract upgrades, TAIKO parameters, and more. The Taiko DAO effectively controls **everything**. -- **Taiko Foundation**: An entity that stewards the growth and development of the Taiko protocol and wider ecosystem. The foundation works solely for, and on behalf of, the Taiko DAO and token holders. Its responsibilities include but are not limited to, financing of technical developments, ecosystem growth and maintenance, partnerships with service providers, events management, and much more -- either through grants or other means. The foundation will do so with full transparency to the Taiko community and DAO. -- **Taiko Security Council**: An X-member council of individuals and entities elected by the Taiko DAO to undertake emergency actions on the Taiko protocol, as and when needed. The Security Council's core responsibility is to ensure the safety and soundness of the Taiko protocol, and as such it has the power to implement upgrades or changes in pursuit of that objective. The Security Council also controls the Guardian Provers within the Taiko protocol. -- **Taiko Community**: Various social groups/accounts run permissionlessly by anyone who desires it. Some examples include the Taiko Discord, Taiko Twitter, etc. +- **Taiko Community**: Social groups/accounts run by anyone interested, including Taiko Discord, Taiko Twitter, etc. +- **Taiko Labs**: Research & development group for the Taiko protocol. +- **Taiko Treasury**: Funded by income from the Taiko protocol (L2 EIP-1559 congestion MEV). +- **Taiko DAO (in progress)**: Governing body of Taiko Token (TAIKO) holders with voting rights over smart contract upgrades, network parameters, and more. Controls all aspects of the Taiko protocol smart contracts. +- **Taiko Foundation**: Stewards growth and development of the Taiko protocol and ecosystem. Works for the Taiko DAO and token holders, financing technical developments, ecosystem growth, partnerships, events, and more with full transparency. +- **Taiko Security Council**: Elected by the Taiko DAO to handle emergency actions. Ensures the safety of the Taiko protocol, implementing necessary upgrades or changes, and controls the Guardian Provers. + +## Services operated by Taiko Labs -## Products operated by Taiko Labs +### Non-critical infrastructure -### Frontends +:::note +Anyone can run these components, not just Taiko Labs. Yes you can sequence blocks on Taiko, host your own bridge using our [signal service](/core-concepts/bridging#the-signal-service), etc. +::: + +#### Frontends - [Bridge UI](https://bridge.taiko.xyz) - [Network status page](https://status.taiko.xyz) - [Main homepage](https://taiko.xyz) + [this documentation site](https://docs.taiko.xyz) - [Geth fork diff page](https://geth.taiko.xyz) -### Non-critical backend infrastructure +#### Backends - [Event indexer](/api-reference/event-indexer) - [Bridge relayer](/api-reference/bridge-relayer) @@ -43,15 +51,11 @@ Taiko is a **fully open source, permissionless, Ethereum-equivalent ZK-Rollup**. - [Testnet P2P bootstrapping nodes](/network-reference/testnet-addresses#taiko-labs-bootnode-addresses) - [Testnet Taiko Labs' proposer and provers](/network-reference/testnet-addresses) -### Critical backend infrastructure - -- [Mainnet Contract Owners](/network-reference/mainnet-addresses#contract-owners) -- [Testnet Contract Owners](/network-reference/testnet-addresses#contract-owners) +### Critical infrastructure -### Open-source software +:::caution +This is a vital concern for rollup users. The smart contracts are upgradeable via a multi-sig, which is a **trusted component** until handed over to the DAO. Please look at a third party source regarding any rollup's safety, such as [L2Beat](https://l2beat.com/scaling/projects/taiko). +::: -- [Taiko protocol smart contracts](https://github.com/taikoxyz/taiko-mono) -- [Taiko geth](https://github.com/taikoxyz/taiko-geth) -- [Taiko client](https://github.com/taikoxyz/taiko-client) -- [Raiko](https://github.com/taikoxyz/raiko) -- [Simple taiko node](https://github.com/taikoxyz/simple-taiko-node) +- [Mainnet contract owners (multi-sig)](/network-reference/mainnet-addresses#contract-owners) +- [Testnet contract owners](/network-reference/testnet-addresses#contract-owners) diff --git a/packages/docs-site/src/content/docs/resources/faqs.md b/packages/docs-site/src/content/docs/resources/faqs.md index cb09cb1209d..57d36f84151 100644 --- a/packages/docs-site/src/content/docs/resources/faqs.md +++ b/packages/docs-site/src/content/docs/resources/faqs.md @@ -11,9 +11,7 @@ This page is divided between [General FAQs](#general-faqs) and [Developer FAQs]( ### What is Taiko? -Taiko is a fully permissionless and decentralized Ethereum-equivalent ZK-Rollup. This means using Taiko is exactly the same as using Ethereum. Not only does Taiko support all EVM opcodes, but it supports the full JSON-RPC execution client API. - -Taiko is an L2 that derives it's security from Ethereum. There is no centralized sequencer or provers, all operations are permissionless and community driven. Learn more about Taiko under our core concepts in the sidebar. +See [What is Taiko?](/core-concepts/what-is-taiko). ### What is a Type 1 ZK-EVM?