From 370df3d1730b4e4e685f64aa410150f7f426e6b5 Mon Sep 17 00:00:00 2001 From: Ilaria <43253244+ilariae@users.noreply.github.com> Date: Mon, 29 Jul 2024 10:49:46 +0200 Subject: [PATCH 01/36] Update learn/introduction.md Co-authored-by: Erin Shaben --- learn/introduction.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/learn/introduction.md b/learn/introduction.md index 29a68cf6..ec631dae 100644 --- a/learn/introduction.md +++ b/learn/introduction.md @@ -10,7 +10,7 @@ Wormhole is a generic **message-passing protocol** that enables communication be ![Overview](/wormhole-mkdocs/images/learn/introduction/simple-overview.webp) !!! note - The above is an oversimplified illustration of the protocol; details about the architecture and components are available in the **[architecture page](#){target=\_blank}**. + The above is an oversimplified illustration of the protocol; details about the architecture and components are available on the [architecture page](#){target=\_blank}. This simple message-passing protocol allows developers and users of cross-chain applications to leverage the advantages of multiple ecosystems. From e5b0d1fdb7b68d2aa7e17c505392c95ea9f4e3d3 Mon Sep 17 00:00:00 2001 From: Ilaria <43253244+ilariae@users.noreply.github.com> Date: Mon, 29 Jul 2024 10:51:40 +0200 Subject: [PATCH 02/36] Update learn/introduction.md Co-authored-by: Erin Shaben --- learn/introduction.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/learn/introduction.md b/learn/introduction.md index ec631dae..97e4b1e2 100644 --- a/learn/introduction.md +++ b/learn/introduction.md @@ -5,7 +5,7 @@ the rest should be fine for now --> # Introduction to Wormhole -Wormhole is a generic **message-passing protocol** that enables communication between blockchains. +Wormhole is a generic _message-passing protocol_ that enables communication between blockchains. ![Overview](/wormhole-mkdocs/images/learn/introduction/simple-overview.webp) From 104f8db949f3c292b3c01af0127d2d29cd96e88b Mon Sep 17 00:00:00 2001 From: Ilaria <43253244+ilariae@users.noreply.github.com> Date: Mon, 29 Jul 2024 10:51:53 +0200 Subject: [PATCH 03/36] Update learn/introduction.md Co-authored-by: Erin Shaben --- learn/introduction.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/learn/introduction.md b/learn/introduction.md index 97e4b1e2..e805c69a 100644 --- a/learn/introduction.md +++ b/learn/introduction.md @@ -11,8 +11,6 @@ Wormhole is a generic _message-passing protocol_ that enables communication betw !!! note The above is an oversimplified illustration of the protocol; details about the architecture and components are available on the [architecture page](#){target=\_blank}. - - This simple message-passing protocol allows developers and users of cross-chain applications to leverage the advantages of multiple ecosystems. ## What Isn't Wormhole? From d6558c3fb7b0416cb0afef4c0923748729647ca8 Mon Sep 17 00:00:00 2001 From: Ilaria <43253244+ilariae@users.noreply.github.com> Date: Mon, 29 Jul 2024 10:52:23 +0200 Subject: [PATCH 04/36] Update learn/introduction.md Co-authored-by: Erin Shaben --- learn/introduction.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/learn/introduction.md b/learn/introduction.md index e805c69a..17fa34c6 100644 --- a/learn/introduction.md +++ b/learn/introduction.md @@ -36,7 +36,7 @@ Tutorials are available to get started quickly and explain the concepts involved - **[Quick Start - Off Chain](#){target=\_blank}** - integrate Wormhole Connect into a new or existing web UI - **[Quick Start - On Chain](#){target=\_blank}** - send your first cross-chain message -More tutorials are available **[on github](https://github.com/wormhole-foundation/docs.wormhole.com/blob/main/docs/tutorials/quick-start/README.md){target=\_blank}**. +More tutorials are available **[on github](#){target=\_blank}**. ## Explore From c5d354e4567148a9f5e5be09b6bb75f0188cbb8c Mon Sep 17 00:00:00 2001 From: Ilaria <43253244+ilariae@users.noreply.github.com> Date: Mon, 29 Jul 2024 10:52:29 +0200 Subject: [PATCH 05/36] Update learn/introduction.md Co-authored-by: Erin Shaben --- learn/introduction.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/learn/introduction.md b/learn/introduction.md index 17fa34c6..e083efc5 100644 --- a/learn/introduction.md +++ b/learn/introduction.md @@ -55,7 +55,7 @@ Demos offer more realistic implementations than tutorials: More demos are available in the **[demos page](#){target=\_blank}**. !!! note - ## Wormhole Integration Complete? + Wormhole Integration Complete? Let us know so we can list your project in our ecosystem directory and introduce you to our global, multichain community! From 874bb8f858698e4556f4da742513b07dbfc63909 Mon Sep 17 00:00:00 2001 From: Ilaria <43253244+ilariae@users.noreply.github.com> Date: Mon, 29 Jul 2024 10:53:49 +0200 Subject: [PATCH 06/36] Update learn/introduction.md Co-authored-by: Erin Shaben --- learn/introduction.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/learn/introduction.md b/learn/introduction.md index e083efc5..0a1441ba 100644 --- a/learn/introduction.md +++ b/learn/introduction.md @@ -7,7 +7,7 @@ the rest should be fine for now Wormhole is a generic _message-passing protocol_ that enables communication between blockchains. -![Overview](/wormhole-mkdocs/images/learn/introduction/simple-overview.webp) +![Overview](/images/learn/introduction/simple-overview.webp) !!! note The above is an oversimplified illustration of the protocol; details about the architecture and components are available on the [architecture page](#){target=\_blank}. From 030636f2ebe0033fc53502bb40637717c1a5e5ee Mon Sep 17 00:00:00 2001 From: Ilaria Enache Date: Mon, 29 Jul 2024 11:32:11 +0200 Subject: [PATCH 07/36] update introduction page --- learn/introduction.md | 18 ++++++++++++------ 1 file changed, 12 insertions(+), 6 deletions(-) diff --git a/learn/introduction.md b/learn/introduction.md index 0a1441ba..6829526c 100644 --- a/learn/introduction.md +++ b/learn/introduction.md @@ -1,13 +1,19 @@ +--- +title: Introduction to Wormhole +description: Wormhole is a versatile message-passing protocol facilitating seamless communication between various blockchains, enabling cross-chain applications and integrations. +--- # Introduction to Wormhole Wormhole is a generic _message-passing protocol_ that enables communication between blockchains. -![Overview](/images/learn/introduction/simple-overview.webp) +![Message-passing process in the Wormhole protocol](/images/learn/introduction/simple-overview.webp) + !!! note The above is an oversimplified illustration of the protocol; details about the architecture and components are available on the [architecture page](#){target=\_blank}. @@ -17,13 +23,13 @@ This simple message-passing protocol allows developers and users of cross-chain - **Wormhole is _not_ a blockchain** - it provides a means of communication between blockchains or rollups -- **Wormhole is _not_ a token bridge** - however, there are **[protocols built on Wormhole](https://portalbridge.com/#/transfer){target=\_blank}** that serve this purpose +- **Wormhole is _not_ a token bridge** - however, there are [protocols built on Wormhole](https://portalbridge.com/#/transfer){target=\_blank} that serve this purpose ## What Can Wormhole Be Used For? Consider the following examples of potential applications enabled by Wormhole: -- **Cross-Chain Exchange** - using **[Wormhole Connect](#){target=\_blank}**, developers can build exchanges that allow deposits from any Wormhole-connected chain, significantly increasing liquidity access +- **Cross-Chain Exchange** - using [Wormhole Connect](#){target=\_blank}, developers can build exchanges that allow deposits from any Wormhole-connected chain, significantly increasing liquidity access - **Cross-Chain Governance** - NFT collections on different networks can use Wormhole to communicate votes cast on their respective chains to a designated "voting" chain for combined proposals - **Cross-Chain Game** - games can be developed on a performant network like Solana, with rewards issued as NFTs on another network, such as Ethereum @@ -36,7 +42,7 @@ Tutorials are available to get started quickly and explain the concepts involved - **[Quick Start - Off Chain](#){target=\_blank}** - integrate Wormhole Connect into a new or existing web UI - **[Quick Start - On Chain](#){target=\_blank}** - send your first cross-chain message -More tutorials are available **[on github](#){target=\_blank}**. +More tutorials are available [on github](#){target=\_blank}. ## Explore @@ -52,7 +58,7 @@ Demos offer more realistic implementations than tutorials: - **[Wormhole Scaffolding](https://github.com/wormhole-foundation/wormhole-scaffolding){target=\_blank}** - quickly set up a project with the Scaffolding repo - **[xDapp Book Projects](https://github.com/wormhole-foundation/xdapp-book/tree/main/projects){target=\_blank}** - run and learn from example programs -More demos are available in the **[demos page](#){target=\_blank}**. +More demos are available in the [demos page](#){target=\_blank}. !!! note Wormhole Integration Complete? From 9ced52fdcbfbbb0d709f67b6add776a7dd868a96 Mon Sep 17 00:00:00 2001 From: Ilaria Enache Date: Mon, 29 Jul 2024 11:32:32 +0200 Subject: [PATCH 08/36] update introduction page --- learn/introduction.md | 1 - 1 file changed, 1 deletion(-) diff --git a/learn/introduction.md b/learn/introduction.md index 6829526c..fac10ab0 100644 --- a/learn/introduction.md +++ b/learn/introduction.md @@ -13,7 +13,6 @@ also missing the list of blockchains Wormhole is a generic _message-passing protocol_ that enables communication between blockchains. ![Message-passing process in the Wormhole protocol](/images/learn/introduction/simple-overview.webp) - !!! note The above is an oversimplified illustration of the protocol; details about the architecture and components are available on the [architecture page](#){target=\_blank}. From 67738da971fbbcbb464706c4b26941fce2f536d3 Mon Sep 17 00:00:00 2001 From: Ilaria Enache Date: Mon, 29 Jul 2024 11:37:14 +0200 Subject: [PATCH 09/36] deleted intro to avoid conflict --- learn/introduction.md | 70 ------------------------------------------- 1 file changed, 70 deletions(-) delete mode 100644 learn/introduction.md diff --git a/learn/introduction.md b/learn/introduction.md deleted file mode 100644 index 87783f9c..00000000 --- a/learn/introduction.md +++ /dev/null @@ -1,70 +0,0 @@ - -# Introduction to Wormhole - -Wormhole is a generic **message-passing protocol** that enables communication between blockchains. - -![Overview](/wormhole-mkdocs/images/learn/introduction/overview.webp) - -!!! note - The above is an oversimplified illustration of the protocol; details about the architecture and components are available in the **[architecture page](#){target=\_blank}**. - - -This simple message-passing protocol allows developers and users of cross-chain applications to leverage the advantages of multiple ecosystems. - -## What Isn't Wormhole? - -- **Wormhole is _not_ a blockchain** - it provides a means of communication between blockchains or rollups - -- **Wormhole is _not_ a token bridge** - however, there are **[protocols built on Wormhole](https://portalbridge.com/#/transfer){target=\_blank}** that serve this purpose - -## What Can Wormhole Be Used For? - -Consider the following examples of potential applications enabled by Wormhole: - -- **Cross-Chain Exchange** - using **[Wormhole Connect](#){target=\_blank}**, developers can build exchanges that allow deposits from any Wormhole-connected chain, significantly increasing liquidity access -- **Cross-Chain Governance** - NFT collections on different networks can use Wormhole to communicate votes cast on their respective chains to a designated "voting" chain for combined proposals -- **Cross-Chain Game** - games can be developed on a performant network like Solana, with rewards issued as NFTs on another network, such as Ethereum - -## Get Started - -### Quick Start Tutorials - -Tutorials are available to get started quickly and explain the concepts involved. - -- **[Quick Start - Off Chain](#){target=\_blank}** - integrate Wormhole Connect into a new or existing web UI -- **[Quick Start - On Chain](#){target=\_blank}** - send your first cross-chain message - -More tutorials are available **[on github](https://github.com/wormhole-foundation/docs.wormhole.com/blob/main/docs/tutorials/quick-start/README.md){target=\_blank}**. - -## Explore - -Discover more about the Wormhole ecosystem, components, and protocols: - -- **[Architecture](#){target=\_blank}** - explore the components of the protocol -- **[Protocol Specifications](https://github.com/wormhole-foundation/wormhole/tree/main/whitepapers){target=\_blank}** - learn about the protocols built on top of Wormhole - -## Demos - -Demos offer more realistic implementations than tutorials: - -- **[Wormhole Scaffolding](https://github.com/wormhole-foundation/wormhole-scaffolding){target=\_blank}** - quickly set up a project with the Scaffolding repo -- **[xDapp Book Projects](https://github.com/wormhole-foundation/xdapp-book/tree/main/projects){target=\_blank}** - run and learn from example programs - -More demos are available in the **[demos page](#){target=\_blank}**. - -!!! note - ## Wormhole Integration Complete? - - Let us know so we can list your project in our ecosystem directory and introduce you to our global, multichain community! - - **[Reach out now!](https://forms.clickup.com/45049775/f/1aytxf-10244/JKYWRUQ70AUI99F32Q){target=\_blank}** - -## Supported Blockchains - -Wormhole supports a growing number of blockchains. - - \ No newline at end of file From 4316d7e021baab9f134c0fbe1cdeeba83fdeb670 Mon Sep 17 00:00:00 2001 From: Ilaria Enache Date: Mon, 29 Jul 2024 11:44:01 +0200 Subject: [PATCH 10/36] added meta title and description --- learn/security.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/learn/security.md b/learn/security.md index 0c69abc8..fbdcc686 100644 --- a/learn/security.md +++ b/learn/security.md @@ -1,3 +1,7 @@ +--- +title: Security +description: Explore Wormhole's security features, including the Guardian network, governance, monitoring, open-source development, and bug bounty programs. +--- From 7ae17319424a04a909522cf93cb126b7fbf2c1cb Mon Sep 17 00:00:00 2001 From: Ilaria Enache Date: Mon, 29 Jul 2024 11:46:03 +0200 Subject: [PATCH 11/36] meta description shorter --- learn/introduction.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/learn/introduction.md b/learn/introduction.md index fac10ab0..a2578f92 100644 --- a/learn/introduction.md +++ b/learn/introduction.md @@ -1,6 +1,6 @@ --- title: Introduction to Wormhole -description: Wormhole is a versatile message-passing protocol facilitating seamless communication between various blockchains, enabling cross-chain applications and integrations. +description: Wormhole is a protocol for seamless communication between blockchains, enabling cross-chain applications and integrations. --- +- **[Wormhole contract deployments](#){target=\_blank}** ## Audits From 42ac9ea7cb7e5be02fabbc9e3be51713d29a4d13 Mon Sep 17 00:00:00 2001 From: Ilaria <43253244+ilariae@users.noreply.github.com> Date: Mon, 29 Jul 2024 11:48:16 +0200 Subject: [PATCH 16/36] Update learn/security.md Co-authored-by: Erin Shaben --- learn/security.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/learn/security.md b/learn/security.md index c3589b55..9076661f 100644 --- a/learn/security.md +++ b/learn/security.md @@ -36,7 +36,7 @@ Governance is the process through which contract upgrades happen. Guardians manu This means that governance actions are held to the same security standard as the rest of the system. A two-thirds supermajority of the Guardians is required to pass any governance action. -Governance messages can target any of the various wormhole modules, including the core contracts and all currently deployed token bridge contracts. When a guardian signs such a message, its signature implies a vote on the action in question. Once more than 2/3 of the guardians have signed, the message and governance action are considered valid. +Governance messages can target any of the various wormhole modules, including the core contracts and all currently deployed token bridge contracts. When a Guardian signs such a message, its signature implies a vote on the action in question. Once more than two-thirds of the Guardians have signed, the message and governance action are considered valid. All governance actions and contract upgrades have been managed via Wormhole's on-chain governance system. From 1efa3b7091a26e79a0b67bfd53ac63e20a05bd95 Mon Sep 17 00:00:00 2001 From: Ilaria <43253244+ilariae@users.noreply.github.com> Date: Mon, 29 Jul 2024 11:48:23 +0200 Subject: [PATCH 17/36] Update learn/security.md Co-authored-by: Erin Shaben --- learn/security.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/learn/security.md b/learn/security.md index 9076661f..df96b613 100644 --- a/learn/security.md +++ b/learn/security.md @@ -99,7 +99,7 @@ Wormhole has had audits performed by the following firms, and continues to seek ## Bug Bounties -Wormhole has one of the largest bug bounty programs in software development, and has repeatedly shown commitment to engaging with the white hat community. +Wormhole has one of the largest bug bounty programs in software development and has repeatedly shown commitment to engaging with the white hat community. Wormhole hosts two bug bounty programs: From 383b6466a3ba10a935aaaf622f229ce159972ef2 Mon Sep 17 00:00:00 2001 From: Ilaria <43253244+ilariae@users.noreply.github.com> Date: Mon, 29 Jul 2024 11:48:35 +0200 Subject: [PATCH 18/36] Update learn/security.md Co-authored-by: Erin Shaben --- learn/security.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/learn/security.md b/learn/security.md index df96b613..e3eaeac6 100644 --- a/learn/security.md +++ b/learn/security.md @@ -108,7 +108,7 @@ Wormhole hosts two bug bounty programs: Both platforms have a top payout of **2.5 million dollars**. -If you are interested in helping contribute to Wormhole security, please look at this section for **[Getting started as a White Hat](https://github.com/wormhole-foundation/wormhole/blob/main/SECURITY.md#white-hat-hacking){target=\blank}**, and be sure to follow the **[Wormhole Contributor Guidelines](https://github.com/wormhole-foundation/wormhole/blob/main/CONTRIBUTING.md){target=\blank}**. +If you are interested in contributing to Wormhole security, please look at this section for **[Getting Started as a White Hat](https://github.com/wormhole-foundation/wormhole/blob/main/SECURITY.md#white-hat-hacking){target=\blank}**, and follow the **[Wormhole Contributor Guidelines](https://github.com/wormhole-foundation/wormhole/blob/main/CONTRIBUTING.md){target=\blank}**. For more information about submitting to the bug bounty programs, **[look here](https://immunefi.com/bug-bounty/wormhole/){target=\blank}** From fdfd48d29f1bd30f98e4d039ec79688924032cd4 Mon Sep 17 00:00:00 2001 From: Ilaria <43253244+ilariae@users.noreply.github.com> Date: Mon, 29 Jul 2024 11:48:41 +0200 Subject: [PATCH 19/36] Update learn/security.md Co-authored-by: Erin Shaben --- learn/security.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/learn/security.md b/learn/security.md index e3eaeac6..5303aa77 100644 --- a/learn/security.md +++ b/learn/security.md @@ -110,7 +110,7 @@ Both platforms have a top payout of **2.5 million dollars**. If you are interested in contributing to Wormhole security, please look at this section for **[Getting Started as a White Hat](https://github.com/wormhole-foundation/wormhole/blob/main/SECURITY.md#white-hat-hacking){target=\blank}**, and follow the **[Wormhole Contributor Guidelines](https://github.com/wormhole-foundation/wormhole/blob/main/CONTRIBUTING.md){target=\blank}**. -For more information about submitting to the bug bounty programs, **[look here](https://immunefi.com/bug-bounty/wormhole/){target=\blank}** +For more information about submitting to the bug bounty programs, refer to the [Wormhole Immunefi page](https://immunefi.com/bug-bounty/wormhole/){target=\blank}. ## Learn More The **[SECURITY.md](https://github.com/wormhole-foundation/wormhole/blob/main/SECURITY.md){target=\blank}** from the official repository has the latest security policies and updates. From 7d14166bdc0b191f1c72e94f6b56849f2b4bbff8 Mon Sep 17 00:00:00 2001 From: Ilaria <43253244+ilariae@users.noreply.github.com> Date: Mon, 29 Jul 2024 11:48:49 +0200 Subject: [PATCH 20/36] Update learn/security.md Co-authored-by: Erin Shaben --- learn/security.md | 1 + 1 file changed, 1 insertion(+) diff --git a/learn/security.md b/learn/security.md index 5303aa77..09dd8985 100644 --- a/learn/security.md +++ b/learn/security.md @@ -113,4 +113,5 @@ If you are interested in contributing to Wormhole security, please look at this For more information about submitting to the bug bounty programs, refer to the [Wormhole Immunefi page](https://immunefi.com/bug-bounty/wormhole/){target=\blank}. ## Learn More + The **[SECURITY.md](https://github.com/wormhole-foundation/wormhole/blob/main/SECURITY.md){target=\blank}** from the official repository has the latest security policies and updates. From 1025153b40399b32f1a436478f24d6c323895ef3 Mon Sep 17 00:00:00 2001 From: Ilaria <43253244+ilariae@users.noreply.github.com> Date: Mon, 29 Jul 2024 11:49:11 +0200 Subject: [PATCH 21/36] Update learn/security.md Co-authored-by: Erin Shaben --- learn/security.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/learn/security.md b/learn/security.md index 09dd8985..79edc415 100644 --- a/learn/security.md +++ b/learn/security.md @@ -21,7 +21,7 @@ At its core, Wormhole is secured by a network of [Guardian](#){target=\_blank} n In summary: - **Core integrators aren't exposed to risk from chains and contracts they don't integrate with** -- By default, you only trust Wormhole's signing process and the Core Contracts of the chains you're on +- By default, you only trust Wormhole's signing process and the core contracts of the chains you're on - You can expand your contract and chain dependencies as you see fit Core assumptions aside, many other factors impact the real-world security of decentralized platforms. Here is more information on additional measures that have been put in place to ensure the security of Wormhole. From 5865bf3eb1bd7077909f7b7a1735864c962332f2 Mon Sep 17 00:00:00 2001 From: Ilaria <43253244+ilariae@users.noreply.github.com> Date: Mon, 29 Jul 2024 11:49:23 +0200 Subject: [PATCH 22/36] Update learn/security.md Co-authored-by: Erin Shaben --- learn/security.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/learn/security.md b/learn/security.md index 79edc415..9d61966f 100644 --- a/learn/security.md +++ b/learn/security.md @@ -46,7 +46,7 @@ Via governance, the Guardians can: - Expand the Guardian set - Upgrade ecosystem contract implementations -The Governance system is fully open source in the core repository. See the **[Open Source section](#){target=\_blank}** for contract source. +The governance system is fully open source in the core repository. See the **[Open Source section](#){target=\_blank}** for contract source. ## Monitoring From fea029b8d60ce1d9e3a72dd6b5aa867999f0b737 Mon Sep 17 00:00:00 2001 From: Ilaria <43253244+ilariae@users.noreply.github.com> Date: Mon, 29 Jul 2024 11:51:44 +0200 Subject: [PATCH 23/36] Update learn/security.md Co-authored-by: Erin Shaben --- learn/security.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/learn/security.md b/learn/security.md index 9d61966f..1598edf7 100644 --- a/learn/security.md +++ b/learn/security.md @@ -52,7 +52,7 @@ The governance system is fully open source in the core repository. See the **[Op A key element of Wormhole's defense-in-depth strategy is that each Guardian is a highly competent validator company with its own in-house processes for running, monitoring, and securing blockchain operations. This heterogeneous approach to monitoring increases the likelihood that fraudulent activity is detected and reduces the number of single failure points in the system. -Guardians are not just running Wormhole validators; they're running validators for **every blockchain inside of Wormhole** as well, which allows them to perform monitoring **holistically across decentralized computing**, rather than just at a few single points. +Guardians are not just running Wormhole validators; they're running validators for every blockchain inside of Wormhole as well, which allows them to perform monitoring holistically across decentralized computing rather than just at a few single points. Guardians Monitor: From 78081c9a50798cc635abd0305d009c413ab85a44 Mon Sep 17 00:00:00 2001 From: Ilaria Enache Date: Mon, 29 Jul 2024 11:53:12 +0200 Subject: [PATCH 24/36] update security page --- learn/security.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/learn/security.md b/learn/security.md index 9d61966f..ae64470b 100644 --- a/learn/security.md +++ b/learn/security.md @@ -52,7 +52,7 @@ The governance system is fully open source in the core repository. See the **[Op A key element of Wormhole's defense-in-depth strategy is that each Guardian is a highly competent validator company with its own in-house processes for running, monitoring, and securing blockchain operations. This heterogeneous approach to monitoring increases the likelihood that fraudulent activity is detected and reduces the number of single failure points in the system. -Guardians are not just running Wormhole validators; they're running validators for **every blockchain inside of Wormhole** as well, which allows them to perform monitoring **holistically across decentralized computing**, rather than just at a few single points. +Guardians are not just running Wormhole validators; they're running validators for every blockchain inside of Wormhole as well, which allows them to perform monitoring holistically across decentralized computing, rather than just at a few single points. Guardians Monitor: From 9e1ec99a33a397ddfc31b33c7ca91e92d157ab26 Mon Sep 17 00:00:00 2001 From: Ilaria <43253244+ilariae@users.noreply.github.com> Date: Mon, 29 Jul 2024 11:57:37 +0200 Subject: [PATCH 25/36] Update learn/security.md Co-authored-by: Erin Shaben --- learn/security.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/learn/security.md b/learn/security.md index 1598edf7..130ac6fb 100644 --- a/learn/security.md +++ b/learn/security.md @@ -56,7 +56,7 @@ Guardians are not just running Wormhole validators; they're running validators f Guardians Monitor: -- Block Production & Consensus of each blockchain - if a blockchain's consensus is violated it will be disconnected from the network until the Guardians resolve the issue +- Block production and consensus of each blockchain - if a blockchain's consensus is violated, it will be disconnected from the network until the Guardians resolve the issue - Smart Contract level data - via processes like the Governor, Guardians constantly monitor the circulating supply and token movements across all supported blockchains - Guardian Level activity - the Guardian Network functions as an autonomous decentralized computing network, complete with its blockchain (**[Gateway](#){target=\_blank}**) From 8e6d9fb41be62612e0db9ce6f3d85f4770417b56 Mon Sep 17 00:00:00 2001 From: Ilaria <43253244+ilariae@users.noreply.github.com> Date: Mon, 29 Jul 2024 12:00:01 +0200 Subject: [PATCH 26/36] Update learn/security.md Co-authored-by: Erin Shaben --- learn/security.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/learn/security.md b/learn/security.md index c5c084cf..3b467268 100644 --- a/learn/security.md +++ b/learn/security.md @@ -58,7 +58,7 @@ Guardians are not just running Wormhole validators; they're running validators f Guardians are not just running Wormhole validators; they're running validators for every blockchain inside of Wormhole as well, which allows them to perform monitoring holistically across decentralized computing rather than just at a few single points. >>>>>>> fea029b8d60ce1d9e3a72dd6b5aa867999f0b737 -Guardians Monitor: +Guardians monitor: - Block production and consensus of each blockchain - if a blockchain's consensus is violated, it will be disconnected from the network until the Guardians resolve the issue - Smart Contract level data - via processes like the Governor, Guardians constantly monitor the circulating supply and token movements across all supported blockchains From 687739ddae0f288d3131c456177855bb299b52c1 Mon Sep 17 00:00:00 2001 From: Ilaria <43253244+ilariae@users.noreply.github.com> Date: Mon, 29 Jul 2024 12:01:15 +0200 Subject: [PATCH 27/36] Update learn/security.md Co-authored-by: Erin Shaben --- learn/security.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/learn/security.md b/learn/security.md index 3b467268..f7c77983 100644 --- a/learn/security.md +++ b/learn/security.md @@ -61,7 +61,7 @@ Guardians are not just running Wormhole validators; they're running validators f Guardians monitor: - Block production and consensus of each blockchain - if a blockchain's consensus is violated, it will be disconnected from the network until the Guardians resolve the issue -- Smart Contract level data - via processes like the Governor, Guardians constantly monitor the circulating supply and token movements across all supported blockchains +- Smart contract level data - via processes like the Governor, Guardians constantly monitor the circulating supply and token movements across all supported blockchains - Guardian Level activity - the Guardian Network functions as an autonomous decentralized computing network, complete with its blockchain (**[Gateway](#){target=\_blank}**) ## Gateway & Asset Layer Protections From 95499978650bd8de1edfea1c5e0c88347fd80d5f Mon Sep 17 00:00:00 2001 From: Ilaria <43253244+ilariae@users.noreply.github.com> Date: Mon, 29 Jul 2024 12:03:49 +0200 Subject: [PATCH 28/36] Update learn/security.md Co-authored-by: Erin Shaben --- learn/security.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/learn/security.md b/learn/security.md index f7c77983..922d0f20 100644 --- a/learn/security.md +++ b/learn/security.md @@ -62,7 +62,7 @@ Guardians monitor: - Block production and consensus of each blockchain - if a blockchain's consensus is violated, it will be disconnected from the network until the Guardians resolve the issue - Smart contract level data - via processes like the Governor, Guardians constantly monitor the circulating supply and token movements across all supported blockchains -- Guardian Level activity - the Guardian Network functions as an autonomous decentralized computing network, complete with its blockchain (**[Gateway](#){target=\_blank}**) +- Guardian level activity - the Guardian Network functions as an autonomous decentralized computing network, complete with its blockchain (**[Gateway](#){target=\_blank}**) ## Gateway & Asset Layer Protections From 259fbeca63bf18de04c1a7e08ba3052786ca04e1 Mon Sep 17 00:00:00 2001 From: Ilaria Enache Date: Mon, 29 Jul 2024 12:04:43 +0200 Subject: [PATCH 29/36] Resolved conflicts in learn/security.md --- learn/security.md | 6 +----- 1 file changed, 1 insertion(+), 5 deletions(-) diff --git a/learn/security.md b/learn/security.md index f7c77983..429e4a9f 100644 --- a/learn/security.md +++ b/learn/security.md @@ -52,16 +52,12 @@ The governance system is fully open source in the core repository. See the **[Op A key element of Wormhole's defense-in-depth strategy is that each Guardian is a highly competent validator company with its own in-house processes for running, monitoring, and securing blockchain operations. This heterogeneous approach to monitoring increases the likelihood that fraudulent activity is detected and reduces the number of single failure points in the system. -<<<<<<< HEAD -Guardians are not just running Wormhole validators; they're running validators for every blockchain inside of Wormhole as well, which allows them to perform monitoring holistically across decentralized computing, rather than just at a few single points. -======= Guardians are not just running Wormhole validators; they're running validators for every blockchain inside of Wormhole as well, which allows them to perform monitoring holistically across decentralized computing rather than just at a few single points. ->>>>>>> fea029b8d60ce1d9e3a72dd6b5aa867999f0b737 Guardians monitor: - Block production and consensus of each blockchain - if a blockchain's consensus is violated, it will be disconnected from the network until the Guardians resolve the issue -- Smart contract level data - via processes like the Governor, Guardians constantly monitor the circulating supply and token movements across all supported blockchains +- Smart Contract level data - via processes like the Governor, Guardians constantly monitor the circulating supply and token movements across all supported blockchains - Guardian Level activity - the Guardian Network functions as an autonomous decentralized computing network, complete with its blockchain (**[Gateway](#){target=\_blank}**) ## Gateway & Asset Layer Protections From 0d0f3001afa1cbd5d6fa1f321a98f7a478898bce Mon Sep 17 00:00:00 2001 From: Ilaria <43253244+ilariae@users.noreply.github.com> Date: Mon, 29 Jul 2024 12:06:39 +0200 Subject: [PATCH 30/36] Update learn/security.md Co-authored-by: Erin Shaben --- learn/security.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/learn/security.md b/learn/security.md index 541fe122..cdf9b31a 100644 --- a/learn/security.md +++ b/learn/security.md @@ -60,7 +60,7 @@ Guardians monitor: - Smart contract level data - via processes like the Governor, Guardians constantly monitor the circulating supply and token movements across all supported blockchains - Guardian level activity - the Guardian Network functions as an autonomous decentralized computing network, complete with its blockchain (**[Gateway](#){target=\_blank}**) -## Gateway & Asset Layer Protections +## Gateway And Asset Layer Protections One of the most powerful aspects of the Wormhole ecosystem is that Guardians effectively have **the entire state DeFi available to them**. From d3e560e789c1cc15c94c90376a6b764bb02ae588 Mon Sep 17 00:00:00 2001 From: Ilaria <43253244+ilariae@users.noreply.github.com> Date: Mon, 29 Jul 2024 12:07:01 +0200 Subject: [PATCH 31/36] Update learn/security.md Co-authored-by: Erin Shaben --- learn/security.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/learn/security.md b/learn/security.md index cdf9b31a..c13fda48 100644 --- a/learn/security.md +++ b/learn/security.md @@ -62,7 +62,7 @@ Guardians monitor: ## Gateway And Asset Layer Protections -One of the most powerful aspects of the Wormhole ecosystem is that Guardians effectively have **the entire state DeFi available to them**. +One of the most powerful aspects of the Wormhole ecosystem is that Guardians effectively have the entire state of DeFi available to them. Gateway is a Cosmos-based blockchain that runs internally to the Guardian network, whereby the Guardians can effectively execute smart contracts against the current state of all blockchains rather than just one blockchain. From 66b22e01010439ac665dc3e3d2f4bfd54633e2f0 Mon Sep 17 00:00:00 2001 From: Ilaria <43253244+ilariae@users.noreply.github.com> Date: Mon, 29 Jul 2024 12:07:50 +0200 Subject: [PATCH 32/36] Update learn/security.md Co-authored-by: Erin Shaben --- learn/security.md | 1 + 1 file changed, 1 insertion(+) diff --git a/learn/security.md b/learn/security.md index c13fda48..037e1ef5 100644 --- a/learn/security.md +++ b/learn/security.md @@ -67,6 +67,7 @@ One of the most powerful aspects of the Wormhole ecosystem is that Guardians eff Gateway is a Cosmos-based blockchain that runs internally to the Guardian network, whereby the Guardians can effectively execute smart contracts against the current state of all blockchains rather than just one blockchain. This enables additional protection for the Wormhole Asset Layer in addition to the core assumptions: + - **Global Accountant** - the accountant tracks the total circulating supply of all Wormhole assets across all chains and prevents any blockchain from bridging assets which would violate the supply invariant In addition to the Global Accountant, Guardians may only sign transfers that do not violate the requirements of the Governor. The **[Governor](https://github.com/wormhole-foundation/wormhole/blob/main/whitepapers/0007_governor.md){target=\_blank}** tracks inflows and outflows of all blockchains and delays suspicious transfers which may be indicative of an exploit. From 8fb1f2be9dab6097a6a694a464675b89d1dbdf29 Mon Sep 17 00:00:00 2001 From: Ilaria <43253244+ilariae@users.noreply.github.com> Date: Mon, 29 Jul 2024 12:08:05 +0200 Subject: [PATCH 33/36] Update learn/security.md Co-authored-by: Erin Shaben --- learn/security.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/learn/security.md b/learn/security.md index 037e1ef5..ac4af781 100644 --- a/learn/security.md +++ b/learn/security.md @@ -70,7 +70,7 @@ This enables additional protection for the Wormhole Asset Layer in addition to t - **Global Accountant** - the accountant tracks the total circulating supply of all Wormhole assets across all chains and prevents any blockchain from bridging assets which would violate the supply invariant -In addition to the Global Accountant, Guardians may only sign transfers that do not violate the requirements of the Governor. The **[Governor](https://github.com/wormhole-foundation/wormhole/blob/main/whitepapers/0007_governor.md){target=\_blank}** tracks inflows and outflows of all blockchains and delays suspicious transfers which may be indicative of an exploit. +In addition to the Global Accountant, Guardians may only sign transfers that do not violate the requirements of the Governor. The **[Governor](https://github.com/wormhole-foundation/wormhole/blob/main/whitepapers/0007_governor.md){target=\_blank}** tracks inflows and outflows of all blockchains and delays suspicious transfers that may indicate an exploit. ## Open Source From 642430d9a941130e379f32f1a962595d3bf81535 Mon Sep 17 00:00:00 2001 From: Ilaria <43253244+ilariae@users.noreply.github.com> Date: Mon, 29 Jul 2024 12:08:15 +0200 Subject: [PATCH 34/36] Update learn/security.md Co-authored-by: Erin Shaben --- learn/security.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/learn/security.md b/learn/security.md index ac4af781..e895c18d 100644 --- a/learn/security.md +++ b/learn/security.md @@ -76,7 +76,7 @@ In addition to the Global Accountant, Guardians may only sign transfers that do Wormhole builds in the open and is always open source. -- **[Wormhole Core Repository](https://github.com/wormhole-foundation/wormhole){target=\_blank}** +- **[Wormhole core repository](https://github.com/wormhole-foundation/wormhole){target=\_blank}** - **[Wormhole Foundation Github Organization](https://github.com/wormhole-foundation){target=\_blank}** - **[Wormhole contract deployments](#){target=\_blank}** From 1567c38a42d8b27ac031d1493a7ce1dc123053e6 Mon Sep 17 00:00:00 2001 From: Ilaria <43253244+ilariae@users.noreply.github.com> Date: Mon, 29 Jul 2024 12:08:26 +0200 Subject: [PATCH 35/36] Update learn/security.md Co-authored-by: Erin Shaben --- learn/security.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/learn/security.md b/learn/security.md index e895c18d..2bc9d49f 100644 --- a/learn/security.md +++ b/learn/security.md @@ -77,7 +77,7 @@ In addition to the Global Accountant, Guardians may only sign transfers that do Wormhole builds in the open and is always open source. - **[Wormhole core repository](https://github.com/wormhole-foundation/wormhole){target=\_blank}** -- **[Wormhole Foundation Github Organization](https://github.com/wormhole-foundation){target=\_blank}** +- **[Wormhole Foundation GitHub organization](https://github.com/wormhole-foundation){target=\_blank}** - **[Wormhole contract deployments](#){target=\_blank}** ## Audits From 3114c1e55e851bda80dbb1cd58ad64bcef910a14 Mon Sep 17 00:00:00 2001 From: Ilaria Enache Date: Mon, 29 Jul 2024 12:44:41 +0200 Subject: [PATCH 36/36] update security page --- learn/security.md | 22 +++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/learn/security.md b/learn/security.md index 2bc9d49f..dada2890 100644 --- a/learn/security.md +++ b/learn/security.md @@ -12,7 +12,7 @@ some missing links will need to be added when pages are created At its core, Wormhole is secured by a network of [Guardian](#){target=\_blank} nodes that validate and sign messages. If a super majority (e.g., 13 out of 19) of Guardians sign the same message, it can be considered valid. A smart contract on the target chain will verify the signatures and format of the message before approving any transaction. - Wormhole's core security primitive is its signed messages (signed VAAs) -- The Guardian network is currently secured by a collection of 19 of the world's top **[validator companies](https://wormhole-foundation.github.io/wormhole-dashboard/#/?endpoint=Mainnet){target=\_blank}** +- The Guardian network is currently secured by a collection of 19 of the world's top [validator companies](https://wormhole-foundation.github.io/wormhole-dashboard/#/?endpoint=Mainnet){target=\_blank} - Guardians produce signed state attestations (signed VAAs) when requested by a Core Contract integrator - Every Guardian runs full nodes (rather than light nodes) of every blockchain in the Wormhole network, so if a blockchain suffers a consensus attack or hard fork, the blockchain will disconnect from the network rather than potentially produce invalid signed VAAs - Any Signed VAA can be verified as authentic by the Core Contract of any other chain @@ -46,7 +46,7 @@ Via governance, the Guardians can: - Expand the Guardian set - Upgrade ecosystem contract implementations -The governance system is fully open source in the core repository. See the **[Open Source section](#){target=\_blank}** for contract source. +The governance system is fully open source in the core repository. See the [Open Source section](#){target=\_blank} for contract source. ## Monitoring @@ -58,7 +58,7 @@ Guardians monitor: - Block production and consensus of each blockchain - if a blockchain's consensus is violated, it will be disconnected from the network until the Guardians resolve the issue - Smart contract level data - via processes like the Governor, Guardians constantly monitor the circulating supply and token movements across all supported blockchains -- Guardian level activity - the Guardian Network functions as an autonomous decentralized computing network, complete with its blockchain (**[Gateway](#){target=\_blank}**) +- Guardian level activity - the Guardian Network functions as an autonomous decentralized computing network, complete with its blockchain ([Gateway](#){target=\_blank}) ## Gateway And Asset Layer Protections @@ -70,7 +70,7 @@ This enables additional protection for the Wormhole Asset Layer in addition to t - **Global Accountant** - the accountant tracks the total circulating supply of all Wormhole assets across all chains and prevents any blockchain from bridging assets which would violate the supply invariant -In addition to the Global Accountant, Guardians may only sign transfers that do not violate the requirements of the Governor. The **[Governor](https://github.com/wormhole-foundation/wormhole/blob/main/whitepapers/0007_governor.md){target=\_blank}** tracks inflows and outflows of all blockchains and delays suspicious transfers that may indicate an exploit. +In addition to the Global Accountant, Guardians may only sign transfers that do not violate the requirements of the Governor. The [Governor](https://github.com/wormhole-foundation/wormhole/blob/main/whitepapers/0007_governor.md){target=\_blank} tracks inflows and outflows of all blockchains and delays suspicious transfers that may indicate an exploit. ## Open Source @@ -82,7 +82,7 @@ Wormhole builds in the open and is always open source. ## Audits -Wormhole has been heavily audited, with **29 third-party audits completed** and more started. +Wormhole has been heavily audited, with _29 third-party audits completed_ and more started. Wormhole has had audits performed by the following firms, and continues to seek more: @@ -96,7 +96,7 @@ Wormhole has had audits performed by the following firms, and continues to seek - Coinspect - Halborn -**[The most up-to-date list of audits, as well as the final reports](https://github.com/wormhole-foundation/wormhole/blob/main/SECURITY.md#3rd-party-security-audits){target=\blank}**. +[The most up-to-date list of audits, as well as the final reports](https://github.com/wormhole-foundation/wormhole/blob/main/SECURITY.md#3rd-party-security-audits){target=\blank}. ## Bug Bounties @@ -104,15 +104,15 @@ Wormhole has one of the largest bug bounty programs in software development and Wormhole hosts two bug bounty programs: -- An **[Immunefi](https://immunefi.com/bug-bounty/wormhole/){target=\blank}** program -- As well as a **[self-hosted program](https://immunefi.com/bug-bounty/wormhole/){target=\blank}** +- An [Immunefi](https://immunefi.com/bug-bounty/wormhole/){target=\blank} program +- As well as a [self-hosted program](https://immunefi.com/bug-bounty/wormhole/){target=\blank} -Both platforms have a top payout of **2.5 million dollars**. +Both platforms have a top payout of _2.5 million dollars_. -If you are interested in contributing to Wormhole security, please look at this section for **[Getting Started as a White Hat](https://github.com/wormhole-foundation/wormhole/blob/main/SECURITY.md#white-hat-hacking){target=\blank}**, and follow the **[Wormhole Contributor Guidelines](https://github.com/wormhole-foundation/wormhole/blob/main/CONTRIBUTING.md){target=\blank}**. +If you are interested in contributing to Wormhole security, please look at this section for [Getting Started as a White Hat](https://github.com/wormhole-foundation/wormhole/blob/main/SECURITY.md#white-hat-hacking){target=\blank}, and follow the [Wormhole Contributor Guidelines](https://github.com/wormhole-foundation/wormhole/blob/main/CONTRIBUTING.md){target=\blank}. For more information about submitting to the bug bounty programs, refer to the [Wormhole Immunefi page](https://immunefi.com/bug-bounty/wormhole/){target=\blank}. ## Learn More -The **[SECURITY.md](https://github.com/wormhole-foundation/wormhole/blob/main/SECURITY.md){target=\blank}** from the official repository has the latest security policies and updates. +The [SECURITY.md](https://github.com/wormhole-foundation/wormhole/blob/main/SECURITY.md){target=\blank} from the official repository has the latest security policies and updates.