Skip to main content

Environments overview

RegionAPI base URLDashboard URLChainsSLAWebhook origin IP
Default - Europeapi.dfns.ioapp.dfns.io Mainnet
Testnet
Yes35.181.116.68
UAEapi.uae.dfns.ioapp.uae.dfns.io Mainnet
Testnet
Yes40.172.249.100
Deprecated Stagingapi.dfns.ninjaapp.dfns.ninja Mainnet
Testnet
No52.47.197.63
The staging environment is to use only with test fundsThis constraint exists to prevent customers from accidentally moving real funds into the staging environment. Dfns cannot prevent customers from using the staging environment to send funds to a mainnet chain. This is however against our terms of use, so please don’t do it - thanks!

Regional hosting - Data residency

Dfns regions are segregated environments enabling you to choose where your data is processed.
An organization and its wallets, keys, users, etc. live in a specific region. They cannot be accessed from another region or transferred to another region.
The original and default Dfns environment (dfns.io) is hosted across multiple European AWS regions. When you use this region, your data are processed in Europe. An alternative environment hosted in the UAE is available (uae.dfns.io). When you use this region, your data are processed exclusively in the UAE.
On-chain activity cannot be tied to a region as blockchains are decentralized by definition. When transactions data are broadcasted to a network they may be processed anywhere in the world, this is totally out of Dfns control.

Building API endpoint URLs

Throughout our documentation, assume that you should prepend the environment base URL in front of the API paths given. For example:
GET /wallets/ should be interpreted as: GET https://api.dfns.io/wallets/

Whitelisting webhooks origin IPs

Our webhooks will always be originated from the same IP address (see table above). You can therefore use these if you want to whitelist Dfns IPs for filtering webhook delivery. Make sure you also verify that webhooks are properly signed by checking the Dfns-Signature header as explained in the webhooks documentation.