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.
User action signature required. See User Action Signing for more information.
Request headers required. See Request Headers for more information.
Authentication required. See Authentication Headers for more information.
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"
  }
}

Name	Conditions
`Wallets:Create`	Always Required

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

API Docs - Previous

Wallets

Delegate Wallet

Last modified 9d ago