Coral V2

Overview

Coral V2 is the latest version of Squid's intent-based protocol, extending cross-chain swap support to non-EVM chains while simplifying the developer experience.

What's New in Coral V2

• Expanded EVM Chain Support: Coral V2 supports a wider range of EVM chains including Hedera, Citrea, XRPL EVM, and more. Bitcoin and Solana support is coming soon.

• No Route Expiry: Unlike Coral V1's ~25 second expiry window, Coral V2 routes do not expire. You can submit your transaction at any time after receiving a route.

• 15-Minute Refunds: If a transaction fails, funds are automatically refunded on the source chain within approximately 15 minutes.

• Status Polling Required: After executing a Coral V2 transaction, you must call the status API with the quoteId parameter. A Coral V2 transaction will fail unless status is called with quoteId.

• Integrator Fee Support: Coral V2 supports integrator fees (unlike Coral V1).

How It Works

Coral V2 uses the same /v2/route endpoint as all Squid transactions. For EVM-to-EVM swaps, the flow is identical to a standard Squid integration — request a route, execute it, and poll for status.

The route response's transactionRequest object will include a transaction_request_type field that indicates how to execute:

• "ON_CHAIN_EXECUTION" — standard on-chain transaction (EVM)

• "DEPOSIT_ADDRESS_CALLDATA" — submit a deposit to the provided address with the specified calldata (non-EVM)

• "DEPOSIT_ADDRESS_WITH_SIGNATURE" — submit a signed deposit to the provided address (non-EVM)

Getting Coral V2 Enabled

Coral V2 is not enabled by default. To get started:

1. If you don't already have a Squid integration, apply for an integrator ID

2. Contact the Squid team to enable Coral V2 on your integrator ID

3. Follow the Integrating Coral V2 guide

Widget Users: Coral V2 requires @0xsquid/widget version 6.5.0 or newer. Please ensure your widget is updated before enabling Coral V2.

Supported Chains

Coral V2 currently supports the following chains:

EVM Chains: Celo, BNB Chain, Citrea, Peaq, HyperEVM, Avalanche, Optimism, Arbitrum, Linea, Berachain, Polygon, Gnosis, Base, Sonic, Hedera, XRPL EVM, Soneium, Blast

Coming Soon: Bitcoin, Solana

For a full comparison of chain support across all bridge types (Axelar, Coral V1, Coral V2), see the Coral Overview.

Key Differences from Coral V1

	Coral V1	Coral V2
Chain Support	EVM only	EVM (including Hedera, Citrea, XRPL EVM) + BTC & SOL coming soon
Route Expiry	~25 second window	No expiry
Refund Timing	~1 hour	~15 minutes
Status quoteId	Optional	Required
Non-EVM Flow	N/A	Deposit address flow