ox 1.1.0 → 1.2.0

package/dist/wasm/Secp256k1.js

@@ -0,0 +1,181 @@
+import * as Errors from '../core/Errors.js';
+import * as secp256k1 from './internal/secp256k1.js';
+export * from '../core/Secp256k1.js';
+export { MemoryError } from './internal/instantiate.js';
+const privateKeySize = 32;
+const publicKeySize = 65;
+const sharedSecretSize = 33;
+const compactSignatureSize = 64;
+const recoveredSignatureSize = 65;
+const maxRawMessageSize = 8192;
+/**
+ * Compiles WASM implementations of deterministic
+ * [`Secp256k1`](/api/Secp256k1) primitives, without installing them.
+ *
+ * Random key generation remains on Ox's host-backed default implementation.
+ *
+ * @example
+ * ```ts twoslash
+ * // @noErrors
+ * import { Engine } from 'ox'
+ * import { Secp256k1 } from 'ox/wasm'
+ *
+ * await Engine.install({ Secp256k1: Secp256k1.engine() })
+ *
+ * Secp256k1.getPublicKey({ privateKey: '0x...' })
+ * ```
+ *
+ * @returns The WASM implementation of the deterministic `Secp256k1` primitives.
+ */
+export async function engine() {
+    const module = await secp256k1.load();
+    return {
+        getPublicKey(privateKey) {
+            assertLength(privateKey, privateKeySize, 'private key');
+            const size = privateKeySize + publicKeySize;
+            module.reserve(size);
+            const privateKeyPtr = module.heapBase;
+            const publicKeyPtr = privateKeyPtr + privateKeySize;
+            try {
+                module.view().set(privateKey, privateKeyPtr);
+                if (module.exports.secp256k1_get_public_key(privateKeyPtr, publicKeyPtr) !== 1)
+                    throw new InvalidInputError({ operation: 'getPublicKey' });
+                return module.view().slice(publicKeyPtr, publicKeyPtr + publicKeySize);
+            }
+            finally {
+                module.exports.zero(privateKeyPtr, size);
+            }
+        },
+        getSharedSecret(privateKey, publicKey) {
+            assertLength(privateKey, privateKeySize, 'private key');
+            assertPublicKeyLength(publicKey);
+            const size = privateKeySize + publicKey.length + sharedSecretSize;
+            module.reserve(size);
+            const privateKeyPtr = module.heapBase;
+            const publicKeyPtr = privateKeyPtr + privateKeySize;
+            const sharedSecretPtr = publicKeyPtr + publicKey.length;
+            try {
+                const memory = module.view();
+                memory.set(privateKey, privateKeyPtr);
+                memory.set(publicKey, publicKeyPtr);
+                if (module.exports.secp256k1_get_shared_secret(privateKeyPtr, publicKeyPtr, publicKey.length, sharedSecretPtr) !== 1)
+                    throw new InvalidInputError({ operation: 'getSharedSecret' });
+                return module
+                    .view()
+                    .slice(sharedSecretPtr, sharedSecretPtr + sharedSecretSize);
+            }
+            finally {
+                module.exports.zero(privateKeyPtr, size);
+            }
+        },
+        recoverPublicKey(signature, payload) {
+            assertLength(signature, recoveredSignatureSize, 'signature');
+            assertRawMessageLength(payload);
+            const size = recoveredSignatureSize + payload.length + publicKeySize;
+            module.reserve(size);
+            const signaturePtr = module.heapBase;
+            const payloadPtr = signaturePtr + recoveredSignatureSize;
+            const publicKeyPtr = payloadPtr + payload.length;
+            try {
+                const memory = module.view();
+                memory.set(signature, signaturePtr);
+                memory.set(payload, payloadPtr);
+                if (module.exports.secp256k1_recover_public_key(signaturePtr, payloadPtr, payload.length, publicKeyPtr) !== 1)
+                    throw new InvalidInputError({ operation: 'recoverPublicKey' });
+                return module.view().slice(publicKeyPtr, publicKeyPtr + publicKeySize);
+            }
+            finally {
+                module.exports.zero(signaturePtr, size);
+            }
+        },
+        sign(payload, privateKey, options) {
+            assertLength(privateKey, privateKeySize, 'private key');
+            if (!options.prehash)
+                assertRawMessageLength(payload);
+            const entropy = options.extraEntropy === true
+                ? crypto.getRandomValues(new Uint8Array(privateKeySize))
+                : options.extraEntropy === false
+                    ? undefined
+                    : options.extraEntropy;
+            const entropySize = entropy?.length ?? 0;
+            const size = payload.length + privateKeySize + entropySize + recoveredSignatureSize;
+            module.reserve(size);
+            const payloadPtr = module.heapBase;
+            const privateKeyPtr = payloadPtr + payload.length;
+            const entropyPtr = entropy ? privateKeyPtr + privateKeySize : 0;
+            const signaturePtr = privateKeyPtr + privateKeySize + entropySize;
+            try {
+                const memory = module.view();
+                memory.set(payload, payloadPtr);
+                memory.set(privateKey, privateKeyPtr);
+                if (entropy)
+                    memory.set(entropy, entropyPtr);
+                if (module.exports.secp256k1_sign(payloadPtr, payload.length, privateKeyPtr, entropyPtr, entropySize, Number(options.prehash), signaturePtr) !== 1)
+                    throw new InvalidInputError({ operation: 'sign' });
+                return module
+                    .view()
+                    .slice(signaturePtr, signaturePtr + recoveredSignatureSize);
+            }
+            finally {
+                module.exports.zero(payloadPtr, size);
+            }
+        },
+        verify(signature, payload, publicKey, options) {
+            assertLength(signature, compactSignatureSize, 'signature');
+            assertPublicKeyLength(publicKey);
+            if (!options.prehash && payload.length > maxRawMessageSize)
+                return false;
+            const size = compactSignatureSize + payload.length + publicKey.length;
+            module.reserve(size);
+            const signaturePtr = module.heapBase;
+            const payloadPtr = signaturePtr + compactSignatureSize;
+            const publicKeyPtr = payloadPtr + payload.length;
+            try {
+                const memory = module.view();
+                memory.set(signature, signaturePtr);
+                memory.set(payload, payloadPtr);
+                memory.set(publicKey, publicKeyPtr);
+                return (module.exports.secp256k1_verify(signaturePtr, payloadPtr, payload.length, publicKeyPtr, publicKey.length, Number(options.prehash)) === 1);
+            }
+            finally {
+                module.exports.zero(signaturePtr, size);
+            }
+        },
+    };
+}
+function assertLength(value, length, name) {
+    if (value.length !== length)
+        throw new RangeError(`Secp256k1 ${name} must be ${length} bytes, got ${value.length}`);
+}
+function assertPublicKeyLength(publicKey) {
+    if (publicKey.length !== sharedSecretSize &&
+        publicKey.length !== publicKeySize)
+        throw new RangeError(`Secp256k1 public key must be 33 or 65 bytes, got ${publicKey.length}`);
+}
+function assertRawMessageLength(payload) {
+    if (payload.length > maxRawMessageSize)
+        throw new RangeError(`Secp256k1 unhashed payload must not exceed ${maxRawMessageSize} bytes, got ${payload.length}`);
+}
+/**
+ * Thrown when libsecp256k1 rejects a key or recovered signature.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Secp256k1 } from 'ox/wasm'
+ *
+ * try {
+ *   const engine = await Secp256k1.engine()
+ *   engine.getPublicKey(new Uint8Array(32))
+ * } catch (error) {
+ *   if (error instanceof Secp256k1.InvalidInputError)
+ *     console.error(error.message)
+ * }
+ * ```
+ */
+export class InvalidInputError extends Errors.BaseError {
+    name = 'Secp256k1.InvalidInputError';
+    constructor({ operation }) {
+        super(`WASM secp256k1 ${operation} received invalid input.`);
+    }
+}
+//# sourceMappingURL=Secp256k1.js.map

