Deposits & withdrawals

Your users interact with Railnet through the Conduit you deployed. The Conduit provides a simplified deposit and withdrawal interface — the same experience regardless of whether the underlying strategy uses sync protocols (Aave), async protocols (Ethena), or a mix of both.

Deposit through a Conduit

Users deposit base assets (e.g., USDC) and receive Conduit shares representing their proportional ownership.

Approve the Conduit

IERC20(usdc).approve(address(conduit), amount);

// Coming soon

Create the deposit

// The Conduit binds the query id to the caller: query.salt MUST be
// keccak256(abi.encode(msg.sender, sourceSalt)) or create() reverts InvalidQuerySalt.
bytes32 sourceSalt = keccak256(abi.encode("deposit", nonce));

Query memory query = Query({
    owner: address(conduit),
    receiver: address(conduit),
    input: Asset({asset: address(usdc), value: amount}),
    output: Asset({asset: address(conduit.getVehicle()), value: 0}),
    mode: Mode.DEPOSIT,
    salt: keccak256(abi.encode(msg.sender, sourceSalt)),
    data: ""
});

// Create the deposit — auto-processes for sync Vehicles
(Id queryId, State state) = conduit.create(query, userAddress, sourceSalt);

// Coming soon

The query’s owner and receiver are the Conduit itself — the userAddress argument is who receives the resulting shares.output.value is a minimum enforced at the Vehicle output; 0 disables the floor. It ignores Conduit fees and the cShare exchange rate, so size expected output with estimate() instead.For sync underlying strategies, the deposit settles in the same transaction — the user receives shares immediately.For async underlying strategies, the query enters PROCESSING. A keeper will call process() automatically when the operation is ready to settle.

Withdraw through a Conduit

Users burn Conduit shares and receive base assets. Use createRedeemFromConduitShares — it converts cShares to Vehicle shares at the current rate and builds the redeem query for you.

// Same caller-bound salt rule as deposits
bytes32 sourceSalt = keccak256(abi.encode("redeem", nonce));

// Minimum asset to receive; value 0 disables the floor
Asset memory outputAsset = Asset({asset: address(usdc), value: minAssetsOut});

// Burns the caller's cShares and creates the redeem — auto-processes for sync Vehicles
(Id queryId, State state) = conduit.createRedeemFromConduitShares(
    shareAmount,
    outputAsset,
    sourceSalt,
    userAddress
);

// Coming soon

No approve is required. The Conduit burns the caller’s shares internally, so withdrawals are a single transaction.createRedeemFromConduitShares is a wrapper over create: it converts the cShare amount to Vehicle shares and calls create for you. Call create with a REDEEM query directly only if you already know the Vehicle-share amount — see the Conduit reference.

Same settlement behavior as deposits: sync strategies settle immediately, async strategies are settled automatically by keepers.

Automated settlement

For async operations, keepers call process() on your Conduit’s active queries when the underlying protocol is ready to settle. This means:

Your platform doesn’t need to build async monitoring infrastructure
Users never need to return to manually claim after cooldown periods
The experience is the same for sync and async strategies from the user’s perspective

Preview operations

Use estimate() to preview deposits and withdrawals including fees before executing:

// Preview: how many cShares will the user get for 100 USDC?
Asset memory estimated = conduit.estimate(
    Asset({asset: address(usdc), value: 100e6}),
    Mode.DEPOSIT,
    EstimationType.OUTPUT
);
// estimated.value = cShares the user will receive (after fees)

// Preview: how much USDC for burning 50 cShares?
Asset memory redeemEstimate = conduit.estimate(
    Asset({asset: address(conduit), value: 50e18}),
    Mode.REDEEM,
    EstimationType.OUTPUT
);

// Coming soon

estimate() includes fees and slippage. For pure share-to-asset conversion without fees, use convert() instead.

Getting started

Tutorials

How-to guides

Reference

Deposits & withdrawals

Deposit through a Conduit

Withdraw through a Conduit

Automated settlement

Preview operations

​Deposit through a Conduit

​Withdraw through a Conduit

​Automated settlement

​Preview operations

Deposit through a Conduit

Withdraw through a Conduit

Automated settlement

Preview operations