@misofm/sdk 0.1.0

package/dist/transactions.js

@@ -0,0 +1,237 @@
+// Copyright (c) Miso Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+// Transaction builders follow the Sui SDK thunk pattern: a builder returns a
+// `(tx: Transaction) => …` thunk that adds commands to a caller-owned
+// `Transaction`, so a platform call composes with protocol calls and anything
+// else in the same PTB.
+//
+// This module holds the OPINIONATED publish flows. `@misonetwork/sdk` does the
+// minimum the Move semantics FORCE and returns anything a caller could
+// legitimately route elsewhere; deciding where those values GO is the
+// platform-layer call that lives here:
+//
+//   - minting a work's share supply is a protocol primitive
+//     (`createComposition`/`createRecording`) — dispersing it to recipients via
+//     minato, publishing (sharing) the work, and transferring its admin cap is
+//     an opinion about economics;
+//   - minting a release is likewise a primitive (`createRelease`) — choosing a
+//     track-assembly strategy, publishing (sharing) it, and picking a recipient
+//     for its `ReleaseAdminCap` is the opinion, so `finalizeRelease` /
+//     `publishRelease` / `publishReleaseFromDeals` live here.
+//
+// Every `finalize*` here MUST run in the same PTB as the `create*` that produced
+// its parts — `Composition`, `Recording`, and `Release` are all `key`-only with
+// no `drop`, so none can outlive its creating transaction. That is a same-PTB
+// constraint, not a same-function one, which is exactly what makes this split
+// possible.
+//
+// Composes with `@misonetwork/sdk`'s calls in the same PTB (the
+// transaction-thunk composition pattern, just crossing a package boundary now).
+import { Transaction } from "@mysten/sui/transactions";
+import { contracts, createComposition, createRecording, createRelease, } from "@misonetwork/sdk";
+const { deal, track, release } = contracts;
+/**
+ * Splits a share `Balance` across `recipients` via `minato::disperse_balance`, then
+ * destroys the emptied balance. Exposed for consumers assembling custom share
+ * distributions in their own PTBs.
+ */
+export function disperseShares(tx, minatoPackageId, shareType, balance, recipients) {
+    tx.moveCall({
+        target: `${minatoPackageId}::minato::disperse_balance`,
+        typeArguments: [shareType],
+        arguments: [
+            balance,
+            tx.makeMoveVec({ type: "u64", elements: recipients.map((r) => tx.pure.u64(r.value)) }),
+            tx.makeMoveVec({ type: "address", elements: recipients.map((r) => tx.pure.address(r.address)) }),
+        ],
+    });
+    tx.moveCall({ target: "0x2::balance::destroy_zero", typeArguments: [shareType], arguments: [balance] });
+}
+export function publishShareCurrency(bytecode) {
+    return (tx) => {
+        const upgradeCap = tx.publish(bytecode);
+        tx.moveCall({ target: "0x2::package::make_immutable", arguments: [upgradeCap] });
+    };
+}
+const SUI_COIN_REGISTRY_ID = "0xc";
+export function initializeShareCurrency(params) {
+    const { shareCurrencyPackageId, name, description, iconUrl, treasuryCapRecipient } = params;
+    return (tx) => {
+        const treasuryCap = tx.moveCall({
+            target: `${shareCurrencyPackageId}::share::initialize`,
+            arguments: [tx.pure.string(name), tx.pure.string(description), tx.pure.string(iconUrl), tx.object(SUI_COIN_REGISTRY_ID)],
+        });
+        tx.transferObjects([treasuryCap], treasuryCapRecipient);
+    };
+}
+/**
+ * The opinionated finish for a composition: disperse its share supply to
+ * `shareRecipients`, publish (share) it, and transfer its admin cap to
+ * `adminAddress`. Consumers that want different economics skip this and act on
+ * the `CompositionParts` from `@misonetwork/sdk`'s `createComposition` directly.
+ */
+export function finalizeComposition(tx, params) {
+    disperseShares(tx, params.minatoPackageId, params.shareType, params.balance, params.shareRecipients);
+    tx.add(contracts.composition.publish({ package: params.misoPackageId, typeArguments: [params.shareType], arguments: [params.composition, params.adminCap] }));
+    tx.transferObjects([params.adminCap], params.adminAddress);
+}
+/** Convenience: publish a composition end-to-end (createComposition → finalizeComposition). */
+export function publishComposition(params) {
+    return (tx) => {
+        const parts = createComposition(tx, {
+            shareType: params.shareType,
+            shareCurrencyId: params.shareCurrencyId,
+            shareTreasuryCapId: params.shareTreasuryCapId,
+            title: params.title,
+            royaltyRateBps: params.royaltyRateBps,
+            misoPackageId: params.misoPackageId,
+        });
+        finalizeComposition(tx, {
+            ...parts,
+            shareType: params.shareType,
+            shareRecipients: params.shareRecipients,
+            adminAddress: params.adminAddress,
+            misoPackageId: params.misoPackageId,
+            minatoPackageId: params.minatoPackageId,
+        });
+    };
+}
+/**
+ * The opinionated finish for a recording: publish (share) it, disperse its
+ * share supply, and transfer its admin cap to `adminAddress`. A recording has
+ * no embedded metadata to set — naming lives in the metadata extension.
+ */
+export function finalizeRecording(tx, params) {
+    const typeArguments = [params.recordingShareType, params.compositionShareType];
+    tx.add(contracts.recording.publish({ package: params.misoPackageId, typeArguments, arguments: [params.recording, params.adminCap] }));
+    disperseShares(tx, params.minatoPackageId, params.recordingShareType, params.balance, params.shareRecipients);
+    tx.transferObjects([params.adminCap], params.adminAddress);
+}
+/** Convenience: publish a recording against an already-on-chain composition. */
+export function publishRecording(params) {
+    return (tx) => {
+        const parts = createRecording(tx, {
+            shareType: params.shareType,
+            shareCurrencyId: params.shareCurrencyId,
+            shareTreasuryCapId: params.shareTreasuryCapId,
+            compositionShareType: params.compositionShareType,
+            composition: tx.object(params.compositionId),
+            maxRoyaltyRateBps: params.maxRoyaltyRateBps,
+            misoPackageId: params.misoPackageId,
+        });
+        finalizeRecording(tx, {
+            ...parts,
+            recordingShareType: params.shareType,
+            compositionShareType: params.compositionShareType,
+            shareRecipients: params.shareRecipients,
+            adminAddress: params.adminAddress,
+            misoPackageId: params.misoPackageId,
+            minatoPackageId: params.minatoPackageId,
+        });
+    };
+}
+/**
+ * Publishes a composition and its recording in a single atomic PTB.
+ *
+ * The ordering is load-bearing: `recording::new` borrows the composition by
+ * immutable reference, so it must run while the composition is still an unshared,
+ * transaction-local value — i.e. AFTER `composition::new` but BEFORE
+ * `composition::publish` (which moves the composition into `share_object`). Hence:
+ * `composition::new` → `recording::new(&comp)` → finalize composition (publish) →
+ * finalize recording (publish).
+ */
+export function publishCompositionAndRecording(params) {
+    return (tx) => {
+        const comp = createComposition(tx, {
+            shareType: params.composition.shareType,
+            shareCurrencyId: params.composition.shareCurrencyId,
+            shareTreasuryCapId: params.composition.shareTreasuryCapId,
+            title: params.title,
+            royaltyRateBps: params.royaltyRateBps,
+            misoPackageId: params.misoPackageId,
+        });
+        // Borrow the still-unshared composition into recording::new before publishing it.
+        // The composition is created in this PTB with a known rate, so the slippage
+        // guard pins that exact value — front-running is structurally impossible here.
+        const rec = createRecording(tx, {
+            shareType: params.recording.shareType,
+            shareCurrencyId: params.recording.shareCurrencyId,
+            shareTreasuryCapId: params.recording.shareTreasuryCapId,
+            compositionShareType: params.composition.shareType,
+            composition: comp.composition,
+            maxRoyaltyRateBps: params.royaltyRateBps,
+            misoPackageId: params.misoPackageId,
+        });
+        finalizeComposition(tx, {
+            ...comp,
+            shareType: params.composition.shareType,
+            shareRecipients: params.composition.shareRecipients,
+            adminAddress: params.composition.adminAddress,
+            misoPackageId: params.misoPackageId,
+            minatoPackageId: params.minatoPackageId,
+        });
+        finalizeRecording(tx, {
+            ...rec,
+            recordingShareType: params.recording.shareType,
+            compositionShareType: params.composition.shareType,
+            shareRecipients: params.recording.shareRecipients,
+            adminAddress: params.recording.adminAddress,
+            misoPackageId: params.misoPackageId,
+            minatoPackageId: params.minatoPackageId,
+        });
+    };
+}
+/**
+ * The opinionated finish for a release: publish (share) it and transfer its
+ * admin cap to `adminAddress`.
+ *
+ * MUST run in the same PTB as the `createRelease` that produced these parts —
+ * `Release` is `key`-only with no `drop`, so an unpublished release cannot
+ * outlive its transaction. Splitting create from finalize is what lets a caller
+ * do something else with the cap (route it to a vault, hand it to another
+ * package, keep it for later commands) instead of a plain address transfer.
+ */
+export function finalizeRelease(tx, params) {
+    tx.add(release.publish({ package: params.misoPackageId, arguments: [params.release, params.adminCap] }));
+    tx.transferObjects([params.adminCap], tx.pure.address(params.adminAddress));
+}
+function buildTrackVec(tx, misoPackageId, trackArgs) {
+    return tx.makeMoveVec({ type: `${misoPackageId}::track::Track`, elements: trackArgs });
+}
+/**
+ * Convenience: publish a release end-to-end, assembling its tracklist from
+ * recording admin caps held by the sender (a deal is created inline per track).
+ */
+export function publishRelease(params) {
+    return (tx) => {
+        const { misoPackageId } = params;
+        const trackArgs = params.tracks.map((t) => {
+            const typeArguments = [t.recordingShareType, t.compositionShareType];
+            const dealArg = tx.add(deal._new({
+                package: misoPackageId,
+                typeArguments,
+                arguments: [tx.object(t.recordingAdminCapId), tx.object(t.recordingId), tx.pure.id(params.releaseId), tx.pure.u16(t.splitBps)],
+            }));
+            return tx.add(track._new({ package: misoPackageId, typeArguments, arguments: [dealArg, tx.object(t.recordingId)] }));
+        });
+        const parts = createRelease(tx, { title: params.title, nonce: params.releaseNonce, releaseRegistryId: params.releaseRegistryId, misoPackageId }, buildTrackVec(tx, misoPackageId, trackArgs));
+        finalizeRelease(tx, { ...parts, adminAddress: params.adminAddress, misoPackageId });
+    };
+}
+/**
+ * Convenience: publish a release end-to-end from pre-made `Deal`s held by the
+ * sender (each deal already pins this release's id).
+ */
+export function publishReleaseFromDeals(params) {
+    return (tx) => {
+        const { misoPackageId } = params;
+        const trackArgs = params.deals.map((dl) => tx.add(track._new({
+            package: misoPackageId,
+            typeArguments: [dl.recordingShareType, dl.compositionShareType],
+            arguments: [tx.object(dl.dealId), tx.object(dl.recordingId)],
+        })));
+        const parts = createRelease(tx, { title: params.title, nonce: params.releaseNonce, releaseRegistryId: params.releaseRegistryId, misoPackageId }, buildTrackVec(tx, misoPackageId, trackArgs));
+        finalizeRelease(tx, { ...parts, adminAddress: params.adminAddress, misoPackageId });
+    };
+}
+//# sourceMappingURL=transactions.js.map

