@riseandshaheen/libcma 0.1.0-alpha.0

package/lib/index.cjs

@@ -0,0 +1,445 @@
+'use strict';
+
+var module$1 = require('module');
+var path = require('path');
+var url = require('url');
+
+var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
+// src/types.ts
+var ADDRESS_LENGTH = 20;
+var U256_LENGTH = 32;
+var ACCOUNTS_DRIVE_PATH = "/dev/pmem1";
+var ACCOUNTS_DRIVE_SIZE_4MIB = 4194304;
+var LOG2_MAX_NUM_OF_ACCOUNTS_DEFAULT = 17;
+var LEDGER_MIN_MEM_LENGTH = 262144;
+var DEFAULT_ETHER_CONFIG = {
+  memoryLength: ACCOUNTS_DRIVE_SIZE_4MIB,
+  maxAccounts: 2 ** LOG2_MAX_NUM_OF_ACCOUNTS_DEFAULT
+};
+
+// src/errors.ts
+var LedgerErrorCode = {
+  SUCCESS: 0,
+  UNKNOWN: -1001,
+  EXCEPTION: -1002,
+  INSUFFICIENT_FUNDS: -1003,
+  ACCOUNT_NOT_FOUND: -1004,
+  ASSET_NOT_FOUND: -1005,
+  BALANCE_NOT_FOUND: -1006,
+  SUPPLY_OVERFLOW: -1007,
+  BALANCE_OVERFLOW: -1008,
+  INVALID_ACCOUNT: -1009,
+  INSERTION_ERROR: -1010,
+  MAX_ASSETS_REACHED: -1011,
+  MAX_ACCOUNTS_REACHED: -1012,
+  MAX_BALANCES_REACHED: -1013,
+  ASSET_SUPPLY: -1014,
+  ACCOUNT_BALANCE: -1015,
+  REMOVE: -1016
+};
+var CODE_NAMES = Object.fromEntries(
+  Object.entries(LedgerErrorCode).map(([k, v]) => [v, k])
+);
+var LedgerError = class _LedgerError extends Error {
+  name = "LedgerError";
+  code;
+  constructor(code, message) {
+    const label = CODE_NAMES[code] ?? "UNKNOWN";
+    super(message ?? `libcma ledger error ${label} (${code})`);
+    this.code = code;
+  }
+  static fromCode(code, detail) {
+    return new _LedgerError(code, detail);
+  }
+};
+
+// src/bytes.ts
+var HEX_RE = /^0x[0-9a-fA-F]*$/;
+function isHex(value) {
+  return HEX_RE.test(value) && value.length % 2 === 0;
+}
+function toBytes(value, name = "value") {
+  if (value instanceof Uint8Array) {
+    return value;
+  }
+  if (typeof value !== "string" || !isHex(value)) {
+    throw new TypeError(`${name} must be a 0x-hex string or Uint8Array`);
+  }
+  const hex = value.slice(2);
+  if (hex.length % 2 !== 0) {
+    throw new TypeError(`${name} hex length must be even`);
+  }
+  const out = new Uint8Array(hex.length / 2);
+  for (let i = 0; i < out.length; i++) {
+    out[i] = Number.parseInt(hex.slice(i * 2, i * 2 + 2), 16);
+  }
+  return out;
+}
+function toHex(bytes) {
+  let s = "0x";
+  for (const b of bytes) {
+    s += b.toString(16).padStart(2, "0");
+  }
+  return s;
+}
+function normalizeAddress(address) {
+  const bytes = toBytes(address, "address");
+  if (bytes.length !== ADDRESS_LENGTH) {
+    throw new TypeError(
+      `address must be ${ADDRESS_LENGTH} bytes, got ${bytes.length}`
+    );
+  }
+  return toHex(bytes).toLowerCase();
+}
+function assertAmount(amount, name = "amount") {
+  if (typeof amount !== "bigint") {
+    throw new TypeError(`${name} must be a bigint`);
+  }
+  if (amount < 0n) {
+    throw new RangeError(`${name} must be non-negative`);
+  }
+}
+function parseEtherPortalDeposit(payload) {
+  const bytes = toBytes(payload, "payload");
+  if (bytes.length < ADDRESS_LENGTH + 32) {
+    throw LedgerError.fromCode(
+      LedgerErrorCode.UNKNOWN,
+      `ether deposit payload too short: ${bytes.length} bytes`
+    );
+  }
+  const sender = normalizeAddress(bytes.subarray(0, ADDRESS_LENGTH));
+  let value = 0n;
+  for (let i = 0; i < 32; i++) {
+    value = value << 8n | BigInt(bytes[ADDRESS_LENGTH + i]);
+  }
+  const rest = bytes.subarray(ADDRESS_LENGTH + 32);
+  if (rest.length === 0) {
+    return { sender, value };
+  }
+  return { sender, value, execLayerData: toHex(rest) };
+}
+
+// src/memory-backend.ts
+var MemoryBackend = class _MemoryBackend {
+  kind = "memory";
+  #balances = /* @__PURE__ */ new Map();
+  #closed = false;
+  maxAccounts;
+  constructor(options) {
+    this.maxAccounts = options.maxAccounts;
+  }
+  static openEther(maxAccounts) {
+    return new _MemoryBackend({ maxAccounts });
+  }
+  #ensureOpen() {
+    if (this.#closed) {
+      throw LedgerError.fromCode(
+        LedgerErrorCode.UNKNOWN,
+        "ledger is closed"
+      );
+    }
+  }
+  #get(key) {
+    return this.#balances.get(key) ?? 0n;
+  }
+  #set(key, value) {
+    if (value === 0n) {
+      this.#balances.delete(key);
+    } else {
+      this.#balances.set(key, value);
+    }
+  }
+  #ensureCapacityForNew(key) {
+    if (!this.#balances.has(key) && this.#balances.size >= this.maxAccounts) {
+      throw LedgerError.fromCode(LedgerErrorCode.MAX_ACCOUNTS_REACHED);
+    }
+  }
+  depositEther(account, amount) {
+    this.#ensureOpen();
+    assertAmount(amount);
+    if (amount === 0n) {
+      return;
+    }
+    const key = normalizeAddress(account);
+    this.#ensureCapacityForNew(key);
+    this.#set(key, this.#get(key) + amount);
+  }
+  transferEther(from, to, amount) {
+    this.#ensureOpen();
+    assertAmount(amount);
+    if (amount === 0n) {
+      return;
+    }
+    const fromKey = normalizeAddress(from);
+    const toKey = normalizeAddress(to);
+    const balance = this.#get(fromKey);
+    if (balance < amount) {
+      throw LedgerError.fromCode(
+        LedgerErrorCode.INSUFFICIENT_FUNDS,
+        `insufficient balance of ${fromKey}`
+      );
+    }
+    if (fromKey !== toKey) {
+      this.#ensureCapacityForNew(toKey);
+    }
+    this.#set(fromKey, balance - amount);
+    this.#set(toKey, this.#get(toKey) + amount);
+  }
+  withdrawEther(account, amount) {
+    this.#ensureOpen();
+    assertAmount(amount);
+    if (amount === 0n) {
+      return;
+    }
+    const key = normalizeAddress(account);
+    const balance = this.#get(key);
+    if (balance < amount) {
+      throw LedgerError.fromCode(
+        LedgerErrorCode.INSUFFICIENT_FUNDS,
+        `insufficient balance of ${key}: ${amount} > ${balance}`
+      );
+    }
+    this.#set(key, balance - amount);
+  }
+  getEtherBalance(account) {
+    this.#ensureOpen();
+    return this.#get(normalizeAddress(account));
+  }
+  close() {
+    this.#closed = true;
+    this.#balances.clear();
+  }
+};
+var cached;
+function tryLoadNative() {
+  if (cached !== void 0) {
+    return cached;
+  }
+  try {
+    const require2 = module$1.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)));
+    const root = path.join(path.dirname(url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)))), "..");
+    const binding = require2("node-gyp-build")(root);
+    cached = binding;
+    return binding;
+  } catch {
+    cached = null;
+    return null;
+  }
+}
+function isNativeAvailable() {
+  return tryLoadNative() !== null;
+}
+var NativeBackend = class _NativeBackend {
+  kind;
+  #handle;
+  #closed = false;
+  constructor(handle) {
+    this.#handle = handle;
+    this.kind = handle.kind === "native-libcma" ? "native-libcma" : "native-mock";
+  }
+  static openEtherBuffer(maxAccounts) {
+    const native = tryLoadNative();
+    if (!native) {
+      return null;
+    }
+    return new _NativeBackend(native.openEtherBuffer(maxAccounts));
+  }
+  static openEtherFile(path, offset, memoryLength, maxAccounts) {
+    const native = tryLoadNative();
+    if (!native) {
+      return null;
+    }
+    return new _NativeBackend(
+      native.openEtherFile(path, offset, memoryLength, maxAccounts)
+    );
+  }
+  #ensureOpen() {
+    if (this.#closed) {
+      throw LedgerError.fromCode(LedgerErrorCode.UNKNOWN, "ledger is closed");
+    }
+  }
+  #addr(account) {
+    return toBytes(normalizeAddress(account));
+  }
+  depositEther(account, amount) {
+    this.#ensureOpen();
+    assertAmount(amount);
+    this.#handle.depositEther(this.#addr(account), amount);
+  }
+  transferEther(from, to, amount) {
+    this.#ensureOpen();
+    assertAmount(amount);
+    this.#handle.transferEther(this.#addr(from), this.#addr(to), amount);
+  }
+  withdrawEther(account, amount) {
+    this.#ensureOpen();
+    assertAmount(amount);
+    this.#handle.withdrawEther(this.#addr(account), amount);
+  }
+  getEtherBalance(account) {
+    this.#ensureOpen();
+    return this.#handle.getEtherBalance(this.#addr(account));
+  }
+  close() {
+    if (!this.#closed) {
+      this.#handle.close();
+      this.#closed = true;
+    }
+  }
+};
+
+// src/ledger.ts
+var Ledger = class _Ledger {
+  #backend;
+  constructor(backend) {
+    this.#backend = backend;
+  }
+  /** Which implementation is serving this instance. */
+  get backendKind() {
+    return this.#backend.kind;
+  }
+  /**
+   * Open a single-asset Ether ledger over an in-memory buffer (host tests).
+   */
+  static openEtherBuffer(config = DEFAULT_ETHER_CONFIG, options = {}) {
+    const maxAccounts = config.maxAccounts;
+    if (maxAccounts <= 0) {
+      throw new RangeError("maxAccounts must be positive");
+    }
+    return _Ledger.#openEther(
+      maxAccounts,
+      options,
+      () => NativeBackend.openEtherBuffer(maxAccounts)
+    );
+  }
+  /**
+   * Open a multi-asset buffer ledger; Phase 1 only exposes Ether helpers on top.
+   */
+  static openBuffer(config, options = {}) {
+    return _Ledger.openEtherBuffer(
+      {
+        memoryLength: config.memoryLength,
+        maxAccounts: config.maxAccounts
+      },
+      options
+    );
+  }
+  /**
+   * Open a single-asset Ether ledger on a file or block device.
+   * Inside the machine use {@link ACCOUNTS_DRIVE_PATH} (`/dev/pmem1`).
+   */
+  static openEtherFile(path, config = DEFAULT_ETHER_CONFIG, options = {}) {
+    const maxAccounts = config.maxAccounts;
+    const offset = config.offset ?? 0;
+    const memoryLength = config.memoryLength ?? ACCOUNTS_DRIVE_SIZE_4MIB;
+    if (maxAccounts <= 0) {
+      throw new RangeError("maxAccounts must be positive");
+    }
+    const prefer = options.backend ?? "auto";
+    if (prefer === "memory") {
+      return new _Ledger(MemoryBackend.openEther(maxAccounts));
+    }
+    const native = NativeBackend.openEtherFile(
+      path,
+      offset,
+      memoryLength,
+      maxAccounts
+    );
+    if (native) {
+      return new _Ledger(native);
+    }
+    if (prefer === "native") {
+      throw LedgerError.fromCode(
+        LedgerErrorCode.UNKNOWN,
+        "native libcma addon is not available; run npm run build:native"
+      );
+    }
+    return new _Ledger(MemoryBackend.openEther(maxAccounts));
+  }
+  /**
+   * File-backed multi-asset entry; Phase 1 routes to Ether single-asset helpers.
+   */
+  static openFile(path, config, options = {}) {
+    return _Ledger.openEtherFile(
+      path,
+      {
+        maxAccounts: config.maxAccounts,
+        offset: config.offset,
+        memoryLength: config.memoryLength
+      },
+      options
+    );
+  }
+  static #openEther(maxAccounts, options, openNative) {
+    const prefer = options.backend ?? "auto";
+    if (prefer === "memory") {
+      return new _Ledger(MemoryBackend.openEther(maxAccounts));
+    }
+    const native = openNative();
+    if (native) {
+      return new _Ledger(native);
+    }
+    if (prefer === "native") {
+      throw LedgerError.fromCode(
+        LedgerErrorCode.UNKNOWN,
+        "native libcma addon is not available; run npm run build:native"
+      );
+    }
+    return new _Ledger(MemoryBackend.openEther(maxAccounts));
+  }
+  depositEther(account, amount) {
+    this.#backend.depositEther(normalizeAddress(account), amount);
+  }
+  /**
+   * Credit from a packed EtherPortal advance payload.
+   * @returns decoded sender and value (exec layer data is ignored here)
+   */
+  creditEtherDeposit(payload) {
+    const { sender, value } = parseEtherPortalDeposit(payload);
+    this.depositEther(sender, value);
+    return { sender, value };
+  }
+  transferEther(from, to, amount) {
+    this.#backend.transferEther(
+      normalizeAddress(from),
+      normalizeAddress(to),
+      amount
+    );
+  }
+  /**
+   * Debit Ether. Does **not** emit a rollup voucher — the dApp must call
+   * `POST /voucher` or `@deroll/cmio.emitVoucher` separately.
+   */
+  withdrawEther(account, amount) {
+    assertAmount(amount);
+    this.#backend.withdrawEther(normalizeAddress(account), amount);
+  }
+  getEtherBalance(account) {
+    return this.#backend.getEtherBalance(normalizeAddress(account));
+  }
+  /** Alias matching Deroll naming. */
+  getBalance(account) {
+    return this.getEtherBalance(account);
+  }
+  close() {
+    this.#backend.close();
+  }
+};
+
+exports.ACCOUNTS_DRIVE_PATH = ACCOUNTS_DRIVE_PATH;
+exports.ACCOUNTS_DRIVE_SIZE_4MIB = ACCOUNTS_DRIVE_SIZE_4MIB;
+exports.ADDRESS_LENGTH = ADDRESS_LENGTH;
+exports.DEFAULT_ETHER_CONFIG = DEFAULT_ETHER_CONFIG;
+exports.LEDGER_MIN_MEM_LENGTH = LEDGER_MIN_MEM_LENGTH;
+exports.LOG2_MAX_NUM_OF_ACCOUNTS_DEFAULT = LOG2_MAX_NUM_OF_ACCOUNTS_DEFAULT;
+exports.Ledger = Ledger;
+exports.LedgerError = LedgerError;
+exports.LedgerErrorCode = LedgerErrorCode;
+exports.U256_LENGTH = U256_LENGTH;
+exports.isNativeAvailable = isNativeAvailable;
+exports.normalizeAddress = normalizeAddress;
+exports.parseEtherPortalDeposit = parseEtherPortalDeposit;
+exports.toBytes = toBytes;
+exports.toHex = toHex;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/lib/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts","../src/errors.ts","../src/bytes.ts","../src/memory-backend.ts","../src/native-backend.ts","../src/ledger.ts"],"names":["require","createRequire","join","dirname","fileURLToPath"],"mappings":"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","file":"index.cjs","sourcesContent":["/** 0x-prefixed hex string. Compatible with viem `Hex` / `Address`. */\nexport type Hex = `0x${string}`;\n\n/** EVM address as checksummed or lowercase 0x hex. */\nexport type Address = Hex;\n\n/** Bytes input accepted at API boundaries. */\nexport type BytesLike = Hex | Uint8Array;\n\nexport const ADDRESS_LENGTH = 20;\nexport const U256_LENGTH = 32;\n\n/** Default accounts-drive path inside the Cartesi Machine. */\nexport const ACCOUNTS_DRIVE_PATH = \"/dev/pmem1\";\n\n/**\n * 4 MiB = 2^17 account slots × 32-byte records (contracts v3 convention when\n * `log2_max_num_of_accounts = 17`).\n */\nexport const ACCOUNTS_DRIVE_SIZE_4MIB = 4_194_304;\n\nexport const LOG2_MAX_NUM_OF_ACCOUNTS_DEFAULT = 17;\n\n/** Minimum mem length required by libcma (`CMA_LEDGER_MIN_MEM_LENGTH`). */\nexport const LEDGER_MIN_MEM_LENGTH = 262_144;\n\nexport type LedgerMemoryMode = \"create-only\" | \"open-only\";\n\n/**\n * File-backed ledger config (machine: `/dev/pmem1`, or a host test file).\n * Sizes must be consistent with `cartesi.toml` `[withdrawal.config]`.\n */\nexport type LedgerFileConfig = {\n  mode?: LedgerMemoryMode;\n  offset?: number;\n  memoryLength: number;\n  maxAccounts: number;\n  maxAssets: number;\n  maxBalances: number;\n};\n\n/** Buffer-backed (non-persistent) ledger config for host tests. */\nexport type LedgerBufferConfig = {\n  memoryLength?: number;\n  maxAccounts: number;\n  maxAssets: number;\n  maxBalances: number;\n};\n\n/**\n * Single-asset Ether ledger config — maps to `cma_ledger_init_single_*`.\n * Preferred for Ether-only dApps.\n */\nexport type LedgerEtherConfig = {\n  memoryLength?: number;\n  /** Account capacity; typically `2 ** log2_max_num_of_accounts`. */\n  maxAccounts: number;\n};\n\nexport const DEFAULT_ETHER_CONFIG: Required<LedgerEtherConfig> = {\n  memoryLength: ACCOUNTS_DRIVE_SIZE_4MIB,\n  maxAccounts: 2 ** LOG2_MAX_NUM_OF_ACCOUNTS_DEFAULT,\n};\n\nexport type BackendKind = \"memory\" | \"native-mock\" | \"native-libcma\";\n","/** libcma-style error codes (see `include/libcma/ledger.h`). */\nexport const LedgerErrorCode = {\n  SUCCESS: 0,\n  UNKNOWN: -1001,\n  EXCEPTION: -1002,\n  INSUFFICIENT_FUNDS: -1003,\n  ACCOUNT_NOT_FOUND: -1004,\n  ASSET_NOT_FOUND: -1005,\n  BALANCE_NOT_FOUND: -1006,\n  SUPPLY_OVERFLOW: -1007,\n  BALANCE_OVERFLOW: -1008,\n  INVALID_ACCOUNT: -1009,\n  INSERTION_ERROR: -1010,\n  MAX_ASSETS_REACHED: -1011,\n  MAX_ACCOUNTS_REACHED: -1012,\n  MAX_BALANCES_REACHED: -1013,\n  ASSET_SUPPLY: -1014,\n  ACCOUNT_BALANCE: -1015,\n  REMOVE: -1016,\n} as const;\n\nexport type LedgerErrorCodeValue =\n  (typeof LedgerErrorCode)[keyof typeof LedgerErrorCode];\n\nconst CODE_NAMES: Record<number, string> = Object.fromEntries(\n  Object.entries(LedgerErrorCode).map(([k, v]) => [v, k]),\n);\n\nexport class LedgerError extends Error {\n  readonly name = \"LedgerError\";\n  readonly code: number;\n\n  constructor(code: number, message?: string) {\n    const label = CODE_NAMES[code] ?? \"UNKNOWN\";\n    super(message ?? `libcma ledger error ${label} (${code})`);\n    this.code = code;\n  }\n\n  static fromCode(code: number, detail?: string): LedgerError {\n    return new LedgerError(code, detail);\n  }\n}\n","import { ADDRESS_LENGTH, type Address, type BytesLike, type Hex } from \"./types.js\";\nimport { LedgerError, LedgerErrorCode } from \"./errors.js\";\n\nconst HEX_RE = /^0x[0-9a-fA-F]*$/;\n\nexport function isHex(value: string): value is Hex {\n  return HEX_RE.test(value) && value.length % 2 === 0;\n}\n\nexport function toBytes(value: BytesLike, name = \"value\"): Uint8Array {\n  if (value instanceof Uint8Array) {\n    return value;\n  }\n  if (typeof value !== \"string\" || !isHex(value)) {\n    throw new TypeError(`${name} must be a 0x-hex string or Uint8Array`);\n  }\n  const hex = value.slice(2);\n  if (hex.length % 2 !== 0) {\n    throw new TypeError(`${name} hex length must be even`);\n  }\n  const out = new Uint8Array(hex.length / 2);\n  for (let i = 0; i < out.length; i++) {\n    out[i] = Number.parseInt(hex.slice(i * 2, i * 2 + 2), 16);\n  }\n  return out;\n}\n\nexport function toHex(bytes: Uint8Array): Hex {\n  let s = \"0x\";\n  for (const b of bytes) {\n    s += b.toString(16).padStart(2, \"0\");\n  }\n  return s as Hex;\n}\n\n/** Normalize to lowercase 0x-address (20 bytes). */\nexport function normalizeAddress(address: BytesLike): Address {\n  const bytes = toBytes(address, \"address\");\n  if (bytes.length !== ADDRESS_LENGTH) {\n    throw new TypeError(\n      `address must be ${ADDRESS_LENGTH} bytes, got ${bytes.length}`,\n    );\n  }\n  return toHex(bytes).toLowerCase() as Address;\n}\n\nexport function assertAmount(amount: bigint, name = \"amount\"): void {\n  if (typeof amount !== \"bigint\") {\n    throw new TypeError(`${name} must be a bigint`);\n  }\n  if (amount < 0n) {\n    throw new RangeError(`${name} must be non-negative`);\n  }\n}\n\n/**\n * Decode packed EtherPortal deposit payload (Rollups v2):\n * `sender (20) || value (32) || execLayerData?`\n */\nexport function parseEtherPortalDeposit(payload: BytesLike): {\n  sender: Address;\n  value: bigint;\n  execLayerData?: Hex;\n} {\n  const bytes = toBytes(payload, \"payload\");\n  if (bytes.length < ADDRESS_LENGTH + 32) {\n    throw LedgerError.fromCode(\n      LedgerErrorCode.UNKNOWN,\n      `ether deposit payload too short: ${bytes.length} bytes`,\n    );\n  }\n  const sender = normalizeAddress(bytes.subarray(0, ADDRESS_LENGTH));\n  let value = 0n;\n  for (let i = 0; i < 32; i++) {\n    value = (value << 8n) | BigInt(bytes[ADDRESS_LENGTH + i]!);\n  }\n  const rest = bytes.subarray(ADDRESS_LENGTH + 32);\n  if (rest.length === 0) {\n    return { sender, value };\n  }\n  return { sender, value, execLayerData: toHex(rest) };\n}\n","import type { Address } from \"./types.js\";\nimport { LedgerError, LedgerErrorCode } from \"./errors.js\";\nimport { assertAmount, normalizeAddress } from \"./bytes.js\";\n\n/**\n * Internal ledger operations shared by memory and native backends.\n *\n * Host `MemoryBackend` is **behavioral only** — not proof-identical to C++ libcma.\n * Production / emergency-withdrawal must use the native addon linked to real libcma.\n */\nexport interface LedgerBackend {\n  readonly kind: \"memory\" | \"native-mock\" | \"native-libcma\";\n  depositEther(account: Address, amount: bigint): void;\n  transferEther(from: Address, to: Address, amount: bigint): void;\n  withdrawEther(account: Address, amount: bigint): void;\n  getEtherBalance(account: Address): bigint;\n  close(): void;\n}\n\n/**\n * In-process Ether ledger for host unit tests and local development.\n *\n * NOT suitable for emergency-withdrawal proofs.\n */\nexport class MemoryBackend implements LedgerBackend {\n  readonly kind = \"memory\" as const;\n  #balances = new Map<string, bigint>();\n  #closed = false;\n  readonly maxAccounts: number;\n\n  constructor(options: { maxAccounts: number }) {\n    this.maxAccounts = options.maxAccounts;\n  }\n\n  static openEther(maxAccounts: number): MemoryBackend {\n    return new MemoryBackend({ maxAccounts });\n  }\n\n  #ensureOpen(): void {\n    if (this.#closed) {\n      throw LedgerError.fromCode(\n        LedgerErrorCode.UNKNOWN,\n        \"ledger is closed\",\n      );\n    }\n  }\n\n  #get(key: string): bigint {\n    return this.#balances.get(key) ?? 0n;\n  }\n\n  #set(key: string, value: bigint): void {\n    if (value === 0n) {\n      this.#balances.delete(key);\n    } else {\n      this.#balances.set(key, value);\n    }\n  }\n\n  #ensureCapacityForNew(key: string): void {\n    if (!this.#balances.has(key) && this.#balances.size >= this.maxAccounts) {\n      throw LedgerError.fromCode(LedgerErrorCode.MAX_ACCOUNTS_REACHED);\n    }\n  }\n\n  depositEther(account: Address, amount: bigint): void {\n    this.#ensureOpen();\n    assertAmount(amount);\n    if (amount === 0n) {\n      return;\n    }\n    const key = normalizeAddress(account);\n    this.#ensureCapacityForNew(key);\n    this.#set(key, this.#get(key) + amount);\n  }\n\n  transferEther(from: Address, to: Address, amount: bigint): void {\n    this.#ensureOpen();\n    assertAmount(amount);\n    if (amount === 0n) {\n      return;\n    }\n    const fromKey = normalizeAddress(from);\n    const toKey = normalizeAddress(to);\n    const balance = this.#get(fromKey);\n    if (balance < amount) {\n      throw LedgerError.fromCode(\n        LedgerErrorCode.INSUFFICIENT_FUNDS,\n        `insufficient balance of ${fromKey}`,\n      );\n    }\n    if (fromKey !== toKey) {\n      this.#ensureCapacityForNew(toKey);\n    }\n    this.#set(fromKey, balance - amount);\n    this.#set(toKey, this.#get(toKey) + amount);\n  }\n\n  withdrawEther(account: Address, amount: bigint): void {\n    this.#ensureOpen();\n    assertAmount(amount);\n    if (amount === 0n) {\n      return;\n    }\n    const key = normalizeAddress(account);\n    const balance = this.#get(key);\n    if (balance < amount) {\n      throw LedgerError.fromCode(\n        LedgerErrorCode.INSUFFICIENT_FUNDS,\n        `insufficient balance of ${key}: ${amount} > ${balance}`,\n      );\n    }\n    this.#set(key, balance - amount);\n  }\n\n  getEtherBalance(account: Address): bigint {\n    this.#ensureOpen();\n    return this.#get(normalizeAddress(account));\n  }\n\n  close(): void {\n    this.#closed = true;\n    this.#balances.clear();\n  }\n}\n","import { createRequire } from \"node:module\";\nimport { dirname, join } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nimport type { Address } from \"./types.js\";\nimport type { LedgerBackend } from \"./memory-backend.js\";\nimport { LedgerError, LedgerErrorCode } from \"./errors.js\";\nimport { assertAmount, normalizeAddress, toBytes } from \"./bytes.js\";\n\ntype NativeLedgerHandle = {\n  depositEther(account: Uint8Array, amount: bigint): void;\n  transferEther(from: Uint8Array, to: Uint8Array, amount: bigint): void;\n  withdrawEther(account: Uint8Array, amount: bigint): void;\n  getEtherBalance(account: Uint8Array): bigint;\n  close(): void;\n  readonly kind: string;\n};\n\ntype NativeBinding = {\n  openEtherBuffer(maxAccounts: number): NativeLedgerHandle;\n  openEtherFile(\n    path: string,\n    offset: number,\n    memoryLength: number,\n    maxAccounts: number,\n  ): NativeLedgerHandle;\n};\n\nlet cached: NativeBinding | null | undefined;\n\nfunction tryLoadNative(): NativeBinding | null {\n  if (cached !== undefined) {\n    return cached;\n  }\n  try {\n    const require = createRequire(import.meta.url);\n    const root = join(dirname(fileURLToPath(import.meta.url)), \"..\");\n    const binding = require(\"node-gyp-build\")(root) as NativeBinding;\n    cached = binding;\n    return binding;\n  } catch {\n    cached = null;\n    return null;\n  }\n}\n\nexport function isNativeAvailable(): boolean {\n  return tryLoadNative() !== null;\n}\n\nexport class NativeBackend implements LedgerBackend {\n  readonly kind: \"native-mock\" | \"native-libcma\";\n  #handle: NativeLedgerHandle;\n  #closed = false;\n\n  private constructor(handle: NativeLedgerHandle) {\n    this.#handle = handle;\n    this.kind =\n      handle.kind === \"native-libcma\" ? \"native-libcma\" : \"native-mock\";\n  }\n\n  static openEtherBuffer(maxAccounts: number): NativeBackend | null {\n    const native = tryLoadNative();\n    if (!native) {\n      return null;\n    }\n    return new NativeBackend(native.openEtherBuffer(maxAccounts));\n  }\n\n  static openEtherFile(\n    path: string,\n    offset: number,\n    memoryLength: number,\n    maxAccounts: number,\n  ): NativeBackend | null {\n    const native = tryLoadNative();\n    if (!native) {\n      return null;\n    }\n    return new NativeBackend(\n      native.openEtherFile(path, offset, memoryLength, maxAccounts),\n    );\n  }\n\n  #ensureOpen(): void {\n    if (this.#closed) {\n      throw LedgerError.fromCode(LedgerErrorCode.UNKNOWN, \"ledger is closed\");\n    }\n  }\n\n  #addr(account: Address): Uint8Array {\n    return toBytes(normalizeAddress(account));\n  }\n\n  depositEther(account: Address, amount: bigint): void {\n    this.#ensureOpen();\n    assertAmount(amount);\n    this.#handle.depositEther(this.#addr(account), amount);\n  }\n\n  transferEther(from: Address, to: Address, amount: bigint): void {\n    this.#ensureOpen();\n    assertAmount(amount);\n    this.#handle.transferEther(this.#addr(from), this.#addr(to), amount);\n  }\n\n  withdrawEther(account: Address, amount: bigint): void {\n    this.#ensureOpen();\n    assertAmount(amount);\n    this.#handle.withdrawEther(this.#addr(account), amount);\n  }\n\n  getEtherBalance(account: Address): bigint {\n    this.#ensureOpen();\n    return this.#handle.getEtherBalance(this.#addr(account));\n  }\n\n  close(): void {\n    if (!this.#closed) {\n      this.#handle.close();\n      this.#closed = true;\n    }\n  }\n}\n","import type { Address, BackendKind, LedgerBufferConfig, LedgerEtherConfig, LedgerFileConfig } from \"./types.js\";\nimport {\n  ACCOUNTS_DRIVE_PATH,\n  ACCOUNTS_DRIVE_SIZE_4MIB,\n  DEFAULT_ETHER_CONFIG,\n  LOG2_MAX_NUM_OF_ACCOUNTS_DEFAULT,\n} from \"./types.js\";\nimport { LedgerError, LedgerErrorCode } from \"./errors.js\";\nimport { assertAmount, normalizeAddress, parseEtherPortalDeposit } from \"./bytes.js\";\nimport { MemoryBackend, type LedgerBackend } from \"./memory-backend.js\";\nimport { NativeBackend, isNativeAvailable } from \"./native-backend.js\";\n\nexport type OpenLedgerOptions = {\n  /**\n   * Prefer native addon when available.\n   * - `\"auto\"` (default): native if built, else memory backend\n   * - `\"memory\"`: force host memory backend (never proof-identical)\n   * - `\"native\"`: require native addon or throw\n   */\n  backend?: \"auto\" | \"memory\" | \"native\";\n};\n\n/**\n * Proveable-oriented asset ledger (Ether MVP).\n *\n * On the Cartesi Machine, open the accounts drive via {@link Ledger.openEtherFile}\n * with path {@link ACCOUNTS_DRIVE_PATH}. On the host, {@link Ledger.openEtherBuffer}\n * uses the native mock when built, otherwise the TypeScript memory backend.\n */\nexport class Ledger {\n  #backend: LedgerBackend;\n\n  private constructor(backend: LedgerBackend) {\n    this.#backend = backend;\n  }\n\n  /** Which implementation is serving this instance. */\n  get backendKind(): BackendKind {\n    return this.#backend.kind;\n  }\n\n  /**\n   * Open a single-asset Ether ledger over an in-memory buffer (host tests).\n   */\n  static openEtherBuffer(\n    config: LedgerEtherConfig = DEFAULT_ETHER_CONFIG,\n    options: OpenLedgerOptions = {},\n  ): Ledger {\n    const maxAccounts = config.maxAccounts;\n    if (maxAccounts <= 0) {\n      throw new RangeError(\"maxAccounts must be positive\");\n    }\n    return Ledger.#openEther(maxAccounts, options, () =>\n      NativeBackend.openEtherBuffer(maxAccounts),\n    );\n  }\n\n  /**\n   * Open a multi-asset buffer ledger; Phase 1 only exposes Ether helpers on top.\n   */\n  static openBuffer(\n    config: LedgerBufferConfig,\n    options: OpenLedgerOptions = {},\n  ): Ledger {\n    return Ledger.openEtherBuffer(\n      {\n        memoryLength: config.memoryLength,\n        maxAccounts: config.maxAccounts,\n      },\n      options,\n    );\n  }\n\n  /**\n   * Open a single-asset Ether ledger on a file or block device.\n   * Inside the machine use {@link ACCOUNTS_DRIVE_PATH} (`/dev/pmem1`).\n   */\n  static openEtherFile(\n    path: string,\n    config: LedgerEtherConfig & { offset?: number; memoryLength?: number } = DEFAULT_ETHER_CONFIG,\n    options: OpenLedgerOptions = {},\n  ): Ledger {\n    const maxAccounts = config.maxAccounts;\n    const offset = config.offset ?? 0;\n    const memoryLength = config.memoryLength ?? ACCOUNTS_DRIVE_SIZE_4MIB;\n    if (maxAccounts <= 0) {\n      throw new RangeError(\"maxAccounts must be positive\");\n    }\n\n    const prefer = options.backend ?? \"auto\";\n    if (prefer === \"memory\") {\n      // Memory backend cannot mmap a drive — still useful for API dry-runs.\n      return new Ledger(MemoryBackend.openEther(maxAccounts));\n    }\n\n    const native = NativeBackend.openEtherFile(\n      path,\n      offset,\n      memoryLength,\n      maxAccounts,\n    );\n    if (native) {\n      return new Ledger(native);\n    }\n    if (prefer === \"native\") {\n      throw LedgerError.fromCode(\n        LedgerErrorCode.UNKNOWN,\n        \"native libcma addon is not available; run npm run build:native\",\n      );\n    }\n    // Host fallback: memory (not drive-backed).\n    return new Ledger(MemoryBackend.openEther(maxAccounts));\n  }\n\n  /**\n   * File-backed multi-asset entry; Phase 1 routes to Ether single-asset helpers.\n   */\n  static openFile(\n    path: string,\n    config: LedgerFileConfig,\n    options: OpenLedgerOptions = {},\n  ): Ledger {\n    return Ledger.openEtherFile(\n      path,\n      {\n        maxAccounts: config.maxAccounts,\n        offset: config.offset,\n        memoryLength: config.memoryLength,\n      },\n      options,\n    );\n  }\n\n  static #openEther(\n    maxAccounts: number,\n    options: OpenLedgerOptions,\n    openNative: () => NativeBackend | null,\n  ): Ledger {\n    const prefer = options.backend ?? \"auto\";\n    if (prefer === \"memory\") {\n      return new Ledger(MemoryBackend.openEther(maxAccounts));\n    }\n    const native = openNative();\n    if (native) {\n      return new Ledger(native);\n    }\n    if (prefer === \"native\") {\n      throw LedgerError.fromCode(\n        LedgerErrorCode.UNKNOWN,\n        \"native libcma addon is not available; run npm run build:native\",\n      );\n    }\n    return new Ledger(MemoryBackend.openEther(maxAccounts));\n  }\n\n  depositEther(account: Address, amount: bigint): void {\n    this.#backend.depositEther(normalizeAddress(account), amount);\n  }\n\n  /**\n   * Credit from a packed EtherPortal advance payload.\n   * @returns decoded sender and value (exec layer data is ignored here)\n   */\n  creditEtherDeposit(payload: `0x${string}` | Uint8Array): {\n    sender: Address;\n    value: bigint;\n  } {\n    const { sender, value } = parseEtherPortalDeposit(payload);\n    this.depositEther(sender, value);\n    return { sender, value };\n  }\n\n  transferEther(from: Address, to: Address, amount: bigint): void {\n    this.#backend.transferEther(\n      normalizeAddress(from),\n      normalizeAddress(to),\n      amount,\n    );\n  }\n\n  /**\n   * Debit Ether. Does **not** emit a rollup voucher — the dApp must call\n   * `POST /voucher` or `@deroll/cmio.emitVoucher` separately.\n   */\n  withdrawEther(account: Address, amount: bigint): void {\n    assertAmount(amount);\n    this.#backend.withdrawEther(normalizeAddress(account), amount);\n  }\n\n  getEtherBalance(account: Address): bigint {\n    return this.#backend.getEtherBalance(normalizeAddress(account));\n  }\n\n  /** Alias matching Deroll naming. */\n  getBalance(account: Address): bigint {\n    return this.getEtherBalance(account);\n  }\n\n  close(): void {\n    this.#backend.close();\n  }\n}\n\nexport {\n  ACCOUNTS_DRIVE_PATH,\n  ACCOUNTS_DRIVE_SIZE_4MIB,\n  DEFAULT_ETHER_CONFIG,\n  LOG2_MAX_NUM_OF_ACCOUNTS_DEFAULT,\n  isNativeAvailable,\n};\n"]}

