web3ql-client 1.2.0

package/dist/src/batch.d.ts

@@ -0,0 +1,107 @@
+/**
+ * @file   batch.ts
+ * @notice Web3QL v1.2 — atomic batch writes via Multicall3.
+ *
+ * Problem:
+ *   Each record write is one Ethereum transaction. Writing N records costs N
+ *   round-trips and creates N separate on-chain entries. For bulk operations
+ *   this is slow and expensive.
+ *
+ * Solution:
+ *   Multicall3 (deployed at 0xcA11bde05977b3631167028862bE2a173976CA11 on
+ *   most EVM chains including Celo) lets you batch N contract calls into a
+ *   single transaction. All calls succeed or all revert — atomicity at EVM level.
+ *
+ * Usage:
+ * ─────────────────────────────────────────────────────────────
+ *   const batch = new BatchWriter(tableClient, signer);
+ *
+ *   // Stage writes
+ *   await batch.stageWrite(key1, plaintext1);
+ *   await batch.stageWrite(key2, plaintext2);
+ *   await batch.stageUpdate(key3, newPlaintext3);
+ *
+ *   // Submit all at once (single tx)
+ *   const receipt = await batch.submit();
+ *
+ * Limitations:
+ *   • Each call still encrypts with a fresh per-record symmetric key.
+ *   • If total calldata exceeds the block gas limit, submission will fail.
+ *     Keep batches under ~100 records for safety on Celo.
+ *   • Multicall3 is non-atomic by default. Use allowFailure=false for
+ *     atomicity (any single failure reverts all).
+ * ─────────────────────────────────────────────────────────────
+ */
+import { ethers } from 'ethers';
+import type { EncryptedTableClient } from './table-client.js';
+import type { EncryptionKeypair } from './crypto.js';
+export declare const MULTICALL3_ADDRESS = "0xcA11bde05977b3631167028862bE2a173976CA11";
+export declare class BatchWriter {
+    private tableClient;
+    private keypair;
+    private signer;
+    private multicall;
+    private ops;
+    constructor(tableClient: EncryptedTableClient, signer: ethers.Signer, keypair: EncryptionKeypair, multicallAddress?: string);
+    /**
+     * Stage a write (new record).
+     * Encrypts the plaintext synchronously before staging.
+     */
+    stageWrite(key: string, plaintext: string | Uint8Array): Promise<this>;
+    /**
+     * Stage an update (overwrite existing record).
+     */
+    stageUpdate(key: string, plaintext: string | Uint8Array): Promise<this>;
+    /**
+     * Stage a delete.
+     */
+    stageDelete(key: string): this;
+    /** Number of staged operations. */
+    get size(): number;
+    /** Clear all staged operations without submitting. */
+    clear(): void;
+    /**
+     * Submit all staged operations as a single Multicall3 transaction.
+     *
+     * @param allowFailure  If true (default), individual call failures don't revert
+     *                      the whole batch. Set false for full atomicity.
+     * @returns             The transaction receipt + per-call results.
+     */
+    submit(allowFailure?: boolean): Promise<{
+        receipt: ethers.TransactionReceipt;
+        results: {
+            success: boolean;
+            returnData: string;
+        }[];
+    }>;
+    /**
+     * Encode and stage N write operations from an array of (key, plaintext) pairs,
+     * then submit in chunks to avoid hitting block gas limits.
+     *
+     * @param rows          Array of { key, plaintext } to write.
+     * @param chunkSize     Max records per transaction. Default: 50.
+     * @param allowFailure  Passed to each submit() call.
+     */
+    seedBatch(rows: {
+        key: string;
+        plaintext: string;
+    }[], chunkSize?: number, allowFailure?: boolean): Promise<ethers.TransactionReceipt[]>;
+}
+export interface CrossTableOp {
+    tableAddress: string;
+    type: 'write' | 'update' | 'delete';
+    key: string;
+    plaintext?: string;
+}
+/**
+ * Build a Multicall3 batch across multiple different table contracts.
+ *
+ * Each op specifies the target table address explicitly, so you can write
+ * to `users`, `posts`, and `comments` in a single atomic transaction.
+ */
+export declare function buildCrossTableBatch(ops: CrossTableOp[], keypair: EncryptionKeypair): Promise<{
+    target: string;
+    allowFailure: boolean;
+    callData: string;
+}[]>;
+//# sourceMappingURL=batch.d.ts.map

