@automerge/sedimentree 0.8.2 → 0.9.0

package/dist/wasm_bindgen/nodejs/sedimentree_wasm.d.ts

@@ -7,23 +7,23 @@ export interface SedimentreeStorage {
     loadAllSedimentreeIds(): Promise<SedimentreeId[]>;
 
     // Compound storage for commits (signed data + blob stored together)
-    saveCommit(sedimentreeId: SedimentreeId, digest: Digest, signedCommit: SignedLooseCommit, blob: Uint8Array): Promise<void>;
-    loadCommit(sedimentreeId: SedimentreeId, digest: Digest): Promise<CommitWithBlob | null>;
-    listCommitDigests(sedimentreeId: SedimentreeId): Promise<Digest[]>;
+    saveCommit(sedimentreeId: SedimentreeId, commitId: CommitId, signedCommit: SignedLooseCommit, blob: Uint8Array): Promise<void>;
+    loadCommit(sedimentreeId: SedimentreeId, commitId: CommitId): Promise<CommitWithBlob | null>;
+    listCommitIds(sedimentreeId: SedimentreeId): Promise<CommitId[]>;
     loadAllCommits(sedimentreeId: SedimentreeId): Promise<CommitWithBlob[]>;
-    deleteCommit(sedimentreeId: SedimentreeId, digest: Digest): Promise<void>;
+    deleteCommit(sedimentreeId: SedimentreeId, commitId: CommitId): Promise<void>;
     deleteAllCommits(sedimentreeId: SedimentreeId): Promise<void>;
 
     // Compound storage for fragments (signed data + blob stored together)
-    saveFragment(sedimentreeId: SedimentreeId, digest: Digest, signedFragment: SignedFragment, blob: Uint8Array): Promise<void>;
-    loadFragment(sedimentreeId: SedimentreeId, digest: Digest): Promise<FragmentWithBlob | null>;
-    listFragmentDigests(sedimentreeId: SedimentreeId): Promise<Digest[]>;
+    saveFragment(sedimentreeId: SedimentreeId, fragmentHead: CommitId, signedFragment: SignedFragment, blob: Uint8Array): Promise<void>;
+    loadFragment(sedimentreeId: SedimentreeId, fragmentHead: CommitId): Promise<FragmentWithBlob | null>;
+    listFragmentIds(sedimentreeId: SedimentreeId): Promise<CommitId[]>;
     loadAllFragments(sedimentreeId: SedimentreeId): Promise<FragmentWithBlob[]>;
-    deleteFragment(sedimentreeId: SedimentreeId, digest: Digest): Promise<void>;
+    deleteFragment(sedimentreeId: SedimentreeId, fragmentHead: CommitId): Promise<void>;
     deleteAllFragments(sedimentreeId: SedimentreeId): Promise<void>;
 
     // Batch save: write all commits + fragments in a single storage transaction.
-    saveBatchAll(sedimentreeId: SedimentreeId, commits: Array<{digest: Digest, signedCommit: SignedLooseCommit, blob: Uint8Array}>, fragments: Array<{digest: Digest, signedFragment: SignedFragment, blob: Uint8Array}>): Promise<number>;
+    saveBatchAll(sedimentreeId: SedimentreeId, commits: Array<{commitId: CommitId, signedCommit: SignedLooseCommit, blob: Uint8Array}>, fragments: Array<{fragmentHead: CommitId, signedFragment: SignedFragment, blob: Uint8Array}>): Promise<number>;
 }
 
 
@@ -55,6 +55,63 @@ export class BlobMeta {
     readonly sizeBytes: bigint;
 }
 
