Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

This process tool plugin allows you to send ADA 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
titleNote

...

NameDescription
Network Type

Select the network to perform transactions on:

  • Mainnet
  • Testnet

"Mainnet" uses

real-world currency(s)

assets with actual monetary value.

Please use "Testnet" for testing purposes.

Backend Service

Select the backend service you wish to use to execute your blockchain queries/transactions with:

  • Blockfrost
  • Koios
Blockfrost Project Key

This property will only appear when Backend Service is Blockfrost.

The library used in this plugin integrates with Cardano node via Blockfrost backend APIs.

Go to blockfrost.io and sign up for an account. There is a free account option. Paste in your generated mainnet/testnet project API key. See blockfrost.io.

Transaction Details

NameDescription
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:

  • ADA
  • Native Token
  • NFT
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 funds assets from. Hash Variable is also accepted.

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.

Warning
titleCaution

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!

Receiver AddressAddress to send funds to. Hash Variable is also accepted.
Amount To Send (ADA)

Amount of ADA coin(s) to send.

Amount can only contain max 6 decimal places. Hash Variable is also accepted.

Enable Transaction MetadataIf enabled, additional configurations will be shown to allow embedding form data into the transaction metadata.
Form

Only available if Enable Transaction Metadata property is checked.

Select a form to retrieve form data.

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.
If Payment Type is NFT, this property is automatically hidden and is always set to 1.

Amount of tokens to send.

Amount can only contain max 6 decimal places. This rule applies for both ADA and native tokens.

Additional Metadata
MetadataMetadata

Only available if Enable Transaction Metadata property is checked.

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/.

Note

Transactions performed on the blockchain are publicly viewable, including its metadata,  as as it is intended primarily as a 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.

NameDescription
Receiver AddressSelect the respective column that represents the receiver addresses.
AmountSelect the respective column that represents the amount of assets to send to the respective receivers.

Store Response To Workflow Variable

NameDescription
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 IDTo 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.