@primuslabs/por-client-sdk 0.1.0

package/README.md

@@ -0,0 +1,91 @@
+# PoR Client SDK
+
+## Overview
+
+The **PoR Client SDK** provides a client for interacting with **zkTLS** and **zkVM**, supporting authentication, program execution, and optional blockchain integration.
+
+
+## Build
+
+Install dependencies and build the project:
+
+```bash
+npm install
+npm run build
+```
+
+
+## Getting Started
+
+1. Copy `.env.example` to `.env` and configure your environment variables (see [Configuration](#configuration)).
+
+2. Ensure required fields are set:
+
+   * `TOKEN` and `PROJECT_ID` for authentication
+   * `PROGRAM_ID` for program execution
+
+3. Run an example:
+
+  ```bash
+  npx tsx example/okx.ts
+  ```
+
+
+## Configuration
+
+The SDK allows flexible configuration from **three sources**, applied in **priority order (highest to lowest)**:
+
+1. **Environment variables** (`.env` or `process.env`)
+2. **User-provided options** (passed to the `PoRClient` constructor)
+3. **Default values** defined in the SDK
+
+> Higher-priority values overwrite lower-priority values.
+
+### Configuration Fields and Defaults
+
+| Env Variable       | SDK Field        | Type   | Required / Conditions | Default                                | Description                                                |
+| ------------------ | ---------------- | ------ | --------------------- | -------------------------------------- | ---------------------------------------------------------- |
+| `TOKEN`            | `token`          | string | Required              | `""`                                   | Authentication token assigned by Primus Labs.              |
+| `PROJECT_ID`       | `projectId`      | string | Required              | `""`                                   | Project identifier associated with your account.           |
+| `PROGRAM_ID`       | `programId`      | string | Required              | `""`                                   | Program identifier for zkVM execution.                     |
+| `LOG_VERBOSE`      | `logVerbose`     | number | Optional              | `0`                                    | Logging verbosity level (`0` = off; higher = more detail). |
+| `RPC_URL`          | `rpcUrl`         | string | Optional              | `https://mainnet.base.org`             | RPC endpoint for blockchain interactions.                  |
+
+
+### User-provided Configuration Example
+
+```ts
+import { PoRClient } from "@primuslabs/por-client-sdk";
+
+const client = new PoRClient({
+  token: "my-token",
+  projectId: "my-project",
+  programId: "my-program",
+  logVerbose: 2,
+});
+```
+
+
+## Using the SDK
+
+```ts
+import { DataSource, PoRClient } from "@primuslabs/por-client-sdk";
+
+async function main() {
+  const ds = new DataSource.Okx();
+  const requestParams = ds.getSampleRequests();
+
+  const client = new PoRClient();
+  const result = await client.run(requestParams);
+
+  console.log("Result:", JSON.stringify(result));
+}
+
+main();
+```
+
+
+## Data Sources
+
+> TODO: Document supported data sources and sample requests.
+

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,52 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { ProverClient } from "./client/prover_client.js";
+import fs from "fs";
+async function main() {
+    const api = new ProverClient();
+    const program = new Command();
+    program
+        .command("uploadProgram")
+        .description("uploadProgram.")
+        .requiredOption("--filepath <FILEPATH>", "Program file path")
+        .option("--name <NAME>", "Program Name", "Default Name")
+        .option("--version <VERSION>", "Version number", "1.0")
+        .option("--description <DESCRIPTION>", "Description", "Default description.")
+        .action(async (opts) => {
+        console.log("uploadProgram");
+        const result = await api.uploadProgram(opts.filepath, 'My Program', '1.0', 'Program description');
+        console.log('Program uploaded, ID:', result.program_id);
+    });
+    program
+        .command("submitTask")
+        .description("submitTask.")
+        .requiredOption("--filepath <FILEPATH>", "Attestation data file path")
+        .action(async (opts) => {
+        console.log("submitTask");
+        const attestation_data = fs.readFileSync(opts.filepath, { encoding: "utf-8" });
+        const result = await api.submitTask(attestation_data);
+        console.log('Task submitted:', result);
+    });
+    program
+        .command("getResult")
+        .description("getResult.")
+        .requiredOption("--taskId <TASK_ID>", "Task id")
+        .action(async (opts) => {
+        console.log("getResult");
+        const result = await api.getResult(opts.taskId);
+        console.log('getResult:', result);
+    });
+    program
+        .command("submitTaskAndGetResult")
+        .description("submitTask and getResult.")
+        .requiredOption("--filepath <FILEPATH>", "Attestation data file path")
+        .action(async (opts) => {
+        console.log("submitTask and getResult.");
+        const attestation_data = fs.readFileSync(opts.filepath, { encoding: "utf-8" });
+        const result = await api.doZkVM(attestation_data);
+        console.log('result:', result);
+    });
+    program.parseAsync();
+}
+main();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,MAAM,IAAI,CAAC;AAEpB,KAAK,UAAU,IAAI;IACjB,MAAM,GAAG,GAAG,IAAI,YAAY,EAAE,CAAC;IAC/B,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,OAAO,CAAC,eAAe,CAAC;SACxB,WAAW,CAAC,gBAAgB,CAAC;SAC7B,cAAc,CAAC,uBAAuB,EAAE,mBAAmB,CAAC;SAC5D,MAAM,CAAC,eAAe,EAAE,cAAc,EAAE,cAAc,CAAC;SACvD,MAAM,CAAC,qBAAqB,EAAE,gBAAgB,EAAE,KAAK,CAAC;SACtD,MAAM,CAAC,6BAA6B,EAAE,aAAa,EAAE,sBAAsB,CAAC;SAC5E,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACrB,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QAC7B,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,EAAE,KAAK,EAAE,qBAAqB,CAAC,CAAC;QAClG,OAAO,CAAC,GAAG,CAAC,uBAAuB,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,YAAY,CAAC;SACrB,WAAW,CAAC,aAAa,CAAC;SAC1B,cAAc,CAAC,uBAAuB,EAAE,4BAA4B,CAAC;SACrE,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACrB,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAC1B,MAAM,gBAAgB,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;QAC/E,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;QACtD,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,WAAW,CAAC;SACpB,WAAW,CAAC,YAAY,CAAC;SACzB,cAAc,CAAC,oBAAoB,EAAE,SAAS,CAAC;SAC/C,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACrB,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACzB,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAChD,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAGL,OAAO;SACJ,OAAO,CAAC,wBAAwB,CAAC;SACjC,WAAW,CAAC,2BAA2B,CAAC;SACxC,cAAc,CAAC,uBAAuB,EAAE,4BAA4B,CAAC;SACrE,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACrB,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;QACzC,MAAM,gBAAgB,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;QAC/E,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;QAClD,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IAEL,OAAO,CAAC,UAAU,EAAE,CAAC;AACvB,CAAC;AAED,IAAI,EAAE,CAAC"}

package/dist/client/data_service_client.d.ts

@@ -0,0 +1,18 @@
+export interface ApiResponse<T> {
+    rc: 0 | 1;
+    mc: string;
+    msg: string;
+    result: T;
+}
+export interface SubmitTaskResult {
+    taskId: string;
+    taskTxHash: string;
+    taskAttestors: string[];
+}
+export declare class DataServiceClient {
+    private readonly client;
+    constructor(baseURL: string, timeout?: number);
+    submitTask(bizId: string, projectId: string, token: string): Promise<SubmitTaskResult>;
+    checkPayment(bizId: string, projectId: string, token: string): Promise<void>;
+    private unwrap;
+}

package/dist/client/data_service_client.js

@@ -0,0 +1,40 @@
+import axios from "axios";
+import { ClientError } from "../error.js";
+export class DataServiceClient {
+    client;
+    constructor(baseURL, timeout = 30_000) {
+        this.client = axios.create({ baseURL, timeout });
+    }
+    async submitTask(bizId, projectId, token) {
+        const res = await this.client.get("/public/program/submitTask", {
+            params: { bizId, projectId },
+            headers: {
+                "POR-TOKEN": token,
+            },
+        });
+        const raw = this.unwrap('submitTask', res.data);
+        return {
+            taskId: raw.taskId,
+            taskTxHash: raw.taskTxHash,
+            taskAttestors: raw.taskAttestors,
+        };
+    }
+    async checkPayment(bizId, projectId, token) {
+        const res = await this.client.get("/public/program/payment/check", {
+            params: { bizId, projectId },
+            headers: {
+                "POR-TOKEN": token,
+            },
+        });
+        this.unwrap('checkPayment', res.data);
+    }
+    unwrap(op, data) {
+        if (data.rc === 0) {
+            return data.result;
+        }
+        // data.rc === 1
+        const { mc, msg } = data;
+        throw new ClientError("72001", `${op} failed`, { op, mc, msg });
+    }
+}
+//# sourceMappingURL=data_service_client.js.map

package/dist/client/data_service_client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data_service_client.js","sourceRoot":"","sources":["../../src/client/data_service_client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAwB,MAAM,OAAO,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAe1C,MAAM,OAAO,iBAAiB;IACX,MAAM,CAAgB;IACvC,YAAY,OAAe,EAAE,UAAkB,MAAM;QACnD,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,UAAU,CACd,KAAa,EACb,SAAiB,EACjB,KAAa;QAEb,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAC/B,4BAA4B,EAC5B;YACE,MAAM,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE;YAC5B,OAAO,EAAE;gBACP,WAAW,EAAE,KAAK;aACnB;SACF,CACF,CAAC;QAEF,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;QAChD,OAAO;YACL,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,aAAa,EAAE,GAAG,CAAC,aAAa;SACjC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,YAAY,CAChB,KAAa,EACb,SAAiB,EACjB,KAAa;QAEb,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAC/B,+BAA+B,EAC/B;YACE,MAAM,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE;YAC5B,OAAO,EAAE;gBACP,WAAW,EAAE,KAAK;aACnB;SACF,CACF,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC;IAGO,MAAM,CAAI,EAAU,EAAE,IAAoB;QAChD,IAAI,IAAI,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC;YAClB,OAAO,IAAI,CAAC,MAAM,CAAC;QACrB,CAAC;QAED,gBAAgB;QAChB,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QACzB,MAAM,IAAI,WAAW,CAAC,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;IAClE,CAAC;CACF"}

package/dist/client/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./zktls_client";
+export * from "./prover_client";
+export * from "./por_client";

package/dist/client/index.js

@@ -0,0 +1,4 @@
+export * from "./zktls_client";
+export * from "./prover_client";
+export * from "./por_client";
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC"}

package/dist/client/por_client.d.ts

@@ -0,0 +1,12 @@
+import { Options, RequestParamsInput } from "../types.js";
+import { SdkConfig } from "../config.js";
+export declare class PoRClient {
+    private readonly config;
+    private zktlsClient;
+    private proverClient;
+    constructor(config?: SdkConfig);
+    /**
+     * zkTLS + zkVM (optional)
+     */
+    run(requestParams: RequestParamsInput, options?: Options): Promise<any>;
+}

package/dist/client/por_client.js

@@ -0,0 +1,36 @@
+import { saveToFile } from "../utils.js";
+import { getDefaultOptions } from "../types.js";
+import { ZkTLSClient } from "./zktls_client.js";
+import { ProverClient } from "./prover_client.js";
+import { resolveSdkConfig, printConfig } from "../config.js";
+export class PoRClient {
+    config;
+    zktlsClient;
+    proverClient;
+    constructor(config = {}) {
+        this.config = resolveSdkConfig(config);
+        printConfig(this.config, 'PoRClient');
+        this.zktlsClient = new ZkTLSClient(this.config);
+        this.proverClient = new ProverClient(this.config);
+    }
+    /**
+     * zkTLS + zkVM (optional)
+     */
+    async run(requestParams, options = {}) {
+        const opts = getDefaultOptions(options);
+        console.log("do zkTLS");
+        const attestationData = await this.zktlsClient.doZkTLS(requestParams, opts);
+        if (attestationData) {
+            // optional
+            saveToFile("attestation.json", JSON.stringify(attestationData));
+        }
+        if (opts.runZkvm && attestationData) {
+            console.log("do zkVM");
+            const result = await this.proverClient.doZkVM(JSON.stringify(attestationData));
+            console.log("result", result);
+            return result;
+        }
+        return attestationData;
+    }
+}
+//# sourceMappingURL=por_client.js.map

package/dist/client/por_client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"por_client.js","sourceRoot":"","sources":["../../src/client/por_client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAW,iBAAiB,EAAsB,MAAM,aAAa,CAAC;AAC7E,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAa,gBAAgB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAExE,MAAM,OAAO,SAAS;IACH,MAAM,CAAsB;IACrC,WAAW,CAAc;IACzB,YAAY,CAAe;IAEnC,YAAY,SAAoB,EAAE;QAChC,IAAI,CAAC,MAAM,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;QACvC,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QACtC,IAAI,CAAC,WAAW,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAChD,IAAI,CAAC,YAAY,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACpD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,aAAiC,EAAE,UAAmB,EAAE;QAChE,MAAM,IAAI,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;QAExC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACxB,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;QAC5E,IAAI,eAAe,EAAE,CAAC;YACpB,WAAW;YACX,UAAU,CAAC,kBAAkB,EAAE,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC,CAAC;QAClE,CAAC;QAED,IAAI,IAAI,CAAC,OAAO,IAAI,eAAe,EAAE,CAAC;YACpC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YACvB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC,CAAC;YAC/E,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAC9B,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,OAAO,eAAe,CAAC;IACzB,CAAC;CACF"}

package/dist/client/prover_client.d.ts

@@ -0,0 +1,14 @@
+import { SdkConfig } from "../config.js";
+export declare class ProverClient {
+    private readonly config;
+    private client;
+    constructor(config?: SdkConfig, timeout?: number);
+    uploadProgram(filePath: string, name: string, version: string, desc: string, prover?: string): Promise<any>;
+    submitTask(attestationData: string): Promise<any>;
+    getResult(taskId: string): Promise<any>;
+    private unwrap;
+    submitTaskWithRetry(attestationData: string, maxRetries?: number, baseDelay?: number): Promise<any>;
+    getResultWithTimeout(taskId: string, timeoutMs?: number, intervalMs?: number): Promise<any>;
+    private _doZkVM;
+    doZkVM(attestationData: string): Promise<any>;
+}

package/dist/client/prover_client.js

@@ -0,0 +1,121 @@
+import axios from "axios";
+import FormData from "form-data";
+import fs from "fs";
+import { resolveSdkConfig } from "../config.js";
+import { ClientError } from "../error.js";
+import { sleepMs, mockErrorReport, makeErrData } from "../utils.js";
+export class ProverClient {
+    config;
+    client;
+    constructor(config = {}, timeout = 30_000) {
+        this.config = resolveSdkConfig(config);
+        this.client = axios.create({ baseURL: this.config.zkvmServiceUrl, timeout });
+    }
+    async uploadProgram(filePath, name, version, desc, prover = "succinct") {
+        const form = new FormData();
+        form.append("file", fs.createReadStream(filePath));
+        form.append("prover", prover);
+        form.append("name", name);
+        form.append("version", version);
+        form.append("desc", desc);
+        const res = await this.client.post("/uploadProgram", form, {
+            headers: form.getHeaders()
+        });
+        return this.unwrap("uploadProgram", res.data);
+    }
+    async submitTask(attestationData) {
+        const form = new FormData();
+        form.append("zktls_mode", this.config.zktlsMode);
+        form.append("token", this.config.token);
+        form.append("project_id", this.config.projectId);
+        form.append("program_id", this.config.programId);
+        form.append("attestation_data", attestationData);
+        const res = await this.client.post("/submitTask", form, {
+            headers: form.getHeaders()
+        });
+        return this.unwrap("submitTask", res.data);
+    }
+    async getResult(taskId) {
+        const res = await this.client.get("/getResult", {
+            params: { task_id: taskId }
+        });
+        return this.unwrap("getResult", res.data);
+    }
+    unwrap(op, data) {
+        if (data.rc === 0) {
+            return data.result;
+        }
+        // data.rc === 1
+        const { mc, msg } = data;
+        throw new ClientError("73001", `${op} failed`, { op, mc, msg });
+    }
+    async submitTaskWithRetry(attestationData, maxRetries = 4, baseDelay = 1000) {
+        let attempt = 0;
+        const start = Date.now();
+        console.log("Submitting task...");
+        while (true) {
+            try {
+                const result = await this.submitTask(attestationData);
+                console.log(`Submitting task done (${Date.now() - start}ms):`, result);
+                return result;
+            }
+            catch (err) {
+                const NO_RETRY_CODES = ["73001"]; // from zkvm
+                if (err instanceof ClientError && NO_RETRY_CODES.includes(err.code))
+                    throw err;
+                attempt++;
+                if (attempt > maxRetries) {
+                    throw new ClientError("73002", `Submitting task failed after ${maxRetries} retries`, makeErrData(err));
+                }
+                const delay = baseDelay * 2 ** (attempt - 1);
+                console.warn(`Submitting task retrying in ${delay}ms...`);
+                await sleepMs(delay);
+            }
+        }
+    }
+    async getResultWithTimeout(taskId, timeoutMs = 600_000, intervalMs = 5000) {
+        const start = Date.now();
+        const isPending = (status) => status === undefined || status === "queued" || status === "running";
+        let errData = undefined;
+        while (true) {
+            const elapsed = Date.now() - start;
+            if (elapsed > timeoutMs) {
+                throw new ClientError("73003", `Timeout: cannot get task[${taskId}] complete result within ${timeoutMs}ms`, errData);
+            }
+            try {
+                const data = await this.getResult(taskId);
+                const { status } = data ?? {};
+                errData = { taskId, status };
+                if (!isPending(status)) {
+                    return data;
+                }
+            }
+            catch (err) {
+                const NO_RETRY_CODES = ["73001"]; // from zkvm
+                if (err instanceof ClientError && NO_RETRY_CODES.includes(err.code))
+                    throw err;
+                errData = makeErrData(err);
+            }
+            console.warn(`Getting result retrying in ${intervalMs}ms...`);
+            await sleepMs(intervalMs);
+        }
+    }
+    async _doZkVM(attestationData) {
+        try {
+            const submitResult = await this.submitTaskWithRetry(attestationData);
+            const result = await this.getResultWithTimeout(submitResult.task_id);
+            return result;
+        }
+        catch (err) {
+            if (!(err instanceof ClientError)) {
+                err = new ClientError("73099", `Do doZkVM failed`, makeErrData(err));
+            }
+            await mockErrorReport(err);
+            throw err;
+        }
+    }
+    async doZkVM(attestationData) {
+        return await this._doZkVM(attestationData);
+    }
+}
+//# sourceMappingURL=prover_client.js.map

package/dist/client/prover_client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prover_client.js","sourceRoot":"","sources":["../../src/client/prover_client.ts"],"names":[],"mappings":"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"}

package/dist/client/zktls_client.d.ts

@@ -0,0 +1,32 @@
+import { Options, RequestParamsInput } from "../types.js";
+import { SdkConfig } from "../config.js";
+export declare class ZkTLSClient {
+    private readonly config;
+    private primusNetwork;
+    constructor(config?: SdkConfig);
+    /**
+     * Initialize PrimusNetwork SDK
+     */
+    private _initializePrimusNetwork;
+    /**
+     * Submit zkTLS task with retry and exponential backoff
+     */
+    private _submitZkTLSTaskWithRetry;
+    /**
+     * Run attestation with retries
+     */
+    private _attestWithRetry;
+    /**
+     * Verify and poll task result with retries
+     */
+    private _verifyAndPollTaskResultWithRetry;
+    /**
+     * Prepare final zkVM attestation data
+     */
+    private _prepareZkVmRequestData;
+    /**
+     * Main entry: perform zkTLS attestation and task flow
+     */
+    private _doZkTLS;
+    doZkTLS(params: RequestParamsInput, options?: Options): Promise<any>;
+}

package/dist/client/zktls_client.js

@@ -0,0 +1,213 @@
+import { PrimusNetwork } from "@primuslabs/network-core-sdk";
+import { ethers } from "ethers";
+import { sleepMs, mockErrorReport, makeErrData } from "../utils.js";
+import { getDefaultOptions } from "../types.js";
+import { resolveSdkConfig } from "../config.js";
+import { ClientError } from "../error.js";
+import { DataServiceClient } from "./data_service_client.js";
+import { v4 as uuidv4 } from 'uuid';
+export class ZkTLSClient {
+    config;
+    primusNetwork;
+    constructor(config = {}) {
+        this.config = resolveSdkConfig(config);
+        this.primusNetwork = new PrimusNetwork();
+    }
+    /**
+     * Initialize PrimusNetwork SDK
+     */
+    async _initializePrimusNetwork(opts, wallet, chainId) {
+        try {
+            console.log("🚀 Initializing PrimusNetwork...");
+            const result = await this.primusNetwork.init(wallet, chainId, opts.noProxy === true ? "native" : undefined);
+            console.log("✅ PrimusNetwork initialized:", result);
+        }
+        catch (err) {
+            throw new ClientError("71002", `Initializing PrimusNetwork failed`, makeErrData(err));
+        }
+    }
+    /**
+     * Submit zkTLS task with retry and exponential backoff
+     */
+    async _submitZkTLSTaskWithRetry(_opts, attestParams, maxRetries = 4, baseDelay = 1000) {
+        let attempt = 0;
+        const start = Date.now();
+        console.log("📝 Submitting zkTLS task...");
+        while (true) {
+            try {
+                let result;
+                if (this.config.zktlsMode === "DVC") {
+                    result = await this.primusNetwork.submitTask(attestParams);
+                }
+                else if (this.config.zktlsMode === "POR") {
+                    const client = new DataServiceClient(this.config.dataServiceUrl);
+                    const bizId = uuidv4();
+                    const token = this.config.token;
+                    const projectId = this.config.projectId;
+                    result = await client.submitTask(bizId, projectId, token);
+                }
+                console.log(`✅ submitTask done (${Date.now() - start}ms):`, result);
+                return result;
+            }
+            catch (err) {
+                const NO_RETRY_CODES = ["72001"]; // from data service client
+                if (err instanceof ClientError && NO_RETRY_CODES.includes(err.code))
+                    throw err;
+                attempt++;
+                console.warn(`⚠️ submitTask attempt ${attempt} failed: ${err.message}`);
+                if (attempt > maxRetries) {
+                    throw new ClientError("71003", `Submitting zkTLS task failed after ${maxRetries} retries`, makeErrData(err));
+                }
+                const delay = baseDelay * 2 ** (attempt - 1);
+                console.warn(`⏳ submitTask retrying in ${delay}ms...`);
+                await sleepMs(delay);
+            }
+        }
+    }
+    /**
+     * Run attestation with retries
+     */
+    async _attestWithRetry(requestParams, opts, attestParams, submitResult, maxRetries = 4, baseDelay = 1000) {
+        let attempt = 0;
+        const start = Date.now();
+        console.log("⚙️ Running attestation...");
+        while (true) {
+            try {
+                const reqParams = opts.requestParamsCallback ? opts.requestParamsCallback() : requestParams;
+                if (reqParams.requests.length !== reqParams.responseResolves.length) {
+                    throw new ClientError("71001", `Request params size mismatch ${reqParams.requests.length} != ${reqParams.responseResolves.length}`);
+                }
+                const params = {
+                    ...attestParams,
+                    ...submitResult,
+                    requests: reqParams.requests,
+                    responseResolves: reqParams.responseResolves,
+                    sslCipher: opts.sslCipher,
+                    attMode: { algorithmType: opts.algorithmType },
+                    specialTask: opts.specialTask,
+                    noProxy: opts.noProxy,
+                    getAllJsonResponse: "true"
+                };
+                const result = await this.primusNetwork.attest(params, 5 * 60 * 1000);
+                console.log(`✅ attest done (${Date.now() - start}ms):`, result);
+                return result;
+            }
+            catch (err) {
+                attempt++;
+                if (err) {
+                    const info = {};
+                    if (err.code)
+                        info.code = err.code;
+                    if (err.message)
+                        info.message = err.message;
+                    if (err.data)
+                        info.data = err.data;
+                    console.warn(`⚠️ attest attempt ${attempt} failed: ${info}`);
+                    const NO_RETRY_CODES = ["71001"]; // TODO:
+                    if (info.code && NO_RETRY_CODES.includes(info.code)) {
+                        if (err instanceof ClientError)
+                            throw err;
+                        throw new ClientError("71004", `Attesting zkTLS failed`, makeErrData(err));
+                    }
+                }
+                if (attempt > maxRetries) {
+                    throw new ClientError("71005", `Attesting zkTLS failed after ${maxRetries} retries`, makeErrData(err));
+                }
+                const delay = baseDelay * 2 ** (attempt - 1);
+                console.warn(`⏳ attest retrying in ${delay}ms...`);
+                await sleepMs(delay);
+            }
+        }
+    }
+    /**
+     * Verify and poll task result with retries
+     */
+    async _verifyAndPollTaskResultWithRetry(attestResult, maxRetries = 4, baseDelay = 1000) {
+        let attempt = 0;
+        const start = Date.now();
+        console.log("🔍 Verifying task...");
+        while (true) {
+            try {
+                const result = await this.primusNetwork.verifyAndPollTaskResult({
+                    taskId: attestResult[0].taskId,
+                    reportTxHash: attestResult[0].reportTxHash
+                });
+                console.log(`✅ verify done (${Date.now() - start}ms):`, result);
+                return result;
+            }
+            catch (err) {
+                attempt++;
+                console.warn(`⚠️ verify attempt ${attempt} failed: ${err.message}`);
+                if (attempt > maxRetries) {
+                    throw new ClientError("71006", `Verifying task failed after ${maxRetries} retries`, makeErrData(err));
+                }
+                const delay = baseDelay * 2 ** (attempt - 1);
+                console.warn(`⏳ verify retrying in ${delay}ms...`);
+                await sleepMs(delay);
+            }
+        }
+    }
+    /**
+     * Prepare final zkVM attestation data
+     */
+    async _prepareZkVmRequestData(verifyType, attestResult) {
+        const taskId = attestResult[0].taskId;
+        const plainResponse = this.primusNetwork.getAllJsonResponse(taskId);
+        if (!plainResponse) {
+            throw new ClientError("71007", `Unable to get plain JSON response.`);
+        }
+        if (verifyType == 'HASH_COMPARISON') {
+            // todo!
+            return {
+                attestationData: {
+                    verification_type: Array.from({ length: plainResponse.length }, () => "HASH_COMPARISON"),
+                    public_data: attestResult,
+                    private_data: plainResponse
+                },
+                requestid: taskId
+            };
+        }
+        else {
+            return {};
+        }
+    }
+    /**
+     * Main entry: perform zkTLS attestation and task flow
+     */
+    async _doZkTLS(requestParams, options = {}) {
+        const startTime = Date.now();
+        const attestParams = {
+            address: "0x9b7706746c6e19AD5EB5c1DaeEa4b4C09EEC8a5f"
+        };
+        const opts = getDefaultOptions(options);
+        try {
+            const provider = new ethers.providers.JsonRpcProvider(this.config.rpcUrl);
+            const wallet = this.config.privateKey ? new ethers.Wallet(this.config.privateKey, provider) : provider;
+            const { chainId } = await provider.getNetwork();
+            await this._initializePrimusNetwork(opts, wallet, chainId);
+            const submitResult = await this._submitZkTLSTaskWithRetry(opts, attestParams);
+            const attestResult = await this._attestWithRetry(requestParams, opts, attestParams, submitResult);
+            await this._verifyAndPollTaskResultWithRetry(attestResult);
+            const zkVmRequestData = await this._prepareZkVmRequestData(requestParams.verifyType, attestResult);
+            console.log(`✅ Total execution time: ${Date.now() - startTime}ms`);
+            return zkVmRequestData;
+        }
+        catch (err) {
+            if (!(err instanceof ClientError)) {
+                err = new ClientError("71099", `Do zkTLS failed`, makeErrData(err));
+            }
+            await mockErrorReport(err);
+            throw err;
+        }
+    }
+    async doZkTLS(params, options = {}) {
+        const requestParams = Array.isArray(params) ? params : [params];
+        let attestations = [];
+        for (const reqParams of requestParams) {
+            const data = await this._doZkTLS(reqParams, options);
+            attestations.push(data.attestationData);
+        }
+        return attestations;
+    }
+}
+//# sourceMappingURL=zktls_client.js.map

package/dist/client/zktls_client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zktls_client.js","sourceRoot":"","sources":["../../src/client/zktls_client.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts

@@ -0,0 +1,16 @@
+import "dotenv/config";
+export interface SdkConfig {
+    token?: string;
+    projectId?: string;
+    programId?: string;
+    logVerbose?: number;
+    zkvmServiceUrl?: string;
+    dataServiceUrl?: string;
+    rpcUrl?: string;
+    privateKey?: string;
+    zktlsMode?: "POR" | string;
+}
+export declare function getDefaultConfig(): Required<SdkConfig>;
+export declare function loadConfigFromEnv(): SdkConfig;
+export declare function resolveSdkConfig(userConfig?: SdkConfig): Required<SdkConfig>;
+export declare function printConfig(config: SdkConfig, tag: string): void;

package/dist/config.js

@@ -0,0 +1,53 @@
+import "dotenv/config";
+export function getDefaultConfig() {
+    return {
+        token: "",
+        projectId: "",
+        programId: "",
+        logVerbose: 0,
+        zkvmServiceUrl: "https://api-por.primuslabs.xyz:38080",
+        dataServiceUrl: "http://api-dev.padolabs.org:38101",
+        rpcUrl: "https://mainnet.base.org",
+        privateKey: "",
+        zktlsMode: "POR",
+    };
+}
+export function loadConfigFromEnv() {
+    const envConfig = {
+        token: process.env.TOKEN?.trim(),
+        projectId: process.env.PROJECT_ID?.trim(),
+        programId: process.env.PROGRAM_ID?.trim(),
+        logVerbose: process.env.LOG_VERBOSE !== undefined ? Number(process.env.LOG_VERBOSE) : undefined,
+        zkvmServiceUrl: process.env.ZKVM_SERVICE_URL?.trim(),
+        dataServiceUrl: process.env.DATA_SERVICE_URL?.trim(),
+        rpcUrl: process.env.RPC_URL?.trim(),
+        privateKey: process.env.PRIVATE_KEY?.trim(),
+        zktlsMode: process.env.ZKTLS_MODE?.trim(),
+    };
+    // filter undefined field
+    return Object.fromEntries(Object.entries(envConfig).filter(([_, value]) => value !== undefined));
+}
+export function resolveSdkConfig(userConfig = {}) {
+    const config = {
+        ...getDefaultConfig(),
+        ...userConfig,
+        ...loadConfigFromEnv(),
+    };
+    // validate
+    if (config.zktlsMode === "POR") {
+        if (!config.token || !config.projectId || !config.programId) {
+            throw new Error("TOKEN, PROJECT_ID, PROGRAM_ID are required in POR mode");
+        }
+    }
+    return config;
+}
+export function printConfig(config, tag) {
+    const maskedConfig = {
+        ...config,
+        token: config.token ? `${config.token.slice(0, 6)}***` : undefined,
+        privateKey: config.privateKey ? `${config.privateKey.slice(0, 6)}***` : undefined,
+    };
+    const filterConfig = Object.fromEntries(Object.entries(maskedConfig).filter(([_, value]) => value !== undefined));
+    console.log(tag, "config", filterConfig);
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/datasource/binance.d.ts

@@ -0,0 +1,14 @@
+import { VERIFY_TYPE, RequestParams } from "../types.js";
+export interface BinanceAccount {
+    key: string;
+    secret: string;
+}
+export declare class Binance {
+    private accounts;
+    private readonly recvWindow;
+    constructor();
+    private loadAccounts;
+    getUnifiedAccountRequests(verifyType?: VERIFY_TYPE): RequestParams;
+    getSpotAccountRequests(verifyType?: VERIFY_TYPE): RequestParams;
+    getAccounts(): BinanceAccount[];
+}

package/dist/datasource/binance.js

@@ -0,0 +1,55 @@
+import ccxt from "ccxt";
+import { makeHashComparisonParams } from "./helper.js";
+export class Binance {
+    accounts;
+    recvWindow;
+    constructor() {
+        this.recvWindow = Number(process.env.BINANCE_RECV_WINDOW || 60) * 1000;
+        this.accounts = this.loadAccounts();
+    }
+    loadAccounts() {
+        const accounts = [];
+        const _add = (key, secret) => {
+            if (key && secret)
+                accounts.push({ key, secret });
+        };
+        _add(process.env.BINANCE_API_KEY, process.env.BINANCE_API_SECRET);
+        for (let i = 1; i <= 100; i++) {
+            _add(process.env[`BINANCE_API_KEY${i}`], process.env[`BINANCE_API_SECRET${i}`]);
+        }
+        if (accounts.length === 0) {
+            throw new Error("Please configure at least one set of BINANCE_API_KEY{i} / BINANCE_API_SECRET{i} in .env.");
+        }
+        const seen = new Set();
+        for (const acc of accounts) {
+            const key = `${acc.key}${acc.secret}`;
+            if (seen.has(key))
+                throw new Error("Duplicate BINANCE_API_KEY{i} detected");
+            seen.add(key);
+        }
+        return accounts;
+    }
+    getUnifiedAccountRequests(verifyType = 'HASH_COMPARISON') {
+        const signParams = { recvWindow: this.recvWindow };
+        const origRequests = [];
+        for (const acc of this.accounts) {
+            const exchange = new ccxt.binance({ apiKey: acc.key, secret: acc.secret });
+            origRequests.push(exchange.sign("um/positionRisk", "papi", "GET", signParams));
+            origRequests.push(exchange.sign("balance", "papi", "GET", signParams));
+        }
+        return makeHashComparisonParams(origRequests, verifyType);
+    }
+    getSpotAccountRequests(verifyType = 'HASH_COMPARISON') {
+        const origRequests = [];
+        const signParams = { recvWindow: this.recvWindow };
+        for (const acc of this.accounts) {
+            const exchange = new ccxt.binance({ apiKey: acc.key, secret: acc.secret });
+            origRequests.push(exchange.sign("account", "private", "GET", { ...signParams, omitZeroBalances: true }));
+        }
+        return makeHashComparisonParams(origRequests, verifyType);
+    }
+    getAccounts() {
+        return this.accounts;
+    }
+}
+//# sourceMappingURL=binance.js.map

package/dist/datasource/binance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"binance.js","sourceRoot":"","sources":["../../src/datasource/binance.ts"],"names":[],"mappings":"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"}

package/dist/datasource/helper.d.ts

@@ -0,0 +1,2 @@
+import { VERIFY_TYPE, RequestParams } from "../types.js";
+export declare function makeHashComparisonParams(origRequests: any[], verifyType: VERIFY_TYPE): RequestParams;

package/dist/datasource/helper.js

@@ -0,0 +1,34 @@
+export function makeHashComparisonParams(origRequests, verifyType) {
+    if (!Array.isArray(origRequests)) {
+        throw new Error("Invalid input: origRequests must be an array");
+    }
+    const requestParams = {
+        verifyType: 'HASH_COMPARISON',
+        requests: [],
+        responseResolves: [],
+    };
+    for (let i = 0; i < origRequests.length; i++) {
+        const origRequest = origRequests[i];
+        requestParams.requests.push({
+            url: origRequest.url,
+            method: "GET",
+            header: { ...origRequest.headers },
+            body: "",
+        });
+        if (verifyType == 'HASH_COMPARISON') {
+            requestParams.responseResolves.push([
+                {
+                    keyName: `${i}`,
+                    parseType: "json",
+                    parsePath: "$",
+                    op: "SHA256_EX",
+                },
+            ]);
+        }
+        else {
+            throw Error("not supported verify type");
+        }
+    }
+    return requestParams;
+}
+//# sourceMappingURL=helper.js.map

package/dist/datasource/helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helper.js","sourceRoot":"","sources":["../../src/datasource/helper.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,wBAAwB,CAAC,YAAmB,EAAE,UAAuB;IACnF,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IAED,MAAM,aAAa,GAAkB;QACnC,UAAU,EAAE,iBAAiB;QAC7B,QAAQ,EAAE,EAAE;QACZ,gBAAgB,EAAE,EAAE;KACrB,CAAC;IAEF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7C,MAAM,WAAW,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;QAEpC,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC;YAC1B,GAAG,EAAE,WAAW,CAAC,GAAG;YACpB,MAAM,EAAE,KAAK;YACb,MAAM,EAAE,EAAE,GAAG,WAAW,CAAC,OAAO,EAAE;YAClC,IAAI,EAAE,EAAE;SACT,CAAC,CAAC;QAEH,IAAI,UAAU,IAAI,iBAAiB,EAAE,CAAC;YACpC,aAAa,CAAC,gBAAgB,CAAC,IAAI,CAAC;gBAClC;oBACE,OAAO,EAAE,GAAG,CAAC,EAAE;oBACf,SAAS,EAAE,MAAM;oBACjB,SAAS,EAAE,GAAG;oBACd,EAAE,EAAE,WAAW;iBAChB;aACF,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,MAAM,KAAK,CAAC,2BAA2B,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAED,OAAO,aAAa,CAAC;AACvB,CAAC"}

package/dist/datasource/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./binance";
+export * from "./okx";

package/dist/datasource/index.js

@@ -0,0 +1,3 @@
+export * from "./binance";
+export * from "./okx";
+//# sourceMappingURL=index.js.map

package/dist/datasource/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/datasource/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,OAAO,CAAC"}

package/dist/datasource/okx.d.ts

@@ -0,0 +1,5 @@
+import { VERIFY_TYPE, RequestParams } from "../types.js";
+export declare class Okx {
+    constructor();
+    getSampleRequests(verifyType?: VERIFY_TYPE): RequestParams;
+}

package/dist/datasource/okx.js

@@ -0,0 +1,17 @@
+import { makeHashComparisonParams } from "./helper.js";
+export class Okx {
+    constructor() {
+    }
+    getSampleRequests(verifyType = 'HASH_COMPARISON') {
+        const origRequests = [
+            {
+                url: "https://www.okx.com/api/v5/public/instruments?instType=SPOT&instId=BTC-USD",
+                method: "GET",
+                header: {},
+                body: "",
+            }
+        ];
+        return makeHashComparisonParams(origRequests, verifyType);
+    }
+}
+//# sourceMappingURL=okx.js.map

package/dist/datasource/okx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"okx.js","sourceRoot":"","sources":["../../src/datasource/okx.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAIvD,MAAM,OAAO,GAAG;IACd;IACA,CAAC;IAEM,iBAAiB,CAAC,aAA0B,iBAAiB;QAClE,MAAM,YAAY,GAAU;YAC1B;gBACE,GAAG,EAAE,4EAA4E;gBACjF,MAAM,EAAE,KAAK;gBACb,MAAM,EAAE,EAAE;gBACV,IAAI,EAAE,EAAE;aACT;SACF,CAAC;QACF,OAAO,wBAAwB,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;IAC5D,CAAC;CAEF"}

package/dist/error.d.ts

@@ -0,0 +1,8 @@
+/**
+ *
+ */
+export declare class ClientError extends Error {
+    code: string;
+    data?: any;
+    constructor(code: string, message?: string, data?: any);
+}

package/dist/error.js

@@ -0,0 +1,14 @@
+/**
+ *
+ */
+export class ClientError extends Error {
+    code;
+    data;
+    constructor(code, message, data) {
+        super(message ?? "");
+        this.name = "ClientError";
+        this.code = code;
+        this.data = data;
+    }
+}
+//# sourceMappingURL=error.js.map

package/dist/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../src/error.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IACpC,IAAI,CAAS;IACb,IAAI,CAAO;IAEX,YAAY,IAAY,EAAE,OAAgB,EAAE,IAAU;QACpD,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./types";
+export * from "./utils";
+export * from "./client";
+export * as DataSource from "./datasource";

package/dist/index.js

@@ -0,0 +1,5 @@
+export * from "./types";
+export * from "./utils";
+export * from "./client";
+export * as DataSource from "./datasource";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,OAAO,KAAK,UAAU,MAAM,cAAc,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,17 @@
+import { AttNetworkRequest, AttNetworkResponseResolve } from "@primuslabs/network-core-sdk/dist/types";
+export type VERIFY_TYPE = "HASH_COMPARISON";
+export type RequestParams = {
+    verifyType: VERIFY_TYPE;
+    requests: AttNetworkRequest[];
+    responseResolves: AttNetworkResponseResolve[][];
+};
+export type RequestParamsInput = RequestParams | RequestParams[];
+export interface Options {
+    sslCipher?: string;
+    algorithmType?: string;
+    specialTask?: any;
+    noProxy?: boolean;
+    runZkvm?: boolean;
+    requestParamsCallback?: () => RequestParams;
+}
+export declare function getDefaultOptions(options: Options): Options;

package/dist/types.js

@@ -0,0 +1,12 @@
+export function getDefaultOptions(options) {
+    const defaults = {
+        sslCipher: "ECDHE-RSA-AES128-GCM-SHA256",
+        algorithmType: "mpctls",
+        specialTask: undefined,
+        noProxy: true,
+        runZkvm: true,
+        requestParamsCallback: undefined,
+    };
+    return { ...defaults, ...options };
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAkBA,MAAM,UAAU,iBAAiB,CAAC,OAAgB;IAChD,MAAM,QAAQ,GAAY;QACxB,SAAS,EAAE,6BAA6B;QACxC,aAAa,EAAE,QAAQ;QACvB,WAAW,EAAE,SAAS;QACtB,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,IAAI;QACb,qBAAqB,EAAE,SAAS;KACjC,CAAC;IACF,OAAO,EAAE,GAAG,QAAQ,EAAE,GAAG,OAAO,EAAE,CAAC;AACrC,CAAC"}

package/dist/utils.d.ts

@@ -0,0 +1,12 @@
+import { ClientError } from "./error.js";
+/**
+ * Save data to file
+ */
+export declare function saveToFile(filepath: string, data: string | Buffer): void;
+/**
+ * Sleep helper (ms)
+ */
+export declare function sleepMs(ms: number): Promise<void>;
+export declare function assertEnvVars<T extends Record<string, any>>(obj: T, keys: readonly (keyof T)[]): void;
+export declare function makeErrData(err: any): Record<string, any> | undefined;
+export declare function mockErrorReport(err: ClientError): Promise<void>;

package/dist/utils.js

@@ -0,0 +1,38 @@
+import fs from "fs";
+/**
+ * Save data to file
+ */
+export function saveToFile(filepath, data) {
+    fs.writeFileSync(filepath, data);
+}
+/**
+ * Sleep helper (ms)
+ */
+export async function sleepMs(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+export function assertEnvVars(obj, keys) {
+    for (const key of keys) {
+        if (!obj[key]) {
+            throw new Error(`❌ Missing required .env value: ${String(key)}`);
+        }
+    }
+}
+export function makeErrData(err) {
+    if (!err)
+        return undefined;
+    const errData = {};
+    if (err.code)
+        errData.code = err.code;
+    if (err.message)
+        errData.message = err.message;
+    if (err.data)
+        errData.data = err.data;
+    console.log("makeErrData:", errData);
+    return errData;
+}
+export async function mockErrorReport(err) {
+    // TODO:
+    console.log('mockErrorReport: ', JSON.stringify(err));
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AAGpB;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,QAAgB,EAAE,IAAqB;IAChE,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,EAAU;IACtC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,aAAa,CAAgC,GAAM,EAAE,IAA0B;IAC7F,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,kCAAkC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,GAAQ;IAClC,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAE3B,MAAM,OAAO,GAAwB,EAAE,CAAC;IACxC,IAAI,GAAG,CAAC,IAAI;QAAE,OAAO,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;IACtC,IAAI,GAAG,CAAC,OAAO;QAAE,OAAO,CAAC,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;IAC/C,IAAI,GAAG,CAAC,IAAI;QAAE,OAAO,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;IACtC,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;IACrC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,GAAgB;IACpD,QAAQ;IACR,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;AACxD,CAAC"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@primuslabs/por-client-sdk",
+  "version": "0.1.0",
+  "author": "Primus Labs <dev@primuslabs.org>",
+  "description": "Primus PoR client sdk",
+  "license": "ISC",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "bin": {
+    "por-cli": "./dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "jest",
+    "publish": "npm publish --access public"
+  },
+  "dependencies": {
+    "@primuslabs/network-core-sdk": "0.1.4",
+    "axios": "^1.13.2",
+    "ccxt": "^4.5.11",
+    "commander": "^14.0.1",
+    "dotenv": "^16.3.1",
+    "ethers": "^5.7.2",
+    "form-data": "^4.0.4",
+    "undici": "^7.16.0",
+    "uuid": "^13.0.0"
+  },
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "@types/node": "^24.10.2",
+    "ts-jest": "^29.4.6",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.3"
+  }
+}