@misofm/sdk 0.9.0 → 0.10.0

package/src/credits.ts

@@ -44,6 +44,30 @@ import * as recordingCredits from "./contracts/recording_credits/recording_credi
 import * as recordingPartyRole from "./contracts/recording_credits/recording_party_role.ts";
 import * as releaseCredits from "./contracts/release_credits/release_credits.ts";
 import * as releasePartyRole from "./contracts/release_credits/release_party_role.ts";
+import { directAdminCap, invokeWithAdminCap, type AdminCapAuthority } from "./vault.ts";
+
+type CompositionAuthorityInput =
+  | { readonly authority: AdminCapAuthority; readonly compositionAdminCapId?: never }
+  | { readonly authority?: never; readonly compositionAdminCapId: string };
+type RecordingAuthorityInput =
+  | { readonly authority: AdminCapAuthority; readonly recordingAdminCapId?: never }
+  | { readonly authority?: never; readonly recordingAdminCapId: string };
+type ReleaseAuthorityInput =
+  | { readonly authority: AdminCapAuthority; readonly releaseAdminCapId?: never }
+  | { readonly authority?: never; readonly releaseAdminCapId: string };
+
+function compositionAuthorityOf(input: CompositionAuthorityInput): AdminCapAuthority {
+  if (input.authority !== undefined) return input.authority;
+  return directAdminCap(input.compositionAdminCapId);
+}
+function recordingAuthorityOf(input: RecordingAuthorityInput): AdminCapAuthority {
+  if (input.authority !== undefined) return input.authority;
+  return directAdminCap(input.recordingAdminCapId);
+}
+function releaseAuthorityOf(input: ReleaseAuthorityInput): AdminCapAuthority {
+  if (input.authority !== undefined) return input.authority;
+  return directAdminCap(input.releaseAdminCapId);
+}
 
 // ── Role model ────────────────────────────────────────────────────────────────
 
