chunktech 0.1.0

package/README.md

@@ -0,0 +1,250 @@
+# ChunkTech
+
+On-chain file storage via chunked transactions for EVM chains.
+
+Store and retrieve files on Ethereum, Base, and Arbitrum using transaction calldata.
+
+## Features
+
+- **Chunk** - Split files into 33.3KB pieces for on-chain storage
+- **Send** - Broadcast chunks as transactions
+- **Track** - Monitor transaction confirmations
+- **Reassemble** - Reconstruct files from on-chain data
+- **Encrypt** - Optional X3DH encryption for private data
+
+## Installation
+
+```bash
+npm install chunktech viem
+```
+
+For encryption support:
+```bash
+npm install @noble/curves @noble/hashes
+```
+
+## Configuration
+
+Copy `.env.example` to `.env` and configure:
+
+```bash
+cp .env.example .env
+```
+
+```env
+# Private key for signing transactions (without 0x prefix)
+PRIVATE_KEY=your_private_key_here
+
+# RPC URLs (optional - uses public RPCs if not set)
+RPC_BASE=https://mainnet.base.org
+RPC_ARBITRUM=https://arb1.arbitrum.io/rpc
+RPC_ETHEREUM=https://eth.llamarpc.com
+
+# Default chain
+DEFAULT_CHAIN=base
+```
+
+## Quick Start
+
+```typescript
+import { ChunkTech } from 'chunktech';
+import { createWalletClient, http } from 'viem';
+import { base } from 'viem/chains';
+import { privateKeyToAccount } from 'viem/accounts';
+
+// Load from environment
+const account = privateKeyToAccount(`0x${process.env.PRIVATE_KEY}`);
+const walletClient = createWalletClient({
+  account,
+  chain: base,
+  transport: http(process.env.RPC_BASE),
+});
+
+// Initialize ChunkTech
+const ct = new ChunkTech({ walletClient });
+
+// Upload a file
+const file = new Uint8Array([...]); // Your file data
+const result = await ct.upload(file, {
+  onProgress: (sent, total) => console.log(`${sent}/${total} chunks sent`),
+});
+
+console.log('Chunk ID:', result.chunkId);
+console.log('TX Hashes:', result.txHashes);
+
+// Download the file
+const downloaded = await ct.download(result.txHashes);
+console.log('Retrieved:', downloaded.data);
+```
+
+## API
+
+### `new ChunkTech(config)`
+
+Create a new ChunkTech instance.
+
+```typescript
+interface ChunkTechConfig {
+  walletClient: WalletClient;    // viem WalletClient for signing
+  publicClient?: PublicClient;   // Optional, created from walletClient if not provided
+  chain?: Chain;                 // Optional, detected from walletClient
+  rpcUrl?: string;               // Optional custom RPC URL
+}
+```
+
+### `upload(data, options)`
+
+Upload data to the blockchain.
+
+```typescript
+const result = await ct.upload(data, {
+  encrypt: false,                // Enable encryption
+  keys: encryptionKeys,          // Required if encrypt: true
+  recipients: [...],             // Recipients for encrypted data
+  onProgress: (sent, total) => {}, // Progress callback
+  confirmations: 1,              // Wait for confirmations
+});
+
+// Returns:
+{
+  chunkId: string;       // Unique ID for this upload
+  txHashes: Hash[];      // Transaction hashes
+  totalChunks: number;   // Number of chunks sent
+  totalBytes: number;    // Original data size
+}
+```
+
+### `download(txHashes, options)`
+
+Download and reassemble data from the blockchain.
+
+```typescript
+const result = await ct.download(txHashes, {
+  keys: encryptionKeys,     // Required if data was encrypted
+  recipientId: 'myId',      // Required if data was encrypted
+});
+
+// Returns:
+{
+  data: Uint8Array;      // The reassembled file
+  chunkId: string;       // Chunk set ID
+  totalChunks: number;   // Number of chunks retrieved
+}
+```
+
+## Encryption
+
+ChunkTech supports optional X3DH encryption for private data.
+
+```typescript
+import { generateEncryptionKeys, deriveKeysFromSignature } from 'chunktech';
+
+// Generate new keys
+const myKeys = await generateEncryptionKeys();
+
+// Or derive from wallet signature (deterministic)
+const signature = await wallet.signMessage('chunktech-keys');
+const myKeys = await deriveKeysFromSignature(signature);
+
+// Upload encrypted data
+await ct.upload(data, {
+  encrypt: true,
+  keys: myKeys,
+  recipients: [
+    { id: 'alice', bundle: aliceBundle },
+    { id: 'bob', bundle: bobBundle },
+  ],
+});
+
+// Download encrypted data
+const result = await ct.download(txHashes, {
+  keys: myKeys,
+  recipientId: 'sender', // Use 'sender' if you're the uploader
+});
+```
+
+## Low-Level API
+
+For more control, use the individual modules:
+
+```typescript
+import {
+  // Chunking
+  chunkData,
+  encodeChunk,
+  decodeChunk,
+  reassembleChunks,
+  ChunkTracker,
+
+  // Sending
+  sendChunk,
+  sendChunks,
+
+  // Tracking
+  waitForTransactions,
+  TransactionMonitor,
+
+  // Fetching
+  fetchChunk,
+  assembleFromHashes,
+  StreamingAssembler,
+} from 'chunktech';
+```
+
+### Chunking
+
+```typescript
+// Split data into chunks
+const chunked = chunkData(myData);
+console.log(`${chunked.total} chunks, ID: ${chunked.id}`);
+
+// Encode for on-chain storage
+const calldata = encodeChunk(chunked.chunks[0]);
+
+// Decode from calldata
+const chunk = decodeChunk(calldata);
+```
+
+### Streaming Reassembly
+
+```typescript
+const tracker = new ChunkTracker();
+
+for (const txHash of incomingHashes) {
+  const result = await fetchChunk(publicClient, txHash);
+  if (result.chunk) {
+    const assembled = tracker.add(result.chunk);
+    if (assembled) {
+      console.log('Complete!', assembled);
+    }
+  }
+}
+
+// Check progress
+console.log(tracker.getIncomplete());
+// [{ id: '...', have: 2, need: 5 }]
+```
+
+## Supported Chains
+
+| Chain | Chain ID |
+|-------|----------|
+| Ethereum | 1 |
+| Base | 8453 |
+| Arbitrum | 42161 |
+| Sepolia | 11155111 |
+| Base Sepolia | 84532 |
+| Arbitrum Sepolia | 421614 |
+
+## Constants
+
+```typescript
+import { MAX_CHUNK_SIZE } from 'chunktech';
+
+// MAX_CHUNK_SIZE = 33333 (33.3KB)
+// This ensures wrapped chunks stay under 128KB tx limit
+```
+
+## License
+
+MIT

