Wallets

List Wallets

List Wallets

GET https://nchain.provide.services/api/v1/wallets

Returns a list of wallets in the authorized scope

Headers

Name	Type	Description
authorization	string	bearer <JWT> scoped to an Application, Organization or User

200: OK

[
    {
        "id": "a20a4b36-4793-43c2-bcf3-077e9c73bc8f",
        "created_at": "2021-08-17T01:42:18.839878Z",
        "user_id": "49a02f33-33f2-4d69-a301-ffb1933e77cc",
        "vault_id": "190822c9-62f5-4caf-a419-df735a793b2f",
        "key_id": "55295b7c-a29b-4fc3-a901-9d30082ebd60",
        "purpose": 44,
        "public_key": "xpub661MyMwAqRbcEuU2GgrffeNM1K3grU4MJ9dFYvadomYe3qB9Qtf151xzpZ7hQB693j1N5ongrouRg7cWNnRFmUhdvNBqcgYb5S4opevCcgC"
    },
    {
        "id": "d690c37a-ec36-49fd-8612-2da93356599a",
        "created_at": "2021-08-16T19:25:18.063619Z",
        "user_id": "49a02f33-33f2-4d69-a301-ffb1933e77cc",
        "vault_id": "190822c9-62f5-4caf-a419-df735a793b2f",
        "key_id": "b67fb1fb-5e07-448b-88c5-a3ae2fa4e51d",
        "purpose": 44,
        "public_key": "xpub661MyMwAqRbcEog1wst4megMhGjdE49GusZJUWCVhEBjQNsF8eXkCUwmKhVbQDiv9DqsteBgznMtYpGGgeSAtwpJfXqL9CLhrJ8i2RW4mni"
    }
]

Create Wallet

Create Wallet

POST https://nchain.provide.services/api/v1/wallets

Creates an HD (hierarchical deterministic) Wallet in accordance with BIP32.. A Wallet may be setup as custodial or non-custodial. If the wallet is custodial then the platform will derive addresses and securely persist an Account for each of those derived addresses.

Headers

Name	Type	Description
authorization	string	bearer <JWT> scoped to an Application, Organization or User

Request Body

Name	Type	Description
key_id	string	id of key to be used to derive Wallet
purpose	string	specification to be used by the HD node subtree; set to 44 for 44' (i.e., 0x8000002C following the BIP43 recommendation)
user_id	string	id of host User
vault_id	string	id of host Vault

201: Created

{
    "id": "dd62c471-09d4-46d2-b54f-485586d8778c",
    "created_at": "2021-08-17T01:50:25.472817293Z",
    "user_id": "49a02f33-33f2-4d69-a301-ffb1933e77cc",
    "vault_id": "190822c9-62f5-4caf-a419-df735a793b2f",
    "key_id": "37a1024e-f326-45e2-8036-97a0223e1099",
    "purpose": 44,
    "public_key": "xpub661MyMwAqRbcEckmZd5gAhUk3bMciVkEhN1dYfnZPzgTNNCnH26EjBH5ks3SabVHkbth42pKXZcXpyhC3o65XmkkrkKeRmgTphFs7G4nqJv"
}

List Wallet Accounts

List Wallet Accounts

GET https://nchain.provide.services/api/v1/wallets/:id/accounts

Retrieves a list of Account instances for a specified Wallet

Path Parameters

Name	Type	Description
id	string	id of host Wallet

Headers

Name	Type	Description
authorization	string	bearer <JWT> scoped to an Application, Organization or User

200: OK

[
    {
        "address": "0x65dabEf381CE60CCB0A6D5bEFC7F15bab6CaF107",
        "hd_derivation_path": "m/44'/60'/0'/0/0",
        "private_key": null,
        "public_key": null
    },
    {
        "address": "0x302004DE78B15E575308A4d09de24455c8A49Cef",
        "hd_derivation_path": "m/44'/60'/0'/0/0/0/1",
        "private_key": null,
        "public_key": null
    }
]