@1claw/sdk 0.27.0 → 0.28.0

package/README.md

@@ -86,7 +86,7 @@ await client.auth.verifyEmailChange({ code: "123456" });
 | `client.vault`     | `create`, `get`, `list`, `delete`, `enableMpc`, `disableMpc`                                                        |
 | `client.secrets`   | `set`, `get`, `delete`, `list`, `rotate`                                                                            |
 | `client.access`    | `grantHuman`, `grantAgent`, `update`, `revoke`, `listGrants`                                                        |
-| `client.agents`    | `enroll` (also `AgentsResource.enroll(baseUrl, …)` static), `create`, `getSelf`, `get`, `list`, `update`, `delete`, `rotateKey`, `submitTransaction`, `signTransaction`, `getTransaction`, `listTransactions`, `simulateTransaction`, `simulateBundle`, `sign` |
+| `client.agents`    | `enroll` (also `AgentsResource.enroll(baseUrl, …)` static), `create`, `getSelf`, `get`, `list`, `update`, `delete`, `rotateKey`, `generateEoa`, `createSmartAccount`, `deleteSmartAccount`, `rotateSigner`, `submitTransaction`, `signTransaction`, `getTransaction`, `listTransactions`, `simulateTransaction`, `simulateBundle`, `sign` |
 | `client.chains`    | `list`, `get`, `adminList`, `create`, `update`, `delete`                                                            |
 | `client.sharing`   | `create`, `access`, `listOutbound`, `listInbound`, `accept`, `decline`, `revoke`                                    |
 | `client.approvals` | `request`, `list`, `approve`, `deny`, `check`, `subscribe`                                                          |
@@ -95,7 +95,7 @@ await client.auth.verifyEmailChange({ code: "123456" });
 | `client.org`       | `listMembers`, `getAgentKeysVault`, `updateMemberRole`, `removeMember`                                              |
 | `client.auth`      | `login`, `signup`, `agentToken`, `apiKeyToken`, `google`, `changePassword`, `setPassword`, `changeEmail`, `verifyEmailChange`, `forgotPassword`, `resetPassword`, `exportData`, `exchangeFederatedToken`, `logout`, `getMe`, `updateMe`, `deleteMe` |
 | `client.apiKeys`   | `create`, `list`, `revoke`                                                                                          |
-| `client.treasury`  | `create`, `list`, `get`, `update`, `delete`, `addSigner`, `removeSigner`, `requestAccess`, `listAccessRequests`, `approveAccess`, `denyAccess` |
+| `client.treasury`  | `create`, `list`, `get`, `update`, `delete`, `addSigner`, `removeSigner`, `requestAccess`, `listAccessRequests`, `approveAccess`, `denyAccess`, `propose`, `listProposals`, `getProposal`, `signProposal`, `executeProposal` |
 | `client.treasuryWallets` | `generateWallets`, `listWallets`, `getWallet`, `exportWallet`, `rotateWallet`, `deactivateWallet`               |
 | `client.signingKeys` | `create`, `list`, `rotate`, `deactivate`, `export`                                                               |
 | `client.platform`  | `createApp`, `listApps`, `getApp`, `updateApp`, `deleteApp`, `createTemplate`, `listTemplates`, `upsertUser`, `listUsers`, `bootstrapUser`, `claimPreview`, `claimRedeem`, `listConnectedApps`, `disconnectApp` |

package/dist/generated/api-types.d.ts