package/dist/wasm/Secp256k1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Secp256k1.js","sourceRoot":"","sources":["../../src/wasm/Secp256k1.ts"],"names":[],"mappings":"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"}

package/dist/wasm/X25519.d.ts

@@ -0,0 +1,33 @@
+import type * as Engine from '../core/Engine.js';
+import type * as Errors from '../core/Errors.js';
+import * as internal from './internal/instantiate.js';
+export * from '../core/X25519.js';
+export { MemoryError } from './internal/instantiate.js';
+/**
+ * Compiles WASM implementations of selected [`X25519`](/api/X25519)
+ * primitives, without installing them.
+ *
+ * Random key generation remains on Ox's default implementation.
+ *
+ * @example
+ * ```ts twoslash
+ * // @noErrors
+ * import { Engine } from 'ox'
+ * import { X25519 } from 'ox/wasm'
+ *
+ * await Engine.install({ X25519: X25519.engine() })
+ *
+ * X25519.getPublicKey({ privateKey: '0x...' })
+ * ```
+ *
+ * @returns The WASM implementation of part of the `X25519` slot.
+ */
+export declare function engine(): Promise<engine.ReturnType>;
+export declare namespace engine {
+    /** Every `X25519` primitive this module implements. */
+    type ReturnType = {
+        [key in 'getPublicKey' | 'getSharedSecret']-?: NonNullable<Engine.Ecdh[key]>;
+    };
+    type ErrorType = internal.MemoryError | Errors.GlobalErrorType;
+}
+//# sourceMappingURL=X25519.d.ts.map

