Dfns API Documentation
Ask or search…
⌃K
Comment on page

Wallets

Welcome to the new Wallets API! We've received feedback that our original notion of Asset Accounts is too granular. Any given Asset Account represents at most one contract on one chain. With Wallets, we're expanding this to any number of assets on a single chain, which we believe is more consistent with the standard mental model of wallets in web3.
In addition to tracking multiple assets, the new Wallets API also natively supports ERC-721 based NFTs. You can list which NFTs are in your wallet and transfer NFTs just like ERC-20 tokens. We are indexing the supported chains below, so we know what's in your wallet at any given time. Also note that the wallets API brings together elements of our high and low level APIs such that with a single wallet you can now transfer a token, broadcast a transaction, or create a signature.
Finally, Wallets will support Delegated Signing, enabling you to require your customers to sign API requests into Dfns using our new Authentication system. Please contact us for additional resources related to Delegated Signing.

Caveats

While we expect Wallets to eventually fully deprecate Asset Accounts, for the time being, see the table below for the supported blockchain networks.

Supported networks

Network name
Mainnet
Testnet
Tier-1
Tier-2
Block Finality*
ArbitrumOne
​
✅
​
​
​
✅
​
​
50
ArbitrumGoerli
​
​
✅
​
​
✅
​
​
0
ArbitrumSepolia
​
​
✅
​
​
✅
​
​
0
AvalancheC
​
✅
​
​
​
✅
​
​
50
AvalancheCFuji
​
​
✅
​
​
✅
​
​
0
Base
​
✅
​
​
​
✅
​
​
50
Bitcoin
​
✅
​
​
​
​
✅
​
2
BitcoinTestnet3
​
​
✅
​
​
​
✅
​
0
Bsc
​
✅
​
​
​
✅
​
​
50
BscTestnet
​
​
✅
​
​
✅
​
​
0
Ethereum
​
✅
​
​
​
✅
​
​
12
EthereumGoerli
​
​
✅
​
​
✅
​
​
0
EthereumSepolia
​
​
✅
​
​
✅
​
​
0
FantomOpera
​
✅
​
​
​
✅
​
​
50
FantomTestnet
​
​
✅
​
​
✅
​
​
0
Optimism
​
✅
​
​
​
✅
​
​
50
OptimismGoerli
​
​
✅
​
​
✅
​
​
0
Polygon
​
✅
​
​
​
✅
​
​
50
PolygonMumbai
​
​
✅
​
​
✅
​
​
0
Tron
​
✅
​
​
​
​
✅
​
19
TronNile
​
​
✅
​
​
​
✅
​
0
* Block Finality refers to the number of blocks that must be validated or mined after a transaction has been included in a block for that transaction to be considered irreversible. Testnets report transactions immediately upon indexing.

Tier-1 vs Tier-2 support

We plan to add support for more blockchain networks over time. The supported features will vary depending on popularity and market demand.
Tier 1 blockchain networks will support all wallet features, including automatic detection of wallet asset and NFT balances if applicable, and on-chain asset transfer history. Tier-1 support also include transfer asset, broadcast transaction and generate signature.
Tier 2 blockchain networks do not track tokens or on-chain history. Only the balance of the native token, which is used to pay transaction fees, is returned. Tier-2 support include broadcast transaction and generate signature; transfer asset is not supported.

Pseudo networks

We also support wallets not tied to a blockchain network. You can create an unbound wallet by setting the network field to one of the supported signature schemes, currently either KeyECDSA or KeyEdDSA. You can use these wallets for more advanced use cases, for example
  • use Dfns wallets with private blockchains that Dfns can't access, such as Polygon supernets or Avalanche subnets.
  • use Dfns wallets with blockchains not on the supported network list, as long as they use either ECDSA or EdDSA.
  • use the same Dfns wallets across multiple blockchain networks.
The unbound wallets only support generate signature. To help improve the developer experience with generate signature, our TypeScript SDK includes integrations with different blockchain SDKs, like ethers.js 5 and 6 or Solana web3.js. Browse through the included examples to see how to develop dapps with Dfns wallets.

Other features

Additionally, the Wallets API is fully integrated with Policy Engine with support for the TransferAmountLimit and AlwaysActivatedRule rules. Additional blockchain integrations as well as full dashboard support for wallets will be available in future releases.
Thanks in advance for testing the new Wallets API and please send any feedback to [email protected].