@misofm/platform 0.18.0 → 0.20.0

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,12 +216,11 @@ 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. */
+    /** Unencrypted Walrus blob of a Recording's Miso Engine session file; absent before publication. */
     readonly recordingEngineSession?: string;
     /** Original immutable Record-gated Seal policy; absent before publication. */
     readonly recordSealPolicy?: string;
-    readonly recordingPreview: 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: {
@@ -250,89 +249,87 @@ export const MISO_PLATFORM_DEPLOYMENTS = immutableSnapshot({
     recordSales: {
       status: "available",
       recordPackageId:
-        "0x75e5fa520c39322e0526ff56a495f9a2a88d097e2df7902d94e58a9a12831e76",
+        "0xc9411d3e2cb9600081544572036bec049624db1707f9354c342090f440b6e1a2",
       recordShopPackageId:
-        "0x2b97df3773040bb2cffd8c329bfd57f05f1fd2defb6ab156050ba1ae540d5d2a",
+        "0xc6d49266080b8f165b6c1fc48e1aa4a6d719183d78a8d1043bfe0f2d6c744ed1",
     },
     operations: {
       status: "available",
       vault: {
         packageId:
-          "0xaed1aa729452c77f4c62882b73317851d628c30af55355c81eb1c93d3d3276ac",
+          "0x77b74e9221874b9e29f6743a277810480bf89d71b5cb71741cd52dfcd83035d2",
         registryId:
-          "0x5de3c379a15e4609260a94ace3d186cc466366fc6aebafe5663c016057b6a2d6",
+          "0x0fcfe3bb47f0ee2fbf0dcb65b48741efd06b4d746f1df14fe6ac3c00e9e35287",
       },
       actions: {
         compositionRoyaltyPool:
-          "0x46b9b193255f28ec5190e8cd37ae85397c9110266da73a4a7a94fcb6e990155b",
+          "0x26c574e0aa01f504833b4f01dad44e2cd17b8718630e025d85ce05b843092085",
         recordingRoyaltyPool:
-          "0x78964bdc2dd7fad943633542edf5a1c9be38b1d2d25de1cc6cca64757c7d037a",
+          "0x84b3cc36907112da74c88c78d1ac20e17010a30e206dfa4322a300c87032d405",
         partyWallet:
-          "0x934f15715f725e3eed2acaeda5c717b6641dce4bb88b7670db26249cb6646728",
+          "0xa3d6016f2da63b53546e3f9922e8f0c12c27ca532509ef8c0e778f3e7cd56ee6",
         compositionRoutedStake:
-          "0xb1539001eaf32350d7044acb03092dcbd5a366e708d959aece0cca683f7f57fc",
+          "0x8e32cdb08953afe0b72f46fde2b0fe1ab0ab3c12885c1e41883ccb5d8703e144",
         releaseRevenueDistributor:
-          "0xd19dde6c20fa41092c9645e8300284cf1a268ab5ed3b3c7a2a12593672203b45",
+          "0x5ab255ed56c601c5d3c79502e81cfd4fd534c166fa731c2275a65d5fd2b34615",
       },
       plugins: {
         compositionRoyaltyPool:
-          "0xad3525b86fad3f2aaaa3fdf0430d690efba249e378b1b89ed8180ecbc5d89392",
+          "0x6969b98c0322a8a7ba2478d900fc88e1c9ba17903c310c7fdb133c0789bd5ba8",
         recordingRoyaltyPool:
-          "0x2adfc809152c5c8cf07f0e466d881b62d48c7da3ae2e787c0471deb867a6a385",
+          "0x4ac310583eda99e148207f99618ce5d21d7e7680e7c92b58422113b155a97455",
         releaseRevenueDistributor:
-          "0x4f1da8c04ec53749f6cf6e8d2d48701fd72654078240050e20e41dc774f93d46",
+          "0xf13e254b32cee1315d9c0af3c4ef6e3bb770c293eee90afe30a009cde30bb381",
       },
     },
     packages: {
       minato:
         "0xcdf58ed7e4580118a6a3f2a8077abffe633c551b2f19e95ce01685d42f90b8d9",
       credit:
-        "0xc5a82310ce313af8f0ec18a4e564af11971b360db9e2ae686fef86fb2297a9a9",
+        "0xb82c6c2524ede481cfa3c1066c70c1e43b1a5f6f11e40d5633153c2c3150bba7",
       compositionCredits:
-        "0xc58ac5d69740866f6514f68f2e9c86b1d069d819ad0bcf5384b6aaa66e0fbf53",
+        "0x09434b8b65fb25a703b9c762abbb9075b5bfde6baffc923baac9353ab2191a65",
       recordingCredits:
-        "0x7bafa653854f0820d911b8f6aa0aac3b131163c254b0021330881b77206d4d79",
+        "0x598303437c97ab1ec232be884d041587f18647b71fb36f4cf76cbbcc3c276dd2",
       releaseCredits:
-        "0x47ccd23c669b023b8678193e7748235916e16e737fdd8ba48b131ded29c76a00",
+        "0xd6e9f090d581779099cc4beaf6c8843f1d569dea85fdde004748c8f03aadafcb",
       royaltyPool:
-        "0xecaa5a29cf8e110face3b80f0e4a5554e8c80edd8eda0983ed2f8015367eecca",
+        "0xce4a1415255ac043301f3057b1dbd1095ad4959fcbe5bfceb9dbb7cf1144def1",
       routedStake:
-        "0x30ed387d3fea69579ddb34d011fa6e1416580bfb3ee6587aabf103fb0d17bced",
+        "0xaa37871d4ba3ce4a465c13c79d1a701941efbf33491633c744ad4b7035f7f894",
       coverArt:
-        "0x2b811f82d33cf6a9448adb11a598f6b04c14970cfc8e2982cde1d468e8e7d4a4",
+        "0x711f7041fc9e12d045b278c07ff9cf5047b69002e91e9dd881ad51c09ec389f6",
       releaseCoverArt:
-        "0x4f0a8736685f6b1ddbcd0bddcd7aae2d072aa3d4043efc0ad4042a7786068999",
+        "0xfb1dc55719142fb575c6242f338447fa87bf4618f6903c7a6e30489f4e810fb3",
       genre:
-        "0x01e58dbc76c15c9ac137dabac1823ebd6ef81efd563c5121000bc11c51a47cc7",
+        "0x095c412a9e9846b091b8f93d9bd50bca5d98a2e65063cb6c20265dc307c4b319",
       releaseDescription:
-        "0x50f5acf7c0c05cdc7656072fd1bfc5ee76d02beabeae090103734b2d75118fa3",
+        "0x957b633fd186f65f953e17caaeec2e3385431c6f55914cb31dfb775368f89d9e",
       releaseDspLink:
-        "0x9ca9ad8cab49c4897cd3cb89628b771ee4f10831ddc273036837751a5339d02a",
+        "0x7bce4d548314d9cff3145732f19ad7e67b3c00e2cf4d6f295f8af6d02108884e",
       releaseGenre:
-        "0xfb73b04be2f72704ec5e6a1035bfab108e5ee2a72e72c0505f999291e23219bd",
+        "0x9770bc7cf9d9b2fa35af194d14f0c36320fbf6541c5ee12b884f0db44d1b5a4f",
       releaseKind:
-        "0xfb2e5790f0577aca3ac8ddd672c4c58ef1e49ef1c3dfe14fb9676aaabf769169",
+        "0x187f6f881623cc843d2c6dc98fe23203598fd3992b6a78c1b5990f3fd60a0f5b",
       recordingAdvisory:
-        "0x23abf3f248466c08edc3349b202d6e809064c0e52098ff290cef1fdc51d5942e",
+        "0x8f745dac70fef5327e686b31acbe3f3504dc7eeb63da5f31a4660bb5aea5ee4b",
       recordingLanguage:
-        "0xb3e1c578638a79acc7ab573c994206047ad8ef76893f9c5c987887c5b10a5c68",
+        "0xd6b7f206f838018a28d33b77bade2b8476ccafab5fe526345c375d3b47bb892f",
       recordingMasterReference:
-        "0x92a752854b80a6103721743125ee48223b577a023fe360e25d3aa695462a6d15",
+        "0x65309bf315f3e035b0f10c706eb5c327af5038be1637a0cee74f4ae62872f6ce",
       recordingEngineSession:
-        "0xdd8f817a221e2acd5a4e6f34d0192d8e0dbddeb76c2dff2fdc82991cb4feb6c6",
+        "0x2fcb9ab90772711487e5858e20393a4f222df538a3d5104d2a884bb54663af33",
+      recordingStreamingTranscode:
+        "0x622cd2a9e49ee2639f5c1d922d2fc75e89e810e80da8dd6d4a843bcefa0aacb0",
       recordSealPolicy:
-        "0xfa22d0678eaec39ad36b74c2c5439d574292e8fb19a9a15272733267499d5351",
-      recordingPreview:
-        "0x2be8405f6b77a30d6942cb240c0d804d608ef761395e6f861b71d9ae3c98f997",
-      ori: "0xf35cf353a62cef01084b51a9cf3da4c64c8724685ad1862f2f8284b71bd26c1a",
+        "0x2b806033f31ed0af5a9118429111dd5c91f44d9229c41aa9d5cbaec7e3910c0a",
+      ori: "0x51792b9adb9a5d05d7c4d74d7d0cb5aefc5639afa80c0089399cab8b99752e60",
     },
     objects: {
       releaseRegistry:
-        "0x452c9904677a1bbf92d4e07d86d2c3eb038c47595b0e17a23756f03887eb2a2a",
+        "0x40700d8fd9de26392d10c4a3c0759b08f60be43e2f80681650e87a4efdac5cf1",
       genreRegistry:
-        "0xda4cc070da1a71d43387973027a7230587a1b9c829d37c2af4a3adbc15fdb8a8",
-      recordGate:
-        "0x8fd51c8b31bb6012fb03d2be39ed7b9f0f581329b6b338c60c209110cc659f31",
+        "0x479a1f43c8118b24d10cba62d64ad782c19fad974cdbc5020c909ea943c857a8",
     },
     legacy: {
       releaseCoverArtPackages: [],

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.
  *

package/src/mix.ts

@@ -23,7 +23,7 @@ import {
   parseStructTag,
 } from "@mysten/sui/utils";
 import { getReleaseById, isNotFound } from "@misofm/protocol";
-import { WalrusData } from "@misofm/protocol/contracts/recording_master_reference/deps/ori/walrus_data";
+import * as engineSessionContract from "@misofm/protocol/contracts/recording_engine_session/recording_engine_session";
 import * as recordContract from "@misofm/protocol/contracts/miso_record/record";
 import type { TxThunk } from "./transactions.ts";
 import {
@@ -432,14 +432,27 @@ export function inspectEngineSessionKey(
 
 const EngineSessionField = bcs.struct("Field", {
   id: bcs.Address,
-  name: bcs.tuple([bcs.bool()]),
-  value: bcs.struct("EngineSession", { reference: WalrusData }),
+  name: engineSessionContract.ExtensionKey,
+  value: engineSessionContract.EngineSession,
+});
+const ENGINE_SESSION_KEY_BYTES = engineSessionContract.ExtensionKey.serialize([
+  false,
+]).toBytes();
+// `release_mix_reference` predates the ori `walrus_data` → `data` split and is
+// not part of the current deployment. Its stored value is still the legacy
+// `ori::walrus_data::WalrusData` enum, kept here verbatim for reads.
+const LegacyConfidentiality = bcs.enum("Confidentiality", {
+  Unencrypted: null,
+  Encrypted: bcs.struct("Confidentiality.Encrypted", { dek: bcs.vector(bcs.u8()) }),
+});
+const LegacyWalrusData = bcs.enum("WalrusData", {
+  Blob: bcs.tuple([bcs.u256(), LegacyConfidentiality]),
+  QuiltPatch: bcs.tuple([bcs.u256(), bcs.u8(), bcs.u16(), bcs.u16()]),
 });
-const ENGINE_SESSION_KEY_BYTES = new Uint8Array([0]);
 const ReleaseMixReferenceField = bcs.struct("Field", {
   id: bcs.Address,
   name: bcs.tuple([bcs.bool()]),
-  value: bcs.tuple([bcs.vector(bcs.option(WalrusData))]),
+  value: bcs.tuple([bcs.vector(bcs.option(LegacyWalrusData))]),
 });
 
 export interface RecordingEngineSessionReference {
@@ -492,15 +505,11 @@ export function recordingEngineSessionFieldId(
 export function parseRecordingEngineSessionContent(
   content: Uint8Array,
 ): RecordingEngineSessionReference {
-  const reference = EngineSessionField.parse(content).value.reference;
-  if (reference.$kind !== "Blob") {
-    throw new Error("Recording engine session is not a standalone Walrus blob");
-  }
-  const [id, confidentiality] = reference.Blob;
-  if (confidentiality.$kind !== "Unencrypted") {
+  const { data } = EngineSessionField.parse(content).value;
+  if (data.confidentiality.$kind !== "Unencrypted") {
     throw new Error("Recording engine session is unexpectedly encrypted");
   }
-  return { blobId: BigInt(id) };
+  return { blobId: BigInt(data.blob_id) };
 }
 
 export async function getRecordingEngineSession(
@@ -596,62 +605,6 @@ export async function resolveRecordEngineSession(
   };
 }
 
-// ── Recording extension writes ──────────────────────────────────────────────
-
-export interface WriteRecordingEngineSessionParams {
-  readonly recordingId: ObjectInput;
-  readonly authority: AdminCapAuthority;
-  readonly recordingShareType: string;
-  readonly compositionShareType: string;
-  readonly sessionBlobId: bigint | string;
-  readonly oriPackageId: string;
-  readonly recordingEngineSessionPackageId: string;
-}
-
-export function attachRecordingEngineSession(
-  params: WriteRecordingEngineSessionParams,
-): TxThunk {
-  return writeRecordingEngineSession("attach_engine_session", params);
-}
-
-export function replaceRecordingEngineSession(
-  params: WriteRecordingEngineSessionParams,
-): TxThunk {
-  return writeRecordingEngineSession("replace_engine_session", params);
-}
-
-export function unsetRecordingEngineSession(
-  params: Omit<WriteRecordingEngineSessionParams, "sessionBlobId" | "oriPackageId">,
-): TxThunk {
-  return (tx) => {
-    invokeWithAdminCap(tx, params.authority, {
-      target: `${params.recordingEngineSessionPackageId}::recording_engine_session::unset_engine_session`,
-      typeArguments: [params.recordingShareType, params.compositionShareType],
-      arguments: [object(tx, params.recordingId)],
-      adminCapIndex: 1,
-    });
-  };
-}
-
-function writeRecordingEngineSession(
-  fn: "attach_engine_session" | "replace_engine_session",
-  params: WriteRecordingEngineSessionParams,
-): TxThunk {
-  const blob = u256("sessionBlobId", params.sessionBlobId);
-  return (tx) => {
-    const reference = tx.moveCall({
-      target: `${params.oriPackageId}::walrus_data::new_blob`,
-      arguments: [tx.pure.u256(blob)],
-    });
-    invokeWithAdminCap(tx, params.authority, {
-      target: `${params.recordingEngineSessionPackageId}::recording_engine_session::${fn}`,
-      typeArguments: [params.recordingShareType, params.compositionShareType],
-      arguments: [object(tx, params.recordingId), reference],
-      adminCapIndex: 1,
-    });
-  };
-}
-
 function object(tx: Transaction, input: ObjectInput): TransactionObjectArgument {
   return typeof input === "string" ? tx.object(input) : input;
 }

package/src/publication.ts

@@ -48,12 +48,13 @@ import {
 } from "./credits.ts";
 import {
   setRecordingAdvisory,
+  setRecordingEngineSession,
   setRecordingInstrumental,
   setRecordingLanguages,
   setRecordingMasterReference,
-  setRecordingPreview,
   setRecordingStreamingTranscode,
 } from "./recording-extensions.ts";
+import { unencryptedWalrusBlob } from "./internal.ts";
 import {
   setReleaseDescription,
   setReleaseDspLinks,
@@ -172,7 +173,8 @@ export type PublicationRecording = PublicationRecordingParent & {
   readonly masterReferenceBlobId?: bigint | string;
   /** Complete Walrus Quilt ID containing this Recording's streaming transcodes. */
   readonly streamingTranscodeQuiltId?: bigint | string;
-  readonly previewBlobId?: bigint | string;
+  /** Unencrypted Walrus blob ID of this Recording's Miso Engine session file. */
+  readonly engineSessionBlobId?: bigint | string;
 };
 
 export interface PublicationFreshTrack {
@@ -334,10 +336,7 @@ function languageVector(tx: Transaction, p: AtomicPublicationParams, codes: stri
 }
 
 function walrusBlob(tx: Transaction, p: AtomicPublicationParams, blobId: bigint | string) {
-  return tx.moveCall({
-    target: `${p.deployment.packages.ori}::walrus_data::new_blob`,
-    arguments: [tx.pure.u256(blobId)],
-  });
+  return unencryptedWalrusBlob(tx, p.deployment.packages.ori, blobId);
 }
 
 function listingPrice(tx: Transaction, p: AtomicPublicationParams, price: ListingPrice) {
@@ -654,6 +653,14 @@ export function publishAtomicCatalog(p: AtomicPublicationParams): TxThunk {
       "A recording streaming transcode requires deployment.packages.recordingStreamingTranscode",
     );
   }
+  if (
+    p.recordings.some((node) => node.engineSessionBlobId !== undefined) &&
+    !p.deployment.packages.recordingEngineSession
+  ) {
+    throw new Error(
+      "A recording engine session requires deployment.packages.recordingEngineSession",
+    );
+  }
   if (publicationUsesVault(p)) {
     requireOperationsDeployment(p.deployment.operations);
   }
@@ -871,12 +878,13 @@ export function publishAtomicCatalog(p: AtomicPublicationParams): TxThunk {
         oriPackageId: p.deployment.packages.ori,
         quiltId: node.streamingTranscodeQuiltId,
       })(tx);
-      if (node.previewBlobId !== undefined) setRecordingPreview({
+      if (node.engineSessionBlobId !== undefined) setRecordingEngineSession({
         recordingId: parts.work, authority,
         recordingShareType: node.shareType,
         compositionShareType: node.compositionShareType,
-        recordingPreviewPackageId: p.deployment.packages.recordingPreview,
-        reference: walrusBlob(tx, p, node.previewBlobId),
+        recordingEngineSessionPackageId: p.deployment.packages.recordingEngineSession!,
+        oriPackageId: p.deployment.packages.ori,
+        sessionBlobId: node.engineSessionBlobId,
       })(tx);
     });
 

package/src/read/catalog.ts

@@ -49,7 +49,6 @@ import type { MisoClient } from "./client.ts";
 import { getRecordingTitles, parseReleaseObject } from "./works.ts";
 import { int } from "./internal/scalars.ts";
 import {
-  quiltPatchId,
   u256ToB64Url,
   walrusBlobReadUrl,
 } from "./internal/walrus.ts";
@@ -75,17 +74,9 @@ import type {
 
 // ── Walrus URLs ──────────────────────────────────────────────────────────────
 
-/** Aggregator URL for a cover image ref, whichever Walrus variant it is. */
+/** Aggregator URL for a cover image ref (a standalone Walrus blob). */
 function imageUrl(aggregator: string, ref: CoverImageRef): string {
-  const base = aggregator.replace(/\/$/, "");
-  if (ref.kind === "blob") return walrusBlobReadUrl(base, ref.blobId);
-  const patch = quiltPatchId(
-    ref.quiltId,
-    ref.version,
-    ref.startIndex,
-    ref.endIndex,
-  );
-  return `${base}/v1/blobs/by-quilt-patch-id/${patch}`;
+  return walrusBlobReadUrl(aggregator.replace(/\/$/, ""), ref.blobId);
 }
 
 function toCover(

package/src/recording-extensions.ts

@@ -11,10 +11,11 @@ import type { TxThunk } from "./transactions.ts";
 import { invokeWithAdminCap, type AdminCapAuthority, type ObjectInput } from "./vault.ts";
 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 preview from "@misofm/protocol/contracts/recording_preview/recording_preview";
+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.ts";
 
 export interface RecordingExtensionTarget {
   readonly recordingId: ObjectInput;
@@ -78,7 +79,7 @@ export function setRecordingInstrumental(p: Omit<SetRecordingLanguagesParams, "l
 }
 
 interface RecordingWalrusReferenceParams extends RecordingExtensionTarget {
-  /** An ori::WalrusData value assembled in the same PTB (must be a standalone blob on chain). */
+  /** An `ori::data::WalrusBlob` value assembled in the same PTB. */
   readonly reference: TransactionArgument;
 }
 
@@ -131,29 +132,61 @@ export type UnsetRecordingStreamingTranscodeParams = Omit<
   "oriPackageId" | "quiltId"
 >;
 
-/** Removes the Recording's streaming-transcode reference, if present. */
-export function unsetRecordingStreamingTranscode(
-  p: UnsetRecordingStreamingTranscodeParams,
-): TxThunk {
+export interface SetRecordingEngineSessionParams extends RecordingExtensionTarget {
+  readonly recordingEngineSessionPackageId: string;
+  /** External `ori` package used to construct the plaintext Walrus blob reference. */
+  readonly oriPackageId: string;
+  /** Unencrypted Walrus blob ID of the Miso Engine session file, as its on-chain `u256`. */
+  readonly sessionBlobId: bigint | string;
+}
+
+/**
+ * Sets or replaces the Miso Engine session file attached to a Recording.
+ *
+ * `recording_engine_session::new` rejects encrypted blobs on chain, so the
+ * reference is always built as a plaintext `ori::data::WalrusBlob`.
+ */
+export function setRecordingEngineSession(p: SetRecordingEngineSessionParams): TxThunk {
   return (tx) => {
+    const session = tx.add(engineSession._new({
+      package: p.recordingEngineSessionPackageId,
+      arguments: [unencryptedWalrusBlob(tx, p.oriPackageId, p.sessionBlobId)],
+    }));
     invokeWithAdminCap(tx, p.authority, {
-      target: `${p.recordingStreamingTranscodePackageId}::recording_streaming_transcode::unset_streaming_transcode`,
+      target: `${p.recordingEngineSessionPackageId}::recording_engine_session::set_engine_session`,
       typeArguments: [p.recordingShareType, p.compositionShareType],
-      arguments: [object(tx, p.recordingId)],
+      arguments: [object(tx, p.recordingId), session],
       adminCapIndex: 1,
     });
   };
 }
 
-export interface SetRecordingPreviewParams extends RecordingWalrusReferenceParams {
-  readonly recordingPreviewPackageId: string;
+export type UnsetRecordingEngineSessionParams = Omit<
+  SetRecordingEngineSessionParams,
+  "oriPackageId" | "sessionBlobId"
+>;
+
+/** Removes the Recording's Miso Engine session reference, if present. */
+export function unsetRecordingEngineSession(p: UnsetRecordingEngineSessionParams): TxThunk {
+  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,
+    });
+  };
 }
-export function setRecordingPreview(p: SetRecordingPreviewParams): TxThunk {
+
+/** Removes the Recording's streaming-transcode reference, if present. */
+export function unsetRecordingStreamingTranscode(
+  p: UnsetRecordingStreamingTranscodeParams,
+): TxThunk {
   return (tx) => {
     invokeWithAdminCap(tx, p.authority, {
-      target: `${p.recordingPreviewPackageId}::recording_preview::set_preview`,
+      target: `${p.recordingStreamingTranscodePackageId}::recording_streaming_transcode::unset_streaming_transcode`,
       typeArguments: [p.recordingShareType, p.compositionShareType],
-      arguments: [object(tx, p.recordingId), p.reference],
+      arguments: [object(tx, p.recordingId)],
       adminCapIndex: 1,
     });
   };
@@ -161,30 +194,26 @@ export function setRecordingPreview(p: SetRecordingPreviewParams): TxThunk {
 
 // ── 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. */
-export function parseRecordingMasterReferenceContent(
-  content: Uint8Array,
-): string | null {
-  const reference = MasterReferenceField.parse(content).value as
-    | { $kind: "Blob"; Blob: [string | number | bigint, unknown] }
-    | {
-        $kind: "QuiltPatch";
-        QuiltPatch: [string | number | bigint, number, number, number];
-      };
-  return reference.$kind === "Blob" ? String(reference.Blob[0]) : null;
+/**
+ * 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: Uint8Array): string {
+  return String(MasterReferenceField.parse(content).value.blob_id);
 }
 
 /** Deterministic dynamic-field id for a Recording's master reference. */
@@ -246,8 +275,7 @@ export async function getRecordingMasterReferencesByIds(
     const target = targets[index];
     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.
     }