@witnium-tech/witniumchain 0.12.2 → 0.13.0

package/dist/index.d.ts

@@ -1472,16 +1472,6 @@ interface paths$1 {
                                 email: string;
                                 /** @description Optional external identifier supplied by the org admin at user-create time. Lets B2B2C apps correlate users to their own records. */
                                 externalUserId: string | null;
-                                /**
-                                 * @description On-chain witness contract bound to the user (null until provisioned).
-                                 * @example 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb0
-                                 */
-                                contractAddress: string | null;
-                                /**
-                                 * @description Owner Ed25519 public key for the user's contract (null until provisioned).
-                                 * @example 4cdde7a3e3a1d8a48d2b9eaf2bcbe2db1d57d3e1a8d6c20e0a86c0f9c4b6cf2e
-                                 */
-                                ownerPublicKey: string | null;
                                 /**
                                  * Format: date-time
                                  * @description ISO 8601 date-time string
@@ -3181,7 +3171,7 @@ interface paths$1 {
         put?: never;
         /**
          * Apply a manual credit adjustment
-         * @description Sysadmin-only. Use sparingly — for correcting billing errors, granting goodwill credits, or backfilling balance after migrations. Recorded as `reason: adjustment` in the ledger with the supplied `note`.
+         * @description Sysadmin-only. Use sparingly — for correcting billing errors, granting goodwill credits, or backfilling balance after migrations. Recorded as `reason: adjustment` in the ledger with the supplied `note`. A positive delta is purchased credit (never expires); a negative one takes purchased credit first, then plan allowance. 400 when it would make the balance negative.
          */
         post: {
             parameters: {
@@ -3221,6 +3211,31 @@ interface paths$1 {
                         };
                     };
                 };
+                /** @description Bad Request — validation failed */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /**
+                             * @description HTTP status code
+                             * @example 400
+                             */
+                            statusCode?: number;
+                            /**
+                             * @description Short error label
+                             * @example Bad Request
+                             */
+                            error?: string;
+                            /**
+                             * @description Human-readable error message. Validation errors from `ZodError.flatten()` may be returned as an array.
+                             * @example Validation failed
+                             */
+                            message: string | string[];
+                        };
+                    };
+                };
                 /** @description Unauthorized — authentication required or invalid */
                 401: {
                     headers: {
@@ -6928,18 +6943,6 @@ interface paths$1 {
                                  * @example 2026-05-20T10:30:00.000Z
                                  */
                                 emailVerifiedAt: string | null;
-                                /**
-                                 * @description Ethereum address (0x + 40 hex characters)
-                                 * @example 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb0
-                                 */
-                                contractAddress: string | null;
-                                /**
-                                 * @description Ed25519 public key — 32 bytes hex-encoded (64 chars, no 0x prefix)
-                                 * @example 4cdde7a3e3a1d8a48d2b9eaf2bcbe2db1d57d3e1a8d6c20e0a86c0f9c4b6cf2e
-                                 */
-                                ownerPublicKey: string | null;
-                                /** @description Server-cached owner nonce (`ownerNonceCached`). */
-                                ownerNonce: number | null;
                                 externalUserId: string | null;
                                 /**
                                  * Format: uri
@@ -6982,6 +6985,29 @@ interface paths$1 {
                                 balance: number | null;
                                 isPersonal: boolean;
                             };
+                            /**
+                             * AccountContract
+                             * @description The active contract of the user's organization; null until provisioned.
+                             */
+                            contract: {
+                                /**
+                                 * @description Ethereum address (0x + 40 hex characters)
+                                 * @example 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb0
+                                 */
+                                address: string;
+                                /** @description WitnessRegistry version chain-api deployed, e.g. `5.0.0`. */
+                                version: string;
+                                /**
+                                 * @description Ed25519 public key — 32 bytes hex-encoded (64 chars, no 0x prefix)
+                                 * @example 4cdde7a3e3a1d8a48d2b9eaf2bcbe2db1d57d3e1a8d6c20e0a86c0f9c4b6cf2e
+                                 */
+                                ownerPublicKey: string;
+                                /**
+                                 * @description Who holds the owner key: `witnium` (managed keys) or `customer` (self-custody). The owner nonce is on chain (chain-api contract info).
+                                 * @enum {string}
+                                 */
+                                custody: "witnium" | "customer";
+                            } | null;
                             signingKeys: {
                                 /**
                                  * @description Ed25519 public key — 32 bytes hex-encoded (64 chars, no 0x prefix)
@@ -10706,778 +10732,6 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    "/admin/validators/propose": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /**
-         * Propose adding or removing a validator
-         * @description Submit a vote to add or remove a validator from the network.
-         */
-        post: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody?: {
-                content: {
-                    "application/json": {
-                        /**
-                         * @description Ethereum address (0x + 40 hex characters)
-                         * @example 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb0
-                         */
-                        validatorAddress: string;
-                        /** @description true = vote to add, false = vote to remove */
-                        add: boolean;
-                    };
-                };
-            };
-            responses: {
-                /** @description Success */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            /** @enum {boolean} */
-                            success: true;
-                            /**
-                             * @description Ethereum address (0x + 40 hex characters)
-                             * @example 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb0
-                             */
-                            validatorAddress: string;
-                            add: boolean;
-                            message: string;
-                        };
-                    };
-                };
-                /** @description Bad Request - Validation failed */
-                400: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            /**
-                             * @description Error message
-                             * @example Validation failed
-                             */
-                            error: string;
-                            /**
-                             * @description Machine-readable error code
-                             * @example VALIDATION_FAILED
-                             */
-                            code?: string;
-                            /** @description Field-level validation errors */
-                            details?: {
-                                [key: string]: string[];
-                            };
-                        };
-                    };
-                };
-                /** @description Internal Server Error */
-                500: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            /**
-                             * @description Error message
-                             * @example Validation failed
-                             */
-                            error: string;
-                            /**
-                             * @description Machine-readable error code
-                             * @example VALIDATION_FAILED
-                             */
-                            code?: string;
-                            /** @description Field-level validation errors */
-                            details?: {
-                                [key: string]: string[];
-                            };
-                        };
-                    };
-                };
-            };
-        };
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/admin/validators/vote/{address}": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        post?: never;
-        /**
-         * Discard a vote for a validator
-         * @description Remove a vote for adding or removing a validator.
-         */
-        delete: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    /** @description Ethereum address (0x + 40 hex characters) */
-                    address: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Success */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            /** @enum {boolean} */
-                            success: true;
-                            message: string;
-                        };
-                    };
-                };
-                /** @description Bad Request - Validation failed */
-                400: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            /**
-                             * @description Error message
-                             * @example Validation failed
-                             */
-                            error: string;
-                            /**
-                             * @description Machine-readable error code
-                             * @example VALIDATION_FAILED
-                             */
-                            code?: string;
-                            /** @description Field-level validation errors */
-                            details?: {
-                                [key: string]: string[];
-                            };
-                        };
-                    };
-                };
-                /** @description Not Found */
-                404: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            /**
-                             * @description Error message
-                             * @example Validation failed
-                             */
-                            error: string;
-                            /**
-                             * @description Machine-readable error code
-                             * @example VALIDATION_FAILED
-                             */
-                            code?: string;
-                            /** @description Field-level validation errors */
-                            details?: {
-                                [key: string]: string[];
-                            };
-                        };
-                    };
-                };
-                /** @description Internal Server Error */
-                500: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            /**
-                             * @description Error message
-                             * @example Validation failed
-                             */
-                            error: string;
-                            /**
-                             * @description Machine-readable error code
-                             * @example VALIDATION_FAILED
-                             */
-                            code?: string;
-                            /** @description Field-level validation errors */
-                            details?: {
-                                [key: string]: string[];
-                            };
-                        };
-                    };
-                };
-            };
-        };
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/admin/validators": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Get list of validators
-         * @description Get the current list of validators in the network.
-         */
-        get: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Success */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            validators: {
-                                /**
-                                 * @description Ethereum address (0x + 40 hex characters)
-                                 * @example 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb0
-                                 */
-                                address: string;
-                                added: boolean;
-                            }[];
-                        };
-                    };
-                };
-                /** @description Internal Server Error */
-                500: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            /**
-                             * @description Error message
-                             * @example Validation failed
-                             */
-                            error: string;
-                            /**
-                             * @description Machine-readable error code
-                             * @example VALIDATION_FAILED
-                             */
-                            code?: string;
-                            /** @description Field-level validation errors */
-                            details?: {
-                                [key: string]: string[];
-                            };
-                        };
-                    };
-                };
-            };
-        };
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/admin/validators/pending": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Get list of pending validators
-         * @description Get validators that have votes but are not yet added/removed.
-         */
-        get: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Success */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            pending: {
-                                /**
-                                 * @description Ethereum address (0x + 40 hex characters)
-                                 * @example 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb0
-                                 */
-                                address: string;
-                                addVotes: number;
-                                removeVotes: number;
-                            }[];
-                        };
-                    };
-                };
-                /** @description Internal Server Error */
-                500: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            /**
-                             * @description Error message
-                             * @example Validation failed
-                             */
-                            error: string;
-                            /**
-                             * @description Machine-readable error code
-                             * @example VALIDATION_FAILED
-                             */
-                            code?: string;
-                            /** @description Field-level validation errors */
-                            details?: {
-                                [key: string]: string[];
-                            };
-                        };
-                    };
-                };
-            };
-        };
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/admin/network/status": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Get network status
-         * @description Get the current status of the blockchain network.
-         */
-        get: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Success */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            chainId: number;
-                            blockNumber: number;
-                            validatorCount: number;
-                        };
-                    };
-                };
-                /** @description Internal Server Error */
-                500: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            /**
-                             * @description Error message
-                             * @example Validation failed
-                             */
-                            error: string;
-                            /**
-                             * @description Machine-readable error code
-                             * @example VALIDATION_FAILED
-                             */
-                            code?: string;
-                            /** @description Field-level validation errors */
-                            details?: {
-                                [key: string]: string[];
-                            };
-                        };
-                    };
-                };
-            };
-        };
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/admin/network/peers": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Get network peers
-         * @description Get the list of connected network peers.
-         */
-        get: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Success */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            peers: {
-                                id: string;
-                                name?: string;
-                                enode: string;
-                                /** @enum {string} */
-                                status: "connected" | "disconnected";
-                            }[];
-                        };
-                    };
-                };
-                /** @description Internal Server Error */
-                500: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            /**
-                             * @description Error message
-                             * @example Validation failed
-                             */
-                            error: string;
-                            /**
-                             * @description Machine-readable error code
-                             * @example VALIDATION_FAILED
-                             */
-                            code?: string;
-                            /** @description Field-level validation errors */
-                            details?: {
-                                [key: string]: string[];
-                            };
-                        };
-                    };
-                };
-            };
-        };
-        put?: never;
-        /**
-         * Add a network peer
-         * @description Add a peer to the network.
-         */
-        post: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody?: {
-                content: {
-                    "application/json": {
-                        enode: string;
-                    };
-                };
-            };
-            responses: {
-                /** @description Success */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            /** @enum {boolean} */
-                            success: true;
-                            message: string;
-                        };
-                    };
-                };
-                /** @description Bad Request - Validation failed */
-                400: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            /**
-                             * @description Error message
-                             * @example Validation failed
-                             */
-                            error: string;
-                            /**
-                             * @description Machine-readable error code
-                             * @example VALIDATION_FAILED
-                             */
-                            code?: string;
-                            /** @description Field-level validation errors */
-                            details?: {
-                                [key: string]: string[];
-                            };
-                        };
-                    };
-                };
-                /** @description Internal Server Error */
-                500: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            /**
-                             * @description Error message
-                             * @example Validation failed
-                             */
-                            error: string;
-                            /**
-                             * @description Machine-readable error code
-                             * @example VALIDATION_FAILED
-                             */
-                            code?: string;
-                            /** @description Field-level validation errors */
-                            details?: {
-                                [key: string]: string[];
-                            };
-                        };
-                    };
-                };
-            };
-        };
-        /**
-         * Remove a network peer
-         * @description Remove a peer from the network.
-         */
-        delete: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody?: {
-                content: {
-                    "application/json": {
-                        enode: string;
-                    };
-                };
-            };
-            responses: {
-                /** @description Success */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            /** @enum {boolean} */
-                            success: true;
-                            message: string;
-                        };
-                    };
-                };
-                /** @description Bad Request - Validation failed */
-                400: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            /**
-                             * @description Error message
-                             * @example Validation failed
-                             */
-                            error: string;
-                            /**
-                             * @description Machine-readable error code
-                             * @example VALIDATION_FAILED
-                             */
-                            code?: string;
-                            /** @description Field-level validation errors */
-                            details?: {
-                                [key: string]: string[];
-                            };
-                        };
-                    };
-                };
-                /** @description Internal Server Error */
-                500: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            /**
-                             * @description Error message
-                             * @example Validation failed
-                             */
-                            error: string;
-                            /**
-                             * @description Machine-readable error code
-                             * @example VALIDATION_FAILED
-                             */
-                            code?: string;
-                            /** @description Field-level validation errors */
-                            details?: {
-                                [key: string]: string[];
-                            };
-                        };
-                    };
-                };
-            };
-        };
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/admin/utils/pubkey-to-address": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /**
-         * Convert public key to Ethereum address
-         * @description Utility endpoint to convert a public key to an Ethereum address.
-         */
-        post: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody?: {
-                content: {
-                    "application/json": {
-                        pubkey: string;
-                    };
-                };
-            };
-            responses: {
-                /** @description Success */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            /**
-                             * @description Ethereum address (0x + 40 hex characters)
-                             * @example 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb0
-                             */
-                            address: string;
-                            pubkey: string;
-                        };
-                    };
-                };
-                /** @description Bad Request - Validation failed */
-                400: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            /**
-                             * @description Error message
-                             * @example Validation failed
-                             */
-                            error: string;
-                            /**
-                             * @description Machine-readable error code
-                             * @example VALIDATION_FAILED
-                             */
-                            code?: string;
-                            /** @description Field-level validation errors */
-                            details?: {
-                                [key: string]: string[];
-                            };
-                        };
-                    };
-                };
-                /** @description Internal Server Error */
-                500: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            /**
-                             * @description Error message
-                             * @example Validation failed
-                             */
-                            error: string;
-                            /**
-                             * @description Machine-readable error code
-                             * @example VALIDATION_FAILED
-                             */
-                            code?: string;
-                            /** @description Field-level validation errors */
-                            details?: {
-                                [key: string]: string[];
-                            };
-                        };
-                    };
-                };
-            };
-        };
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
     "/health/live": {
         parameters: {
             query?: never;