@multitapio/multitap 0.0.1

package/dist/crypto.d.ts

@@ -0,0 +1,141 @@
+import type { InputData } from './messages';
+export declare const SIGNATURE_SIZE = 65;
+export declare const COMPRESSED_PUBKEY_SIZE = 33;
+export declare const COMPRESSED_PUB_KEY_SIZE = 33;
+export declare const PRIVATE_KEY_SIZE = 32;
+export declare const HASH_SIZE = 32;
+export declare const INPUT_HEADER_SIZE = 5;
+export declare const GENESIS_HASH_SIZE = 16;
+/**
+ * Generate a new secp256k1 private key.
+ * @returns 32-byte private key
+ */
+export declare function generateKeyPair(): Uint8Array;
+/**
+ * Derive the compressed public key from a private key.
+ * @param privateKey 32-byte private key
+ * @returns 33-byte compressed public key
+ */
+export declare function pubKeyFromPrivate(privateKey: Uint8Array): Uint8Array;
+/**
+ * Sign a 32-byte message hash with a private key.
+ * Returns a 65-byte recoverable signature in format [r:32][s:32][v:1].
+ * @param privateKey 32-byte private key
+ * @param messageHash 32-byte message hash
+ * @returns 65-byte signature
+ */
+export declare function sign(privateKey: Uint8Array, messageHash: Uint8Array): Uint8Array;
+/**
+ * Recover the compressed public key from a message hash and signature.
+ * @param messageHash 32-byte message hash
+ * @param signature 65-byte signature in format [r:32][s:32][v:1]
+ * @returns 33-byte compressed public key
+ */
+export declare function recoverPubKey(messageHash: Uint8Array, signature: Uint8Array): Uint8Array;
+/**
+ * Verify that a signature was created by the owner of the given public key.
+ * @param pubKey 33-byte compressed public key
+ * @param messageHash 32-byte message hash
+ * @param signature 65-byte signature
+ * @returns true if valid
+ */
+export declare function verifySignature(pubKey: Uint8Array, messageHash: Uint8Array, signature: Uint8Array): boolean;
+/**
+ * Compute SHA-256 hash of arbitrary data.
+ * @param data Data to hash
+ * @returns 32-byte hash
+ */
+export declare function hashMessage(data: Uint8Array): Uint8Array;
+/**
+ * Compute a short truncated SHA256 hash used to shard sessions based on simulation/schema/input compatibility.
+ * Returns the first 8 bytes of SHA256(data).
+ * @param data Data to hash
+ * @returns 8-byte truncated hash
+ */
+export declare function sessionCompatibilityHash(data: Uint8Array): Uint8Array;
+/**
+ * Compute a truncated SHA256 hash of a JavaScript object using deterministic CBOR encoding.
+ * This ensures cross-platform compatibility - the same object will produce the same hash
+ * in both Go and JavaScript implementations.
+ *
+ * CBOR encoding rules (RFC 8949 §4.2 Core Deterministic Encoding):
+ * - Map keys sorted by byte string length, then lexicographically
+ * - Smallest possible integer encodings
+ * - No indefinite-length encodings
+ *
+ * @param obj JavaScript object to hash (must be CBOR-serializable)
+ * @returns 8-byte truncated hash
+ */
+export declare function hashContent(obj: unknown): Uint8Array;
+/**
+ * Compute the hash for signing an input message.
+ * Format: SHA256(genesisHash || targetTick || payload)
+ * @param genesisHash 16-byte genesis hash (from SessionConfig.toGenesisHash())
+ * @param targetTick Target tick number (uint32)
+ * @param payload Variable-length input payload (0-255 bytes)
+ * @returns 32-byte hash
+ */
+export declare function hashInputMessage(genesisHash: Uint8Array, targetTick: number, payload: Uint8Array): Uint8Array;
+/**
+ * Compute the hash for signing a tick message.
+ * Format: SHA256(genesisHash || tickNum || inputsHash || prevTickSig)
+ * @param genesisHash 16-byte genesis hash (from SessionConfig.toGenesisHash())
+ * @param tickNum Tick number (uint32)
+ * @param inputsHash 32-byte hash of concatenated inputs
+ * @param prevTickSig 65-byte previous tick's signature
+ * @returns 32-byte hash
+ */
+export declare function hashTickMessage(genesisHash: Uint8Array, tickNum: number, inputsHash: Uint8Array, prevTickSig: Uint8Array): Uint8Array;
+/**
+ * Compute a hash over all inputs in a tick.
+ * Format: SHA256(input1 || input2 || ... || inputN)
+ * where each input is: [targetTick:4][payloadLen:1][payload:0-255][signature:65]
+ * Returns zero hash if there are no inputs.
+ * @param inputs Array of input messages
+ * @returns 32-byte hash
+ */
+export declare function hashInputs(inputs: InputData[]): Uint8Array;
+/**
+ * Compute a hash over ordered payloads for stateId computation.
+ * Format: SHA256(payload1 || payload2 || ... || payloadN)
+ * Returns zero hash if there are no payloads.
+ *
+ * NOTE: This is distinct from hashInputs() which hashes full input messages
+ * (including signatures) for the tick signature chain. hashPayloads() hashes
+ * only the raw payloads in participant order, for state identity caching.
+ *
+ * @param payloads Array of payload bytes, ordered by participant index
+ * @returns 32-byte hash
+ */
+export declare function hashPayloads(payloads: Uint8Array[]): Uint8Array;
+/**
+ * Compute the hash for connection authentication.
+ * Format: SHA256("multitap:session:" || genesisHash || ":" || timestamp)
+ * @param genesisHash 16-byte genesis hash (from SessionConfig.toGenesisHash())
+ * @param timestampMs Timestamp in milliseconds
+ * @returns 32-byte hash
+ */
+export declare function hashAuthMessage(genesisHash: Uint8Array, timestampMs: number): Uint8Array;
+/**
+ * Encode a 16-byte genesis hash to base64url (no padding).
+ * A genesis hash is the deterministic session identity from SessionConfig.toGenesisHash().
+ * @param bytes 16-byte genesis hash
+ * @returns base64url string (22 chars)
+ */
+export declare function genesisHashToString(bytes: Uint8Array): string;
+/**
+ * Decode a base64url (no padding) string to a 16-byte genesis hash.
+ * Throws if the string is invalid or decodes to all zeros.
+ * @param str base64url string (22 chars)
+ * @returns 16-byte genesis hash
+ */
+export declare function genesisHashFromString(str: string): Uint8Array;
+/**
+ * Convert signature to hex string for URL encoding.
+ */
+export declare function signatureToHex(signature: Uint8Array): string;
+/**
+ * Parse hex string to signature bytes.
+ */
+export declare function hexToSignature(hex: string): Uint8Array;
+//# sourceMappingURL=crypto.d.ts.map

