WrapfiDocumentation

LayerZero

Wrapfi uses LayerZero V2 OFT messaging to move mint and burn instructions between Ethereum and Robinhood Chain. The app tracks message status through LayerZero Scan.

Endpoint IDs

  • Ethereum mainnet: 30101
  • Robinhood Chain mainnet: 30416

DVN configuration

Live bridge messages require two DVNs to verify delivery: LayerZero Labs and Nethermind. BitGo was removed from the required set after investigation showed its DVN was dormant on Robinhood Chain for weeks, which caused wraps to stall at partial verification.

Forward looking fix only

Replacing BitGo with Nethermind fixes future messages. It does not guarantee that messages already stuck before the change will automatically complete. Treat any in flight test amount from before the DVN swap as potentially stuck.

What you see in the app

  • Wrap and unwrap transactions show LayerZero message progress
  • The Transactions page links to LayerZero Scan for detailed status
  • Network fee on wrap is quoted from the adapter before you confirm

Common stuck states

If a message shows partial DVN verification for a long time, check that you interacted with wired adapter and OFT contracts from the Contracts page. Also confirm the required DVN set on both chains still matches LayerZero Labs plus Nethermind.

Operational debugging

For detailed recovery steps, see the LAYERZERO.md file in the repository root. It covers nonce issues, DVN liveness checks, and explorer based investigation workflows.