Create New Wallet

API Documentation: Create New Wallet

Overview

This API endpoint allows you to create a new MPC wallet for a particular account

• HTTP Method: POST
• Endpoint: /api/<VERSION>/account/create

Request Body Parameters

• isCustodian (optional): (Only for Version 2) The boolean value to determine whether you want to create a custodian account or not. If the value is true, the account will be created as a custodian account. If the value is false, the account will be created as a non-custodian account. (Default: true)
• rampable (optional): The object containing the user's information (username, fullName & password) to create Rampable account.

Example Request Body

{
    "isCustodian": true,
    "rampable": {
        "username": "johndoe",
        "fullName": "John Doe",
        "password": "JohnDoe123",
    },
}

Request

Request Headers

• Authorization (required): JWT token which was generated when user login and do not have an MPC wallet.
• x-client-secret (required): Client secret which was generated when register in Xellar Embedded Wallet API Service Dashboard.

Example Request Syntax

curl -X POST -H "Content-Type: application/json" -H "x-client-secret: $YOUR_CLIENT_SECRET" -H "Authorization: Bearer $YOUR_ACCESS_TOKEN" -d '{
    "isCustodian": true,
    "rampable": {
        "username": "johndoe",
        "fullName": "John Doe",
        "password": "JohnDoe123",
    },
}' <BASE_URL>/api/<VERSION>/account/create

Response

The response will include a JSON object with the following properties:

• status (number): The HTTP status code of the response (e.g., 200 for success).
• message (string): A message providing additional information about the operation.
• data (object): An object containing the user access token, secret0, secret0Link & wallet address.
  • walletToken : JWT token used to access the Wallet Operation endpoint.
  • secret0 : The encrypted secret that user’s need to save in order to recover their wallet if user lose access to the account.
  • secret0Link : Temporary link to download recovery file. The value is same as secret0 value, but it is already saved in .xellar file. The link will be expired in 5 minutes after being created.
  • address : User’s MPC wallet address.
  • rampableAccessToken : JWT token used to access the Rampable Operation endpoint.

Example Response

V1

{
    "status": 200,
    "message": "Create wallet successfully",
    "data": {
        "walletToken": "your_wallet_token_here",
        "secret0": "your_secret_here",
        "secret0Link": "temporary_link_to_download_secret0_file",
        "address": "your_address",
        "rampableAccessToken": "your_rampable_access_token_here"
    }
}

V2

Custodian Account

{
    "status": 200,
    "message": "Create wallet successfully",
    "data": {
        "walletToken": "your_wallet_token_here",
        "refreshToken": "your_refresh_token_here",
        "secret0": "your_secret_here",
        "secret0Link": "temporary_link_to_download_secret0_file",
        "address": "your_address",
        "rampableAccessToken": "your_rampable_access_token_here"
    }
}

Non-Custodian Account

{
    "status": 200,
    "message": "Create wallet successfully",
    "data": {
        "walletToken": "your_wallet_token_here",
        "refreshToken": "your_refresh_token_here",
        "secret0Link": "https://passport.xellar.co/?download_recoverykey",
        "address": "your_address",
        "rampableAccessToken": "your_rampable_access_token_here"
    }
}