@openserv-labs/client 2.0.2 → 2.1.2

package/dist/workflows-api.d.ts

@@ -1,5 +1,5 @@
 import type { PlatformClient } from "./client";
-import type { WorkflowConfig, TaskDefinition, EdgeDefinition, Edge } from "./types";
+import type { WorkflowConfig, TaskDefinition, EdgeDefinition, Edge, ImportWeb3WalletRequest, SignFeedbackAuthResponse, Web3Wallet } from "./types";
 import type { TriggerConfig } from "./triggers-api";
 import { Workflow } from "./workflow";
 /**
@@ -159,5 +159,114 @@ export declare class WorkflowsAPI {
     private getTriggerName;
     private resolveEdgeRef;
     private resolveNodeId;
+    /**
+     * Get the web3 wallet associated with a workspace.
+     *
+     * @param params - Parameters
+     * @param params.id - The workflow (workspace) ID
+     * @returns The web3 wallet details
+     *
+     * @example
+     * ```typescript
+     * const wallet = await client.workflows.getWallet({ id: 123 });
+     * console.log(wallet.address, wallet.deployed, wallet.erc8004AgentId);
+     * ```
+     */
+    getWallet(params: {
+        id: number;
+    }): Promise<Web3Wallet>;
+    /**
+     * Generate a new web3 wallet for a workspace.
+     *
+     * Creates a fresh wallet with a server-generated private key. The wallet
+     * is stored securely on the platform and used for ERC-8004 operations.
+     * A workspace can only have one web3 wallet.
+     *
+     * @param params - Parameters
+     * @param params.id - The workflow (workspace) ID
+     * @returns The generated web3 wallet
+     * @throws Error if the workspace already has a web3 wallet
+     *
+     * @example
+     * ```typescript
+     * const wallet = await client.workflows.generateWallet({ id: 123 });
+     * console.log('Wallet address:', wallet.address);
+     * ```
+     */
+    generateWallet(params: {
+        id: number;
+    }): Promise<Web3Wallet>;
+    /**
+     * Import an existing web3 wallet into a workspace.
+     *
+     * Use this to associate a pre-existing wallet (e.g., one that already has
+     * an ERC-8004 registration) with a workspace.
+     * A workspace can only have one web3 wallet.
+     *
+     * @param params - Import parameters
+     * @param params.id - The workflow (workspace) ID
+     * @param params.address - Wallet address
+     * @param params.network - Network name (e.g., "base")
+     * @param params.chainId - Chain ID (e.g., 8453)
+     * @param params.privateKey - Wallet private key
+     * @returns The imported web3 wallet
+     * @throws Error if the workspace already has a web3 wallet
+     *
+     * @example
+     * ```typescript
+     * const wallet = await client.workflows.importWallet({
+     *   id: 123,
+     *   address: '0x...',
+     *   network: 'base',
+     *   chainId: 8453,
+     *   privateKey: '0x...',
+     * });
+     * ```
+     */
+    importWallet(params: ImportWeb3WalletRequest & {
+        id: number;
+    }): Promise<Web3Wallet>;
+    /**
+     * Delete the web3 wallet associated with a workspace.
+     *
+     * This removes the wallet record from the platform. Note that the on-chain
+     * ERC-8004 registration is not affected -- this only removes the platform's
+     * association.
+     *
+     * @param params - Parameters
+     * @param params.id - The workflow (workspace) ID
+     *
+     * @example
+     * ```typescript
+     * await client.workflows.deleteWallet({ id: 123 });
+     * ```
+     */
+    deleteWallet(params: {
+        id: number;
+    }): Promise<void>;
+    /**
+     * Sign a feedback auth message for a buyer address.
+     *
+     * This is used for the ERC-8004 reputation system. The workspace's web3 wallet
+     * signs an auth message that allows a buyer to submit feedback/reputation
+     * for the agent on-chain.
+     *
+     * @param params - Parameters
+     * @param params.id - The workflow (workspace) ID
+     * @param params.buyerAddress - The buyer's wallet address to authorize
+     * @returns Object containing the signed feedback auth
+     *
+     * @example
+     * ```typescript
+     * const { signature } = await client.workflows.signFeedbackAuth({
+     *   id: 123,
+     *   buyerAddress: '0xBuyer...',
+     * });
+     * ```
+     */
+    signFeedbackAuth(params: {
+        id: number;
+        buyerAddress: string;
+    }): Promise<SignFeedbackAuthResponse>;
 }
 //# sourceMappingURL=workflows-api.d.ts.map

package/dist/workflows-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflows-api.d.ts","sourceRoot":"","sources":["../src/workflows-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,KAAK,EACV,cAAc,EAEd,cAAc,EACd,cAAc,EACd,IAAI,EAGL,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,YAAY;IACX,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,cAAc;IAE1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACG,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC;IAiCvD;;;;;OAKG;IACG,GAAG,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,QAAQ,CAAC;IA8C7D;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAWjC;;;;;;;OAOG;IACG,MAAM,CAAC,MAAM,EAAE;QACnB,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;QACpB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,GAAG,OAAO,CAAC,QAAQ,CAAC;IAWrB;;;;OAIG;IACG,MAAM,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5D;;;;;;;OAOG;IACG,UAAU,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAMhE;;;;;OAKG;IACG,OAAO,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,KAAK,EAAE,IAAI,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB5E;;;;;;;;;;;;;;;;OAgBG;IACG,QAAQ,CAAC,MAAM,EAAE;QACrB,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,IAAI,CAAC;IAMjB;;;;;;;;;;;OAWG;IACG,IAAI,CAAC,MAAM,EAAE;QACjB,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;QAC3B,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;QACzB,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;KAC1B,GAAG,OAAO,CAAC,IAAI,CAAC;YAWH,YAAY;IAqP1B,OAAO,CAAC,wBAAwB;IAWhC,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,aAAa;CAQtB"}
+{"version":3,"file":"workflows-api.d.ts","sourceRoot":"","sources":["../src/workflows-api.ts"],"names":[],"mappings":"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"}

