@decent-stuff/dc-client/dist/dc-client.js

High-performance WebAssembly client for browser-based querying of Decent Cloud ledger data

/**
 * Main client module for the Decent Cloud WASM library.
 * This module provides the API for interacting with the ledger.
 */
import { __wbg_set_wasm } from './dc-client_bg.js';
import * as wasmModule from './dc-client_bg.js';
import { decentCloudLedger } from './ledger';
import { db } from './db';
export { decentCloudLedger, db };

// Track initialization state and module path
let initialized = false;

/**
 * Client class for interacting with the Decent Cloud ledger.
 */
export class DecentCloudClient {
  /**
   * Initialize the WASM module.
   * @returns {Promise<void>}
   */
  async initialize() {
    await initializeWasm();
  }

  /**
   * Clear the ledger storage.
   * @returns {Promise<void>}
   */
  async clearStorage() {
    return await ledgerStorageClear();
  }
}

/**
 * Initialize the WASM module.
 * @returns {Promise<void>} A promise that resolves when initialization is complete.
 */
export async function initializeWasm() {
  if (initialized) return;
  try {
    // 16 MB initial, up to 256 MB
    const memory = new WebAssembly.Memory({ initial: 256, maximum: 4096 });

    const response = await fetch(new URL('./dc-client_bg.wasm', import.meta.url));
    const wasmModuleInstance = await WebAssembly.instantiate(await response.arrayBuffer(), {
      env: { memory },
      './dc-client_bg.js': wasmModule,
    });
    __wbg_set_wasm(wasmModuleInstance.instance.exports);
    wasmModuleInstance.instance.exports.init();
    initialized = true;
  } catch (error) {
    console.error('Failed to initialize WASM module:', error);
    throw error;
  }
}

/**
 * Parse ledger blocks from raw binary input data.
 * @param {Uint8Array} inputData - The raw input data.
 * @param {bigint} [startOffset=0n] - The starting offset.
 * @returns {Promise<BlockData[]>} A promise that resolves to an array of ledger block data.
 */
export async function parseLedgerBlocks(inputData, startOffset) {
  if (!initialized) await initializeWasm();
  try {
    // The WASM function returns a JSON string; parse it into an object.
    const result = wasmModule.parse_ledger_blocks(inputData, startOffset);
    return typeof result === 'string' ? JSON.parse(result) : result;
  } catch (error) {
    console.error('Error in parseLedgerBlocks:', error);
    throw error;
  }
}

/**
 * Sign data using ed25519.
 * @param {Uint8Array} secretKeyRaw - The private key, in raw format.
 * @param {Uint8Array} data - The data to sign.
 * @returns {Promise<Uint8Array>} The signature.
 */
export async function ed25519Sign(privateKeyRaw, data) {
  if (!initialized) await initializeWasm();
  return wasmModule.ed25519_sign(privateKeyRaw, data);
}

/**
 * Clear the ledger storage.
 * @returns {Promise<void>}
 */
export async function ledgerStorageClear() {
  if (!initialized) await initializeWasm();
  try {
    wasmModule.ledger_storage_clear();
  } catch (error) {
    console.error('Error in ledgerStorageClear:', error);
    throw error;
  }
}