What is an Intent?

A signed Request For Funds describing sources, destination, and fees — filled by solvers on the destination chain.

An intent is a user's request to receive funds on a destination chain, paid for with tokens they hold on one or more source chains. In Nexus, an intent is a Request For Funds (RFF): a single structured message describing the sources, the destination, and the fees. The user signs this message once (an EIP-191 signature) — no per-chain bridging, no chain switching. The signed RFF is submitted to the Nexus network, the user's funds are deposited into Vault contracts on each source chain, and a solver fills the request by delivering funds on the destination chain.

What does an Intent look like?

The following information is part of an intent:

Selected Sources: The chains and tokens the funds will be drawn from, and how much from each.
Available Sources: Everywhere the user could source funds from, so your UI can offer alternatives.
Destination: The chain, token, and amount the user will receive.
Fees: The CA gas fee (for cross-chain operations), protocol fee, solver fee, and the total.
Sources Total: The full amount drawn from source chains, combining the transaction amount and all fees.
Provider: Whether the route is served by the native Nexus flow (nexus) or by Mayan (mayan), a third-party bridge provider. The SDK selects this automatically.

This is a simplified view of the BridgeIntent object the SDK passes to your onIntent hook — see the full type for every field:

type BridgeIntent = {
  provider: 'nexus' | 'mayan';
  selectedSources: {
    amount: string;
    amountRaw: bigint;
    chain: { id: number; name: string; logo: string };
    token: { decimals: number; symbol: string; logo: string; contractAddress: `0x${string}` };
    value: string; // USD value
  }[];
  availableSources: { /* same shape as selectedSources */ }[];
  destination: {
    amount: string;
    amountRaw: bigint;
    chain: { id: number; name: string; logo: string };
    token: { decimals: number; symbol: string; logo: string; contractAddress: `0x${string}` };
    value: string; // USD value
  };
  fees: {
    caGas: string;
    protocol: string;
    solver: string;
    total: string;
    totalValue: string; // USD value
  };
  sourcesTotal: string;
};

Note

Learn about the complete lifecycle of an intent.

How is this guide?

What is Chain Abstraction?

Eliminate manual bridging and wallet complexity.

What are Solvers?

Agents that compete to fulfill user intents.

What does an Intent look like?

Edit in GitHub

type BridgeIntent = { provider: 'nexus' | 'mayan'; selectedSources: { amount: string; amountRaw: bigint; chain: { id: number; name: string; logo: string }; token: { decimals: number; symbol: string; logo: string; contractAddress: `0x${string}` }; value: string; // USD value }[]; availableSources: { /* same shape as selectedSources */ }[]; destination: { amount: string; amountRaw: bigint; chain: { id: number; name: string; logo: string }; token: { decimals: number; symbol: string; logo: string; contractAddress: `0x${string}` }; value: string; // USD value }; fees: { caGas: string; protocol: string; solver: string; total: string; totalValue: string; // USD value }; sourcesTotal: string; };

Search Documentation

What is an Intent?

What does an Intent look like?

Search Documentation

What is an Intent?

What does an Intent look like?