@@ -341,11 +365,9 @@ function buildCredit(
 
 // ── Writers ───────────────────────────────────────────────────────────────────
 
-export interface AttachCompositionCreditParams {
+interface AttachCompositionCreditParamsBase {
   /** The `Composition` object to credit on. */
   compositionId: string;
-  /** The composition's `CompositionAdminCap`. */
-  compositionAdminCapId: string;
   /** The `Party` being credited. */
   partyId: string;
   /** Human-readable name for the credit (≤200 bytes, non-empty). */
@@ -359,6 +381,8 @@ export interface AttachCompositionCreditParams {
   /** `miso_credit` package id (home of `credit::new`). */
   misoCreditPackageId: string;
 }
+export type AttachCompositionCreditParams =
+  AttachCompositionCreditParamsBase & CompositionAuthorityInput;
 
 /**
  * Adds a writing credit for a party on a composition. Throws (client-side,
@@ -382,26 +406,18 @@ export function attachCompositionCredit(
       p.displayName,
       roleArgs,
     );
-    tx.add(
-      compositionCredits.addCredit({
-        package: p.compositionCreditsPackageId,
-        typeArguments: [p.compositionShareType],
-        arguments: [
-          p.compositionId,
-          p.compositionAdminCapId,
-          p.partyId,
-          credit,
-        ],
-      }),
-    );
+    invokeWithAdminCap(tx, compositionAuthorityOf(p), {
+      target: `${p.compositionCreditsPackageId}::composition_credits::add_credit`,
+      typeArguments: [p.compositionShareType],
+      arguments: [tx.object(p.compositionId), tx.object(p.partyId), credit],
+      adminCapIndex: 1,
+    });
   };
 }
 
-export interface AttachRecordingCreditParams {
+interface AttachRecordingCreditParamsBase {
   /** The `Recording` object to credit on. */
   recordingId: string;
-  /** The recording's `RecordingAdminCap`. */
-  recordingAdminCapId: string;
   /** The `Party` being credited. */
   partyId: string;
   /** Human-readable name for the credit (≤200 bytes, non-empty). */
@@ -417,6 +433,8 @@ export interface AttachRecordingCreditParams {
   /** `miso_credit` package id (home of `credit::new`). */
   misoCreditPackageId: string;
 }
+export type AttachRecordingCreditParams =
+  AttachRecordingCreditParamsBase & RecordingAuthorityInput;
 
 /**
  * Adds a production/performance credit for a party on a recording. Throws
@@ -439,21 +457,18 @@ export function attachRecordingCredit(p: AttachRecordingCreditParams): TxThunk {
       p.displayName,
       roleArgs,
     );
-    tx.add(
-      recordingCredits.addCredit({
-        package: p.recordingCreditsPackageId,
-        typeArguments: [p.recordingShareType, p.compositionShareType],
-        arguments: [p.recordingId, p.recordingAdminCapId, p.partyId, credit],
-      }),
-    );
+    invokeWithAdminCap(tx, recordingAuthorityOf(p), {
+      target: `${p.recordingCreditsPackageId}::recording_credits::add_credit`,
+      typeArguments: [p.recordingShareType, p.compositionShareType],
+      arguments: [tx.object(p.recordingId), tx.object(p.partyId), credit],
+      adminCapIndex: 1,
+    });
   };
 }
 
-export interface AddRecordingArtistParams {
+interface AddRecordingArtistParamsBase {
   /** The `Recording` object. */
   recordingId: string;
-  /** The recording's `RecordingAdminCap`. */
-  recordingAdminCapId: string;
   /** The `Party` to designate. Must already be credited on the recording. */
   partyId: string;
   /** The recording's own share coin type (the `RecordingShare` phantom). */
@@ -463,6 +478,8 @@ export interface AddRecordingArtistParams {
   /** `recording_credits` package id. */
   recordingCreditsPackageId: string;
 }
+export type AddRecordingArtistParams =
+  AddRecordingArtistParamsBase & RecordingAuthorityInput;
 
 /**
  * Designates an already-credited party as a primary artist on a recording. The
@@ -473,13 +490,12 @@ export function addRecordingPrimaryArtist(
   p: AddRecordingArtistParams,
 ): TxThunk {
   return (tx) => {
-    tx.add(
-      recordingCredits.addPrimaryArtist({
-        package: p.recordingCreditsPackageId,
-        typeArguments: [p.recordingShareType, p.compositionShareType],
-        arguments: [p.recordingId, p.recordingAdminCapId, p.partyId],
-      }),
-    );
+    invokeWithAdminCap(tx, recordingAuthorityOf(p), {
+      target: `${p.recordingCreditsPackageId}::recording_credits::add_primary_artist`,
+      typeArguments: [p.recordingShareType, p.compositionShareType],
+      arguments: [tx.object(p.recordingId), tx.object(p.partyId)],
+      adminCapIndex: 1,
+    });
   };
 }
 
@@ -492,21 +508,18 @@ export function addRecordingFeaturedArtist(
   p: AddRecordingArtistParams,
 ): TxThunk {
   return (tx) => {
-    tx.add(
-      recordingCredits.addFeaturedArtist({
-        package: p.recordingCreditsPackageId,
-        typeArguments: [p.recordingShareType, p.compositionShareType],
-        arguments: [p.recordingId, p.recordingAdminCapId, p.partyId],
-      }),
-    );
+    invokeWithAdminCap(tx, recordingAuthorityOf(p), {
+      target: `${p.recordingCreditsPackageId}::recording_credits::add_featured_artist`,
+      typeArguments: [p.recordingShareType, p.compositionShareType],
+      arguments: [tx.object(p.recordingId), tx.object(p.partyId)],
+      adminCapIndex: 1,
+    });
   };
 }
 
-export interface AddReleaseCreditParams {
+interface AddReleaseCreditParamsBase {
   /** The `Release` object to credit on. */
   releaseId: string;
-  /** The release's `ReleaseAdminCap`. */
-  releaseAdminCapId: string;
   /** The `Party` being credited. */
   partyId: string;
   /** Human-readable name for the credit (≤200 bytes, non-empty). */
@@ -518,6 +531,7 @@ export interface AddReleaseCreditParams {
   /** `miso_credit` package id (home of `credit::new`). */
   misoCreditPackageId: string;
 }
+export type AddReleaseCreditParams = AddReleaseCreditParamsBase & ReleaseAuthorityInput;
 
 /**
  * Adds a top-line billing credit (a single role) for a party on a release.
@@ -536,12 +550,11 @@ export function addReleaseCredit(p: AddReleaseCreditParams): TxThunk {
       p.displayName,
       [roleArg],
     );
-    tx.add(
-      releaseCredits.addCredit({
-        package: p.releaseCreditsPackageId,
-        arguments: [p.releaseId, p.releaseAdminCapId, p.partyId, credit],
-      }),
-    );
+    invokeWithAdminCap(tx, releaseAuthorityOf(p), {
+      target: `${p.releaseCreditsPackageId}::release_credits::add_credit`,
+      arguments: [tx.object(p.releaseId), tx.object(p.partyId), credit],
+      adminCapIndex: 1,
+    });
   };
 }
 

package/src/deployments.ts

@@ -1,10 +1,9 @@
 // Copyright (c) Miso Labs, Inc.
 // SPDX-License-Identifier: Apache-2.0
 
-import {
-  MISO_PROTOCOL_DEPLOYMENTS,
-  type MisoNetwork,
-  type MisoProtocolDeployment,
+import type {
+  MisoNetwork,
+  MisoProtocolDeployment,
 } from "@misonetwork/sdk/deployments";
 
 /** Complete on-chain identity used by the Miso platform SDK on one network. */
@@ -14,28 +13,47 @@ export interface MisoPlatformDeployment {
   readonly packages: {
     readonly pressing: string;
     readonly record: string;
-    readonly releaseRegistry: string;
     readonly minato: string;
-    readonly drop: string;
     readonly credit: string;
     readonly compositionCredits: string;
     readonly recordingCredits: string;
     readonly releaseCredits: string;
     /** Base royalty-pool value library. */
     readonly royaltyPool: string;
-    /** Composition royalty-pool extension. */
-    readonly compositionRoyaltyPool: string;
-    /** Recording royalty-pool extension. */
-    readonly recordingRoyaltyPool: string;
+    /** Shared custody package for protocol admin capabilities. */
+    readonly vault: string;
+    /** Vault plugin that creates and cranks Composition royalty pools. */
+    readonly compositionRoyaltyPoolPlugin: string;
+    /** Vault plugin that creates and cranks Recording royalty pools. */
+    readonly recordingRoyaltyPoolPlugin: string;
+    /** Generic stake wrapper used by the composition routed-stake plugin. */
+    readonly routedStake: string;
+    /** Vault plugin for Composition-owned Recording-share staking. */
+    readonly compositionRoutedStakePlugin: string;
     /** Cover-art value type used by the release cover extension. */
     readonly coverArt: string;
     readonly releaseCoverArt: string;
+    /** Curated Genre vocabulary package used by release_genre. */
+    readonly genre: string;
+    readonly releaseDescription: string;
+    readonly releaseDspLink: string;
+    readonly releaseGenre: string;
+    readonly releaseKind: string;
+    /** Vault plugin that routes Release revenue into Recording addresses. */
+    readonly releaseRevenueDistributorPlugin: string;
+    readonly releaseSnapshotBundle: string;
+    readonly recordingAdvisory: string;
+    readonly recordingLanguage: string;
+    readonly recordingMasterReference: string;
+    readonly recordingPreview: string;
     /** External `ori::walrus_data::WalrusData` dependency used by cover art. */
     readonly ori: string;
   };
   readonly objects: {
     readonly recordSettings: string;
     readonly releaseRegistry: string;
+    /** Shared parent used to derive canonical Genre object ids. */
+    readonly genreRegistry: string;
   };
   /** PartyOS packages used by the composed artist and wallet reads. */
   readonly party: {
@@ -63,100 +81,21 @@ export interface MisoPlatformDeployment {
 /**
  * Platform deployments bundled with this SDK release.
  *
- * Mainnet is intentionally absent until the complete platform stack is live.
- * Mainnet is intentionally unavailable until this ABI is deployed there.
+ * This release deliberately contains no bundled network deployment. The core
+ * protocol is being republished as an immutable stack, so every old package ID
+ * is an incompatible ABI and must not be selected by accident. The admin-cli
+ * deployment flow injects verified IDs in a follow-up change.
  */
-export const MISO_PLATFORM_DEPLOYMENTS = {
-  testnet: {
-    protocol: MISO_PROTOCOL_DEPLOYMENTS.testnet,
-    packages: {
-      pressing:
-        "0xd0913b584d87a3891a8013c58644e3896f438fd948e819a69db256b47314974e",
-      record:
-        "0x97e2772d81528c69e21b6681f6702f90deae2a6b079e19da1df53f9f4fdd3271",
-      releaseRegistry:
-        "0x683b2feb784a815171d2976418345bd41c046e159dcf7a16890c766f69fd7808",
-      minato:
-        "0x8466e9864c1d947888e73b0e349b035bc22805579eef18f132966f56c8efe1d2",
-      drop:
-        "0xfc2b51f068dee9d5482d39fa017164f6a8c3601cabb59084a518de5f609ef1c7",
-      credit:
-        "0x0121926470393cc93b89b5b6d5067737a8bc0c1c545fb96c4447569174116174",
-      compositionCredits:
-        "0xfa2f62db28f2eb42c8c1a6533097fb2095649efab05c0527be1874b9be6cdc73",
-      recordingCredits:
-        "0xc794252bd90efb4cc224107f9dd0a56d4f4f5623783628b6af286f6535dd4c1e",
-      releaseCredits:
-        "0x42e2dbf6098d18782911460ecf79b338af2f1b654ef7ba99c6e7344fd4bf3f94",
-      royaltyPool:
-        "0x798fb353a5dbed51a0df08a7c10fdc432a11d60b55e016102ca635f9033c654d",
-      compositionRoyaltyPool:
-        "0xc22693ec50312492d7da23f3544625df637a92cd2be08e09d0f2eb8ff4e0e7ac",
-      recordingRoyaltyPool:
-        "0x33c9149889ef9e8078a5eba5c5486e8938e2dc69b3bd49a45c5c57e9f3d898a8",
-      coverArt:
-        "0xb29052d1174835a8061149aeca08f53551fa0691de64350247fc5cb558f797a0",
-      releaseCoverArt:
-        "0x831a612920343696de7e8f0603ff4c0b21c43ca3de478feb96d230e263cd11d4",
-      ori:
-        "0x340057f2174fb59e4626742dd2b46c662237837b6187450cb59e4976ce7eac78",
-    },
-    objects: {
-      recordSettings:
-        "0x6a005dad071562d421ad7a9d368289f5c9f0408ca495cd466a1f774d65a21fa7",
-      releaseRegistry:
-        "0x5941b8690916e762a7583363906496d64a6ea3e6cedb078c90e23e7c671544f2",
-    },
-    party: {
-      partyPackageId:
-        "0x09a812d46c3aa3978703c8e5a7409ba67b9ba2dfdb91154e48ebdd9d2415da0c",
-      partyProfilePackageId:
-        "0xce89d3f993dfebc0b697388598c3b01e9db7b73fa2e8df18ed22608cf7ac5aee",
-      countryCodePackageId:
-        "0x6c3a53f228ccd089825d0fb5ee1f0465a4b7a438bc1b1735b4e2f01df8d056e9",
-      languageCodePackageId:
-        "0xa18b786807cfc45488691f93aa647800b77cf9993e420d110afd7024c5b15948",
-      partyMediaPackageId:
-        "0x7db56ef37692f84c1cfb0e0b26bde35ac9f1bc0bcd91ac5d24b3f8b4d1821349",
-      partyRolesPackageId:
-        "0x41a442a2c39368af2181e73ea5b90e2e0b4f89de09050c121a6e7d79e7c84415",
-      partyTagsPackageId:
-        "0xa4c7f6b05bb9b612ea7640974c150ce31ad7927ea82d3f9f4673acac7deef0da",
-      partyGenrePackageId:
-        "0x6ce063438be6cf44ccf5f17bf8892c9e0cef4e2344442aeb44412beead74d3a8",
-      partyCtaPackageId:
-        "0x85a312210d9ddbae535e0f933032c8a56aa3f0fe1d6c3430d4fa538765008da3",
-      partyPlatformLinkPackageId:
-        "0x46d9f3e05d2065a926b010fe833baf61e5c250c233d512a260cbe746b02c56af",
-      partySocialPackageId:
-        "0x438e767ce8f5699f12be1704a12ff69c28045ca241f890ca8a978d55e09f6541",
-      partyMusicPackageId:
-        "0x89add347dfa779aa77e21b1853a37f2054dbecfce29799b61463d9900877b7b1",
-      partyProLinkPackageId:
-        "0xe5e8a0d02b43037abb7e6ddb4b742c6197aadf2dc19910957bba98307bef4103",
-      partyFeaturedDropPackageId:
-        "0x1a7b926686565a6cc82a9e0630839dc1f75c9bf4fafc0ba789a05af2c3c269f0",
-      genrePackageId:
-        "0xcbbce10e8b0781d458e88ce99d08e0c85f1e674c5b7ec975383d74f87a1d76b1",
-    },
-    legacy: {
-      releaseCoverArtPackages: [
-        "0x25c3c87ef4823d62d80dd8bda714ef4976df0f04453997646659a6cebadd655b",
-        "0x1ee2cae0da7595d7973c310c912434ef531589b468cc57839296810c1385f7f6",
-        "0x7d4a205a68f8e768a408c9f4c45a4d4076722c5edeba9068c0ac058f554e964e",
-      ],
-    },
-  },
-} as const satisfies Partial<Record<MisoNetwork, MisoPlatformDeployment>>;
+export const MISO_PLATFORM_DEPLOYMENTS = {} as const satisfies Partial<
+  Record<MisoNetwork, MisoPlatformDeployment>
+>;
 
 /** Resolve a bundled platform deployment, failing closed when it is unavailable. */
 export function getMisoPlatformDeployment(
   network: string,
 ): MisoPlatformDeployment {
   const deployment = (
-    MISO_PLATFORM_DEPLOYMENTS as Partial<
-      Record<string, MisoPlatformDeployment>
-    >
+    MISO_PLATFORM_DEPLOYMENTS as Partial<Record<string, MisoPlatformDeployment>>
   )[network];
   if (!deployment) {
     throw new Error(

package/src/index.ts

@@ -14,9 +14,8 @@
 //
 // A release is protocol. Pressing a record off it and selling that record is
 // platform. Keeping the split at the package boundary is what stops the protocol
-// from quietly growing a storefront. Core's `release::new` is the sole practical
-// exception: it needs `&mut UID`, which cannot cross a PTB command boundary, so
-// the platform's `release_registry` extension owns the PTB-callable minting path.
+// from quietly growing a storefront. Core `release::new` uses its shared
+// `ReleaseRegistry` as the PTB-callable derivation parent.
 //
 // Extensions live on this side of the line for the same reason. An extension is
 // not part of what a Composition or Recording IS — it is a choice Miso makes
@@ -27,7 +26,12 @@
 
 // The recommended entry point is the client extension (see ./client.ts); the bare
 // builders and readers stay exported for callers that hold ids themselves.
-export { miso, misoPlatform, MisoClient, MisoPlatformClient } from "./client.ts";
+export {
+  miso,
+  misoPlatform,
+  MisoClient,
+  MisoPlatformClient,
+} from "./client.ts";
 export type {
   ConfiguredReleaseGraphParams,
   MisoOptions,
@@ -51,7 +55,9 @@ export * as read from "./read/index.ts";
 // `uid_mut` hook.
 export * from "./credits.ts";
 export * from "./cover.ts";
-export * from "./extensions/royalty-pool.ts";
+export * from "./release-extensions.ts";
+export * from "./recording-extensions.ts";
+export * from "./vault.ts";
 
 // Generated, ABI-bound bindings (BCS structs + type-safe Move calls).
 export * as contracts from "./contracts.ts";