@misofm/sdk 0.6.0 → 0.8.0

package/README.md

@@ -62,14 +62,17 @@ Register the extension on any client implementing Sui's Core API
 ```ts
 import { SuiGrpcClient } from "@mysten/sui/grpc";
 import { Transaction } from "@mysten/sui/transactions";
-import { misoPlatform } from "@misofm/sdk";
+import { miso } from "@misofm/sdk";
 
 const client = new SuiGrpcClient({ network: "testnet", baseUrl }).$extend(
-  misoPlatform({ packageId: MISO_PRESSING_PACKAGE_ID, settingsId: MISO_RECORD_SETTINGS_ID }),
+  miso(),
 );
 
+// The permissionless protocol SDK is part of the same facade.
+const release = await client.miso.protocol.getReleaseById(releaseId);
+
 // Read: run + one currency's offer, one round trip, no registry lookup.
-const { pressing, listing } = await client.misoPlatform.getSale({
+const { pressing, listing } = await client.miso.getSale({
   releaseId,
   currencyType: USD_COIN_TYPE,
 });
@@ -77,7 +80,7 @@ const { pressing, listing } = await client.misoPlatform.getSale({
 // Write: a thunk, so it composes with protocol calls in the same PTB.
 const tx = new Transaction();
 tx.add(
-  client.misoPlatform.tx.buyRecord({
+  client.miso.tx.buyRecord({
     releaseId,
     currencyType: USD_COIN_TYPE,
     amount: listing.price.amount,
@@ -93,6 +96,11 @@ Holding the ids yourself? Every builder and reader is exported bare, taking
 import { buyRecord, getSale } from "@misofm/sdk/pressing";
 ```
 
+Mainnet is selected automatically once the complete platform deployment is
+included in this SDK. Until then, registering `miso()` on a Mainnet client fails
+closed. Localnet, Devnet, forks, and private deployments can provide one complete
+explicit deployment through `miso({ deployment })`.
+
 ### High-level platform reads
 
 `@misofm/sdk/read` turns protocol, pressing, PartyOS, credits, cover, and wallet
