This step is mandatory for all types of tokenized securities: bonds, shares, etc. The metadata contains certain basic information about the security (e.g. nominal value, ISIN, type of shares, etc.). According to eWpG regulations, this data must be already present on the blockchain before any distribution to investor can take place.
It is also the very last step in the token creation flow.
Once the token has been created and (if it's a bond) the terms of issuance document have been sent, you can trigger the endpoint Set Meta Data On Chain. This will send the required specific datapoints to the blockchain in a dedicated transaction:
The transaction contains the following data:
Use this endpoint to send the token metadata to the blockchain:
POST Send Token Details On Chain: /api/Tokenization/{institutionId}/tokenized-asset/{tokenizedAssetId}/send-token-metadata-on-chain
Request Example
# UAT BASE_URL: https://uat.vault.nyala.de
# Production BASE_URL: https://vault.nyala.de
# The {institutionId} is 8c8f78bc-78e0-47a7-b4e0-a793343175f0
# The {tokenizedAssetId} is ef86ea3e-f46f-4274-aad8-e83b1a241360
curl -X POST {{BASE_URL}}/api/Tokenization/{institutionId}/tokenized-asset/{tokenizedAssetId}/send-token-metadata-on-chain \
-H "X-API-KEY: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"passphrase": "{your-secure-passphrase}"
}'You will need to send the passphrase that you previously set for this project.
ℹ️ This action is immutable. If you made a mistake in the data, you must first patch the token details and re-trigger the Set Metadata operation. This will result in two Set Metadata operations visible on the blockchain.