@misofm/platform 0.22.1 → 0.24.0

package/src/read/config.ts

@@ -13,6 +13,7 @@
 
 import type { MisoDeployment } from "@misofm/protocol/deployments";
 import { getMisoPlatformDeployment, type RecordSalesDeployment } from "../deployments.ts";
+import { walrusAggregatorUrl } from "../walrus.ts";
 
 export type Network = "testnet" | "mainnet";
 
@@ -33,6 +34,10 @@ export interface ProtocolIds {
   releaseKind: string;
   /** `recording_master_reference` — optional Walrus master pointers. */
   recordingMasterReference: string;
+  /** `recording_streaming_transcode` — the `miso-hls/v1` Quilt a track streams from, or null when the generation lacks it. */
+  recordingStreamingTranscode: string | null;
+  /** `recording_engine_session` — the Session V1 blob and stems a track mixes from, or null when the generation lacks it. */
+  recordingEngineSession: string | null;
   /** `composition_credits` / `recording_credits` / `release_credits` extensions. */
   compositionCredits: string;
   recordingCredits: string;
@@ -111,6 +116,8 @@ export function misoConfig(network: Network, overrides: MisoConfigOverrides = {}
       releaseCoverArt: platform.packages.releaseCoverArt,
       releaseKind: platform.packages.releaseKind,
       recordingMasterReference: platform.packages.recordingMasterReference,
+      recordingStreamingTranscode: platform.packages.recordingStreamingTranscode ?? null,
+      recordingEngineSession: platform.packages.recordingEngineSession ?? null,
       compositionCredits: platform.packages.compositionCredits,
       recordingCredits: platform.packages.recordingCredits,
       releaseCredits: platform.packages.releaseCredits,
@@ -123,7 +130,7 @@ export function misoConfig(network: Network, overrides: MisoConfigOverrides = {}
     },
     grpcUrl: "https://fullnode.testnet.sui.io",
     graphqlUrl: "https://graphql.testnet.sui.io/graphql",
-    walrusAggregatorUrl: "https://aggregator.walrus-testnet.walrus.space",
+    walrusAggregatorUrl: walrusAggregatorUrl(network),
     apiBaseUrl: "https://api.testnet.miso.fm",
     discoverSales: [],
   };

package/src/read/types.ts

@@ -74,8 +74,23 @@ export interface TrackView {
   splitBps: number;
   /** 1-based disc this track sits on. */
   disc: number;
-  /** Base64url Walrus blob id for the master stream, when attached on-chain. */
+  /** Base64url Walrus blob id of the archival master, when attached on-chain. */
   masterBlobId?: string;
+  /**
+   * Base64url Walrus Quilt id of the `miso-hls/v1` streaming transcode, when
+   * attached on-chain. The playback key: `streamUrl(network, transcodeQuiltId)`.
+   */
+  transcodeQuiltId?: string;
+  /** The Miso Engine session attached on-chain, when present. */
+  engineSession?: TrackEngineSession;
+}
+
+/** A track's on-chain engine session: ids are base64url Walrus blob ids. */
+export interface TrackEngineSession {
+  /** The canonical Session V1 JSON document. */
+  sessionBlobId: string;
+  /** One FLAC blob per session source, keyed by the source's canonical PCM digest (64 hex chars), sorted by digest. */
+  stems: { digest: string; blobId: string }[];
 }
 
 /** A release with everything a page renders: metadata, cover, credits, tracklist. */

package/src/recording-extensions.ts

@@ -241,6 +241,99 @@ export function unsetRecordingStreamingTranscode(
   };
 }
 
