wormhole

Implement Wormhole cross-chain messaging, NTT token transfers, and Guardian-signed VAA verification.

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

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, and forgetting that publishMessage() only emits an event without delivering it. This Skill provides verified contract addresses, correct chain ID mappings, and working code patterns for cross-chain messaging and token transfers. ## 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. - NTT (Native Token Transfers): Deploy burn/mint canonical token transfers with NttManager, Transceiver setup, peer registration, and rate limiting across Ethereum, Arbitrum, Base, Optimism, and Solana. - Wormhole Queries & Standard Relayer: Execute gas-free cross-chain reads via Guardian-signed queries and automate VAA delivery with the Standard Relayer. - Use Case: Deploy an ERC-20 token on Ethereum and Arbitrum, configure NTT peers bidirectionally, set rate limits, 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 verify the resulting VAA on the destination chain.

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 and a consistency level, paying the messageFee(). Then fetch the signed VAA from the Wormholescan API and submit it to the destination chain's Core Bridge via parseAndVerifyVM, or use the Standard Relayer for automatic delivery.

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 you to control the token contract. 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, so the full process takes roughly 13-15 minutes. Also verify the transaction succeeded and that you are querying with 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, with optional on-chain verification.

What happens when an NTT transfer exceeds the rate limit?

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