package/dist/workflows-api.js

@@ -474,5 +474,117 @@ class WorkflowsAPI {
         }
         return `${ref.type}-${ref.id}`;
     }
+    // ===========================================================================
+    // Web3 Wallet Management
+    // ===========================================================================
+    /**
+     * Get the web3 wallet associated with a workspace.
+     *
+     * @param params - Parameters
+     * @param params.id - The workflow (workspace) ID
+     * @returns The web3 wallet details
+     *
+     * @example
+     * ```typescript
+     * const wallet = await client.workflows.getWallet({ id: 123 });
+     * console.log(wallet.address, wallet.deployed, wallet.erc8004AgentId);
+     * ```
+     */
+    async getWallet(params) {
+        return this.client.get(`/workspaces/${params.id}/web3`);
+    }
+    /**
+     * Generate a new web3 wallet for a workspace.
+     *
+     * Creates a fresh wallet with a server-generated private key. The wallet
+     * is stored securely on the platform and used for ERC-8004 operations.
+     * A workspace can only have one web3 wallet.
+     *
+     * @param params - Parameters
+     * @param params.id - The workflow (workspace) ID
+     * @returns The generated web3 wallet
+     * @throws Error if the workspace already has a web3 wallet
+     *
+     * @example
+     * ```typescript
+     * const wallet = await client.workflows.generateWallet({ id: 123 });
+     * console.log('Wallet address:', wallet.address);
+     * ```
+     */
+    async generateWallet(params) {
+        return this.client.post(`/workspaces/${params.id}/web3/generate`);
+    }
+    /**
+     * Import an existing web3 wallet into a workspace.
+     *
+     * Use this to associate a pre-existing wallet (e.g., one that already has
+     * an ERC-8004 registration) with a workspace.
+     * A workspace can only have one web3 wallet.
+     *
+     * @param params - Import parameters
+     * @param params.id - The workflow (workspace) ID
+     * @param params.address - Wallet address
+     * @param params.network - Network name (e.g., "base")
+     * @param params.chainId - Chain ID (e.g., 8453)
+     * @param params.privateKey - Wallet private key
+     * @returns The imported web3 wallet
+     * @throws Error if the workspace already has a web3 wallet
+     *
+     * @example
+     * ```typescript
+     * const wallet = await client.workflows.importWallet({
+     *   id: 123,
+     *   address: '0x...',
+     *   network: 'base',
+     *   chainId: 8453,
+     *   privateKey: '0x...',
+     * });
+     * ```
+     */
+    async importWallet(params) {
+        const { id, ...body } = params;
+        return this.client.post(`/workspaces/${id}/web3/import`, body);
+    }
+    /**
+     * Delete the web3 wallet associated with a workspace.
+     *
+     * This removes the wallet record from the platform. Note that the on-chain
+     * ERC-8004 registration is not affected -- this only removes the platform's
+     * association.
+     *
+     * @param params - Parameters
+     * @param params.id - The workflow (workspace) ID
+     *
+     * @example
+     * ```typescript
+     * await client.workflows.deleteWallet({ id: 123 });
+     * ```
+     */
+    async deleteWallet(params) {
+        await this.client.delete(`/workspaces/${params.id}/web3`);
+    }
+    /**
+     * Sign a feedback auth message for a buyer address.
+     *
+     * This is used for the ERC-8004 reputation system. The workspace's web3 wallet
+     * signs an auth message that allows a buyer to submit feedback/reputation
+     * for the agent on-chain.
+     *
+     * @param params - Parameters
+     * @param params.id - The workflow (workspace) ID
+     * @param params.buyerAddress - The buyer's wallet address to authorize
+     * @returns Object containing the signed feedback auth
+     *
+     * @example
+     * ```typescript
+     * const { signature } = await client.workflows.signFeedbackAuth({
+     *   id: 123,
+     *   buyerAddress: '0xBuyer...',
+     * });
+     * ```
+     */
+    async signFeedbackAuth(params) {
+        return this.client.post(`/workspaces/${params.id}/web3/sign-feedback-auth`, { buyerAddress: params.buyerAddress });
+    }
 }
 exports.WorkflowsAPI = WorkflowsAPI;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openserv-labs/client",
-  "version": "2.0.2",
+  "version": "2.1.2",
   "description": "OpenServ Platform Client - Manage agents, workflows, tasks, and triggers via the OpenServ API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -39,6 +39,7 @@
   "dependencies": {
     "axios": "^1.6.8",
     "ethers": "^6.16.0",
+    "pinata": "^2.5.1",
     "viem": "^2.45.1",
     "x402-fetch": "^1.1.0"
   },