@pipedream/overledger 0.1.0 → 1.0.0

package/README.md

@@ -0,0 +1,11 @@
+# Overview
+
+The Overledger API by Quant Network allows developers to interact with multiple blockchain networks. It facilitates the creation, reading, and execution of smart contracts and transactions across different blockchains. This API simplifies the complex nature of blockchain interoperability, enabling multi-chain applications (MApps) through a single gateway.
+
+# Example Use Cases
+
+- **Automated Multi-chain Financial Reporting**: Build a workflow on Pipedream that triggers monthly, pulling transaction data from various blockchains via the Overledger API. Integrate this data with Google Sheets or a similar app on Pipedream to generate consolidated financial reports.
+
+- **Cross-Blockchain Event Monitoring**: Set up a Pipedream workflow to monitor specific events (like transactions or smart contract interactions) across multiple blockchains using Overledger. This can trigger notifications via Slack or email when predefined conditions are met, such as unusual transaction volumes or large transfers.
+
+- **Decentralized Application (DApp) Management**: Develop a workflow in Pipedream that utilizes Overledger to deploy and manage smart contracts across different blockchains. The workflow could, for instance, automatically update or verify contracts on Ethereum and Binance Smart Chain when a GitHub repository is updated, using a combination of Overledger and GitHub triggers on Pipedream.

package/actions/execute-signed-transaction/execute-signed-transaction.mjs

