Equity tokenization
Set up actors, verify compliance, mint 100,000 ACME shares, and distribute tokens to issuer and exchange through the DALP console.
Follow this runbook to complete the ACME Holdings equity scenario in the Console. By the end, ACME Holdings holds 80,000 ACME equity tokens, NovaX Vault holds 20,000, and your setup has applied identity and collateral checks.
Prerequisites
Before starting this example, ensure your blockchain network has the core platform contracts deployed. The table below lists each required contract.
| Contract | Purpose | Deployed by |
|---|---|---|
| DALP Directory | Registry and discovery service for all platform instances and their components | Platform deployer |
| DALP Identity Factory | Creates on-chain identity contracts for users | Platform deployer |
| DALP System Factory | Deploys organisation-specific system contracts | Platform deployer |
Additional requirements include access to the platform web interface, email addresses for all demo participants, and ETH or native tokens for transaction gas fees on public chains.
Gas requirements vary by persona on public chains.
| Persona | Gas needed |
|---|---|
| Daniel Admin | Moderate: system deployment and permission management |
| Clara Compliance | Small: user registration and verification issuance |
| Olivia Operator | Moderate: asset creation, permissions, minting, and transfers |
| Colin Collateral | Small: issuing collateral verifications |
| Invited users | Small: identity creation when using the invitation flow |
Scenario overview
This demonstration tokenizes 100,000 shares of ACME Holdings S.A., a Luxembourg company, using a multi-organisation platform operated by Digital Securities S.A.
Organizations
| Organisation | Role | Domain | Jurisdiction |
|---|---|---|---|
| Digital Securities S.A. | Platform operator | digital-securities.example | Luxembourg |
| ACME Holdings S.A. | Issuer (equity owner) | acme-holdings.example | Luxembourg |
| Guardian Collateral Services Ltd | Collateral agent | guardian-collateral.example | (generic) |
| Exchange Ltd | Exchange/vault provider | exchange.example | (generic) |
Key personas
Platform Operators (Digital Securities S.A.)
| Persona | Name | Purpose | |
|---|---|---|---|
| Platform Admin | Daniel Admin | [email protected] | System setup and configuration |
| Asset Operator | Olivia Operator | [email protected] | Asset creation and management |
| Compliance Officer | Clara Compliance | [email protected] | KYC and regulatory compliance |
External Partners
| Organisation | Persona | Name | Purpose | |
|---|---|---|---|---|
| ACME Holdings S.A. | Issuer Representative | Ian Issuer | [email protected] | Legal equity owner |
| Guardian Collateral Services | Collateral Agent | Colin Collateral | [email protected] | Collateral verification |
| Exchange Ltd | Vault Provider | NovaX Vault | [email protected] | Token custody |
ACME equity token specifications
Real-world instrument properties:
| Property | Value |
|---|---|
| Issuer | ACME Holdings S.A. (Luxembourg) |
| Security type | Ordinary shares |
| Total shares | 100,000 |
| Reference currency | EUR |
| Price per share | €0.71 |
On-chain representation properties:
| Property | Value |
|---|---|
| Token name | ACME Holdings Equity |
| Symbol | ACME |
| Decimals | 0 (1 token = 1 share) |
| Maximum supply | 100,000 |
| Asset class | EQUITY |
| ISIN | LU0000ACME01 |
| Final distribution after setup | 80,000 held by issuer, 20,000 held by exchange |
Implementation steps
Platform initialization
Start by setting up Daniel Admin as the platform administrator. He will initialize the entire system.
Follow the First Administrator Setup guide using these values: email [email protected], organisation name Digital Securities S.A., base currency EUR, and asset factories set to Equity.
Grant additional administrative permissions
Continue as Daniel Admin. After platform setup, he holds only the minimum required roles: Permission Manager and System Manager. This demo requires two more. Use the Change Admin Roles guide to add Add-on Manager (manages platform extensions and modules) and Identity Manager (required to invite other users).
Invite platform team
Continue as Daniel Admin. Add the other platform operators and external partners who will participate in this demo.
Use either the Invite users guide or the Create users guide. The invite flow sends email invitations so participants onboard themselves, which is more realistic. The create-user flow sets up accounts with random passwords for faster demo setup when participants do not need direct platform access.
Platform operators:
-
Olivia Operator ([email protected]): creates tokens, manages corporate events, handles minting/burning.
-
Clara Compliance ([email protected]): manages KYC and AML verification, registers identities, issues verifications.
External organizations:
-
Ian Issuer ([email protected]): legal owner of the equity being tokenized.
-
Colin Collateral ([email protected]): independently verifies collateral backing.
-
NovaX Vault ([email protected]): institutional vault provider for token custody. NovaX Vault receives 20,000 tokens in the final forced transfer step.
User onboarding process (if "Invite user" was chosen)
All invited users follow the same onboarding process. See User Onboarding for the complete flow.
Each invited user will accept their invitation, generate a blockchain wallet with PIN security, save backup codes, create an on-chain identity, and complete their profile.
Assign platform admins
Continue as Daniel Admin. After team onboarding, use Add Administrators to assign roles to platform admins.
Olivia Operator needs the Asset Manager role to create and configure new assets.
Clara Compliance needs four roles: Identity Manager (manages the users registry), Verification Issuer (issues KYC and compliance verifications), Compliance Manager (manages global compliance rules), and Verification Policy Manager (configures verification topics and trusted issuers). Clara owns all regulatory compliance and user verification.
Colin Collateral needs one role: Verification Issuer. Colin's only function is issuing collateral verifications.
Configure trusted issuers
Log in as Clara Compliance to set up the verification framework by designating who can issue which types of verifications.
Follow Configure Trusted Issuers to configure each issuer:
Clara Compliance as trusted issuer for investor-level verifications: add Clara for Know Your Customer (KYC) and Anti-Money Laundering (AML). Add Accredited Investor and Qualified Institutional Investor if the scenario requires those statuses. As Compliance Officer, Clara owns all investor-related verification.
Colin Collateral as trusted issuer for collateral verification: add Colin for the Collateral topic. Guardian Collateral Services is the independent third party verifying collateral backing.
Olivia Operator as trusted issuer for asset-level verifications: add Olivia for Base Price, Unique Identifier, Asset Classification, and Asset Location (the last is optional and needed only for real estate). As Asset Operator, Olivia manages asset metadata and classification.
Register investors in registry
Log in as Clara Compliance and use Register User. For both Ian Issuer and NovaX Vault, choose Luxembourg as jurisdiction. Both users then show "Registered" status and can receive KYC verifications.
Issue KYC and AML verifications
Continue as Clara Compliance and use Verify KYC. Issue Know Your Customer and Anti-Money Laundering verifications for both Ian Issuer and NovaX Vault. Both users now have the KYC and AML verifications the ACME token requires.
Create ACME equity token
Create the equity token using the Asset Designer with full compliance configuration.
Log in as Olivia Operator and follow Create Asset. Complete the Asset Designer configuration as follows.
Asset Class (step 1): select Flexible Income class, choose Equity type.
Basic Details (step 2): Name = ACME Holdings Equity, Symbol = ACME, Decimals = 0 (whole shares only), Jurisdiction = Luxembourg.
Asset Classification (step 3): Category = Common Equity, Class = Common Equity, Unique Identifier = LU0000ACME01 (ISIN format), Internal Reference = ACME-EQ-001.
Pricing (step 4): Currency = EUR, Base Price = 0.71 (€0.71 per share).
Compliance Modules (step 5): enable Identity verification with required expression AML and KYC, so only users with both accepted verifications can receive assets. Enable Collateral Requirement (optional) with topic "Collateral" at 100% ratio; the collateral verifier records backing for the tokenized equity example.
Configure token permissions
After asset creation, Olivia has the minimum required roles (Permission manager + Governance) following the principle of least privilege. For this demo, she needs additional token-specific roles.
Use Change Asset Admin Roles to assign Olivia Operator these additional roles: Custodian (execute transfers and forced transfers), Emergency (pause/unpause token operations), and Supply Management (mint and burn token supply).
Issue collateral verification
Colin must issue a collateral verification before minting is possible, because collateral modules block any mint until this step is complete.
Log in as Colin Collateral and follow the Collateral guide to issue verification with these details:
- Amount: 100000 (covering full supply)
- Expiration: 1 year from now
This confirms Guardian Collateral Services has verified sufficient backing for the full token supply.
Unpause the token
Log in as Olivia Operator and use the Pause/Unpause Asset guide to activate the ACME asset.
Olivia can unpause because she holds the Emergency role on the ACME token, which pause/unpause operations require.
Mint and distribute ACME tokens
Continue as Olivia Operator and use Mint Assets:
Mint to ACME Holdings:
- Recipient: Ian Issuer (select from contacts or use wallet address)
- Amount: 100000 (full token supply)
- Purpose: issue the complete supply to the legal issuer before the exchange allocation is moved by forced transfer
Execute forced transfer to exchange
Continue as Olivia Operator. Transfer 20,000 tokens from the issuer to the exchange using forced transfer capability.
Use Forced Transfer with these details:
Set the from address to ACME Holdings, the to address to NovaX Exchange, amount 20000, and purpose to allocate tokens to exchange for secondary market custody.
This demonstrates custodian-controlled movement between verified parties after issuance. Final holdings are 80,000 ACME tokens for ACME Holdings and 20,000 for NovaX Vault. Olivia can execute this transfer because she holds the Custodian role on the ACME token.
Troubleshooting
| Issue | Solution |
|---|---|
| Minting fails | • Ensure collateral verification covers the mint amount when enabled • Verify each recipient satisfies KYC and AML • Check the operator has the Supply Management role • Confirm the wallet has enough native gas tokens |
| User cannot receive assets | • Verify the user is registered in the identity registry • Ensure the user has KYC and AML verifications • Check token compliance requirements • Confirm the wallet address is correct |
| Verifications not trusted | • Verify issuer is configured as trusted for specific topic • Check verification data format and expiration • Ensure issuer transaction was confirmed • Refresh page after configuration changes |
| Role assignment fails | • Confirm you have role management permissions • Verify target user completed onboarding • Ensure user belongs to your organisation (for internal roles) • Check transaction has sufficient gas tokens for public chains |
Each row in the troubleshooting table links to the underlying cause. Consult the individual feature guides for the affected step when the table guidance does not resolve the issue.