# Legacy transfers

Source: https://docs.settlemint.com/docs/concepts/custody-and-signing/custody-deposits-and-withdrawals
What changed from custody-wallet deposits and withdrawals to gateways, and which destination proofs, fee rules and approvals remain.

The former custody-wallet deposit and withdrawal operations have been retired. Current wallet deposits and withdrawals use a client’s custody gateway and its custody receipts. Destination control proofs remain available, but proving an address does not make it an approved gateway payout address.

[Figure] From retired custody books to current gateway evidence. The old watch and journal workflows are retired. Current gateway records and receipt holdings provide current evidence. Cases and registrar reconciliation remain separate. Labels: Retired: custody watch and journal; Current: gateway records and receipts; Separate: Cases and registrar reconciliation.

[Figure] From retired custody books to current gateway evidence. The old watch and journal workflows are retired. Current gateway records and receipt holdings provide current evidence. Cases and registrar reconciliation remain separate. Labels: Retired: custody watch and journal; Current: gateway records and receipts; Separate: Cases and registrar reconciliation.

The custody watch and journal are retired. Current gateways use records and custody receipts. Cases and registrar reconciliation are separate operator controls.

## A deposit and a withdrawal are separate records [#a-deposit-and-a-withdrawal-are-separate-records]

The former custody-wallet deposit and withdrawal records are retired. Current gateway deposits and withdrawal requests have stable identifiers and stage histories. Use the identifiers returned by the current records API. The old deposit identifier formula and spendable or held postings no longer describe gateway evidence. [Custodial deposits and positions](https://docs.settlemint.com/docs/concepts/custody-and-signing/custodial-deposits) maps the retired addresses, watches, journals and positions to their current gateway equivalents.

## How a deposit becomes spendable [#how-a-deposit-becomes-spendable]

The old journal deposit state table is retired. Current deposits mint custody receipts, with stage-specific screening and acceptance. Receipts awaiting custody acceptance may remain held until that flow completes. Read the current record rather than applying a provider-wide rule to every deposit.

## An operator decides a held deposit [#an-operator-decides-a-held-deposit]

The old held-deposit review and transition routes are retired. An operator now reads the gateway deposit and uses only the decisions allowed by its stage and signer roles. Where the add-on requires checker approval, that approval remains necessary. There is no generic release, return or refusal action that applies to every hold.

## A destination is proved, then cleared [#a-destination-is-proved-then-cleared]

Address-control proofs and operator review remain available even though the legacy withdrawal workflow is retired. Propose a destination, sign its issued message, submit the proof, and wait for the required operator review. The operator can clear or refuse it. The participant can revoke it. A cleared destination proves and reviews address control, but is not automatically an approved gateway payout address. See [Withdrawal destination review](https://docs.settlemint.com/docs/console/organisation-settings/custody-reconciliation) and [Wallet deposits and withdrawals](https://docs.settlemint.com/docs/console/my-assets/wallet-transfers).

## A clearance belongs to one custody reset [#a-clearance-belongs-to-one-custody-reset]

The retained destination proof binds the organisation, participant, network, address, custody reset epoch and expiry. A proof that no longer matches that binding is refused. This protects the current proof list. It does not restart a retired deposit watch or authorise a new gateway payout address.

## Requesting a withdrawal holds the amount and the fees [#requesting-a-withdrawal-holds-the-amount-and-the-fees]

The old journal withdrawal request, limits and retry-key contract are retired. A current gateway request locks custody receipts under its current terms. Review the gateway’s amount and fee quote before submitting. The former held-balance errors and journal policy limits are not gateway request rules.

## A withdrawal waits out its cancel window [#a-withdrawal-waits-out-its-cancel-window]

The former journal cancellation window and transition route are retired. Current cancellation depends on the gateway request’s stage and configured cancellation setting. The current return flow releases the receipts when permitted. Do not assume every request waits before payment or can always be cancelled.

## A payout settles only on the exact transfer [#a-payout-settles-only-on-the-exact-transfer]

The former durable payout lifecycle is retired. In the current gateway, claiming a withdrawal pays coins and burns receipts atomically. Follow the actual request stage and gateway record history to distinguish a pending request, a claimable payment and a settled withdrawal.

## A payout the platform cannot prove is parked [#a-payout-the-platform-cannot-prove-is-parked]

The old parked-payout resolver is retired. Current gateway requests use their own stages, evidence and role-gated claim or return decisions. An uncertain old payout does not map automatically to a gateway stage, and there is no replacement generic consume-or-release action.

## What a withdrawal costs and how the fees are booked [#what-a-withdrawal-costs-and-how-the-fees-are-booked]

The former journal fee schedule and postings are retired. Gateway withdrawal fees use the gateway’s current terms: a fee can be deducted or recorded as owed. Client and service gas obligations are separate. Review the current quote. Neither fees nor network charges are universally zero.

### How the fees are quoted [#how-the-fees-are-quoted]

The old fee-quote endpoint and fixed gas estimate are retired. The current gateway quote uses its actual terms and network recharge ceiling. If the interface cannot price a fee, resolve that condition before submitting. A gateway quote is not a renamed legacy journal quote.

### How the fees are charged [#how-the-fees-are-charged]

The former journal hold for custody fees is retired. Current requests lock receipts and apply the gateway’s fee mode. A deducted fee reduces the value paid, while an accounting-only fee is recorded as owed. Consult the current network quote rather than relying on the old claim that the investor’s custody balance never pays gas.

### How the fees are booked [#how-the-fees-are-booked]

The old fee-account posting table is retired. Current gateway fee-accrued or fee-owed records and reconciliation provide evidence for gateway fees. They are not aliases for the old journal outcomes or fee-account balances.

## Who sees what [#who-sees-what]

The old route and role inventory is retired. Current gateway reads are client or organisation scoped, and transitions require the appropriate role and stage. Withdrawal proofs retain their participant and operator checks. Generic organisation Cases remain available to owners and platform administrators even when custody operations are off.

## Related pages [#related-pages]

The legacy workflows on this page are migration references. Use [Custody gateway](https://docs.settlemint.com/docs/concepts/custody-and-signing/custody-gateway) for the current deposit and withdrawal model, [Wallet deposits and withdrawals](https://docs.settlemint.com/docs/console/my-assets/wallet-transfers) for client actions, [Custody settings](https://docs.settlemint.com/docs/console/organisation-settings/custody) for Providers and Cases, and [Custody reconciliation](https://docs.settlemint.com/docs/console/organisation-settings/custody-reconciliation) for break and destination review. [Custody Provider](https://docs.settlemint.com/docs/concepts/custody-and-signing/custody-provider) explains signing responsibilities. [Maker-checker](https://docs.settlemint.com/docs/concepts/custody-and-signing/maker-checker) explains required approvals.
