Skip to content

Custodial vs self-hosted wallets

Set policy expectations before you build

Wallet type is the first routing decision for an incoming or outgoing transaction. A custodial wallet is controlled by a provider; a self-hosted wallet is controlled by the customer. Start with Wallet Intelligence (KYW) to classify the wallet, then follow the relevant messaging or verification flow. Your VASP sets the confidence thresholds and evidence requirements for that decision.

How to differentiate wallet types

Blockchain addresses alone do not reliably identify who controls a wallet. Start with KYW, then use customer information and your own tools where further checks are needed:

  • Use Wallet Intelligence (KYW) to classify the wallet as custodial, non-custodial, or unknown. Evaluate the confidence and reason for the result. See Wallet Intelligence (KYW).
  • Ask the customer during withdrawal setup (select "exchange/VASP" vs "self-hosted").
  • Validate against your own wallet registry if the destination is an address you control.
  • Use beneficiary VASP selection or entity lookup tools to confirm custodial destinations.
  • Store the declared type with the transaction so it remains available for audits and investigations.

Compliance impact under the Travel Rule

  • Custodial (VASP-to-VASP) - Follow the outgoing or incoming Travel Rule message flow, identify the counterparty, and handle delivery and response statuses.
  • Self-hosted (non-custodial) - There is no counterparty VASP behind the wallet. Apply your policy for wallet ownership evidence and use self-hosted wallet verification when needed. For an outgoing transfer to a self-hosted wallet, your VASP may still choose to create a Travel Rule message, even when one is not required for that transfer. If you do, set blockchainInfo.destinationType to "NON_CUSTODIAL". This tells CryptoSwift that the destination is self-hosted, so it will not search for a beneficiary VASP behind the address.
  • Unknown - Use your fallback policy: collect more context through customer information or your own tools, or review the case before choosing a path.

Explore these paths in the interactive Smart withdrawal demo by choosing custodial, self-hosted or unknown wallet results.

Your VASP's own custodial wallet inventory is different from a transaction counterparty's wallet. Register the addresses you control so incoming messages can be matched to your VASP.

Recommended policy approach

  • Require wallet type selection for every outgoing transfer.
  • Apply stricter verification to higher-risk self-hosted withdrawals.
  • Maintain evidence of how wallet type was determined.

Next steps