SyncDepositQueue

​

Overview

​

Key features

• Shares minted in the same transaction as the deposit
• Pricing from the latest non-suspicious oracle report, no older than maxAge
• Optional penaltyD6 discount on the deposit price, kept by existing holders
• Vault deposit fee applied, as in DepositQueue
• Same depositor whitelist check as DepositQueue
• Deposit hook runs inside the deposit transaction

​

Parameters

struct SyncDepositQueueStorage {
    uint256 penaltyD6;  // Price penalty in 1e6 precision (1e4 = 1%)
    uint32 maxAge;      // Maximum age of the oracle report, in seconds
}

keccak256("queues.SyncDepositQueue.SET_SYNC_DEPOSIT_PARAMS_ROLE")

​

Creation

vault.createQueue(
    2,                                  // SyncDepositQueue implementation
    true,                               // isDeposit
    owner,                              // proxy owner
    asset,                              // must be supported by the oracle
    abi.encode(penaltyD6, maxAge)       // uint256, uint32
);

​

Function: deposit

function deposit(uint224 assets, address referral, bytes32[] calldata merkleProof) external payable nonReentrant

1. Reverts with ZeroValue if assets is zero.
2. Reverts with QueuePaused if the vault has paused the queue.
3. Reverts with DepositNotAllowed if shareManager.isDepositorWhitelisted(caller, merkleProof) returns false.
4. Reads the latest report with oracle.getReport(asset):
   • Reverts with InvalidReport if the report is suspicious or its price is zero.
   • Reverts with StaleReport if report.timestamp + maxAge < block.timestamp.
5. Applies the penalty: priceD18 = report.priceD18 * (1e6 - penaltyD6) / 1e6.
6. Transfers assets from the caller to the queue, then from the queue to the vault.
7. Computes shares = assets * priceD18 / 1e18.
8. Computes feeShares = feeManager.calculateDepositFee(shares), mints them to the fee recipient and subtracts them from shares.
9. Mints the remaining shares to the caller. Reverts with ZeroValue if nothing is left.
10. Calls riskManager.modifyVaultBalance(asset, +assets). Reverts with LimitExceeded if the deposit would push the vault over its limit, including pending async deposits.
11. Calls vault.callHook(assets), which runs the queue’s deposit hook (custom or default) in the vault context.
12. Emits Deposited(account, referral, assets, shares, feeShares).

​

Estimating shares

(uint256 penaltyD6, uint32 maxAge) = queue.syncDepositParams();
IOracle.DetailedReport memory report = oracle.getReport(asset);
// check: !report.isSuspicious && report.priceD18 != 0
// check: report.timestamp + maxAge >= block.timestamp
uint256 priceD18 = report.priceD18 * (1e6 - penaltyD6) / 1e6;
uint256 grossShares = assets * priceD18 / 1e18;
uint256 userShares = grossShares - feeManager.calculateDepositFee(grossShares);

​

Interface compatibility

​

View functions

​

Events

event Deposited(address indexed account, address indexed referral, uint224 assets, uint256 shares, uint256 feeShares);
event SyncDepositParamsSet(uint256 penaltyD6, uint32 maxAge);

​

Errors

​

Design considerations

• Stale-price window. Deposits are priced at a report that can be up to maxAge old. If the real share price has dropped since that report, a deposit mints more shares than it would after the next report. Keep maxAge close to the oracle’s reporting cadence, and use penaltyD6 if you need an extra buffer.
• Vault limit. The vault limit check counts pending async deposits, so a large pending async deposit can make sync deposits revert with LimitExceeded.
• Hook execution. The deposit hook runs in the depositor’s transaction, so a reverting hook blocks sync deposits for that queue.