move files around for tutorials reorg

build/contract-integrations/.pages

@@ -3,9 +3,8 @@ nav:
  - index.md
  - 'Wormhole Relayer': 'wormhole-relayers.md'
  - 'Core Contracts': 'core-contracts.md'
- # - 'Token Bridge': 'token-bridge.md'
+ - 'Token Bridge': 'token-bridge.md'
  - 'CCTP': 'cctp.md'
  - native-token-transfers
  - multigov
  - 'Development Environment': 'dev-env.md'
- - 'FAQs': 'faqs.md'

build/contract-integrations/wormhole-relayers.md

@@ -138,4 +138,4 @@ See the [Wormhole CLI tool docs](/docs/build/toolkit/cli/) for installation and
 
 ## Step-by-Step Tutorial
 
-For detailed, step-by-step guidance on creating cross-chain contracts that interact with the Wormhole relayer, refer to the [Create Cross-Chain Contracts](/docs/tutorials/messaging/cross-chain-contracts/) tutorial.
+For detailed, step-by-step guidance on creating cross-chain contracts that interact with the Wormhole relayer, refer to the [Create Cross-Chain Contracts](/docs/tutorials/by-product/cross-chain-contracts/cross-chain-contracts/) tutorial.

build/toolkit/solidity-sdk.md

@@ -162,5 +162,5 @@ The SDK includes built-in support for Forge-based testing, which allows you to t
 
 For a detailed example, check out the below repositories:
 
- - [Cross chain messaging](/docs/tutorials/messaging/cross-chain-contracts/){target=\_blank}
- - [Cross chain token transfer](/docs/tutorials/messaging/cross-chain-token-contracts/){target=\_blank}
+ - [Cross chain messaging](/docs/tutorials/by-product/cross-chain-contracts/cross-chain-contracts/){target=\_blank}
+ - [Cross chain token transfer](/docs/tutorials/by-product/cross-chain-contracts/cross-chain-token-contracts/){target=\_blank}

learn/governance/index.md

@@ -63,7 +63,7 @@ Discover everything you need to know about MultiGov, Wormhole's cross-chain gove
 
     Access step-by-step guides for executing cross-chain governance actions, including treasury management proposals with MultiGov and Wormhole.
 
-    [:octicons-arrow-right-16: Create MultiGov solutions](/docs/tutorials/multigov/)
+    [:octicons-arrow-right-16: Create MultiGov solutions](/docs/tutorials/by-product/multigov/)
 
 -   :octicons-question-16:{ .lg .middle } **Technical FAQs**
 

learn/messaging/token-nft-bridge.md