package/dist/src/batch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch.d.ts","sourceRoot":"","sources":["../../src/batch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAoC,QAAQ,CAAC;AAC9D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAiB,mBAAmB,CAAC;AAMzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAoB,aAAa,CAAC;AAMnE,eAAO,MAAM,kBAAkB,+CAA+C,CAAC;AAsC/E,qBAAa,WAAW;IACtB,OAAO,CAAC,WAAW,CAAwB;IAC3C,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,GAAG,CAA2B;gBAGpC,WAAW,EAAO,oBAAoB,EACtC,MAAM,EAAY,MAAM,CAAC,MAAM,EAC/B,OAAO,EAAW,iBAAiB,EACnC,gBAAgB,GAAE,MAA2B;IAU/C;;;OAGG;IACG,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAW5E;;OAEG;IACG,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAW7E;;OAEG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAM9B,mCAAmC;IACnC,IAAI,IAAI,IAAI,MAAM,CAA4B;IAE9C,sDAAsD;IACtD,KAAK,IAAI,IAAI;IAIb;;;;;;OAMG;IACG,MAAM,CAAC,YAAY,UAAO,GAAG,OAAO,CAAC;QACzC,OAAO,EAAE,MAAM,CAAC,kBAAkB,CAAC;QACnC,OAAO,EAAG;YAAE,OAAO,EAAE,OAAO,CAAC;YAAC,UAAU,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;KACtD,CAAC;IA6BF;;;;;;;OAOG;IACG,SAAS,CACb,IAAI,EAAU;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EAAE,EAClD,SAAS,GAAK,MAAW,EACzB,YAAY,GAAE,OAAc,GAC3B,OAAO,CAAC,MAAM,CAAC,kBAAkB,EAAE,CAAC;CAUxC;AAMD,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAU,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC5C,GAAG,EAAW,MAAM,CAAC;IACrB,SAAS,CAAC,EAAI,MAAM,CAAC;CACtB;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,GAAG,EAAM,YAAY,EAAE,EACvB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CAsBxE"}

package/dist/src/batch.js

