Overview
Native Token Transfers Overview#
Native Token Transfers (NTT) provides an adaptable framework for transferring your native tokens across different blockchains. Unlike traditional wrapped assets, NTT maintains your token's native properties on every chain. This ensures that you retain complete control over crucial aspects, such as metadata, ownership, upgradeability, and custom features.
Key Features#
- Control and customization: Ensure ownership and configurable access controls, permissions, and thresholds, preventing unauthorized calls.
- Advanced rate limiting: Set rate limits per chain and period to prevent abuse, manage network congestion, and control deployments.
- Global accountant: Ensures the amount burned and transferred on chains never exceeds the amount of tokens minted.
- No wrapped tokens: Tokens are used directly within their native ecosystem, eliminating intermediary transfer steps.
Deployment Models#
NTT offers two operational modes for your existing tokens:
- Hub-and-spoke: Locks tokens on a central "hub" chain and mints equivalents on "spoke" chains, maintaining the total supply on the hub. It's ideal for integrating existing tokens onto new blockchains without altering their original contracts.
- Burn-and-mint: Burns tokens on the source chain and mints new ones on the destination, distributing the total supply across multiple chains. It's best suited for new token deployments or projects willing to upgrade existing contracts for a truly native multichain token.
Supported Token Standards#
Native Token Transfers (NTT) primarily support ERC-20 tokens, the most widely used standard for fungible assets on Ethereum and other EVM-compatible chains, including ERC-20 Burnable tokens, which can be burned on the source chain during cross-chain transfers when required. It also supports fungible SPL tokens on Solana for secure cross-chain transfers.
The NttManager is a contract that oversees the secure and reliable transfer of native tokens across supported blockchains. It leverages the standard IERC20 interface and OpenZeppelin’s SafeERC20 library to interact with these tokens securely across chains.
NTT does not currently support token standards like ERC-721 (non-fungible tokens), ERC-1155 (a multi-token standard), or SPL-based tokens, such as Metaplex NFTs. Support is currently limited to ERC-20 tokens.
Deployment Process#
Here's a breakdown of the key steps involved when deploying NTT:
- Prepare tokens: Ensure your ERC-20 or SPL tokens are ready.
- Choose deployment model: Choose your cross-chain token model: either burn-and-mint or hub-and-spoke.
- Choose deployment tool: Use the NTT Launchpad (for EVM chains only) or the NTT CLI.
- Initialization: Specify target chains and token details, and set up your CLI environment if using it.
- Deploy contracts: Deploy NTT Manager contracts to all selected chains, confirming transactions and covering gas fees.
- Finalize configurations: Grant minting authority, configure rate limits, establish peer manager connections, and assign administrative roles.
- Monitor and maintain: Verify deployment, monitor total supply with the Global Accountant, and adjust configurations as needed.
Use Cases#
-
Cross-Chain Swaps and Liquidity Aggregation
- Native Token Transfers: Transmits native assets across chains.
- Connect: Manages user-friendly asset transfers.
- Queries: Acquires real-time prices for optimal trade execution.
-
Borrowing and Lending Across Chains
- Native Token Transfers: Moves collateral as native assets.
- Messaging: Propagates loan requests and liquidations across chains.
- Queries: Retrieves interest rates and asset prices in real-time.
-
Gas Abstraction
- Native Token Transfers: Facilitates native token conversion for gas payments.
- Messaging: Sends gas fee payments across chains.
-
Cross-Chain Payment Widgets
- Native Token Transfers: Ensures direct, native asset transfers.
- Connect: Facilitates seamless payments in various tokens.
-
Cross-Chain Staking
- Native Token Transfers: Transfers staked assets natively between networks.
- Messaging: Moves staking rewards and governance signals across chains.
Next Steps#
Follow these steps to get started with NTT:
Start your journey with Wormhole's NTT by learning to install its CLI, deploy test tokens, and set up it's initial structure for seamless token movement.
Deploy NTT
Use these resources to deploy NTT across supported chains:
→ Deploy to EVM
→ Deploy to EVM Chains via Launchpad
→ Deploy to Solana
Customize NTT
Configure crucial operational and security settings for NTT:
→ Access control
→ Rate limits