@misofm/platform 0.19.0 → 0.21.0

package/dist/recording-extensions.js

@@ -2,13 +2,16 @@
 // SPDX-License-Identifier: Apache-2.0
 /** Cap-authorized builders and reads for data-only Recording metadata extensions. */
 import { bcs } from "@mysten/sui/bcs";
-import { deriveDynamicFieldID } from "@mysten/sui/utils";
+import { deriveDynamicFieldID, fromHex, toHex } from "@mysten/sui/utils";
+import { isNotFound } from "@misofm/protocol";
 import { invokeWithAdminCap } from "./vault.js";
 import * as advisory from "@misofm/protocol/contracts/recording_advisory/recording_advisory";
 import * as language from "@misofm/protocol/contracts/recording_language/recording_language";
-import * as walrusData from "@misofm/protocol/contracts/recording_master_reference/deps/ori/walrus_data";
+import * as walrusData from "@misofm/protocol/contracts/recording_master_reference/deps/ori/data";
 import * as masterReference from "@misofm/protocol/contracts/recording_master_reference/recording_master_reference";
+import * as engineSession from "@misofm/protocol/contracts/recording_engine_session/recording_engine_session";
 import * as streamingTranscode from "@misofm/protocol/contracts/recording_streaming_transcode/recording_streaming_transcode";
+import { unencryptedWalrusBlob } from "./internal.js";
 function object(tx, value) {
     return typeof value === "string" ? tx.object(value) : value;
 }
@@ -74,6 +77,73 @@ export function setRecordingStreamingTranscode(p) {
         });
     };
 }
+const STEM_DIGEST_BYTES = 32;
+function stemDigestBytes(digest) {
+    const bytes = typeof digest === "string" ? fromHex(digest) : digest;
+    if (bytes.length !== STEM_DIGEST_BYTES) {
+        throw new Error(`stem digest must be ${STEM_DIGEST_BYTES} bytes`);
+    }
+    return bytes;
+}
+function compareBytes(a, b) {
+    for (let index = 0; index < a.length; index += 1) {
+        if (a[index] !== b[index])
+            return a[index] - b[index];
+    }
+    return 0;
+}
+/**
+ * Sets or replaces the Miso Engine session attached to a Recording: the
+ * Session V1 blob plus one `Stem` per source. Stems are sorted by digest and
+ * checked for duplicates here, mirroring `recording_engine_session::new`, so a
+ * bad input fails before signing rather than on chain.
+ */
+export function setRecordingEngineSession(p) {
+    const stems = p.stems
+        .map((stem) => ({ digest: stemDigestBytes(stem.digest), blobId: stem.blobId }))
+        .sort((a, b) => compareBytes(a.digest, b.digest));
+    for (let index = 1; index < stems.length; index += 1) {
+        if (compareBytes(stems[index - 1].digest, stems[index].digest) === 0) {
+            throw new Error(`duplicate stem digest ${toHex(stems[index].digest)}`);
+        }
+    }
+    return (tx) => {
+        const pkg = p.recordingEngineSessionPackageId;
+        const sessionBlob = unencryptedWalrusBlob(tx, p.oriPackageId, p.sessionBlobId);
+        const stemValues = stems.map((stem) => tx.add(engineSession.newStem({
+            package: pkg,
+            arguments: [
+                tx.pure.vector("u8", Array.from(stem.digest)),
+                unencryptedWalrusBlob(tx, p.oriPackageId, stem.blobId),
+            ],
+        })));
+        const stemVector = tx.makeMoveVec({
+            type: `${pkg}::recording_engine_session::Stem`,
+            elements: stemValues,
+        });
+        const session = tx.add(engineSession._new({
+            package: pkg,
+            arguments: [sessionBlob, stemVector],
+        }));
+        invokeWithAdminCap(tx, p.authority, {
+            target: `${pkg}::recording_engine_session::set_engine_session`,
+            typeArguments: [p.recordingShareType, p.compositionShareType],
+            arguments: [object(tx, p.recordingId), session],
+            adminCapIndex: 1,
+        });
+    };
+}
+/** Removes the Recording's Miso Engine session reference, if present. */
+export function unsetRecordingEngineSession(p) {
+    return (tx) => {
+        invokeWithAdminCap(tx, p.authority, {
+            target: `${p.recordingEngineSessionPackageId}::recording_engine_session::unset_engine_session`,
+            typeArguments: [p.recordingShareType, p.compositionShareType],
+            arguments: [object(tx, p.recordingId)],
+            adminCapIndex: 1,
+        });
+    };
+}
 /** Removes the Recording's streaming-transcode reference, if present. */
 export function unsetRecordingStreamingTranscode(p) {
     return (tx) => {
@@ -85,23 +155,71 @@ export function unsetRecordingStreamingTranscode(p) {
         });
     };
 }
