CMTA FA2 Blueprint Implementation
This reference implementation provides an easy to use Tezos Token smart contract following the FA2 standard defined here. Capital Markets and technology association (CMTA) has provided guideance on implementing the required functionalities in order to tokeniza a Swiss corporation's equity securities. The blueprint document can be found here Blueprint
This implementation derived the required functionality from the CMTA20 project.
There are two main differences compared to the mentioned CMTA20 project:
- FA2 allows for multiple tokens on the same contract. This of course means that we can have per token an admin who gets the token 'owner' status as per CMTA20. Since 'owner' in FA2 receives another sematic we a use the expression 'token admin' to relate to the 'CMTA20 token owner' and 'token owners' for us are what CMTA20 calls 'holders'.
- For gas optimization purposes where it makes sense the entrypoints have been extended to accept lists. This allows for batched operations.
Glossary
- Owner (CMTA20): the administrator of a specific token_id (one per token_id).
- Holder (CMTA20): the token holder (n per token_id). In our context the actual shareholder.
- Administrator: the administrator of a specific token_id (one per token_id).
- Owner: the token holder (n per token_id). In our context the actual shareholder.
- Batch: allow for multiple changes/executions in one method call. Will always fail for all requests (and revert) in case a single one fails.
- Contact: contact data in bytes. This can be encrypted or unencrypted. Used for shareholder identity (recommended encrypted/not accessible for everyone) and/or token contact (readable for everyone) for shareholders.
- Plurals: plurals are used in the variable name to signal a list. If the plural does not make sense, we choose the _list postfix.
Build/Basic Usage
Dependencies
This project depends only on SmartPy, you can install SmartPy by doing a:
$ sh <(curl -s https://smartpy.io/cli/install.sh)
You can read more about the installation here: https://smartpy.io/cli/
If you feel lazy you can simply copy/paste the entire 'cmtaFA2.py' content into the web IDE: https://smartpy.io/ide
Build
$ /home/coder/smartpy-cli/SmartPy.sh compile cmtaFA2.py "CMTAFA2()" out
Test
$ /home/coder/smartpy-cli/SmartPy.sh test cmtaFA2.py out