Skip to main content

Withdrawal strategy

OrcaRail supports two withdrawal strategies that control how funds are sent from your deposit wallets to your withdrawal addresses: multi-network (direct transfers per chain) and bridge (cross-chain via Relay when needed).

:::info Sweep path being deprecated

The sweep step described here (deposit wallet → withdrawal address, executed by an OrcaRail keeper) is being replaced chain-by-chain with on-chain atomic splitting in per-link smart contracts. The strategy field and the bridge option stay the same; what changes is that EVM and Solana settlements move to contract receivers that split directly on the pay transaction. See Non-custodial overview and the Roadmap.

:::

Strategy values​

  • 1 — multi-network: Direct transfers per chain. Each chain type (EVM, Solana, Bitcoin) sends to the address you configured for that chain. No cross-chain bridge.
  • 2 — bridge: When the quote indicates a bridge is required (e.g. payer pays on Base, receivable on Ethereum), the system uses Relay to bridge. If no bridge is needed, behavior is the same as multi-network.

Responses from the API use numeric values (1 or 2). Use these same values when sending strategy in request bodies.

Where strategy is set​

Account default: Withdrawal Settings​

Set the default strategy for your account with Update Withdrawal Settings:

PUT /withdrawals/settings

Include strategy in the request body (e.g. "strategy": 1 or "strategy": 2). This default applies to auto-withdrawals and can be overridden per withdrawal request.

Per request: Create Withdrawal Request​

When creating a withdrawal request, you can override the default:

POST /withdrawals/requests

Send strategy as a number: 1 for multi-network, 2 for bridge. The effective strategy is stored on the withdrawal request and used when the withdrawal is executed.

Behavior summary​

  • multiNetwork (1): Funds are sent directly to your withdrawal address for the same chain type. No cross-chain routing.
  • bridge (2): If the payment quote requires a bridge (e.g. different source and destination networks), the system uses Relay to bridge; otherwise it behaves like multi-network. Strategy may be downgraded to multi-network when the quote does not require a bridge.

See also​