wormhole

Implement cross-chain messaging and token transfers using Wormhole NTT, VAAs, and relayers.

6|20|Updated Mar 14, 2026
One-click install
npx skills add https://github.com/andresdefi/cryptoskills --skill wormhole-andresdefi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wormhole
Source: https://github.com/andresdefi/cryptoskills/tree/main/skills/wormhole
Command: npx skills add https://github.com/andresdefi/cryptoskills --skill wormhole-andresdefi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? AI agents frequently produce incorrect Wormhole integrations: confusing NTT with the legacy Token Bridge, mixing up Wormhole chain IDs with EVM chain IDs, hardcoding guardian sets, or forgetting that publishMessage() does not deliver messages. This Skill provides verified contract addresses, correct chain ID mappings, and working code patterns for cross-chain messaging and token transfers across Ethereum, Solana, Arbitrum, Base, and Optimism. ## Core Features & Use Cases - Cross-Chain Messaging: Publish messages via the Core Bridge, fetch signed VAAs from the Guardian network, and verify them on destination chains with replay protection and emitter validation. - NTT (Native Token Transfers): Deploy burn/mint canonical token transfers with NttManager, Transceiver setup, bidirectional peer registration, and configurable rate limiting. - Standard Relayer & Queries: Automate VAA delivery with gas-budgeted relaying, and execute cross-chain reads via Wormhole Queries without spending gas on target chains. - Use Case: Deploy an ERC-20 token on Ethereum and Arbitrum, configure NTT peers with rate limits, set the NttManager as minter, and execute a test transfer that burns tokens on Ethereum and mints them natively on Arbitrum. ## Quick Start Ask the agent to send a cross-chain message from Ethereum to Arbitrum using the Wormhole Core Bridge and fetch the signed VAA for verification.

Frequently Asked Questions about wormhole

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I send a cross-chain message with Wormhole?

Call publishMessage() on the Core Bridge contract with your payload, a nonce, and a consistency level, paying the dynamic messageFee(). Then fetch the signed VAA from the Wormholescan API and submit it to the destination chain's Core Bridge for verification via parseAndVerifyVM.

What is the difference between Wormhole NTT and the Token Bridge?

NTT burns tokens on the source chain and mints canonical tokens on the destination, preserving full decimal precision and requiring token contract ownership. The Token Bridge locks tokens and mints wrapped representations, truncating amounts to 8 decimals, and works with third-party tokens.

Why does my Wormhole message go to the wrong chain?

Wormhole uses its own chain ID scheme separate from EVM chain IDs. Ethereum is Wormhole ID 2 (not 1), Arbitrum is 23 (not 42161), and Optimism is 24 (not 10). Using EVM chain IDs routes messages to the wrong chain or causes reverts.

Why is my VAA not available after calling publishMessage?

With consistencyLevel 15 on Ethereum, Guardians wait for 15 block confirmations before signing, taking roughly 13-15 minutes total. Also verify the transaction succeeded and that you query the correct emitter address, which is the calling contract, not your EOA.

Can I read contract state on another chain without sending a transaction?

Yes, Wormhole Queries let Guardians execute eth_call on a remote chain and return a signed response without spending gas on the target chain. Supported query types include EthCallQueryRequest, timestamp-based reads, and finality-guaranteed reads.

What happens when an NTT transfer exceeds the rate limit?

If shouldQueue is true, the transfer enters a queue and completes automatically when the rate limit window replenishes. If shouldQueue is false, the transfer reverts with RateLimitExceeded. Both inbound and outbound limits are configurable per peer chain.