+const EngineSessionField = bcs.struct("Field", {
+    id: bcs.Address,
+    name: engineSession.ExtensionKey,
+    value: engineSession.EngineSession,
+});
+const ENGINE_SESSION_KEY_BYTES = engineSession.ExtensionKey.serialize([false]).toBytes();
+/** Parse an engine-session dynamic field's BCS content. */
+export function parseRecordingEngineSessionContent(content) {
+    const { value } = EngineSessionField.parse(content);
+    if (value.data.confidentiality.$kind !== "Unencrypted") {
+        throw new Error("Recording engine session is unexpectedly encrypted");
+    }
+    return {
+        sessionBlobId: String(value.data.blob_id),
+        stems: value.stems.map((stem) => {
+            if (stem.data.confidentiality.$kind !== "Unencrypted") {
+                throw new Error("Recording engine session stem is unexpectedly encrypted");
+            }
+            return { digest: toHex(Uint8Array.from(stem.digest)), blobId: String(stem.data.blob_id) };
+        }),
+    };
+}
+/** Deterministic dynamic-field id for a Recording's engine session. */
+export function recordingEngineSessionFieldId(recordingId, recordingEngineSessionPackageId) {
+    return deriveDynamicFieldID(recordingId, `${recordingEngineSessionPackageId}::recording_engine_session::ExtensionKey`, ENGINE_SESSION_KEY_BYTES);
+}
+/** Read one Recording's engine session, or null when none is attached. */
+export async function getRecordingEngineSession(client, recordingId, recordingEngineSessionPackageId) {
+    const fieldId = recordingEngineSessionFieldId(recordingId, recordingEngineSessionPackageId);
+    const { objects } = await client.core.getObjects({
+        objectIds: [fieldId],
+        include: { content: true },
+    });
+    const field = objects[0];
+    if (!field)
+        throw new Error("Recording engine-session read returned no result");
+    if (field instanceof Error) {
+        if (isNotFound(field))
+            return null;
+        throw field;
+    }
+    if (!field.content)
+        throw new Error("Recording engine-session field is missing BCS content");
+    return parseRecordingEngineSessionContent(field.content);
+}
 // ── Master-reference reads ───────────────────────────────────────────────────
-// recording_master_reference stores the ori::WalrusData value inline in a
+// recording_master_reference stores the ori::data::WalrusBlob value inline in a
 // dynamic field on the Recording. Its empty ExtensionKey serializes to one false
 // byte, so the field object id can be derived without listing the Recording's
 // dynamic fields.
 const MasterReferenceField = bcs.struct("Field", {
     id: bcs.Address,
     name: masterReference.ExtensionKey,
-    value: walrusData.WalrusData,
+    value: walrusData.WalrusBlob,
 });
 const MASTER_REFERENCE_KEY_BYTES = masterReference.ExtensionKey.serialize([
     false,
 ]).toBytes();