package/dist/wasm/X25519.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"X25519.d.ts","sourceRoot":"","sources":["../../src/wasm/X25519.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,MAAM,mBAAmB,CAAA;AAChD,OAAO,KAAK,KAAK,MAAM,MAAM,mBAAmB,CAAA;AAEhD,OAAO,KAAK,QAAQ,MAAM,2BAA2B,CAAA;AAGrD,cAAc,mBAAmB,CAAA;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AAIvD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAuBzD;AAED,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC;IAC9B,uDAAuD;IACvD,KAAK,UAAU,GAAG;SACf,GAAG,IAAI,cAAc,GAAG,iBAAiB,CAAC,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;KAC7E,CAAA;IAED,KAAK,SAAS,GAAG,QAAQ,CAAC,WAAW,GAAG,MAAM,CAAC,eAAe,CAAA;CAC/D"}

package/dist/wasm/X25519.js

@@ -0,0 +1,53 @@
+import * as crypto25519 from './internal/crypto25519.js';
+import * as x25519 from './internal/x25519.js';
+export * from '../core/X25519.js';
+export { MemoryError } from './internal/instantiate.js';
+const keySize = 32;
+/**
+ * Compiles WASM implementations of selected [`X25519`](/api/X25519)
+ * primitives, without installing them.
+ *
+ * Random key generation remains on Ox's default implementation.
+ *
+ * @example
+ * ```ts twoslash
+ * // @noErrors
+ * import { Engine } from 'ox'
+ * import { X25519 } from 'ox/wasm'
+ *
+ * await Engine.install({ X25519: X25519.engine() })
+ *
+ * X25519.getPublicKey({ privateKey: '0x...' })
+ * ```
+ *
+ * @returns The WASM implementation of part of the `X25519` slot.
+ */
+export async function engine() {
+    const module = await crypto25519.load();
+    return {
+        getPublicKey(privateKey) {
+            assertLength(privateKey, 'private');
+            module.reserve(keySize * 2);
+            const privateKeyPtr = module.heapBase;
+            const publicKeyPtr = privateKeyPtr + keySize;
+            try {
+                module.view().set(privateKey, privateKeyPtr);
+                module.exports.x25519_get_public_key(privateKeyPtr, publicKeyPtr);
+                return module.view().slice(publicKeyPtr, publicKeyPtr + keySize);
+            }
+            finally {
+                module.exports.zero(privateKeyPtr, keySize * 2);
+            }
+        },
+        getSharedSecret(privateKey, publicKey) {
+            assertLength(privateKey, 'private');
+            assertLength(publicKey, 'public');
+            return x25519.getSharedSecret(module, privateKey, publicKey);
+        },
+    };
+}
+function assertLength(key, type) {
+    if (key.length !== keySize)
+        throw new RangeError(`X25519 ${type} key must be ${keySize} bytes, got ${key.length}`);
+}
+//# sourceMappingURL=X25519.js.map

