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

    Class Sntrup761

    sntrup761 key encapsulation mechanism wrapper class

    Sntrup761

    High-level wrapper for sntrup761 KEM operations. Provides secure key generation, encapsulation, and decapsulation with automatic memory management.

    Memory Management:

    • All WASM memory is managed internally
    • Call destroy() when finished to free resources
    • Do not use instance after calling destroy()
    const kem = await createSntrup761();

    // Generate keypair
    const { publicKey, secretKey } = kem.generateKeyPair();

    // Encapsulate
    const { ciphertext, sharedSecret: senderSecret } = kem.encapsulate(publicKey);

    // Decapsulate
    const receiverSecret = kem.decapsulate(ciphertext, secretKey);

    // Cleanup
    kem.destroy();
    Index

    Accessors

    info

    Methods

    generateKeyPair encapsulate decapsulate destroy

    Accessors

    • get info(): {
          name: "sntrup761";
          identifier: "sntrup761";
          type: "kem";
          securityLevel: 3;
          standardized: false;
          description: string;
          keySize: {
              publicKey: 1158;
              secretKey: 1763;
              ciphertext: 1039;
              sharedSecret: 32;
          };
      }

      Get algorithm information

      Returns {
          name: "sntrup761";
          identifier: "sntrup761";
          type: "kem";
          securityLevel: 3;
          standardized: false;
          description: string;
          keySize: {
              publicKey: 1158;
              secretKey: 1763;
              ciphertext: 1039;
              sharedSecret: 32;
          };
      }

      Algorithm metadata

      console.log(kem.info.name);           // 'sntrup761'
      console.log(kem.info.securityLevel);  // 3
      console.log(kem.info.keySize);        // { publicKey: 1158, secretKey: 1763, ciphertext: 1039, sharedSecret: 32 }

    Methods

    • Generate a new sntrup761 keypair

      Returns { publicKey: Uint8Array; secretKey: Uint8Array }

      If instance is destroyed

      If key generation fails

      const { publicKey, secretKey } = kem.generateKeyPair();
      console.log('Public key:', publicKey.length);  // 1158 bytes
      console.log('Secret key:', secretKey.length);  // 1763 bytes

    • Encapsulate a shared secret using the public key

      Parameters

      • publicKey: Uint8Array<ArrayBufferLike>

        Public key for encapsulation (1158 bytes)

      Returns { ciphertext: Uint8Array; sharedSecret: Uint8Array }

      If instance is destroyed

      If public key is invalid

      If encapsulation fails

      const { ciphertext, sharedSecret } = kem.encapsulate(publicKey);
      console.log('Ciphertext:', ciphertext.length);     // 1039 bytes
      console.log('Shared secret:', sharedSecret.length); // 32 bytes

    • Decapsulate a shared secret using the secret key

      Parameters

      • ciphertext: Uint8Array<ArrayBufferLike>

        Ciphertext to decapsulate (1039 bytes)

      • secretKey: Uint8Array<ArrayBufferLike>

        Secret key for decapsulation (1763 bytes)

      Returns Uint8Array<ArrayBufferLike>

      Shared secret (32 bytes)

      If instance is destroyed

      If inputs are invalid

      If decapsulation fails

      const sharedSecret = kem.decapsulate(ciphertext, secretKey);
      console.log('Shared secret:', sharedSecret.length); // 32 bytes

    • Free WASM resources

      Returns void

      Releases all WASM memory associated with this instance. The instance cannot be used after calling destroy().

      kem.destroy();
      // kem is now unusable

    Settings

    Member Visibility

    On This Page

    Accessors
    Methods