@misofm/sdk 0.12.3 → 0.13.0

package/src/contracts/miso_pressing/pressing.ts

@@ -38,9 +38,9 @@
  * Nothing here is ever destroyed, sealed, or wound down — deleting a pressing
  * would strand its whole derived subtree, so there is no destructor at all. The
  * run's lifecycle is `Scheduled → Active → Paused → Active`: it opens itself at
- * its drop moment (no artist transaction, and nobody can buy early), and after
- * that the artist stops and starts it at will. The first transition is real, not
- * computed — the first sale past the start rewrites `Scheduled` to `Active` inside
+ * its scheduled start (no artist transaction, and nobody can buy early), then the
+ * artist stops and starts it at will. The first transition is real, not computed —
+ * the first sale past the start rewrites `Scheduled` to `Active` inside
  * `mint_next`, which is why `Scheduled` only ever describes a run still waiting.
  * Below it, each listing's `Enabled | Disabled` governs one currency. A run that
  * is paused or not yet open sells in no currency, whatever the listings say.
@@ -73,8 +73,8 @@ export const PressingKey = new MoveTuple({ name: `${$moduleName}::PressingKey`,
 export const PressingAdminCapKey = new MoveTuple({ name: `${$moduleName}::PressingAdminCapKey`, fields: [bcs.bool()] });
 /**
  * Whether the run sells, over every currency at once. The lifecycle runs
- * `Scheduled → Active → Paused → Active`: a pressing opens itself at its drop
- * moment, then the artist stops and starts it at will.
+ * `Scheduled → Active → Paused → Active`: a pressing opens itself at its scheduled
+ * start, then the artist stops and starts it at will.
  */
 export const PressingState = new MoveEnum({ name: `${$moduleName}::PressingState`, fields: {
         /**
@@ -85,7 +85,7 @@ export const PressingState = new MoveEnum({ name: `${$moduleName}::PressingState
           * `Active` (in `mint_next`, before any sales logic), so a run reads `Scheduled`
           * only while it is still waiting. Between the start and that first sale the run
           * already sells — `is_selling` answers against the clock — so nobody has to go
-          * first for the drop to be open.
+          * first for the Pressing to be open.
           *
           * Consequence worth knowing: once the transition fires the start time is gone from
           * the object. `PressingOpenedEvent` and `PressingStateChangedEvent` carry it, so
@@ -190,7 +190,7 @@ export interface NewOptions {
     ];
 }
 /**
- * Open a release's pressing in `state` — `Scheduled` for a drop moment, `Active`
+ * Open a release's pressing in `state` — `Scheduled` for a future start, `Active`
  * to sell immediately, `Paused` to set it up quietly. Returns it unshared, so the
  * same transaction can list it (`listing::new`) before `share` puts it on chain,
  * plus the cap that governs it from here on. Neither value has `drop`, so neither

package/src/contracts/routed_stake/deps/royalty_pool/stake.ts

@@ -5,16 +5,22 @@
 
 /**
  * A position holding share tokens registered against a `RoyaltyPool`.
- * 
+ *
  * Stakes are owned objects with an immutable balance — to increase a holder's
  * total staked amount, mint additional Stake objects rather than modify an
  * existing one. This mirrors Sui's native staking model.
- * 
+ *
  * Each stake tracks the royalty pools it is currently registered with via an
  * inline `VecMap<TypeName, Registration>`, keyed by the pool's `Currency`
  * `TypeName`. The stake cannot be destroyed while any registrations remain. Pool
  * registrations are mutated by `royalty_pool::pool` through the package-private
  * accessors below.
+ *
+ * Custody warning: `pool::claim_rewards` pays accrued rewards to the _caller_, and
+ * `Stake` is `key + store` — a bare shared stake (or one wrapped in a shared
+ * object that hands out `&mut`) is drainable by anyone. Stakes must stay
+ * address-owned, or wrapped by a contract that pins the reward route (e.g.
+ * `routed_stake`); the pool cannot enforce this itself.
  */
 
 import { MoveStruct } from '../../../utils/index.js';

package/src/cover.ts

@@ -17,8 +17,9 @@
 import type { ClientWithCoreApi } from "@mysten/sui/client";
 import { bcs } from "@mysten/sui/bcs";
 import { deriveDynamicFieldID } from "@mysten/sui/utils";
+import type { Transaction, TransactionObjectArgument } from "@mysten/sui/transactions";
 import type { TxThunk } from "./transactions.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";
 import { OPTION_NONE, OPTION_SOME } from "./internal.ts";
 import * as coverArt from "./contracts/cover_art/cover_art.ts";
 import * as releaseCoverArt from "./contracts/release_cover_art/release_cover_art.ts";
@@ -34,7 +35,7 @@ function releaseAuthorityOf(input: ReleaseAuthorityInput): AdminCapAuthority {
 
 interface SetReleaseCoverParamsBase {
   /** The `Release` object to attach the cover to. */
-  releaseId: string;
+  releaseId: ObjectInput;
   /** Walrus blob id of the still cover image, as `u256` (decimal string or bigint). */
   stillBlobId: bigint | string;
   /** Optional animated-cover Walrus blob id (`u256`); omit for a still-only cover. */
@@ -46,6 +47,10 @@ interface SetReleaseCoverParamsBase {
   /** `ori` package (home of `walrus_data::new_blob` / the `WalrusData` type). */
   oriPackageId: string;
 }
+
+function object(tx: Transaction, value: ObjectInput): TransactionObjectArgument {
+  return typeof value === "string" ? tx.object(value) : value;
+}
 export type SetReleaseCoverParams = SetReleaseCoverParamsBase & ReleaseAuthorityInput;
 
 export type SetReleaseTrackCoverParams = SetReleaseCoverParams & {
@@ -85,7 +90,7 @@ export function setReleaseCover(p: SetReleaseCoverParams): TxThunk {
     const cover = buildCover(tx, p);
     invokeWithAdminCap(tx, releaseAuthorityOf(p), {
       target: `${p.releaseCoverArtPackageId}::release_cover_art::set_cover`,
-      arguments: [tx.object(p.releaseId), cover],
+      arguments: [object(tx, p.releaseId), cover],
       adminCapIndex: 1,
     });
   };
@@ -97,7 +102,7 @@ export function setReleaseTrackCover(p: SetReleaseTrackCoverParams): TxThunk {
     const cover = buildCover(tx, p);
     invokeWithAdminCap(tx, releaseAuthorityOf(p), {
       target: `${p.releaseCoverArtPackageId}::release_cover_art::set_track_cover`,
-      arguments: [tx.object(p.releaseId), tx.pure.u64(asU64("trackIndex", p.trackIndex)), cover],
+      arguments: [object(tx, p.releaseId), tx.pure.u64(asU64("trackIndex", p.trackIndex)), cover],
       adminCapIndex: 1,
     });
   };

package/src/credits.ts

@@ -44,7 +44,11 @@ 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";
+import { directAdminCap, invokeWithAdminCap, type AdminCapAuthority, type ObjectInput } from "./vault.ts";
+
+function object(tx: Transaction, value: ObjectInput): TransactionObjectArgument {
+  return typeof value === "string" ? tx.object(value) : value;
+}
 
 type CompositionAuthorityInput =
   | { readonly authority: AdminCapAuthority; readonly compositionAdminCapId?: never }
@@ -367,9 +371,9 @@ function buildCredit(
 
 interface AttachCompositionCreditParamsBase {
   /** The `Composition` object to credit on. */
-  compositionId: string;
+  compositionId: ObjectInput;
   /** The `Party` being credited. */
-  partyId: string;
+  partyId: ObjectInput;
   /** Human-readable name for the credit (≤200 bytes, non-empty). */
   displayName: string;
   /** 1–5 writing roles; duplicates are rejected on-chain. */
@@ -409,7 +413,7 @@ export function attachCompositionCredit(
     invokeWithAdminCap(tx, compositionAuthorityOf(p), {
       target: `${p.compositionCreditsPackageId}::composition_credits::add_credit`,
       typeArguments: [p.compositionShareType],
-      arguments: [tx.object(p.compositionId), tx.object(p.partyId), credit],
+      arguments: [object(tx, p.compositionId), object(tx, p.partyId), credit],
       adminCapIndex: 1,
     });
   };
@@ -417,9 +421,9 @@ export function attachCompositionCredit(
 
 interface AttachRecordingCreditParamsBase {
   /** The `Recording` object to credit on. */
-  recordingId: string;
+  recordingId: ObjectInput;
   /** The `Party` being credited. */
-  partyId: string;
+  partyId: ObjectInput;
   /** Human-readable name for the credit (≤200 bytes, non-empty). */
   displayName: string;
   /** 1–10 production/performance roles; duplicates are rejected on-chain. */
@@ -460,7 +464,7 @@ export function attachRecordingCredit(p: AttachRecordingCreditParams): TxThunk {
     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],
+      arguments: [object(tx, p.recordingId), object(tx, p.partyId), credit],
       adminCapIndex: 1,
     });
   };
@@ -468,9 +472,9 @@ export function attachRecordingCredit(p: AttachRecordingCreditParams): TxThunk {
 
 interface AddRecordingArtistParamsBase {
   /** The `Recording` object. */
-  recordingId: string;
+  recordingId: ObjectInput;
   /** The `Party` to designate. Must already be credited on the recording. */
-  partyId: string;
+  partyId: ObjectInput;
   /** The recording's own share coin type (the `RecordingShare` phantom). */
   recordingShareType: string;
   /** The parent composition's share coin type (the `CompositionShare` phantom). */
@@ -493,7 +497,7 @@ export function addRecordingPrimaryArtist(
     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)],
+      arguments: [object(tx, p.recordingId), object(tx, p.partyId)],
       adminCapIndex: 1,
     });
   };
@@ -511,7 +515,7 @@ export function addRecordingFeaturedArtist(
     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)],
+      arguments: [object(tx, p.recordingId), object(tx, p.partyId)],
       adminCapIndex: 1,
     });
   };
@@ -519,9 +523,9 @@ export function addRecordingFeaturedArtist(
 
 interface AddReleaseCreditParamsBase {
   /** The `Release` object to credit on. */
-  releaseId: string;
+  releaseId: ObjectInput;
   /** The `Party` being credited. */
-  partyId: string;
+  partyId: ObjectInput;
   /** Human-readable name for the credit (≤200 bytes, non-empty). */
   displayName: string;
   /** The single billing role: `"Primary"` or `"Featured"`. */
@@ -552,7 +556,7 @@ export function addReleaseCredit(p: AddReleaseCreditParams): TxThunk {
     );
     invokeWithAdminCap(tx, releaseAuthorityOf(p), {
       target: `${p.releaseCreditsPackageId}::release_credits::add_credit`,
-      arguments: [tx.object(p.releaseId), tx.object(p.partyId), credit],
+      arguments: [object(tx, p.releaseId), object(tx, p.partyId), credit],
       adminCapIndex: 1,
     });
   };

package/src/execute.ts

@@ -18,7 +18,14 @@ import type { TxThunk } from "./transactions.ts";
 // surface available through this platform-layer entry point as well.
 export * from "@misonetwork/sdk/execute";
 
-type FullInclude = typeof FULL_INCLUDE;
+/** Publication execution also needs lifecycle events to associate same-typed
+ * objects (notably several new Parties and Vaults) with their manifest refs. */
+export const PLATFORM_FULL_INCLUDE = { ...FULL_INCLUDE, events: true } as const;
+type PlatformFullInclude = typeof PLATFORM_FULL_INCLUDE;
+
+export interface PlatformExecResult extends ExecResult {
+  events: SuiClientTypes.Event[];
+}
 
 /**
  * Builds a transaction from thunks and executes it through the parallel executor,
@@ -32,8 +39,14 @@ type FullInclude = typeof FULL_INCLUDE;
  * job (e.g. a resumable checkpoint that reconciles against on-chain state). A Move
  * abort RESOLVES as a `FailedTransaction`, so `toExecResult` surfaces it too.
  */
-export async function executeViaExecutor(executor: ParallelTransactionExecutor, ...thunks: TxThunk[]): Promise<ExecResult> {
+export async function executeViaExecutor(
+  executor: ParallelTransactionExecutor,
+  ...thunks: TxThunk[]
+): Promise<PlatformExecResult> {
   const tx = await buildTx(...thunks);
-  const res: SuiClientTypes.TransactionResult<FullInclude> = await executor.executeTransaction(tx, FULL_INCLUDE);
-  return toExecResult(res);
+  const res: SuiClientTypes.TransactionResult<PlatformFullInclude> =
+    await executor.executeTransaction(tx, PLATFORM_FULL_INCLUDE);
+  const base = toExecResult(res);
+  if (res.$kind !== "Transaction") throw new Error("unreachable: toExecResult accepted a failed transaction");
+  return { ...base, events: res.Transaction.events ?? [] };
 }

package/src/index.ts

@@ -44,6 +44,7 @@ export * from "./execute.ts";
 export * from "./share.ts";
 export * from "./share-template.ts";
 export * from "./release-graph.ts";
+export * from "./publication.ts";
 export * from "./catalog.ts";
 
 // High-level, JSON-safe platform projections used directly by clients and by

package/src/pressing.ts

@@ -181,8 +181,8 @@ export interface OpenPressingParams {
   /** Currencies to open the run in. May be empty — listings can be added later with
    *  {@link openListing} — but a run with no listings sells nothing. */
   listings: ListingTerms[];
-  /** Run state at open. Defaults to `active` (sell immediately); `scheduled` is the
-   *  trustless drop moment, and needs no later transaction to open. */
+  /** Run state at open. Defaults to `active` (sell immediately); `scheduled` sets a
+   *  trustless opening time and needs no later transaction to open. */
   state?: PressingRunState;
   /** Where to send the minted `PressingAdminCap` (usually the artist or their vault). */
   adminCapRecipient: string;
@@ -518,10 +518,10 @@ function variant<T extends string>(
 /**
  * Fetches and parses a `Pressing`, or `null` if the release has never opened one.
  *
- * NOTE: like the old drop reader, this deliberately deviates from the core-getter
- * convention in `./queries.ts` (throw on missing object). A pressing's address is
- * computable for ANY release, so probing one that was never opened is a normal state,
- * not a broken reference — absence is `null` and only transport failures throw.
+ * This deliberately deviates from the core-getter convention in `./queries.ts`
+ * (throw on missing object). A Pressing's address is computable for any release, so
+ * probing one that was never opened is a normal state, not a broken reference —
+ * absence is `null` and only transport failures throw.
  */
 export async function getPressing(
   client: ClientWithCoreApi,