Skip to content

Commit 4d2c722

Browse files
refresh infra architecture, updates llms (#324)
* refresh infra architecture, updates llms * updates next steps cards, updates llms --------- Co-authored-by: Martin Hofmann <martin@papermoon.io>
1 parent 35c9f44 commit 4d2c722

File tree

2 files changed

+62
-14
lines changed

2 files changed

+62
-14
lines changed

learn/infrastructure/architecture.md

+31-7
Original file line numberDiff line numberDiff line change
@@ -3,28 +3,30 @@ title: Architecture
33
description: Overview of Wormhole's architecture, detailing key on-chain and off-chain components like the Core Contract, Guardian Network, and relayers.
44
---
55

6-
# Architecture Overview
6+
# Architecture
77

8-
## Architecture
8+
## Overview
99

1010
Wormhole has several noteworthy components. Before discussing each component in depth, this page will provide an overview of how the major pieces fit together.
1111

1212
![Wormhole architecture detailed diagram: source to target chain communication.](/docs/images/learn/infrastructure/architecture/architecture-1.webp)
1313

14-
The diagram outlines the end-to-end flow of cross-chain communication through Wormhole's architecture:
14+
The preceding diagram outlines the end-to-end flow of multichain communication through Wormhole's architecture, which is described as follows:
1515

1616
1. **Source chain** - a source contract emits a message by interacting with the [Wormhole Core Contract](/docs/learn/infrastructure/core-contracts/){target=\_blank} on the source chain, which publishes the message in the blockchain's transaction logs
1717
2. **Guardian Network** - [Guardians](/docs/learn/infrastructure/guardians/){target=\_blank} validate these messages and sign them to produce [Verifiable Action Approvals (VAAs)](/docs/learn/infrastructure/vaas/){target=\_blank}
1818
3. **Relayers** - off-chain relayers or applications fetch the VAA and relay it to the target chain
19-
4. **Target chain** - on the target chain, the message is consumed by the appropriate contract. This contract interacts with the Wormhole Core Contract to verify the VAA and execute the intended cross-chain operation. The flow from the relayer to the target chain involves an entry point contract, which could vary based on the use case:
19+
4. **Target chain** - on the target chain, the message is consumed by the appropriate contract. This contract interacts with the Wormhole Core Contract to verify the VAA and execute the intended multichain operation.
20+
21+
The flow from the relayer to the target chain involves an entry point contract, which could vary based on the use case:
2022

2123
- In some applications, the target contract acts as the entry point and performs verification via the Core Contract
2224
- In products like the Token Bridge, the Token Bridge contract itself interacts with the Core Contract
2325

2426
## On-Chain Components
2527

26-
- **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](/docs/learn/glossary/#xdapp){target=\_blank} or an existing ecosystem protocol
27-
- **[Wormhole Core Contract](/docs/learn/infrastructure/core-contracts/){target=\_blank}** - primary contract, this is the contract which the Guardians observe and which fundamentally allows for cross-chain communication
28+
- **Emitter** - a contract that calls the publish message method on the Core Contract. To identify the message, the Core Contract will write an event to the transaction logs with details about the emitter and sequence number. This may be your [xDapp](/docs/learn/glossary/#xdapp){target=\_blank} or an existing ecosystem protocol
29+
- **[Wormhole Core Contract](/docs/learn/infrastructure/core-contracts/){target=\_blank}** - primary contract, this is the contract which the Guardians observe and which fundamentally allows for multichain communication
2830
- **Transaction logs** - blockchain-specific logs that allow the Guardians to observe messages emitted by the Core Contract
2931

3032
## Off-Chain Components
@@ -36,4 +38,26 @@ The diagram outlines the end-to-end flow of cross-chain communication through Wo
3638
- **[VAAs](/docs/learn/infrastructure/vaas/){target=\_blank}** - Verifiable Action Approvals (VAAs) are the signed attestation of an observed message from the Wormhole Core Contract
3739
- **[Relayer](/docs/learn/infrastructure/relayer/){target=\_blank}** - any off-chain process that relays a VAA to the target chain
3840
- **Wormhole relayers** - a decentralized relayer network that delivers messages that are requested on-chain via the Wormhole relayer contract
39-
- **Custom 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 custom relayers
41+
- **Custom relayers** - relayers that only handle VAAs for a specific protocol or multichain application. They can execute custom logic off-chain, reducing gas costs and increasing multichain compatibility. Currently, multichain application developers are responsible for developing and hosting custom relayers
42+
43+
## Next Steps
44+
45+
<div class="grid cards" markdown>
46+
47+
- :octicons-book-16:{ .lg .middle } **Core Contracts**
48+
49+
---
50+
51+
Discover Wormhole's Core Contracts, enabling multichain communication with message sending, receiving, and multicast features for efficient synchronization.
52+
53+
[:custom-arrow: Explore Core Contracts](/docs/learn/infrastructure/core-contracts/)
54+
55+
- :octicons-tools-16:{ .lg .middle } **Core Messaging**
56+
57+
---
58+
59+
Follow the guides in this section to work directly with the building blocks of Wormhole messaging, Wormhole-deployed relayers and Core Contracts, to send, receive, validate, and track multichain messages.
60+
61+
[:custom-arrow: Build with Core Messaging](/docs/build/core-messaging/)
62+
63+
</div>

llms.txt

+31-7
Original file line numberDiff line numberDiff line change
@@ -15303,28 +15303,30 @@ title: Architecture
1530315303
description: Overview of Wormhole's architecture, detailing key on-chain and off-chain components like the Core Contract, Guardian Network, and relayers.
1530415304
---
1530515305

15306-
# Architecture Overview
15306+
# Architecture
1530715307

15308-
## Architecture
15308+
## Overview
1530915309

1531015310
Wormhole has several noteworthy components. Before discussing each component in depth, this page will provide an overview of how the major pieces fit together.
1531115311

1531215312
![Wormhole architecture detailed diagram: source to target chain communication.](/docs/images/learn/infrastructure/architecture/architecture-1.webp)
1531315313

15314-
The diagram outlines the end-to-end flow of cross-chain communication through Wormhole's architecture:
15314+
The preceding diagram outlines the end-to-end flow of multichain communication through Wormhole's architecture, which is described as follows:
1531515315

1531615316
1. **Source chain** - a source contract emits a message by interacting with the [Wormhole Core Contract](/docs/learn/infrastructure/core-contracts/){target=\_blank} on the source chain, which publishes the message in the blockchain's transaction logs
1531715317
2. **Guardian Network** - [Guardians](/docs/learn/infrastructure/guardians/){target=\_blank} validate these messages and sign them to produce [Verifiable Action Approvals (VAAs)](/docs/learn/infrastructure/vaas/){target=\_blank}
1531815318
3. **Relayers** - off-chain relayers or applications fetch the VAA and relay it to the target chain
15319-
4. **Target chain** - on the target chain, the message is consumed by the appropriate contract. This contract interacts with the Wormhole Core Contract to verify the VAA and execute the intended cross-chain operation. The flow from the relayer to the target chain involves an entry point contract, which could vary based on the use case:
15319+
4. **Target chain** - on the target chain, the message is consumed by the appropriate contract. This contract interacts with the Wormhole Core Contract to verify the VAA and execute the intended multichain operation.
15320+
15321+
The flow from the relayer to the target chain involves an entry point contract, which could vary based on the use case:
1532015322

1532115323
- In some applications, the target contract acts as the entry point and performs verification via the Core Contract
1532215324
- In products like the Token Bridge, the Token Bridge contract itself interacts with the Core Contract
1532315325

1532415326
## On-Chain Components
1532515327

15326-
- **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](/docs/learn/glossary/#xdapp){target=\_blank} or an existing ecosystem protocol
15327-
- **[Wormhole Core Contract](/docs/learn/infrastructure/core-contracts/){target=\_blank}** - primary contract, this is the contract which the Guardians observe and which fundamentally allows for cross-chain communication
15328+
- **Emitter** - a contract that calls the publish message method on the Core Contract. To identify the message, the Core Contract will write an event to the transaction logs with details about the emitter and sequence number. This may be your [xDapp](/docs/learn/glossary/#xdapp){target=\_blank} or an existing ecosystem protocol
15329+
- **[Wormhole Core Contract](/docs/learn/infrastructure/core-contracts/){target=\_blank}** - primary contract, this is the contract which the Guardians observe and which fundamentally allows for multichain communication
1532815330
- **Transaction logs** - blockchain-specific logs that allow the Guardians to observe messages emitted by the Core Contract
1532915331

1533015332
## Off-Chain Components
@@ -15336,7 +15338,29 @@ The diagram outlines the end-to-end flow of cross-chain communication through Wo
1533615338
- **[VAAs](/docs/learn/infrastructure/vaas/){target=\_blank}** - Verifiable Action Approvals (VAAs) are the signed attestation of an observed message from the Wormhole Core Contract
1533715339
- **[Relayer](/docs/learn/infrastructure/relayer/){target=\_blank}** - any off-chain process that relays a VAA to the target chain
1533815340
- **Wormhole relayers** - a decentralized relayer network that delivers messages that are requested on-chain via the Wormhole relayer contract
15339-
- **Custom 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 custom relayers
15341+
- **Custom relayers** - relayers that only handle VAAs for a specific protocol or multichain application. They can execute custom logic off-chain, reducing gas costs and increasing multichain compatibility. Currently, multichain application developers are responsible for developing and hosting custom relayers
15342+
15343+
## Next Steps
15344+
15345+
<div class="grid cards" markdown>
15346+
15347+
- :octicons-book-16:{ .lg .middle } **Core Contracts**
15348+
15349+
---
15350+
15351+
Discover Wormhole's Core Contracts, enabling multichain communication with message sending, receiving, and multicast features for efficient synchronization.
15352+
15353+
[:custom-arrow: Explore Core Contracts](/docs/learn/infrastructure/core-contracts/)
15354+
15355+
- :octicons-tools-16:{ .lg .middle } **Core Messaging**
15356+
15357+
---
15358+
15359+
Follow the guides in this section to work directly with the building blocks of Wormhole messaging, Wormhole-deployed relayers and Core Contracts, to send, receive, validate, and track multichain messages.
15360+
15361+
[:custom-arrow: Build with Core Messaging](/docs/build/core-messaging/)
15362+
15363+
</div>
1534015364
--- END CONTENT ---
1534115365

1534215366
Doc-Content: https://wormhole.com/docs/learn/infrastructure/core-contracts/

0 commit comments

Comments
 (0)