Deposit Flow

Preconditions

Before showing a deposit button:

health.ready.display === true
health.ready.operations === true
health.ready.deposits === true
Wallet is on HyperEVM chain 999
Amount is at least config.deposit.minimumDeposit

Funding from other networks

Signalite deposits are native HyperEVM USDC actions. If the user starts with USDC on another network, the partner app must fund HyperEVM USDC first, then create the Signalite action.

Ethereum/Base/Arbitrum/Solana/etc USDC
  -> Arc/Relay funding flow
  -> HyperEVM USDC in the user's EVM wallet
  -> Signalite Partner Action deposit

Read the production funding contract from config:

const config = await shlp.getConfig();
const destination = config.deposit.funding.destination;
const sources = config.deposit.funding.sourceNetworks;

Use the actual HyperEVM USDC amount received after funding as the Signalite deposit amount. Do not submit Relay/funding transaction hashes to Signalite.

Prepare

import { parseUsdc, preparePartnerDeposit } from "@arc/shlp-sdk";

const prepared = await preparePartnerDeposit(shlp, {
  amount: parseUsdc("100"),
  account: userAddress,
  receiver: userAddress,
  slippageBps: 50,
});

If the action is blocked, do not ask the wallet to sign:

if (!prepared.canAskForSignature || !prepared.flow) {
  showBlockedState(prepared.title, prepared.description);
  return;
}

Send wallet steps

for (const step of prepared.flow.steps) {
  const hash = await shlp.sendApiTransaction(step.tx, userAddress);
  await waitForReceipt(hash);

  if (step.refreshQuoteAfterConfirm) {
    // Approval changed allowance. Re-run preparePartnerDeposit before sending
    // the vault deposit step.
    return;
  }
}

First-time depositors usually see two wallet actions: Approve USDC, then Deposit USDC. Existing allowance is a one-step deposit.

Product states to handle

Code	UI behavior
`DEPOSITS_PAUSED`	Disable deposit and show a product-state message
`DEPOSITS_NOT_READY`	Disable deposit until operations recover
`MIN_DEPOSIT_NOT_MET`	Ask user to increase amount
`CAP_EXCEEDED`	Show cap reached
`BAD_WALLET`	Ask user to reconnect/switch wallet

Deposits below the recommended operational batch minimum can still be valid, but may remain in the vault buffer until the keeper batches liquidity.

Start

Build flows

SDK

Operations

Preconditions

Funding from other networks

Prepare

Send wallet steps

Product states to handle

​Preconditions

​Funding from other networks

​Prepare

​Send wallet steps

​Product states to handle

Preconditions

Funding from other networks

Prepare

Send wallet steps

Product states to handle