@@ -0,0 +1,71 @@
+---
+title: Token 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
+
+Transferring tokens across blockchain networks is challenging due to the lack of interoperability. Maintaining token properties such as value, name, and precision while ensuring security during transfers often requires complex and costly solutions like liquidity pools or native swaps, which can introduce inefficiencies and risks.
+
+Wormhole's Token Bridge addresses these challenges by providing a decentralized protocol for seamless cross-chain token transfers through a lock-and-mint mechanism. Using Wormhole's message-passing protocol, the Token Bridge allows standards-compliant tokens, like ERC-20 on Ethereum or SPL on Solana, to be transferred between blockchains while preserving their original attributes.
+
+Offering a more efficient, scalable, and secure alternative to traditional solutions, the Token Bridge ensures that assets retain their properties across multiple blockchain ecosystems. Additionally, it supports flexible features like [Contract Controlled Transfers](/docs/learn/infrastructure/vaas/#token-transfer-with-message){target=\_blank}, enabling custom interactions by allowing tokens to carry additional data for smart contract integration on the destination chain.
+
+This page introduces the core concepts and functions of Wormhole's Token Bridge, explaining how it operates, its key features, and how it enables secure and efficient cross-chain token transfers.
+
+### How Does It Work?
+
+At the core of the Token Bridge lies the lock-and-mint mechanism, which uses the [Core Contract](/docs/learn/infrastructure/core-contracts/){target=\_blank} with a specific [payload](/docs/learn/infrastructure/vaas/#token-transfer){target=\_blank} to pass information about the transfer. Tokens on the source chain are locked, and wrapped tokens are minted on the destination chain. This approach guarantees that token transfers are secure and consistent, ensuring that token properties such as name, symbol, and decimal precision are preserved across chains.
+
+Before you can transfer a token to a new chain, the token's metadata must be [attested](/docs/learn/infrastructure/vaas/#attestation){target=\_blank}. This process registers the token details (such as decimals and symbol) on the destination chain, enabling the creation of wrapped assets.
+
+While the [Core Contract](/docs/learn/infrastructure/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.
+
+In addition to standard token transfers, the Token Bridge supports [Contract Controlled Transfers](/docs/learn/infrastructure/vaas/#token-transfer-with-message){target=\_blank}. This functionality allows users to attach additional data to token transfers, enabling more complex interactions with smart contracts on the destination chain. For instance, a token transfer can include a payload that triggers specific actions, such as interacting with a decentralized exchange (DEX) or automated market maker (AMM).
+
+### Token Transfer Flow
+
+The transfer process is simple yet secure, involving a few key steps:
+
+1. **Attestation** - first, a token's metadata is attested on the source chain, ensuring that its properties are consistent across chains
+2. **Locking** - on the source chain, the native token is locked in a custody account
+3. **Message emission** - a message detailing the transfer is sent through Wormhole's Guardian Network, which verifies the transfer and signs the message
+4. **Verification and minting** - on the destination chain, the transfer message is verified, and wrapped tokens are minted, or native tokens are released from custody
+
+![Token Bridge detailed flow](/docs/images/learn/messaging/token-bridge/token-bridge-diagram.webp)
+
+### Key Features of the Token Bridge
+
+The Token Bridge creates wrapped versions when tokens are transferred to a different chain. These wrapped assets represent the locked tokens on the source chain and allow users to interact with them on the destination chain. This mechanism ensures seamless functionality without needing liquidity pools or native token swaps.
+
+The Token Bridge employs a universal token representation compatible with various virtual machine (VM) data types. This allows the tokens to interact with decentralized applications (dApps) across different chains without issues related to differing token standards.
+
+### Message and Payload Structure
+
+To facilitate cross-chain communication, the Token Bridge uses specialized payloads that carry the necessary information for token transfers and attestations. These payloads ensure that the correct tokens are minted or unlocked on the destination chain.
+
+- `Transfer` - this payload initiates the transfer of tokens, either by minting wrapped tokens or releasing locked tokens
+- `TransferWithPayload` - in addition to transferring tokens, this payload carries additional data, allowing integration with smart contracts or dApps on the target chain
+- `AssetMeta` - before a token can be transferred for the first time, this payload is used to attest to the token's metadata, including decimals, symbol, and name
+- `RegisterChain` - register the Token Bridge contract (emitter address) for a foreign chain
+- `UpgradeContract` - upgrade the contract
+
+Each payload type is designed to serve a specific function in the token transfer process, ensuring that the bridge operates efficiently and securely.
+
+One of the key challenges in cross-chain token transfers is maintaining the correct token precision. The Token Bridge addresses this using the `AssetMeta` payload to store token metadata. Before transferring a token to a new chain, metadata such as its decimal precision, name, and symbol must be attested. The bridge ensures token amounts are truncated to a maximum of 8 decimals, guaranteeing compatibility with chains that may not support higher decimal precision. For example, an 18-decimal token on Ethereum will be represented with only eight decimals on the destination chain, simplifying integration with various decentralized applications.
+
+### Security and Authorization
+
+The Token Bridge uses an emitter chain and address authorization system to verify the validity of messages. Each Token Bridge endpoint is registered on its respective chain, ensuring only trusted contracts can send or receive transfer messages.
+
+The [Wormhole Guardian Network](/docs/learn/infrastructure/guardians/#guardian-network){target=\_blank} plays a critical role in verifying each transfer and ensuring that the message is signed and relayed securely between chains.
+
+### Portal Bridge
+
+A real-world example of Wormhole's Token Bridge in action is the [Portal Bridge](https://portalbridge.com/){target=\_blank}, which provides users with a simple interface to transfer tokens across multiple blockchains. Using the Wormhole infrastructure, Portal Bridge guarantees secure and seamless cross-chain transfers, making it easier for users to move assets between different blockchain ecosystems.
+
+## 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.

tutorials/.pages

@@ -1,5 +1,5 @@
 title: Tutorials
 nav:
  - index.md
- - messaging
- - multigov
+ - by-product
+# - end-to-end

tutorials/by-product/.pages

@@ -0,0 +1,8 @@
+title: Tutorials by Product
+nav:
+ - index.md
+ - connect
+ - cross-chain-contracts
+ - native-token-transfers
+ - multigov
+ - wormhole-sdk

tutorials/by-product/connect/.pages

@@ -0,0 +1,4 @@
+title: Connect
+nav:
+ - index.md
+ - 'Integrate Connect into a React DApp': react-dapp.md

tutorials/by-product/connect/index.md

@@ -0,0 +1,34 @@
+---
+title: Wormhole Connect Tutorials
+description: Enable cross-chain connectivity with Wormhole Connect. Learn integration and simplify user experiences across multiple blockchains.
+---
+
+# Connect Tutorials
+
+Wormhole Connect makes it simple to link your application to multiple blockchain ecosystems. These tutorials will teach you how to integrate Connect into your projects, streamline cross-chain interactions, simplify user onboarding, and deliver a smoother overall experience.
+
+<div class="grid cards" markdown>
+
+-   :octicons-repo-16:{ .lg .middle } **Integrate Connect into a React DApp**
+
+    ---
+
+    Learn how to incorporate Wormhole Connect into a React application. This step-by-step tutorial guides you through enabling cross-chain token transfers and interactions, bridging assets between networks, and enhancing the user experience with streamlined blockchain connectivity.
+
+    [:octicons-arrow-right-16: Start building](/docs/tutorials/by-product/connect/react-dapp/)
+
+</div>
+
+## Additional Resources
+
+<div class="grid cards" markdown>
+
+-   :octicons-tools-16:{ .lg .middle } **Connect**
+
+    ---
+
+    Get deeper insights into setting up and customizing Wormhole Connect. Explore advanced guides, best practices, and configuration tips to streamline your cross-chain integrations.
+
+    [:octicons-arrow-right-16: Start building](/docs/build/applications/connect/)
+
+</div>

tutorials/messaging/sui-connect.md → tutorials/by-product/connect/react-dapp.md

@@ -1,9 +1,11 @@
 ---
-title: Transfer Tokens Cross-Chain with Connect
+title: Integrate Connect into a React DApp Tutorial
 description: Learn how to use Wormhole Connect to transfers tokens cross-chain seamlessly between Sui and Avalanche Fuji with this step-by-step guide.
 ---
 
-# Cross-Chain Token Transfers with Wormhole Connect
+# Integrate Connect into a React DApp
+
+:simple-github: [Source code on GitHub](https://github.com/wormhole-foundation/demo-basic-connect){target=\_blank}
 
 ## Introduction
 
@@ -127,38 +129,38 @@ To transfer tokens from Sui to Fuji in the Wormhole Connect interface:
 2. Choose **Fuji** as the destination network and connect your wallet with the Fuji network
 3. Enter the amount of SUI tokens you wish to transfer
 
-    ![](/docs/images/tutorials/connect/connect-1.webp)
+    ![](/docs/images/tutorials/by-product/connect/react-dapp/connect-1.webp)
 
 4. Choose to view other routes 
 
-    ![](/docs/images/tutorials/connect/connect-2.webp)
+    ![](/docs/images/tutorials/by-product/connect/react-dapp/connect-2.webp)
 
 5. Select the manual bridge option, which will require two transactions: one on the source chain (Sui) and one on the destination chain (Fuji)
 
     !!! note
         It is recommended to use the manual bridge option for this tutorial. The automatic bridge feature is currently undergoing improvements, while the manual bridge ensures that transfers complete successfully.
 
-    ![](/docs/images/tutorials/connect/connect-3.webp)
+    ![](/docs/images/tutorials/by-product/connect/react-dapp/connect-3.webp)
 
 6. Review and confirm the transfer on Sui. This will lock your tokens on the Sui chain
 
-    ![](/docs/images/tutorials/connect/connect-4.webp)
+    ![](/docs/images/tutorials/by-product/connect/react-dapp/connect-4.webp)
 
 7. Follow the on-screen prompts to approve the transaction. You will be asked to sign with your Sui wallet
 
-    ![](/docs/images/tutorials/connect/connect-5.webp)
+    ![](/docs/images/tutorials/by-product/connect/react-dapp/connect-5.webp)
 
 Once the transaction has been submitted, Wormhole Connect will display the progress of the transfer. Monitor the status until you’re prompted to complete the transaction on the destination chain. You can also track your transactions on [Wormholescan](https://wormholescan.io/#/?network=Testnet){target=\_blank}.
 
 ## Claim Tokens on Fuji
 
 After the Sui transaction is complete, confirm the final transaction on Fuji by claiming the wrapped tokens. You will be asked to confirm the transaction with your Fuji wallet.
 
-![](/docs/images/tutorials/connect/connect-6.webp)
+![](/docs/images/tutorials/by-product/connect/react-dapp/connect-6.webp)
 
 Once confirmed, check your Fuji wallet to verify that the wrapped SUI tokens have been successfully received.
 
-![](/docs/images/tutorials/connect/connect-7.webp)
+![](/docs/images/tutorials/by-product/connect/react-dapp/connect-7.webp)
 
 ## Resources
 

tutorials/by-product/cross-chain-contracts/.pages

@@ -0,0 +1,5 @@
+title: Cross-Chain Contracts
+nav:
+ - index.md
+ - 'Create Messaging Contracts': 'cross-chain-contracts.md'
+ - 'Create Token Transfer Contracts': 'cross-chain-token-contracts.md'