+/**
+ * A user-supplied opaque identifier for a loose commit.
+ *
+ * Unlike [`Digest`](crate::digest::WasmDigest), which is a content hash
+ * computed by the system, `CommitId` is provided by the caller at construction
+ * time. This is the identity used for DAG traversal, fragment boundaries,
+ * and sync.
+ */
+export class CommitId {
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * Upcasts; to the JS-import type for [`WasmCommitId`].
+     */
+    __wasm_refgen_toWasmCommitId(): CommitId;
+    /**
+     * Creates a new commit identifier from its Base58 string representation.
+     *
+     * # Errors
+     *
+     * Returns an error if the string cannot be decoded or is not 32 bytes.
+     */
+    static fromBase58(s: string): CommitId;
+    /**
+     * Creates a new commit identifier from its byte representation.
+     *
+     * # Errors
+     *
+     * Returns an error if the byte slice is not exactly 32 bytes.
+     */
+    static fromBytes(bytes: Uint8Array): CommitId;
+    /**
+     * Creates a new commit identifier from its hexadecimal string representation.
+     *
+     * # Errors
+     *
+     * Returns an error if the string is not valid hex or not 32 bytes.
+     */
+    static fromHexString(s: string): CommitId;
+    /**
+     * Creates a new commit identifier from its byte representation.
+     *
+     * # Errors
+     *
+     * Returns an error if the byte slice is not exactly 32 bytes.
+     */
+    constructor(bytes: Uint8Array);
+    /**
+     * Returns the byte representation of the commit identifier.
+     */
+    toBytes(): Uint8Array;
+    /**
+     * Returns the hexadecimal string representation.
+     */
+    toHexString(): string;
+}
+
 /**
  * A commit stored with its associated blob.
  */
@@ -175,19 +232,19 @@ export class Fragment {
     /**
      * Create a new fragment from the given sedimentree ID, head, boundary, checkpoints, and blob metadata.
      */
-    constructor(sedimentree_id: SedimentreeId, head: Digest, boundary: Digest[], checkpoints: Digest[], blob_meta: BlobMeta);
+    constructor(sedimentree_id: SedimentreeId, head: CommitId, boundary: CommitId[], checkpoints: CommitId[], blob_meta: BlobMeta);
     /**
      * Get the blob metadata of the fragment.
      */
     readonly blobMeta: BlobMeta;
     /**
-     * Get the boundary digests of the fragment.
+     * Get the boundary commit identifiers of the fragment.
      */
-    readonly boundary: Digest[];
+    readonly boundary: CommitId[];
     /**
-     * Get the head digest of the fragment.
+     * Get the head commit identifier of the fragment.
      */
-    readonly head: Digest;
+    readonly head: CommitId;
 }
 
 /**
@@ -235,21 +292,25 @@ export class LooseCommit {
      */
     __wasm_refgen_toWasmLooseCommit(): LooseCommit;
     /**
-     * Create a new `LooseCommit` from the given sedimentree ID, parents, and blob metadata.
+     * Create a new `LooseCommit` from the given sedimentree ID, head, parents, and blob metadata.
      */
-    constructor(sedimentree_id: SedimentreeId, parents: Digest[], blob_meta: BlobMeta);
+    constructor(sedimentree_id: SedimentreeId, head: CommitId, parents: CommitId[], blob_meta: BlobMeta);
     /**
      * Get the blob metadata of the commit.
      */
     readonly blobMeta: BlobMeta;
     /**
-     * Get the digest of the commit.
+     * Get the commit's head identifier.
+     */
+    readonly commitId: CommitId;
+    /**
+     * Get the digest of the commit (content hash).
      */
     readonly digest: Digest;
     /**
-     * Get the parent digests of the commit.
+     * Get the parent commit identifiers.
      */
-    readonly parents: Digest[];
+    readonly parents: CommitId[];
 }
 
 /**
@@ -269,25 +330,25 @@ export class MemoryStorage {
      */
     deleteAllFragments(sedimentree_id: SedimentreeId): Promise<any>;
     /**
-     * Delete a commit by digest.
+     * Delete a single commit by its ID.
      */
-    deleteCommit(sedimentree_id: SedimentreeId, digest: Digest): Promise<any>;
+    deleteCommit(sedimentree_id: SedimentreeId, commit_id: CommitId): Promise<any>;
     /**
-     * Delete a fragment by digest.
+     * Delete a fragment by its identifier.
      */
-    deleteFragment(sedimentree_id: SedimentreeId, digest: Digest): Promise<any>;
+    deleteFragment(sedimentree_id: SedimentreeId, fragment_head: CommitId): Promise<any>;
     /**
      * Delete a sedimentree ID.
      */
     deleteSedimentreeId(sedimentree_id: SedimentreeId): Promise<any>;
     /**
-     * List all commit digests for a sedimentree.
+     * List all commit IDs for a sedimentree.
      */
-    listCommitDigests(sedimentree_id: SedimentreeId): Promise<any>;
+    listCommitIds(sedimentree_id: SedimentreeId): Promise<any>;
     /**
-     * List all fragment digests for a sedimentree.
+     * List all fragment IDs for a sedimentree.
      */
