User Guide
Compliance
Overview
Prerequisite
Ensure your Controller Wallet is active by validating its address in the upper right of the screen before following any steps.
Compliance Workflow
Create a Role
A Role is a defined set of rights (methods) that are available for a particular entity within the System; for example, depending on the use case, a Role could be an individual or an entity within an organization.
To create a new Role:
- 1
Go to Compliance
From the left-hand menu bar, select Compliance.
- 2
Select Roles
- 3
On the right side panel, click on "Create Role"
- 4
Populate the Role Name, Controller wallet and Description
Add Role to a Role Context
Note: You can also automatically associate a new Role with a Role Context during the process of creating the Role Context. After you create the Role Content, select Create Role at the bottom of the Role Context Created dialogue box.
To add a Role to a Role Context:
- 1
Go to Compliance
From the left-hand menu bar, select Compliance.
- 2
Select Role Context
All the available Role Contexts are listed.
- 3
Select the Role Context to which you want to add a Role
- 4
Select Add Role
All the available Roles that you can add to the Role Context will display.
- 5
Select the Role you want to add to this Role Context
- 6
Click Submit
Assign a Role to a Wallet
You must assign a Role to a wallet so you can control the permissions on that wallet. To add a Role to a Wallet:
- 1
Go to Compliance
From the left-hand menu bar, select Compliance.
- 2
Select Role Context. All the Roles that you have linked to that Role Context will appear in the panel on the right.
- 3
Select the Role that you want to assign the wallet to; for example, "Transfer Agent."
- 4
Select Add Wallet. In the pop-up dialogue box, add the wallet address of the Role that you want to assign the wallet to.
Note: If you do not already have the Role's wallet address, you will need to copy it from the Role information. If you have not already done so, perform the following steps:
- From the left-hand menu bar, select Compliance.
- Select Roles.
- Select the desired Role.
- Hover your mouse over the Role address and select the Copy icon.
- Return to the Role Context menu and re-select the Role Context.
- Paste the address into address field.
- 5
Click Submit.
- 6
Confirm the operation
If prompted, complete the operation by confirming the action with your wallet management tool.
For example, if you are using MetaMask, select Confirm in the prompt.
Create a Role Context
A Role Context is a smart contract that bundles multiple role names to create an on-chain user directory by linking roles name to wallet addresses. By adding a Role Context to a token, you can control the permissions and access for the token by individuals or entities within your organization.
To create a Role Context:
- 1
Go to Compliance
From the left-hand menu bar, select Compliance.
- 2
Select Role Context
- 3
From the creating Role Context dialogue box, populate the name for the Role; for example, "Transfer Agent."
- 4
Designate the Owner Wallet for the role context.
- 5
Select Create Context.
Add Role Context to a Token
If you have not yet created a Token, view the Create Token topic for instructions.
Prerequisite:
Confirm that your Controller Wallet is active by validating its address in the upper right of the screen.
To add a Role Context to a Token:
- 1
From the left-hand menu bar, select Tokenization.
- 2
From the list of available tokens, select the token to which you want to add a Role Content.
- 3
On the right panel, select the Roles & Permission tab.
- 4
Click on Add Context.
- 5
A list of all available Role Contexts displays. Click on the selector icon for the Role Context you wish to add.
- 6
Click on Submit.
- 7
Confirm the operation
If prompted, complete the operation by confirming the action with your wallet management tool.
For example, if you are using MetaMask, select Confirm in the prompt.
You can now modify the permissions for specific Roles based on the Token's strategy. See Assign Functions to a Role / Permissions Setup for instructions.
Remove Role Context from a Token
You can remove a Role Context from a token to manage the token's permissions.
Prerequisite:
Confirm that your Controller Wallet is active by validating its address in the upper right of the screen.
To remove a Role Context to a Token:
- 1
From the left-hand menu bar, select Tokenization.
- 2
From the list of available tokens, select a Token with a linked Role Context.
- 3
On the right-hand panel, select the Roles & Permissions tab.
- 4
Select the Role Context to remove, then click the Trash icon next to that Context.
- 5
Confirm you action in the dialog window.
- 6
Confirm the operation
If prompted, complete the operation by confirming the action with your wallet management tool.
For example, if you are using MetaMask, select Confirm in the prompt.
Role Functions / Permissions Setup
You can modify a token's permissions or what actions a Role can or cannot perform. For example, you may only want a specific role to have the capability to Mint a token.
To add a Role Context to a Token:
- 1
From the left-hand menu bar, select Tokenization.
- 2
From the list of available tokens, select the token whose permission you want to modify.
- 3
In the right hand panel, select the Roles & Permissions tab.
- 4
In the Override column, use the Select Role dropdown to modify the permissions for the Roles associated with the token.
- 5
Confirm the operation
If prompted, complete the operation by confirming the action with your wallet management tool.
For example, if you are using MetaMask, select Confirm in the prompt.
Create an Allow List
An Allow List is a distribution list of whitelisted tokens. An issuer uses this functionality when using multiple distributors. An Allow List can be linked to multiple tokens, enabling asset transfers to addresses listed in the whitelist.
You can add multiple wallets (or wallet addresses) to an Allow List. By creating a list of whitelisted wallets through an Allow List, you can manage that collection of wallet addresses by assigning them to a token (through the token's compliance function)
To create an Allow List:
- 1
Go to Compliance
From the left-hand menu bar, select Compliance.
- 2
Select Allow List.
- 3
Click Create Allow List.
- 4
In the Create Allow List dialogue box, name your Allow List.
Note: The Owner field is automatically populated with the Controller Wallet address; however, you can override it should that be a necessity for your configuration.
- 5
Click Create Context.
- 6
Confirm the operation
If prompted, complete the operation by confirming the action with your wallet management tool.
For example, if you are using MetaMask, select Confirm in the prompt.
Create a Master Allow List
A Master Allow List is an aggregate of selected Allow Lists. You can create multiple Master Allow Lists composed of overlapping Allow Lists depending on your compliance strategy.
To create a Master Allow List:
- 1
Go to Compliance
From the left-hand menu bar, select Compliance.
- 2
Select Master Allow List
- 3
Click on Create Master Allow List
- 4
In the Create Master Allow List dialogue box, name your Allow List
Note: The Owner field is automatically populated with the Controller Wallet address; however, you can override it should that be a necessity for your configuration
- 5
Click on Create Compliance
- 6
Confirm the operation
If prompted, complete the operation by confirming the action with your wallet management tool.
For example, if you are using MetaMask, select Confirm in the prompt.
Add Allow Lists to a Master Allow List
You can add unlimited Allow Lists to a Master Allow List. This functionality provides versatility in the management of tokens; you can create unique composites of Allow Lists (whitelisted Wallet addresses) associated with a digitized asset (or token).
- 1
Go to Compliance
From the left-hand menu bar, select Compliance.
- 2
Select Master Allow List that you want to add an Allow List
- 3
Select Add Allow List from the panel on the right
- 4
In the Add Allow List dialogue box:
- From the Contract Type dropdown, select Whitelist.
- In the Address field, enter the Allow List smart contract address. Note: If you do not already have the Allow List address, you can obtain it by returning to the Allow List menu, selecting the desired Allow List, and copying the address.
- 5
Click Submit
- 6
Confirm the operation
If prompted, complete the operation by confirming the action with your wallet management tool.
For example, if you are using MetaMask, select Confirm in the prompt.
Note: You can repeat these steps to add additional Allow Lists to a Master Allow List. The added Allow Lists will display on the right panel under the Allow List tab.
Add a Wallet to an Allow List
You can add a wallet to an existing Allow List. It is critical to add wallets to Allow Lists because if a wallet is not whitelisted in DTCC ComposerX Factory, the smart contract will not recognize its wallet.
- 1
Go to Compliance
From the left-hand menu bar, select Compliance.
- 2
Select Allow List
- 3
Select the Allow List that you wish to add a wallet
- 4
On the right hand panel, select the Wallets tab
- 5
Add the wallet address in the input field and click on Add Wallet
- 6
Confirm the operation
If prompted, complete the operation by confirming the action with your wallet management tool.
For example, if you are using MetaMask, select Confirm in the prompt.
Note: You can repeat these steps to add additional wallets to the Allow List.
Add Allow List to a Token
Adding an Allow List, or Master Allow List, to a Token allows you to manage the token's compliance functionality. When you associate any list with a token, all the whitelisted wallets associated within those lists are now associated with the token.
Info
You cannot add multiple Allow Lists to a token. You can only add an Allow List to a token with a Revokable Compliance strategy.
To add an Allow List or Master Allow List to a token:
- 1
Go to Tokenization
From the left-hand menu bar, select Tokenization.
- 2
Select the token that you want to associate with an Allow List.
The list of available tokens displays, select the token that you want to associate with an Allow List.
IMPORTANT:
Only a token with a Revocable Compliance strategy can be associated with an Allow List.
- 3
In the right-hand panel, select the Details tab.
- 4
Select +Add Compliance
- 5
Select from the list of available Master Allow Lists or Allow Lists in dialogue box.
- 6
Click Submit.
- 7
Confirm the operation
If prompted, complete the operation by confirming the action with your wallet management tool.
For example, if you are using MetaMask, select Confirm in the prompt.
Remove Allow List from Token
You can edit or remove Allow Lists or Master Allow Lists from a token. This allows you to continuously update the token's compliance settings and its associated wallets.
To remove an Allow List or Master Allow List from a token:
- 1
From the left-hand menu bar, select Tokenization.
- 2
From the list of available tokens, select a Token with linked Allow List or Master Allow List
- 3
On the right hand panel, select the Details tab.
- 4
Select the Allow List or Master Allow List that you would like to remove. Click on the Trash icon next to that List.
- 5
Confirm your action in the dialog window.
- 6
Confirm the operation
If prompted, complete the operation by confirming the action with your wallet management tool.
For example, if you are using MetaMask, select Confirm in the prompt.
Contact our sales team for more information
View answers to the most common questions about our platforms and services