Skip to main content

Deposit funding instructions

How an operator makes deposits possible: turn the module on, enable coins on the custody gateway add-on and give clients the gateway address to send to.

A DALP Instance tells a client where to send a deposit through the client's own custody gateway. The gateway belongs to one client identity and has an address. The client sends coins to that address, and the gateway records the deposit, screens it and mints receipts. No deployment setting lists accepted coins, and no route watches a wallet for deposits. The operator decides what is accepted in the Console.

What must be in place

Requirement
Where it comes from
The “Self-custody” module is on
The features.custodyOps setting, as Switch application layers on or off describes. With it off, the gateway routes answer DALP-20531.
The custody gateway add-on exists
An owner or platform admin sets it up. See Set up the custody gateway.
A keeper service wallet
It records deposits and pays withdrawals.
A screener service wallet
It clears or refuses quarantined deposits.
At least one enabled coin and one profile
They define what a gateway accepts and the claim a client needs.
A gateway for the client

Which coins are accepted

A coin is accepted when it is enabled on the add-on. A deposit of any other coin lands on the gateway's “Unsupported” list and is returned, recovered or ignored by an operator. See Review deposits and withdrawals.

A coin can be set to wait for custody. The gateway then mints the receipts to the client and holds them until the custodian accepts the coins the gateway forwarded. A deposit in that state rests at Awaiting custody.

Where a client sends a deposit

A client sees the gateway address in the Deposit dialog of the Investor portal, and reads it through GET /api/v2/addons/custody-gateways/gateways/mine. A gateway has no client wallet when it is created. A gateway manager binds one before the client's own routes work, as the custody gateway API describes.

What happens to a deposit

Every deposit enters a screening stage first. The screener clears it, the gateway mints the receipts and the coins move on. Deposit and withdrawal stages lists each stage, who moves it and the time limits.

Was this page helpful?