@misofm/sdk 0.12.4 → 0.14.0

package/src/recording-extensions.ts

@@ -3,21 +3,25 @@
 
 /** Cap-authorized builders for data-only Recording metadata extensions. */
 
-import type { TransactionArgument } from "@mysten/sui/transactions";
+import type { Transaction, TransactionArgument, TransactionObjectArgument } from "@mysten/sui/transactions";
 import type { TxThunk } from "./transactions.ts";
-import { invokeWithAdminCap, type AdminCapAuthority } from "./vault.ts";
+import { invokeWithAdminCap, type AdminCapAuthority, type ObjectInput } from "./vault.ts";
 import * as advisory from "./contracts/recording_advisory/recording_advisory.ts";
 import * as language from "./contracts/recording_language/recording_language.ts";
 import * as masterReference from "./contracts/recording_master_reference/recording_master_reference.ts";
 import * as preview from "./contracts/recording_preview/recording_preview.ts";
 
 export interface RecordingExtensionTarget {
-  readonly recordingId: string;
+  readonly recordingId: ObjectInput;
   readonly authority: AdminCapAuthority;
   readonly recordingShareType: string;
   readonly compositionShareType: string;
 }
 
+function object(tx: Transaction, value: ObjectInput): TransactionObjectArgument {
+  return typeof value === "string" ? tx.object(value) : value;
+}
+
 type Rating = "Explicit" | "NotExplicit" | "Cleaned";
 export interface SetRecordingAdvisoryParams extends RecordingExtensionTarget {
   readonly recordingAdvisoryPackageId: string;
@@ -34,7 +38,7 @@ export function setRecordingAdvisory(p: SetRecordingAdvisoryParams): TxThunk {
     invokeWithAdminCap(tx, p.authority, {
       target: `${p.recordingAdvisoryPackageId}::recording_advisory::set_rating`,
       typeArguments: [p.recordingShareType, p.compositionShareType],
-      arguments: [tx.object(p.recordingId), rating],
+      arguments: [object(tx, p.recordingId), rating],
       adminCapIndex: 1,
     });
   };
@@ -51,7 +55,7 @@ export function setRecordingLanguages(p: SetRecordingLanguagesParams): TxThunk {
     invokeWithAdminCap(tx, p.authority, {
       target: `${p.recordingLanguagePackageId}::recording_language::set_languages`,
       typeArguments: [p.recordingShareType, p.compositionShareType],
-      arguments: [tx.object(p.recordingId), p.languages],
+      arguments: [object(tx, p.recordingId), p.languages],
       adminCapIndex: 1,
     });
   };
@@ -62,7 +66,7 @@ export function setRecordingInstrumental(p: Omit<SetRecordingLanguagesParams, "l
     invokeWithAdminCap(tx, p.authority, {
       target: `${p.recordingLanguagePackageId}::recording_language::set_instrumental`,
       typeArguments: [p.recordingShareType, p.compositionShareType],
-      arguments: [tx.object(p.recordingId)],
+      arguments: [object(tx, p.recordingId)],
       adminCapIndex: 1,
     });
   };
@@ -81,7 +85,7 @@ export function setRecordingMasterReference(p: SetRecordingMasterReferenceParams
     invokeWithAdminCap(tx, p.authority, {
       target: `${p.recordingMasterReferencePackageId}::recording_master_reference::set_master_reference`,
       typeArguments: [p.recordingShareType, p.compositionShareType],
-      arguments: [tx.object(p.recordingId), p.reference],
+      arguments: [object(tx, p.recordingId), p.reference],
       adminCapIndex: 1,
     });
   };
@@ -95,7 +99,7 @@ export function setRecordingPreview(p: SetRecordingPreviewParams): TxThunk {
     invokeWithAdminCap(tx, p.authority, {
       target: `${p.recordingPreviewPackageId}::recording_preview::set_preview`,
       typeArguments: [p.recordingShareType, p.compositionShareType],
-      arguments: [tx.object(p.recordingId), p.reference],
+      arguments: [object(tx, p.recordingId), p.reference],
       adminCapIndex: 1,
     });
   };

package/src/release-extensions.ts

@@ -9,6 +9,7 @@ import { deriveObjectID } from "@mysten/sui/utils";
 import type {
   Transaction,
   TransactionArgument,
+  TransactionObjectArgument,
 } from "@mysten/sui/transactions";
 import type { TxThunk } from "./transactions.ts";
 import * as genre from "./contracts/genre/genre.ts";
@@ -16,13 +17,17 @@ import * as releaseDescription from "./contracts/release_description/release_des
 import * as releaseDspLink from "./contracts/release_dsp_link/release_dsp_link.ts";
 import * as releaseGenre from "./contracts/release_genre/release_genre.ts";
 import * as releaseKind from "./contracts/release_kind/release_kind.ts";
-import { asU64, directAdminCap, invokeWithAdminCap, type AdminCapAuthority, type U64Input } from "./vault.ts";
+import { asU64, directAdminCap, invokeWithAdminCap, type AdminCapAuthority, type ObjectInput, type U64Input } from "./vault.ts";
+
+function object(tx: Transaction, value: ObjectInput): TransactionObjectArgument {
+  return typeof value === "string" ? tx.object(value) : value;
+}
 
 type ReleaseAuthorityInput =
   | { readonly authority: AdminCapAuthority; readonly releaseAdminCapId?: never }
   | { readonly authority?: never; readonly releaseAdminCapId: string };
 interface ReleaseExtensionTargetBase {
-  releaseId: string;
+  releaseId: ObjectInput;
 }
 export type ReleaseExtensionTarget = ReleaseExtensionTargetBase & ReleaseAuthorityInput;
 function authority(p: ReleaseExtensionTarget): AdminCapAuthority {
@@ -48,7 +53,7 @@ export function setReleaseKind(p: SetReleaseKindParams): TxThunk {
   return (tx) => {
     invokeWithAdminCap(tx, authority(p), {
       target: `${p.releaseKindPackageId}::release_kind::set_kind`,
-      arguments: [tx.object(p.releaseId), tx.pure.string(p.kind)],
+      arguments: [object(tx, p.releaseId), tx.pure.string(p.kind)],
       adminCapIndex: 1,
     });
   };
@@ -73,7 +78,7 @@ export function setReleaseDescription(p: SetReleaseDescriptionParams): TxThunk {
   return (tx) => {
     invokeWithAdminCap(tx, authority(p), {
       target: `${p.releaseDescriptionPackageId}::release_description::set_description`,
-      arguments: [tx.object(p.releaseId), tx.pure.string(p.description)],
+      arguments: [object(tx, p.releaseId), tx.pure.string(p.description)],
       adminCapIndex: 1,
     });
   };
@@ -124,13 +129,13 @@ export function setReleaseGenres(p: SetReleaseGenresParams): TxThunk {
   return (tx) => {
     invokeWithAdminCap(tx, authority(p), {
       target: `${p.releaseGenrePackageId}::release_genre::set_primary_genre`,
-      arguments: [tx.object(p.releaseId), tx.object(p.primaryGenreId)],
+      arguments: [object(tx, p.releaseId), tx.object(p.primaryGenreId)],
       adminCapIndex: 1,
     });
     for (const genreId of p.secondaryGenreIds ?? []) {
       invokeWithAdminCap(tx, authority(p), {
         target: `${p.releaseGenrePackageId}::release_genre::add_secondary_genre`,
-        arguments: [tx.object(p.releaseId), tx.object(genreId)],
+        arguments: [object(tx, p.releaseId), tx.object(genreId)],
         adminCapIndex: 1,
       });
     }
@@ -138,7 +143,7 @@ export function setReleaseGenres(p: SetReleaseGenresParams): TxThunk {
       invokeWithAdminCap(tx, authority(p), {
         target: `${p.releaseGenrePackageId}::release_genre::set_track_primary_genre`,
         arguments: [
-          tx.object(p.releaseId),
+          object(tx, p.releaseId),
           tx.pure.u64(asU64("trackIndex", assignment.trackIndex)),
           tx.object(assignment.genreId),
         ],
@@ -247,7 +252,7 @@ export function setReleaseDspLinks(p: SetReleaseDspLinksParams): TxThunk {
       const value = buildDspLink(tx, p.releaseDspLinkPackageId, link);
       invokeWithAdminCap(tx, authority(p), {
         target: `${p.releaseDspLinkPackageId}::release_dsp_link::set_release_link`,
-        arguments: [tx.object(p.releaseId), value],
+        arguments: [object(tx, p.releaseId), value],
         adminCapIndex: 1,
       });
     }
@@ -255,7 +260,7 @@ export function setReleaseDspLinks(p: SetReleaseDspLinksParams): TxThunk {
       const value = buildDspLink(tx, p.releaseDspLinkPackageId, item.link);
       invokeWithAdminCap(tx, authority(p), {
         target: `${p.releaseDspLinkPackageId}::release_dsp_link::set_track_link`,
-        arguments: [tx.object(p.releaseId), tx.pure.u64(asU64("trackIndex", item.trackIndex)), value],
+        arguments: [object(tx, p.releaseId), tx.pure.u64(asU64("trackIndex", item.trackIndex)), value],
         adminCapIndex: 1,
       });
     }

package/src/share.ts

@@ -14,7 +14,9 @@
 // matters, and it is the same signer for all), so publishes are fungible: a whole
 // batch can be published — up to 5 `tx.publish` per PTB (the protocol's
 // `max_publish_or_upgrade_per_ptb` cap) — and run concurrently through a
-// `ParallelTransactionExecutor`. Initialization is likewise batched. The caller
+// `ParallelTransactionExecutor`. Every Publish result is consumed immediately by
+// `package::make_immutable` in that same PTB, so no share-package UpgradeCap is
+// ever left with the publisher. Initialization is likewise batched. The caller
 // assigns packages to work slots and supplies per-package metadata, so each
 // currency still gets a descriptive, work-specific name.
 
@@ -104,7 +106,7 @@ export interface CreateShareCurrencyParams {
   treasuryCapRecipient?: string;
 }
 
-/** Publishes + initializes a fresh share currency in two sequential txs. */
+/** Publishes an immutable package, then initializes a fresh share currency in a second tx. */
 export async function createShareCurrency(
   client: ClientWithCoreApi,
   signer: Signer,
@@ -151,8 +153,9 @@ function chunk<T>(items: T[], size: number): T[][] {
 }
 
 /**
- * Publishes `count` fresh share-currency packages, batched at ≤5 publishes per PTB
- * and run concurrently through the executor. Returns the published package ids
+ * Publishes `count` fresh, permanently immutable share-currency packages, batched
+ * at ≤5 publishes per PTB and run concurrently through the executor. Each publish
+ * consumes its UpgradeCap in the same PTB. Returns the published package ids
  * (fungible — order is not meaningful; the caller assigns them to work slots).
  */
 export async function publishShareCurrencies(

package/src/transactions.ts

@@ -130,6 +130,7 @@ export interface PackageBytecode {
   digest: number[];
 }
 
+/** Publish a share package and permanently destroy its UpgradeCap in the same PTB. */
 export function publishShareCurrency(bytecode: PackageBytecode): TxThunk {
   return (tx) => {
     const upgradeCap = tx.publish(bytecode);

package/src/vault.ts

@@ -21,6 +21,7 @@ import { normalizeStructTag } from "@mysten/sui/utils";
 import * as vault from "./contracts/vault/vault.ts";
 import * as compositionRoyaltyPool from "./contracts/composition_royalty_pool/composition_royalty_pool.ts";
 import * as recordingRoyaltyPool from "./contracts/recording_royalty_pool/recording_royalty_pool.ts";
+import * as partyWallet from "./contracts/party_wallet/party_wallet.ts";
 import * as compositionRoutedStake from "./contracts/composition_routed_stake/composition_routed_stake.ts";
 import * as releaseRevenueDistributor from "./contracts/release_revenue_distributor/release_revenue_distributor.ts";
 import * as routedStake from "./contracts/routed_stake/routed_stake.ts";
@@ -150,8 +151,8 @@ export interface CustodyNewAdminCapParams {
   readonly owner: string | TransactionArgument;
   /** Optional installation/configuration while the new Vault is still owned. */
   readonly configure?: (
-    vaultObject: TransactionArgument,
-    vaultAdminCapObject: TransactionArgument,
+    vaultObject: TransactionObjectArgument,
+    vaultAdminCapObject: TransactionObjectArgument,
   ) => void;
 }
 
@@ -360,6 +361,23 @@ export function installRecordingRoyaltyPoolPlugin(
   );
 }
 
+/** Install the Party wallet plugin; its canonical witness stays internal. */
+export function installPartyWalletPlugin(
+  tx: Transaction,
+  params: {
+    readonly vault: TransactionObjectArgument;
+    readonly vaultAdminCap: TransactionObjectArgument;
+    readonly pluginPackageId: string;
+  },
+): void {
+  tx.add(
+    partyWallet.install({
+      package: params.pluginPackageId,
+      arguments: [params.vault, params.vaultAdminCap],
+    }),
+  );
+}
+
 export function uninstallRecordingRoyaltyPoolPlugin(
   tx: Transaction,
   params: RecordingRoyaltyPoolPluginParams,