Dfns API Documentation
Ask or search…
K
Comment on page

Create Wallet

POST /wallets
Creates new Wallet associated with the given chain (such as Ethereum or Polygon). Returns a new wallet ID. Note the request is asynchronous - call Get Wallet to check status of creation and get the associated blockchain address once complete.

Required Permissions

Name
Conditions
Wallets:Create
Always Required

Request

Request body fields
Required/Optional
Description
Type
network
Required
Network used for the wallet (See Supported Networks + Pseudo Network for possible values)
String
name
Optional
Name given to the wallet
String
delayDelegation
Optional
Specify this if you want to create the wallet from a service account and later delegate it to an end user. Defaults to false.
Boolean

Example

{
"network": "EthereumSepolia",
"name": "my-wallet"
}

Response

The response body is the created Wallet. The Wallet object has those fields:
  • id - string - ID of the wallet
  • network - string - Network used for the wallet (See Supported Networks for possible values)
  • name - (Optional) string - Name given to the wallet
  • address - (Optional) string - Wallet address on its corresponding network. If using a Pseudo Network, this field will not be set.
  • status - string - Status of the wallet, can be one of Active, Archived.
  • signingKey - object - Info about the signing key corresponding to that wallet
    • scheme - string - Supported schemes are ECDSA or EdDSA
    • curve - string - Key curve. Can be ed25519 or secp256k1
    • publicKey - string - Hex-encoded value of public key
  • dateCreated - string - ISO 8601 date string when wallet was created
  • imported - (Optional) boolean - is true if the wallet is an imported wallet.
  • exported - (Optional) boolean - is true if the wallet was already exported at least once.
  • dateExported - (Optional) string - ISO 8601 date string when wallet was first exported.

200 Response example

{
"id": "wa-1f04s-lqc9q-xxxxxxxxxxxxxxxx",
"network": "EthereumSepolia",
"status": "Active",
"name": "My awesome wallet",
"dateCreated": "2023-04-14T20:41:28.715Z",
"signingKey": {
"curve": "secp256k1",
"scheme": "ECDSA",
"publicKey": "e2375c8c9e87bfcd0be8f29d76c818cabacd51584f72cb2222d49a13b036d84d3d"
}
}