Introduction
This process tool plugin allows you to send assets from one account to another on the Cardano blockchain, with option to also embed form data into the transaction metadata according to the CIP-20 standard.
Note
- Do ensure that the sender's account has sufficient balance for the amount of assets to send & its required transaction fee.
- Do ensure the amount sent complies with the minimum ADA value requirement, see: https://docs.cardano.org/native-tokens/minimum-ada-value-requirement. As of date of writing, the minimum is 1 ADA.
Plugin Properties
Configure Cardano Send Transaction Tool
| Name | Description |
|---|---|
| Network Type | Select the network to perform transactions on:
"Mainnet" uses assets with actual monetary value. Please use the testnets for testing purposes. |
| Backend Service | Select the backend service you wish to use to execute your blockchain queries/transactions with:
|
| Blockfrost Project Key | This property will only appear when Backend Service is Blockfrost. Paste in your generated mainnet/testnet project API key. See blockfrost.io. |
Transaction Details
| Name | Description |
|---|---|
| Form | Select a form to retrieve transaction data from. All fields from the selected form will be made available for field mapping in the sections below. |
| Asset Configuration | |
| Payment Type | Select the asset type to transfer:
|
| Policy ID | This property will only appear when Payment Type is Native Token or NFT. The policy ID that minted the token. Can use a Hash Variable or simply hardcoded. |
| Asset Name | This property will only appear when Payment Type is Native Token or NFT. The asset name of the token, e.g.: MyTestToken, My-First-NFT. Typically a Hash Variable is used here. |
| Payment Configuration | |
| Sender Address | Address to send assets from. |
| Sender Account Mnemonic Phrase | This is the sender's account secret key required in order to perform actions with the sender's account. Only accepts Hash Variable that points to the sender's encrypted stored mnemonic phrase. Caution Account Mnemonic Phrase MUST be strictly secured at all times, and only viewable to the intended user. Do NOT key in the plain-text mnemonic phrase here. Anyone who possesses this phrase has full unrestricted control and can do irreparable damage! |
| Enable Multiple Receivers | This property will only appear when Payment Type is ADA or Native Token. When this option is checked, you can pull multiple rows of data from a datalist to send assets to multiple receivers with their respective amounts. With this feature, all the receivers are compiled into a single transaction and executed atomically. Datalist To Retrieve Receivers property will appear for you to select an existing datalist in the current app. After then, the Datalist Column Mapping (Multiple Receivers Mode) configuration tab will be available for you to map datalist columns accordingly. |
| Datalist To Retrieve Receivers | This property will only appear when Enable Multiple Receivers is checked. Select an existing datalist in the current app. The plugin will reference the selected datalist here and automatically retrieve data via the Datalist Binder of the selected datalist. |
| Receiver Address | This property will only appear when Enable Multiple Receivers is not checked. Address to send assets to. |
| Amount To Send | This property will only appear when Enable Multiple Receivers is not checked. Amount of tokens to send. Amount can only contain max 6 decimal places. This rule applies for both ADA and native tokens. |
| Additional Metadata | |
| Metadata | Fields available here depends on the Form selected. Select the field(s) you wish to embed into the transaction metadata. Written transaction metadata follows the CIP-20 standard. To learn more about transaction metadata, see https://developers.cardano.org/docs/transaction-metadata/. Transactions performed on the blockchain are publicly viewable, including its metadata, as it is intended primarily as an always-accessible proof of existence. Do NOT directly embed sensitive information to the transaction metadata. |
Datalist Column Mapping (Multiple Receivers Mode)
This configuration tab will only appear when Enable Multiple Receivers property is checked.
The columns available here depends on the datalist selected in Datalist To Retrieve Receivers property.
| Name | Description |
|---|---|
| Receiver Address | Select the respective column that represents the receiver addresses. |
| Amount | Select the respective column that represents the amount of assets to send to the respective receivers. |
Store Response To Workflow Variable
| Name | Description |
|---|---|
| Is Transaction Successful | To indicate if this transaction has executed successfully. Returns true if successful, otherwise it returns false. You can use this value in your process to route your business logic and fully customize the user experience flow. |
| Is Transaction Validated | To indicate if this transaction has been successfully validated. This value will typically start with a false value. Only after the transaction has been confirmed/validated on the blockchain, only then this value will automatically be changed to true. |
| Transaction ID | To store the transaction ID of the transaction performed. |
| Transaction Explorer URL | To store an auto-generated URL to see transaction details on the official Cardano blockchain explorer. Do note that explorers typically has a short delay to sync to the latest blockchain state in order to reflect your transactions. |