bitchat-node 0.1.0

package/dist/index.js

@@ -0,0 +1,48 @@
+/**
+ * bitchat-node
+ * Node.js implementation of the Bitchat BLE mesh protocol
+ *
+ * Compatible with Jack Dorsey's Bitchat app.
+ * @see https://github.com/permissionlesstech/bitchat
+ *
+ * @example
+ * ```typescript
+ * import { BitchatClient } from 'bitchat-node';
+ *
+ * const client = new BitchatClient({ nickname: 'my-node' });
+ *
+ * client.on('message', (message) => {
+ *   console.log(`${message.senderNickname}: ${message.content}`);
+ * });
+ *
+ * client.on('peer:connected', (peer) => {
+ *   console.log(`Connected to ${peer.nickname}`);
+ * });
+ *
+ * await client.start();
+ * await client.sendPublicMessage('Hello mesh!');
+ * ```
+ */
+// Main client
+export { BitchatClient } from './client.js';
+// Crypto
+export { 
+// Noise protocol
+CipherState, fingerprint, formatFingerprint, generateKeyPair, 
+// Signing
+generateSigningKeyPair, HandshakeState as NoiseHandshakeState, NoiseSession, sha256, sign, verify, } from './crypto/index.js';
+// Mesh
+export { MeshRouter, MessageDeduplicator, } from './mesh/index.js';
+// Protocol
+export { CHARACTERISTIC_UUID, DEFAULT_TTL, decode, 
+// Binary encoding
+encode, encodeForSigning, HandshakeState, MAX_MESSAGE_LENGTH, MAX_TTL, 
+// Types
+MessageType, makeDeduplicationID, NoisePayloadType, PacketFlags, PeerID, 
+// Constants
+SERVICE_UUID, SERVICE_UUID_TESTNET, } from './protocol/index.js';
+// Sessions
+export { SessionManager, } from './session/index.js';
+// Transport
+export { BLELink, BLETransport, } from './transport/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,cAAc;AACd,OAAO,EAAE,aAAa,EAAsD,MAAM,aAAa,CAAC;AAChG,SAAS;AACT,OAAO;AACL,iBAAiB;AACjB,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,eAAe;AACf,UAAU;AACV,sBAAsB,EACtB,cAAc,IAAI,mBAAmB,EAGrC,YAAY,EAEZ,MAAM,EACN,IAAI,EACJ,MAAM,GACP,MAAM,mBAAmB,CAAC;AAC3B,OAAO;AACP,OAAO,EAGL,UAAU,EACV,mBAAmB,GAEpB,MAAM,iBAAiB,CAAC;AACzB,WAAW;AACX,OAAO,EAEL,mBAAmB,EAEnB,WAAW,EAEX,MAAM;AACN,kBAAkB;AAClB,MAAM,EACN,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,OAAO;AACP,QAAQ;AACR,WAAW,EACX,mBAAmB,EACnB,gBAAgB,EAChB,WAAW,EACX,MAAM;AAGN,YAAY;AACZ,YAAY,EACZ,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAE7B,WAAW;AACX,OAAO,EACL,cAAc,GAGf,MAAM,oBAAoB,CAAC;AAE5B,YAAY;AACZ,OAAO,EACL,OAAO,EACP,YAAY,GAGb,MAAM,sBAAsB,CAAC"}

package/dist/mesh/deduplicator.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Message Deduplicator
+ * Prevents processing the same message multiple times in the mesh
+ * Uses a simple bloom-filter-like approach with time-based expiry
+ */
+export interface DeduplicatorConfig {
+    maxSize: number;
+    maxAgeMs: number;
+}
+/**
+ * Efficient message deduplication for mesh networks
+ */
+export declare class MessageDeduplicator {
+    private seen;
+    private readonly config;
+    private cleanupTimer?;
+    constructor(config?: Partial<DeduplicatorConfig>);
+    /**
+     * Check if message was seen and mark it as seen
+     * Returns true if this is a NEW message (not seen before)
+     */
+    markSeen(id: string): boolean;
+    /**
+     * Check if message was seen (without marking)
+     */
+    hasSeen(id: string): boolean;
+    /**
+     * Remove expired entries
+     */
+    private cleanup;
+    /**
+     * Trim oldest entries when size limit exceeded
+     */
+    private trimOldest;
+    /**
+     * Clear all entries
+     */
+    reset(): void;
+    /**
+     * Stop cleanup timer
+     */
+    destroy(): void;
+    /**
+     * Get current size
+     */
+    get size(): number;
+}
+//# sourceMappingURL=deduplicator.d.ts.map