package/dist/assembler.d.ts

@@ -0,0 +1,58 @@
+/**
+ * ChunkTech - Assembler
+ * Fetch and reassemble chunks from on-chain transactions
+ */
+import type { PublicClient, Hash } from 'viem';
+import type { Chunk, DownloadOptions } from './types.js';
+export interface FetchResult {
+    chunk: Chunk | null;
+    hash: Hash;
+    encrypted: boolean;
+}
+/**
+ * Fetch calldata from a transaction
+ */
+export declare function fetchTransaction(publicClient: PublicClient, hash: Hash): Promise<string | null>;
+/**
+ * Fetch and decode a chunk from a transaction
+ */
+export declare function fetchChunk(publicClient: PublicClient, hash: Hash): Promise<FetchResult>;
+/**
+ * Fetch multiple chunks from transactions
+ */
+export declare function fetchChunks(publicClient: PublicClient, hashes: Hash[]): Promise<FetchResult[]>;
+/**
+ * Fetch chunks in parallel
+ */
+export declare function fetchChunksParallel(publicClient: PublicClient, hashes: Hash[]): Promise<FetchResult[]>;
+/**
+ * Fetch and reassemble data from transaction hashes
+ */
+export declare function assembleFromHashes(publicClient: PublicClient, hashes: Hash[], options?: DownloadOptions): Promise<Uint8Array | null>;
+export declare class StreamingAssembler {
+    private publicClient;
+    private tracker;
+    private options;
+    constructor(publicClient: PublicClient, options?: DownloadOptions);
+    /**
+     * Add a transaction hash and check for completion
+     */
+    addHash(hash: Hash): Promise<Uint8Array | null>;
+    /**
+     * Add multiple transaction hashes
+     */
+    addHashes(hashes: Hash[]): Promise<Uint8Array | null>;
+    /**
+     * Get incomplete chunk sets
+     */
+    getIncomplete(): Array<{
+        id: string;
+        have: number;
+        need: number;
+    }>;
+    /**
+     * Clear all tracked data
+     */
+    clear(): void;
+}
+//# sourceMappingURL=assembler.d.ts.map

