@openforge-sh/liboqs - v0.14.3
    Preparing search index...

    Class ClassicMcEliece348864f

    Classic-McEliece-348864f wrapper class providing high-level KEM operations

    This class wraps the low-level WASM module to provide a user-friendly interface for Classic-McEliece-348864f operations with automatic memory management and input validation.

    ClassicMcEliece348864f

    import { createClassicMcEliece348864f } from '@openforge-sh/liboqs';

    const kem = await createClassicMcEliece348864f();
    const { publicKey, secretKey } = kem.generateKeyPair();
    const { ciphertext, sharedSecret } = kem.encapsulate(publicKey);
    kem.destroy();
    Index

    Accessors

    • get info(): {
          name: "Classic-McEliece-348864f";
          identifier: "Classic-McEliece-348864f";
          type: "kem";
          securityLevel: 1;
          standardized: false;
          description: string;
          keySize: {
              publicKey: 261120;
              secretKey: 6492;
              ciphertext: 96;
              sharedSecret: 32;
          };
      }

      Get algorithm information and constants

      Returns {
          name: "Classic-McEliece-348864f";
          identifier: "Classic-McEliece-348864f";
          type: "kem";
          securityLevel: 1;
          standardized: false;
          description: string;
          keySize: {
              publicKey: 261120;
              secretKey: 6492;
              ciphertext: 96;
              sharedSecret: 32;
          };
      }

      Algorithm metadata (copy of CLASSIC_MCELIECE_348864F_INFO)

      const info = kem.info;
      console.log(info.keySize.publicKey); // 261120

    Methods

    • Generate a new keypair for Classic-McEliece-348864f

      Generates a public/private keypair using the algorithm's internal random number generator. The secret key must be kept confidential.

      Returns publicKey

      Generated keypair

      If keypair generation fails

      If instance has been destroyed

      const { publicKey, secretKey } = kem.generateKeyPair();
      // publicKey: 261120 bytes
      // secretKey: 6492 bytes (keep confidential!)
    • Encapsulate a shared secret using a public key

      Generates a random shared secret and encapsulates it using the provided public key. The shared secret can be used for symmetric encryption.

      Parameters

      • publicKey: Uint8Array<ArrayBufferLike>

        Recipient's public key (261120 bytes)

      Returns ciphertext

      Encapsulation result

      If public key is invalid

      If encapsulation fails

      If instance has been destroyed

      const { ciphertext, sharedSecret } = kem.encapsulate(recipientPublicKey);
      // ciphertext: 96 bytes (send to recipient)
      // sharedSecret: 32 bytes (use for symmetric encryption)
    • Decapsulate a shared secret using a secret key

      Recovers the shared secret from a ciphertext using the secret key. The recovered shared secret will match the one generated during encapsulation.

      Parameters

      • ciphertext: Uint8Array<ArrayBufferLike>

        Ciphertext received (96 bytes)

      • secretKey: Uint8Array<ArrayBufferLike>

        Recipient's secret key (6492 bytes)

      Returns Uint8Array<ArrayBufferLike>

      Recovered shared secret (32 bytes)

      If inputs are invalid

      If decapsulation fails

      If instance has been destroyed

      const sharedSecret = kem.decapsulate(ciphertext, mySecretKey);
      // sharedSecret: 32 bytes (matches sender's shared secret)
    • Clean up resources and free WASM memory

      This method should be called when you're done using the instance to free WASM memory. After calling destroy(), the instance cannot be used for further operations.

      Returns void

      const kem = await createClassicMcEliece348864f();
      // ... use kem ...
      kem.destroy();