package/lib/index.d.cts

@@ -0,0 +1,156 @@
+/** 0x-prefixed hex string. Compatible with viem `Hex` / `Address`. */
+type Hex = `0x${string}`;
+/** EVM address as checksummed or lowercase 0x hex. */
+type Address = Hex;
+/** Bytes input accepted at API boundaries. */
+type BytesLike = Hex | Uint8Array;
+declare const ADDRESS_LENGTH = 20;
+declare const U256_LENGTH = 32;
+/** Default accounts-drive path inside the Cartesi Machine. */
+declare const ACCOUNTS_DRIVE_PATH = "/dev/pmem1";
+/**
+ * 4 MiB = 2^17 account slots × 32-byte records (contracts v3 convention when
+ * `log2_max_num_of_accounts = 17`).
+ */
+declare const ACCOUNTS_DRIVE_SIZE_4MIB = 4194304;
+declare const LOG2_MAX_NUM_OF_ACCOUNTS_DEFAULT = 17;
+/** Minimum mem length required by libcma (`CMA_LEDGER_MIN_MEM_LENGTH`). */
+declare const LEDGER_MIN_MEM_LENGTH = 262144;
+type LedgerMemoryMode = "create-only" | "open-only";
+/**
+ * File-backed ledger config (machine: `/dev/pmem1`, or a host test file).
+ * Sizes must be consistent with `cartesi.toml` `[withdrawal.config]`.
+ */
+type LedgerFileConfig = {
+    mode?: LedgerMemoryMode;
+    offset?: number;
+    memoryLength: number;
+    maxAccounts: number;
+    maxAssets: number;
+    maxBalances: number;
+};
+/** Buffer-backed (non-persistent) ledger config for host tests. */
+type LedgerBufferConfig = {
+    memoryLength?: number;
+    maxAccounts: number;
+    maxAssets: number;
+    maxBalances: number;
+};
+/**
+ * Single-asset Ether ledger config — maps to `cma_ledger_init_single_*`.
+ * Preferred for Ether-only dApps.
+ */
+type LedgerEtherConfig = {
+    memoryLength?: number;
+    /** Account capacity; typically `2 ** log2_max_num_of_accounts`. */
+    maxAccounts: number;
+};
+declare const DEFAULT_ETHER_CONFIG: Required<LedgerEtherConfig>;
+type BackendKind = "memory" | "native-mock" | "native-libcma";
+
+declare function isNativeAvailable(): boolean;
+
+type OpenLedgerOptions = {
+    /**
+     * Prefer native addon when available.
+     * - `"auto"` (default): native if built, else memory backend
+     * - `"memory"`: force host memory backend (never proof-identical)
+     * - `"native"`: require native addon or throw
+     */
+    backend?: "auto" | "memory" | "native";
+};
+/**
+ * Proveable-oriented asset ledger (Ether MVP).
+ *
+ * On the Cartesi Machine, open the accounts drive via {@link Ledger.openEtherFile}
+ * with path {@link ACCOUNTS_DRIVE_PATH}. On the host, {@link Ledger.openEtherBuffer}
+ * uses the native mock when built, otherwise the TypeScript memory backend.
+ */
+declare class Ledger {
+    #private;
+    private constructor();
+    /** Which implementation is serving this instance. */
+    get backendKind(): BackendKind;
+    /**
+     * Open a single-asset Ether ledger over an in-memory buffer (host tests).
+     */
+    static openEtherBuffer(config?: LedgerEtherConfig, options?: OpenLedgerOptions): Ledger;
+    /**
+     * Open a multi-asset buffer ledger; Phase 1 only exposes Ether helpers on top.
+     */
+    static openBuffer(config: LedgerBufferConfig, options?: OpenLedgerOptions): Ledger;
+    /**
+     * Open a single-asset Ether ledger on a file or block device.
+     * Inside the machine use {@link ACCOUNTS_DRIVE_PATH} (`/dev/pmem1`).
+     */
+    static openEtherFile(path: string, config?: LedgerEtherConfig & {
+        offset?: number;
+        memoryLength?: number;
+    }, options?: OpenLedgerOptions): Ledger;
+    /**
+     * File-backed multi-asset entry; Phase 1 routes to Ether single-asset helpers.
+     */
+    static openFile(path: string, config: LedgerFileConfig, options?: OpenLedgerOptions): Ledger;
+    depositEther(account: Address, amount: bigint): void;
+    /**
+     * Credit from a packed EtherPortal advance payload.
+     * @returns decoded sender and value (exec layer data is ignored here)
+     */
+    creditEtherDeposit(payload: `0x${string}` | Uint8Array): {
+        sender: Address;
+        value: bigint;
+    };
+    transferEther(from: Address, to: Address, amount: bigint): void;
+    /**
+     * Debit Ether. Does **not** emit a rollup voucher — the dApp must call
+     * `POST /voucher` or `@deroll/cmio.emitVoucher` separately.
+     */
+    withdrawEther(account: Address, amount: bigint): void;
+    getEtherBalance(account: Address): bigint;
+    /** Alias matching Deroll naming. */
+    getBalance(account: Address): bigint;
+    close(): void;
+}
+
+/** libcma-style error codes (see `include/libcma/ledger.h`). */
+declare const LedgerErrorCode: {
+    readonly SUCCESS: 0;
+    readonly UNKNOWN: -1001;
+    readonly EXCEPTION: -1002;
+    readonly INSUFFICIENT_FUNDS: -1003;
+    readonly ACCOUNT_NOT_FOUND: -1004;
+    readonly ASSET_NOT_FOUND: -1005;
+    readonly BALANCE_NOT_FOUND: -1006;
+    readonly SUPPLY_OVERFLOW: -1007;
+    readonly BALANCE_OVERFLOW: -1008;
+    readonly INVALID_ACCOUNT: -1009;
+    readonly INSERTION_ERROR: -1010;
+    readonly MAX_ASSETS_REACHED: -1011;
+    readonly MAX_ACCOUNTS_REACHED: -1012;
+    readonly MAX_BALANCES_REACHED: -1013;
+    readonly ASSET_SUPPLY: -1014;
+    readonly ACCOUNT_BALANCE: -1015;
+    readonly REMOVE: -1016;
+};
+declare class LedgerError extends Error {
+    readonly name = "LedgerError";
+    readonly code: number;
+    constructor(code: number, message?: string);
+    static fromCode(code: number, detail?: string): LedgerError;
+}
+
+declare function toBytes(value: BytesLike, name?: string): Uint8Array;
+declare function toHex(bytes: Uint8Array): Hex;
+/** Normalize to lowercase 0x-address (20 bytes). */
+declare function normalizeAddress(address: BytesLike): Address;
+/**
+ * Decode packed EtherPortal deposit payload (Rollups v2):
+ * `sender (20) || value (32) || execLayerData?`
+ */
+declare function parseEtherPortalDeposit(payload: BytesLike): {
+    sender: Address;
+    value: bigint;
+    execLayerData?: Hex;
+};
+
+export { ACCOUNTS_DRIVE_PATH, ACCOUNTS_DRIVE_SIZE_4MIB, ADDRESS_LENGTH, type Address, type BackendKind, type BytesLike, DEFAULT_ETHER_CONFIG, type Hex, LEDGER_MIN_MEM_LENGTH, LOG2_MAX_NUM_OF_ACCOUNTS_DEFAULT, Ledger, type LedgerBufferConfig, LedgerError, LedgerErrorCode, type LedgerEtherConfig, type LedgerFileConfig, type LedgerMemoryMode, type OpenLedgerOptions, U256_LENGTH, isNativeAvailable, normalizeAddress, parseEtherPortalDeposit, toBytes, toHex };