Deposits

Provider-owned deposit flows for Lighter mainnet and Lighter on Robinhood Chain

Use PerpsClient.getDepositFlow() instead of hard-coding a chain or collateral token. The Lighter provider owns account-existence checks and returns the correct deployment-specific flow.

const flow = await perps.getDepositFlow({
  provider: 'lighter-rh',
  address: userAddress,
});

Flow by deployment

Provider	Existing account	First deposit / account opening
lighter	lifiSwap into USDC on the Lighter chain (ChainId.LTR)	firstDepositPipeline on Ethereum: ETH gas + Ethereum USDC, then DEPOSIT
lighter-rh	lifiSwap into USDG on Robinhood Chain	firstDepositPipeline on Robinhood Chain: native gas + USDG, then DEPOSIT

The returned assets carry exact { chainId, address, decimals } identity. A symbol alone is not sufficient: Ethereum USDC and Lighter-chain USDC, and the two deployments’ asset index 3, refer to different on-chain assets.

First-deposit pipeline

A firstDepositPipeline supplies:

Field	Description
chainId	Chain on which the deposit legs are broadcast
gasAsset	Native gas asset to seed on that chain
collateral	Exact collateral token used to open the account
bridgeAction	ActionType.DEPOSIT

The DEPOSIT action is user-authorized and returns two EVM transaction steps: an ERC-20 approve(bridge, amount), then bridge.deposit(to, assetIndex = 3, routeType = perp, amount). For mainnet Lighter, the bridge contract is on Ethereum. For lighter-rh, the deployment descriptor supplies Robinhood Chain and USDG instead; do not reuse mainnet constants.

Param	Description
amount	Amount in the token’s base units as an integer string, for example "100500000" for 100.5 USDC
tokenAddress	Collateral token address
chainId	Must be the deployment’s bridge chain (Ethereum for lighter, Robinhood Chain for lighter-rh); any other chain is rejected with a validation error asking the caller to bridge first through LI.FI

Direct DEPOSIT is only for the first-deposit pipeline on the bridge chain. To fund from any other chain, route through lifiSwap.

import { getGasRecommendation } from '@lifi/perps-sdk';

const flow = await perps.getDepositFlow({ provider: 'lighter', address: userAddress });

if (flow?.kind === 'firstDepositPipeline') {
  const gas = await getGasRecommendation(perps.client, { chainId: flow.chainId });
  // Route gas and flow.collateral, then execute flow.bridgeAction.
}

Existing accounts

An existing account returns lifiSwap. Route into flow.destination; LI.FI routing decides whether that is a same-chain swap or a bridge. The optional toAddress is the credited address when a provider requires a provisioned destination.

Setup after account opening

Lighter cannot register its trading key before the venue account exists. After the first deposit is indexed, call checkSetup() and execute the returned REGISTER_API_KEY and any conditional setup steps. See Setup.