Deposits - Veilify

deposit

function deposit(uint256 amount, address token) public payable returns (uint256 index);

Deposits to the caller’s own inbox key. It is equivalent to depositTo(msg.sender, amount, token).

depositTo

function depositTo(address recipient, uint256 amount, address token)
    public payable nonReentrant whenNotPaused returns (uint256 index);

address

required

Must have a registered inbox key (ReceivingKeyNotFound).

uint256

required

Deposit amount in token base units. For fee-on-transfer tokens, the amount actually received is used.

address

required

address(0) for ETH. Must be whitelisted (TokenNotWhitelisted).

uint256

required

ETH: amount + gasEscrow. ERC-20: gasEscrow only.

Stores pendingDepositHashes[index] = keccak256(abi.encode(recipient, token, amount, msg.sender, gasEscrow)) and emits DepositPending. Limits (_checkDepositLimits): amount ≥ minDeposit[token]; amount ≤ maxDeposit[token] when set; pool balance ≤ depositCap[token] when set.

registerReceivingKeyAndDeposit

function registerReceivingKeyAndDeposit(uint256 amount, address token, ReceivingKey calldata rk)
    external payable returns (uint256 index);

Registers the caller’s inbox key (idempotent) and deposits in one transaction.

withdrawPendingDeposit

function withdrawPendingDeposit(uint256 index, address recipient, address token, uint256 amount, uint256 gasEscrow)
    external nonReentrant;

The original depositor takes back a pending deposit and its full escrow. It works while paused. If the admin enabled cancelCheckFee, the capped check cost is kept. Emits DepositStatusChanged(index, REVERTED).

approveDeposit / rejectDeposit

Gatekeeper only. See Gatekeeper.

pullDeposit

function pullDeposit(PullParams calldata p, RevocationKey calldata rk, bytes calldata intentSig)
    external nonReentrant whenNotPaused returns (uint256 index);

struct PullParams {
    address depositor;
    address token;
    uint256 amount;
    uint256 gasFee;      // not signed; capped by maxPullGasFee[token] and 5% of received
    bytes32 requestId;   // single use
    uint256 deadline;
}

Gatekeeper only. ERC-20 only. It credits immediately: the events match a deposit followed by an approval, with a zero escrow.

Revert	Cause
`PullIntentExpired(deadline)`	`block.timestamp > deadline`
`PullRequestUsed(requestId)`	Intent already used
`InvalidPullIntent()`	Signature is neither a valid ECDSA nor ERC-1271 signature by `depositor`
`GasFeeTooHigh(gasFee, max)`	Gas fee above the cap
`FeesExceedDeposit(amount, fees)`	Protocol fee + gas fee ≥ received

Deposit status

enum DepositStatus { REJECTED, PENDING, ACTION_REQUIRED, APPROVED, REVERTED }

​deposit

​depositTo

​registerReceivingKeyAndDeposit

​withdrawPendingDeposit

​approveDeposit / rejectDeposit

​pullDeposit

​Deposit status

deposit

depositTo

registerReceivingKeyAndDeposit

withdrawPendingDeposit

approveDeposit / rejectDeposit

pullDeposit

Deposit status