Cardano Transaction Executor

Introduction

The Cardano Transaction Executor plugin is designed to handle user transactions on the Cardano network. It manages user wallets and facilitates different types of transactions within the blockchain environment, ensuring efficient processing and management of transaction data.

Get started

Prerequisites

  • The Cardano Default Backend Plugin should be configured for your network and backend service settings.
  • A Blockfrost account is required if Blockfrost is used as the backend service.

Where to get the plugin

You can download the Cardano Explorer Link Form Element from the JogetOSS GitHub repository.

How to install

  1. Click Download on this plugin screen (It will be a .jar file).
  2. Go to your Joget localhost or server. In the Joget Console, go to Admin Bar > Systems Settings > Manage Plugins and click the Upload Plugins button.
  3. Under Upload Plugin, select the plugin .jar file you downloaded and click Upload.
  4. Depending on the plugin type, you can now view your new plugin in your form, List, or UI Builder.
  5. Remember to uninstall the old plugin before uploading a new version.

Configure cardano transaction executor properties

Fields to configure:

  • Network Type: Select the type of Cardano network:
  • Backend Service: Configure the backend service. 
    Type
    • Blockfrost
    • Koios
  • Blockfrost Project Key: Use the Blockfrost Project Key to connect your app with the Cardano blockchain.

Transaction properties

Wallet configuration

  • Wallet Handler: Select a wallet handler:
    • Internal
    • CIP-30 Wallet
  • Form (Account Data): This property will only appear when Wallet Handler is Internal.
    Select a form to account for data from. 
    All fields from the selected form will be available for field mapping in the below sections.
  • Account Mnemonic Field: This property will only appear when the Wallet Handler is Internal.
    Fields available here depend on the form selected from the Form (Account Data) property.
  • Record ID (Account Data): This property will only appear when Wallet Handler is Internal.

    Enter the field ID associated with the record ID of the account data.

Transaction Parameters

  • Action to Perform: Select an action to perform:
  • Fee Limit (ADA): This property will only appear when Wallet Handler is Internal.
    The maximum limit for transaction fees in units of ADA.
    Note:
    Value can only contain a maximum of 6 decimal places.
    If this is empty, no limit is applied.
  • Transaction Metadata: The fields available here depend 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 Build with transaction metadata.

    Transactions performed on the blockchain, including their metadata, are publicly viewable, as it is intended primarily as an always-accessible proof of existence.
    Do NOT directly embed sensitive information in the transaction metadata.

Store response to form

  • Form: Select a form to store information about the newly minted asset.
    All fields from the selected form will be available for field mapping in the section below.
  • Is Transaction Validated: To indicate if this transaction has been successfully validated. 
    This value will typically start with a false value. It will automatically change to true only after the transaction has been confirmed/validated on the blockchain.
  • 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.

    Note that explorers typically have a short delay in syncing to the latest blockchain state to reflect your transactions.

Download plugin

Created by Julieth Last modified by Aadrian on Nov 19, 2024