+// ── Streaming-transcode reads ────────────────────────────────────────────────
+
+// recording_streaming_transcode stores the ori::data::WalrusQuilt inline in a
+// dynamic field on the Recording; its empty ExtensionKey serializes to one
+// false byte, so the field id derives without listing dynamic fields.
+const StreamingTranscodeField = bcs.struct("Field", {
+  id: bcs.Address,
+  name: streamingTranscode.ExtensionKey,
+  value: streamingTranscode.StreamingTranscode,
+});
+const STREAMING_TRANSCODE_KEY_BYTES = streamingTranscode.ExtensionKey.serialize([false]).toBytes();
+
+/** Parse a streaming-transcode dynamic field into its Quilt id (decimal `u256`). */
+export function parseRecordingStreamingTranscodeContent(content: Uint8Array): string {
+  return String(StreamingTranscodeField.parse(content).value.quilt.quilt_id);
+}
+
+/** Deterministic dynamic-field id for a Recording's streaming transcode. */
+export function recordingStreamingTranscodeFieldId(
+  recordingId: string,
+  recordingStreamingTranscodePackageId: string,
+): string {
+  return deriveDynamicFieldID(
+    recordingId,
+    `${recordingStreamingTranscodePackageId}::recording_streaming_transcode::ExtensionKey`,
+    STREAMING_TRANSCODE_KEY_BYTES,
+  );
+}
+
+/** Read one Recording's streaming-transcode Quilt id, or null when absent. */
+export async function getRecordingStreamingTranscode(
+  client: ClientWithCoreApi,
+  recordingId: string,
+  recordingStreamingTranscodePackageId: string,
+): Promise<string | null> {
+  return (
+    (
+      await getRecordingStreamingTranscodesByIds(
+        client,
+        [recordingId],
+        recordingStreamingTranscodePackageId,
+      )
+    )[recordingId] ?? null
+  );
+}
+
+/**
+ * Read streaming-transcode Quilt ids for many Recordings in one Core request.
+ * Missing and malformed fields are omitted, like master references.
+ */
+export async function getRecordingStreamingTranscodesByIds(
+  client: ClientWithCoreApi,
+  recordingIdsInput: readonly string[],
+  recordingStreamingTranscodePackageId: string,
+): Promise<Partial<Record<string, string>>> {
+  return readSoftFields(
+    client,
+    recordingIdsInput,
+    (recordingId) => recordingStreamingTranscodeFieldId(recordingId, recordingStreamingTranscodePackageId),
+    parseRecordingStreamingTranscodeContent,
+  );
+}
+
+/**
+ * Fetch one derived dynamic field per Recording in a single Core request and
+ * parse each, dropping Recordings whose field is missing or malformed so one
+ * stale extension cannot take a whole tracklist down.
+ */
+async function readSoftFields<T>(
+  client: ClientWithCoreApi,
+  recordingIdsInput: readonly string[],
+  fieldIdOf: (recordingId: string) => string,
+  parse: (content: Uint8Array) => T,
+): Promise<Partial<Record<string, T>>> {
+  const recordingIds = [...new Set(recordingIdsInput)];
+  if (recordingIds.length === 0) return {};
+  const { objects } = await client.core.getObjects({
+    objectIds: recordingIds.map(fieldIdOf),
+    include: { content: true },
+  });
+  const out: Partial<Record<string, T>> = {};
+  objects.forEach((object, index) => {
+    const recordingId = recordingIds[index];
+    if (!recordingId || object instanceof Error || !object.content) return;
+    try {
+      out[recordingId] = parse(object.content);
+    } catch {
+      // Extension metadata is soft: retain valid tracks when one field is stale.
+    }
+  });
+  return out;
+}
+
 // ── Engine-session reads ─────────────────────────────────────────────────────
 
 /** A Recording's attached engine session, ids as decimal `u256` strings. */
@@ -308,6 +401,23 @@ export async function getRecordingEngineSession(
   return parseRecordingEngineSessionContent(field.content);
 }
 
+/**
+ * Read engine sessions for many Recordings in one Core request. Missing and
+ * malformed fields are omitted.
+ */
+export async function getRecordingEngineSessionsByIds(
+  client: ClientWithCoreApi,
+  recordingIdsInput: readonly string[],
+  recordingEngineSessionPackageId: string,
+): Promise<Partial<Record<string, RecordingEngineSessionView>>> {
+  return readSoftFields(
+    client,
+    recordingIdsInput,
+    (recordingId) => recordingEngineSessionFieldId(recordingId, recordingEngineSessionPackageId),
+    parseRecordingEngineSessionContent,
+  );
+}
+
 // ── Master-reference reads ───────────────────────────────────────────────────
 
 // recording_master_reference stores the ori::data::WalrusBlob value inline in a

package/src/vault.ts

@@ -734,17 +734,18 @@ export function redeemAllAndDistributeReleaseRevenue(
     readonly accumulatorRoot?: ObjectInput;
   },
 ): void {
-  tx.add(
-    releaseRevenueDistributorPlugin.redeemAllAndDistribute({
-      package: params.pluginPackageId,
-      typeArguments: [params.currencyType],
-      arguments: [
-        params.vault,
-        params.release,
-        object(tx, params.accumulatorRoot ?? SUI_ACCUMULATOR_ROOT_OBJECT_ID),
-      ],
-    }),
-  );
+  // The generated binding resolves the chain-wide accumulator root itself, so it
+  // no longer accepts one. Call the target directly to keep honoring an explicit
+  // `accumulatorRoot` (a test fixture root) while the on-chain shape is unchanged.
+  tx.moveCall({
+    target: `${params.pluginPackageId}::release_revenue_distributor_plugin::redeem_all_and_distribute`,
+    typeArguments: [params.currencyType],
+    arguments: [
+      object(tx, params.vault),
+      params.release,
+      object(tx, params.accumulatorRoot ?? SUI_ACCUMULATOR_ROOT_OBJECT_ID),
+    ],
+  });
 }
 
 /** Convenience form of the fixed crank for a known Release object ID. */