-/** Parse an attached master reference's standalone Walrus blob id. */
+/**
+ * Parse an attached master reference's standalone Walrus blob id (decimal
+ * `u256`). Encrypted masters are returned as-is: the reference is the same
+ * either way, and access control belongs to the caller.
+ */
 export function parseRecordingMasterReferenceContent(content) {
-    const reference = MasterReferenceField.parse(content).value;
-    return reference.$kind === "Blob" ? String(reference.Blob[0]) : null;
+    return String(MasterReferenceField.parse(content).value.blob_id);
 }
 /** Deterministic dynamic-field id for a Recording's master reference. */
 export function recordingMasterReferenceFieldId(recordingId, recordingMasterReferencePackageId) {
@@ -135,9 +253,7 @@ export async function getRecordingMasterReferencesByIds(client, recordingIdsInpu
         if (!target || object instanceof Error || !object.content)
             return;
         try {
-            const blobId = parseRecordingMasterReferenceContent(object.content);
-            if (blobId)
-                out[target.recordingId] = blobId;
+            out[target.recordingId] = parseRecordingMasterReferenceContent(object.content);
         }
         catch {
             // Extension metadata is soft: retain valid tracks when one field is stale.

package/dist/recording-extensions.js.map

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

package/dist/walrus-ids.d.ts

@@ -0,0 +1,11 @@
+/** Parse a `bigint` or decimal string as an exact `u256`. */
+export declare function walrusU256(label: string, value: bigint | string): bigint;
+/** The base64url Walrus blob id for an on-chain `u256` blob id. */
+export declare function walrusBlobIdFromU256(value: bigint | string): string;
+/** The on-chain `u256` for a base64url Walrus blob id (43 characters). */
+export declare function walrusBlobIdToU256(blobId: string): bigint;
+/** Unpadded base64url. */
+export declare function bytesToBase64Url(bytes: Uint8Array): string;
+/** Strict inverse of {@link bytesToBase64Url}: no padding, no stray bits. */
+export declare function base64UrlToBytes(value: string): Uint8Array;
+//# sourceMappingURL=walrus-ids.d.ts.map

package/dist/walrus-ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"walrus-ids.d.ts","sourceRoot":"","sources":["../src/walrus-ids.ts"],"names":[],"mappings":"AAgBA,6DAA6D;AAC7D,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAWxE;AAED,mEAAmE;AACnE,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAQnE;AAED,0EAA0E;AAC1E,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAUzD;AAED,0BAA0B;AAC1B,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAc1D;AAED,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CA6B1D"}

package/dist/walrus-ids.js

@@ -0,0 +1,96 @@
+// Copyright (c) Miso Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Walrus blob id conversions.
+ *
+ * On chain a blob id is a `u256` (BCS little-endian). Off chain it is the
+ * unpadded base64url encoding of those same 32 little-endian bytes, which is
+ * also its key in a `miso-sources` staging bucket and its path on an
+ * aggregator. Both directions here are canonical: a value that does not
+ * round-trip byte for byte is rejected.
+ */
+const ALPHABET = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_";
+/** Parse a `bigint` or decimal string as an exact `u256`. */
+export function walrusU256(label, value) {
+    let parsed;
+    try {
+        parsed = typeof value === "bigint" ? value : BigInt(value);
+    }
+    catch {
+        throw new Error(`${label} must be an exact u256 integer`);
+    }
+    if (parsed < 0n || parsed >= 1n << 256n) {
+        throw new Error(`${label} is outside u256 range`);
+    }
+    return parsed;
+}
+/** The base64url Walrus blob id for an on-chain `u256` blob id. */
+export function walrusBlobIdFromU256(value) {
+    let remaining = walrusU256("Walrus blob id", value);
+    const bytes = new Uint8Array(32);
+    for (let index = 0; index < 32; index += 1) {
+        bytes[index] = Number(remaining & 0xffn);
+        remaining >>= 8n;
+    }
+    return bytesToBase64Url(bytes);
+}
+/** The on-chain `u256` for a base64url Walrus blob id (43 characters). */
+export function walrusBlobIdToU256(blobId) {
+    const bytes = base64UrlToBytes(blobId);
+    if (bytes.length !== 32) {
+        throw new Error("Walrus blob id must decode to exactly 32 bytes");
+    }
+    let value = 0n;
+    for (let index = 31; index >= 0; index -= 1) {
+        value = (value << 8n) | BigInt(bytes[index]);
+    }
+    return value;
+}
+/** Unpadded base64url. */
+export function bytesToBase64Url(bytes) {
+    let output = "";
+    for (let index = 0; index < bytes.length; index += 3) {
+        const a = bytes[index] ?? 0;
+        const b = bytes[index + 1] ?? 0;
+        const c = bytes[index + 2] ?? 0;
+        output += ALPHABET[a >>> 2];
+        output += ALPHABET[((a & 3) << 4) | (b >>> 4)];
+        if (index + 1 < bytes.length) {
+            output += ALPHABET[((b & 15) << 2) | (c >>> 6)];
+        }
+        if (index + 2 < bytes.length)
+            output += ALPHABET[c & 63];
+    }
+    return output;
+}
+/** Strict inverse of {@link bytesToBase64Url}: no padding, no stray bits. */
+export function base64UrlToBytes(value) {
+    if (typeof value !== "string" ||
+        value.length % 4 === 1 ||
+        value.includes("=") ||
+        !/^[A-Za-z0-9_-]*$/.test(value)) {
+        throw new Error("invalid canonical base64url");
+    }
+    const bytes = new Uint8Array(Math.floor((value.length * 6) / 8));
+    let accumulator = 0;
+    let bits = 0;
+    let outputIndex = 0;
+    for (const character of value) {
+        const digit = ALPHABET.indexOf(character);
+        if (digit < 0)
+            throw new Error("invalid canonical base64url");
+        accumulator = (accumulator << 6) | digit;
+        bits += 6;
+        if (bits >= 8) {
+            bits -= 8;
+            bytes[outputIndex] = (accumulator >>> bits) & 0xff;
+            outputIndex += 1;
+            accumulator &= (1 << bits) - 1;
+        }
+    }
+    if (bytesToBase64Url(bytes) !== value) {
+        throw new Error("invalid canonical base64url padding bits");
+    }
+    return bytes;
+}
+//# sourceMappingURL=walrus-ids.js.map

package/dist/walrus-ids.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@misofm/platform",
-  "version": "0.19.0",
+  "version": "0.21.0",
   "packageManager": "bun@1.4.0",
   "description": "Complete client SDK for the Miso platform on Sui \u2014 high-level reads, pressings, listings, records, and work publishing.",
   "license": "Apache-2.0",
@@ -89,10 +89,6 @@
       "types": "./dist/recording-extensions.d.ts",
       "default": "./dist/recording-extensions.js"
     },
-    "./mix": {
-      "types": "./dist/mix.d.ts",
-      "default": "./dist/mix.js"
-    },
     "./read": {
       "types": "./dist/read/index.d.ts",
       "default": "./dist/read/index.js"
@@ -129,20 +125,18 @@
     "prepare": "rm -rf dist && tsc -p tsconfig.build.json --noCheck"
   },
   "dependencies": {
-    "@misofm/protocol": "0.13.0",
+    "@misofm/protocol": "0.15.0",
     "@mysten/bcs": "^2.1.1"
   },
   "devDependencies": {
     "@mysten/codegen": "^0.11.14",
     "@mysten/move-bytecode-template": "^0.4.0",
-    "@mysten/seal": "1.4.6",
     "@mysten/sui": "2.29.0",
     "@types/bun": "^1.3.14",
     "typescript": "^7.0.2"
   },
   "peerDependencies": {
     "@mysten/move-bytecode-template": "^0.4.0",
-    "@mysten/seal": "1.4.6",
     "@mysten/sui": "2.29.0",
     "typescript": "^5.7 || ^6 || ^7"
   },

package/src/client.ts

@@ -310,7 +310,7 @@ export interface MisoPlatformConfig {
   /** Curated genre vocabulary package and its shared derivation parent. */
   genrePackageId?: string;
   genreRegistryId?: string;
-  /** External ori package used to create WalrusData values. */
+  /** External ori package used to create `data::WalrusBlob` values. */
   oriPackageId?: string;
 }
 

package/src/contracts.ts

@@ -42,6 +42,7 @@ export * as releaseRevenueDistributor from "@misofm/protocol/contracts/release_r
 export * as recordingAdvisory from "@misofm/protocol/contracts/recording_advisory/recording_advisory";
 export * as recordingLanguage from "@misofm/protocol/contracts/recording_language/recording_language";
 export * as recordingMasterReference from "@misofm/protocol/contracts/recording_master_reference/recording_master_reference";
+export * as recordingEngineSession from "@misofm/protocol/contracts/recording_engine_session/recording_engine_session";
 export * as recordingStreamingTranscode from "@misofm/protocol/contracts/recording_streaming_transcode/recording_streaming_transcode";
 
 // Credits extensions (per-work credit stores + their role vocabularies).

package/src/cover.ts

@@ -2,9 +2,9 @@
 // SPDX-License-Identifier: Apache-2.0
 
 // Release cover art. A cover is a still image (optionally an animation) stored as
-// a Walrus blob and referenced on-chain via `ori::WalrusData`. We build the ref
-// (`ori::walrus_data::new_blob`, a raw call — ori is an external dep), wrap it in a
-// `cover_art::CoverArt`, and attach it to the Release with
+// a Walrus blob and referenced on-chain via `ori::data::WalrusBlob`. We build the
+// plaintext ref (`ori::data::new_blob`, a raw call — ori is an external dep), wrap
+// it in a `cover_art::CoverArt`, and attach it to the Release with
 // `release_cover_art::set_cover` (gated by the ReleaseAdminCap).
 //
 // Blob ids are passed as `u256` (decimal string or bigint) — the CLI converts the
@@ -20,7 +20,7 @@ import { deriveDynamicFieldID } from "@mysten/sui/utils";
 import type { Transaction, TransactionObjectArgument } from "@mysten/sui/transactions";
 import type { TxThunk } from "./transactions.ts";
 import { asU64, directAdminCap, invokeWithAdminCap, type AdminCapAuthority, type ObjectInput, type U64Input } from "./vault.ts";
-import { OPTION_NONE, OPTION_SOME } from "./internal.ts";
+import { OPTION_NONE, OPTION_SOME, unencryptedWalrusBlob } from "./internal.ts";
 import * as coverArt from "@misofm/protocol/contracts/cover_art/cover_art";
 import * as releaseCoverArt from "@misofm/protocol/contracts/release_cover_art/release_cover_art";
 
@@ -44,7 +44,7 @@ interface SetReleaseCoverParamsBase {
   coverArtPackageId: string;
   /** `release_cover_art` package — home of the `set_cover` extension entry point. */
   releaseCoverArtPackageId: string;
-  /** `ori` package (home of `walrus_data::new_blob` / the `WalrusData` type). */
+  /** `ori` package (home of `data::new_blob` / the `WalrusBlob` type). */
   oriPackageId: string;
 }
 
@@ -59,12 +59,8 @@ export type SetReleaseTrackCoverParams = SetReleaseCoverParams & {
 };
 
 function buildCover(tx: Parameters<TxThunk>[0], p: SetReleaseCoverParams) {
-  const walrusType = `${p.oriPackageId}::walrus_data::WalrusData`;
-  const blob = (id: bigint | string) =>
-    tx.moveCall({
-      target: `${p.oriPackageId}::walrus_data::new_blob`,
-      arguments: [tx.pure.u256(id)],
-    });
+  const walrusType = `${p.oriPackageId}::data::WalrusBlob`;
+  const blob = (id: bigint | string) => unencryptedWalrusBlob(tx, p.oriPackageId, id);
 
   const still = blob(p.stillBlobId);
   const animated =
@@ -113,17 +109,12 @@ export function setReleaseTrackCover(p: SetReleaseTrackCoverParams): TxThunk {
 /**
  * A normalized reference to a cover image's Walrus data. Blob ids are returned as
  * `u256` decimal strings (the on-chain form); callers convert to a base64url
- * aggregator URL with `@unconfirmed/ori` (`u256ToB64Url` / `walrusDataUrl`).
+ * aggregator URL with `@unconfirmed/ori` (`u256ToB64Url` / `walrusBlobUrl`).
+ *
+ * The current `cover_art` generation stores standalone `ori::data::WalrusBlob`
+ * values only, so every cover image is a `blob` reference.
  */
-export type CoverImageRef =
-  | { kind: "blob"; blobId: string }
-  | {
-      kind: "quiltPatch";
-      quiltId: string;
-      version: number;
-      startIndex: number;
-      endIndex: number;
-    };
+export type CoverImageRef = { kind: "blob"; blobId: string };
 
 /** A release's album-level cover: a still image and an optional animation. */
 export interface ReleaseCoverView {
@@ -143,24 +134,13 @@ const COVER_ART_KEY_BYTES = releaseCoverArt.ExtensionKey.serialize([
   false,
 ]).toBytes();
 
-/** A parsed `ori::WalrusData` value (a MoveEnum: `Blob` or `QuiltPatch`). */
-type ParsedWalrusData =
-  | { $kind: "Blob"; Blob: [string | number | bigint, unknown] }
-  | {
-      $kind: "QuiltPatch";
-      QuiltPatch: [string | number | bigint, number, number, number];
-    };
-
-function toCoverImageRef(wd: ParsedWalrusData): CoverImageRef {
-  if (wd.$kind === "Blob") return { kind: "blob", blobId: String(wd.Blob[0]) };
-  const [quiltId, version, startIndex, endIndex] = wd.QuiltPatch;
-  return {
-    kind: "quiltPatch",
-    quiltId: String(quiltId),
-    version,
-    startIndex,
-    endIndex,
-  };
+/** A parsed `ori::data::WalrusBlob` value. */
+interface ParsedWalrusBlob {
+  blob_id: string | number | bigint;
+}
+
+function toCoverImageRef(blob: ParsedWalrusBlob): CoverImageRef {
+  return { kind: "blob", blobId: String(blob.blob_id) };
 }
 
 /**
@@ -185,8 +165,8 @@ export function parseReleaseCoverContent(
   content: Uint8Array,
 ): ReleaseCoverView | null {
   const cover = CoverArtField.parse(content).value.cover as {
-    still: ParsedWalrusData;
-    animated: ParsedWalrusData | null;
+    still: ParsedWalrusBlob;
+    animated: ParsedWalrusBlob | null;
   } | null;
   if (!cover) return null;
 

package/src/deployments.ts

@@ -216,11 +216,15 @@ export interface MisoPlatformDeployment {
     readonly recordingMasterReference: string;
     /** Complete Walrus Quilt containing the Recording's streaming transcodes. */
     readonly recordingStreamingTranscode?: string;
-    /** Canonical plaintext session pointer extension; absent before publication. */
+    /**
+     * Miso Engine session: the Session V1 blob plus each stem's PCM digest and
+     * blob. Absent until the stems generation of `recording_engine_session` is
+     * published; the retired single-blob generation is not a substitute.
+     */
     readonly recordingEngineSession?: string;
     /** Original immutable Record-gated Seal policy; absent before publication. */
     readonly recordSealPolicy?: string;
-    /** External `ori::walrus_data::WalrusData` dependency used by cover art. */
+    /** External `ori` package (`data::WalrusBlob`, `data::WalrusQuilt`) used by Walrus-backed extensions. */
     readonly ori: string;
   };
   readonly objects: {
@@ -317,8 +321,9 @@ export const MISO_PLATFORM_DEPLOYMENTS = immutableSnapshot({
         "0xd6b7f206f838018a28d33b77bade2b8476ccafab5fe526345c375d3b47bb892f",
       recordingMasterReference:
         "0x65309bf315f3e035b0f10c706eb5c327af5038be1637a0cee74f4ae62872f6ce",
-      recordingEngineSession:
-        "0x2fcb9ab90772711487e5858e20393a4f222df538a3d5104d2a884bb54663af33",
+      // 0x2fcb9ab9… is the retired single-blob generation. Fill in the stems
+      // generation's identity from Published.toml once it is published.
+      recordingEngineSession: undefined,
       recordingStreamingTranscode:
         "0x622cd2a9e49ee2639f5c1d922d2fc75e89e810e80da8dd6d4a843bcefa0aacb0",
       recordSealPolicy:

package/src/index.ts

@@ -49,7 +49,7 @@ export * from "./share-template.ts";
 export * from "./release-graph.ts";
 export * from "./publication.ts";
 export * from "./catalog.ts";
-export * from "./mix.ts";
+export * from "./walrus-ids.ts";
 
 // High-level, JSON-safe platform projections used directly by clients and by
 // the thin HTTP read service. Namespaced because these composed view types are
@@ -62,7 +62,6 @@ export * from "./credits.ts";
 export * from "./cover.ts";
 export * from "./release-extensions.ts";
 export * from "./recording-extensions.ts";
-export * from "./mix.ts";
 export * from "./vault.ts";
 
 // Generated, ABI-bound bindings (BCS structs + type-safe Move calls).

package/src/internal.ts

@@ -2,6 +2,8 @@
 // SPDX-License-Identifier: Apache-2.0
 
 // Internal shared helpers (deliberately NOT exported from the package root).
+
+import type { Transaction, TransactionArgument } from "@mysten/sui/transactions";
 //
 // PTB building blocks — the `0x1::option` move-call targets used when a generated
 // call needs an `Option` argument built inline. Consumed by `./cover` and
@@ -18,6 +20,29 @@
 export const OPTION_NONE = "0x1::option::none";
 export const OPTION_SOME = "0x1::option::some";
 
+/**
+ * Build a plaintext `ori::data::WalrusBlob` in the PTB: `confidentiality::new_unencrypted()`
+ * followed by `data::new_blob(blob_id, confidentiality)`. `ori` is an external
+ * dependency, so these are raw calls against the deployment's `ori` package.
+ *
+ * Every platform extension that stores a standalone blob (cover art, master
+ * reference, engine session) builds its reference here so the ori ABI is pinned
+ * in exactly one place.
+ */
+export function unencryptedWalrusBlob(
+  tx: Transaction,
+  oriPackageId: string,
+  blobId: bigint | string,
+): TransactionArgument {
+  const confidentiality = tx.moveCall({
+    target: `${oriPackageId}::confidentiality::new_unencrypted`,
+  });
+  return tx.moveCall({
+    target: `${oriPackageId}::data::new_blob`,
+    arguments: [tx.pure.u256(blobId), confidentiality],
+  });
+}
+
 /**
  * Clone arrays and plain records recursively, then freeze the clone.
  *