package/dist/assembler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assembler.d.ts","sourceRoot":"","sources":["../src/assembler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC/C,OAAO,KAAK,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAQzD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,IAAI,EAAE,IAAI,CAAC;IACX,SAAS,EAAE,OAAO,CAAC;CACpB;AAMD;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,YAAY,EAAE,YAAY,EAC1B,IAAI,EAAE,IAAI,GACT,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAaxB;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,YAAY,EAAE,YAAY,EAC1B,IAAI,EAAE,IAAI,GACT,OAAO,CAAC,WAAW,CAAC,CAWtB;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,YAAY,EAAE,YAAY,EAC1B,MAAM,EAAE,IAAI,EAAE,GACb,OAAO,CAAC,WAAW,EAAE,CAAC,CASxB;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,YAAY,EAAE,YAAY,EAC1B,MAAM,EAAE,IAAI,EAAE,GACb,OAAO,CAAC,WAAW,EAAE,CAAC,CAExB;AAMD;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,YAAY,EAAE,YAAY,EAC1B,MAAM,EAAE,IAAI,EAAE,EACd,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAkC5B;AAMD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,OAAO,CAAkB;gBAErB,YAAY,EAAE,YAAY,EAAE,OAAO,GAAE,eAAoB;IAKrE;;OAEG;IACG,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAsBrD;;OAEG;IACG,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAU3D;;OAEG;IACH,aAAa,IAAI,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAIlE;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd"}

package/dist/assembler.js