package/dist/crypto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.d.ts","sourceRoot":"","sources":["../../src/crypto.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAO5C,eAAO,MAAM,cAAc,KAAK,CAAC;AACjC,eAAO,MAAM,sBAAsB,KAAK,CAAC;AACzC,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAC1C,eAAO,MAAM,gBAAgB,KAAK,CAAC;AACnC,eAAO,MAAM,SAAS,KAAK,CAAC;AAC5B,eAAO,MAAM,iBAAiB,IAAI,CAAC;AACnC,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC;;;GAGG;AACH,wBAAgB,eAAe,IAAI,UAAU,CAE5C;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,UAAU,GAAG,UAAU,CAEpE;AAED;;;;;;GAMG;AACH,wBAAgB,IAAI,CAAC,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,GAAG,UAAU,CAehF;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,GAAG,UAAU,CAkBxF;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,GAAG,OAAO,CAO3G;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,CAExD;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,CAGrE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,CAIpD;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,UAAU,CAc7G;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,WAAW,EAAE,UAAU,EACvB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,UAAU,EACtB,WAAW,EAAE,UAAU,GACtB,UAAU,CAiBZ;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,UAAU,CAkC1D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,UAAU,CAkC/D;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,GAAG,UAAU,CAkBxF;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAE7D;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAU7D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,UAAU,GAAG,MAAM,CAI5D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAMtD"}

package/dist/debug.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Debug logging utility for the multitap SDK.
+ *
+ * Wraps console.* methods with an enable/disable toggle.
+ * Disabled by default so library consumers don't see logs unless they opt-in.
+ *
+ * Usage:
+ *   import { debug } from './debug';
+ *   debug.warn('something happened');
+ *
+ * To enable logging (e.g., for debugging):
+ *   import { setDebugEnabled } from './debug';
+ *   setDebugEnabled(true);
+ */
+/** Enable or disable debug logging globally */
+export declare function setDebugEnabled(value: boolean): void;
+/** Check if debug logging is currently enabled */
+export declare function isDebugEnabled(): boolean;
+export declare const debug: {
+    log: (...args: unknown[]) => void;
+    warn: (...args: unknown[]) => void;
+    error: (...args: unknown[]) => void;
+    info: (...args: unknown[]) => void;
+    debug: (...args: unknown[]) => void;
+    /** Returns a group function; if disabled, returns noop */
+    group: (label?: string) => void;
+    groupEnd: () => void;
+    /** Table output for structured data */
+    table: (data: unknown) => void;
+    /** Get the underlying console method (for advanced use) */
+    readonly raw: Console | {
+        log: () => void;
+        warn: () => void;
+        error: () => void;
+        info: () => void;
+        debug: () => void;
+    };
+};
+//# sourceMappingURL=debug.d.ts.map

package/dist/debug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.d.ts","sourceRoot":"","sources":["../../src/debug.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,+CAA+C;AAC/C,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAEpD;AAED,kDAAkD;AAClD,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAID,eAAO,MAAM,KAAK;mBACD,OAAO,EAAE,KAAG,IAAI;oBAGf,OAAO,EAAE,KAAG,IAAI;qBAGf,OAAO,EAAE,KAAG,IAAI;oBAGjB,OAAO,EAAE,KAAG,IAAI;qBAGf,OAAO,EAAE,KAAG,IAAI;IAGjC,0DAA0D;oBAC1C,MAAM,KAAG,IAAI;oBAGf,IAAI;IAGlB,uCAAuC;kBACzB,OAAO,KAAG,IAAI;IAG5B,2DAA2D;;;;;;;;CAI5D,CAAC"}

package/dist/diagnostics/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Diagnostics client for e2e testing.
+ *
+ * Minimal browser client that:
+ * - Parses URL params (connectionURL, serverCertHash, relayPubKey)
+ * - Creates a Session with zero plugins (channel-only mode)
+ * - Generates random inputs on 50ms interval
+ * - Logs SYNC ticks to console for conformance testing
+ * - Exits when session duration elapses
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/diagnostics/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}