zkcloudworker 0.11.7 → 0.11.8

package/lib/ts/src/cloud/networks.d.ts

@@ -1,33 +1,27 @@
 export { blockchain, MinaNetwork, networks, Mainnet, Devnet, Zeko, Lightnet, Local, };
 /**
- * blockchain is the type for the chain id
- * @param local the local chain id
- * @param devnet the devnet chain id
- * @param lightnet the lightnet chain id
- * @param mainnet the mainnet chain id
- * @param zeko the zeko chain id
- * @param mainnet the mainnet chain id
+ * blockchain is the type for the chain ID.
  */
-type blockchain = "local" | "devnet" | "lightnet" | "mainnet" | "zeko" | "mainnet";
+type blockchain = "local" | "devnet" | "lightnet" | "mainnet" | "zeko";
 /**
- * MinaNetwork is the data structure for a Mina network, keeping track of the mina and archive endpoints, chain id, name, account manager, explorer account url, explorer transaction url, and faucet
- * @param mina the mina endpoints
- * @param archive the archive endpoints
- * @param chainId the chain id
- * @param name the name of the network
- * @param accountManager the account manager for Lightnet
- * @param explorerAccountUrl the explorer account url
- * @param explorerTransactionUrl the explorer transaction url
- * @param faucet the faucet url
+ * MinaNetwork is the data structure for a Mina network, keeping track of the Mina and archive endpoints, chain ID, name, account manager, explorer account URL, explorer transaction URL, and faucet.
  */
 interface MinaNetwork {
+    /** The Mina endpoints */
     mina: string[];
+    /** The archive endpoints */
     archive: string[];
+    /** The chain ID */
     chainId: blockchain;
+    /** The name of the network (optional) */
     name?: string;
+    /** The account manager for Lightnet (optional) */
     accountManager?: string;
+    /** The explorer account URL (optional) */
     explorerAccountUrl?: string;
+    /** The explorer transaction URL (optional) */
     explorerTransactionUrl?: string;
+    /** The faucet URL (optional) */
     faucet?: string;
 }
 declare const Mainnet: MinaNetwork;

package/lib/ts/src/cloud/worker/cloud.d.ts

