Compact Orders

The Compact flow uses The Compact resource lock for off-chain, gasless order submission. Users deposit tokens once and can issue multiple intents from that balance without paying gas per order.

If you’re adding LI.FI Intents alongside other bridges, the standard escrow flow is simpler and recommended. Use the Compact flow when you need gasless submissions or are building a resource-lock-native application.

How It Differs from Escrow

	Escrow	Compact
Token locking	Per-intent, on-chain each time	Deposit once, reuse balance
Order submission	On-chain (`open`/`openFor`)	Off-chain (`POST /orders/submit`)
Gas per intent	User pays gas to lock	Gasless after initial deposit
Settlement	`finalise` (no signature needed)	`finaliseWithSignature` (signatures required)
Order type	N/A (detected on-chain)	`CatalystCompactOrder`

Flow

Deposit into The Compact

Deposit tokens into The Compact resource lock. This is a one-time on-chain transaction. Later intents draw from this balance and cost no extra gas.See the lintent.org demo for a UI example of depositing and registering intents.

Request a quote

Call the legacy V0 endpoint POST /quote/request with "oif-resource-lock-v0" in supportedTypes to indicate Compact support. The V1 quote endpoint does not serve resource-lock flows; it only returns user-open orders. So this flow uses V0, which takes EIP-7930 interoperable addresses — these pack the chain and address into one bytes field. Build them with the interoperable-addresses library.

const response = await fetch('https://order.li.fi/quote/request', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    user: '0x0001000002210514YOUR_WALLET_ADDRESS_20_BYTES',
    intent: {
      intentType: 'oif-swap',
      inputs: [{
        user: '0x0001000002210514YOUR_WALLET_ADDRESS_20_BYTES',
        asset: '0x0001000002210514833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',  // USDC on Base
        amount: '10000000',
      }],
      outputs: [{
        receiver: '0x0001000002A4B114YOUR_WALLET_ADDRESS_20_BYTES',
        asset: '0x0001000002A4B114af88d065e77c8cC2239327C5EDb3A432268e5831',  // USDC on Arbitrum
        amount: null,
      }],
      swapType: 'exact-input',
    },
    supportedTypes: ['oif-escrow-v0', 'oif-resource-lock-v0'],
  }),
});

const { quotes } = await response.json();
const bestQuote = quotes[0];

Sign the claim

Compact orders are authorized via EIP-712 signatures rather than on-chain transactions. Sign a BatchClaim using The Compact’s domain separator.

TypeScript

// The claim is signed as a BatchCompact struct:
// struct BatchCompact {
//   address arbiter;        // InputSettlerCompact address
//   address sponsor;        // User address
//   uint256 nonce;          // Allocator nonce
//   uint256 expires;        // Claim expiry
//   uint256[2][] idsAndAmounts;
//   Mandate mandate;        // fillDeadline, inputOracle, outputs
// }

For a complete signing example, see the lintent.org demo.

Submit the order off-chain

Submit the signed order to POST /orders/submit. Include the quoteId for preferential solver matching.

curl -X POST 'https://order.li.fi/orders/submit' \
  -H 'Content-Type: application/json' \
  -d '{
    "orderType": "CatalystCompactOrder",
    "inputSettler": "0x0000000000cd5f7fDEc90a03a31F79E5Fbc6A9Cf",
    "quoteId": "QUOTE_ID_FROM_STEP_2",
    "order": {
      "expires": 1942819670,
      "user": "0xYOUR_WALLET_ADDRESS",
      "nonce": "1004",
      "originChainId": "8453",
      "fillDeadline": 1942819670,
      "inputOracle": "0x008C3800F3Ad9b3B662d002E90Cc00000000eE17",
      "inputs": [
        ["749071750893463290574776461331093852760741783827", "10000000"]
      ],
      "outputs": [{
        "oracle": "0x000000000000000000000000008C3800F3Ad9b3B662d002E90Cc00000000eE17",
        "settler": "0x00000000000000000000000075220B7600c300005038432a0000f308e0000068",
        "chainId": "42161",
        "token": "0x000000000000000000000000af88d065e77c8cC2239327C5EDb3A432268e5831",
        "amount": "9986765",
        "recipient": "0x000000000000000000000000YOUR_WALLET_ADDRESS",
        "callbackData": "0x",
        "context": "0x"
      }]
    }
  }'

CatalystCompactOrder submissions require a sponsor signature or Compact registration tx hash. The payload above is a reference template. You must include the appropriate signature fields. Always test on order-dev.li.fi before production.

The response includes a meta object with orderIdentifier and onChainOrderId for tracking.

Track the order

Same as the escrow flow. Poll GET /orders/status until the order reaches Settled or Refunded.

const trackOrder = async (orderId: string) => {
  let status: string;
  do {
    const res = await fetch(
      `https://order.li.fi/orders/status?catalystOrderId=${orderId}`
    );
    const data = await res.json();
    status = data.meta.orderStatus;
    console.log(`Status: ${status}`);

    if (status !== 'Settled' && status !== 'Refunded') {
      await new Promise(r => setTimeout(r, 3000));
    }
  } while (status !== 'Settled' && status !== 'Refunded');

  return status;
};

// `submitted`: the JSON response body from POST /orders/submit in the previous step
await trackOrder(submitted.meta.orderIdentifier);

Integration Examples

Signing a BatchCompact claim (UI example)
Depositing and registering intents (UI example)
RegisterIntentLib.sol (smart contract example)

Next Steps

Settlement

Compact claim structure, registration, and Permit2 details

Resource Locks

How resource locks, sponsors, allocators, and arbiters work

Create and Submit Orders

Full order construction reference and validation rules

Track Order Status

Monitor orders via the API or on-chain events

Getting Started

Intents API

Solver API

MCP Server

Architecture

Knowledge Base

Compact Orders

How It Differs from Escrow

Flow

Integration Examples

Next Steps

Settlement

Resource Locks

Create and Submit Orders

Track Order Status

​How It Differs from Escrow

​Flow

​Integration Examples

​Next Steps

Settlement

Resource Locks

Create and Submit Orders

Track Order Status

How It Differs from Escrow

Flow

Integration Examples

Next Steps