@wishknish/knishio-client-ts 0.9.7 → 1.0.0

package/dist/index.d.cts

@@ -29,7 +29,7 @@ interface TransferRecipientInput {
 }
 
 type HashAlgorithm = 'SHAKE256' | 'SHA3-256' | 'BLAKE2B';
-type SignatureAlgorithm = 'XMSS' | 'ML-KEM768' | 'SPHINCS+';
+type SignatureAlgorithm = 'XMSS' | 'SPHINCS+';
 interface SHAKE256Options {
     input: string | Uint8Array;
     outputLength: number;
@@ -543,12 +543,13 @@ declare class Wallet {
     tokenUnits: any[];
     tradeRates: Record<string, any>;
     molecules: Record<string, any>;
+    mlKemParameterSet: 1024 | 768;
     tokenName?: string;
     tokenAmount?: string;
     tokenSupply?: string;
     tokenFungibility?: string;
     createdAt?: string;
-    constructor({ secret, bundle, token, address, position, batchId, characters }?: {
+    constructor({ secret, bundle, token, address, position, batchId, characters, mlKemParameterSet }?: {
         secret?: string | null;
         bundle?: string | null;
         token?: string;
@@ -556,13 +557,15 @@ declare class Wallet {
         position?: string | null;
         batchId?: string | null;
         characters?: string | null;
+        mlKemParameterSet?: 1024 | 768;
     });
-    static create({ secret, bundle, token, batchId, characters }: {
+    static create({ secret, bundle, token, batchId, characters, mlKemParameterSet }: {
         secret?: string | null;
         bundle?: string | null;
         token?: string;
         batchId?: string | null;
         characters?: string | null;
+        mlKemParameterSet?: 1024 | 768;
     }): Wallet;
     static generateKey({ secret, token, position }: {
         secret: string;
@@ -582,6 +585,8 @@ declare class Wallet {
     splitUnitsMulti(recipientUnitLists: string[][], recipientWallets: Wallet[], remainderWallet: Wallet): void;
     getTokenUnitsData(): any[];
     isShadow(): boolean;
+    private deriveMlKemKeypair;
+    static mlKemParameterSetFromPubkey(pubkey: string | null | undefined): 1024 | 768 | null;
     initializeMLKEM(): void;
     encryptMessage(message: any, recipientPubkey: string): Promise<{
         cipherText: string;
@@ -596,8 +601,8 @@ declare class Wallet {
         encryptedMessage: string;
     }): Promise<string | null>;
     hashShare(pubkey: string): string;
-    encryptStringML768(message: any, recipientPubkey: string): Promise<string>;
-    decryptMyMessageML768(map: Record<string, {
+    encryptStringML(message: any, recipientPubkey: string): Promise<string>;
+    decryptMyMessageML(map: Record<string, {
         cipherText: string;
         encryptedMessage: string;
     }>): Promise<string | null>;
@@ -732,7 +737,8 @@ declare class Molecule {
     continuIdPosition: string | null;
     parentHashes: string[];
     local?: number;
-    constructor({ secret, bundle, sourceWallet, remainderWallet, cellSlug, version, continuIdPosition }?: {
+    mlKemParameterSet: 1024 | 768;
+    constructor({ secret, bundle, sourceWallet, remainderWallet, cellSlug, version, continuIdPosition, mlKemParameterSet }?: {
         secret?: string | null;
         bundle?: string | null;
         sourceWallet?: Wallet | null;
@@ -740,6 +746,7 @@ declare class Molecule {
         cellSlug?: string | null;
         version?: string | number | null;
         continuIdPosition?: string | null;
+        mlKemParameterSet?: 1024 | 768 | null;
     });
     get cellSlugDelimiter(): string;
     getIsotopes(isotopes: AtomIsotope | AtomIsotope[]): Atom[];
@@ -961,6 +968,17 @@ declare class GraphQLClient implements GraphQLClient$1 {
     socketDisconnect(): void;
 }
 
+type AuthTokenSnapshot = {
+    token: string;
+    expiresAt: number;
+    pubkey: string;
+    encrypt: boolean;
+    wallet?: {
+        position: string | null;
+        characters: string | null;
+        mlKemParameterSet?: 1024 | 768;
+    };
+};
 declare class AuthToken {
     private $__token;
     private $__expiresAt;
@@ -979,16 +997,8 @@ declare class AuthToken {
         encrypt: boolean;
         pubkey: string;
     }, wallet: Wallet): AuthToken;
-    static restore(snapshot: {
-        token: string;
-        expiresAt: number;
-        pubkey: string;
-        encrypt: boolean;
-        wallet: {
-            position: string;
-            characters: string | null;
-        };
-    }, secret: string): AuthToken;
+    static resolveMlKemParameterSet(snapshot: AuthTokenSnapshot): 1024 | 768;
+    static restore(snapshot: AuthTokenSnapshot, secret: string): AuthToken;
     setWallet(wallet: Wallet): void;
     getWallet(): Wallet | undefined;
     getToken(): string;
@@ -1002,16 +1012,7 @@ declare class AuthToken {
         pubkey: string;
         wallet: Wallet | undefined;
     };
-    toSnapshot(): {
-        token: string;
-        expiresAt: number;
-        pubkey: string;
-        encrypt: boolean;
-        wallet?: {
-            position: string | null;
-            characters: string | null;
-        };
-    };
+    toSnapshot(): AuthTokenSnapshot;
 }
 
 interface UniversalResponse<T> {
@@ -1214,6 +1215,7 @@ declare class KnishIOClient {
     private $__authTokenObjects;
     private $__authToken;
     private $__authInProcess;
+    private $__mlKemParameterSet;
     private $__remainderWallet;
     private lastMoleculeQuery;
     private abortControllers;
@@ -1231,8 +1233,9 @@ declare class KnishIOClient {
         logging?: boolean;
         defaultRequestPolicy?: RequestPolicy | null;
         secretStorage?: ISecretStorageProvider | null;
+        mlKemParameterSet?: 1024 | 768;
     });
-    initialize({ uri, cellSlug, socket, client, serverSdkVersion, logging, defaultRequestPolicy }: {
+    initialize({ uri, cellSlug, socket, client, serverSdkVersion, logging, defaultRequestPolicy, mlKemParameterSet }: {
         uri: string | string[];
         cellSlug?: string | null;
         socket?: {
@@ -1243,7 +1246,10 @@ declare class KnishIOClient {
         serverSdkVersion?: number;
         logging?: boolean;
         defaultRequestPolicy?: RequestPolicy | null;
+        mlKemParameterSet?: 1024 | 768;
     }): void;
+    getMlKemParameterSet(): 1024 | 768;
+    setMlKemParameterSet(parameterSet: 1024 | 768): this;
     getRandomUri(): string;
     switchEncryption(encrypt: boolean): boolean;
     deinitialize(): void;
@@ -1752,7 +1758,7 @@ declare class QueryBatch extends Query {
     createResponse(json: any): Response;
 }
 
-declare abstract class MutationProposeMolecule extends Mutation {
+declare class MutationProposeMolecule extends Mutation {
     protected $__molecule: Molecule;
     protected $__remainderWallet: any | null;
     constructor(graphQLClient: GraphQLClient, knishIOClient: KnishIOClient, molecule: Molecule);
@@ -1763,7 +1769,7 @@ declare abstract class MutationProposeMolecule extends Mutation {
     }): Promise<ResponseProposeMolecule | null>;
     remainderWallet(): any | null;
     molecule(): any;
-    abstract fillMolecule(params: any): void;
+    fillMolecule(_params?: any): void;
 }
 
 declare class ResponseTransferTokens extends ResponseProposeMolecule {
@@ -2199,15 +2205,15 @@ declare function withSecureBytes<T>(bytes: Uint8Array, fn: (bytes: Uint8Array) =
 declare function withSecureString<T>(secret: string, fn: (cleanSecret: string) => Promise<T> | T): Promise<T>;
 declare function constantTimeCompare(a: Uint8Array | string, b: Uint8Array | string): boolean;
 
-declare const SDK_VERSION = "0.9.7";
+declare const SDK_VERSION = "1.0.0";
 declare const SDK_NAME = "KnishIO-Client-TS";
 declare const COMPATIBLE_SERVER_VERSIONS: number[];
 declare const SDK_INFO: {
     readonly name: "KnishIO-Client-TS";
-    readonly version: "0.9.7";
+    readonly version: "1.0.0";
     readonly description: "TypeScript SDK for Knish.IO post-blockchain distributed ledger";
     readonly compatibleServerVersions: number[];
-    readonly features: readonly ["Post-quantum cryptography (XMSS, ML-KEM768)", "Cross-platform compatibility", "Type-safe APIs", "DAG-based transaction processing", "GraphQL integration", "Real-time subscriptions", "Cellular architecture support"];
+    readonly features: readonly ["Post-quantum cryptography (XMSS, ML-KEM-1024)", "Cross-platform compatibility", "Type-safe APIs", "DAG-based transaction processing", "GraphQL integration", "Real-time subscriptions", "Cellular architecture support"];
     readonly build: {
         readonly target: "ES2022";
         readonly formats: readonly ["esm", "cjs", "iife"];
@@ -2232,10 +2238,10 @@ declare const DevUtils: {
         nodeVersion: string;
         environment: string;
         name: "KnishIO-Client-TS";
-        version: "0.9.7";
+        version: "1.0.0";
         description: "TypeScript SDK for Knish.IO post-blockchain distributed ledger";
         compatibleServerVersions: number[];
-        features: readonly ["Post-quantum cryptography (XMSS, ML-KEM768)", "Cross-platform compatibility", "Type-safe APIs", "DAG-based transaction processing", "GraphQL integration", "Real-time subscriptions", "Cellular architecture support"];
+        features: readonly ["Post-quantum cryptography (XMSS, ML-KEM-1024)", "Cross-platform compatibility", "Type-safe APIs", "DAG-based transaction processing", "GraphQL integration", "Real-time subscriptions", "Cellular architecture support"];
         build: {
             readonly target: "ES2022";
             readonly formats: readonly ["esm", "cjs", "iife"];
@@ -2259,10 +2265,10 @@ declare const KnishIO: {
     SDK_VERSION: string;
     SDK_INFO: {
         readonly name: "KnishIO-Client-TS";
-        readonly version: "0.9.7";
+        readonly version: "1.0.0";
         readonly description: "TypeScript SDK for Knish.IO post-blockchain distributed ledger";
         readonly compatibleServerVersions: number[];
-        readonly features: readonly ["Post-quantum cryptography (XMSS, ML-KEM768)", "Cross-platform compatibility", "Type-safe APIs", "DAG-based transaction processing", "GraphQL integration", "Real-time subscriptions", "Cellular architecture support"];
+        readonly features: readonly ["Post-quantum cryptography (XMSS, ML-KEM-1024)", "Cross-platform compatibility", "Type-safe APIs", "DAG-based transaction processing", "GraphQL integration", "Real-time subscriptions", "Cellular architecture support"];
         readonly build: {
             readonly target: "ES2022";
             readonly formats: readonly ["esm", "cjs", "iife"];

package/dist/index.d.ts

@@ -29,7 +29,7 @@ interface TransferRecipientInput {
 }
 
 type HashAlgorithm = 'SHAKE256' | 'SHA3-256' | 'BLAKE2B';
-type SignatureAlgorithm = 'XMSS' | 'ML-KEM768' | 'SPHINCS+';
+type SignatureAlgorithm = 'XMSS' | 'SPHINCS+';
 interface SHAKE256Options {
     input: string | Uint8Array;
     outputLength: number;
@@ -543,12 +543,13 @@ declare class Wallet {
     tokenUnits: any[];
     tradeRates: Record<string, any>;
     molecules: Record<string, any>;
+    mlKemParameterSet: 1024 | 768;
     tokenName?: string;
     tokenAmount?: string;
     tokenSupply?: string;
     tokenFungibility?: string;
     createdAt?: string;
-    constructor({ secret, bundle, token, address, position, batchId, characters }?: {
+    constructor({ secret, bundle, token, address, position, batchId, characters, mlKemParameterSet }?: {
         secret?: string | null;
         bundle?: string | null;
         token?: string;
@@ -556,13 +557,15 @@ declare class Wallet {
         position?: string | null;
         batchId?: string | null;
         characters?: string | null;
+        mlKemParameterSet?: 1024 | 768;
     });
-    static create({ secret, bundle, token, batchId, characters }: {
+    static create({ secret, bundle, token, batchId, characters, mlKemParameterSet }: {
         secret?: string | null;
         bundle?: string | null;
         token?: string;
         batchId?: string | null;
         characters?: string | null;
+        mlKemParameterSet?: 1024 | 768;
     }): Wallet;
     static generateKey({ secret, token, position }: {
         secret: string;
@@ -582,6 +585,8 @@ declare class Wallet {
     splitUnitsMulti(recipientUnitLists: string[][], recipientWallets: Wallet[], remainderWallet: Wallet): void;
     getTokenUnitsData(): any[];
     isShadow(): boolean;
+    private deriveMlKemKeypair;
+    static mlKemParameterSetFromPubkey(pubkey: string | null | undefined): 1024 | 768 | null;
     initializeMLKEM(): void;
     encryptMessage(message: any, recipientPubkey: string): Promise<{
         cipherText: string;
@@ -596,8 +601,8 @@ declare class Wallet {
         encryptedMessage: string;
     }): Promise<string | null>;
     hashShare(pubkey: string): string;
-    encryptStringML768(message: any, recipientPubkey: string): Promise<string>;
-    decryptMyMessageML768(map: Record<string, {
+    encryptStringML(message: any, recipientPubkey: string): Promise<string>;
+    decryptMyMessageML(map: Record<string, {
         cipherText: string;
         encryptedMessage: string;
     }>): Promise<string | null>;
@@ -732,7 +737,8 @@ declare class Molecule {
     continuIdPosition: string | null;
     parentHashes: string[];
     local?: number;
-    constructor({ secret, bundle, sourceWallet, remainderWallet, cellSlug, version, continuIdPosition }?: {
+    mlKemParameterSet: 1024 | 768;
+    constructor({ secret, bundle, sourceWallet, remainderWallet, cellSlug, version, continuIdPosition, mlKemParameterSet }?: {
         secret?: string | null;
         bundle?: string | null;
         sourceWallet?: Wallet | null;
@@ -740,6 +746,7 @@ declare class Molecule {
         cellSlug?: string | null;
         version?: string | number | null;
         continuIdPosition?: string | null;
+        mlKemParameterSet?: 1024 | 768 | null;
     });
     get cellSlugDelimiter(): string;
     getIsotopes(isotopes: AtomIsotope | AtomIsotope[]): Atom[];
@@ -961,6 +968,17 @@ declare class GraphQLClient implements GraphQLClient$1 {
     socketDisconnect(): void;
 }
 
+type AuthTokenSnapshot = {
+    token: string;
+    expiresAt: number;
+    pubkey: string;
+    encrypt: boolean;
+    wallet?: {
+        position: string | null;
+        characters: string | null;
+        mlKemParameterSet?: 1024 | 768;
+    };
+};
 declare class AuthToken {
     private $__token;
     private $__expiresAt;
@@ -979,16 +997,8 @@ declare class AuthToken {
         encrypt: boolean;
         pubkey: string;
     }, wallet: Wallet): AuthToken;
-    static restore(snapshot: {
-        token: string;
-        expiresAt: number;
-        pubkey: string;
-        encrypt: boolean;
-        wallet: {
-            position: string;
-            characters: string | null;
-        };
-    }, secret: string): AuthToken;
+    static resolveMlKemParameterSet(snapshot: AuthTokenSnapshot): 1024 | 768;
+    static restore(snapshot: AuthTokenSnapshot, secret: string): AuthToken;
     setWallet(wallet: Wallet): void;
     getWallet(): Wallet | undefined;
     getToken(): string;
@@ -1002,16 +1012,7 @@ declare class AuthToken {
         pubkey: string;
         wallet: Wallet | undefined;
     };
-    toSnapshot(): {
-        token: string;
-        expiresAt: number;
-        pubkey: string;
-        encrypt: boolean;
-        wallet?: {
-            position: string | null;
-            characters: string | null;
-        };
-    };
+    toSnapshot(): AuthTokenSnapshot;
 }
 
 interface UniversalResponse<T> {
@@ -1214,6 +1215,7 @@ declare class KnishIOClient {
     private $__authTokenObjects;
     private $__authToken;
     private $__authInProcess;
+    private $__mlKemParameterSet;
     private $__remainderWallet;
     private lastMoleculeQuery;
     private abortControllers;
@@ -1231,8 +1233,9 @@ declare class KnishIOClient {
         logging?: boolean;
         defaultRequestPolicy?: RequestPolicy | null;
         secretStorage?: ISecretStorageProvider | null;
+        mlKemParameterSet?: 1024 | 768;
     });
-    initialize({ uri, cellSlug, socket, client, serverSdkVersion, logging, defaultRequestPolicy }: {
+    initialize({ uri, cellSlug, socket, client, serverSdkVersion, logging, defaultRequestPolicy, mlKemParameterSet }: {
         uri: string | string[];
         cellSlug?: string | null;
         socket?: {
@@ -1243,7 +1246,10 @@ declare class KnishIOClient {
         serverSdkVersion?: number;
         logging?: boolean;
         defaultRequestPolicy?: RequestPolicy | null;
+        mlKemParameterSet?: 1024 | 768;
     }): void;
+    getMlKemParameterSet(): 1024 | 768;
+    setMlKemParameterSet(parameterSet: 1024 | 768): this;
     getRandomUri(): string;
     switchEncryption(encrypt: boolean): boolean;
     deinitialize(): void;
@@ -1752,7 +1758,7 @@ declare class QueryBatch extends Query {
     createResponse(json: any): Response;
 }
 
-declare abstract class MutationProposeMolecule extends Mutation {
+declare class MutationProposeMolecule extends Mutation {
     protected $__molecule: Molecule;
     protected $__remainderWallet: any | null;
     constructor(graphQLClient: GraphQLClient, knishIOClient: KnishIOClient, molecule: Molecule);
@@ -1763,7 +1769,7 @@ declare abstract class MutationProposeMolecule extends Mutation {
     }): Promise<ResponseProposeMolecule | null>;
     remainderWallet(): any | null;
     molecule(): any;
-    abstract fillMolecule(params: any): void;
+    fillMolecule(_params?: any): void;
 }
 
 declare class ResponseTransferTokens extends ResponseProposeMolecule {
@@ -2199,15 +2205,15 @@ declare function withSecureBytes<T>(bytes: Uint8Array, fn: (bytes: Uint8Array) =
 declare function withSecureString<T>(secret: string, fn: (cleanSecret: string) => Promise<T> | T): Promise<T>;
 declare function constantTimeCompare(a: Uint8Array | string, b: Uint8Array | string): boolean;
 
-declare const SDK_VERSION = "0.9.7";
+declare const SDK_VERSION = "1.0.0";
 declare const SDK_NAME = "KnishIO-Client-TS";
 declare const COMPATIBLE_SERVER_VERSIONS: number[];
 declare const SDK_INFO: {
     readonly name: "KnishIO-Client-TS";
-    readonly version: "0.9.7";
+    readonly version: "1.0.0";
     readonly description: "TypeScript SDK for Knish.IO post-blockchain distributed ledger";
     readonly compatibleServerVersions: number[];
-    readonly features: readonly ["Post-quantum cryptography (XMSS, ML-KEM768)", "Cross-platform compatibility", "Type-safe APIs", "DAG-based transaction processing", "GraphQL integration", "Real-time subscriptions", "Cellular architecture support"];
+    readonly features: readonly ["Post-quantum cryptography (XMSS, ML-KEM-1024)", "Cross-platform compatibility", "Type-safe APIs", "DAG-based transaction processing", "GraphQL integration", "Real-time subscriptions", "Cellular architecture support"];
     readonly build: {
         readonly target: "ES2022";
         readonly formats: readonly ["esm", "cjs", "iife"];
@@ -2232,10 +2238,10 @@ declare const DevUtils: {
         nodeVersion: string;
         environment: string;
         name: "KnishIO-Client-TS";
-        version: "0.9.7";
+        version: "1.0.0";
         description: "TypeScript SDK for Knish.IO post-blockchain distributed ledger";
         compatibleServerVersions: number[];
-        features: readonly ["Post-quantum cryptography (XMSS, ML-KEM768)", "Cross-platform compatibility", "Type-safe APIs", "DAG-based transaction processing", "GraphQL integration", "Real-time subscriptions", "Cellular architecture support"];
+        features: readonly ["Post-quantum cryptography (XMSS, ML-KEM-1024)", "Cross-platform compatibility", "Type-safe APIs", "DAG-based transaction processing", "GraphQL integration", "Real-time subscriptions", "Cellular architecture support"];
         build: {
             readonly target: "ES2022";
             readonly formats: readonly ["esm", "cjs", "iife"];
@@ -2259,10 +2265,10 @@ declare const KnishIO: {
     SDK_VERSION: string;
     SDK_INFO: {
         readonly name: "KnishIO-Client-TS";
-        readonly version: "0.9.7";
+        readonly version: "1.0.0";
         readonly description: "TypeScript SDK for Knish.IO post-blockchain distributed ledger";
         readonly compatibleServerVersions: number[];
-        readonly features: readonly ["Post-quantum cryptography (XMSS, ML-KEM768)", "Cross-platform compatibility", "Type-safe APIs", "DAG-based transaction processing", "GraphQL integration", "Real-time subscriptions", "Cellular architecture support"];
+        readonly features: readonly ["Post-quantum cryptography (XMSS, ML-KEM-1024)", "Cross-platform compatibility", "Type-safe APIs", "DAG-based transaction processing", "GraphQL integration", "Real-time subscriptions", "Cellular architecture support"];
         readonly build: {
             readonly target: "ES2022";
             readonly formats: readonly ["esm", "cjs", "iife"];