quanta-wasm

WebAssembly bindings for QuantaChain post-quantum cryptography — compiled from Rust using wasm-pack.

Provides Falcon-512 key generation, signing, and verification directly in the browser or Node.js at near-native speed. No server round-trips for cryptographic operations.

---

When to Use This Package

Use case	Package
Build wallets, explorers, or integrations	Use quanta-sdk (bundles this internally)
Need raw Falcon-512 WASM operations	Use quanta-wasm directly

Most developers should install quanta-sdk instead.

---

Installation

npm install quanta-wasm

Or with Cargo (Rust):

[dependencies]
quanta-wasm = "0.1"

---

Browser Usage

import init, {
  generate_keypair,
  sign_message,
  verify_signature,
  generate_mnemonic,
  keypair_from_mnemonic
} from 'quanta-wasm';

// Must call init() before any other function in browser environments
await init();

// Generate a Falcon-512 keypair
const keypair = generate_keypair();
console.log('Public key length:', keypair.public_key.length);   // 897 bytes
console.log('Address:', keypair.address);                        // "0x..."

// Sign a message
const message = new TextEncoder().encode("hello quanta");
const signature = sign_message(keypair.secret_key, message);

// Verify
const valid = verify_signature(keypair.public_key, message, signature);
console.log('Valid:', valid);   // true

---

Node.js Usage

In Node.js environments, initialization is automatic:

const { generate_keypair, generate_mnemonic } = require('quanta-wasm');

// No await needed in Node.js
const keypair = generate_keypair();
console.log('Address:', keypair.address);

const mnemonic = generate_mnemonic();
console.log('Mnemonic:', mnemonic);   // 24 BIP39 words

---

API Reference

generate_keypair() → Keypair

Generates a fresh Falcon-512 keypair.

const keypair = generate_keypair();
// keypair.public_key  — Uint8Array (897 bytes)
// keypair.secret_key  — Uint8Array (~1,281 bytes) — never share or send
// keypair.address     — string "0x" + hex(SHA3-256(pubkey)[0:20])

---

generate_mnemonic() → string

Generates a cryptographically secure 24-word BIP39 mnemonic.

const mnemonic = generate_mnemonic();
// "word1 word2 word3 ... word24"

---

keypair_from_mnemonic(mnemonic: string) → Keypair

Derives a deterministic Falcon-512 keypair from a 24-word BIP39 mnemonic.

const keypair = keypair_from_mnemonic("word1 word2 ... word24");
// Same mnemonic always produces the same keypair and address

---

sign_message(secret_key: Uint8Array, message: Uint8Array) → Uint8Array

Signs a message with a Falcon-512 secret key. Returns the signed-message blob (33–698 bytes).

const signature = sign_message(keypair.secret_key, messageBytes);

In the Quanta protocol, the message is always the canonical signing hash:

SHA3-256("QUANTA_TX_V1:" || signing_bytes)

The quanta-sdk handles this automatically — use TransactionBuilder.sign() instead of calling this directly for transactions.

---

verify_signature(public_key: Uint8Array, message: Uint8Array, signature: Uint8Array) → boolean

Verifies a Falcon-512 signature.

const valid = verify_signature(pubkey, message, signature);

Returns false (does not throw) for any invalid input.

---

Cryptographic Details

• Algorithm: Falcon-512 (NTRU lattice-based, NIST Level 1)
• Public key: exactly 897 bytes (consensus-enforced in the Quanta protocol)
• Secret key: ~1,281 bytes
• Signature: variable 33–698 bytes
• Security: 128-bit classical, 64-bit post-quantum (Grover's)
• No known quantum attack: Falcon relies on NTRU lattice problems — not affected by Shor's algorithm

Build Flags

The Rust source is compiled with:

• target-feature=+strict-float — enforces IEEE 754 compliance for consensus determinism across x86_64 and ARM64
• opt-level = "z" — minimize WASM binary size
• codegen-units = 1 — reproducible builds

---

Ecosystem

Package	Description
quanta-sdk	Full JS/TS SDK — wallets, transactions, node client
quanta-wasm	This package — raw Falcon-512 WASM bindings
Quanta Node	Rust node source — runs the blockchain

---

License

Apache-2.0 — see LICENSE