Migration GuidesNon-EVM and Prefills

Breaking Changes for API Users

Required parameter changes for deposit transactions after the non-EVM migration.

API users and integrators must update their deposit transaction construction to include new parameters returned by the /suggested-fees endpoint.

Implementation began January 23, 2025. Full deprecation of old functions by April 1, 2025.

Required API Changes

The /api/suggested-fees endpoint now returns three parameters that must be included in your deposit or depositV3 transactions:

ParameterDescription
exclusiveRelayerAddress of the relayer with exclusive fill rights
exclusivityDeadlineUnix timestamp when exclusivity expires
fillDeadlineUnix timestamp by which the deposit must be filled

These values must be passed through to the deposit transaction exactly as returned by the API.

use-api-params.ts
const fees = await fetch(
  `https://app.across.to/api/suggested-fees?${params}`
).then((r) => r.json());

// These MUST be included in your deposit transaction
const { exclusiveRelayer, exclusivityDeadline, fillDeadline } = fees;

Deprecated Functions

Two deposit functions are being phased out:

FunctionStatus
deposit() (original version)Deprecated — removed from contract ABIs
depositFor() (original version)Deprecated — removed from contract ABIs

These functions are not guaranteed to work after April 1, 2025. Migrate to the new deposit function (distinct from the deprecated version) which provides all the functionality of depositV3 with future support for non-EVM chain deposits.

Instead of independently indexing Across events, adopt the /deposit/status endpoint for tracking. It has approximately 60-second latency and is simpler to integrate than event indexing.

On this page