@@ -4,29 +4,39 @@ export default {
   key: "overledger-execute-signed-transaction",
   name: "Execute Signed Transaction",
   description: "Executes a signed transaction by sending it to a blockchain node via Overledger. [See the documentation](https://developers.quant.network/reference/executesignedrequest)",
-  version: "0.0.1",
+  version: "0.0.3",
   type: "action",
   props: {
     overledger,
+    environment: {
+      propDefinition: [
+        overledger,
+        "environment",
+      ],
+    },
     requestId: {
       type: "string",
       label: "Request ID",
-      description: "The ID of the request for executing a signed transaction.",
+      description: "The Overledger identifier assigned to the related transaction preparation request. This should be set to the requestId parameter found in the response object of the 'Prepare a Smart Contract Transaction' Overledger action.",
     },
     signedTransaction: {
       type: "string",
       label: "Signed Transaction",
-      description: "The signed transaction data.",
+      description: "The raw transaction bytecode after signing. This should be set to the signed parameter found in the response object of the 'Sign a Transaction' Overledger action.",
       optional: true,
     },
   },
   async run({ $ }) {
+
+    const requestBody = {
+      requestId: this.requestId,
+      signedTransaction: this.signedTransaction,
+    };
+
     const response = await this.overledger.executeSignedTransaction({
       $,
-      data: {
-        requestId: this.requestId,
-        signedTransaction: this.signedTransaction,
-      },
+      environment: this.environment,
+      data: requestBody,
     });
 
     $.export("$summary", `Successfully executed signed transaction with Request ID ${this.requestId}`);

package/actions/prepare-smart-contract-transaction/prepare-smart-contract-transaction.mjs

@@ -8,10 +8,16 @@ export default {
   key: "overledger-prepare-smart-contract-transaction",
   name: "Prepare Smart Contract Transaction",
   description: "Prepares a smart contract transaction for signing on the Overledger platform. [See the documentation](https://developers.quant.network/reference/preparesmartcontractwrite)",
-  version: "0.0.1",
+  version: "0.0.3",
   type: "action",
   props: {
     overledger,
+    environment: {
+      propDefinition: [
+        overledger,
+        "environment",
+      ],
+    },
     locationTechnology: {
       type: "string",
       label: "Location Technology",
@@ -22,19 +28,19 @@ export default {
     signingAccountId: {
       type: "string",
       label: "Signing Account ID",
-      description: "The blockchain account that will sign the transaction.",
+      description: "The blockchain account ID/address that will be sending this transaction",
+    },
+    smartContractId: {
+      type: "string",
+      label: "Smart Contract ID",
+      description: "The ID/address of the smart contract to interact with.",
+
     },
     functionName: {
       type: "string",
       label: "Function Name",
       description: "The name of the function to call on the smart contract.",
     },
-    smartContractId: {
-      propDefinition: [
-        overledger,
-        "smartContractId",
-      ],
-    },
     inputParameters: {
       type: "string[]",
       label: "Input Parameters",
@@ -55,18 +61,21 @@ export default {
     return props;
   },
   async run({ $ }) {
+    const requestBody = {
+      location: {
+        technology: this.locationTechnology,
+        network: this.locationNetwork,
+      },
+      signingAccountId: this.signingAccountId,
+      functionName: this.functionName,
+      smartContractId: this.smartContractId,
+      inputParameters: parseObject(this.inputParameters), //parse these values using the parseObject function at this shouls turn the JSON string into JSON objects to used in the request body.
+    };
+
     const response = await this.overledger.prepareSmartContractTransaction({
       $,
-      data: {
-        location: {
-          technology: this.locationTechnology,
-          network: this.locationNetwork,
-        },
-        signingAccountId: this.signingAccountId,
-        functionName: this.functionName,
-        smartContractId: this.smartContractId,
-        inputParameters: this.inputParameters && parseObject(this.inputParameters),
-      },
+      environment: this.environment,
+      data: requestBody,
     });
     $.export("$summary", "Smart contract transaction prepared successfully");
     return response;

package/actions/read-from-a-smart-contract/read-from-a-smart-contract.mjs

@@ -0,0 +1,86 @@
+import {
+  NETWORK_OPTIONS, TECHNOLOGY_OPTIONS,
+} from "../../common/constants.mjs";
+import { parseObject } from "../../common/utils.mjs";
+import overledger from "../../overledger.app.mjs";
+
+export default {
+  key: "overledger-read-from-a-smart-contract",
+  name: "Read from a smart contract",
+  description: "Reads data from a specified smart contract on the Overledger network.",
+  version: "0.0.2",
+  type: "action",
+  props: {
+    overledger,
+    environment: {
+      propDefinition: [
+        overledger,
+        "environment",
+      ],
+    },
+    locationTechnology: {
+      type: "string",
+      label: "Location Technology",
+      description: "The technology of the blockchain that the transaction will be submitted to",
+      options: TECHNOLOGY_OPTIONS,
+      reloadProps: true,
+    },
+    functionName: {
+      type: "string",
+      label: "Function Name",
+      description: "The name of the function to call on the smart contract.",
+    },
+    inputParameters: {
+      type: "string[]",
+      label: "Input Parameters",
+      description: "The input parameters for the smart contract function, provide both type and value in object format. Example: {\"type\":\"uint256\",\"value\":\"5\"} or {\"type\":\"address\",\"value\":\"0x3....ed8\"}",
+      optional: true,
+      default: [],
+    },
+    smartContractId: {
+      type: "string",
+      label: "Smart Contract ID",
+      description: "The ID/address of the smart contract to interact with.",
+    },
+    outputParameters: {
+      type: "string[]",
+      label: "Output Parameters",
+      description: "Each output parameter expected, provide just the type in object format. Example - 1) function returns one uint256 value: {\"type\": \"uint256\"} or 2) function returns two address values: {\"type\": \"address\"},{\"type\": \"address\"}",
+      optional: true,
+      default: [],
+    },
+  },
+  async additionalProps() {
+    const props = {};
+    if (this.locationTechnology) {
+      props.locationNetwork = {
+        type: "string",
+        label: "Location Network",
+        description: "The blockchain network the transaction will be submitted to.",
+        options: NETWORK_OPTIONS[this.locationTechnology],
+      };
+    }
+    return props;
+  },
+  async run({ $ }) {
+
+    const requestBody = {
+      location: {
+        technology: this.locationTechnology,
+        network: this.locationNetwork,
+      },
+      functionName: this.functionName,
+      inputParameters: parseObject(this.inputParameters), //parse these values using the parseObject function at this shouls turn the JSON string into JSON objects to used in the request body.
+      smartContractId: this.smartContractId,
+      outputParameters: parseObject(this.outputParameters),
+    };
+      // Make the API call to Overledger
+    const response = await this.overledger.readFromSmartContract({
+      $,
+      environment: this.environment,
+      data: requestBody,
+    });
+    $.export("$summary", `Successfully read from contract: ${this.smartContractId}`);
+    return response;
+  },
+};

package/actions/sign-a-transaction/sign-a-transaction.mjs

@@ -0,0 +1,77 @@
+import overledger from "../../overledger.app.mjs";
+import {
+  TECHNOLOGY_OPTIONS, UNIT_OPTIONS,
+} from "../../common/constants.mjs";
+
+export default {
+  key: "overledger-sign-a-transaction",
+  name: "Sign a transaction",
+  description: "Sign a transaction using Overledger - Part 2 of [Overledger Pattern](https://developers.quant.network/reference/overledger-pattern). [See documentation](https://developers.quant.network/reference/sandboxsigning)",
+  version: "0.0.3",
+  type: "action",
+  props: {
+    overledger,
+    environment: {
+      propDefinition: [
+        overledger,
+        "environment",
+      ],
+    },
+    locationTechnology: {
+      type: "string",
+      label: "Location Technology",
+      description: "The blockchain technology used for this transaction, e.g., ethereum, substrate - required in order to set the dltfee",
+      options: TECHNOLOGY_OPTIONS,
+      reloadProps: true,
+    },
+    keyId: {
+      type: "string",
+      label: "Signing Account ID",
+      description: "The ID/address of the blockchain account that will sign the transaction.",
+    },
+    requestId: {
+      type: "string",
+      label: "Request ID",
+      description: "The Request ID assigned to a preparation request in Overledger. This should be set to the requestId parameter found in the response object of the 'Prepare Transaction' Overledger action.",
+    },
+    transactionSigningResponderName: {
+      type: "string",
+      label: "Transaction Signing Responder Name",
+      description: "The name of the Transaction Signing Responder you would like to use. The CTA Transaction Signing Responder is the Quant-provided signer for testnet accounts.",
+    },
+    nativeData: {
+      type: "object",
+      label: "Native Data",
+      description: "An object representing the transaction required to be signed - This should be set to the nativeData object of the 'Prepare Transaction' Overledger action.",
+    },
+  },
+  async run({ $ }) {
+    //default values of gatewayFee and dltfee hard coded into params.
+    const gatewayFee = {
+      amount: "0",
+      unit: "QNT",
+    };
+    // Define DLT Fee and dynamically set the 'unit/symbol' from UNIT_OPTIONS
+    const dltFee = {
+      amount: "0.000019897764079968",
+      unit: UNIT_OPTIONS[this.locationTechnology] || "ETH", // Use default if not found
+    };
+    // Sign the transaction
+    const requestBody = {
+      keyId: this.keyId,
+      gatewayFee: gatewayFee,
+      requestId: this.requestId,
+      dltFee: dltFee,
+      nativeData: this.nativeData,
+      transactionSigningResponderName: this.transactionSigningResponderName,
+    };
+
+    const response = await this.overledger.signTransaction({
+      $,
+      environment: this.environment,
+      data: requestBody,
+    });
+    $.export("$summary", "Transaction signed successfully");
+    return response;
+  },
+};

package/common/constants.mjs

@@ -24,15 +24,13 @@ export const TECHNOLOGY_OPTIONS = [
 export const NETWORK_OPTIONS = {
   "ethereum": [
     "ethereum sepolia testnet",
-    "ethereum goerli testnet",
     "ethereum mainnet",
-    "polygon mumbai testnet",
+    "polygon amoy testnet",
     "polygon mainnet",
     "avalanche fuji testnet",
     "avalanche c-chain mainnet",
     "xdc apothem testnet",
     "xdc network mainnet",
-    "Defined on demand",
   ],
   "substrate": [
     "polkadot westend",
@@ -50,3 +48,22 @@ export const NETWORK_OPTIONS = {
     "Sandbox",
   ],
 };
+//Overledger environment to be used - Test or Live
+export const OVERLEDGER_INSTANCE = [
+  {
+    label: "Sandbox",
+    value: "sandbox",
+  },
+  {
+    label: "Overledger",
+    value: "overledger",
+  },
+];
+///unit options to allow for the correct selection based on the location network
+export const UNIT_OPTIONS = {
+  "ethereum": "ETH",               // Ethereum's token symbol is ETH
+  "substrate": "DOT",              // Polkadot's token symbol is DOT
+  "xrp ledger": "XRP",             // XRP Ledger's token symbol is XRP
+  "bitcoin": "BTC",                // Bitcoin's token symbol is BTC
+  "hyperledger fabric": "FAB",     // Placeholder for Hyperledger Fabric's token symbol
+};

package/overledger.app.mjs

@@ -1,4 +1,5 @@
 import { axios } from "@pipedream/platform";
+import { OVERLEDGER_INSTANCE } from "./common/constants.mjs";
 
 export default {
   type: "app",
@@ -9,11 +10,14 @@ export default {
       label: "Smart Contract ID",
       description: "The ID of the smart contract to interact with.",
     },
+    environment: {
+      type: "string",
+      label: "Overledger Instance",
+      description: "Select the Overledger instance to be used",
+      options: OVERLEDGER_INSTANCE,
+    },
   },
   methods: {
-    _baseUrl() {
-      return "https://api.overledger.io";
-    },
     _headers() {
       return {
         "Authorization": `Bearer ${this.$auth.oauth_access_token}`,
@@ -21,12 +25,17 @@ export default {
         "API-Version": "3.0.0",
       };
     },
+    _getBaseUrl(environment) { //conditional for environment url selection.
+      return environment === "sandbox"
+        ? "https://api.sandbox.overledger.dev"
+        : "https://api.overledger.dev";
+    },
     _makeRequest({
-      $ = this, path, ...otherOpts
+      $ = this, environment, path, ...otherOpts
     }) {
       return axios($, {
         ...otherOpts,
-        url: this._baseUrl() + path,
+        url: this._getBaseUrl(environment) + path,
         headers: this._headers(),
       });
     },
@@ -37,6 +46,20 @@ export default {
         ...opts,
       });
     },
+    readFromSmartContract(opts = {}) {
+      return this._makeRequest({
+        method: "POST",
+        path: "/api/smart-contracts/read",
+        ...opts,
+      });
+    },
+    signTransaction(opts = {}) {
+      return this._makeRequest({
+        method: "POST",
+        path: "/api/transaction-signing-sandbox",
+        ...opts,
+      });
+    },
     executeSignedTransaction(opts = {}) {
       return this._makeRequest({
         method: "POST",
@@ -54,11 +77,12 @@ export default {
       });
     },
     deleteHook({
-      path, webhookId,
+      path, webhookId, ...opts
     }) {
       return this._makeRequest({
         method: "DELETE",
         path: `/api/webhooks/${path}/${webhookId}`,
+        ...opts,
       });
     },
   },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pipedream/overledger",
-  "version": "0.1.0",
+  "version": "1.0.0",
   "description": "Pipedream Overledger Components",
   "main": "overledger.app.mjs",
   "keywords": [

package/sources/common/base.mjs

@@ -6,6 +6,12 @@ import overledger from "../../overledger.app.mjs";
 export default {
   props: {
     overledger,
+    environment: {
+      propDefinition: [
+        overledger,
+        "environment",
+      ],
+    },
     db: "$.service.db",
     http: {
       type: "$.interface.http",
@@ -35,6 +41,7 @@ export default {
     async activate() {
       const response = await this.overledger.createHook({
         path: this.getPath(),
+        environment: this.environment,
         data: {
           location: {
             technology: this.locationTechnology,
@@ -51,6 +58,7 @@ export default {
       await this.overledger.deleteHook({
         path: this.getPath(),
         webhookId,
+        environment: this.environment,
       });
     },
   },

package/sources/new-contract-event-instant/new-contract-event-instant.mjs

@@ -6,7 +6,7 @@ export default {
   key: "overledger-new-contract-event-instant",
   name: "New Smart Contract Event (Instant)",
   description: "Emit new event when a smart contract releases a new event.",
-  version: "0.0.1",
+  version: "0.0.3",
   type: "source",
   dedupe: "unique",
   props: {

package/sources/watch-new-account-event-instant/watch-new-account-event-instant.mjs

@@ -6,7 +6,7 @@ export default {
   key: "overledger-watch-new-account-event-instant",
   name: "New Account Event (Instant)",
   description: "Emit new event for transactions to/from a specific account.",
-  version: "0.0.1",
+  version: "0.0.3",
   type: "source",
   dedupe: "unique",
   props: {
@@ -27,7 +27,7 @@ export default {
       };
     },
     getSummary(body) {
-      return `New asccount event with transaction Id: ${body.transactionId}`;
+      return `New account event with transaction Id: ${body.transactionId}`;
     },
   },
   sampleEmit,