package/dist/wasm/X25519.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"X25519.js","sourceRoot":"","sources":["../../src/wasm/X25519.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,WAAW,MAAM,2BAA2B,CAAA;AAExD,OAAO,KAAK,MAAM,MAAM,sBAAsB,CAAA;AAE9C,cAAc,mBAAmB,CAAA;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AAEvD,MAAM,OAAO,GAAG,EAAE,CAAA;AAElB;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM;IAC1B,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,IAAI,EAAE,CAAA;IAEvC,OAAO;QACL,YAAY,CAAC,UAAU;YACrB,YAAY,CAAC,UAAU,EAAE,SAAS,CAAC,CAAA;YACnC,MAAM,CAAC,OAAO,CAAC,OAAO,GAAG,CAAC,CAAC,CAAA;YAC3B,MAAM,aAAa,GAAG,MAAM,CAAC,QAAQ,CAAA;YACrC,MAAM,YAAY,GAAG,aAAa,GAAG,OAAO,CAAA;YAC5C,IAAI,CAAC;gBACH,MAAM,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,UAAU,EAAE,aAAa,CAAC,CAAA;gBAC5C,MAAM,CAAC,OAAO,CAAC,qBAAqB,CAAC,aAAa,EAAE,YAAY,CAAC,CAAA;gBACjE,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,CAAA;YAClE,CAAC;oBAAS,CAAC;gBACT,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,OAAO,GAAG,CAAC,CAAC,CAAA;YACjD,CAAC;QACH,CAAC;QACD,eAAe,CAAC,UAAU,EAAE,SAAS;YACnC,YAAY,CAAC,UAAU,EAAE,SAAS,CAAC,CAAA;YACnC,YAAY,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;YACjC,OAAO,MAAM,CAAC,eAAe,CAAC,MAAM,EAAE,UAAU,EAAE,SAAS,CAAC,CAAA;QAC9D,CAAC;KACF,CAAA;AACH,CAAC;AAWD,SAAS,YAAY,CAAC,GAAe,EAAE,IAA0B;IAC/D,IAAI,GAAG,CAAC,MAAM,KAAK,OAAO;QACxB,MAAM,IAAI,UAAU,CAClB,UAAU,IAAI,gBAAgB,OAAO,eAAe,GAAG,CAAC,MAAM,EAAE,CACjE,CAAA;AACL,CAAC"}

package/dist/wasm/index.d.ts

@@ -1,10 +1,10 @@
 /** @entrypointCategory WASM */
 /**
- * WASM implementations of ox's hash primitives, compiled from C.
+ * WASM implementations of Ox's supported cryptographic primitives, compiled
+ * from C.
  *
- * Load it and hand the result to {@link ox#Engine.set}. WASM must be compiled
- * asynchronously, so the `await` lives here -- every call afterwards is
- * synchronous.
+ * Install it during startup. WASM must be compiled asynchronously, so the
+ * `await` lives there. Every cryptographic call afterwards is synchronous.
  *
  * :::note
  * Performance varies by primitive, input size, runtime, and processor. Run
@@ -15,32 +15,144 @@
  * @example
  * ```ts twoslash
  * // @noErrors
- * import { Hash } from 'ox'
- * import { Engine } from 'ox/wasm'
+ * import { Engine, Hash } from 'ox/wasm'
  *
- * await Engine.load()
+ * await Engine.install()
  *
- * Hash.keccak256('0xdeadbeef')
+ * Hash.sha256('0xdeadbeef')
  * ```
  *
  * @category Crypto
  */
 export * as Engine from './Engine.js';