@@ -179,21 +187,17 @@ back its by-value parts (the object, its admin cap, its freshly-minted share
 supplies the opinionated finish on top:
 
 ```ts
-import { misoPlatform } from "@misofm/sdk";
+import { miso } from "@misofm/sdk";
 
 const client = new SuiGrpcClient({ network: "testnet", baseUrl }).$extend(
-  misoPlatform({
-    packageId: MISO_PRESSING_PACKAGE_ID,
-    misoPackageId: MISO_PROTOCOL_PACKAGE_ID,   // required for publish builders
-    minatoPackageId: MINATO_PACKAGE_ID,        // required — they disperse shares via minato
-  }),
+  miso(),
 );
 
 // Mints the composition's share supply, disperses it to shareRecipients via
 // minato, publishes (shares) the composition, and transfers the
 // CompositionAdminCap to adminAddress — createComposition → finalizeComposition
 // in one PTB.
-const thunk = client.misoPlatform.tx.publishComposition({
+const thunk = client.miso.tx.publishComposition({
   title: "Song Title",
   royaltyRateBps: 1000,
   shareType: "0x...::share::Share",
@@ -204,13 +208,13 @@ const thunk = client.misoPlatform.tx.publishComposition({
 });
 ```
 
-`client.misoPlatform.tx.publishRecording` and `publishCompositionAndRecording`
+`client.miso.tx.publishRecording` and `publishCompositionAndRecording`
 follow the same shape (the latter atomically, borrow-before-share, in one PTB —
 see `@misonetwork/sdk`'s README for why the ordering is load-bearing).
-`misoPackageId`/`minatoPackageId` are optional on the client — a sell-only
-client (e.g. a storefront that never mints new works) can omit them; the
-publish builders throw at call time, not at client construction, if they're
-missing.
+The protocol, pressing, record-settings, minato, and release-coordinator
+addresses all come from the deployment selected by the Sui client's network.
+The deprecated `misoPlatform()` constructor still accepts those values manually
+for compatibility with existing integrations.
 
 For custom PTBs, the bare primitives (`disperseShares`, `finalizeComposition`,
 `finalizeRecording`) and the whole-graph orchestrator are exported standalone:
@@ -218,7 +222,7 @@ For custom PTBs, the bare primitives (`disperseShares`, `finalizeComposition`,
 ```ts
 import { publishReleaseGraph } from "@misofm/sdk";
 
-// Every composition and recording, optional royalty pools, deals/tracks, and
+// Every composition and recording, optional royalty pools, tracks, and
 // the release — with the release id derived ON-CHAIN — in one atomic PTB.
 const thunk = publishReleaseGraph({
   compositions: [{ shareType, shareCurrencyId, shareTreasuryCapId, title: "Song", royaltyRateBps: 1000, shareRecipients, adminAddress }],
@@ -232,6 +236,7 @@ const thunk = publishReleaseGraph({
   },
   misoPackageId: "0x...",
   minatoPackageId: "0x...",
+  releaseRegistryPackageId: "0x...",
 });
 ```
 
@@ -244,7 +249,7 @@ Publish and initialize are necessarily two transactions:
 
 ```ts
 // Sequential (one currency, two txs):
-const currency = await client.misoPlatform.createShareCurrency(signer, {
+const currency = await client.miso.createShareCurrency(signer, {
   name: "Song Shares",
   description: "…",
 });
@@ -373,7 +378,8 @@ carry an optional `RecordingRoleLevel` (`Producer`, `Vocalist`, `Engineer`,
 
 ```
 src/
-  client.ts              the client extension — misoPlatform({ packageId, settingsId, misoPackageId?, minatoPackageId? })
+  deployments.ts         baked per-network package and singleton object ids
+  client.ts              the full client.miso facade; protocol lives at client.miso.protocol
   pressing.ts            facade: builders, readers, and the id derivations
   queries.ts             shared read plumbing (isNotFound, re-exported from @misonetwork/sdk)
   transactions.ts        the TxThunk contract + the opinionated publish flow (disperse/finalize/publish*)
@@ -401,24 +407,26 @@ the on-chain ABI:
 bun run codegen   # reads sui-codegen.config.ts → src/contracts/
 ```
 
-`sui-codegen.config.ts` lists the **platform** package (`miso_pressing`) and the
+`sui-codegen.config.ts` lists the **platform** package (`miso_pressing`), the
+canonical release-minting extension (`release_registry`), and the
 first-party **extension** packages (`royalty_pool`, `composition_royalty_pool`,
 `recording_royalty_pool`, `cover_art`, `release_cover_art`,
 `composition_credits`, `recording_credits`, `release_credits`). The protocol
-CORE (`miso` — composition/recording/release/deal/track) generates into
+CORE (`miso` — composition/recording/release/track) generates into
 `@misonetwork/sdk` instead, which this package depends on for those bindings —
 adding the core here to save an import is how the split this package exists to
 enforce gets undone.
 
 Paths resolve against sibling checkouts, so regenerating requires
-`~/Documents/GitHub/misofm/{sdk, pressing, protocol-extensions}`.
+`~/Documents/GitHub/misofm/{sdk, pressing, protocol-extensions}` and
+`~/Documents/GitHub/misonetwork/{protocol, share}`.
 
 ## Dependency on `@misonetwork/sdk`
 
-`@misonetwork/sdk` is a `dependencies` entry (not a peer) — this package
-imports its bare primitives and types directly, rather than registering it as
-a second client extension via `$extend`, so it isn't the "avoid bundling two
-copies of a Mysten package" situation the peer-dependency guidance targets.
+`@misonetwork/sdk` is a `dependencies` entry (not a peer). This package imports
+its primitives, deployment configuration, and protocol client directly, then
+wraps that client at `client.miso.protocol`; applications do not install or
+register a second protocol extension.
 `@mysten/sui` itself stays a peer dependency here, same as in
 `@misonetwork/sdk`.
 
@@ -432,8 +440,8 @@ bun install
 ```
 
 If you are changing both packages at once, `bun link` still works for a local
-loop — register the protocol SDK with `bun link` in its checkout, `bun link
-@misonetwork/sdk` here, and remember to put the version range back before
-committing. Note that `file:` does NOT work for this: Bun copies a `file:`
+loop — register the protocol SDK with `bun link` in its checkout, then run `bun
+link @misonetwork/sdk` here. Keep `@misonetwork/sdk` at its released semver
+range (`^0.6.0`) when committing. Note that `file:` does NOT work for this: Bun copies a `file:`
 dependency while honouring `.gitignore`, and `@misonetwork/sdk` builds to a
 gitignored `dist/`, so the copy arrives empty and nothing resolves.

package/dist/client.d.ts

@@ -1,11 +1,23 @@
-import type { ClientWithCoreApi } from "@mysten/sui/client";
+import type { ClientWithCoreApi, SuiClientRegistration } from "@mysten/sui/client";
 import type { Signer } from "@mysten/sui/cryptography";
+import type { SuiGraphQLClient } from "@mysten/sui/graphql";
+import { type MisoProtocolClient } from "@misonetwork/sdk/client";
 import * as listingContract from "./contracts/miso_pressing/listing.ts";
 import * as pressingContract from "./contracts/miso_pressing/pressing.ts";
+import * as releaseRegistry from "./contracts/release_registry/release_registry.ts";
 import type { BuyRecordParams, GetSaleParams, ListingView, OpenListingParams, OpenPressingParams, PressingView, SetListingPriceParams, SetListingStateParams, SetPressingStateParams } from "./pressing.ts";
 import { publishShareCurrency, initializeShareCurrency } from "./transactions.ts";
-import type { TxThunk, PublishCompositionParams, PublishRecordingParams, PublishCompositionAndRecordingParams } from "./transactions.ts";
+import type { TxThunk, PublishCompositionParams, PublishRecordingParams, PublishCompositionAndRecordingParams, PublishReleaseParams } from "./transactions.ts";
 import * as share from "./share.ts";
+import { type MisoPlatformDeployment } from "./deployments.ts";
+export interface MisoOptions<Name extends string = "miso"> {
+    /** Name for the client extension. Defaults to `miso`. */
+    name?: Name;
+    /** Complete custom deployment; omit to select the bundled client network. */
+    deployment?: MisoPlatformDeployment;
+    /** Required only by protocol methods that perform global type discovery. */
+    graphqlClient?: SuiGraphQLClient;
+}
 export interface MisoPlatformConfig {
     /** The published `miso_pressing` package. */
     packageId: string;
@@ -27,14 +39,24 @@ export interface MisoPlatformConfig {
      * builders (they disperse shares via minato).
      */
     minatoPackageId?: string;
+    /** The published `release_registry` extension package used to mint releases. */
+    releaseRegistryPackageId?: string;
+    /** The one shared `ReleaseRegistry` object created by that package's `init`. */
+    releaseRegistryId?: 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">;
+/** Release-builder params with this client's core, share, and registry ids dropped. */
+type ConfiguredRelease<T> = Omit<T, "misoPackageId" | "minatoPackageId" | "releaseRegistryPackageId" | "releaseRegistryId">;
 export declare class MisoPlatformClient {
     #private;
-    constructor(client: ClientWithCoreApi, config: MisoPlatformConfig);
+    /** The permissionless protocol layer wrapped by this platform facade. */
+    readonly protocol: MisoProtocolClient;
+    /** Bundled/custom deployment selected for the full facade, when available. */
+    readonly deployment?: MisoPlatformDeployment;
+    constructor(client: ClientWithCoreApi, config: MisoPlatformConfig, protocol?: MisoProtocolClient, deployment?: MisoPlatformDeployment);
     get packageId(): string;
     /** The run itself, or `null` if this release has never opened one. */
     getPressing(pressingId: string): Promise<PressingView | null>;
@@ -66,13 +88,15 @@ export declare class MisoPlatformClient {
         publishComposition: (p: ConfiguredPublish<PublishCompositionParams>) => TxThunk;
         publishRecording: (p: ConfiguredPublish<PublishRecordingParams>) => TxThunk;
         publishCompositionAndRecording: (p: ConfiguredPublish<PublishCompositionAndRecordingParams>) => TxThunk;
+        publishRelease: (p: ConfiguredRelease<PublishReleaseParams>) => TxThunk;
     };
     /** Publishes + initializes a fresh share currency (two txs). */
     createShareCurrency(signer: Signer, params: share.CreateShareCurrencyParams): Promise<share.ShareCurrency>;
     /** Generated Move-call bindings, for commands this facade doesn't wrap. */
-    readonly call: {
+    get call(): {
         listing: typeof listingContract;
         pressing: typeof pressingContract;
+        releaseRegistry: typeof releaseRegistry;
     };
     /** Generated BCS definitions, for parsing objects or events yourself. */
     readonly bcs: {
@@ -117,10 +141,27 @@ export declare class MisoPlatformClient {
                 amount: import("@mysten/bcs").BcsType<string, string | number | bigint, "u64">;
             }, "Price.Floor">;
         }, "@local-pkg/miso_pressing::listing::Price">;
+        ReleaseRegistry: import("./contracts/utils/index.ts").MoveStruct<{
+            id: import("@mysten/bcs").BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
+        }, "@local-pkg/release_registry::release_registry::ReleaseRegistry">;
+        ReleaseRegistryCreatedEvent: import("./contracts/utils/index.ts").MoveStruct<{
+            registry_id: import("@mysten/bcs").BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
+            created_by: import("@mysten/bcs").BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
+        }, "@local-pkg/release_registry::release_registry::ReleaseRegistryCreatedEvent">;
     };
 }
+/** The full Miso client exposed by `@misofm/sdk`. */
+export { MisoPlatformClient as MisoClient };
+/**
+ * Registers the complete Miso facade at `client.miso`.
+ *
+ * Platform operations live directly on `client.miso`; the lower-level
+ * permissionless protocol SDK is available at `client.miso.protocol`.
+ */
+export declare function miso<const Name extends string = "miso">(options?: MisoOptions<Name>): SuiClientRegistration<ClientWithCoreApi, Name, MisoPlatformClient>;
 /**
- * Registers the platform layer on a Sui client. Pass the result to `$extend`.
+ * @deprecated Prefer zero-config `miso()`, which registers the complete facade
+ * at `client.miso` and exposes the protocol layer at `client.miso.protocol`.
  *
  * `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
@@ -130,5 +171,4 @@ export declare function misoPlatform(config: MisoPlatformConfig): {
     name: "misoPlatform";
     register: (client: ClientWithCoreApi) => MisoPlatformClient;
 };
-export {};
 //# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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

package/dist/client.js

@@ -1,16 +1,42 @@
 // Copyright (c) Miso Labs, Inc.
 // SPDX-License-Identifier: Apache-2.0
+import { miso as protocolMiso, } from "@misonetwork/sdk/client";
 import * as listingContract from "./contracts/miso_pressing/listing.js";
 import * as pressingContract from "./contracts/miso_pressing/pressing.js";
+import * as releaseRegistry from "./contracts/release_registry/release_registry.js";
 import { buyRecord, deriveListingId, derivePressingAdminCapId, derivePressingId, deriveSaleIds, getListing, getPressing, getSale, openListing, openPressing, setListingPrice, setListingState, setPressingState, } from "./pressing.js";
-import { publishShareCurrency, initializeShareCurrency, publishComposition, publishRecording, publishCompositionAndRecording, } from "./transactions.js";
+import { publishShareCurrency, initializeShareCurrency, publishComposition, publishRecording, publishCompositionAndRecording, publishRelease, } from "./transactions.js";
 import * as share from "./share.js";
+import { getMisoPlatformDeployment, } from "./deployments.js";
+/** Defaults `options.package` to `pkg` for every generated call function. */
+function bindModulePackage(mod, pkg) {
+    const out = {};
+    for (const [key, value] of Object.entries({ ...mod })) {
+        out[key] =
+            typeof value === "function"
+                ? (options) => value({ package: pkg, ...options })
+                : value;
+    }
+    return out;
+}
 export class MisoPlatformClient {
     #client;
     #config;
-    constructor(client, config) {
+    /** The permissionless protocol layer wrapped by this platform facade. */
+    protocol;
+    /** Bundled/custom deployment selected for the full facade, when available. */
+    deployment;
+    constructor(client, config, protocol, deployment) {
         this.#client = client;
         this.#config = config;
+        this.protocol =
+            protocol ??
+                protocolMiso({
+                    deployment: config.misoPackageId
+                        ? { packageId: config.misoPackageId }
+                        : undefined,
+                }).register(client);
+        this.deployment = deployment;
     }
     get packageId() {
         return this.#config.packageId;
@@ -26,7 +52,7 @@ export class MisoPlatformClient {
         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 }).");
+                "(publishComposition, publishRecording, publishCompositionAndRecording, publishRelease) — pass it to misoPlatform({ misoPackageId }).");
         }
         return misoPackageId;
     }
@@ -38,6 +64,13 @@ export class MisoPlatformClient {
         }
         return minatoPackageId;
     }
+    #releaseRegistry() {
+        const { releaseRegistryPackageId: packageId, releaseRegistryId: id } = this.#config;
+        if (!packageId || !id) {
+            throw new Error("misoPlatform: `releaseRegistryPackageId` and `releaseRegistryId` are required to build a release — pass both to misoPlatform(...).");
+        }
+        return { packageId, id };
+    }
     // ── Reads ─────────────────────────────────────────────────────────────────
     /** The run itself, or `null` if this release has never opened one. */
     getPressing(pressingId) {
@@ -80,6 +113,15 @@ export class MisoPlatformClient {
         publishComposition: (p) => publishComposition({ ...p, misoPackageId: this.#misoPackageId(), minatoPackageId: this.#minatoPackageId() }),
         publishRecording: (p) => publishRecording({ ...p, misoPackageId: this.#misoPackageId(), minatoPackageId: this.#minatoPackageId() }),
         publishCompositionAndRecording: (p) => publishCompositionAndRecording({ ...p, misoPackageId: this.#misoPackageId(), minatoPackageId: this.#minatoPackageId() }),
+        publishRelease: (p) => {
+            const registry = this.#releaseRegistry();
+            return publishRelease({
+                ...p,
+                misoPackageId: this.#misoPackageId(),
+                releaseRegistryPackageId: registry.packageId,
+                releaseRegistryId: registry.id,
+            });
+        },
     };
     // ── Share currency provisioning (executes; Signer pattern) ─────────────────
     /** Publishes + initializes a fresh share currency (two txs). */
@@ -88,17 +130,57 @@ export class MisoPlatformClient {
     }
     // ── Generated layer ───────────────────────────────────────────────────────
     /** Generated Move-call bindings, for commands this facade doesn't wrap. */
-    call = { listing: listingContract, pressing: pressingContract };
+    get call() {
+        return {
+            listing: bindModulePackage(listingContract, this.packageId),
+            pressing: bindModulePackage(pressingContract, this.packageId),
+            releaseRegistry: this.#config.releaseRegistryPackageId
+                ? bindModulePackage(releaseRegistry, this.#config.releaseRegistryPackageId)
+                : releaseRegistry,
+        };
+    }
     /** Generated BCS definitions, for parsing objects or events yourself. */
     bcs = {
         Pressing: pressingContract.Pressing,
         PressingAdminCap: pressingContract.PressingAdminCap,
         Listing: listingContract.Listing,
         Price: listingContract.Price,
+        ReleaseRegistry: releaseRegistry.ReleaseRegistry,
+        ReleaseRegistryCreatedEvent: releaseRegistry.ReleaseRegistryCreatedEvent,
+    };
+}
+/** The full Miso client exposed by `@misofm/sdk`. */
+export { MisoPlatformClient as MisoClient };
+/**
+ * Registers the complete Miso facade at `client.miso`.
+ *
+ * Platform operations live directly on `client.miso`; the lower-level
+ * permissionless protocol SDK is available at `client.miso.protocol`.
+ */
+export function miso(options = {}) {
+    const name = (options.name ?? "miso");
+    return {
+        name,
+        register: (client) => {
+            const deployment = options.deployment ?? getMisoPlatformDeployment(client.network);
+            const protocol = protocolMiso({
+                deployment: deployment.protocol,
+                graphqlClient: options.graphqlClient,
+            }).register(client);
+            return new MisoPlatformClient(client, {
+                packageId: deployment.packages.pressing,
+                settingsId: deployment.objects.recordSettings,
+                misoPackageId: deployment.protocol.packageId,
+                minatoPackageId: deployment.packages.minato,
+                releaseRegistryPackageId: deployment.packages.releaseRegistry,
+                releaseRegistryId: deployment.objects.releaseRegistry,
+            }, protocol, deployment);
+        },
     };
 }
 /**
- * Registers the platform layer on a Sui client. Pass the result to `$extend`.
+ * @deprecated Prefer zero-config `miso()`, which registers the complete facade
+ * at `client.miso` and exposes the protocol layer at `client.miso.protocol`.
  *
  * `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
@@ -107,7 +189,16 @@ export class MisoPlatformClient {
 export function misoPlatform(config) {
     return {
         name: "misoPlatform",
-        register: (client) => new MisoPlatformClient(client, config),
+        register: (client) => {
+            const protocol = protocolMiso({
+                deployment: config.misoPackageId
+                    ? {
+                        packageId: config.misoPackageId,
+                    }
+                    : undefined,
+            }).register(client);
+            return new MisoPlatformClient(client, config, protocol);
+        },
     };
 }
 //# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,sCAAsC;AAiCtC,OAAO,EACL,IAAI,IAAI,YAAY,GAErB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,KAAK,eAAe,MAAM,sCAAsC,CAAC;AACxE,OAAO,KAAK,gBAAgB,MAAM,uCAAuC,CAAC;AAC1E,OAAO,KAAK,eAAe,MAAM,kDAAkD,CAAC;AACpF,OAAO,EACL,SAAS,EACT,eAAe,EACf,wBAAwB,EACxB,gBAAgB,EAChB,aAAa,EACb,UAAU,EACV,WAAW,EACX,OAAO,EACP,WAAW,EACX,YAAY,EACZ,eAAe,EACf,eAAe,EACf,gBAAgB,GACjB,MAAM,eAAe,CAAC;AAYvB,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,kBAAkB,EAClB,gBAAgB,EAChB,8BAA8B,EAC9B,cAAc,GACf,MAAM,mBAAmB,CAAC;AAQ3B,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC;AACpC,OAAO,EACL,yBAAyB,GAE1B,MAAM,kBAAkB,CAAC;AAE1B,6EAA6E;AAC7E,SAAS,iBAAiB,CAAmB,GAAM,EAAE,GAAW;IAC9D,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC,EAAE,CAAC;QACtD,GAAG,CAAC,GAAG,CAAC;YACN,OAAO,KAAK,KAAK,UAAU;gBACzB,CAAC,CAAC,CAAC,OAA6B,EAAE,EAAE,CAC/B,KAAiC,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC;gBACpE,CAAC,CAAC,KAAK,CAAC;IACd,CAAC;IACD,OAAO,GAAQ,CAAC;AAClB,CAAC;AA+CD,MAAM,OAAO,kBAAkB;IACpB,OAAO,CAAoB;IAC3B,OAAO,CAAqB;IACrC,yEAAyE;IAChE,QAAQ,CAAqB;IACtC,8EAA8E;IACrE,UAAU,CAA0B;IAE7C,YACE,MAAyB,EACzB,MAA0B,EAC1B,QAA6B,EAC7B,UAAmC;QAEnC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,QAAQ;YACX,QAAQ;gBACR,YAAY,CAAC;oBACX,UAAU,EAAE,MAAM,CAAC,aAAa;wBAC9B,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,aAAa,EAAE;wBACrC,CAAC,CAAC,SAAS;iBACd,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACtB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC;IAChC,CAAC;IAED,SAAS;QACP,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;QACpC,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CACb,uGAAuG,CACxG,CAAC;QACJ,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,cAAc;QACZ,MAAM,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;QACvC,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CACb,qEAAqE;gBACnE,sIAAsI,CACzI,CAAC;QACJ,CAAC;QACD,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,gBAAgB;QACd,MAAM,EAAE,eAAe,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;QACzC,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CACb,4FAA4F;gBAC1F,wHAAwH,CAC3H,CAAC;QACJ,CAAC;QACD,OAAO,eAAe,CAAC;IACzB,CAAC;IAED,gBAAgB;QACd,MAAM,EAAE,wBAAwB,EAAE,SAAS,EAAE,iBAAiB,EAAE,EAAE,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;QACpF,IAAI,CAAC,SAAS,IAAI,CAAC,EAAE,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CACb,oIAAoI,CACrI,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;IAC3B,CAAC;IAED,6EAA6E;IAE7E,sEAAsE;IACtE,WAAW,CAAC,UAAkB;QAC5B,OAAO,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAC/C,CAAC;IAED,sEAAsE;IACtE,UAAU,CAAC,SAAiB;QAC1B,OAAO,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAC7C,CAAC;IAED,0EAA0E;IAC1E,OAAO,CAAC,CAA4B;QAIlC,OAAO,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,GAAG,CAAC,EAAE,qBAAqB,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IAChF,CAAC;IAED,6EAA6E;IAEpE,GAAG,GAAG;QACb,QAAQ,EAAE,CAAC,SAAiB,EAAE,EAAE,CAAC,gBAAgB,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC;QAC5E,gBAAgB,EAAE,CAAC,UAAkB,EAAE,EAAE,CACvC,wBAAwB,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC;QACtD,OAAO,EAAE,CAAC,UAAkB,EAAE,YAAoB,EAAE,EAAE,CACpD,eAAe,CAAC,UAAU,EAAE,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC;QAC3D,IAAI,EAAE,CAAC,SAAiB,EAAE,YAAoB,EAAE,EAAE,CAChD,aAAa,CAAC,SAAS,EAAE,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC;KACzD,CAAC;IAEF,6EAA6E;IAEpE,EAAE,GAAG;QACZ,SAAS,EAAE,CAAC,CAA8B,EAAW,EAAE,CACrD,SAAS,CAAC;YACR,GAAG,CAAC;YACJ,UAAU,EAAE,IAAI,CAAC,SAAS,EAAE;YAC5B,qBAAqB,EAAE,IAAI,CAAC,SAAS;SACtC,CAAC;QACJ,YAAY,EAAE,CAAC,CAAiC,EAAW,EAAE,CAC3D,YAAY,CAAC,EAAE,GAAG,CAAC,EAAE,qBAAqB,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;QAC/D,WAAW,EAAE,CAAC,CAAgC,EAAW,EAAE,CACzD,WAAW,CAAC,EAAE,GAAG,CAAC,EAAE,qBAAqB,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;QAC9D,eAAe,EAAE,CAAC,CAAoC,EAAW,EAAE,CACjE,eAAe,CAAC,EAAE,GAAG,CAAC,EAAE,qBAAqB,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;QAClE,eAAe,EAAE,CAAC,CAAoC,EAAW,EAAE,CACjE,eAAe,CAAC,EAAE,GAAG,CAAC,EAAE,qBAAqB,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;QAClE,gBAAgB,EAAE,CAAC,CAAqC,EAAW,EAAE,CACnE,gBAAgB,CAAC,EAAE,GAAG,CAAC,EAAE,qBAAqB,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;QAEnE,yEAAyE;QACzE,+DAA+D;QAC/D,wEAAwE;QACxE,qEAAqE;QACrE,sEAAsE;QACtE,oBAAoB;QACpB,uBAAuB;QACvB,kBAAkB,EAAE,CAAC,CAA8C,EAAW,EAAE,CAC9E,kBAAkB,CAAC,EAAE,GAAG,CAAC,EAAE,aAAa,EAAE,IAAI,CAAC,cAAc,EAAE,EAAE,eAAe,EAAE,IAAI,CAAC,gBAAgB,EAAE,EAAE,CAAC;QAC9G,gBAAgB,EAAE,CAAC,CAA4C,EAAW,EAAE,CAC1E,gBAAgB,CAAC,EAAE,GAAG,CAAC,EAAE,aAAa,EAAE,IAAI,CAAC,cAAc,EAAE,EAAE,eAAe,EAAE,IAAI,CAAC,gBAAgB,EAAE,EAAE,CAAC;QAC5G,8BAA8B,EAAE,CAAC,CAA0D,EAAW,EAAE,CACtG,8BAA8B,CAAC,EAAE,GAAG,CAAC,EAAE,aAAa,EAAE,IAAI,CAAC,cAAc,EAAE,EAAE,eAAe,EAAE,IAAI,CAAC,gBAAgB,EAAE,EAAE,CAAC;QAC1H,cAAc,EAAE,CAAC,CAA0C,EAAW,EAAE;YACtE,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACzC,OAAO,cAAc,CAAC;gBACpB,GAAG,CAAC;gBACJ,aAAa,EAAE,IAAI,CAAC,cAAc,EAAE;gBACpC,wBAAwB,EAAE,QAAQ,CAAC,SAAS;gBAC5C,iBAAiB,EAAE,QAAQ,CAAC,EAAE;aAC/B,CAAC,CAAC;QACL,CAAC;KACF,CAAC;IAEF,8EAA8E;IAE9E,gEAAgE;IAChE,KAAK,CAAC,mBAAmB,CAAC,MAAc,EAAE,MAAuC;QAC/E,OAAO,KAAK,CAAC,mBAAmB,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACjE,CAAC;IAED,6EAA6E;IAE7E,2EAA2E;IAC3E,IAAI,IAAI;QACN,OAAO;YACL,OAAO,EAAE,iBAAiB,CAAC,eAAe,EAAE,IAAI,CAAC,SAAS,CAAC;YAC3D,QAAQ,EAAE,iBAAiB,CAAC,gBAAgB,EAAE,IAAI,CAAC,SAAS,CAAC;YAC7D,eAAe,EAAE,IAAI,CAAC,OAAO,CAAC,wBAAwB;gBACpD,CAAC,CAAC,iBAAiB,CACf,eAAe,EACf,IAAI,CAAC,OAAO,CAAC,wBAAwB,CACtC;gBACH,CAAC,CAAC,eAAe;SACpB,CAAC;IACJ,CAAC;IAED,yEAAyE;IAChE,GAAG,GAAG;QACb,QAAQ,EAAE,gBAAgB,CAAC,QAAQ;QACnC,gBAAgB,EAAE,gBAAgB,CAAC,gBAAgB;QACnD,OAAO,EAAE,eAAe,CAAC,OAAO;QAChC,KAAK,EAAE,eAAe,CAAC,KAAK;QAC5B,eAAe,EAAE,eAAe,CAAC,eAAe;QAChD,2BAA2B,EAAE,eAAe,CAAC,2BAA2B;KACzE,CAAC;CACH;AAED,qDAAqD;AACrD,OAAO,EAAE,kBAAkB,IAAI,UAAU,EAAE,CAAC;AAE5C;;;;;GAKG;AACH,MAAM,UAAU,IAAI,CAClB,UAA6B,EAAE;IAE/B,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,MAAM,CAAS,CAAC;IAC9C,OAAO;QACL,IAAI;QACJ,QAAQ,EAAE,CAAC,MAAyB,EAAE,EAAE;YACtC,MAAM,UAAU,GACd,OAAO,CAAC,UAAU,IAAI,yBAAyB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAClE,MAAM,QAAQ,GAAG,YAAY,CAAC;gBAC5B,UAAU,EAAE,UAAU,CAAC,QAAQ;gBAC/B,aAAa,EAAE,OAAO,CAAC,aAAa;aACrC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YACpB,OAAO,IAAI,kBAAkB,CAC3B,MAAM,EACN;gBACE,SAAS,EAAE,UAAU,CAAC,QAAQ,CAAC,QAAQ;gBACvC,UAAU,EAAE,UAAU,CAAC,OAAO,CAAC,cAAc;gBAC7C,aAAa,EAAE,UAAU,CAAC,QAAQ,CAAC,SAAS;gBAC5C,eAAe,EAAE,UAAU,CAAC,QAAQ,CAAC,MAAM;gBAC3C,wBAAwB,EAAE,UAAU,CAAC,QAAQ,CAAC,eAAe;gBAC7D,iBAAiB,EAAE,UAAU,CAAC,OAAO,CAAC,eAAe;aACtD,EACD,QAAQ,EACR,UAAU,CACX,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,MAA0B;IACrD,OAAO;QACL,IAAI,EAAE,cAAuB;QAC7B,QAAQ,EAAE,CAAC,MAAyB,EAAE,EAAE;YACtC,MAAM,QAAQ,GAAG,YAAY,CAAC;gBAC5B,UAAU,EAAE,MAAM,CAAC,aAAa;oBAC9B,CAAC,CAAC;wBACE,SAAS,EAAE,MAAM,CAAC,aAAa;qBAChC;oBACH,CAAC,CAAC,SAAS;aACd,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YACpB,OAAO,IAAI,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC1D,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/contracts/release_registry/release_registry.d.ts

@@ -0,0 +1,114 @@
+/**************************************************************
+ * THIS FILE IS GENERATED AND SHOULD NOT BE MANUALLY MODIFIED *
+ **************************************************************/
+/**
+ * The recommended canonical parent namespace for `miso::release::new`.
+ *
+ * `miso::release::new` takes `parent: &mut UID` and derives every release's id
+ * from `(parent, digest)`: core is deliberately parent-agnostic and implements no
+ * coordination policy of its own (see the "Consent scope" section of
+ * `miso::release`'s module doc). This package supplies the one recommended parent
+ * — a shared, permissionless, undeletable `UID` — and is deliberately the _only_
+ * policy it implements: it neither gates who may assemble a release through it nor
+ * interprets what a `Track` means.
+ *
+ * ### One instance, ever
+ *
+ * The module exposes no constructor: the only `ReleaseRegistry` that can ever
+ * exist is the canonical one created and shared by package initialization. "The
+ * registry" is therefore unambiguous on-chain — the type itself names the
+ * namespace, not a config convention. Every `new_release` takes `&mut` on that one
+ * shared object, so release creation through it serializes per checkpoint; the
+ * ceiling is accepted — releases are rare events. Alternative namespaces are still
+ * possible, but they live in other packages: core is parent-agnostic, and any
+ * object exposing a `&mut UID` (a release escrow, for instance) can parent its own
+ * releases; ids derived under different parents never collide, by construction of
+ * `derive_address`.
+ *
+ * ### Liveness
+ *
+ * The canonical instance is shared at publish, and this module exposes no delete
+ * function and no `uid_mut`: its only capability is being a derivation parent.
+ * That undeletability is a consent guarantee, not an accident — a `Track`'s
+ * `target_release_id` commits to this namespace's liveness (see `miso::release`'s
+ * module doc), and a deletable parent would strand every track and offer that ever
+ * targeted it. Keeping the surface to exactly one capability is what makes that
+ * guarantee durable: there is nothing else here to reason about.
+ *
+ * ### Permissionless
+ *
+ * No capability gates `new_release`: anyone holding a fully-formed `vector<Track>`
+ * may assemble and claim a release through this registry. That is not a gap —
+ * consent already lives in the `Track`s themselves, each one minted by its
+ * recording's admin via cap-gated `miso::track::new` against this exact digest.
+ * Assembly is bookkeeping over consent already given, not a second authorization
+ * step.
+ */
+import { MoveStruct, type RawTransactionArgument } from '../utils/index.js';
+import { type Transaction, type TransactionArgument } from '@mysten/sui/transactions';
+export declare const ReleaseRegistry: MoveStruct<{
+    id: import("@mysten/sui/bcs").BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
+}, "@local-pkg/release_registry::release_registry::ReleaseRegistry">;
+export declare const ReleaseRegistryCreatedEvent: MoveStruct<{
+    registry_id: import("@mysten/sui/bcs").BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
+    created_by: import("@mysten/sui/bcs").BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
+}, "@local-pkg/release_registry::release_registry::ReleaseRegistryCreatedEvent">;
+export interface NewReleaseArguments {
+    self: RawTransactionArgument<string>;
+    title: RawTransactionArgument<string>;
+    tracks: TransactionArgument;
+    nonce: RawTransactionArgument<number | bigint>;
+}
+export interface NewReleaseOptions {
+    package?: string;
+    arguments: NewReleaseArguments | [
+        self: RawTransactionArgument<string>,
+        title: RawTransactionArgument<string>,
+        tracks: TransactionArgument,
+        nonce: RawTransactionArgument<number | bigint>
+    ];
+}
+/**
+ * Assembles a release by delegating to `miso::release::new` with this registry as
+ * parent. Returns the `(Release, ReleaseAdminCap)` pair rather than transferring
+ * or sharing either: the release is not on-chain-final until `release::publish`
+ * consumes it by value — typically later in the same PTB — and where the cap ends
+ * up is the caller's decision, not this function's.
+ */
+export declare function newRelease(options: NewReleaseOptions): (tx: Transaction) => import("@mysten/sui/transactions").TransactionResult;
+export interface DeriveTargetReleaseIdArguments {
+    self: RawTransactionArgument<string>;
+    recordingIds: RawTransactionArgument<Array<string>>;
+    trackSplitValues: RawTransactionArgument<Array<number | bigint>>;
+    nonce: RawTransactionArgument<number | bigint>;
+}
+export interface DeriveTargetReleaseIdOptions {
+    package?: string;
+    arguments: DeriveTargetReleaseIdArguments | [
+        self: RawTransactionArgument<string>,
+        recordingIds: RawTransactionArgument<Array<string>>,
+        trackSplitValues: RawTransactionArgument<Array<number | bigint>>,
+        nonce: RawTransactionArgument<number | bigint>
+    ];
+}
+/**
+ * Derives the release id `new_release` would produce for the given inputs under
+ * this registry, without creating anything. Delegates to
+ * `miso::release::derive_target_release_id` with this registry's own id as parent.
+ */
+export declare function deriveTargetReleaseId(options: DeriveTargetReleaseIdOptions): (tx: Transaction) => import("@mysten/sui/transactions").TransactionResult;
+export interface IdArguments {
+    self: RawTransactionArgument<string>;
+}
+export interface IdOptions {
+    package?: string;
+    arguments: IdArguments | [
+        self: RawTransactionArgument<string>
+    ];
+}
+/**
+ * Returns the registry's object id — the derivation parent that
+ * `derive_target_release_id` and `new_release` both commit to.
+ */
+export declare function id(options: IdOptions): (tx: Transaction) => import("@mysten/sui/transactions").TransactionResult;
+//# sourceMappingURL=release_registry.d.ts.map

package/dist/contracts/release_registry/release_registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"release_registry.d.ts","sourceRoot":"","sources":["../../../src/contracts/release_registry/release_registry.ts"],"names":[],"mappings":"AAAA;;gEAEgE;AAGhE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAEH,OAAO,EAAE,UAAU,EAA0B,KAAK,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAEpG,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEtF,eAAO,MAAM,eAAe;;oEAEpB,CAAC;AACT,eAAO,MAAM,2BAA2B;;;gFAGhC,CAAC;AACT,MAAM,WAAW,mBAAmB;IAChC,IAAI,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;IACrC,KAAK,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;IACtC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,KAAK,EAAE,sBAAsB,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;CAClD;AACD,MAAM,WAAW,iBAAiB;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,mBAAmB,GAAG;QAC7B,IAAI,EAAE,sBAAsB,CAAC,MAAM,CAAC;QACpC,KAAK,EAAE,sBAAsB,CAAC,MAAM,CAAC;QACrC,MAAM,EAAE,mBAAmB;QAC3B,KAAK,EAAE,sBAAsB,CAAC,MAAM,GAAG,MAAM,CAAC;KACjD,CAAC;CACL;AACD;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,iBAAiB,IASzC,IAAI,WAAW,0DAM1B;AACD,MAAM,WAAW,8BAA8B;IAC3C,IAAI,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;IACrC,YAAY,EAAE,sBAAsB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IACpD,gBAAgB,EAAE,sBAAsB,CAAC,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC;IACjE,KAAK,EAAE,sBAAsB,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;CAClD;AACD,MAAM,WAAW,4BAA4B;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,8BAA8B,GAAG;QACxC,IAAI,EAAE,sBAAsB,CAAC,MAAM,CAAC;QACpC,YAAY,EAAE,sBAAsB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACnD,gBAAgB,EAAE,sBAAsB,CAAC,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;QAChE,KAAK,EAAE,sBAAsB,CAAC,MAAM,GAAG,MAAM,CAAC;KACjD,CAAC;CACL;AACD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,4BAA4B,IAS/D,IAAI,WAAW,0DAM1B;AACD,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;CACxC;AACD,MAAM,WAAW,SAAS;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,WAAW,GAAG;QACrB,IAAI,EAAE,sBAAsB,CAAC,MAAM,CAAC;KACvC,CAAC;CACL;AACD;;;GAGG;AACH,wBAAgB,EAAE,CAAC,OAAO,EAAE,SAAS,IAMzB,IAAI,WAAW,0DAM1B"}