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 venue chain	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: mainnet and venue-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 EVM transaction steps. For mainnet Lighter, the bridge contract is on Ethereum and the flow approves USDC before calling deposit. For lighter-rh, the deployment descriptor supplies Robinhood Chain and USDG instead; do not reuse mainnet constants.

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.