chunktech 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,138 @@
+/**
+ * ChunkTech - Type Definitions
+ */
+import type { WalletClient, PublicClient, Hash, Chain } from 'viem';
+export interface ChainConfig {
+    id: number;
+    name: string;
+    rpcUrl?: string;
+}
+export declare const SUPPORTED_CHAINS: Record<string, ChainConfig>;
+export interface ChunkTechConfig {
+    /** Wallet client for signing transactions */
+    walletClient: WalletClient;
+    /** Public client for reading from chain (optional, created from walletClient if not provided) */
+    publicClient?: PublicClient;
+    /** Chain to use */
+    chain?: Chain;
+    /** Custom RPC URL */
+    rpcUrl?: string;
+}
+export interface ChunkMetadata {
+    /** Unique chunk set ID (hex) */
+    id: string;
+    /** 1-indexed chunk number */
+    part: number;
+    /** Total chunks in set */
+    total: number;
+}
+export interface Chunk extends ChunkMetadata {
+    /** Raw chunk data (Uint8Array) */
+    data: Uint8Array;
+}
+export interface ChunkedData {
+    /** Chunk set ID */
+    id: string;
+    /** Total number of chunks */
+    total: number;
+    /** Chunks ready to send */
+    chunks: Chunk[];
+}
+export interface UploadOptions {
+    /** Enable encryption (requires crypto module) */
+    encrypt?: boolean;
+    /** Encryption keys (required if encrypt: true) */
+    keys?: EncryptionKeys;
+    /** Recipients for encrypted data */
+    recipients?: Recipient[];
+    /** Progress callback */
+    onProgress?: (sent: number, total: number) => void;
+    /** Wait for confirmations (default: 1) */
+    confirmations?: number;
+}
+export interface UploadResult {
+    /** Unique chunk set ID */
+    chunkId: string;
+    /** Transaction hashes for each chunk */
+    txHashes: Hash[];
+    /** Total chunks sent */
+    totalChunks: number;
+    /** Total bytes uploaded */
+    totalBytes: number;
+}
+export interface DownloadOptions {
+    /** Decryption keys (required if data was encrypted) */
+    keys?: EncryptionKeys;
+    /** Your recipient ID (required if data was encrypted) */
+    recipientId?: string;
+}
+export interface DownloadResult {
+    /** Reassembled file data */
+    data: Uint8Array;
+    /** Chunk set ID */
+    chunkId: string;
+    /** Total chunks retrieved */
+    totalChunks: number;
+}
+export interface TxStatus {
+    /** Transaction hash */
+    hash: Hash;
+    /** Chunk part number */
+    part: number;
+    /** Transaction status */
+    status: 'pending' | 'confirmed' | 'failed';
+    /** Block number (if confirmed) */
+    blockNumber?: bigint;
+    /** Confirmations count */
+    confirmations?: number;
+}
+export interface TrackerOptions {
+    /** Required confirmations (default: 1) */
+    confirmations?: number;
+    /** Poll interval in ms (default: 2000) */
+    pollInterval?: number;
+    /** Timeout in ms (default: 300000 = 5 min) */
+    timeout?: number;
+    /** Status update callback */
+    onStatus?: (status: TxStatus) => void;
+}
+export interface KeyPair {
+    privateKey: Uint8Array;
+    publicKey: Uint8Array;
+}
+export interface KeyBundle {
+    identityKey: Uint8Array;
+    signedPreKey: Uint8Array;
+}
+export interface EncryptionKeys {
+    identity: KeyPair;
+    signedPreKey: KeyPair;
+    bundle: KeyBundle;
+}
+export interface Recipient {
+    id: string;
+    bundle: KeyBundle;
+}
+export interface EncryptedPayload {
+    version: number;
+    senderIdentityKey: string;
+    iv: string;
+    ciphertext: string;
+    authTag: string;
+    keys: WrappedKey[];
+}
+export interface WrappedKey {
+    recipientId: string;
+    recipientIdentityKey: string;
+    ephemeralKey: string;
+    wrappedKey: string;
+    iv: string;
+    authTag: string;
+}
+/** Maximum chunk size in bytes (33.3KB) */
+export declare const MAX_CHUNK_SIZE = 33333;
+/** Chunk data prefix for identification */
+export declare const CHUNK_PREFIX = "data:chunk,";
+/** Encrypted chunk prefix */
+export declare const CHUNK_ENCRYPTED_PREFIX = "data:chunk-enc,";
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,21 @@
+/**
+ * ChunkTech - Type Definitions
+ */
+export const SUPPORTED_CHAINS = {
+    ethereum: { id: 1, name: 'Ethereum' },
+    base: { id: 8453, name: 'Base' },
+    arbitrum: { id: 42161, name: 'Arbitrum One' },
+    sepolia: { id: 11155111, name: 'Sepolia' },
+    baseSepolia: { id: 84532, name: 'Base Sepolia' },
+    arbitrumSepolia: { id: 421614, name: 'Arbitrum Sepolia' },
+};
+// ============================================================================
+// Constants
+// ============================================================================
+/** Maximum chunk size in bytes (33.3KB) */
+export const MAX_CHUNK_SIZE = 33333;
+/** Chunk data prefix for identification */
+export const CHUNK_PREFIX = 'data:chunk,';
+/** Encrypted chunk prefix */
+export const CHUNK_ENCRYPTED_PREFIX = 'data:chunk-enc,';
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAcH,MAAM,CAAC,MAAM,gBAAgB,GAAgC;IAC3D,QAAQ,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE;IACrC,IAAI,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE;IAChC,QAAQ,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE;IAC7C,OAAO,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE;IAC1C,WAAW,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE;IAChD,eAAe,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,EAAE;CAC1D,CAAC;AA+JF,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E,2CAA2C;AAC3C,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,CAAC;AAEpC,2CAA2C;AAC3C,MAAM,CAAC,MAAM,YAAY,GAAG,aAAa,CAAC;AAE1C,6BAA6B;AAC7B,MAAM,CAAC,MAAM,sBAAsB,GAAG,iBAAiB,CAAC"}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "chunktech",
+  "version": "0.1.0",
+  "description": "On-chain file storage via chunked transactions for EVM chains",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "node --experimental-vm-modules test/index.test.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "ethereum",
+    "base",
+    "arbitrum",
+    "blockchain",
+    "file-storage",
+    "chunking",
+    "calldata",
+    "on-chain"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "viem": "^2.21.0"
+  },
+  "optionalDependencies": {
+    "@noble/curves": "^1.6.0",
+    "@noble/hashes": "^1.5.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}