-    listFragmentDigests(sedimentree_id: SedimentreeId): Promise<any>;
+    listFragmentIds(sedimentree_id: SedimentreeId): Promise<any>;
     /**
      * Load all commits for a sedimentree, returning `CommitWithBlob[]`.
      */
@@ -301,25 +362,38 @@ export class MemoryStorage {
      */
     loadAllSedimentreeIds(): Promise<any>;
     /**
-     * Load a commit by digest, returning `CommitWithBlob` or null.
+     * Load a single commit by its ID, returning `CommitWithBlob` or null.
      */
-    loadCommit(sedimentree_id: SedimentreeId, digest: Digest): Promise<any>;
+    loadCommit(sedimentree_id: SedimentreeId, commit_id: CommitId): Promise<any>;
     /**
-     * Load a fragment by digest, returning `FragmentWithBlob` or null.
+     * Load a fragment by its identifier, returning `FragmentWithBlob` or null.
      */
-    loadFragment(sedimentree_id: SedimentreeId, digest: Digest): Promise<any>;
+    loadFragment(sedimentree_id: SedimentreeId, fragment_head: CommitId): Promise<any>;
     /**
      * Create a new in-memory storage instance.
      */
     constructor();
+    /**
+     * Save commits and fragments in a single batch.
+     */
+    saveBatchAll(sedimentree_id: SedimentreeId, commits: Array<any>, fragments: Array<any>): Promise<any>;
     /**
      * Save a commit with its blob.
+     *
+     * The `commit_id` parameter must match the `head()` embedded in
+     * the signed commit payload. Returns an error if they differ.
+     *
+     * # Errors
+     *
+     * Returns a JS error if:
+     * - The signed payload cannot be decoded
+     * - The `commit_id` does not match the embedded `head()`
      */
-    saveCommit(sedimentree_id: SedimentreeId, _digest: Digest, signed_commit: SignedLooseCommit, blob: Uint8Array): Promise<any>;
+    saveCommit(sedimentree_id: SedimentreeId, commit_id: CommitId, signed_commit: SignedLooseCommit, blob: Uint8Array): Promise<any>;
     /**
      * Save a fragment with its blob.
      */
-    saveFragment(sedimentree_id: SedimentreeId, _digest: Digest, signed_fragment: SignedFragment, blob: Uint8Array): Promise<any>;
+    saveFragment(sedimentree_id: SedimentreeId, _fragment_head: CommitId, signed_fragment: SignedFragment, blob: Uint8Array): Promise<any>;
     /**
      * Save a sedimentree ID.
      */

package/dist/wasm_bindgen/nodejs/sedimentree_wasm_bg.wasm.d.ts

@@ -1,18 +1,22 @@
 /* tslint:disable */
 /* eslint-disable */
 export const memory: WebAssembly.Memory;
+export const __wbg_commitid_free: (a: number, b: number) => void;
+export const commitid_fromBytes: (a: number, b: number) => [number, number, number];
+export const commitid_fromBase58: (a: number, b: number) => [number, number, number];
+export const commitid_fromHexString: (a: number, b: number) => [number, number, number];
+export const commitid_toBytes: (a: number) => [number, number];
+export const commitid_toHexString: (a: number) => [number, number];
+export const commitid___wasm_refgen_toWasmCommitId: (a: number) => number;
 export const __wbg_depth_free: (a: number, b: number) => void;
 export const depth_new: (a: any) => [number, number, number];
 export const depth_value: (a: number) => number;
 export const depth___subduction_castToDepth: (a: number) => number;
-export const __wbg_digest_free: (a: number, b: number) => void;
 export const digest_new: (a: number, b: number) => [number, number, number];
 export const digest_fromBytes: (a: number, b: number) => [number, number, number];
 export const digest_fromBase58: (a: number, b: number) => [number, number, number];
-export const digest_toBytes: (a: number) => [number, number];
 export const digest_fromHexString: (a: number, b: number) => [number, number, number];
 export const digest_toHexString: (a: number) => [number, number];
-export const digest___wasm_refgen_toWasmDigest: (a: number) => number;
 export const __wbg_fragment_free: (a: number, b: number) => void;
 export const fragment_new: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => number;
 export const fragment_head: (a: number) => number;
@@ -24,7 +28,8 @@ export const fragmentsarray___wasm_refgen_toWasmFragmentsArray: (a: number) => n
 export const fragmentwithblob_signed: (a: number) => number;
 export const fragmentwithblob___wasm_refgen_toWasmFragmentWithBlob: (a: number) => number;
 export const __wbg_loosecommit_free: (a: number, b: number) => void;
-export const loosecommit_new: (a: number, b: number, c: number, d: number) => number;
+export const loosecommit_new: (a: number, b: number, c: number, d: number, e: number) => number;
+export const loosecommit_commitId: (a: number) => number;
 export const loosecommit_digest: (a: number) => number;
 export const loosecommit_parents: (a: number) => [number, number];
 export const loosecommit_blobMeta: (a: number) => number;
@@ -62,33 +67,38 @@ export const memorystorage_deleteSedimentreeId: (a: number, b: number) => any;
 export const memorystorage_loadAllSedimentreeIds: (a: number) => any;
 export const memorystorage_saveCommit: (a: number, b: number, c: number, d: number, e: any) => any;
 export const memorystorage_loadCommit: (a: number, b: number, c: number) => any;
-export const memorystorage_listCommitDigests: (a: number, b: number) => any;
-export const memorystorage_loadAllCommits: (a: number, b: number) => any;
 export const memorystorage_deleteCommit: (a: number, b: number, c: number) => any;
+export const memorystorage_listCommitIds: (a: number, b: number) => any;
+export const memorystorage_loadAllCommits: (a: number, b: number) => any;
 export const memorystorage_deleteAllCommits: (a: number, b: number) => any;
 export const memorystorage_saveFragment: (a: number, b: number, c: number, d: number, e: any) => any;
 export const memorystorage_loadFragment: (a: number, b: number, c: number) => any;
-export const memorystorage_listFragmentDigests: (a: number, b: number) => any;
+export const memorystorage_listFragmentIds: (a: number, b: number) => any;
 export const memorystorage_loadAllFragments: (a: number, b: number) => any;
 export const memorystorage_deleteFragment: (a: number, b: number, c: number) => any;
 export const memorystorage_deleteAllFragments: (a: number, b: number) => any;
+export const memorystorage_saveBatchAll: (a: number, b: number, c: any, d: any) => any;
+export const commitid_new: (a: number, b: number) => [number, number, number];
 export const depth___wasm_refgen_toWasmDepth: (a: number) => number;
-export const fragmentwithblob_new: (a: number, b: any) => number;
 export const __wbg_sedimentreeid_free: (a: number, b: number) => void;
+export const fragmentwithblob_new: (a: number, b: any) => number;
+export const __wbg_digest_free: (a: number, b: number) => void;
 export const __wbg_fragmentwithblob_free: (a: number, b: number) => void;
 export const __wbg_signedloosecommit_free: (a: number, b: number) => void;
 export const sedimentreeid___wasm_refgen_toWasmSedimentreeId: (a: number) => number;
 export const sedimentreeid_toBytes: (a: number) => [number, number];
+export const digest___wasm_refgen_toWasmDigest: (a: number) => number;
+export const digest_toBytes: (a: number) => [number, number];
 export const fragmentwithblob_blob: (a: number) => any;
-export const __wasm_bindgen_func_elem_366: (a: number, b: number) => void;
-export const __wasm_bindgen_func_elem_533: (a: number, b: number, c: any) => [number, number];
-export const __wasm_bindgen_func_elem_533_66: (a: number, b: number, c: any, d: any) => void;
-export const __wbindgen_export: (a: number) => void;
-export const __wbindgen_export2: () => number;
+export const __wasm_bindgen_func_elem_400: (a: number, b: number) => void;
+export const __wasm_bindgen_func_elem_563: (a: number, b: number, c: any) => [number, number];
+export const __wasm_bindgen_func_elem_563_75: (a: number, b: number, c: any, d: any) => void;
+export const __wbindgen_export: (a: number, b: number) => number;
+export const __wbindgen_export2: (a: number, b: number, c: number, d: number) => number;
+export const __wbindgen_export3: (a: number) => void;
+export const __wbindgen_export4: () => number;
 export const __wbindgen_externrefs: WebAssembly.Table;
-export const __wbindgen_export3: (a: number, b: number) => number;
-export const __wbindgen_export4: (a: number) => void;
-export const __wbindgen_export5: (a: number, b: number, c: number, d: number) => number;
+export const __wbindgen_export5: (a: number) => void;
 export const __wbindgen_export6: (a: number, b: number, c: number) => void;
 export const __wbindgen_export7: (a: number, b: number) => void;
 export const __wbindgen_start: () => void;

package/dist/wasm_bindgen/web/sedimentree_wasm.d.ts

@@ -7,23 +7,23 @@ export interface SedimentreeStorage {
     loadAllSedimentreeIds(): Promise<SedimentreeId[]>;
 
     // Compound storage for commits (signed data + blob stored together)
-    saveCommit(sedimentreeId: SedimentreeId, digest: Digest, signedCommit: SignedLooseCommit, blob: Uint8Array): Promise<void>;
-    loadCommit(sedimentreeId: SedimentreeId, digest: Digest): Promise<CommitWithBlob | null>;
-    listCommitDigests(sedimentreeId: SedimentreeId): Promise<Digest[]>;
+    saveCommit(sedimentreeId: SedimentreeId, commitId: CommitId, signedCommit: SignedLooseCommit, blob: Uint8Array): Promise<void>;
+    loadCommit(sedimentreeId: SedimentreeId, commitId: CommitId): Promise<CommitWithBlob | null>;
+    listCommitIds(sedimentreeId: SedimentreeId): Promise<CommitId[]>;
     loadAllCommits(sedimentreeId: SedimentreeId): Promise<CommitWithBlob[]>;
-    deleteCommit(sedimentreeId: SedimentreeId, digest: Digest): Promise<void>;
+    deleteCommit(sedimentreeId: SedimentreeId, commitId: CommitId): Promise<void>;
     deleteAllCommits(sedimentreeId: SedimentreeId): Promise<void>;
 
     // Compound storage for fragments (signed data + blob stored together)
-    saveFragment(sedimentreeId: SedimentreeId, digest: Digest, signedFragment: SignedFragment, blob: Uint8Array): Promise<void>;
-    loadFragment(sedimentreeId: SedimentreeId, digest: Digest): Promise<FragmentWithBlob | null>;
-    listFragmentDigests(sedimentreeId: SedimentreeId): Promise<Digest[]>;
+    saveFragment(sedimentreeId: SedimentreeId, fragmentHead: CommitId, signedFragment: SignedFragment, blob: Uint8Array): Promise<void>;
+    loadFragment(sedimentreeId: SedimentreeId, fragmentHead: CommitId): Promise<FragmentWithBlob | null>;
+    listFragmentIds(sedimentreeId: SedimentreeId): Promise<CommitId[]>;
     loadAllFragments(sedimentreeId: SedimentreeId): Promise<FragmentWithBlob[]>;
-    deleteFragment(sedimentreeId: SedimentreeId, digest: Digest): Promise<void>;
+    deleteFragment(sedimentreeId: SedimentreeId, fragmentHead: CommitId): Promise<void>;
     deleteAllFragments(sedimentreeId: SedimentreeId): Promise<void>;
 
     // Batch save: write all commits + fragments in a single storage transaction.
-    saveBatchAll(sedimentreeId: SedimentreeId, commits: Array<{digest: Digest, signedCommit: SignedLooseCommit, blob: Uint8Array}>, fragments: Array<{digest: Digest, signedFragment: SignedFragment, blob: Uint8Array}>): Promise<number>;
+    saveBatchAll(sedimentreeId: SedimentreeId, commits: Array<{commitId: CommitId, signedCommit: SignedLooseCommit, blob: Uint8Array}>, fragments: Array<{fragmentHead: CommitId, signedFragment: SignedFragment, blob: Uint8Array}>): Promise<number>;
 }
 
 
@@ -55,6 +55,63 @@ export class BlobMeta {
     readonly sizeBytes: bigint;
 }
 
+/**
+ * A user-supplied opaque identifier for a loose commit.
+ *
+ * Unlike [`Digest`](crate::digest::WasmDigest), which is a content hash
+ * computed by the system, `CommitId` is provided by the caller at construction
+ * time. This is the identity used for DAG traversal, fragment boundaries,
+ * and sync.
+ */
+export class CommitId {
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * Upcasts; to the JS-import type for [`WasmCommitId`].
+     */
+    __wasm_refgen_toWasmCommitId(): CommitId;
+    /**
+     * Creates a new commit identifier from its Base58 string representation.
+     *
+     * # Errors
+     *
+     * Returns an error if the string cannot be decoded or is not 32 bytes.
+     */
+    static fromBase58(s: string): CommitId;
+    /**
+     * Creates a new commit identifier from its byte representation.
+     *
+     * # Errors
+     *
+     * Returns an error if the byte slice is not exactly 32 bytes.
+     */
+    static fromBytes(bytes: Uint8Array): CommitId;
+    /**
+     * Creates a new commit identifier from its hexadecimal string representation.
+     *
+     * # Errors
+     *
+     * Returns an error if the string is not valid hex or not 32 bytes.
+     */
+    static fromHexString(s: string): CommitId;
+    /**
+     * Creates a new commit identifier from its byte representation.
+     *
+     * # Errors
+     *
+     * Returns an error if the byte slice is not exactly 32 bytes.
+     */
+    constructor(bytes: Uint8Array);
+    /**
+     * Returns the byte representation of the commit identifier.
+     */
+    toBytes(): Uint8Array;
+    /**
+     * Returns the hexadecimal string representation.
+     */
+    toHexString(): string;
+}
+
 /**
  * A commit stored with its associated blob.
  */
@@ -175,19 +232,19 @@ export class Fragment {
     /**
      * Create a new fragment from the given sedimentree ID, head, boundary, checkpoints, and blob metadata.
      */
-    constructor(sedimentree_id: SedimentreeId, head: Digest, boundary: Digest[], checkpoints: Digest[], blob_meta: BlobMeta);
+    constructor(sedimentree_id: SedimentreeId, head: CommitId, boundary: CommitId[], checkpoints: CommitId[], blob_meta: BlobMeta);
     /**
      * Get the blob metadata of the fragment.
      */
     readonly blobMeta: BlobMeta;
     /**
-     * Get the boundary digests of the fragment.
+     * Get the boundary commit identifiers of the fragment.
      */
-    readonly boundary: Digest[];
+    readonly boundary: CommitId[];
     /**
-     * Get the head digest of the fragment.
+     * Get the head commit identifier of the fragment.
      */
-    readonly head: Digest;
+    readonly head: CommitId;
 }
 
 /**
@@ -235,21 +292,25 @@ export class LooseCommit {
      */
     __wasm_refgen_toWasmLooseCommit(): LooseCommit;
     /**
-     * Create a new `LooseCommit` from the given sedimentree ID, parents, and blob metadata.
+     * Create a new `LooseCommit` from the given sedimentree ID, head, parents, and blob metadata.
      */
-    constructor(sedimentree_id: SedimentreeId, parents: Digest[], blob_meta: BlobMeta);
+    constructor(sedimentree_id: SedimentreeId, head: CommitId, parents: CommitId[], blob_meta: BlobMeta);
     /**
      * Get the blob metadata of the commit.
      */
     readonly blobMeta: BlobMeta;
     /**
-     * Get the digest of the commit.
+     * Get the commit's head identifier.
+     */
+    readonly commitId: CommitId;
+    /**
+     * Get the digest of the commit (content hash).
      */
     readonly digest: Digest;
     /**
-     * Get the parent digests of the commit.
+     * Get the parent commit identifiers.
      */
-    readonly parents: Digest[];
+    readonly parents: CommitId[];
 }
 
 /**
@@ -269,25 +330,25 @@ export class MemoryStorage {
      */
     deleteAllFragments(sedimentree_id: SedimentreeId): Promise<any>;
     /**
-     * Delete a commit by digest.
+     * Delete a single commit by its ID.
      */
