zkcloudworker 0.7.3 → 0.7.4

Sign up to get free protection for your applications and to get access to all the features.
@@ -60,19 +60,20 @@ export declare abstract class Cloud {
60
60
  readonly isLocalCloud: boolean;
61
61
  /**
62
62
  * Constructor for the Cloud class
63
- * @param id: the id of the user
64
- * @param jobId: the job id
65
- * @param stepId: the step id
66
- * @param taskId: the task id
67
- * @param cache: the cache folder. Use it to get the Cache object: cache = Cache.FileSystem(this.cloud.cache);
68
- * @param developer: the developer id
69
- * @param repo: the repo id
70
- * @param task: the task id
71
- * @param userId: the user id
72
- * @param args: the arguments, should be a string or serialized JSON
73
- * @param metadata: the metadata, should be a string or serialized JSON
74
- * @param chain: the blockchain network
75
- * @param isLocalCloud: a boolean to check if the cloud is local or not
63
+ * @param params the parameters for the Cloud class
64
+ * @param params.id the id of the user
65
+ * @param params.jobId the job id
66
+ * @param params.stepId the step id
67
+ * @param params.taskId the task id
68
+ * @param params.cache the cache folder. Use it to get the Cache object: cache = Cache.FileSystem(this.cloud.cache);
69
+ * @param params.developer the developer id
70
+ * @param params.repo the repo id
71
+ * @param params.task the task id
72
+ * @param params.userId the user id
73
+ * @param params.args the arguments, should be a string or serialized JSON
74
+ * @param params.metadata the metadata, should be a string or serialized JSON
75
+ * @param params.chain the blockchain network
76
+ * @param params.isLocalCloud a boolean to check if the cloud is local or not
76
77
  */
77
78
  constructor(params: {
78
79
  id: string;
@@ -98,10 +99,10 @@ export declare abstract class Cloud {
98
99
  abstract getDeployer(): Promise<DeployerKeyPair | undefined>;
99
100
  /**
100
101
  * Abstract method to release the deployer
101
- * @param params: the public key of the deployer and the transactions hashes
102
+ * @param params the public key of the deployer and the transactions hashes
102
103
  * Used to release the deployer after the transactions are sent to the blockchain
103
- * @param publicKey: the public key of the deployer
104
- * @param txsHashes: the transactions hashes
104
+ * @param params.publicKey the public key of the deployer
105
+ * @param params.txsHashes the transactions hashes
105
106
  */
106
107
  abstract releaseDeployer(params: {
107
108
  publicKey: string;
@@ -110,46 +111,46 @@ export declare abstract class Cloud {
110
111
  /**
111
112
  * Abstract method to get the data by key
112
113
  * Used to get the data by key from the cloud storage
113
- * @param key: the key
114
+ * @param key the key
114
115
  * @returns the value of the key
115
116
  */
116
117
  abstract getDataByKey(key: string): Promise<string | undefined>;
117
118
  /**
118
119
  * Abstract method to save the data by key
119
120
  * Used to save the data by key to the cloud storage
120
- * @param key: the key
121
- * @param value: the value
121
+ * @param key the key
122
+ * @param value the value
122
123
  */
123
124
  abstract saveDataByKey(key: string, value: string | undefined): Promise<void>;
124
125
  /**
125
126
  * Abstract method to save the file
126
127
  * Used to save the file to the cloud storage
127
- * @param filename: the filename
128
- * @param value: the value
128
+ * @param filename the filename
129
+ * @param value the value
129
130
  */
130
131
  abstract saveFile(filename: string, value: Buffer): Promise<void>;
131
132
  /**
132
133
  * Abstract method to load the file
133
134
  * Used to load the file from the cloud storage
134
- * @param filename: the filename
135
+ * @param filename the filename
135
136
  * @returns the value of the file
136
137
  */
137
138
  abstract loadFile(filename: string): Promise<Buffer | undefined>;
138
139
  /**
139
140
  * Abstract method to load the environment
140
141
  * Used to load the environment from the cloud storage
141
- * @param password: the password
142
+ * @param password the password
142
143
  */
143
144
  abstract loadEnvironment(password: string): Promise<void>;
144
145
  /**
145
146
  * Abstract method to calculate the recursive proof
146
147
  * Used to calculate the recursive proof
147
- * @param data: the data
148
- * @param data.transactions: the transactions
149
- * @param data.task: the task
150
- * @param data.userId: the user id
151
- * @param data.args: the arguments
152
- * @param data.metadata: the metadata
148
+ * @param data the data
149
+ * @param data.transactions the transactions
150
+ * @param data.task the task
151
+ * @param data.userId the user id
152
+ * @param data.args the arguments
153
+ * @param data.metadata the metadata
153
154
  * @returns the proof
154
155
  */
155
156
  abstract recursiveProof(data: {
@@ -162,12 +163,12 @@ export declare abstract class Cloud {
162
163
  /**
163
164
  * Abstract method to execute the transactions
164
165
  * Used to execute the transactions
165
- * @param data: the data
166
- * @param data.transactions: the transactions
167
- * @param data.task: the task
168
- * @param data.userId: the user id
169
- * @param data.args: the arguments
170
- * @param data.metadata: the metadata
166
+ * @param data the data
167
+ * @param data.transactions the transactions
168
+ * @param data.task the task
169
+ * @param data.userId the user id
170
+ * @param data.args the arguments
171
+ * @param data.metadata the metadata
171
172
  * @returns the result
172
173
  */
173
174
  abstract execute(data: {
@@ -180,13 +181,13 @@ export declare abstract class Cloud {
180
181
  /**
181
182
  * Abstract method to add the task
182
183
  * Used to add the task
183
- * @param data: the data
184
- * @param data.task: the task
185
- * @param data.startTime: the start time
186
- * @param data.userId: the user id
187
- * @param data.args: the arguments
188
- * @param data.metadata: the metadata
189
- * @param data.maxAttempts: the maximum attempts
184
+ * @param data the data
185
+ * @param data.task the task
186
+ * @param data.startTime the start time
187
+ * @param data.userId the user id
188
+ * @param data.args the arguments
189
+ * @param data.metadata the metadata
190
+ * @param data.maxAttempts the maximum attempts
190
191
  * @returns the task id
191
192
  */
192
193
  abstract addTask(data: {
@@ -200,7 +201,7 @@ export declare abstract class Cloud {
200
201
  /**
201
202
  * Abstract method to delete the transaction
202
203
  * Used to delete the transaction
203
- * @param txId: the transaction id
204
+ * @param txId the transaction id
204
205
  */
205
206
  abstract deleteTransaction(txId: string): Promise<void>;
206
207
  /**
@@ -212,7 +213,7 @@ export declare abstract class Cloud {
212
213
  /**
213
214
  * Abstract method to delete the task
214
215
  * Used to delete the task
215
- * @param taskId: the task id
216
+ * @param taskId the task id
216
217
  */
217
218
  abstract deleteTask(taskId: string): Promise<void>;
218
219
  /**
@@ -222,7 +223,7 @@ export declare abstract class Cloud {
222
223
  /**
223
224
  * Abstract method to get the job result
224
225
  * Used to get the job result
225
- * @param jobId: the job id
226
+ * @param jobId the job id
226
227
  * @returns the job result
227
228
  */
228
229
  abstract jobResult(jobId: string): Promise<JobData | undefined>;
@@ -237,7 +238,7 @@ export declare abstract class zkCloudWorker {
237
238
  readonly cloud: Cloud;
238
239
  /**
239
240
  * Constructor for the zkCloudWorker class
240
- * @param cloud: the cloud instance provided by the zkCloudWorker in the local environment or in the cloud
241
+ * @param cloud the cloud instance provided by the zkCloudWorker in the local environment or in the cloud
241
242
  */
242
243
  constructor(cloud: Cloud);
243
244
  /**
@@ -247,20 +248,20 @@ export declare abstract class zkCloudWorker {
247
248
  deployedContracts(): Promise<DeployedSmartContract[]>;
248
249
  /**
249
250
  * Creates a new proof from a transaction
250
- * @param transaction: the transaction
251
+ * @param transaction the transaction
251
252
  * @returns the serialized proof
252
253
  */
253
254
  create(transaction: string): Promise<string | undefined>;
254
255
  /**
255
256
  * Merges two proofs
256
- * @param proof1: the first proof
257
- * @param proof2: the second proof
257
+ * @param proof1 the first proof
258
+ * @param proof2 the second proof
258
259
  * @returns the merged proof
259
260
  */
260
261
  merge(proof1: string, proof2: string): Promise<string | undefined>;
261
262
  /**
262
263
  * Executes the transactions
263
- * @param transactions: the transactions, can be empty list
264
+ * @param transactions the transactions, can be empty list
264
265
  * @returns the result
265
266
  */
266
267
  execute(transactions: string[]): Promise<string | undefined>;
@@ -1,37 +1,38 @@
1
1
  /*
2
- * Abstract class for the cloud
2
+ * Abstract class for the cloud service
3
3
  * Used to define the cloud methods and properties
4
4
  * Should be implemented by for local testing and for the zkCloudWorker in the cloud
5
- * @param id: the id of the user
6
- * @param jobId: the job id
7
- * @param stepId: the step id
8
- * @param taskId: the task id
9
- * @param cache: the cache folder. Use it to get the Cache object: cache = Cache.FileSystem(this.cloud.cache);
10
- * @param developer: the developer id
11
- * @param repo: the repo id
12
- * @param task: the task id
13
- * @param userId: the user id
14
- * @param args: the arguments, should be a string or serialized JSON
15
- * @param metadata: the metadata, should be a string or serialized JSON
16
- * @param chain: the blockchain network
17
- * @param isLocalCloud: a boolean to check if the cloud is local or not
5
+ * @param id the id of the user
6
+ * @param jobId the job id
7
+ * @param stepId the step id
8
+ * @param taskId the task id
9
+ * @param cache the cache folder. Use it to get the Cache object: cache = Cache.FileSystem(this.cloud.cache);
10
+ * @param developer the developer id
11
+ * @param repo the repo id
12
+ * @param task the task id
13
+ * @param userId the user id
14
+ * @param args the arguments, should be a string or serialized JSON
15
+ * @param metadata the metadata, should be a string or serialized JSON
16
+ * @param chain the blockchain network
17
+ * @param isLocalCloud a boolean to check if the cloud is local or not
18
18
  */
19
19
  export class Cloud {
20
20
  /**
21
21
  * Constructor for the Cloud class
22
- * @param id: the id of the user
23
- * @param jobId: the job id
24
- * @param stepId: the step id
25
- * @param taskId: the task id
26
- * @param cache: the cache folder. Use it to get the Cache object: cache = Cache.FileSystem(this.cloud.cache);
27
- * @param developer: the developer id
28
- * @param repo: the repo id
29
- * @param task: the task id
30
- * @param userId: the user id
31
- * @param args: the arguments, should be a string or serialized JSON
32
- * @param metadata: the metadata, should be a string or serialized JSON
33
- * @param chain: the blockchain network
34
- * @param isLocalCloud: a boolean to check if the cloud is local or not
22
+ * @param params the parameters for the Cloud class
23
+ * @param params.id the id of the user
24
+ * @param params.jobId the job id
25
+ * @param params.stepId the step id
26
+ * @param params.taskId the task id
27
+ * @param params.cache the cache folder. Use it to get the Cache object: cache = Cache.FileSystem(this.cloud.cache);
28
+ * @param params.developer the developer id
29
+ * @param params.repo the repo id
30
+ * @param params.task the task id
31
+ * @param params.userId the user id
32
+ * @param params.args the arguments, should be a string or serialized JSON
33
+ * @param params.metadata the metadata, should be a string or serialized JSON
34
+ * @param params.chain the blockchain network
35
+ * @param params.isLocalCloud a boolean to check if the cloud is local or not
35
36
  */
36
37
  constructor(params) {
37
38
  const { id, jobId, stepId, taskId, cache, developer, repo, task, userId, args, metadata, isLocalCloud, chain, } = params;
@@ -59,7 +60,7 @@ export class Cloud {
59
60
  export class zkCloudWorker {
60
61
  /**
61
62
  * Constructor for the zkCloudWorker class
62
- * @param cloud: the cloud instance provided by the zkCloudWorker in the local environment or in the cloud
63
+ * @param cloud the cloud instance provided by the zkCloudWorker in the local environment or in the cloud
63
64
  */
64
65
  constructor(cloud) {
65
66
  this.cloud = cloud;
@@ -74,7 +75,7 @@ export class zkCloudWorker {
74
75
  // Those methods should be implemented for recursive proofs calculations
75
76
  /**
76
77
  * Creates a new proof from a transaction
77
- * @param transaction: the transaction
78
+ * @param transaction the transaction
78
79
  * @returns the serialized proof
79
80
  */
80
81
  async create(transaction) {
@@ -82,8 +83,8 @@ export class zkCloudWorker {
82
83
  }
83
84
  /**
84
85
  * Merges two proofs
85
- * @param proof1: the first proof
86
- * @param proof2: the second proof
86
+ * @param proof1 the first proof
87
+ * @param proof2 the second proof
87
88
  * @returns the merged proof
88
89
  */
89
90
  async merge(proof1, proof2) {
@@ -92,7 +93,7 @@ export class zkCloudWorker {
92
93
  // Those methods should be implemented for anything except for recursive proofs
93
94
  /**
94
95
  * Executes the transactions
95
- * @param transactions: the transactions, can be empty list
96
+ * @param transactions the transactions, can be empty list
96
97
  * @returns the result
97
98
  */
98
99
  async execute(transactions) {
@@ -1 +1 @@
1
- {"version":3,"file":"cloud.js","sourceRoot":"","sources":["../../../../../src/cloud/cloud.ts"],"names":[],"mappings":"AA8CA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAgB,KAAK;IAezB;;;;;;;;;;;;;;;OAeG;IACH,YAAY,MAcX;QACC,MAAM,EACJ,EAAE,EACF,KAAK,EACL,MAAM,EACN,MAAM,EACN,KAAK,EACL,SAAS,EACT,IAAI,EACJ,IAAI,EACJ,MAAM,EACN,IAAI,EACJ,QAAQ,EACR,YAAY,EACZ,KAAK,GACN,GAAG,MAAM,CAAC;QACX,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,YAAY,GAAG,YAAY,IAAI,KAAK,CAAC;QAC1C,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CA2JF;AAED;;;;;GAKG;AACH,MAAM,OAAgB,aAAa;IAGjC;;;OAGG;IACH,YAAY,KAAY;QACtB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,iBAAiB;QACrB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,wEAAwE;IACxE;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAC,WAAmB;QAC9B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,KAAK,CAAC,MAAc,EAAE,MAAc;QACxC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,+EAA+E;IAC/E;;;;OAIG;IACH,KAAK,CAAC,OAAO,CAAC,YAAsB;QAClC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,mBAAmB,CAAC,YAAgC,IAAkB,CAAC;IAE7E;;;OAGG;IACH,KAAK,CAAC,IAAI;QACR,OAAO,SAAS,CAAC;IACnB,CAAC;CACF"}
1
+ {"version":3,"file":"cloud.js","sourceRoot":"","sources":["../../../../../src/cloud/cloud.ts"],"names":[],"mappings":"AA8CA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAgB,KAAK;IAezB;;;;;;;;;;;;;;;;OAgBG;IACH,YAAY,MAcX;QACC,MAAM,EACJ,EAAE,EACF,KAAK,EACL,MAAM,EACN,MAAM,EACN,KAAK,EACL,SAAS,EACT,IAAI,EACJ,IAAI,EACJ,MAAM,EACN,IAAI,EACJ,QAAQ,EACR,YAAY,EACZ,KAAK,GACN,GAAG,MAAM,CAAC;QACX,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,YAAY,GAAG,YAAY,IAAI,KAAK,CAAC;QAC1C,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CA2JF;AAED;;;;;GAKG;AACH,MAAM,OAAgB,aAAa;IAGjC;;;OAGG;IACH,YAAY,KAAY;QACtB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,iBAAiB;QACrB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,wEAAwE;IACxE;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAC,WAAmB;QAC9B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,KAAK,CAAC,MAAc,EAAE,MAAc;QACxC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,+EAA+E;IAC/E;;;;OAIG;IACH,KAAK,CAAC,OAAO,CAAC,YAAsB;QAClC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,mBAAmB,CAAC,YAAgC,IAAkB,CAAC;IAE7E;;;OAGG;IACH,KAAK,CAAC,IAAI;QACR,OAAO,SAAS,CAAC;IACnB,CAAC;CACF"}
@@ -17,11 +17,11 @@ export declare class LocalCloud extends Cloud {
17
17
  /**
18
18
  * Constructor for LocalCloud
19
19
  * @param params the parameters to create the LocalCloud
20
- * @param job the job data
21
- * @param chain the blockchain to execute the job on, can be any blockchain, not only local
22
- * @param cache the cache folder
23
- * @param stepId the step id
24
- * @param localWorker the worker to execute the tasks
20
+ * @param params.job the job data
21
+ * @param params.chain the blockchain to execute the job on, can be any blockchain, not only local
22
+ * @param params.cache the cache folder
23
+ * @param params.stepId the step id
24
+ * @param params.localWorker the worker to execute the tasks
25
25
  */
26
26
  constructor(params: {
27
27
  job: JobData;
@@ -12,11 +12,11 @@ export class LocalCloud extends Cloud {
12
12
  /**
13
13
  * Constructor for LocalCloud
14
14
  * @param params the parameters to create the LocalCloud
15
- * @param job the job data
16
- * @param chain the blockchain to execute the job on, can be any blockchain, not only local
17
- * @param cache the cache folder
18
- * @param stepId the step id
19
- * @param localWorker the worker to execute the tasks
15
+ * @param params.job the job data
16
+ * @param params.chain the blockchain to execute the job on, can be any blockchain, not only local
17
+ * @param params.cache the cache folder
18
+ * @param params.stepId the step id
19
+ * @param params.localWorker the worker to execute the tasks
20
20
  */
21
21
  constructor(params) {
22
22
  const { job, chain, cache, stepId, localWorker } = params;