+/**
+ * WASM implementations of Ox's supported Ed25519 primitives.
+ *
+ * @example
+ * ```ts twoslash
+ * // @noErrors
+ * import { Engine } from 'ox'
+ * import { Ed25519 } from 'ox/wasm'
+ *
+ * await Engine.install({ Ed25519: Ed25519.engine() })
+ *
+ * Ed25519.getPublicKey({ privateKey: '0x...' })
+ * ```
+ *
+ * @category Crypto
+ */
+export * as Ed25519 from './Ed25519.js';
 /**
  * WASM implementations of Ox's supported hash primitives.
  *
  * @example
  * ```ts twoslash
  * // @noErrors
- * import { Engine, Hash } from 'ox'
- * import * as WasmHash from 'ox/wasm/Hash'
+ * import { Engine } from 'ox'
+ * import { Hash } from 'ox/wasm'
  *
- * Engine.set(await WasmHash.create())
+ * await Engine.install({ Hash: Hash.engine() })
  *
- * Hash.keccak256('0xdeadbeef')
+ * Hash.sha256('0xdeadbeef')
  * ```
  *
  * @category Crypto
  */
 export * as Hash from './Hash.js';
+/**
+ * WASM implementations of Ox's synchronous PBKDF2-HMAC-SHA256 and scrypt
+ * primitives.
+ *
+ * @example
+ * ```ts twoslash
+ * // @noErrors
+ * import { Engine } from 'ox'
+ * import { Keystore } from 'ox/wasm'
+ *
+ * await Engine.install({ Keystore: Keystore.engine() })
+ *
+ * Keystore.pbkdf2({ password: 'testpassword' })
+ * ```
+ *
+ * @category Crypto
+ */
+export * as Keystore from './Keystore.js';
+/**
+ * WASM implementation of Ox's KZG interface, backed by c-kzg-4844.
+ *
+ * This module is not installed into [`Engine`](/api/Engine). Create an explicit
+ * instance, pass it anywhere that accepts `Kzg.Kzg`, and dispose it when done.
+ *
+ * @example
+ * ```ts twoslash
+ * // @noErrors
+ * import { Setups } from 'ox/trusted-setups'
+ * import { Kzg } from 'ox/wasm'
+ *
+ * const kzg = await Kzg.create({
+ *   trustedSetup: Setups.mainnet
+ * })
+ *
+ * kzg.dispose()
+ * ```
+ *
+ * @category Crypto
+ */
+export * as Kzg from './Kzg.js';
+/**
+ * WASM implementation of Ox's BIP-39 seed derivation.
+ *
+ * @example
+ * ```ts twoslash
+ * // @noErrors
+ * import { Engine } from 'ox'
+ * import { Mnemonic } from 'ox/wasm'
+ *
+ * await Engine.install({ Mnemonic: Mnemonic.engine() })
+ *
+ * Mnemonic.toSeed(
+ *   'test test test test test test test test test test test junk'
+ * )
+ * ```
+ *
+ * @category Crypto
+ */
+export * as Mnemonic from './Mnemonic.js';
+/**
+ * WASM implementations of deterministic Secp256k1 primitives.
+ *
+ * This provider is opt-in because its embedded libsecp256k1 artifact is larger
+ * than the modules installed by [`Engine.install`](/api/Engine/install).
+ *
+ * @example
+ * ```ts twoslash
+ * // @noErrors
+ * import { Engine } from 'ox'
+ * import { Secp256k1 } from 'ox/wasm'
+ *
+ * await Engine.install({ Secp256k1: Secp256k1.engine() })
+ *
+ * Secp256k1.getPublicKey({ privateKey: '0x...' })
+ * ```
+ *
+ * @category Crypto
+ */
+export * as Secp256k1 from './Secp256k1.js';
+/**
+ * WASM implementations of Ox's supported X25519 primitives.
+ *
+ * @example
+ * ```ts twoslash
+ * // @noErrors
+ * import { Engine } from 'ox'
+ * import { X25519 } from 'ox/wasm'
+ *
+ * await Engine.install({ X25519: X25519.engine() })
+ *
+ * X25519.getPublicKey({ privateKey: '0x...' })
+ * ```
+ *
+ * @category Crypto
+ */
+export * as X25519 from './X25519.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/wasm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/wasm/index.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAE/B;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AAErC;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/wasm/index.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAE/B;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AAErC;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AAEvC;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AAEjC;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AAEzC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAAK,GAAG,MAAM,UAAU,CAAA;AAE/B;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AAEzC;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAE3C;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA"}