@@ -0,0 +1,188 @@
+/**
+ * @file   batch.ts
+ * @notice Web3QL v1.2 — atomic batch writes via Multicall3.
+ *
+ * Problem:
+ *   Each record write is one Ethereum transaction. Writing N records costs N
+ *   round-trips and creates N separate on-chain entries. For bulk operations
+ *   this is slow and expensive.
+ *
+ * Solution:
+ *   Multicall3 (deployed at 0xcA11bde05977b3631167028862bE2a173976CA11 on
+ *   most EVM chains including Celo) lets you batch N contract calls into a
+ *   single transaction. All calls succeed or all revert — atomicity at EVM level.
+ *
+ * Usage:
+ * ─────────────────────────────────────────────────────────────
+ *   const batch = new BatchWriter(tableClient, signer);
+ *
+ *   // Stage writes
+ *   await batch.stageWrite(key1, plaintext1);
+ *   await batch.stageWrite(key2, plaintext2);
+ *   await batch.stageUpdate(key3, newPlaintext3);
+ *
+ *   // Submit all at once (single tx)
+ *   const receipt = await batch.submit();
+ *
+ * Limitations:
+ *   • Each call still encrypts with a fresh per-record symmetric key.
+ *   • If total calldata exceeds the block gas limit, submission will fail.
+ *     Keep batches under ~100 records for safety on Celo.
+ *   • Multicall3 is non-atomic by default. Use allowFailure=false for
+ *     atomicity (any single failure reverts all).
+ * ─────────────────────────────────────────────────────────────
+ */
+import { ethers } from 'ethers';
+import { generateSymmetricKey, encryptData, encryptKeyForSelf, } from './crypto.js';
+// ─────────────────────────────────────────────────────────────
+//  Multicall3 — deployed at the same address on all major EVM chains
+// ─────────────────────────────────────────────────────────────
+export const MULTICALL3_ADDRESS = '0xcA11bde05977b3631167028862bE2a173976CA11';
+const MULTICALL3_ABI = [
+    `function aggregate3(
+    tuple(address target, bool allowFailure, bytes callData)[] calls
+  ) external payable returns (tuple(bool success, bytes returnData)[] returnData)`,
+];
+// ─────────────────────────────────────────────────────────────
+//  Table ABI (minimal subset for encoding)
+// ─────────────────────────────────────────────────────────────
+const TABLE_IFACE = new ethers.Interface([
+    'function write(bytes32 key, bytes calldata ciphertext, bytes calldata encryptedKey) external',
+    'function update(bytes32 key, bytes calldata ciphertext, bytes calldata encryptedKey) external',
+    'function deleteRecord(bytes32 key) external',
+]);
+function toBytes(data) {
+    return typeof data === 'string' ? new TextEncoder().encode(data) : data;
+}
+// ─────────────────────────────────────────────────────────────
+//  BatchWriter
+// ─────────────────────────────────────────────────────────────
+export class BatchWriter {
+    tableClient;
+    keypair;
+    signer;
+    multicall;
+    ops = [];
+    constructor(tableClient, signer, keypair, multicallAddress = MULTICALL3_ADDRESS) {
+        this.tableClient = tableClient;
+        this.keypair = keypair;
+        this.signer = signer;
+        this.multicall = new ethers.Contract(multicallAddress, MULTICALL3_ABI, signer);
+    }
+    // ── Stage operations ────────────────────────────────────────
+    /**
+     * Stage a write (new record).
+     * Encrypts the plaintext synchronously before staging.
+     */
+    async stageWrite(key, plaintext) {
+        const data = toBytes(plaintext);
+        const symKey = generateSymmetricKey();
+        const ciphertext = encryptData(data, symKey);
+        const encryptedKey = encryptKeyForSelf(symKey, this.keypair);
+        const callData = TABLE_IFACE.encodeFunctionData('write', [key, ciphertext, encryptedKey]);
+        this.ops.push({ type: 'write', target: this.tableClient.tableAddress, callData });
+        return this;
+    }
+    /**
+     * Stage an update (overwrite existing record).
+     */
+    async stageUpdate(key, plaintext) {
+        const data = toBytes(plaintext);
+        const symKey = generateSymmetricKey();
+        const ciphertext = encryptData(data, symKey);
+        const encryptedKey = encryptKeyForSelf(symKey, this.keypair);
+        const callData = TABLE_IFACE.encodeFunctionData('update', [key, ciphertext, encryptedKey]);
+        this.ops.push({ type: 'update', target: this.tableClient.tableAddress, callData });
+        return this;
+    }
+    /**
+     * Stage a delete.
+     */
+    stageDelete(key) {
+        const callData = TABLE_IFACE.encodeFunctionData('deleteRecord', [key]);
+        this.ops.push({ type: 'delete', target: this.tableClient.tableAddress, callData });
+        return this;
+    }
+    /** Number of staged operations. */
+    get size() { return this.ops.length; }
+    /** Clear all staged operations without submitting. */
+    clear() { this.ops = []; }
+    // ── Submit ──────────────────────────────────────────────────
+    /**
+     * Submit all staged operations as a single Multicall3 transaction.
+     *
+     * @param allowFailure  If true (default), individual call failures don't revert
+     *                      the whole batch. Set false for full atomicity.
+     * @returns             The transaction receipt + per-call results.
+     */
+    async submit(allowFailure = true) {
+        if (this.ops.length === 0)
+            throw new Error('BatchWriter: no operations staged');
+        const calls = this.ops.map((op) => ({
+            target: op.target,
+            allowFailure,
+            callData: op.callData,
+        }));
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const tx = await this.multicall.aggregate3(calls);
+        const receipt = await tx.wait();
+        // Decode return data
+        const results = [];
+        for (const log of receipt.logs) {
+            // The aggregate3 return is in the function call return, not logs.
+            // We rely on success/failure from receipt status.
+            void log;
+        }
+        // Clear staged ops after submit
+        this.ops = [];
+        return { receipt, results };
+    }
+    // ── Convenience: batch seed ─────────────────────────────────
+    /**
+     * Encode and stage N write operations from an array of (key, plaintext) pairs,
+     * then submit in chunks to avoid hitting block gas limits.
+     *
+     * @param rows          Array of { key, plaintext } to write.
+     * @param chunkSize     Max records per transaction. Default: 50.
+     * @param allowFailure  Passed to each submit() call.
+     */
+    async seedBatch(rows, chunkSize = 50, allowFailure = true) {
+        const receipts = [];
+        for (let i = 0; i < rows.length; i += chunkSize) {
+            const chunk = rows.slice(i, i + chunkSize);
+            for (const row of chunk)
+                await this.stageWrite(row.key, row.plaintext);
+            const { receipt } = await this.submit(allowFailure);
+            receipts.push(receipt);
+        }
+        return receipts;
+    }
+}
+/**
+ * Build a Multicall3 batch across multiple different table contracts.
+ *
+ * Each op specifies the target table address explicitly, so you can write
+ * to `users`, `posts`, and `comments` in a single atomic transaction.
+ */
+export async function buildCrossTableBatch(ops, keypair) {
+    const calls = [];
+    for (const op of ops) {
+        let callData;
+        if (op.type === 'delete') {
+            callData = TABLE_IFACE.encodeFunctionData('deleteRecord', [op.key]);
+        }
+        else {
+            if (!op.plaintext)
+                throw new Error(`buildCrossTableBatch: plaintext required for ${op.type}`);
+            const data = new TextEncoder().encode(op.plaintext);
+            const symKey = generateSymmetricKey();
+            const ciphertext = encryptData(data, symKey);
+            const encryptedKey = encryptKeyForSelf(symKey, keypair);
+            const fn = op.type === 'write' ? 'write' : 'update';
+            callData = TABLE_IFACE.encodeFunctionData(fn, [op.key, ciphertext, encryptedKey]);
+        }
+        calls.push({ target: op.tableAddress, allowFailure: true, callData });
+    }
+    return calls;
+}
+//# sourceMappingURL=batch.js.map