@@ -2099,6 +2099,88 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/treasury/{treasury_id}/proposals": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** List proposals for a treasury */
+        get: operations["listTreasuryProposals"];
+        put?: never;
+        /**
+         * Create a multisig proposal
+         * @description Create a new Safe multisig transaction proposal. The proposer must be a
+         *     treasury signer or an agent with an active delegation for the treasury.
+         *     If auto-approve rules match, the agent's signature is auto-inserted and
+         *     auto-execute fires if threshold is met.
+         */
+        post: operations["createTreasuryProposal"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/treasury/{treasury_id}/proposals/{proposal_id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Get a proposal with collected signatures */
+        get: operations["getTreasuryProposal"];
+        put?: never;
+        post?: never;
+        /** Cancel a pending proposal (proposer only) */
+        delete: operations["cancelTreasuryProposal"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/treasury/{treasury_id}/proposals/{proposal_id}/sign": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Sign a proposal (approve or reject)
+         * @description Submit an EIP-712 signature for a pending proposal. When approve signatures
+         *     reach the Safe threshold, auto-execute fires: signatures are collected in
+         *     address-sorted order, `execTransaction` calldata is built, and the transaction
+         *     is broadcast via RPC.
+         */
+        post: operations["signTreasuryProposal"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/treasury/{treasury_id}/proposals/{proposal_id}/execute": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Force-execute a proposal if threshold is met (user-only) */
+        post: operations["executeTreasuryProposal"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/treasury/wallets/generate": {
         parameters: {
             query?: never;
@@ -2732,6 +2814,70 @@ export interface paths {
         };
         trace?: never;
     };
+    "/v1/platform/apps/{appId}/rotate-key": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Rotate platform API key
+         * @description Generate a new API key for the platform app. The old key is immediately invalidated. Returns the new key (one-time).
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    appId: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    "application/json": {
+                        /**
+                         * Format: date-time
+                         * @description Optional expiration for the new key.
+                         */
+                        api_key_expires_at?: string | null;
+                    };
+                };
+            };
+            responses: {
+                /** @description New key generated */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @description The new API key (shown once) */
+                            api_key?: string;
+                            api_key_prefix?: string;
+                            /** Format: date-time */
+                            api_key_expires_at?: string | null;
+                        };
+                    };
+                };
+                /** @description Only human users can rotate platform keys */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/platform/apps/{appId}/templates": {
         parameters: {
             query?: never;
@@ -3784,6 +3930,11 @@ export interface components {
              */
             shroud_enabled: boolean;
             shroud_config?: components["schemas"]["ShroudConfig"];
+            /**
+             * Format: date-time
+             * @description Optional expiration time for the agent's API key.
+             */
+            api_key_expires_at?: string | null;
         };
         UpdateAgentRequest: {
             name?: string;
@@ -3819,6 +3970,11 @@ export interface components {
              *     Hard-capped at 3600 seconds.
              */
             federated_token_ttl_seconds?: number | null;
+            /**
+             * Format: date-time
+             * @description Optional expiration time for the agent's API key. Set to null to clear.
+             */
+            api_key_expires_at?: string | null;
         };
         AgentResponse: {
             /** Format: uuid */
@@ -3871,6 +4027,13 @@ export interface components {
             eip712_default_policy?: "deny" | "allow";
             /** @description Whether EIP-191 personal_sign is enabled. */
             message_signing_enabled?: boolean;
+            /**
+             * Format: date-time
+             * @description Optional expiration time for the agent's API key.
+             */
+            api_key_expires_at?: string | null;
+            /** @description Agent's Ethereum EOA address (used as Safe signer for smart accounts and Intents API). */
+            evm_address?: string | null;
             /** Format: date-time */
             created_at: string;
             /** Format: date-time */
@@ -4883,6 +5046,79 @@ export interface components {
             /** Format: date-time */
             resolved_at?: string;
         };
+        CreateTreasuryProposalRequest: {
+            /** @description Destination address (0x-prefixed) */
+            to_address: string;
+            /** @description Transaction value in wei */
+            value_wei: string;
+            /** @description Chain name (e.g. ethereum, base) */
+            chain: string;
+            /** @description Numeric chain ID (alternative to chain name) */
+            chain_id?: number;
+            /** @description Hex-encoded calldata (optional) */
+            data_hex?: string;
+            /**
+             * @description Safe operation type (0 = Call, 1 = DelegateCall)
+             * @default 0
+             */
+            operation: number;
+        };
+        SignTreasuryProposalRequest: {
+            /**
+             * @description Whether to approve or reject the proposal
+             * @enum {string}
+             */
+            decision: "approve" | "reject";
+            /** @description EIP-712 signature (hex). If omitted, server signs with caller's key. */
+            signature?: string;
+        };
+        TreasuryProposalResponse: {
+            /** Format: uuid */
+            id?: string;
+            /** Format: uuid */
+            treasury_id?: string;
+            /** Format: uuid */
+            proposed_by?: string;
+            /** @enum {string} */
+            proposed_by_type?: "user" | "agent";
+            chain?: string;
+            chain_id?: number;
+            safe_address?: string;
+            to_address?: string;
+            value_wei?: string;
+            data_hex?: string | null;
+            operation?: number;
+            safe_tx_hash?: string | null;
+            nonce?: number | null;
+            /** @enum {string} */
+            status?: "pending" | "approved" | "executing" | "executed" | "rejected" | "expired";
+            threshold?: number;
+            /** Format: date-time */
+            expires_at?: string | null;
+            executed_tx_hash?: string | null;
+            /** Format: date-time */
+            executed_at?: string | null;
+            signatures?: components["schemas"]["ProposalSignatureResponse"][];
+            /** Format: date-time */
+            created_at?: string;
+        };
+        ProposalSignatureResponse: {
+            /** Format: uuid */
+            id?: string;
+            /** Format: uuid */
+            signer_id?: string;
+            /** @enum {string} */
+            signer_type?: "user" | "agent";
+            signer_address?: string;
+            signature?: string;
+            /** @enum {string} */
+            decision?: "approve" | "reject";
+            /** Format: date-time */
+            created_at?: string;
+        };
+        TreasuryProposalListResponse: {
+            proposals?: components["schemas"]["TreasuryProposalResponse"][];
+        };
         GenerateTreasuryWalletsRequest: {
             /** @description Chains to generate wallets for (e.g. ["ethereum", "solana"]). Omit for all supported chains. */
             chains?: string[];
@@ -5048,6 +5284,11 @@ export interface components {
              */
             auth_mode: "silent" | "user_signin" | "configurable";
             max_connected_users?: number | null;
+            /**
+             * Format: date-time
+             * @description Optional expiration time for the platform API key.
+             */
+            api_key_expires_at?: string | null;
         };
         UpdatePlatformAppRequest: {
             name?: string;
@@ -5065,6 +5306,11 @@ export interface components {
             auth_mode?: "silent" | "user_signin" | "configurable";
             max_connected_users?: number | null;
             is_active?: boolean;
+            /**
+             * Format: date-time
+             * @description Optional expiration time for the platform API key. Set to null to clear.
+             */
+            api_key_expires_at?: string | null;
         };
         PlatformAppResponse: {
             /** Format: uuid */
@@ -5085,6 +5331,16 @@ export interface components {
             auth_mode?: string;
             max_connected_users?: number | null;
             connected_users?: number;
+            /**
+             * Format: date-time
+             * @description When the platform API key expires.
+             */
+            api_key_expires_at?: string | null;
+            /**
+             * Format: date-time
+             * @description When the platform API key was last rotated.
+             */
+            api_key_rotated_at?: string | null;
             /** Format: date-time */
             created_at?: string;
             /** Format: date-time */
@@ -8838,6 +9094,167 @@ export interface operations {
             404: components["responses"]["NotFound"];
         };
     };
+    listTreasuryProposals: {
+        parameters: {
+            query?: {
+                status?: "pending" | "approved" | "executing" | "executed" | "rejected" | "expired";
+            };
+            header?: never;
+            path: {
+                treasury_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Proposal list */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["TreasuryProposalListResponse"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+        };
+    };
+    createTreasuryProposal: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                treasury_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CreateTreasuryProposalRequest"];
+            };
+        };
+        responses: {
+            /** @description Proposal created */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["TreasuryProposalResponse"];
+                };
+            };
+            400: components["responses"]["BadRequest"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+        };
+    };
+    getTreasuryProposal: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                treasury_id: string;
+                proposal_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Proposal details */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["TreasuryProposalResponse"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            404: components["responses"]["NotFound"];
+        };
+    };
+    cancelTreasuryProposal: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                treasury_id: string;
+                proposal_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Proposal cancelled */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+        };
+    };
+    signTreasuryProposal: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                treasury_id: string;
+                proposal_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["SignTreasuryProposalRequest"];
+            };
+        };
+        responses: {
+            /** @description Signature recorded (may include executed_tx_hash if auto-executed) */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["TreasuryProposalResponse"];
+                };
+            };
+            400: components["responses"]["BadRequest"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+        };
+    };
+    executeTreasuryProposal: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                treasury_id: string;
+                proposal_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Proposal executed */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["TreasuryProposalResponse"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+        };
+    };
     generateTreasuryWallets: {
         parameters: {
             query?: never;