@unknownncat/curve25519-node 1.0.0 → 2.0.0

package/README.md

@@ -1,54 +1,27 @@
 # @unknownncat/curve25519-node
 
-[![npm](https://img.shields.io/npm/v/%40unknownncat%2Fcurve25519-node)](https://www.npmjs.com/package/@unknownncat/curve25519-node)
-[![downloads](https://img.shields.io/npm/dm/%40unknownncat%2Fcurve25519-node)](https://www.npmjs.com/package/@unknownncat/curve25519-node)
-[![types](https://img.shields.io/badge/types-included-blue)](./dist/index.d.ts)
-[![license](https://img.shields.io/github/license/unknownncat/curve25519-node)](./LICENSE)
-[![node](https://img.shields.io/badge/node-%3E%3D20-339933?logo=node.js&logoColor=white)](https://nodejs.org/)
-![runtime deps](https://img.shields.io/badge/runtime%20deps-0-brightgreen)
-![esm+cjs](https://img.shields.io/badge/ESM%20%2B%20CJS-compatible-blue)
-
-Modern **zero-dependency** X25519 + Ed25519 for Node.js using OpenSSL via `node:crypto`.
-
-- **Node:** `>= 20`
-- **Runtime deps:** `0`
-- **TypeScript:** `strict`, **ESM-first**
-- **Compat:** ESM + CJS (`import` e `require`)
-
----
-
-## Why
-
-O projeto original ([curve25519-js](https://github.com/harveyconnor/curve25519-js)) fazia aritmética de campo manual (loops extensos BigInt/Float64) para Curve25519/Ed25519.
+> 🇺🇸 English version: [README.en.md](./README.en.md)
 
-Este pacote troca isso por primitivas nativas do OpenSSL (via `node:crypto`), com foco em:
+Implementação sem dependências de runtime de:
 
-- **segurança** por implementação consolidada
-- **performance** melhor em Node moderno
-- **API pequena** e **bem tipada**
+- X25519 + Ed25519 (modo moderno via OpenSSL em `node:crypto`)
+- axlsign legado (modo opcional via WASM, compatível com `curve25519-js`)
 
----
-
-## Compatibility notes (importante)
-
-Este pacote **não replica o esquema `axlsign`** do `curve25519-js`.
-
-Aqui a API é **padrão moderna**:
-
-- acordo de chave: **X25519**
-- assinatura: **Ed25519**
-
-Consequências:
+[![npm](https://img.shields.io/npm/v/@unknownncat/curve25519-node)](https://www.npmjs.com/package/@unknownncat/curve25519-node)
+[![node](https://img.shields.io/badge/node-%3E%3D20-339933?logo=node.js&logoColor=white)](https://nodejs.org/)
+[![types](https://img.shields.io/badge/types-included-blue)](./dist/index.d.ts)
+![runtime deps](https://img.shields.io/badge/runtime%20deps-0-brightgreen)
+![esm+cjs](https://img.shields.io/badge/ESM%20%2B%20CJS-compatible-blue)
+[![license](https://img.shields.io/badge/license-MIT-green)](./LICENSE)
 
-- Chaves de X25519 e Ed25519 são **diferentes** (public keys diferentes).
-- `sign`/`verify` usam chaves **Ed25519**.
-- Conversão X25519 public key ↔ Ed25519 public key **não é exposta** por `node:crypto`.
-- `opt_random` (64 bytes) do legado **não é suportado** em Ed25519 com `node:crypto`.
-  - O compat layer aceita um 3º argumento apenas por compatibilidade de chamada, mas **sempre lança erro** se ele for fornecido.
+- Node: `>= 20`
+- Dependências de runtime: `0`
+- TypeScript: `strict`
+- Formatos de módulo: ESM + CJS
 
 ---
 
-## Install
+## Instalação
 
 ```bash
 npm i @unknownncat/curve25519-node
@@ -56,155 +29,304 @@ npm i @unknownncat/curve25519-node
 
 ---
 
-## Usage
-
-### ESM (TypeScript / Node moderno)
+## Uso Rápido
 
 ```ts
-import {
-  asBytes32,
-  x25519,
-  ed25519,
-  sign, // compat top-level (Ed25519)
-  verify, // compat top-level (Ed25519)
-} from "@unknownncat/curve25519-node";
+import { randomBytes } from "node:crypto";
+import { asBytes32, x25519, ed25519 } from "@unknownncat/curve25519-node";
 
-const aliceSeed = asBytes32(crypto.getRandomValues(new Uint8Array(32)));
-const bobSeed = asBytes32(crypto.getRandomValues(new Uint8Array(32)));
+const aliceSeed = asBytes32(randomBytes(32));
+const bobSeed = asBytes32(randomBytes(32));
 
 const aliceX = x25519.generateKeyPair(aliceSeed);
 const bobX = x25519.generateKeyPair(bobSeed);
 
-const s1 = x25519.sharedKey(aliceX.private, bobX.public);
-const s2 = x25519.sharedKey(bobX.private, aliceX.public);
-// s1 e s2 devem ser iguais
-
-const signerSeed = asBytes32(crypto.getRandomValues(new Uint8Array(32)));
-const ed = ed25519.generateKeyPair(signerSeed);
+const segredo1 = x25519.sharedKey(aliceX.private, bobX.public);
+const segredo2 = x25519.sharedKey(bobX.private, aliceX.public);
+// segredo1 === segredo2
 
+const signerSeed = asBytes32(randomBytes(32));
+const signer = ed25519.generateKeyPair(signerSeed);
 const msg = new TextEncoder().encode("hello");
 
 const sig = ed25519.sign(signerSeed, msg);
-const ok = verify(ed.public, msg, sig);
-
-const signedMsg = ed25519.signMessage(signerSeed, msg);
-const opened = ed25519.openMessage(ed.public, signedMsg);
+const ok = ed25519.verify(signer.public, msg, sig);
 ```
 
-### CommonJS
+CommonJS:
 
 ```js
 const { x25519, ed25519, asBytes32 } = require("@unknownncat/curve25519-node");
-
-const seed = asBytes32(new Uint8Array(32));
-const kp = x25519.generateKeyPair(seed);
-
-const sig = ed25519.sign(seed, Buffer.from("hello"));
 ```
 
-### Subpath imports (opcional)
+Legado axlsign via WASM:
 
 ```ts
-import { x25519 } from "@unknownncat/curve25519-node/x25519";
-import { ed25519 } from "@unknownncat/curve25519-node/ed25519";
-import { asBytes32, asBytes64 } from "@unknownncat/curve25519-node/types";
+import { asBytes32, axlsign } from "@unknownncat/curve25519-node";
+
+const seed = asBytes32(new Uint8Array(32));
+const kp = axlsign.generateKeyPair(seed); // X25519 keypair compatível com curve25519-js
+const sig = axlsign.sign(
+  kp.private,
+  new TextEncoder().encode("hello"),
+  new Uint8Array(64),
+);
+const ok = axlsign.verify(kp.public, new TextEncoder().encode("hello"), sig);
 ```
 
 ---
 
 ## API
 
-### Namespace `x25519`
+### `x25519`
 
 - `publicKey(secretKey32: Bytes32): Bytes32`
 - `sharedKey(secretKey32: Bytes32, publicKey32: Bytes32): Bytes32`
 - `generateKeyPair(seed32: Bytes32): { public: Bytes32; private: Bytes32 }`
 
-### Namespace `ed25519`
+### `ed25519`
 
 - `publicKey(secretSeed32: Bytes32): Bytes32`
 - `generateKeyPair(seed32: Bytes32): { public: Bytes32; private: Bytes32 }`
 - `sign(secretSeed32: Bytes32, msg: Uint8Array): Bytes64`
 - `verify(publicKey32: Bytes32, msg: Uint8Array, signature64: Bytes64): boolean`
-- `signMessage(secretSeed32: Bytes32, msg: Uint8Array): Uint8Array`
+- `signMessage(secretSeed32: Bytes32, msg: Uint8Array): Uint8Array` (`assinatura || mensagem`)
 - `openMessage(publicKey32: Bytes32, signedMsg: Uint8Array): Uint8Array | null`
 
-### Top-level compat layer
+### `axlsign` (compatibilidade legado, via WASM)
+
+- `publicKey(secretKey32: Bytes32): Bytes32`
+- `sharedKey(secretKey32: Bytes32, publicKey32: Bytes32): Bytes32`
+- `generateKeyPair(seed32: Bytes32): { public: Bytes32; private: Bytes32 }`
+- `sign(secretKey32: Bytes32, msg: Uint8Array, opt_random?: Bytes64): Bytes64`
+- `verify(publicKey32: Bytes32, msg: Uint8Array, signature64: Bytes64): boolean`
+- `signMessage(secretKey32: Bytes32, msg: Uint8Array, opt_random?: Bytes64): Uint8Array`
+- `openMessage(publicKey32: Bytes32, signedMsg: Uint8Array): Uint8Array | null`
+
+### Aliases de compatibilidade (top-level)
 
 - `sharedKey = x25519.sharedKey`
 - `generateKeyPair = x25519.generateKeyPair`
-- `sign`, `verify`, `signMessage`, `openMessage` (**Ed25519**)
+- `sign`, `verify`, `signMessage`, `openMessage` (semântica Ed25519)
 - `generateKeyPairX25519`, `generateKeyPairEd25519`
 
-> `sign` e `signMessage` aceitam um terceiro argumento opcional **apenas para compatibilidade de chamada**, mas **sempre lançam erro** se ele for fornecido (`opt_random` legado não suportado).
+---
+
+## Notas de Compatibilidade
+
+Este pacote suporta dois modos:
+
+- **moderno (recomendado):** `x25519` + `ed25519` via `node:crypto`
+- **legado:** `axlsign` via WASM para compatibilidade com `curve25519-js`
+
+| Recurso                             | `curve25519-js` | `curve25519-node`                            |
+| ----------------------------------- | --------------- | -------------------------------------------- |
+| Esquema de assinatura (moderno)     | axlsign         | Ed25519 (padrão)                             |
+| Esquema de assinatura (legado)      | axlsign         | axlsign (namespace `axlsign`)                |
+| Acordo de chave                     | X25519          | X25519                                       |
+| Mesma chave para assinatura + ECDH  | sim             | apenas no namespace `axlsign`                |
+| `opt_random` nas APIs de assinatura | sim             | sim no `axlsign`, não no top-level/`ed25519` |
+| Backend OpenSSL                     | não             | sim                                          |
+
+Importante:
+
+- Chaves públicas X25519 e Ed25519 são diferentes.
+- `node:crypto` não expõe API para converter public key X25519 ↔ Ed25519.
+- Top-level `sign`/`signMessage` e namespace `ed25519` continuam com semântica Ed25519 e rejeitam `opt_random`.
+- Para compatibilidade com `curve25519-js` (incluindo `opt_random`), use o namespace `axlsign`.
+- Assinaturas Ed25519 continuam determinísticas (comportamento padrão do OpenSSL).
 
 ---
 
-## Branded types
+## Motivação
+
+O `curve25519-js` é um projeto importante, mas usa aritmética de campo manual em JS (`Float64Array`, estilo TweetNaCl).
+
+Este pacote foca em Node moderno com primitivas do OpenSSL:
+
+- caminho de implementação mais seguro
+- melhor desempenho em Node >= 20
+- API menor e explícita
+- tipagem forte com zero dependências de runtime
+
+Além disso, o namespace `axlsign` via WASM permite migração progressiva de código legado sem reintroduzir aritmética de curva em JavaScript puro.
+
+---
+
+## Tipos Branded
 
 - `Bytes32`
 - `Bytes64`
 
-Helpers:
+Helpers (validam sem copiar):
 
 - `asBytes32(u8)`
 - `asBytes64(u8)`
 
-✅ Os helpers validam tamanho e retornam o **mesmo objeto** (sem cópia).
-
 ---
 
-## Technical details (RFC 8410 DER)
+## Mapa de RFCs (uso no projeto)
+
+| RFC                               | Seções usadas                                                                                                 | Uso no projeto                                                                                                                                  | Onde no código          |
+| --------------------------------- | ------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------- |
+| RFC 7748 (X25519)                 | Seção 5 (`The X25519 and X448 Functions`)                                                                     | Regras de clamping/decoding do escalar e comportamento da função X25519 (zera 3 bits baixos, zera bit mais alto, seta o segundo bit mais alto). | `src/x25519.ts`         |
+| RFC 7748 (X25519)                 | Seção 5.2 (`Test Vectors`), Seção 6.1 (`Diffie-Hellman / Curve25519`)                                         | Vetores oficiais para validação de interoperabilidade e corretude.                                                                              | `test/x25519.test.mjs`  |
+| RFC 8032 (Ed25519)                | Seção 5.1.5 (`Key Generation`), 5.1.6 (`Sign`), 5.1.7 (`Verify`)                                              | Semântica de keygen/sign/verify Ed25519 (executada por OpenSSL via `node:crypto`).                                                              | `src/ed25519.ts`        |
+| RFC 8032 (Ed25519)                | Seção 7.1 (`Test Vectors for Ed25519`)                                                                        | Vetores determinísticos para validação de chave pública e assinatura.                                                                           | `test/ed25519.test.mjs` |
+| RFC 8410 (X25519/Ed25519 em PKIX) | Seção 3 (identificadores de algoritmo), Seção 4 (`Subject Public Key Fields`), Seção 7 (`Private Key Format`) | Estrutura DER para import/export de chaves raw de 32 bytes em SPKI/PKCS#8 com OIDs de X25519 e Ed25519.                                         | `src/internal/der.ts`   |
+
+Referências indiretas por estrutura ASN.1/PKIX:
+
+- RFC 5958 (OneAsymmetricKey / família PKCS#8)
+- RFC 5280, Seção 4.1.2.7 (`Subject Public Key Info`)
 
-Prefixos usados para importar/exportar RAW(32) ↔ `KeyObject` via DER prealocado:
+Observações:
 
-- X25519 PKCS#8 prefix: `302e020100300506032b656e04220420`
-- X25519 SPKI prefix: `302a300506032b656e032100`
-- Ed25519 PKCS#8 prefix: `302e020100300506032b657004220420`
-- Ed25519 SPKI prefix: `302a300506032b6570032100`
+- O projeto não reimplementa aritmética de curva em JS; as operações criptográficas usam OpenSSL via `node:crypto`.
+- A suíte de testes cobre vetores oficiais do RFC 7748 e RFC 8032.
 
-As operações usam buffers DER prealocados + `.set`, sem loops byte-a-byte.
+Rodar testes:
+
+```bash
+npm test
+```
 
 ---
 
-## Performance notes
+## Detalhes Técnicos (DER / RFC 8410)
 
-- Sem `Buffer.concat` no hot path; buffers montados por prealloc + `.set`.
-- `Uint8Array` → `Buffer` usa view zero-copy:
-  - `Buffer.from(u8.buffer, u8.byteOffset, u8.byteLength)`
+Chaves raw de 32 bytes são importadas/exportadas com prefixos fixos:
 
-- `signMessage` monta `signature || msg` com `Uint8Array` prealocado e `.set`.
-- Para throughput máximo em loops longos, considere cachear `KeyObject` no nível da aplicação (evita parse ASN.1 repetido).
+- X25519 PKCS#8: `302e020100300506032b656e04220420`
+- X25519 SPKI: `302a300506032b656e032100`
+- Ed25519 PKCS#8: `302e020100300506032b657004220420`
+- Ed25519 SPKI: `302a300506032b6570032100`
+
+Notas de implementação:
+
+- buffers prealocados + `.set`
+- views zero-copy de `Uint8Array` quando seguro
+- sem `Buffer.concat` em hot path
+
+---
+
+## Notas de Performance
+
+- Evita cópias desnecessárias de bytes nos caminhos críticos.
+- `signMessage` monta `assinatura || mensagem` com um único `Uint8Array` prealocado.
+- Para throughput máximo em loops longos, cache de `KeyObject` no nível da aplicação reduz overhead de parse ASN.1.
 
 ---
 
-## Security
+## Notas de Segurança
 
-- Validação de tipo/tamanho em todas as entradas públicas.
-- Sem logs de segredo.
-- Comparações internas de DER prefix usam `timingSafeEqual`.
+- validação estrita de tipo/tamanho nas APIs públicas
+- sem log de segredos
+- `timingSafeEqual` em comparações internas de tamanho fixo quando necessário
 
 ---
 
-## Tests
+## Benchmarks
+
+A suíte de benchmark fica isolada em `bench/` (subprojeto separado) e compara com `curve25519-js`.
 
 ```bash
-npm test
+npm run build
+cd bench
+npm install
+npm run bench
 ```
 
-Cobertura inclui vetores RFC:
+### Snapshot real de benchmark (`npm run bench:ci`) no GitHub Codespaces
 
-- X25519: RFC 7748
-- Ed25519: RFC 8032
+Comando:
+
+```bash
+node --expose-gc bench.mjs --rounds=16 --roundMs=350 --warmupMs=500 --vectors=64 --variants=raw,cached --strict --verifyEvery=64 --jsonFile=results/bench-results.json
+```
+
+Ambiente:
+
+- Node: `v24.11.1`
+- OpenSSL: `3.5.4`
+- CPU: `AMD EPYC 7763 64-Core Processor`
+- Cores lógicos: `4`
+- Vetores: `64`
+
+### Tabela 1 - API moderna (`x25519` + `ed25519`)
+
+`sign`/`verify` abaixo comparam throughput de API, não equivalência criptográfica (Ed25519 vs axlsign legado).
+
+| Operação                       | Moderno raw | Legado raw (`curve25519-js`) | Speedup raw | Moderno cached | Legado cached (`curve25519-js`) | Speedup cached |
+| ------------------------------ | ----------: | ---------------------------: | ----------: | -------------: | ------------------------------: | -------------: |
+| `x25519.generateKeyPair`       |      14,378 |                        1,591 |       9.04x |         41,120 |                           1,478 |         27.83x |
+| `x25519.sharedKey`             |       9,970 |                        1,591 |       6.27x |         23,995 |                           1,554 |         15.44x |
+| `ed25519.sign (msg32)`         |      11,273 |                          143 |      78.95x |         23,696 |                             133 |        178.10x |
+| `ed25519.sign (msg1024)`       |      10,800 |                          138 |      78.07x |         22,502 |                             147 |        152.92x |
+| `ed25519.verify (msg32)`       |       7,280 |                          136 |      53.36x |          8,271 |                             155 |         53.37x |
+| `ed25519.verify (msg1024)`     |       7,160 |                          132 |      54.33x |          8,159 |                             154 |         52.90x |
+| `ed25519.signMessage (msg256)` |      10,624 |                          131 |      81.09x |         23,304 |                             148 |        156.97x |
+| `ed25519.openMessage (msg256)` |       6,574 |                          124 |      52.93x |          8,129 |                             154 |         52.64x |
+
+### Tabela 2 - Compatibilidade `axlsign` (equivalente ao `curve25519-js`)
+
+Aqui a comparação é de mesmo esquema criptográfico (equivalência + throughput).
+
+| Operação                                  | Moderno raw | Legado raw (`curve25519-js`) | Speedup raw | Moderno cached | Legado cached (`curve25519-js`) | Speedup cached |
+| ----------------------------------------- | ----------: | ---------------------------: | ----------: | -------------: | ------------------------------: | -------------: |
+| `axlsign.generateKeyPair`                 |       8,429 |                        1,583 |       5.33x |          8,384 |                           1,585 |          5.29x |
+| `axlsign.sharedKey`                       |       8,452 |                        1,583 |       5.34x |          8,396 |                           1,570 |          5.35x |
+| `axlsign.sign (msg32)`                    |       3,973 |                          144 |      27.61x |          3,952 |                             140 |         28.28x |
+| `axlsign.sign (msg32,opt_random)`         |       3,969 |                          147 |      27.03x |          3,984 |                             139 |         28.58x |
+| `axlsign.sign (msg1024)`                  |       3,881 |                          143 |      27.16x |          3,864 |                             139 |         27.72x |
+| `axlsign.verify (msg32)`                  |       6,527 |                          146 |      44.70x |          6,534 |                             143 |         45.72x |
+| `axlsign.verify (msg32,opt_random)`       |       6,506 |                          144 |      45.07x |          6,469 |                             141 |         45.80x |
+| `axlsign.verify (msg1024)`                |       6,361 |                          141 |      45.03x |          6,337 |                             135 |         46.92x |
+| `axlsign.signMessage (msg256)`            |       3,902 |                          140 |      27.79x |          3,935 |                             141 |         27.98x |
+| `axlsign.signMessage (msg256,opt_random)` |       3,885 |                          142 |      27.40x |          3,864 |                             145 |         26.60x |
+| `axlsign.openMessage (msg256)`            |       6,441 |                          138 |      46.57x |          6,300 |                             131 |         47.93x |
+| `axlsign.openMessage (msg256,opt_random)` |       6,362 |                          141 |      45.24x |          6,285 |                             130 |         48.22x |
+
+Notas:
+
+- `raw` inclui custo fim-a-fim da API.
+- `cached` reduz overhead de setup para evidenciar melhor o throughput criptográfico.
+- Fonte dos números: saída JSON de `bench:ci` (`results/bench-results.json`).
 
 ---
 
-## License
+## Build do namespace `axlsign`
+
+No pacote publicado no npm, os artefatos WASM já vêm prontos em `dist/`.
+
+Para buildar a partir do código-fonte, você precisa:
+
+- Rust toolchain
+- `wasm-pack` instalado
 
-MIT © unknownncat — veja [LICENSE](./LICENSE)
+Com isso, `npm run build` executa:
+
+1. `wasm-pack build` (`wasm/axlsign`)
+2. `tsc` ESM + CJS
+3. cópia dos artefatos WASM para `dist/internal/axlsign-wasm`
 
 ---
 
-## Thanks
+## Licença
+
+MIT
+
+---
 
-❤️ [curve25519-js](https://github.com/harveyconnor/curve25519-js)
+## Créditos
+
+- [curve25519-js](https://github.com/harveyconnor/curve25519-js) (Harvey Connor, Dmitry Chestnykh)
+- [TweetNaCl.js](https://tweetnacl.js.org/)
+- Trevor Perrin, ideia de assinaturas Curve25519: <https://moderncrypto.org/mail-archive/curves/2014/000205.html>
+- [Documentação Node.js `crypto`](https://nodejs.org/api/crypto.html)
+- [OpenSSL](https://www.openssl.org/)
+- [RFC 7748](https://www.rfc-editor.org/rfc/rfc7748)
+- [RFC 8032](https://www.rfc-editor.org/rfc/rfc8032)
+- [RFC 8410](https://www.rfc-editor.org/rfc/rfc8410)
+- [RFC 5958](https://www.rfc-editor.org/rfc/rfc5958)
+- [RFC 5280](https://www.rfc-editor.org/rfc/rfc5280)

package/dist/axlsign.d.ts

@@ -0,0 +1,31 @@
+import type { Bytes32, Bytes64, KeyPair32 } from "./types.js";
+/**
+ * Derives an axlsign-compatible public key (Montgomery/X25519 format).
+ */
+export declare function publicKey(secretKey32: Bytes32): Bytes32;
+/**
+ * Computes an axlsign-compatible X25519 shared key.
+ */
+export declare function sharedKey(secretKey32: Bytes32, publicKey32: Bytes32): Bytes32;
+/**
+ * Generates an axlsign-compatible key pair from a 32-byte seed.
+ */
+export declare function generateKeyPair(seed32: Bytes32): KeyPair32;
+/**
+ * Detached axlsign signature using X25519-format secret key.
+ * opt_random (64 bytes) enables randomized signing as in curve25519-js.
+ */
+export declare function sign(secretKey32: Bytes32, msg: Uint8Array, opt_random?: Uint8Array): Bytes64;
+/**
+ * Verifies detached axlsign signature.
+ */
+export declare function verify(publicKey32: Bytes32, msg: Uint8Array, signature64: Bytes64): boolean;
+/**
+ * Returns signature || message (axlsign mode).
+ */
+export declare function signMessage(secretKey32: Bytes32, msg: Uint8Array, opt_random?: Uint8Array): Uint8Array;
+/**
+ * Verifies signature || message and returns original message on success.
+ */
+export declare function openMessage(publicKey32: Bytes32, signedMsg: Uint8Array): Uint8Array | null;
+//# sourceMappingURL=axlsign.d.ts.map

package/dist/axlsign.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"axlsign.d.ts","sourceRoot":"","sources":["../src/axlsign.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAiB9D;;GAEG;AACH,wBAAgB,SAAS,CAAC,WAAW,EAAE,OAAO,GAAG,OAAO,CAIvD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,GAAG,OAAO,CAK7E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,CAQ1D;AAED;;;GAGG;AACH,wBAAgB,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,UAAU,CAAC,EAAE,UAAU,GAAG,OAAO,CAU5F;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,WAAW,EAAE,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO,GAAG,OAAO,CAK3F;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,UAAU,CAAC,EAAE,UAAU,GAAG,UAAU,CAUtG;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,GAAG,UAAU,GAAG,IAAI,CAe1F"}

package/dist/axlsign.js

@@ -0,0 +1,96 @@
+import { asBytes32, asBytes64, assertBytes32, assertBytes64, assertUint8Array } from "./internal/assert.js";
+import * as wasmAxl from "./internal/axlsign-wasm/axlsign_wasm.js";
+function clampScalar(seed32) {
+    const out = new Uint8Array(32);
+    out.set(seed32);
+    out[0] = (out[0] ?? 0) & 248;
+    const last = out[31] ?? 0;
+    out[31] = (last & 127) | 64;
+    return asBytes32(out, "clamped scalar");
+}
+function assertOptionalRandom64(value, fnName) {
+    if (value === undefined)
+        return;
+    assertBytes64(value, `${fnName} opt_random`);
+}
+/**
+ * Derives an axlsign-compatible public key (Montgomery/X25519 format).
+ */
+export function publicKey(secretKey32) {
+    assertBytes32(secretKey32, "secretKey32");
+    const out = wasmAxl.axlsignPublicKey(secretKey32);
+    return asBytes32(out, "axlsign public key");
+}
+/**
+ * Computes an axlsign-compatible X25519 shared key.
+ */
+export function sharedKey(secretKey32, publicKey32) {
+    assertBytes32(secretKey32, "secretKey32");
+    assertBytes32(publicKey32, "publicKey32");
+    const out = wasmAxl.axlsignSharedKey(secretKey32, publicKey32);
+    return asBytes32(out, "axlsign shared key");
+}
+/**
+ * Generates an axlsign-compatible key pair from a 32-byte seed.
+ */
+export function generateKeyPair(seed32) {
+    assertBytes32(seed32, "seed32");
+    const privateKey = clampScalar(seed32);
+    const publicKey32 = publicKey(privateKey);
+    return {
+        public: publicKey32,
+        private: privateKey,
+    };
+}
+/**
+ * Detached axlsign signature using X25519-format secret key.
+ * opt_random (64 bytes) enables randomized signing as in curve25519-js.
+ */
+export function sign(secretKey32, msg, opt_random) {
+    assertBytes32(secretKey32, "secretKey32");
+    assertUint8Array(msg, "msg");
+    assertOptionalRandom64(opt_random, "sign");
+    const signature = opt_random === undefined
+        ? wasmAxl.axlsignSign(secretKey32, msg)
+        : wasmAxl.axlsignSignRnd(secretKey32, msg, opt_random);
+    return asBytes64(signature, "axlsign signature");
+}
+/**
+ * Verifies detached axlsign signature.
+ */
+export function verify(publicKey32, msg, signature64) {
+    assertBytes32(publicKey32, "publicKey32");
+    assertUint8Array(msg, "msg");
+    assertBytes64(signature64, "signature64");
+    return wasmAxl.axlsignVerify(publicKey32, msg, signature64);
+}
+/**
+ * Returns signature || message (axlsign mode).
+ */
+export function signMessage(secretKey32, msg, opt_random) {
+    assertBytes32(secretKey32, "secretKey32");
+    assertUint8Array(msg, "msg");
+    assertOptionalRandom64(opt_random, "signMessage");
+    const signature = sign(secretKey32, msg, opt_random);
+    const out = new Uint8Array(64 + msg.byteLength);
+    out.set(signature, 0);
+    out.set(msg, 64);
+    return out;
+}
+/**
+ * Verifies signature || message and returns original message on success.
+ */
+export function openMessage(publicKey32, signedMsg) {
+    assertBytes32(publicKey32, "publicKey32");
+    assertUint8Array(signedMsg, "signedMsg");
+    if (signedMsg.byteLength < 64) {
+        return null;
+    }
+    const signature64 = asBytes64(signedMsg.subarray(0, 64), "signedMsg signature");
+    const msg = signedMsg.subarray(64);
+    if (!verify(publicKey32, msg, signature64)) {
+        return null;
+    }
+    return new Uint8Array(msg);
+}
+//# sourceMappingURL=axlsign.js.map

package/dist/axlsign.js.map

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