Ilariae/core contracts

.snippets/code/learn/messaging/core-contracts/receiving.js

@@ -0,0 +1 @@
+parseAndVerifyVAA(byte[] VAA)

.snippets/code/learn/messaging/core-contracts/sending.js

@@ -0,0 +1,5 @@
+publishMessage(
+    int nonce,
+    byte[] payload,
+    int consistencyLevel
+) returns int sequenceNumber

learn/.pages

@@ -5,3 +5,4 @@ nav:
  - 'Security': 'security.md'
  - 'Architecture Overview': 'architecture.md'
  - infrastructure
+ - messaging

learn/messaging/.pages

@@ -0,0 +1,6 @@
+title: Messaging
+nav:
+ - index.md
+ - 'Overview': 'overview.md'
+ - 'Core Contracts': 'core-contracts.md'
+ - 'Token and NFT Bridge': 'token-nft-bridge.md'

learn/messaging/core-contracts.md

@@ -0,0 +1,75 @@
+---
+title: Core Contracts
+description: Discover Wormhole's Core Contracts, enabling cross-chain communication with message sending, receiving, and multicast features for efficient synchronization.
+---
+
+# Core Contracts
+
+The Core Contracts are the mechanism by which all Wormhole messages are emitted. All cross-chain applications either interact directly with the Core Contract or interact with another contract that does. There is one Core Contract on each blockchain in the ecosystem, which is the contract which the Guardians are required to observe. The Core Contract is the contract that ultimately emits the messages the [Guardians](/learn/infrastructure/guardians/){target=\_blank} pick up as an [Observation](#){target=\_blank}.
+
+In general, Core Contracts are simple and can be broken down to a sending and receiving side, which will be defined next. 
+
+## Sending
+
+Currently, there are no fees to publish a message (with the exception of publishing on Solana), but this is not guaranteed to always be the case.
+
+The implementation strategy for `publishMessage` differs by chain. However, the general strategy consists of the Core Contract posting the `emitterAddress` (the contract which called `publishMessage`), `sequenceNumber`, and `consistencyLevel` into the blockchain logs. Once the desired `consistencyLevel` has been reached and the message passes all of the Guardians' optional checks, the Guardian Network will produce the requested Verified Action Approvals [VAAs].
+
+The method signature for publishing messages:
+
+```js
+--8<-- 'code/learn/messaging/core-contracts/sending.js'
+```
+
+#### Parameters
+
+**payload**
+
+The content of the emitted message is an arbitrary byte array. Due to the constraints of individual blockchains, it may be capped to a certain maximum length.
+
+**consistencyLevel**
+
+!!! note
+    Some advanced integrators may want to get messages before finality, which is where the `consistency_level` field offers chain-specific flexibility.
+
+The `consistency_level` can be considered as a numeric `enum` data type where the value is treated differently for different chains.
+
+It describes the level of finality to reach before the Guardians will observe and attest the emitted event. This is a defense against reorgs and rollbacks since a transaction, once considered `final`, is guaranteed not to have the state changes it caused be rolled back.
+
+Different chains use different consensus mechanisms, so there are different finality assumptions with each one, see the options for finality in the [Environments](#){target=\_blank} pages. <!-- link to blockchain platforms -->
+
+**nonce**
+
+A free integer field that can be used however the developer would like. Note that a different `nonce` will result in a different digest.
+
+#### Returns
+
+**sequenceNumber**
+
+A unique number that increments for every message for a given emitter (and implicitly chain). This combined with the emitter address and emitter chain ID allows the VAA for this message to be queried from the [APIs](#){target=\_blank}.
+
+## Receiving
+
+The method signature for receiving messages, encoded as a VAA:
+
+```js
+--8<-- 'code/learn/messaging/core-contracts/receiving.js'
+```
+
+When passed a VAA, this function will either return the payload and associated metadata for the VAA or throw an exception. An exception should only ever be thrown if the VAA fails signature verification, indicating that the VAA is invalid or inauthentic in some form.
+
+!!! note
+    A developer should take care to make sure this method is called during the execution of a transaction where a VAA is passed to ensure the signatures are checked and verified.
+
+## Multicast
+
+Please notice that there is no destination address or chain in these functions.
+
+VAAs simply attest that "this contract on this chain said this thing." Therefore, VAAs are multicast by default and will be verified as authentic on any chain they are brought to.
+
+This multicast-by-default model is integral to the design. Having this multicast capacity makes it easy to synchronize state across the entire ecosystem, because a single blockchain can make its data available to every chain in a single action with low latency. This reduces the complexity of the n^2 problems encountered by routing data to a large number of blockchains.
+
+This does not mean an application _cannot_ specify a destination address or chain. For example, the Token Bridge and Standard Relayer contracts require that some destination details be passed and verified on the destination chain.
+
+Because the VAA creation is separate from relaying, there is no _additional_ cost to the multicast model when a single chain is being targeted. If the data isn't needed on a certain blockchain, don't relay it there, and it won't cost anything.
+

learn/messaging/index.md

@@ -0,0 +1,4 @@
+---
+title: TODO
+description: TODO
+---

learn/messaging/overview.md

@@ -0,0 +1,26 @@
+---
+title: Overview
+description: Discover Wormhole's Messaging features, including cross-chain communication, token and NFT bridges, and the Circle Bridge integration.
+---
+
+# Messaging Overview
+
+The Messaging section covers various aspects and services related to communication protocols and systems within the Wormhole platform. Each subsection provides detailed information on specific components, contracts, and bridges used for messaging and data transfer. Below is a brief overview of each subsection.
+
+## Core Contracts
+
+The Core Contracts form the backbone of Wormhole's cross-chain communication system, allowing for the emission and receipt of messages across different blockchains. Each blockchain in the ecosystem has its own Core Contract, which Guardians observe to ensure the integrity and synchronization of data. These contracts handle message sending, receiving, and multicast, providing a seamless mechanism for inter-chain communication without additional costs.
+
+## NTT (Native Token Transfers)
+_A description will be added here._
+
+## Token and NFT Bridge
+
+The Token and NFT Bridges facilitate cross-chain transfers of both fungible tokens and non-fungible tokens (NFTs). Utilizing a lock and mint mechanism, the bridge ensures secure and efficient asset movement between blockchains. The Token Bridge allows for token transfers with specific receiver details, while the NFT Bridge handles the transfer of unique digital assets with specialized rules for creating wrapped versions on the destination chain.
+
+## CCTP and Circle Bridge
+
+The CCTP and Circle Bridge support fast and cost-effective native USDC transfers across blockchains using Circle's Cross Chain Transfer Protocol (CCTP). While distinct from Wormhole, this protocol is enhanced by Wormhole's features such as automated relaying, gas payment on the destination chain, and native gas dropoff, making it more user-friendly. The integration can be achieved through the Wormhole Connect Widget or the Connect SDK, providing a seamless experience for developers and users.
+
+## Gateway
+_A description will be added here._

learn/messaging/token-nft-bridge.md

@@ -0,0 +1,21 @@
+---
+title: Token and NFT Bridge 
+description: Learn about Wormhole's Token and NFT Bridge for cross-chain transfers using lock and mint mechanisms, ensuring secure and efficient asset movement.
+---
+
+# Token and NFT Bridge
+
+## Token Bridge
+
+!!! note
+    Before a token transfer can be made, the token being transferred must exist as a wrapped asset on the target chain. This is done by [Attesting](#){target=\_blank} the token details on the target chain. <!-- link to VAAs -->
+
+The Token Bridge contract allows token transfers between blockchains through a lock and mint mechanism, using the [Core Contract](/learn/messaging/core-contracts/){target=\_blank} with a specific [payload](#){target=\_blank} to pass information about the transfer. <!--payload links to VAAs page payloads -->
+
+The Token Bridge also supports sending tokens with some additional data in the form of arbitrary byte payload attached to the token transfer. This type of transfer is referred to as a [Contract Controlled Transfer](#){target=\_blank}. <!-- links to VAAs page token + msg  -->
+
+While the [Core Contract](/learn/messaging/core-contracts/){target=\_blank} has no specific receiver by default, transfers sent through the token bridge do have a specific receiver chain and address to ensure the tokens are minted to the expected recipient.
+
+## NFT Bridge
+
+The NFT Bridge functions similarly to the Token Bridge but with special rules for what may be transferred and how the wrapped version is created on the destination chain.