What is an hdAccountId ?

An hdAccountId is essentially an alternative name for 'account' as defined in the BIP-44 Derivation Path. Conceptually, it functions like a container that can hold multiple different DLT assets, but it cannot hold the same DLT asset more than once.

An hdAccountId is assigned to a clientId on Quant Connect through Authorise. If Authorise permits a clientId to have multiple hdAccountId, users can manage the same type of DLT asset across different hdAccountId.

Prerequisites

• Create an account and generate your application's API keys
  Create an account on Quant Connect. Then, register your application to generate API keys to authorise your requests on Overledger APIs.

• Generate a Bearer Token You must generate an authentication token in order to use the Overledger APIs.

Service Providers

To enable seamless management of hdAccountId, Quant integrates with two leading custodial service providers: AWS Key Management Service (KMS) and Fireblocks' Direct Custodial Wallet. Each provider offers unique advantages, ensuring a secure and efficient environment for key management.

It's important to note that AWS KMS does not natively support HD wallets. Overwallet incorporates the concept of hdAccountId to enable seamless management of multiple DLT assets while interacting with AWS KMS.

Call the endpoint

Creating an hdAccountId is currently available via the endpoint:

https://hook.eu2.make.com/b2zp46pd8v071w1e7s51iqin1pqlil1p

To use this endpoint you must pass in your Quant Connect ClientId and the service provider ("awskms" or "fireblocks") as shown in the request body:

curl --request POST \
     --url https://hook.eu2.make.com/b2zp46pd8v071w1e7s51iqin1pqlil1p\
     --header 'Authorization: Bearer token' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "clientId": "6rigmpr3qtji7dbfolrsbdh4ic",
  "serviceProvider": "fireblocks"
}
'

If the request is successful you will receive a response with your new hdAccountId:

{
  "hdAccountId": 107
}