package/dist/mesh/deduplicator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deduplicator.d.ts","sourceRoot":"","sources":["../../src/mesh/deduplicator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAOD;;GAEG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,IAAI,CAA6B;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,YAAY,CAAC,CAAiC;gBAE1C,MAAM,GAAE,OAAO,CAAC,kBAAkB,CAAM;IAOpD;;;OAGG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IA0B7B;;OAEG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAa5B;;OAEG;IACH,OAAO,CAAC,OAAO;IAWf;;OAEG;IACH,OAAO,CAAC,UAAU;IAUlB;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,OAAO,IAAI,IAAI;IAQf;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/mesh/deduplicator.js

@@ -0,0 +1,107 @@
+/**
+ * Message Deduplicator
+ * Prevents processing the same message multiple times in the mesh
+ * Uses a simple bloom-filter-like approach with time-based expiry
+ */
+const DEFAULT_CONFIG = {
+    maxSize: 10000,
+    maxAgeMs: 5 * 60 * 1000, // 5 minutes
+};
+/**
+ * Efficient message deduplication for mesh networks
+ */
+export class MessageDeduplicator {
+    seen = new Map();
+    config;
+    cleanupTimer;
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        // Periodic cleanup
+        this.cleanupTimer = setInterval(() => this.cleanup(), 60000);
+    }
+    /**
+     * Check if message was seen and mark it as seen
+     * Returns true if this is a NEW message (not seen before)
+     */
+    markSeen(id) {
+        const now = Date.now();
+        // Check if already seen
+        const existingTimestamp = this.seen.get(id);
+        if (existingTimestamp !== undefined) {
+            // Already seen - check if expired
+            if (now - existingTimestamp > this.config.maxAgeMs) {
+                // Expired, treat as new
+                this.seen.set(id, now);
+                return true;
+            }
+            return false;
+        }
+        // New message - add to seen set
+        this.seen.set(id, now);
+        // Trim if too large
+        if (this.seen.size > this.config.maxSize) {
+            this.trimOldest();
+        }
+        return true;
+    }
+    /**
+     * Check if message was seen (without marking)
+     */
+    hasSeen(id) {
+        const timestamp = this.seen.get(id);
+        if (timestamp === undefined)
+            return false;
+        // Check expiry
+        if (Date.now() - timestamp > this.config.maxAgeMs) {
+            this.seen.delete(id);
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Remove expired entries
+     */
+    cleanup() {
+        const now = Date.now();
+        const maxAge = this.config.maxAgeMs;
+        for (const [id, timestamp] of this.seen) {
+            if (now - timestamp > maxAge) {
+                this.seen.delete(id);
+            }
+        }
+    }
+    /**
+     * Trim oldest entries when size limit exceeded
+     */
+    trimOldest() {
+        // Convert to array, sort by timestamp, keep newest half
+        const entries = Array.from(this.seen.entries()).sort((a, b) => a[1] - b[1]);
+        const toRemove = Math.floor(entries.length / 2);
+        for (let i = 0; i < toRemove; i++) {
+            this.seen.delete(entries[i][0]);
+        }
+    }
+    /**
+     * Clear all entries
+     */
+    reset() {
+        this.seen.clear();
+    }
+    /**
+     * Stop cleanup timer
+     */
+    destroy() {
+        if (this.cleanupTimer) {
+            clearInterval(this.cleanupTimer);
+            this.cleanupTimer = undefined;
+        }
+        this.seen.clear();
+    }
+    /**
+     * Get current size
+     */
+    get size() {
+        return this.seen.size;
+    }
+}
+//# sourceMappingURL=deduplicator.js.map

package/dist/mesh/deduplicator.js.map

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

package/dist/mesh/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Mesh module exports
+ */
+export { type DeduplicatorConfig, MessageDeduplicator } from './deduplicator.js';
+export { type Link, MeshRouter, type RouterConfig, type RouterEvents } from './router.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mesh/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACjF,OAAO,EAAE,KAAK,IAAI,EAAE,UAAU,EAAE,KAAK,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/mesh/index.js

@@ -0,0 +1,6 @@
+/**
+ * Mesh module exports
+ */
+export { MessageDeduplicator } from './deduplicator.js';
+export { MeshRouter } from './router.js';
+//# sourceMappingURL=index.js.map

package/dist/mesh/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mesh/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAA2B,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACjF,OAAO,EAAa,UAAU,EAAwC,MAAM,aAAa,CAAC"}

package/dist/mesh/router.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Mesh Router
+ * Handles TTL-based message flooding and routing decisions
+ */
+import { EventEmitter } from 'node:events';
+import { type BitchatPacket, type PeerID } from '../protocol/types.js';
+export interface RouterConfig {
+    maxTTL: number;
+    defaultTTL: number;
+    probabilisticRelay: boolean;
+    relayProbability: number;
+}
+export interface Link {
+    id: string;
+    send(data: Uint8Array): Promise<void>;
+    peerID?: PeerID;
+}
+export interface RouterEvents {
+    packet: (packet: BitchatPacket, fromLink: Link | null) => void;
+    forward: (packet: BitchatPacket, toLinks: Link[]) => void;
+    drop: (packet: BitchatPacket, reason: string) => void;
+}
+/**
+ * Mesh message router with TTL-based flooding
+ */
+export declare class MeshRouter extends EventEmitter {
+    private readonly config;
+    private readonly deduplicator;
+    private readonly links;
+    private myPeerID;
+    private ingressLinks;
+    constructor(config?: Partial<RouterConfig>);
+    /**
+     * Set our own peer ID (to avoid processing our own messages)
+     */
+    setMyPeerID(peerID: PeerID): void;
+    /**
+     * Get our own peer ID
+     */
+    getMyPeerID(): PeerID | null;
+    /**
+     * Add a link (connection to another peer)
+     */
+    addLink(link: Link): void;
+    /**
+     * Remove a link
+     */
+    removeLink(linkId: string): void;
+    /**
+     * Get all active links
+     */
+    getLinks(): Link[];
+    /**
+     * Get peer IDs of all connected links
+     */
+    getConnectedPeerIDs(): PeerID[];
+    /**
+     * Handle an incoming packet
+     */
+    handlePacket(packet: BitchatPacket, fromLink: Link | null): Promise<boolean>;
+    /**
+     * Send a new packet (originated by us)
+     */
+    sendPacket(packet: BitchatPacket): Promise<void>;
+    /**
+     * Check if packet should be forwarded
+     */
+    private shouldForward;
+    /**
+     * Forward a packet (decrement TTL, send to other links)
+     */
+    private forward;
+    /**
+     * Broadcast to all links
+     */
+    private broadcast;
+    /**
+     * Send packet to specific links
+     */
+    private sendToLinks;
+    /**
+     * Send to a specific peer (if we have a direct link)
+     */
+    sendToPeer(packet: BitchatPacket, peerID: PeerID): Promise<boolean>;
+    /**
+     * Clean up
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=router.d.ts.map

package/dist/mesh/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/mesh/router.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,EAAE,KAAK,aAAa,EAAe,KAAK,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAGpF,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AASD,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,IAAI,GAAG,IAAI,KAAK,IAAI,CAAC;IAC/D,OAAO,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,IAAI,CAAC;IAC1D,IAAI,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACvD;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,YAAY;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAsB;IACnD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA2B;IACjD,OAAO,CAAC,QAAQ,CAAuB;IAGvC,OAAO,CAAC,YAAY,CAA6B;gBAErC,MAAM,GAAE,OAAO,CAAC,YAAY,CAAM;IAM9C;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIjC;;OAEG;IACH,WAAW,IAAI,MAAM,GAAG,IAAI;IAI5B;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAIzB;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAUhC;;OAEG;IACH,QAAQ,IAAI,IAAI,EAAE;IAIlB;;OAEG;IACH,mBAAmB,IAAI,MAAM,EAAE;IAM/B;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,IAAI,GAAG,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC;IA+BlF;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAUtD;;OAEG;IACH,OAAO,CAAC,aAAa;IAuBrB;;OAEG;YACW,OAAO;IAqBrB;;OAEG;YACW,SAAS;IAKvB;;OAEG;YACW,WAAW;IAgBzB;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAgBzE;;OAEG;IACH,OAAO,IAAI,IAAI;CAMhB"}

package/dist/mesh/router.js

@@ -0,0 +1,204 @@
+/**
+ * Mesh Router
+ * Handles TTL-based message flooding and routing decisions
+ */
+import { EventEmitter } from 'node:events';
+import { makeDeduplicationID } from '../protocol/binary.js';
+import { DEFAULT_TTL, MAX_TTL } from '../protocol/constants.js';
+import { MessageType } from '../protocol/types.js';
+import { MessageDeduplicator } from './deduplicator.js';
+const DEFAULT_ROUTER_CONFIG = {
+    maxTTL: MAX_TTL,
+    defaultTTL: DEFAULT_TTL,
+    probabilisticRelay: false,
+    relayProbability: 0.8,
+};
+/**
+ * Mesh message router with TTL-based flooding
+ */
+export class MeshRouter extends EventEmitter {
+    config;
+    deduplicator;
+    links = new Map();
+    myPeerID = null;
+    // Track ingress link for each message to avoid echo
+    ingressLinks = new Map();
+    constructor(config = {}) {
+        super();
+        this.config = { ...DEFAULT_ROUTER_CONFIG, ...config };
+        this.deduplicator = new MessageDeduplicator();
+    }
+    /**
+     * Set our own peer ID (to avoid processing our own messages)
+     */
+    setMyPeerID(peerID) {
+        this.myPeerID = peerID;
+    }
+    /**
+     * Get our own peer ID
+     */
+    getMyPeerID() {
+        return this.myPeerID;
+    }
+    /**
+     * Add a link (connection to another peer)
+     */
+    addLink(link) {
+        this.links.set(link.id, link);
+    }
+    /**
+     * Remove a link
+     */
+    removeLink(linkId) {
+        this.links.delete(linkId);
+        // Clean up any ingress tracking
+        for (const [msgId, ingressLinkId] of this.ingressLinks) {
+            if (ingressLinkId === linkId) {
+                this.ingressLinks.delete(msgId);
+            }
+        }
+    }
+    /**
+     * Get all active links
+     */
+    getLinks() {
+        return Array.from(this.links.values());
+    }
+    /**
+     * Get peer IDs of all connected links
+     */
+    getConnectedPeerIDs() {
+        return Array.from(this.links.values())
+            .filter((link) => link.peerID !== undefined)
+            .map((link) => link.peerID);
+    }
+    /**
+     * Handle an incoming packet
+     */
+    async handlePacket(packet, fromLink) {
+        const dedupID = makeDeduplicationID(packet);
+        // Check deduplication
+        if (!this.deduplicator.markSeen(dedupID)) {
+            this.emit('drop', packet, 'duplicate');
+            return false;
+        }
+        // Track ingress link
+        if (fromLink) {
+            this.ingressLinks.set(dedupID, fromLink.id);
+        }
+        // Validate TTL
+        if (packet.ttl > this.config.maxTTL) {
+            this.emit('drop', packet, 'ttl_exceeded');
+            return false;
+        }
+        // Emit packet for processing
+        this.emit('packet', packet, fromLink);
+        // Decide whether to forward
+        if (this.shouldForward(packet)) {
+            await this.forward(packet, fromLink?.id);
+        }
+        return true;
+    }
+    /**
+     * Send a new packet (originated by us)
+     */
+    async sendPacket(packet) {
+        const dedupID = makeDeduplicationID(packet);
+        // Mark as seen to avoid processing our own relayed copy
+        this.deduplicator.markSeen(dedupID);
+        // Broadcast to all links
+        await this.broadcast(packet);
+    }
+    /**
+     * Check if packet should be forwarded
+     */
+    shouldForward(packet) {
+        // Don't forward if TTL exhausted
+        if (packet.ttl <= 0)
+            return false;
+        // Don't forward certain message types
+        switch (packet.type) {
+            case MessageType.REQUEST_SYNC:
+                // Sync requests are local-only
+                return false;
+            default:
+                break;
+        }
+        // Probabilistic relay under high load
+        if (this.config.probabilisticRelay) {
+            if (Math.random() > this.config.relayProbability) {
+                return false;
+            }
+        }
+        return true;
+    }
+    /**
+     * Forward a packet (decrement TTL, send to other links)
+     */
+    async forward(packet, excludeLinkId) {
+        // Decrement TTL
+        const forwardPacket = {
+            ...packet,
+            ttl: packet.ttl - 1,
+        };
+        // Get links to forward to (excluding ingress)
+        const dedupID = makeDeduplicationID(packet);
+        const ingressLinkId = excludeLinkId ?? this.ingressLinks.get(dedupID);
+        const targetLinks = Array.from(this.links.values()).filter((link) => link.id !== ingressLinkId);
+        if (targetLinks.length === 0)
+            return;
+        this.emit('forward', forwardPacket, targetLinks);
+        // Send to all target links
+        await this.sendToLinks(forwardPacket, targetLinks);
+    }
+    /**
+     * Broadcast to all links
+     */
+    async broadcast(packet) {
+        const targetLinks = Array.from(this.links.values());
+        await this.sendToLinks(packet, targetLinks);
+    }
+    /**
+     * Send packet to specific links
+     */
+    async sendToLinks(packet, links) {
+        const { encode } = await import('../protocol/binary.js');
+        const data = encode(packet);
+        const sendPromises = links.map(async (link) => {
+            try {
+                await link.send(data);
+            }
+            catch (error) {
+                // Log error but don't fail the whole broadcast
+                console.error(`Failed to send to link ${link.id}:`, error);
+            }
+        });
+        await Promise.allSettled(sendPromises);
+    }
+    /**
+     * Send to a specific peer (if we have a direct link)
+     */
+    async sendToPeer(packet, peerID) {
+        // Find link for this peer
+        const link = Array.from(this.links.values()).find((l) => l.peerID?.equals(peerID));
+        if (!link) {
+            // No direct link - broadcast and hope for relay
+            await this.sendPacket(packet);
+            return false;
+        }
+        const { encode } = await import('../protocol/binary.js');
+        const data = encode(packet);
+        await link.send(data);
+        return true;
+    }
+    /**
+     * Clean up
+     */
+    destroy() {
+        this.deduplicator.destroy();
+        this.links.clear();
+        this.ingressLinks.clear();
+        this.removeAllListeners();
+    }
+}
+//# sourceMappingURL=router.js.map

package/dist/mesh/router.js.map

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

package/dist/protocol/binary.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Binary Protocol Encoder/Decoder
+ * From: bitchat/Protocols/BinaryProtocol.swift
+ *
+ * Wire format:
+ * Header (14 bytes for v1, 16 bytes for v2):
+ * +--------+------+-----+-----------+-------+------------------+
+ * |Version | Type | TTL | Timestamp | Flags | PayloadLength    |
+ * |1 byte  |1 byte|1byte| 8 bytes   | 1 byte| 2 or 4 bytes     |
+ * +--------+------+-----+-----------+-------+------------------+
+ *
+ * Variable sections:
+ * +----------+-------------+---------+------------+
+ * | SenderID | RecipientID | Payload | Signature  |
+ * | 8 bytes  | 8 bytes*    | Variable| 64 bytes*  |
+ * +----------+-------------+---------+------------+
+ */
+import { type BitchatPacket } from './types.js';
+/**
+ * Encode a BitchatPacket to binary wire format
+ */
+export declare function encode(packet: BitchatPacket, options?: {
+    padding?: boolean;
+}): Uint8Array;
+/**
+ * Decode binary wire format to BitchatPacket
+ */
+export declare function decode(data: Uint8Array): BitchatPacket | null;
+/**
+ * Create binary representation for signing (without signature, TTL=0)
+ */
+export declare function encodeForSigning(packet: BitchatPacket): Uint8Array;
+/**
+ * Create message deduplication ID
+ */
+export declare function makeDeduplicationID(packet: BitchatPacket): string;
+//# sourceMappingURL=binary.d.ts.map

package/dist/protocol/binary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binary.d.ts","sourceRoot":"","sources":["../../src/protocol/binary.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAWH,OAAO,EAAE,KAAK,aAAa,EAAyC,MAAM,YAAY,CAAC;AA0CvF;;GAEG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,UAAU,CAyG7F;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,aAAa,GAAG,IAAI,CAY7D;AAmID;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,GAAG,UAAU,CASlE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAEjE"}