@@ -0,0 +1,158 @@
+/**
+ * ChunkTech - Assembler
+ * Fetch and reassemble chunks from on-chain transactions
+ */
+import { decodeChunk, reassembleChunks, isEncryptedChunk, ChunkTracker } from './chunker.js';
+import { decryptForRecipient } from './crypto.js';
+// ============================================================================
+// Fetching
+// ============================================================================
+/**
+ * Fetch calldata from a transaction
+ */
+export async function fetchTransaction(publicClient, hash) {
+    try {
+        const tx = await publicClient.getTransaction({ hash });
+        if (!tx || !tx.input) {
+            return null;
+        }
+        // Convert hex to string
+        return hexToString(tx.input);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Fetch and decode a chunk from a transaction
+ */
+export async function fetchChunk(publicClient, hash) {
+    const calldata = await fetchTransaction(publicClient, hash);
+    if (!calldata) {
+        return { chunk: null, hash, encrypted: false };
+    }
+    const chunk = decodeChunk(calldata);
+    const encrypted = isEncryptedChunk(calldata);
+    return { chunk, hash, encrypted };
+}
+/**
+ * Fetch multiple chunks from transactions
+ */
+export async function fetchChunks(publicClient, hashes) {
+    const results = [];
+    for (const hash of hashes) {
+        const result = await fetchChunk(publicClient, hash);
+        results.push(result);
+    }
+    return results;
+}
+/**
+ * Fetch chunks in parallel
+ */
+export async function fetchChunksParallel(publicClient, hashes) {
+    return Promise.all(hashes.map((hash) => fetchChunk(publicClient, hash)));
+}
+// ============================================================================
+// Assembler
+// ============================================================================
+/**
+ * Fetch and reassemble data from transaction hashes
+ */
+export async function assembleFromHashes(publicClient, hashes, options = {}) {
+    const results = await fetchChunksParallel(publicClient, hashes);
+    // Extract valid chunks
+    const chunks = [];
+    let encrypted = false;
+    for (const result of results) {
+        if (result.chunk) {
+            chunks.push(result.chunk);
+            if (result.encrypted) {
+                encrypted = true;
+            }
+        }
+    }
+    if (chunks.length === 0) {
+        return null;
+    }
+    // Reassemble
+    const data = reassembleChunks(chunks);
+    if (!data) {
+        return null;
+    }
+    // Decrypt if needed
+    if (encrypted && options.keys && options.recipientId) {
+        const payload = JSON.parse(new TextDecoder().decode(data));
+        return decryptForRecipient(options.recipientId, options.keys, payload);
+    }
+    return data;
+}
+// ============================================================================
+// Streaming Assembler
+// ============================================================================
+export class StreamingAssembler {
+    publicClient;
+    tracker = new ChunkTracker();
+    options;
+    constructor(publicClient, options = {}) {
+        this.publicClient = publicClient;
+        this.options = options;
+    }
+    /**
+     * Add a transaction hash and check for completion
+     */
+    async addHash(hash) {
+        const result = await fetchChunk(this.publicClient, hash);
+        if (!result.chunk) {
+            return null;
+        }
+        const data = this.tracker.add(result.chunk);
+        if (!data) {
+            return null;
+        }
+        // Decrypt if needed
+        if (result.encrypted && this.options.keys && this.options.recipientId) {
+            const payload = JSON.parse(new TextDecoder().decode(data));
+            return decryptForRecipient(this.options.recipientId, this.options.keys, payload);
+        }
+        return data;
+    }
+    /**
+     * Add multiple transaction hashes
+     */
+    async addHashes(hashes) {
+        for (const hash of hashes) {
+            const result = await this.addHash(hash);
+            if (result) {
+                return result;
+            }
+        }
+        return null;
+    }
+    /**
+     * Get incomplete chunk sets
+     */
+    getIncomplete() {
+        return this.tracker.getIncomplete();
+    }
+    /**
+     * Clear all tracked data
+     */
+    clear() {
+        this.tracker.clear();
+    }
+}
+// ============================================================================
+// Utilities
+// ============================================================================
+function hexToString(hex) {
+    // Remove 0x prefix if present
+    const cleanHex = hex.startsWith('0x') ? hex.slice(2) : hex;
+    // Convert hex to bytes
+    const bytes = new Uint8Array(cleanHex.length / 2);
+    for (let i = 0; i < cleanHex.length; i += 2) {
+        bytes[i / 2] = parseInt(cleanHex.substr(i, 2), 16);
+    }
+    // Decode as UTF-8
+    return new TextDecoder().decode(bytes);
+}
+//# sourceMappingURL=assembler.js.map

package/dist/assembler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assembler.js","sourceRoot":"","sources":["../src/assembler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC7F,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAYlD,+EAA+E;AAC/E,WAAW;AACX,+EAA+E;AAE/E;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,YAA0B,EAC1B,IAAU;IAEV,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,MAAM,YAAY,CAAC,cAAc,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QAEvD,IAAI,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;YACrB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,wBAAwB;QACxB,OAAO,WAAW,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,YAA0B,EAC1B,IAAU;IAEV,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;IAE5D,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IACjD,CAAC;IAED,MAAM,KAAK,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;IACpC,MAAM,SAAS,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAE7C,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,YAA0B,EAC1B,MAAc;IAEd,MAAM,OAAO,GAAkB,EAAE,CAAC;IAElC,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;QACpD,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvB,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,YAA0B,EAC1B,MAAc;IAEd,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;AAC3E,CAAC;AAED,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,YAA0B,EAC1B,MAAc,EACd,UAA2B,EAAE;IAE7B,MAAM,OAAO,GAAG,MAAM,mBAAmB,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAEhE,uBAAuB;IACvB,MAAM,MAAM,GAAY,EAAE,CAAC;IAC3B,IAAI,SAAS,GAAG,KAAK,CAAC;IAEtB,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACjB,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC1B,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;gBACrB,SAAS,GAAG,IAAI,CAAC;YACnB,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,aAAa;IACb,MAAM,IAAI,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAEtC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,IAAI,CAAC;IACd,CAAC;IAED,oBAAoB;IACpB,IAAI,SAAS,IAAI,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;QACrD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3D,OAAO,mBAAmB,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACzE,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,+EAA+E;AAC/E,sBAAsB;AACtB,+EAA+E;AAE/E,MAAM,OAAO,kBAAkB;IACrB,YAAY,CAAe;IAC3B,OAAO,GAAG,IAAI,YAAY,EAAE,CAAC;IAC7B,OAAO,CAAkB;IAEjC,YAAY,YAA0B,EAAE,UAA2B,EAAE;QACnE,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,IAAU;QACtB,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;QAEzD,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YAClB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAE5C,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,IAAI,CAAC;QACd,CAAC;QAED,oBAAoB;QACpB,IAAI,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;YACtE,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;YAC3D,OAAO,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACnF,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS,CAAC,MAAc;QAC5B,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;YAC1B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACxC,IAAI,MAAM,EAAE,CAAC;gBACX,OAAO,MAAM,CAAC;YAChB,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;IACtC,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;CACF;AAED,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E,SAAS,WAAW,CAAC,GAAW;IAC9B,8BAA8B;IAC9B,MAAM,QAAQ,GAAG,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IAE3D,uBAAuB;IACvB,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAClD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5C,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,kBAAkB;IAClB,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACzC,CAAC"}

package/dist/chunker.d.ts

@@ -0,0 +1,65 @@
+/**
+ * ChunkTech - File Chunking
+ * Split files into chunks for on-chain storage
+ */
+import type { Chunk, ChunkedData } from './types.js';
+/**
+ * Generate a random chunk set ID
+ */
+export declare function generateChunkId(): string;
+/**
+ * Split data into chunks
+ */
+export declare function chunkData(data: Uint8Array, chunkId?: string): ChunkedData;
+/**
+ * Encode chunk to calldata string
+ */
+export declare function encodeChunk(chunk: Chunk, encrypted?: boolean): string;
+/**
+ * Decode calldata string to chunk
+ */
+export declare function decodeChunk(calldata: string): Chunk | null;
+/**
+ * Check if calldata is a chunk
+ */
+export declare function isChunk(calldata: string): boolean;
+/**
+ * Check if calldata is an encrypted chunk
+ */
+export declare function isEncryptedChunk(calldata: string): boolean;
+/**
+ * Reassemble chunks back into original data
+ */
+export declare function reassembleChunks(chunks: Chunk[]): Uint8Array | null;
+export declare class ChunkTracker {
+    private chunks;
+    /**
+     * Add a chunk, returns assembled data if complete
+     */
+    add(chunk: Chunk): Uint8Array | null;
+    /**
+     * Get incomplete chunk sets
+     */
+    getIncomplete(): Array<{
+        id: string;
+        have: number;
+        need: number;
+    }>;
+    /**
+     * Get chunks for a specific ID
+     */
+    getChunks(id: string): Chunk[];
+    /**
+     * Clear all tracked chunks
+     */
+    clear(): void;
+}
+/**
+ * Estimate number of chunks needed for data
+ */
+export declare function estimateChunks(dataSize: number): number;
+/**
+ * Estimate total calldata size (rough approximation)
+ */
+export declare function estimateCalldataSize(dataSize: number): number;
+//# sourceMappingURL=chunker.d.ts.map

package/dist/chunker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunker.d.ts","sourceRoot":"","sources":["../src/chunker.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAiB,MAAM,YAAY,CAAC;AAOpE;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAMxC;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,WAAW,CAmBzE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,UAAQ,GAAG,MAAM,CAenE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAsB1D;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAKjD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE1D;AAMD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,UAAU,GAAG,IAAI,CAqCnE;AAMD,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAA8B;IAE5C;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,KAAK,GAAG,UAAU,GAAG,IAAI;IAuBpC;;OAEG;IACH,aAAa,IAAI,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAYlE;;OAEG;IACH,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,KAAK,EAAE;IAI9B;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd;AAMD;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAK7D"}