-    deleteCommit(sedimentree_id: SedimentreeId, digest: Digest): Promise<any>;
+    deleteCommit(sedimentree_id: SedimentreeId, commit_id: CommitId): Promise<any>;
     /**
-     * Delete a fragment by digest.
+     * Delete a fragment by its identifier.
      */
-    deleteFragment(sedimentree_id: SedimentreeId, digest: Digest): Promise<any>;
+    deleteFragment(sedimentree_id: SedimentreeId, fragment_head: CommitId): Promise<any>;
     /**
      * Delete a sedimentree ID.
      */
     deleteSedimentreeId(sedimentree_id: SedimentreeId): Promise<any>;
     /**
-     * List all commit digests for a sedimentree.
+     * List all commit IDs for a sedimentree.
      */
-    listCommitDigests(sedimentree_id: SedimentreeId): Promise<any>;
+    listCommitIds(sedimentree_id: SedimentreeId): Promise<any>;
     /**
-     * List all fragment digests for a sedimentree.
+     * List all fragment IDs for a sedimentree.
      */
-    listFragmentDigests(sedimentree_id: SedimentreeId): Promise<any>;
+    listFragmentIds(sedimentree_id: SedimentreeId): Promise<any>;
     /**
      * Load all commits for a sedimentree, returning `CommitWithBlob[]`.
      */