package/dist/transactions.js.map

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

package/package.json

@@ -0,0 +1,99 @@
+{
+  "name": "@misofm/sdk",
+  "version": "0.1.0",
+  "description": "Typed query helpers and transaction builders for the Miso platform layer on Sui \u2014 pressings, listings, records, and opinionated work publishing.",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/misofm/sdk.git"
+  },
+  "homepage": "https://github.com/misofm/sdk#readme",
+  "bugs": {
+    "url": "https://github.com/misofm/sdk/issues"
+  },
+  "keywords": [
+    "sui",
+    "move",
+    "miso",
+    "music",
+    "blockchain",
+    "sdk",
+    "pressing"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "default": "./dist/client.js"
+    },
+    "./pressing": {
+      "types": "./dist/pressing.d.ts",
+      "default": "./dist/pressing.js"
+    },
+    "./transactions": {
+      "types": "./dist/transactions.d.ts",
+      "default": "./dist/transactions.js"
+    },
+    "./execute": {
+      "types": "./dist/execute.d.ts",
+      "default": "./dist/execute.js"
+    },
+    "./share": {
+      "types": "./dist/share.d.ts",
+      "default": "./dist/share.js"
+    },
+    "./share-template": {
+      "types": "./dist/share-template.d.ts",
+      "default": "./dist/share-template.js"
+    },
+    "./release-graph": {
+      "types": "./dist/release-graph.d.ts",
+      "default": "./dist/release-graph.js"
+    },
+    "./catalog": {
+      "types": "./dist/catalog.d.ts",
+      "default": "./dist/catalog.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "LICENSE",
+    "package.json"
+  ],
+  "scripts": {
+    "codegen": "sui-codegen generate",
+    "typecheck": "tsc --noEmit",
+    "test": "bun test",
+    "build": "tsc -p tsconfig.build.json",
+    "prepack": "tsc -p tsconfig.build.json",
+    "prepare": "tsc -p tsconfig.build.json"
+  },
+  "devDependencies": {
+    "@mysten/codegen": "^0.11.14",
+    "@mysten/move-bytecode-template": "^0.4.0",
+    "@mysten/sui": "^2.24.0",
+    "@types/bun": "^1.3.14"
+  },
+  "peerDependencies": {
+    "@mysten/move-bytecode-template": "^0.4.0",
+    "@mysten/sui": "^2.4.0",
+    "typescript": "^5"
+  },
+  "dependencies": {
+    "@misonetwork/sdk": "^0.2.2"
+  },
+  "main": "./dist/index.js"
+}

