Skip to content

Commit 1d64d82

Browse files
Ilaria EnacheIlaria Enache
Ilaria Enache
authored and
Ilaria Enache
committed
sync with main
2 parents 0d8df79 + 1212370 commit 1d64d82

File tree

4 files changed

+36
-3
lines changed

4 files changed

+36
-3
lines changed

learn/architecture.md

+33
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
---
2+
title: Architecture
3+
description: Overview of Wormhole's architecture, detailing key on-chain and off-chain components like the Core Contract, Guardian Network, and relayers.
4+
---
5+
<!--
6+
need to link this page in the introduction page once its merged
7+
need to add links
8+
-->
9+
# Architecture Overview
10+
11+
## Architecture
12+
13+
Wormhole has several noteworthy components. Before discussing each component in depth, this page will provide an overview of how the major pieces fit together.
14+
15+
![Wormhole architecture detailed diagram: source to target chain communication.](/images/learn/architecture/architecture-1.webp)
16+
17+
## On-Chain Components
18+
19+
- **Emitter** - a contract that calls the publish message method on the Core Contract. The Core Contract will write an event to the transaction logs with details about the emitter and sequence number to identify the message. This may be your [xDapp](#){target=\_blank} or an existing ecosystem protocol <!-- link to glossary xDapp -->
20+
- **[Wormhole Core Contract](#){target=\_blank}** - primary contract, this is the contract which the Guardians observe and which fundamentally allows for cross-chain communication <!-- link to core contracts page -->
21+
- **Transaction Log** - blockchain-specific logs that allow the Guardians to observe messages emitted by the core contract
22+
23+
## Off-Chain Components
24+
25+
- **Guardian Network** - validators that exist in their own P2P network. Guardians observe and validate the messages emitted by the Core Contract on each supported chain to produce VAAs (signed messages)
26+
- **[Guardian](#){target=\_blank}** - one of 19 validators in the Guardian Network that contributes to the VAA multisig
27+
- **[Spy](#){target=\_blank}** - a daemon that subscribes to messages published within the Guardian Network. A Spy can observe and forward network traffic, which helps scale up VAA distribution
28+
- **[API](#){target=\_blank}** - a REST server to retrieve details for a VAA or the Guardian Network
29+
- **[VAAs](/learn/infrastructure/vaas/){target=\_blank}** - Verifiable Action Approvals (VAAs) are the signed attestation of an observed message from the Wormhole Core Contract
30+
- **[Relayer](#){target=\_blank}** - any off-chain process that relays a VAA to the target chain
31+
- **Standard Relayers** - a decentralized relayer network that delivers messages that are requested on-chain via the Wormhole Relay Contract
32+
- **Specialized Relayers** - relayers that only handle VAAs for a specific protocol or cross-chain application. They can execute custom logic off-chain, reducing gas costs and increasing cross-chain compatibility. Currently, cross-chain application developers are responsible for developing and hosting specialized relayers
33+

learn/introduction.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -12,10 +12,10 @@ also missing the list of blockchains
1212

1313
Wormhole is a generic _message-passing protocol_ that enables communication between blockchains.
1414

15-
![Message-passing process in the Wormhole protocol](/images/learn/introduction/simple-overview.webp)
15+
![Message-passing process in the Wormhole protocol](/images/learn/introduction/introduction-1.webp)
1616

1717
!!! note
18-
The above is an oversimplified illustration of the protocol; details about the architecture and components are available on the [architecture page](#){target=\_blank}.
18+
The above is an oversimplified illustration of the protocol; details about the architecture and components are available on the [architecture page](/learn/architecture/){target=\_blank}.
1919
This simple message-passing protocol allows developers and users of cross-chain applications to leverage the advantages of multiple ecosystems.
2020

2121
## What Isn't Wormhole?
@@ -47,7 +47,7 @@ More tutorials are available [on github](#){target=\_blank}. <!-- tutorials will
4747

4848
Discover more about the Wormhole ecosystem, components, and protocols:
4949

50-
- **[Architecture](#){target=\_blank}** - explore the components of the protocol
50+
- **[Architecture](/learn/architecture/){target=\_blank}** - explore the components of the protocol
5151
- **[Protocol Specifications](https://github.com/wormhole-foundation/wormhole/tree/main/whitepapers){target=\_blank}** - learn about the protocols built on top of Wormhole
5252

5353
## Demos

0 commit comments

Comments
 (0)