Web User Interface (UI)
Last updated
Last updated
The Asset Tokenization Studio (ATS) web user interface offers an easy-to-use platform for tokenizing and managing real-world assets (RWAs). It guides users through every feature, from setup to advanced asset management. By the end of this tutorial, you'll know how to set up assets, manage roles, and handle key tasks like corporate actions and regulatory compliance.
HashPack or MetaMask Wallet
To interact with the demo, you will need to first set up a Hedera Testnet account with testnet HBAR. After setting up an account, head to the interactive demo site (tokenization-studio.hedera.com) and connect your wallet:
Once your wallet is connected, click "Create new digital security" at the top right of the dashboard.
Choose the type of digital security to start the tokenization process and follow along.
Before we start tokenizing assets into digital securities, let's review some important regulatory information to understand the applicable restrictions and rules for both types (bonds and equities) of securities that ATS supports. The current jurisdiction for digital securities is limited to the United States, meaning all legal and regulatory frameworks concerning the issuance, management, and trading of the tokenized asset are in conformity with U.S. laws. While designed to be flexible for more jurisdictions in the near future, for the time being, all the offerings of tokenized instruments shall fall under the ambit of American laws.
Important: Please read the restrictions applicable to the selected regulation carefully and ensure your deal is compliant. Once published, these details cannot be altered. It is recommended to consult your legal and financial advisor for regulations applicable to your digital security.
The blocklist is responsible for prohibiting specific investors from participating in a tokenized offering. Investors from the countries mentioned on this blocklist would not be able to invest in the digital security. This functionality allows an issuer to adhere to particular legal, regulatory, or operational constraints applied to specific jurisdictions. For this, the issuer can select a country and then blocklist it to ensure that residents of that country do not create or participate in an offering.
Important: Investors from only the countries specified below will not be allowed to invest.
To initiate the creation of a new bond, choose New Bond and enter the basic details of the new bond:
Name: Bond's name.
Symbol: Bond's symbol.
Decimals: Number of decimals units (default is 6).
ISIN: International Security Identification Number - this can be any 12 alphanumeric characters.
Toggle the permissions you want to enable for your new bond:
Controllable: Enables token controller role and compliance operations.
Blocklist: Enables access control to the security using a list of blocked accounts.
Approval list: Enables access control to the security using a list of approved/allowed accounts.
Enter the bond details, such as the nominal value, number of bond units, starting (mint) date, and maturity date.
Number of Bond Units: The total number of bond tokens to be issued. Each unit represents a fraction of the overall bond and can be bought, sold, or transferred.
Nominal Value: The face value of each bond unit, which is the amount the issuer agrees to repay the bondholder at maturity.
Starting Date: The issuance or minting date of the bond, marking the official start of the bond's term. It is the date from which interest (coupon) payments start to accrue.
Maturity Date: The date when the bond reaches its full term, and the issuer is obligated to repay the bondholders the nominal value of the bond units, along with any remaining interest payments.
Define the bond's interest payment structure, including coupon type (fixed or custom), rate, payment frequency, and the first coupon date.
Coupon Type: The structure of the interest payments (coupons) that the bond will provide.
Fixed: A bond with a fixed coupon pays a set interest rate over its lifetime, regardless of market fluctuations.
Custom: A bond with zero coupons by default, but flexible or floating coupon rates can be added later. This option allows for custom interest structures through the "Set Coupons" tab.
Coupon Rate: The interest rate paid on each coupon. It is expressed as a percentage of the bond's nominal value and determines the periodic payments made to bondholders.
Coupon Frequency: Defines the interval between two consecutive coupon payments, measured in months (each month is assumed to have 30 days). For example, a frequency of 6 months means that bondholders will receive interest payments every six months.
First Coupon Date: The first date when a coupon payment will be recorded and made to bondholders. All subsequent coupon payment dates are automatically calculated based on the coupon frequency and the first coupon's date.
The blocklist is responsible for prohibiting specific investors from participating in a tokenized offering. Investors from the countries mentioned on this blocklist would not be able to invest in the digital security. This functionality allows an issuer to adhere to particular legal, regulatory, or operational constraints applied to specific jurisdictions. For this, the issuer can select a country and then blocklist it to ensure that residents of that country do not create or participate in an offering.
Important: Investors from only the countries specified below will not be allowed to invest.
Review the details of the new equity you are creating. Once you have confirmed that all the information is correct, click Create Bond and then Accept to finalize bond creation.
Please note that you will not be able to edit the details after the bond is created, so take your time to review them carefully.
To initiate the creation of new equity, choose New Equity and enter the basic details of the new equity:
Name: Equity's name.
Symbol: Equity's symbol.
Decimals: Number of decimals units (default is 6).
ISIN: International Security Identification Number - this can be any 12 alphanumeric characters (e.g., abc123456789, 111111111111, 1a2b3c4d5e6f).
Toggle the permissions you want to enable for your new equity:
Controllable: Enables token controller role and compliance operations.
Blocklist: Enables access control to the security using a list of blocked accounts.
Approval list: Enables access control to the security using a list of approved/allowed accounts.
Enter the specific details of the new equity, such as nominal value and number of shares, and select the applicable rights and privileges each token will hold.
Nominal Value: Value of each equity token in the selected currency.
Currency: USD (default).
Number of Shares: Equity's maximum supply.
Types of dividends available for equity holders, including none, preferred, and common dividends.
None: Equity holders won't receive dividends.
Preferred: Equity holders are entitled to preferential dividends that have to be paid before common dividends and may be at a fixed rate relative to nominal value.
Common: Equity holders enjoy common dividends that may vary and, if any is paid, after preferred.
The blocklist prohibits specific investors from participating in a tokenized offering. Investors from the countries mentioned on this blocklist cannot invest in digital security. This functionality allows an issuer to adhere to particular legal, regulatory, or operational constraints applied to specific jurisdictions. For this, the issuer can select a country and then blocklist it to ensure that residents of that country do not create or participate in an offering.
Important: Investors from only the countries specified below will not be allowed to invest.
Review the details of the new equity you are creating. Once you have confirmed that all the information is correct, click Create equity and then Accept to finalize equity creation.
Please note that you will not be able to edit the information after the equity is created, so take your time to carefully review the details.
In Asset Tokenization Studio (ATS), role management is a crucial feature that provides control over various functions related to the management and operation of digital securities. If your account is assigned the Admin Role, you can manage other roles for your security tokens, making governance easier and more secure.
To operate and manage digital securities within Asset Tokenization Studio, you must first assign roles to your connected wallet or account. Without the appropriate roles, you will not have the necessary permissions to perform operations such as minting tokens, managing corporate actions, or updating compliance settings. Be sure to grant yourself the required roles through the role management tab for each security to gain full access to manage your tokenized assets.
Roles you can manage include:
Admin: Grants full administrative privileges, including the ability to assign and manage all other roles.
Minter: Permits the account to mint new tokens, increasing the supply of the asset.
Controller: Authorizes the account to execute specific control actions over the tokenized asset, such as regulatory or operational updates.
Pause: Allows the account to temporarily halt all transactions for the asset, useful in emergencies or during maintenance.
Control List: Manages approval lists and blacklists, determining which accounts can or cannot participate in asset transactions.
Corporate Actions: Enables the execution of corporate actions like dividend distributions or token conversions.
Document: Grants the ability to manage and update asset-related documents, such as legal or compliance files.
Snapshot: Authorizes the creation of snapshots, capturing the state of token holder balances at a specific point in time for reporting or auditing purposes.
Connect your wallet and select the digital security you want to manage from the Admin (mode) dashboard.
Once the asset information loads, navigate to the "Role Management" tab to assign or modify roles. Enter the account ID to which you want to assign roles.
After assigning roles, ATS will display all operations available for each digital security based on the roles your account has been assigned. Simply click on the corresponding tab and follow the on-screen prompts to complete each operation. Here's a rundown of the available operations by dashboard mode:
Mint: Allows the creation of new tokens for the security, increasing the total supply based on the issuer’s parameters.
Force Transfer: Enables the transfer of tokens from one account to another without the token holder's consent, often used in cases of legal or regulatory necessity.
Dividends: Programs dividend payments for equity tokens, specifying how and when dividends will be distributed to token holders. It also provides an overview of all programmed dividend payouts, including past, pending, or upcoming payments, allowing the issuer or investor to track distributions.
Balances: Shows the balance of tokens held by various investors, offering a snapshot of current token holdings for the selected security.
Blocked List: Manages a list of blocked or restricted investors who are prohibited from participating in token transactions, ensuring compliance with KYC/AML requirements.
Voting Rights: Assigns, adjusts, or displays voting rights for security token holders, allowing them to participate in governance decisions, such as corporate actions or board elections.
Role Management: Enables the assignment and management of roles (e.g., Admin, Minter, Controller) for specific users, determining their permissions and access to various operations within the digital security.
Transfer: Allows token holders to send their security tokens to another account or wallet, following any compliance rules.
Redeem: Enables token holders to return their tokens to the issuer in exchange for cash, removing them from circulation.
Balance: Displays the token holder's current balance, providing a real-time view of the total tokens held for the selected asset.
🎉 Congrats on creating and managing your first digital security with Asset Tokenization Studio! You can view the transaction details on HashScan by looking up your new security token ID.