package/src/catalog.ts

@@ -0,0 +1,77 @@
+// Copyright (c) Miso Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
+// Composed catalog reads.
+//
+// `@misonetwork/sdk` exposes one-question reads: fetch an object by id, list the
+// caps an address owns, resolve a share type to its work. Stitching several of
+// those together to answer a PRODUCT question — "show me everything this artist
+// administers" — is orchestration, and it lives here for the same reason the
+// opinionated publish flows do: it picks a traversal strategy, decides how much
+// to fetch, and chooses a concurrency/rate-limit tradeoff. Those are platform
+// calls, not protocol facts.
+
+import type { ClientWithCoreApi } from "@mysten/sui/client";
+import type { SuiGraphQLClient } from "@mysten/sui/graphql";
+import {
+  getOwnedRecordingAdminCaps,
+  getRecordingByShareType,
+  type Recording,
+} from "@misonetwork/sdk";
+
+export interface GetAdministeredRecordingsOptions {
+  /**
+   * Maximum lookups in flight at once. The traversal is one lookup per admin
+   * cap, so an artist with a large catalog would otherwise open as many
+   * concurrent requests as they have recordings. Defaults to 10.
+   */
+  concurrency?: number;
+}
+
+/**
+ * Every `Recording` administered by `owner`.
+ *
+ * Two stages: list the owner's `RecordingAdminCap`s over the Core API, then
+ * resolve each cap's share type back to its recording.
+ *
+ * The second stage needs GraphQL and is inherently one lookup per cap, because
+ * `RecordingAdminCap` carries no back-pointer to its recording — unlike
+ * `ReleaseAdminCap`, which stores `release_id` and can therefore be resolved
+ * entirely over the Core API. The caps are derived objects (recording → cap via
+ * `deriveObjectID`), and that derivation cannot be inverted, so the share type
+ * is the only link back. Adding a `recording_id: ID` field to
+ * `RecordingAdminCap` on the protocol side would make this a pure Core-API
+ * batch read and remove both the GraphQL dependency and the fan-out.
+ *
+ * Until then the lookups run concurrently in bounded batches rather than
+ * serially.
+ */
+export async function getAdministeredRecordings(
+  client: ClientWithCoreApi,
+  graphqlClient: SuiGraphQLClient,
+  owner: string,
+  misoPackageId: string,
+  options: GetAdministeredRecordingsOptions = {},
+): Promise<Recording[]> {
+  const concurrency = Math.max(1, options.concurrency ?? 10);
+  const caps = await getOwnedRecordingAdminCaps(client, owner, misoPackageId);
+
+  const recordings: Recording[] = [];
+  for (let i = 0; i < caps.length; i += concurrency) {
+    const batch = caps.slice(i, i + concurrency);
+    const settled = await Promise.all(
+      batch.map(async (cap) => {
+        try {
+          return await getRecordingByShareType(client, graphqlClient, cap.shareType, misoPackageId);
+        } catch {
+          // A cap whose recording cannot be resolved is skipped rather than
+          // failing the whole catalog — matching the previous behavior, where a
+          // missing address was silently passed over.
+          return null;
+        }
+      }),
+    );
+    for (const rec of settled) if (rec) recordings.push(rec);
+  }
+  return recordings;
+}

