Skip to content

Creates Transfer Wrapped Assets guide #459

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
wants to merge 24 commits into from
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
24 commits
Select commit Hold shift + click to select a range
7abbc0d
wip
eshaben Apr 23, 2025
a690f89
reorganize content to new structure
eshaben Apr 24, 2025
5dc1e37
Merge remote-tracking branch 'origin' into staging-new-ia
eshaben Apr 24, 2025
a149aa9
update llms
eshaben Apr 24, 2025
990adbf
add support for tool selector
eshaben Apr 30, 2025
99c55cc
add logic so the dropdown closes when a user clicks anywhere else on …
eshaben May 1, 2025
66cbbdc
update messaging tutorial .pages file
eshaben May 5, 2025
209f970
move ai resources to a directory
eshaben May 6, 2025
ac88301
Queries - Get Started page (#377)
martin0995 May 6, 2025
02370ff
NTT - Get Started page (#376)
martin0995 May 6, 2025
8c212e0
move tools
eshaben May 9, 2025
7fe8e30
Connect - Get Started page (#375)
dawnkelly09 May 13, 2025
ba6c0da
Messaging - Get Started (#381)
dawnkelly09 May 16, 2025
2d9d111
Queries - Overview (#388)
ilariae May 19, 2025
46a0fe9
Messaging - Overview (#387)
ilariae May 19, 2025
1411849
Multigov - Overview (#397)
ilariae May 19, 2025
cc3b7b9
Pull the latest changes into staging (#404)
eshaben May 19, 2025
2609cea
Multigov - Get Started page (#379)
martin0995 May 19, 2025
086ed52
remove dropdown js used for tools
eshaben May 20, 2025
6c018e6
link fixes (#407)
ilariae May 21, 2025
129ddc0
Typescript SDK - Get Started page (#380)
martin0995 May 21, 2025
50001c0
Token Bridge - Get Started page (#382)
martin0995 May 21, 2025
fa7d609
adding snippets and terminal output, adds transfer steps
dawnkelly09 Jun 10, 2025
5c28a7a
grammarly and llms
dawnkelly09 Jun 10, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ Follow the links below for how-to guides about using Core Contracts and Wormhole
## Simplified Message Flow


Wormhole-deployed relayer support is limited to EVM environments. For a complete list of supported EVM environment blockchains, see the [Supported Networks](/docs/build/start-building/supported-networks/){target=\_blank} page.
Wormhole-deployed relayer support is limited to EVM environments. For a complete list of supported EVM environment blockchains, see the [Supported Networks](/docs/products/reference/supported-networks/){target=\_blank} page.

[timeline(wormhole-docs/.snippets/text/build/core-messaging/core-messaging-timeline.json)]

Expand All @@ -26,14 +26,14 @@ Wormhole-deployed relayer support is limited to EVM environments. For a complete

Follow this series of how-to guides about interacting with Core Contracts to send, receive, and validate messages.

[:custom-arrow: Get started](/docs/build/core-messaging/core-contracts/#prerequisites)
[:custom-arrow: Get started](/docs/products/messaging/guides/core-contracts/#prerequisites)

- :octicons-tools-16:{ .lg .middle } **Get Started with Relayers**

---

Follow this series of how-to guides about using Wormhole-deployed relayers to send, receive, and track the progress of messages.

[:custom-arrow: Get started](/docs/build/core-messaging/wormhole-relayers/#get-started-with-the-wormhole-relayer)
[:custom-arrow: Get started](/docs/products/messaging/guides/wormhole-relayers/#get-started-with-the-wormhole-relayer)

</div>
10 changes: 5 additions & 5 deletions build/multigov/index.md → ..build/multigov/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,39 +25,39 @@ Take the following steps to get started with a MultiGov integration:

Set up and deploy MultiGov on EVM chains with step-by-step instructions for configuring, compiling, and deploying smart contracts across chains.

[:custom-arrow: Discover how to deploy MultiGov](/docs/build/multigov/deploy-to-evm/)
[:custom-arrow: Discover how to deploy MultiGov](/docs/products/multigov/guides/deploy-to-evm/)

- :octicons-rocket-16:{ .lg .middle } **Deploy to Solana**

---

Set up and deploy the MultiGov Staking Program on Solana with step-by-step instructions for configuring, funding, deploying, and initializing the program.

[:custom-arrow: Discover how to deploy MultiGov on Solana](/docs/build/multigov/deploy-to-solana/)
[:custom-arrow: Discover how to deploy MultiGov on Solana](/docs/products/multigov/guides/deploy-to-solana/)

- :octicons-file-code-16:{ .lg .middle } **Upgrade MultiGov on EVM Chains**

---

Learn the process and key considerations for upgrading MultiGov contracts, ensuring system integrity and careful planning across cross-chain components.

[:custom-arrow: Discover how to upgrade MultiGov on EVM Chains](/docs/build/multigov/upgrade-evm/)
[:custom-arrow: Discover how to upgrade MultiGov on EVM Chains](/docs/products/multigov/guides/upgrade-evm/)

- :octicons-file-code-16:{ .lg .middle } **Upgrade MultiGov on Solana**

---

Learn how to upgrade the MultiGov Staking Program on Solana, including updating the program binary, IDL, and more.

[:custom-arrow: Discover how to upgrade MultiGov on Solana](/docs/build/multigov/upgrade-solana/)
[:custom-arrow: Discover how to upgrade MultiGov on Solana](/docs/products/multigov/guides/upgrade-solana/)

- :octicons-question-16:{ .lg .middle } **Technical FAQs**

---

Find answers to common technical questions about MultiGov, covering technical setup, security, proposal creation, and more.

[:custom-arrow: Find the answer to your technical questions](/docs/build/multigov/faq/)
[:custom-arrow: Find the answer to your technical questions](/docs/products/multigov/faqs/)

</div>

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -90,7 +90,7 @@ For example, many chains have implementations forked from [Geth](https://github.

Remember that Wormhole Queries are currently in beta. You can [register to join the beta](https://forms.clickup.com/45049775/f/1aytxf-10244/JKYWRUQ70AUI99F32Q){target=\_blank} to fully experiment with Wormhole Queries.

Be sure to check out the [FAQs](/docs/build/queries/faqs/){target=\_blank} and the [Use Queries guide](/docs/build/queries/use-queries/){target=\_blank}.
Be sure to check out the [FAQs](/docs/products/queries/faqs/){target=\_blank} and the [Use Queries guide](/docs/build/queries/use-queries/){target=\_blank}.

You can also check out the following examples of applications that make use of Wormhole Queries:

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -120,7 +120,7 @@ anvil --fork-url https://ethereum.publicnode.com

In order for mock requests to verify against the Mainnet Core Contract, you need to replace the current Guardian set with the single Devnet key used by the mock.

Here's an example for Ethereum Mainnet, where the `-a` parameter is the [Core Contract address](/docs/build/reference/contract-addresses/#core-contracts){target=\_blank} on that chain.
Here's an example for Ethereum Mainnet, where the `-a` parameter is the [Core Contract address](/docs/products/reference/contract-addresses/#core-contracts){target=\_blank} on that chain.

```jsx
npx @wormhole-foundation/wormhole-cli evm hijack -a 0x98f3c9e6E3fAce36bAAd05FE09d375Ef1464288B -g 0xbeFA429d57cD18b7F8A4d91A2da9AB4AF05d0FBe
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -18,8 +18,8 @@ Enable seamless swaps between chains with real-time liquidity routing.

🛠 **Wormhole products used:**

- [**Wormhole Connect**](/docs/build/transfers/connect/overview/){target=\_blank} – handles user-friendly asset transfers
- [**Native Token Transfer**](/docs/build/transfers/native-token-transfers/){target=\_blank} – moves native assets across chains
- [**Wormhole Connect**](/docs/products/connect/overview/){target=\_blank} – handles user-friendly asset transfers
- [**Native Token Transfer**](/docs/products/native-token-transfers/overview/){target=\_blank} – moves native assets across chains
- [**Queries**](/docs/build/queries/overview/){target=\_blank} – fetches real-time prices for optimal trade execution

🔗 **Used in:** Decentralized exchanges (DEXs) and liquidity aggregators <br>🏗️ **Used by:** [StellaSwap](https://app.stellaswap.com/exchange/swap){target=\_blank}
Expand All @@ -40,8 +40,8 @@ Let users borrow assets on one chain using collateral from another.

🛠 **Wormhole products used:**

- [**Messaging**](/docs/learn/infrastructure/){target=\_blank} – moves loan requests and liquidations across chains
- [**Native Token Transfer**](/docs/build/transfers/native-token-transfers/){target=\_blank} – transfers collateral as native assets
- [**Messaging**](/docs/protocol/infrastructure/){target=\_blank} – moves loan requests and liquidations across chains
- [**Native Token Transfer**](/docs/products/native-token-transfers/overview/){target=\_blank} – transfers collateral as native assets
- [**Queries**](/docs/build/queries/overview/){target=\_blank} – fetches interest rates and asset prices in real-time

🔗 **Used in:** Lending protocols and yield platforms <br>🏗️ **Used by:** [Folks Finance](https://wormhole.com/case-studies/folks-finance){target=\_blank}
Expand All @@ -63,7 +63,7 @@ Fetch price feeds across multiple chains for DeFi applications.
🛠 **Wormhole products used:**

- [**Queries**](/docs/build/queries/overview/){target=\_blank} – fetches price feeds from oracles and trading platforms
- [**Messaging**](/docs/learn/infrastructure/){target=\_blank} – sends signals to execute trades
- [**Messaging**](/docs/protocol/infrastructure/){target=\_blank} – sends signals to execute trades

🔗 **Used in:** Trading bots, arbitrage platforms, and oracles <br>🏗️ **Used by:** [Infinex](https://wormhole.com/case-studies/infinex){target=\_blank}

Expand All @@ -83,7 +83,7 @@ Enable direct BTC transfers without wrapped assets.

🛠 **Wormhole products used:**

- [**Native Token Transfer**](/docs/build/transfers/native-token-transfers/){target=\_blank} – transfers BTC across chains
- [**Native Token Transfer**](/docs/products/native-token-transfers/overview/){target=\_blank} – transfers BTC across chains

🔗 **Used in:** Bitcoin DeFi and lightning network integrations <br>🏗️ **Used by:** [Synonym](https://wormhole.com/case-studies/synonym){target=\_blank}

Expand All @@ -102,7 +102,7 @@ Enable seamless communication and asset transfer across decentralized social net

🛠 **Wormhole products used:**

- [**Messaging**](/docs/learn/infrastructure/){target=\_blank} – facilitates decentralized interactions
- [**Messaging**](/docs/protocol/infrastructure/){target=\_blank} – facilitates decentralized interactions
- [**Token Bridge**](/docs/build/transfers/token-bridge/){target=\_blank} – enables cross-chain tokenized rewards

🔗 **Used in:** Web3 social networks and content monetization <br>🏗️ **Used by:** [Chingari](https://chingari.io/){target=\_blank}
Expand All @@ -123,8 +123,8 @@ Launch and distribute memecoins across multiple chains, enabling cross-chain fun

🛠 **Wormhole products used:**

- [**Native Token Transfer**](/docs/build/transfers/native-token-transfers/){target=\_blank} – enables native asset transfers for seamless fundraising
- [**Messaging**](/docs/learn/infrastructure/){target=\_blank} – facilitates cross-chain token distribution and claim processes
- [**Native Token Transfer**](/docs/products/native-token-transfers/overview/){target=\_blank} – enables native asset transfers for seamless fundraising
- [**Messaging**](/docs/protocol/infrastructure/){target=\_blank} – facilitates cross-chain token distribution and claim processes

🔗 **Used in:** Token launchpads, IDOs, and meme token ecosystems

Expand Down Expand Up @@ -165,8 +165,8 @@ Allow users to pay gas fees with any token across different networks, removing f

🛠 **Wormhole products used:**

- [**Messaging**](/docs/learn/infrastructure/){target=\_blank} – routes gas fee payments across chains
- [**Native Token Transfer**](/docs/build/transfers/native-token-transfers/){target=\_blank} – facilitates native token conversion for gas payments
- [**Messaging**](/docs/protocol/infrastructure/){target=\_blank} – routes gas fee payments across chains
- [**Native Token Transfer**](/docs/products/native-token-transfers/overview/){target=\_blank} – facilitates native token conversion for gas payments

🔗 **Used in:** Wallets, dApps, and multichain user experience improvements

Expand All @@ -186,7 +186,7 @@ Provide developers with a library of bridging intents and automation functions,

🛠 **Wormhole products used:**

- [**Messaging**](/docs/learn/infrastructure/){target=\_blank} – enables predefined cross-chain actions and triggers.
- [**Messaging**](/docs/protocol/infrastructure/){target=\_blank} – enables predefined cross-chain actions and triggers.
- [**Wormhole Settlement**](/docs/learn/transfers/settlement/overview/){target=\_blank} - provides a framework for executing user-defined bridging intents

🔗 **Used in:** Bridging protocols, DeFi automation, and smart contract libraries
Expand Down Expand Up @@ -228,8 +228,8 @@ Allow merchants and platforms to accept payments in any token, auto-converting t

🛠 **Wormhole products used:**

- [**Wormhole Connect**](/docs/build/transfers/connect/overview/){target=\_blank} – facilitates seamless payments in various tokens
- [**Native Token Transfer**](/docs/build/transfers/native-token-transfers/){target=\_blank} – ensures direct, native asset transfers
- [**Wormhole Connect**](/docs/products/connect/overview/){target=\_blank} – facilitates seamless payments in various tokens
- [**Native Token Transfer**](/docs/products/native-token-transfers/overview/){target=\_blank} – ensures direct, native asset transfers

🔗 **Used in:** E-commerce, Web3 payments, and subscription models

Expand All @@ -250,7 +250,7 @@ Fetch and verify cross-chain data, enabling reliable, decentralized Oracle servi
🛠 **Wormhole products used:**

- [**Queries**](/docs/build/queries/overview/){target=\_blank} – fetches data from multiple chains and Oracle providers
- [**Messaging**](/docs/learn/infrastructure/){target=\_blank} – ensures tamper-proof data relay across networks
- [**Messaging**](/docs/protocol/infrastructure/){target=\_blank} – ensures tamper-proof data relay across networks

🔗 **Used in:** Price feeds, DeFi protocols, and smart contract automation <br>🏗️ **Used by:** [Pyth](https://wormhole.com/case-studies/pyth){target=\_blank}

Expand All @@ -270,8 +270,8 @@ Enable users to stake assets on one chain while earning rewards or securing netw

🛠 **Wormhole products used:**

- [**Messaging**](/docs/learn/infrastructure/){target=\_blank} – moves staking rewards and governance signals across chains
- [**Native Token Transfer**](/docs/build/transfers/native-token-transfers/){target=\_blank} – transfers staked assets natively between networks
- [**Messaging**](/docs/protocol/infrastructure/){target=\_blank} – moves staking rewards and governance signals across chains
- [**Native Token Transfer**](/docs/products/native-token-transfers/overview/){target=\_blank} – transfers staked assets natively between networks

🔗 **Used in:** Liquid staking, cross-chain governance, and PoS networks <br>🏗️ **Used by:** [Lido](https://lido.fi/){target=\_blank}

Expand Down
File renamed without changes.
8 changes: 4 additions & 4 deletions build/toolkit/dev-env.md → ..build/toolkit/dev-env.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ Developers building for smart contract integration will want to set up a develop

## Tooling Installation

The [Wormhole CLI Tool](/docs/build/toolkit/cli/){target=\_blank} should be installed regardless of the environments chosen. Each environment has its own set of recommended tools. To begin working with a specific environment, see the recommended tools on the respective [environment page](/docs/build/start-building/supported-networks/){target=\_blank}.
The [Wormhole CLI Tool](/docs/build/toolkit/cli/){target=\_blank} should be installed regardless of the environments chosen. Each environment has its own set of recommended tools. To begin working with a specific environment, see the recommended tools on the respective [environment page](/docs/products/reference/supported-networks/){target=\_blank}.

## Development Stages

Expand All @@ -28,7 +28,7 @@ Relying on native tools when possible allows for more rapid prototyping and iter

### Integration

For integration to Wormhole and with multiple chains, the simplest option is to use the chains' Testnets. In choosing which chains to use for integration testing, consider which chains in a given environment provide easy access to Testnet tokens and where block times are fast. Find links for Testnet faucets in the [blockchain details section](/docs/build/start-building/supported-networks/){target=\_blank}. A developer may prefer standing up a set of local validators instead of using the Testnet. For this option, [Tilt](https://github.com/wormhole-foundation/wormhole/blob/main/DEVELOP.md){target=\_blank} is available to run local instances of all the chains Wormhole supports.
For integration to Wormhole and with multiple chains, the simplest option is to use the chains' Testnets. In choosing which chains to use for integration testing, consider which chains in a given environment provide easy access to Testnet tokens and where block times are fast. Find links for Testnet faucets in the [blockchain details section](/docs/products/reference/supported-networks/){target=\_blank}. A developer may prefer standing up a set of local validators instead of using the Testnet. For this option, [Tilt](https://github.com/wormhole-foundation/wormhole/blob/main/DEVELOP.md){target=\_blank} is available to run local instances of all the chains Wormhole supports.

!!! note
Variation in host environments causes unique issues, and the computational intensity of multiple simultaneous local validators can make setting them up difficult or time-consuming. You may prefer Testnets for the simplest integration testing.
Expand All @@ -46,15 +46,15 @@ If you'd like to set up a local validator environment, follow the setup guide fo

### Testnet

When doing integration testing on Testnets, remember that a single Guardian node is watching for transactions on various test networks. Because Testnets only have a single Guardian, there's a slight chance that your VAAs won't be processed. This rate doesn't indicate performance on Mainnet, where 19 Guardians are watching for transactions. The Testnet contract addresses are available on the page for each [environment](/docs/build/start-building/supported-networks/){target=\_blank}. The [Wormholescan API](https://docs.wormholescan.io){target=\_blank} offers the following Guardian equivalent Testnet endpoint:
When doing integration testing on Testnets, remember that a single Guardian node is watching for transactions on various test networks. Because Testnets only have a single Guardian, there's a slight chance that your VAAs won't be processed. This rate doesn't indicate performance on Mainnet, where 19 Guardians are watching for transactions. The Testnet contract addresses are available on the page for each [environment](/docs/products/reference/supported-networks/){target=\_blank}. The [Wormholescan API](https://docs.wormholescan.io){target=\_blank} offers the following Guardian equivalent Testnet endpoint:

```text
https://api.testnet.wormholescan.io
```

### Mainnet

The Mainnet contract addresses are available on the page for each [environment](/docs/build/start-building/supported-networks/){target=\_blank}. The [Wormholescan API](https://docs.wormholescan.io){target=\_blank} offers the following Guardian equivalent Mainnet endpoint:
The Mainnet contract addresses are available on the page for each [environment](/docs/products/reference/supported-networks/){target=\_blank}. The [Wormholescan API](https://docs.wormholescan.io){target=\_blank} offers the following Guardian equivalent Mainnet endpoint:

```text
https://api.wormholescan.io
Expand Down
2 changes: 1 addition & 1 deletion build/toolkit/faqs.md → ..build/toolkit/faqs.md
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,7 @@ To manually submit a VAA (Verifiable Action Approval) to a destination chain, fo

3. **Submit the VAA through Etherscan (for EVM chains)** - once the VAA is in hex format, go to the [Etherscan UI](https://etherscan.io/){target=\_blank} and submit it through the [`TokenBridge`](https://github.com/wormhole-foundation/wormhole-solidity-sdk/blob/main/src/interfaces/ITokenBridge.sol){target=\_blank} contract’s method (such as the `CompleteTransfer` function or `CompleteTransferWithPayload`)

- The `TokenBridge` contract addresses for each chain are available in the [Wormhole contract addresses](/docs/build/reference/contract-addresses/){target=\_blank} section
- The `TokenBridge` contract addresses for each chain are available in the [Wormhole contract addresses](/docs/products/reference/contract-addresses/){target=\_blank} section

- Interact with the smart contract through the Etherscan UI by pasting the hex-encoded VAA into the appropriate field

Expand Down
Loading