package/dist/wasm/index.js

@@ -1,10 +1,10 @@
 /** @entrypointCategory WASM */
 /**
- * WASM implementations of ox's hash primitives, compiled from C.
+ * WASM implementations of Ox's supported cryptographic primitives, compiled
+ * from C.
  *
- * Load it and hand the result to {@link ox#Engine.set}. WASM must be compiled
- * asynchronously, so the `await` lives here -- every call afterwards is
- * synchronous.
+ * Install it during startup. WASM must be compiled asynchronously, so the
+ * `await` lives there. Every cryptographic call afterwards is synchronous.
  *
  * :::note
  * Performance varies by primitive, input size, runtime, and processor. Run
@@ -15,32 +15,144 @@
  * @example
  * ```ts twoslash
  * // @noErrors
- * import { Hash } from 'ox'
- * import { Engine } from 'ox/wasm'
+ * import { Engine, Hash } from 'ox/wasm'
  *
- * await Engine.load()
+ * await Engine.install()
  *
- * Hash.keccak256('0xdeadbeef')
+ * Hash.sha256('0xdeadbeef')
  * ```
  *
  * @category Crypto
  */
 export * as Engine from './Engine.js';
+/**
+ * WASM implementations of Ox's supported Ed25519 primitives.
+ *
+ * @example
+ * ```ts twoslash
+ * // @noErrors
+ * import { Engine } from 'ox'
+ * import { Ed25519 } from 'ox/wasm'
+ *
+ * await Engine.install({ Ed25519: Ed25519.engine() })
+ *
+ * Ed25519.getPublicKey({ privateKey: '0x...' })
+ * ```
+ *
+ * @category Crypto
+ */
+export * as Ed25519 from './Ed25519.js';
 /**
  * WASM implementations of Ox's supported hash primitives.
  *
  * @example
  * ```ts twoslash
  * // @noErrors
- * import { Engine, Hash } from 'ox'
- * import * as WasmHash from 'ox/wasm/Hash'
+ * import { Engine } from 'ox'
+ * import { Hash } from 'ox/wasm'
  *
- * Engine.set(await WasmHash.create())
+ * await Engine.install({ Hash: Hash.engine() })
  *
- * Hash.keccak256('0xdeadbeef')
+ * Hash.sha256('0xdeadbeef')
  * ```
  *
  * @category Crypto
  */
 export * as Hash from './Hash.js';
