Account
Account describes the concept of digital wallet, therefore including the public and private keys that either the customer or you would use to carry out the token exchange operations.
A customer can have multiple accounts linked to it, and each account can have multiple tokens linked to it.
NOTE
Under MiCAR regulations, Nexus cannot control the private keys of accounts holding tokens on behalf of our client or their customers. For this reason, when you create an account in Nexus, only the public key needs to be provided. Securely storing the private keys of your customers' accounts sits outside of Nexus. This also means that any transaction signatures needed specifically from your customers' accounts to carry out token exchange operations, needs to happen outside of Nexus, as to not expose the private key of your customer to us.
Types
In Nexus, we have two types of accounts. The main difference between the two sits with allowing all on-chain token functionality through the Nexus APIs for the one and only certain on-chain token functionality through the Nexus APIs for the other. See below the definitions for each account type, as well as a table indicating the different functionalities allowed for each.
- Managed: When creating a managed account, Nexus assumes the address supplied is a new address on the blockchain and validates this. Managed accounts are allowed all on-chain token functionality through the Nexus APIs, specifically including functionality that requires generated envelopes to be signed by the private key of the account.
- Unmanaged: When creating an unmanaged account, Nexus assumes the address supplied is an existing address on the blockchain and validates this. Unmanaged accounts are only allowed limited on-chain token functionality through the Nexus APIs, specifically not allowing functionality that requires generated envelopes to be signed by the private key of the account.
| Managed | Unmanaged | |
|---|---|---|
| Opt-in an account to a token on the blockchain and in Nexus | ✔️ | |
| Register a token on an account in Nexus, which already opted-in to that token outside of Nexus | ✔️ | ✔️ |
| Token transaction funding | ✔️ | ✔️ |
| Token transaction payments | ✔️ | |
| Token transaction payouts | ✔️ | |
| Token transaction clawbacks | ✔️ | ✔️ |
| Freeze or unfreeze an account on the blockchain | ✔️ | ✔️ |