@@ -4,26 +4,27 @@ import { JobData } from "./job";
 import { TransactionMetadata } from "./transaction";
 /**
  * Interface for the deployer key pair
- * Used to get the public and private keys of the deployer for test networks only
- * Devnet and Zeko are supported
- * @param publicKey: the public key of the deployer
- * @param privateKey: the private key of the deployer
+ * Used to get the public and private keys of the deployer for test networks only.
+ * Devnet and Zeko are supported.
  */
 export interface DeployerKeyPair {
+    /** The public key of the deployer */
     publicKey: string;
+    /** The private key of the deployer */
     privateKey: string;
 }
 /**
  * Interface for the cloud transaction
  * Used to get the transaction id, the transaction, and the time received
- * @param txId: the transaction id
- * @param transaction: the transaction
- * @param timeReceived: the time received
  */
 export interface CloudTransaction {
+    /** The transaction id */
     txId: string;
+    /** The transaction */
     transaction: string;
+    /** The time received */
     timeReceived: number;
+    /** The status of the transaction */
     status: string;
 }
 export declare abstract class Cloud {

package/lib/ts/src/cloud/worker/job.d.ts

@@ -1,85 +1,87 @@
 import { blockchain } from "../networks";
 export type JobStatus = "created" | "started" | "finished" | "failed" | "used" | "restarted";
 /**
- * LogStream is a subset of the log stream data returned by AWS CloudWatch Logs when running the worker
- * https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/cloudwatch-logs/command/GetLogEventsCommand/
- * example:
+ * LogStream is a subset of the log stream data returned by AWS CloudWatch Logs when running the worker.
+ * @see {@link https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/cloudwatch-logs/command/GetLogEventsCommand/}
+ *
+ * Example:
+ * ```
  * {
- * logGroupName: '/aws/lambda/zkcloudworker-dev-test',
- * logStreamName: '2024/05/09/[$LATEST]52d048f64e894d2e8ba2800df93629c5'
- * awsRequestId: '581d0d45-9165-47e8-84d9-678599938811',
+ *   logGroupName: '/aws/lambda/zkcloudworker-dev-test',
+ *   logStreamName: '2024/05/09/[$LATEST]52d048f64e894d2e8ba2800df93629c5',
+ *   awsRequestId: '581d0d45-9165-47e8-84d9-678599938811'
  * }
- * @param logGroupName the log group name
- * @param logStreamName the log stream name
- * @param awsRequestId the AWS request ID
+ * ```
  */
 export interface LogStream {
+    /** The log group name */
     logGroupName: string;
+    /** The log stream name */
     logStreamName: string;
+    /** The AWS request ID */
     awsRequestId: string;
 }
 /**
- * JobData is the data structure for a job, keeping track of the job status, result, logs, and metadata
- * @param id the id of the user
- * @param jobId the id of the job
- * @param taskId the id of the task
- *
- * @param developer the developer of the repo executing the job
- * @param repo the repo executing the job
- *
- * @param task the task to execute
- * @param userId the id of the user
- * @param args the arguments for the job
- * @param metadata the metadata for the job
- * @param chain the blockchain to execute the job on
- * @param filename the filename where transactions data is stored
- * @param txNumber the number of transactions
- * @param timeCreated the time the job was created
- * @param timeStarted the time the job was started
- * @param timeFinished the time the job was finished
- * @param timeFailed the time the job failed
- * @param timeUsed the time the job result was used
- * @param jobStatus the status of the job
- * @param billedDuration the duration the job was billed for in ms
- * @param logStreams the log streams of the job
- * @param logs the logs of the job
- * @param isFullLog whether the logs are full
+ * JobData is the data structure for a job, keeping track of the job status, result, logs, and metadata.
  */
 export interface JobData {
+    /** The ID of the user */
     id: string;
+    /** The ID of the job */
     jobId: string;
+    /** The ID of the task (optional) */
     taskId?: string;
+    /** The developer of the repo executing the job */
     developer: string;
+    /** The repo executing the job */
     repo: string;
+    /** The task to execute (optional) */
     task?: string;
+    /** The ID of the user (optional) */
     userId?: string;
+    /** The arguments for the job (optional) */
     args?: string;
+    /** The metadata for the job (optional) */
     metadata?: string;
+    /** The blockchain to execute the job on */
     chain: blockchain;
+    /** The filename where transactions data is stored (optional) */
     filename?: string;
+    /** The number of transactions */
     txNumber: number;
+    /** The time the job was created */
     timeCreated: number;
+    /** The time the job was started (optional) */
     timeStarted?: number;
+    /** The time the job was finished (optional) */
     timeFinished?: number;
+    /** The time the job failed (optional) */
     timeFailed?: number;
+    /** The time the job result was used (optional) */
     timeUsed?: number;
+    /** The status of the job */
     jobStatus: JobStatus;
+    /** The duration the job was billed for in ms (optional) */
     billedDuration?: number;
+    /** The result of the job (optional) */
     result?: string;
+    /** The log streams of the job (optional) */
     logStreams?: LogStream[];
+    /** The logs of the job (optional) */
     logs?: string[];
+    /** Whether the logs are full (optional) */
     isFullLog?: boolean;
 }
 /**
- * JobData is the data structure for a job, keeping track of the job status, result, logs, and metadata
- * @param jobId the id of the job
- * @param eventTime the time the event occurred
- * @param jobStatus the status of the job
- * @param result the result of the job
+ * JobEvent is the data structure for a job events, keeping track of the job status changes.
  */
 export interface JobEvent {
+    /** The ID of the job */
     jobId: string;
+    /** The time the event occurred */
     eventTime: number;
+    /** The status of the job */
     jobStatus: JobStatus;
+    /** The result of the job (optional) */
     result?: string;
 }

package/lib/ts/src/cloud/worker/task.d.ts

@@ -1,34 +1,32 @@
 import { blockchain } from "../networks";
 /**
- * TaskData is the data structure for a task, keeping track of the task status, result, logs, and metadata
- * @param id the id of the user
- * @param taskId the id of the task
- *
- * @param startTime the time the task was started
- * @param timeCreated the time the task was created
- * @param maxAttempts the maximum number of attempts
- * @param attempts the number of attempts
- *
- * @param developer the developer of the repo executing the task
- * @param repo the repo executing the task
- * @param task the task to execute
- * @param userId the id of the user
- * @param args the arguments for the task
- * @param metadata the metadata for the task
- * @param chain the blockchain to execute the task on
+ * TaskData is the data structure for a task, keeping track of the task status, result, logs, and metadata.
  */
 export interface TaskData {
+    /** The ID of the user */
     id: string;
+    /** The ID of the task */
     taskId: string;
+    /** The time the task was started (optional) */
     startTime?: number;
+    /** The time the task was created */
     timeCreated: number;
+    /** The maximum number of attempts (default is 5) (optional) */
     maxAttempts?: number;
+    /** The number of attempts */
     attempts: number;
+    /** The developer of the repo executing the task */
     developer: string;
+    /** The repo executing the task */
     repo: string;
+    /** The task to execute */
     task: string;
+    /** The ID of the user (optional) */
     userId?: string;
+    /** The arguments for the task (optional) */
     args?: string;
+    /** The metadata for the task (optional) */
     metadata?: string;
+    /** The blockchain to execute the task on */
     chain: blockchain;
 }

package/lib/ts/src/cloud/worker/worker.d.ts

@@ -3,9 +3,9 @@ import { Cloud, CloudTransaction } from "./cloud";
  * Abstract class for the zkCloudWorker
  * Used to define the zkCloudWorker methods and properties
  * Should be implemented for by the developer for the zkCloudWorker in the cloud
- * @param cloud: the cloud
  */
 export declare abstract class zkCloudWorker {
+    /**  cloud: the cloud instance */
     readonly cloud: Cloud;
     /**
      * Constructor for the zkCloudWorker class

package/lib/ts/src/cloud/worker/worker.js

@@ -5,7 +5,6 @@ exports.zkCloudWorker = void 0;
  * Abstract class for the zkCloudWorker
  * Used to define the zkCloudWorker methods and properties
  * Should be implemented for by the developer for the zkCloudWorker in the cloud
- * @param cloud: the cloud
  */
 class zkCloudWorker {
     /**

package/lib/ts/src/mina/local/local.d.ts

@@ -223,41 +223,45 @@ export declare class LocalCloud extends Cloud {
     forceWorkerRestart(): Promise<void>;
 }
 /**
- * LocalStorage is a local storage for the local cloud
- * It stores jobs, tasks, transactions, and data
- * It can be used to test the cloud functionality without deploying to the cloud
- * @param jobs the jobs
- * @param data the data
- * @param transactions the transactions
- * @param tasks the tasks
+ * LocalStorage is a local storage for the local cloud.
+ * It stores jobs, tasks, transactions, and data.
+ * It can be used to test the cloud functionality without deploying to the cloud.
  */
 export declare class LocalStorage {
+    /** The jobs */
     static jobs: {
         [key: string]: JobData;
     };
+    /** The job events */
     static jobEvents: {
         [key: string]: JobEvent;
     };
+    /** The data */
     static data: {
         [key: string]: string;
     };
+    /** The files */
     static files: {
         [key: string]: Buffer;
     };
+    /** The transactions */
     static transactions: {
         [key: string]: CloudTransaction;
     };
+    /** The tasks */
     static tasks: {
         [key: string]: TaskData;
     };
     /**
-     * Saves the data
-     * @param name the name to save the data
+     * Saves the data.
+     * @param name The name to save the data under.
+     * @throws Error Method not implemented to keep web compatibility.
      */
     static saveData(name: string): Promise<void>;
     /**
-     * Loads the data
-     * @param name the name to load the data
+     * Loads the data.
+     * @param name The name to load the data from.
+     * @throws Error Method not implemented to keep web compatibility.
      */
     static loadData(name: string): Promise<void>;
 }

package/lib/ts/src/mina/local/local.js

@@ -446,18 +446,15 @@ class LocalCloud extends cloud_1.Cloud {
 }
 exports.LocalCloud = LocalCloud;
 /**
- * LocalStorage is a local storage for the local cloud
- * It stores jobs, tasks, transactions, and data
- * It can be used to test the cloud functionality without deploying to the cloud
- * @param jobs the jobs
- * @param data the data
- * @param transactions the transactions
- * @param tasks the tasks
+ * LocalStorage is a local storage for the local cloud.
+ * It stores jobs, tasks, transactions, and data.
+ * It can be used to test the cloud functionality without deploying to the cloud.
  */
 class LocalStorage {
     /**
-     * Saves the data
-     * @param name the name to save the data
+     * Saves the data.
+     * @param name The name to save the data under.
+     * @throws Error Method not implemented to keep web compatibility.
      */
     static async saveData(name) {
         throw new Error("Method not implemented to keep web compatibility.");
@@ -468,11 +465,12 @@ class LocalStorage {
             tasks: LocalStorage.tasks,
         };
         const filename = name + ".cloud";
-        //await saveFile({ data, filename });
+        // await saveFile({ data, filename });
     }
     /**
-     * Loads the data
-     * @param name the name to load the data
+     * Loads the data.
+     * @param name The name to load the data from.
+     * @throws Error Method not implemented to keep web compatibility.
      */
     static async loadData(name) {
         throw new Error("Method not implemented to keep web compatibility.");
@@ -488,9 +486,15 @@ class LocalStorage {
     }
 }
 exports.LocalStorage = LocalStorage;
+/** The jobs */
 LocalStorage.jobs = {};
+/** The job events */
 LocalStorage.jobEvents = {};
+/** The data */
 LocalStorage.data = {};
+/** The files */
 LocalStorage.files = {};
+/** The transactions */
 LocalStorage.transactions = {};
+/** The tasks */
 LocalStorage.tasks = {};

package/lib/ts/src/mina/utils/mina.d.ts

@@ -2,14 +2,14 @@ export { initBlockchain, accountBalance, accountBalanceMina, MinaNetworkInstance
 import { Mina, PublicKey, UInt64, Field } from "o1js";
 import { blockchain, MinaNetwork } from "../../cloud";
 /**
- * MinaNetworkInstance is the data structure for a Mina network instance, keeping track of the keys, network, and network id hash
- * @param keys the keys for the deployers
- * @param network the network
- * @param networkIdHash the network id hash
+ * MinaNetworkInstance is the data structure for a Mina network instance, keeping track of the keys, network, and network ID hash.
  */
 interface MinaNetworkInstance {
+    /** The keys for the deployers */
     keys: Mina.TestPublicKey[];
+    /** The network */
     network: MinaNetwork;
+    /** The network ID hash */
     networkIdHash: Field;
 }
 declare let currentNetwork: MinaNetworkInstance | undefined;

package/lib/ts/src/mina/verification/verification.d.ts

@@ -7,6 +7,7 @@ import { SmartContract } from "o1js";
  * programDependencies: The zk programs that need to be compiled before verification.
  * address: The address of the smart contract on the blockchain.
  * chain: The blockchain on which the smart contract is deployed.
+ * image: The logo of the smart contract (public url)
  *
  * Contract, contractDependencies, and programDependencies should be exported from the repo
  */
@@ -16,4 +17,5 @@ export interface VerificationData {
     programDependencies?: any[];
     address: string;
     chain: blockchain;
+    image?: string;
 }