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

    Class ClassicMcEliece460896f

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

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

    ClassicMcEliece460896f

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

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

    Accessors

    • get info(): {
          name: "Classic-McEliece-460896f";
          identifier: "Classic-McEliece-460896f";
          type: "kem";
          securityLevel: 3;
          standardized: false;
          description: string;
          keySize: {
              publicKey: 524160;
              secretKey: 13608;
              ciphertext: 156;
              sharedSecret: 32;
          };
      }

      Get algorithm information and constants

      Returns {
          name: "Classic-McEliece-460896f";
          identifier: "Classic-McEliece-460896f";
          type: "kem";
          securityLevel: 3;
          standardized: false;
          description: string;
          keySize: {
              publicKey: 524160;
              secretKey: 13608;
              ciphertext: 156;
              sharedSecret: 32;
          };
      }

      Algorithm metadata (copy of CLASSIC_MCELIECE_460896F_INFO)

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

    Methods

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

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

      Returns { publicKey: Uint8Array; secretKey: Uint8Array }

      If keypair generation fails

      If instance has been destroyed

      const { publicKey, secretKey } = kem.generateKeyPair();
      // publicKey: 524160 bytes
      // secretKey: 13608 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 (524160 bytes)

      Returns { ciphertext: Uint8Array; sharedSecret: Uint8Array }

      If public key is invalid

      If encapsulation fails

      If instance has been destroyed

      const { ciphertext, sharedSecret } = kem.encapsulate(recipientPublicKey);
      // ciphertext: 156 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 (156 bytes)

      • secretKey: Uint8Array<ArrayBufferLike>

        Recipient's secret key (13608 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 createClassicMcEliece460896f();
      // ... use kem ...
      kem.destroy();