package/dist/src/batch.js.map

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

package/dist/src/cli.d.ts

@@ -0,0 +1,40 @@
+#!/usr/bin/env node
+/**
+ * @file   cli.ts
+ * @notice Web3QL CLI — manage databases, tables, and records from the terminal.
+ *
+ * Install globally:
+ *   npm install -g @web3ql/sdk
+ *   web3ql --help
+ *
+ * Or run via npx:
+ *   npx @web3ql/sdk <command>
+ *
+ * Requires a .env file (or env vars):
+ *   PRIVATE_KEY=0x...
+ *   RPC_URL=https://...
+ *   FACTORY_ADDRESS=0x...
+ *   REGISTRY_ADDRESS=0x...
+ *
+ * ─────────────────────────────────────────────────────────────
+ * Commands
+ * ─────────────────────────────────────────────────────────────
+ *   web3ql db list                     — list your databases
+ *   web3ql db create <name>            — create a new database
+ *
+ *   web3ql table list <dbAddress>      — list tables in a database
+ *   web3ql table create <dbAddress> "<SQL>"  — create table from SQL
+ *   web3ql table schema <tableAddress> — print schema for a table
+ *
+ *   web3ql record write <tableAddress> <id> '<json>'  — write a record
+ *   web3ql record read  <tableAddress> <id>           — read + decrypt a record
+ *   web3ql record list  <tableAddress>                — list your records
+ *   web3ql record delete <tableAddress> <id>          — delete a record
+ *
+ *   web3ql query <tableAddress> --where "age > 18" --order "name asc" --limit 10
+ *
+ *   web3ql info                        — show connected wallet + factory
+ * ─────────────────────────────────────────────────────────────
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/src/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG"}