@@ -301,25 +362,38 @@ export class MemoryStorage {
      */
     loadAllSedimentreeIds(): Promise<any>;
     /**
-     * Load a commit by digest, returning `CommitWithBlob` or null.
+     * Load a single commit by its ID, returning `CommitWithBlob` or null.
      */
-    loadCommit(sedimentree_id: SedimentreeId, digest: Digest): Promise<any>;
+    loadCommit(sedimentree_id: SedimentreeId, commit_id: CommitId): Promise<any>;
     /**
-     * Load a fragment by digest, returning `FragmentWithBlob` or null.
+     * Load a fragment by its identifier, returning `FragmentWithBlob` or null.
      */
-    loadFragment(sedimentree_id: SedimentreeId, digest: Digest): Promise<any>;
+    loadFragment(sedimentree_id: SedimentreeId, fragment_head: CommitId): Promise<any>;
     /**
      * Create a new in-memory storage instance.
      */
     constructor();
+    /**
+     * Save commits and fragments in a single batch.
+     */
+    saveBatchAll(sedimentree_id: SedimentreeId, commits: Array<any>, fragments: Array<any>): Promise<any>;
     /**
      * Save a commit with its blob.
+     *
+     * The `commit_id` parameter must match the `head()` embedded in
+     * the signed commit payload. Returns an error if they differ.
+     *
+     * # Errors
+     *
+     * Returns a JS error if:
+     * - The signed payload cannot be decoded
+     * - The `commit_id` does not match the embedded `head()`
      */
-    saveCommit(sedimentree_id: SedimentreeId, _digest: Digest, signed_commit: SignedLooseCommit, blob: Uint8Array): Promise<any>;
+    saveCommit(sedimentree_id: SedimentreeId, commit_id: CommitId, signed_commit: SignedLooseCommit, blob: Uint8Array): Promise<any>;
     /**
      * Save a fragment with its blob.
      */
-    saveFragment(sedimentree_id: SedimentreeId, _digest: Digest, signed_fragment: SignedFragment, blob: Uint8Array): Promise<any>;
+    saveFragment(sedimentree_id: SedimentreeId, _fragment_head: CommitId, signed_fragment: SignedFragment, blob: Uint8Array): Promise<any>;
     /**
      * Save a sedimentree ID.
      */
@@ -451,18 +525,22 @@ export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembl
 
 export interface InitOutput {
     readonly memory: WebAssembly.Memory;
+    readonly __wbg_commitid_free: (a: number, b: number) => void;
+    readonly commitid_fromBytes: (a: number, b: number) => [number, number, number];
+    readonly commitid_fromBase58: (a: number, b: number) => [number, number, number];
+    readonly commitid_fromHexString: (a: number, b: number) => [number, number, number];
+    readonly commitid_toBytes: (a: number) => [number, number];
+    readonly commitid_toHexString: (a: number) => [number, number];
+    readonly commitid___wasm_refgen_toWasmCommitId: (a: number) => number;
     readonly __wbg_depth_free: (a: number, b: number) => void;
     readonly depth_new: (a: any) => [number, number, number];
     readonly depth_value: (a: number) => number;
     readonly depth___subduction_castToDepth: (a: number) => number;
-    readonly __wbg_digest_free: (a: number, b: number) => void;
     readonly digest_new: (a: number, b: number) => [number, number, number];
     readonly digest_fromBytes: (a: number, b: number) => [number, number, number];
     readonly digest_fromBase58: (a: number, b: number) => [number, number, number];
-    readonly digest_toBytes: (a: number) => [number, number];
     readonly digest_fromHexString: (a: number, b: number) => [number, number, number];
     readonly digest_toHexString: (a: number) => [number, number];
-    readonly digest___wasm_refgen_toWasmDigest: (a: number) => number;
     readonly __wbg_fragment_free: (a: number, b: number) => void;
     readonly fragment_new: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => number;
     readonly fragment_head: (a: number) => number;
@@ -474,7 +552,8 @@ export interface InitOutput {
     readonly fragmentwithblob_signed: (a: number) => number;
     readonly fragmentwithblob___wasm_refgen_toWasmFragmentWithBlob: (a: number) => number;
     readonly __wbg_loosecommit_free: (a: number, b: number) => void;
-    readonly loosecommit_new: (a: number, b: number, c: number, d: number) => number;
+    readonly loosecommit_new: (a: number, b: number, c: number, d: number, e: number) => number;
+    readonly loosecommit_commitId: (a: number) => number;
     readonly loosecommit_digest: (a: number) => number;
     readonly loosecommit_parents: (a: number) => [number, number];
     readonly loosecommit_blobMeta: (a: number) => number;
@@ -512,33 +591,38 @@ export interface InitOutput {
     readonly memorystorage_loadAllSedimentreeIds: (a: number) => any;
     readonly memorystorage_saveCommit: (a: number, b: number, c: number, d: number, e: any) => any;
     readonly memorystorage_loadCommit: (a: number, b: number, c: number) => any;
-    readonly memorystorage_listCommitDigests: (a: number, b: number) => any;
-    readonly memorystorage_loadAllCommits: (a: number, b: number) => any;
     readonly memorystorage_deleteCommit: (a: number, b: number, c: number) => any;
+    readonly memorystorage_listCommitIds: (a: number, b: number) => any;
+    readonly memorystorage_loadAllCommits: (a: number, b: number) => any;
     readonly memorystorage_deleteAllCommits: (a: number, b: number) => any;
     readonly memorystorage_saveFragment: (a: number, b: number, c: number, d: number, e: any) => any;
     readonly memorystorage_loadFragment: (a: number, b: number, c: number) => any;
-    readonly memorystorage_listFragmentDigests: (a: number, b: number) => any;
+    readonly memorystorage_listFragmentIds: (a: number, b: number) => any;
     readonly memorystorage_loadAllFragments: (a: number, b: number) => any;
     readonly memorystorage_deleteFragment: (a: number, b: number, c: number) => any;
     readonly memorystorage_deleteAllFragments: (a: number, b: number) => any;
+    readonly memorystorage_saveBatchAll: (a: number, b: number, c: any, d: any) => any;
+    readonly commitid_new: (a: number, b: number) => [number, number, number];
     readonly depth___wasm_refgen_toWasmDepth: (a: number) => number;
-    readonly fragmentwithblob_new: (a: number, b: any) => number;
     readonly __wbg_sedimentreeid_free: (a: number, b: number) => void;
+    readonly fragmentwithblob_new: (a: number, b: any) => number;
+    readonly __wbg_digest_free: (a: number, b: number) => void;
     readonly __wbg_fragmentwithblob_free: (a: number, b: number) => void;
     readonly __wbg_signedloosecommit_free: (a: number, b: number) => void;
     readonly sedimentreeid___wasm_refgen_toWasmSedimentreeId: (a: number) => number;
     readonly sedimentreeid_toBytes: (a: number) => [number, number];
+    readonly digest___wasm_refgen_toWasmDigest: (a: number) => number;
+    readonly digest_toBytes: (a: number) => [number, number];
     readonly fragmentwithblob_blob: (a: number) => any;
-    readonly __wasm_bindgen_func_elem_366: (a: number, b: number) => void;
-    readonly __wasm_bindgen_func_elem_533: (a: number, b: number, c: any) => [number, number];
-    readonly __wasm_bindgen_func_elem_533_66: (a: number, b: number, c: any, d: any) => void;
-    readonly __wbindgen_export: (a: number) => void;
-    readonly __wbindgen_export2: () => number;
+    readonly __wasm_bindgen_func_elem_400: (a: number, b: number) => void;
+    readonly __wasm_bindgen_func_elem_563: (a: number, b: number, c: any) => [number, number];
+    readonly __wasm_bindgen_func_elem_563_75: (a: number, b: number, c: any, d: any) => void;
+    readonly __wbindgen_export: (a: number, b: number) => number;
+    readonly __wbindgen_export2: (a: number, b: number, c: number, d: number) => number;
+    readonly __wbindgen_export3: (a: number) => void;
+    readonly __wbindgen_export4: () => number;
     readonly __wbindgen_externrefs: WebAssembly.Table;
-    readonly __wbindgen_export3: (a: number, b: number) => number;
-    readonly __wbindgen_export4: (a: number) => void;
-    readonly __wbindgen_export5: (a: number, b: number, c: number, d: number) => number;
+    readonly __wbindgen_export5: (a: number) => void;
     readonly __wbindgen_export6: (a: number, b: number, c: number) => void;
     readonly __wbindgen_export7: (a: number, b: number) => void;
     readonly __wbindgen_start: () => void;