+/**
+ * WASM implementations of Ox's synchronous PBKDF2-HMAC-SHA256 and scrypt
+ * primitives.
+ *
+ * @example
+ * ```ts twoslash
+ * // @noErrors
+ * import { Engine } from 'ox'
+ * import { Keystore } from 'ox/wasm'
+ *
+ * await Engine.install({ Keystore: Keystore.engine() })
+ *
+ * Keystore.pbkdf2({ password: 'testpassword' })
+ * ```
+ *
+ * @category Crypto
+ */
+export * as Keystore from './Keystore.js';
+/**
+ * WASM implementation of Ox's KZG interface, backed by c-kzg-4844.
+ *
+ * This module is not installed into [`Engine`](/api/Engine). Create an explicit
+ * instance, pass it anywhere that accepts `Kzg.Kzg`, and dispose it when done.
+ *
+ * @example
+ * ```ts twoslash
+ * // @noErrors
+ * import { Setups } from 'ox/trusted-setups'
+ * import { Kzg } from 'ox/wasm'
+ *
+ * const kzg = await Kzg.create({
+ *   trustedSetup: Setups.mainnet
+ * })
+ *
+ * kzg.dispose()
+ * ```
+ *
+ * @category Crypto
+ */
+export * as Kzg from './Kzg.js';
+/**
+ * WASM implementation of Ox's BIP-39 seed derivation.
+ *
+ * @example
+ * ```ts twoslash
+ * // @noErrors
+ * import { Engine } from 'ox'
+ * import { Mnemonic } from 'ox/wasm'
+ *
+ * await Engine.install({ Mnemonic: Mnemonic.engine() })
+ *
+ * Mnemonic.toSeed(
+ *   'test test test test test test test test test test test junk'
+ * )
+ * ```
+ *
+ * @category Crypto
+ */
+export * as Mnemonic from './Mnemonic.js';
+/**
+ * WASM implementations of deterministic Secp256k1 primitives.
+ *
+ * This provider is opt-in because its embedded libsecp256k1 artifact is larger
+ * than the modules installed by [`Engine.install`](/api/Engine/install).
+ *
+ * @example
+ * ```ts twoslash
+ * // @noErrors
+ * import { Engine } from 'ox'
+ * import { Secp256k1 } from 'ox/wasm'
+ *
+ * await Engine.install({ Secp256k1: Secp256k1.engine() })
+ *
+ * Secp256k1.getPublicKey({ privateKey: '0x...' })
+ * ```
+ *
+ * @category Crypto
+ */
+export * as Secp256k1 from './Secp256k1.js';
+/**
+ * WASM implementations of Ox's supported X25519 primitives.
+ *
+ * @example
+ * ```ts twoslash
+ * // @noErrors
+ * import { Engine } from 'ox'
+ * import { X25519 } from 'ox/wasm'
+ *
+ * await Engine.install({ X25519: X25519.engine() })
+ *
+ * X25519.getPublicKey({ privateKey: '0x...' })
+ * ```
+ *
+ * @category Crypto
+ */
+export * as X25519 from './X25519.js';
 //# sourceMappingURL=index.js.map

package/dist/wasm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/wasm/index.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAE/B;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AAErC;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/wasm/index.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAE/B;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AAErC;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AAEvC;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AAEjC;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AAEzC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAAK,GAAG,MAAM,UAAU,CAAA;AAE/B;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AAEzC;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAE3C;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA"}

package/dist/wasm/internal/blake3.d.ts

@@ -0,0 +1,11 @@
+import * as internal from './instantiate.js';
+/** Exports supplied by the dedicated portable BLAKE3 artifact. @internal */
+export type Exports = {
+    blake3_hash(input: number, length: number, out: number): void;
+    zero(ptr: number, length: number): void;
+};
+/** Returns the one memoized BLAKE3 instance shared by its providers. */
+export declare function load(): Promise<internal.Module<Exports>>;
+/** Hashes an input through a loaded BLAKE3 module. @internal */
+export declare function hash(module: internal.Module<Exports>, input: Uint8Array): Uint8Array;
+//# sourceMappingURL=blake3.d.ts.map

package/dist/wasm/internal/blake3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blake3.d.ts","sourceRoot":"","sources":["../../../src/wasm/internal/blake3.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,QAAQ,MAAM,kBAAkB,CAAA;AAK5C,4EAA4E;AAC5E,MAAM,MAAM,OAAO,GAAG;IACpB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7D,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CACxC,CAAA;AAMD,wEAAwE;AACxE,wBAAgB,IAAI,sCAEnB;AAED,gEAAgE;AAChE,wBAAgB,IAAI,CAClB,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,EAChC,KAAK,EAAE,UAAU,GAChB,UAAU,CAmBZ"}