package/src/client.ts

@@ -0,0 +1,249 @@
+// Copyright (c) Miso Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
+// The client extension — Sui's recommended shape for an SDK
+// (https://sdk.mystenlabs.com/sui/sdk-building). Register it once and the
+// platform layer hangs off whatever client you already have:
+//
+//   const client = new SuiGrpcClient({ network, baseUrl })
+//     .$extend(misoPlatform({ packageId, settingsId }));
+//
+//   await client.misoPlatform.getSale({ releaseId, currencyType });
+//   tx.add(client.misoPlatform.tx.buyRecord({ releaseId, currencyType, amount, recipient }));
+//
+// Two things this buys over calling the bare functions:
+//
+//   IDS ARE CONFIGURED ONCE. Every builder and reader below needs the pressing
+//   package id, and half of them need the record `Settings` too. Threading those
+//   through 20 call sites is how an app ends up publishing against one package and
+//   reading against another.
+//
+//   IT COMPOSES. `register` takes the transport-agnostic `ClientWithCoreApi`, never
+//   a concrete client, so this works on gRPC, GraphQL, or JSON-RPC — and the
+//   builders stay thunks, so a platform call and a protocol call go in the same PTB.
+//
+// Namespaces follow the guide's convention: top-level methods read and parse,
+// `tx` builds transactions without executing, `bcs` exposes the generated struct
+// definitions, `ids` is the address math that replaces a registry.
+
+import type { ClientWithCoreApi } from "@mysten/sui/client";
+import type { Signer } from "@mysten/sui/cryptography";
+
+import * as listingContract from "./contracts/miso_pressing/listing.ts";
+import * as pressingContract from "./contracts/miso_pressing/pressing.ts";
+import {
+  buyRecord,
+  deriveListingId,
+  derivePressingAdminCapId,
+  derivePressingId,
+  deriveSaleIds,
+  getListing,
+  getPressing,
+  getSale,
+  openListing,
+  openPressing,
+  setListingPrice,
+  setListingState,
+  setPressingState,
+} from "./pressing.ts";
+import type {
+  BuyRecordParams,
+  GetSaleParams,
+  ListingView,
+  OpenListingParams,
+  OpenPressingParams,
+  PressingView,
+  SetListingPriceParams,
+  SetListingStateParams,
+  SetPressingStateParams,
+} from "./pressing.ts";
+import {
+  publishShareCurrency,
+  initializeShareCurrency,
+  publishComposition,
+  publishRecording,
+  publishCompositionAndRecording,
+} from "./transactions.ts";
+import type {
+  TxThunk,
+  PublishCompositionParams,
+  PublishRecordingParams,
+  PublishCompositionAndRecordingParams,
+} from "./transactions.ts";
+import * as share from "./share.ts";
+
+export interface MisoPlatformConfig {
+  /** The published `miso_pressing` package. */
+  packageId: string;
+  /**
+   * The `miso_record` shared `Settings` that authorizes `miso_pressing`'s
+   * `MintWitness`. Required to buy; optional if this client only ever reads.
+   */
+  settingsId?: string;
+  /**
+   * The `@misonetwork/sdk` protocol package (miso core). Required for the
+   * publish builders (`publishComposition`, `publishRecording`,
+   * `publishCompositionAndRecording`) — optional if this client only ever
+   * sells pressed records.
+   */
+  misoPackageId?: string;
+  /**
+   * The minato share-disperse package. Bound into the publish builders so
+   * callers don't repeat it; required alongside `misoPackageId` for the same
+   * builders (they disperse shares via minato).
+   */
+  minatoPackageId?: string;
+}
+
+/** Params with the ids this client already knows dropped from the call site. */
+type Configured<T> = Omit<T, "misoPressingPackageId" | "settingsId">;
+
+/** Publish-builder params with the protocol/minato ids this client already knows dropped. */
+type ConfiguredPublish<T> = Omit<T, "misoPackageId" | "minatoPackageId">;
+
+export class MisoPlatformClient {
+  readonly #client: ClientWithCoreApi;
+  readonly #config: MisoPlatformConfig;
+
+  constructor(client: ClientWithCoreApi, config: MisoPlatformConfig) {
+    this.#client = client;
+    this.#config = config;
+  }
+
+  get packageId(): string {
+    return this.#config.packageId;
+  }
+
+  #settings(): string {
+    const { settingsId } = this.#config;
+    if (!settingsId) {
+      throw new Error(
+        "misoPlatform: `settingsId` is required to build a purchase — pass it to misoPlatform({ settingsId }).",
+      );
+    }
+    return settingsId;
+  }
+
+  #misoPackageId(): string {
+    const { misoPackageId } = this.#config;
+    if (!misoPackageId) {
+      throw new Error(
+        "misoPlatform: `misoPackageId` is required for the publish builders " +
+          "(publishComposition, publishRecording, publishCompositionAndRecording) — pass it to misoPlatform({ misoPackageId }).",
+      );
+    }
+    return misoPackageId;
+  }
+
+  #minatoPackageId(): string {
+    const { minatoPackageId } = this.#config;
+    if (!minatoPackageId) {
+      throw new Error(
+        "misoPlatform: `minatoPackageId` is required for the publish builders that disperse shares " +
+          "(publishComposition, publishRecording, publishCompositionAndRecording) — pass it to misoPlatform({ minatoPackageId }).",
+      );
+    }
+    return minatoPackageId;
+  }
+
+  // ── Reads ─────────────────────────────────────────────────────────────────
+
+  /** The run itself, or `null` if this release has never opened one. */
+  getPressing(pressingId: string): Promise<PressingView | null> {
+    return getPressing(this.#client, pressingId);
+  }
+
+  /** One currency's offer, or `null` if the run does not sell in it. */
+  getListing(listingId: string): Promise<ListingView | null> {
+    return getListing(this.#client, listingId);
+  }
+
+  /** Run + one currency's offer in a single round trip, by address math. */
+  getSale(p: Configured<GetSaleParams>): Promise<{
+    pressing: PressingView | null;
+    listing: ListingView | null;
+  }> {
+    return getSale(this.#client, { ...p, misoPressingPackageId: this.packageId });
+  }
+
+  // ── Address math ──────────────────────────────────────────────────────────
+
+  readonly ids = {
+    pressing: (releaseId: string) => derivePressingId(releaseId, this.packageId),
+    pressingAdminCap: (pressingId: string) =>
+      derivePressingAdminCapId(pressingId, this.packageId),
+    listing: (pressingId: string, currencyType: string) =>
+      deriveListingId(pressingId, currencyType, this.packageId),
+    sale: (releaseId: string, currencyType: string) =>
+      deriveSaleIds(releaseId, currencyType, this.packageId),
+  };
+
+  // ── Transaction builders ──────────────────────────────────────────────────
+
+  readonly tx = {
+    buyRecord: (p: Configured<BuyRecordParams>): TxThunk =>
+      buyRecord({
+        ...p,
+        settingsId: this.#settings(),
+        misoPressingPackageId: this.packageId,
+      }),
+    openPressing: (p: Configured<OpenPressingParams>): TxThunk =>
+      openPressing({ ...p, misoPressingPackageId: this.packageId }),
+    openListing: (p: Configured<OpenListingParams>): TxThunk =>
+      openListing({ ...p, misoPressingPackageId: this.packageId }),
+    setListingPrice: (p: Configured<SetListingPriceParams>): TxThunk =>
+      setListingPrice({ ...p, misoPressingPackageId: this.packageId }),
+    setListingState: (p: Configured<SetListingStateParams>): TxThunk =>
+      setListingState({ ...p, misoPressingPackageId: this.packageId }),
+    setPressingState: (p: Configured<SetPressingStateParams>): TxThunk =>
+      setPressingState({ ...p, misoPressingPackageId: this.packageId }),
+
+    // Publishing (protocol works + minato share economics) — package-id-free
+    // builders pass through unchanged; the rest bind this client's
+    // `misoPackageId`/`minatoPackageId`, throwing at call time if either is
+    // missing (kept optional on the client so a sell-only client, e.g. a
+    // storefront that never mints new works, doesn't need to carry them).
+    publishShareCurrency,
+    initializeShareCurrency,
+    publishComposition: (p: ConfiguredPublish<PublishCompositionParams>): TxThunk =>
+      publishComposition({ ...p, misoPackageId: this.#misoPackageId(), minatoPackageId: this.#minatoPackageId() }),
+    publishRecording: (p: ConfiguredPublish<PublishRecordingParams>): TxThunk =>
+      publishRecording({ ...p, misoPackageId: this.#misoPackageId(), minatoPackageId: this.#minatoPackageId() }),
+    publishCompositionAndRecording: (p: ConfiguredPublish<PublishCompositionAndRecordingParams>): TxThunk =>
+      publishCompositionAndRecording({ ...p, misoPackageId: this.#misoPackageId(), minatoPackageId: this.#minatoPackageId() }),
+  };
+
+  // ── Share currency provisioning (executes; Signer pattern) ─────────────────
+
+  /** Publishes + initializes a fresh share currency (two txs). */
+  async createShareCurrency(signer: Signer, params: share.CreateShareCurrencyParams): Promise<share.ShareCurrency> {
+    return share.createShareCurrency(this.#client, signer, params);
+  }
+
+  // ── Generated layer ───────────────────────────────────────────────────────
+
+  /** Generated Move-call bindings, for commands this facade doesn't wrap. */
+  readonly call = { listing: listingContract, pressing: pressingContract };
+
+  /** Generated BCS definitions, for parsing objects or events yourself. */
+  readonly bcs = {
+    Pressing: pressingContract.Pressing,
+    PressingAdminCap: pressingContract.PressingAdminCap,
+    Listing: listingContract.Listing,
+    Price: listingContract.Price,
+  };
+}
+
+/**
+ * Registers the platform layer on a Sui client. Pass the result to `$extend`.
+ *
+ * `settingsId` is optional so a read-only client (an indexer, a catalog page) can
+ * skip it; asking to build a purchase without it throws rather than sending a
+ * transaction against the wrong `Settings`.
+ */
+export function misoPlatform(config: MisoPlatformConfig) {
+  return {
+    name: "misoPlatform" as const,
+    register: (client: ClientWithCoreApi) => new MisoPlatformClient(client, config),
+  };
+}