@misofm/sdk 0.5.0 → 0.7.1

package/README.md

@@ -207,7 +207,8 @@ const thunk = client.misoPlatform.tx.publishComposition({
 `client.misoPlatform.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
+`misoPackageId`/`minatoPackageId`/`releaseRegistryPackageId`/`releaseRegistryId`
+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.
@@ -218,7 +219,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 +233,7 @@ const thunk = publishReleaseGraph({
   },
   misoPackageId: "0x...",
   minatoPackageId: "0x...",
+  releaseRegistryPackageId: "0x...",
 });
 ```
 
@@ -373,7 +375,7 @@ carry an optional `RecordingRoleLevel` (`Producer`, `Vocalist`, `Engineer`,
 
 ```
 src/
-  client.ts              the client extension — misoPlatform({ packageId, settingsId, misoPackageId?, minatoPackageId? })
+  client.ts              the client extension — misoPlatform({ packageId, settingsId, misoPackageId?, minatoPackageId?, releaseRegistryPackageId?, releaseRegistryId? })
   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,17 +403,19 @@ 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`
 
@@ -432,8 +436,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.5.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

@@ -2,9 +2,10 @@ 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 * 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";
 export interface MisoPlatformConfig {
     /** The published `miso_pressing` package. */
@@ -27,11 +28,17 @@ 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);
@@ -66,6 +73,7 @@ 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>;
@@ -73,6 +81,7 @@ export declare class MisoPlatformClient {
     readonly call: {
         listing: typeof listingContract;
         pressing: typeof pressingContract;
+        releaseRegistry: typeof releaseRegistry;
     };
     /** Generated BCS definitions, for parsing objects or events yourself. */
     readonly bcs: {
@@ -117,6 +126,13 @@ 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">;
     };
 }
 /**

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

@@ -2,8 +2,9 @@
 // SPDX-License-Identifier: Apache-2.0
 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";
 export class MisoPlatformClient {
     #client;
@@ -26,7 +27,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 +39,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 +88,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,13 +105,15 @@ export class MisoPlatformClient {
     }
     // ── Generated layer ───────────────────────────────────────────────────────
     /** Generated Move-call bindings, for commands this facade doesn't wrap. */
-    call = { listing: listingContract, pressing: pressingContract };
+    call = { listing: listingContract, pressing: pressingContract, 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,
     };
 }
 /**

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":"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"}

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"}

package/dist/contracts/release_registry/release_registry.js

@@ -0,0 +1,119 @@
+/**************************************************************
+ * 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, normalizeMoveArguments } from '../utils/index.js';
+import { bcs } from '@mysten/sui/bcs';
+import {} from '@mysten/sui/transactions';
+const $moduleName = '@local-pkg/release_registry::release_registry';
+export const ReleaseRegistry = new MoveStruct({ name: `${$moduleName}::ReleaseRegistry`, fields: {
+        id: bcs.Address
+    } });
+export const ReleaseRegistryCreatedEvent = new MoveStruct({ name: `${$moduleName}::ReleaseRegistryCreatedEvent`, fields: {
+        registry_id: bcs.Address,
+        created_by: bcs.Address
+    } });
+/**
+ * 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 function newRelease(options) {
+    const packageAddress = options.package ?? '@local-pkg/release_registry';
+    const argumentsTypes = [
+        null,
+        '0x1::string::String',
+        'vector<null>',
+        'u256'
+    ];
+    const parameterNames = ["self", "title", "tracks", "nonce"];
+    return (tx) => tx.moveCall({
+        package: packageAddress,
+        module: 'release_registry',
+        function: 'new_release',
+        arguments: normalizeMoveArguments(options.arguments, argumentsTypes, parameterNames),
+    });
+}
+/**
+ * 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 function deriveTargetReleaseId(options) {
+    const packageAddress = options.package ?? '@local-pkg/release_registry';
+    const argumentsTypes = [
+        null,
+        'vector<0x2::object::ID>',
+        'vector<u64>',
+        'u256'
+    ];
+    const parameterNames = ["self", "recordingIds", "trackSplitValues", "nonce"];
+    return (tx) => tx.moveCall({
+        package: packageAddress,
+        module: 'release_registry',
+        function: 'derive_target_release_id',
+        arguments: normalizeMoveArguments(options.arguments, argumentsTypes, parameterNames),
+    });
+}
+/**
+ * Returns the registry's object id — the derivation parent that
+ * `derive_target_release_id` and `new_release` both commit to.
+ */
+export function id(options) {
+    const packageAddress = options.package ?? '@local-pkg/release_registry';
+    const argumentsTypes = [
+        null
+    ];
+    const parameterNames = ["self"];
+    return (tx) => tx.moveCall({
+        package: packageAddress,
+        module: 'release_registry',
+        function: 'id',
+        arguments: normalizeMoveArguments(options.arguments, argumentsTypes, parameterNames),
+    });
+}
+//# sourceMappingURL=release_registry.js.map

package/dist/contracts/release_registry/release_registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"release_registry.js","sourceRoot":"","sources":["../../../src/contracts/release_registry/release_registry.ts"],"names":[],"mappings":"AAAA;;gEAEgE;AAGhE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAEH,OAAO,EAAE,UAAU,EAAE,sBAAsB,EAA+B,MAAM,mBAAmB,CAAC;AACpG,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AACtC,OAAO,EAA8C,MAAM,0BAA0B,CAAC;AACtF,MAAM,WAAW,GAAG,+CAA+C,CAAC;AACpE,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,UAAU,CAAC,EAAE,IAAI,EAAE,GAAG,WAAW,mBAAmB,EAAE,MAAM,EAAE;QACzF,EAAE,EAAE,GAAG,CAAC,OAAO;KAClB,EAAE,CAAC,CAAC;AACT,MAAM,CAAC,MAAM,2BAA2B,GAAG,IAAI,UAAU,CAAC,EAAE,IAAI,EAAE,GAAG,WAAW,+BAA+B,EAAE,MAAM,EAAE;QACjH,WAAW,EAAE,GAAG,CAAC,OAAO;QACxB,UAAU,EAAE,GAAG,CAAC,OAAO;KAC1B,EAAE,CAAC,CAAC;AAgBT;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,OAA0B;IACjD,MAAM,cAAc,GAAG,OAAO,CAAC,OAAO,IAAI,6BAA6B,CAAC;IACxE,MAAM,cAAc,GAAG;QACnB,IAAI;QACJ,qBAAqB;QACrB,cAAc;QACd,MAAM;KACmB,CAAC;IAC9B,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC5D,OAAO,CAAC,EAAe,EAAE,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC;QACpC,OAAO,EAAE,cAAc;QACvB,MAAM,EAAE,kBAAkB;QAC1B,QAAQ,EAAE,aAAa;QACvB,SAAS,EAAE,sBAAsB,CAAC,OAAO,CAAC,SAAS,EAAE,cAAc,EAAE,cAAc,CAAC;KACvF,CAAC,CAAC;AACP,CAAC;AAgBD;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAqC;IACvE,MAAM,cAAc,GAAG,OAAO,CAAC,OAAO,IAAI,6BAA6B,CAAC;IACxE,MAAM,cAAc,GAAG;QACnB,IAAI;QACJ,yBAAyB;QACzB,aAAa;QACb,MAAM;KACmB,CAAC;IAC9B,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,cAAc,EAAE,kBAAkB,EAAE,OAAO,CAAC,CAAC;IAC7E,OAAO,CAAC,EAAe,EAAE,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC;QACpC,OAAO,EAAE,cAAc;QACvB,MAAM,EAAE,kBAAkB;QAC1B,QAAQ,EAAE,0BAA0B;QACpC,SAAS,EAAE,sBAAsB,CAAC,OAAO,CAAC,SAAS,EAAE,cAAc,EAAE,cAAc,CAAC;KACvF,CAAC,CAAC;AACP,CAAC;AAUD;;;GAGG;AACH,MAAM,UAAU,EAAE,CAAC,OAAkB;IACjC,MAAM,cAAc,GAAG,OAAO,CAAC,OAAO,IAAI,6BAA6B,CAAC;IACxE,MAAM,cAAc,GAAG;QACnB,IAAI;KACqB,CAAC;IAC9B,MAAM,cAAc,GAAG,CAAC,MAAM,CAAC,CAAC;IAChC,OAAO,CAAC,EAAe,EAAE,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC;QACpC,OAAO,EAAE,cAAc;QACvB,MAAM,EAAE,kBAAkB;QAC1B,QAAQ,EAAE,IAAI;QACd,SAAS,EAAE,sBAAsB,CAAC,OAAO,CAAC,SAAS,EAAE,cAAc,EAAE,cAAc,CAAC;KACvF,CAAC,CAAC;AACP,CAAC"}

package/dist/contracts/royalty_pool/pool.d.ts

@@ -2,7 +2,7 @@
  * THIS FILE IS GENERATED AND SHOULD NOT BE MANUALLY MODIFIED *
  **************************************************************/
 /**
- * Generic accumulator-based royalty distribution pool.
+ * Accumulator-based royalty distribution pool for the protocol's share tokens.
  *
  * A `RoyaltyPool<Share, Currency>` is a derived object of any UID-bearing parent.
  * Its address is deterministically derived from `(parent_id, Currency)` — at most
@@ -19,7 +19,33 @@
  * transfers or balances credited to the pool's funds-accumulator. Both are
  * permissionless: anyone who notices stuck funds can fold them in. The canonical
  * funding path remains `deposit(balance)` from a higher-layer extension (e.g.
- * `composition_royalty_distributor`) that pulls from the parent's address.
+ * `composition_royalty_distributor`) that pulls from the parent's address. Note
+ * the recovery valves run through `deposit`, which aborts while no shares are
+ * staked — and the pool has no other withdrawal path — so funds sent to the pool's
+ * address before the first registration stay locked until a stake registers.
+ * Payers should always target the parent's address, never the pool's.
+ *
+ * ### No activation delay (deliberate)
+ *
+ * Registration earns from the next deposit onward; there is no bonding or
+ * unbonding period (contrast Sui native staking's next-epoch activation). With the
+ * protocol's fixed-supply share token this is safe: a stake's take of any deposit
+ * is `v · s / S` with `S` (total registered) bounded by the share supply, so a
+ * continuously registered stake is guaranteed at least its pro-rata share of total
+ * supply on every deposit. Short-lived or just-in-time registrations can only
+ * compete for the _unregistered_ supply's drift — the designed incentive for being
+ * registered — never below any registered stake's floor.
+ *
+ * ### Precision
+ *
+ * The share token's shape is fixed at issuance by the protocol — exactly 10¹³ base
+ * units, 6 decimals, supply made immutable via `miso_share::share::initialize`
+ * (`make_supply_fixed`) — so `staked_shares ≤ 10¹³` objectively. A deposit of
+ * `value ≥ 1` base units therefore advances the accumulator by
+ * `value · PRECISION / staked_shares ≥ 10¹⁸ / 10¹³ = 10⁵`: the truncation-to-zero
+ * case that would permanently lock a deposit in the pool balance is impossible by
+ * construction, not by convention. Sub-base-unit claim residue (the remaining
+ * source of locked dust) is documented on `unregister_stake`.
  */
 import { MoveStruct, MoveTuple, type RawTransactionArgument } from '../utils/index.js';
 import { type Transaction, type TransactionArgument } from '@mysten/sui/transactions';

package/dist/contracts/royalty_pool/pool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../../../src/contracts/royalty_pool/pool.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../../../src/contracts/royalty_pool/pool.ts"],"names":[],"mappings":"AAAA;;gEAEgE;AAGhE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAA0B,KAAK,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAE/G,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAGtF,eAAO,MAAM,WAAW;;;;;;;IAKhB;;;OAGG;;iFAEH,CAAC;AACT,eAAO,MAAM,cAAc,sJAAoG,CAAC;AAChI,eAAO,MAAM,uBAAuB;;;6FAG5B,CAAC;AACT,eAAO,MAAM,qBAAqB;;;2FAG1B,CAAC;AACT,eAAO,MAAM,oBAAoB;;;;0FAIzB,CAAC;AACT,eAAO,MAAM,sBAAsB;;;;4FAI3B,CAAC;AACT,eAAO,MAAM,mBAAmB;;;;yFAIxB,CAAC;AACT,MAAM,WAAW,YAAY;IACzB,MAAM,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;CAC1C;AACD,MAAM,WAAW,UAAU;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,YAAY,GAAG;QACtB,MAAM,EAAE,sBAAsB,CAAC,MAAM,CAAC;KACzC,CAAC;IACF,aAAa,EAAE;QACX,MAAM;QACN,MAAM;KACT,CAAC;CACL;AACD;;;;;;;GAOG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,UAAU,IAM5B,IAAI,WAAW,0DAO1B;AACD,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;CACxC;AACD,MAAM,WAAW,YAAY;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,cAAc,GAAG;QACxB,IAAI,EAAE,sBAAsB,CAAC,MAAM,CAAC;KACvC,CAAC;IACF,aAAa,EAAE;QACX,MAAM;QACN,MAAM;KACT,CAAC;CACL;AACD,0EAA0E;AAC1E,wBAAgB,KAAK,CAAC,OAAO,EAAE,YAAY,IAM/B,IAAI,WAAW,0DAO1B;AACD,MAAM,WAAW,gBAAgB;IAC7B,IAAI,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;IACrC,OAAO,EAAE,mBAAmB,CAAC;CAChC;AACD,MAAM,WAAW,cAAc;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,gBAAgB,GAAG;QAC1B,IAAI,EAAE,sBAAsB,CAAC,MAAM,CAAC;QACpC,OAAO,EAAE,mBAAmB;KAC/B,CAAC;IACF,aAAa,EAAE;QACX,MAAM;QACN,MAAM;KACT,CAAC;CACL;AACD;;;;;;;;GAQG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,cAAc,IAOnC,IAAI,WAAW,0DAO1B;AACD,MAAM,WAAW,0BAA0B;IACvC,IAAI,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;IACrC,KAAK,EAAE,mBAAmB,CAAC;CAC9B;AACD,MAAM,WAAW,wBAAwB;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,0BAA0B,GAAG;QACpC,IAAI,EAAE,sBAAsB,CAAC,MAAM,CAAC;QACpC,KAAK,EAAE,mBAAmB;KAC7B,CAAC;IACF,aAAa,EAAE;QACX,MAAM;QACN,MAAM;KACT,CAAC;CACL;AACD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,IAOvD,IAAI,WAAW,0DAO1B;AACD,MAAM,WAAW,yBAAyB;IACtC,IAAI,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;IACrC,KAAK,EAAE,sBAAsB,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;CAClD;AACD,MAAM,WAAW,uBAAuB;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,yBAAyB,GAAG;QACnC,IAAI,EAAE,sBAAsB,CAAC,MAAM,CAAC;QACpC,KAAK,EAAE,sBAAsB,CAAC,MAAM,GAAG,MAAM,CAAC;KACjD,CAAC;IACF,aAAa,EAAE;QACX,MAAM;QACN,MAAM;KACT,CAAC;CACL;AACD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,IAOrD,IAAI,WAAW,0DAO1B;AACD,MAAM,WAAW,sBAAsB;IACnC,IAAI,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;IACrC,KAAK,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;CACzC;AACD,MAAM,WAAW,oBAAoB;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,sBAAsB,GAAG;QAChC,IAAI,EAAE,sBAAsB,CAAC,MAAM,CAAC;QACpC,KAAK,EAAE,sBAAsB,CAAC,MAAM,CAAC;KACxC,CAAC;IACF,aAAa,EAAE;QACX,MAAM;QACN,MAAM;KACT,CAAC;CACL;AACD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,IAO/C,IAAI,WAAW,0DAO1B;AACD,MAAM,WAAW,wBAAwB;IACrC,IAAI,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;IACrC,KAAK,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;CACzC;AACD,MAAM,WAAW,sBAAsB;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,wBAAwB,GAAG;QAClC,IAAI,EAAE,sBAAsB,CAAC,MAAM,CAAC;QACpC,KAAK,EAAE,sBAAsB,CAAC,MAAM,CAAC;KACxC,CAAC;IACF,aAAa,EAAE;QACX,MAAM;QACN,MAAM;KACT,CAAC;CACL;AACD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,IAOnD,IAAI,WAAW,0DAO1B;AACD,MAAM,WAAW,qBAAqB;IAClC,IAAI,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;IACrC,KAAK,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;CACzC;AACD,MAAM,WAAW,mBAAmB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,qBAAqB,GAAG;QAC/B,IAAI,EAAE,sBAAsB,CAAC,MAAM,CAAC;QACpC,KAAK,EAAE,sBAAsB,CAAC,MAAM,CAAC;KACxC,CAAC;IACF,aAAa,EAAE;QACX,MAAM;QACN,MAAM;KACT,CAAC;CACL;AACD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,IAO7C,IAAI,WAAW,0DAO1B;AACD,MAAM,WAAW,uBAAuB;IACpC,IAAI,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;IACrC,KAAK,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;CACzC;AACD,MAAM,WAAW,qBAAqB;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,uBAAuB,GAAG;QACjC,IAAI,EAAE,sBAAsB,CAAC,MAAM,CAAC;QACpC,KAAK,EAAE,sBAAsB,CAAC,MAAM,CAAC;KACxC,CAAC;IACF,aAAa,EAAE;QACX,MAAM;QACN,MAAM;KACT,CAAC;CACL;AACD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,qBAAqB,IAOjD,IAAI,WAAW,0DAO1B;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;IACF,aAAa,EAAE;QACX,MAAM;QACN,MAAM;KACT,CAAC;CACL;AACD,wBAAgB,EAAE,CAAC,OAAO,EAAE,SAAS,IAMzB,IAAI,WAAW,0DAO1B;AACD,MAAM,WAAW,gBAAgB;IAC7B,IAAI,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;CACxC;AACD,MAAM,WAAW,cAAc;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,gBAAgB,GAAG;QAC1B,IAAI,EAAE,sBAAsB,CAAC,MAAM,CAAC;KACvC,CAAC;IACF,aAAa,EAAE;QACX,MAAM;QACN,MAAM;KACT,CAAC;CACL;AACD,wBAAgB,OAAO,CAAC,OAAO,EAAE,cAAc,IAMnC,IAAI,WAAW,0DAO1B;AACD,MAAM,WAAW,qBAAqB;IAClC,IAAI,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;CACxC;AACD,MAAM,WAAW,mBAAmB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,qBAAqB,GAAG;QAC/B,IAAI,EAAE,sBAAsB,CAAC,MAAM,CAAC;KACvC,CAAC;IACF,aAAa,EAAE;QACX,MAAM;QACN,MAAM;KACT,CAAC;CACL;AACD,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,IAM7C,IAAI,WAAW,0DAO1B;AACD,MAAM,WAAW,iCAAiC;IAC9C,IAAI,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;CACxC;AACD,MAAM,WAAW,+BAA+B;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,iCAAiC,GAAG;QAC3C,IAAI,EAAE,sBAAsB,CAAC,MAAM,CAAC;KACvC,CAAC;IACF,aAAa,EAAE;QACX,MAAM;QACN,MAAM;KACT,CAAC;CACL;AACD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,+BAA+B,IAMrE,IAAI,WAAW,0DAO1B;AACD,MAAM,WAAW,2BAA2B;IACxC,IAAI,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;CACxC;AACD,MAAM,WAAW,yBAAyB;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,2BAA2B,GAAG;QACrC,IAAI,EAAE,sBAAsB,CAAC,MAAM,CAAC;KACvC,CAAC;IACF,aAAa,EAAE;QACX,MAAM;QACN,MAAM;KACT,CAAC;CACL;AACD,gFAAgF;AAChF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,IAMzD,IAAI,WAAW,0DAO1B;AACD,MAAM,WAAW,uBAAuB;IACpC,QAAQ,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;CAC5C;AACD,MAAM,WAAW,qBAAqB;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,uBAAuB,GAAG;QACjC,QAAQ,EAAE,sBAAsB,CAAC,MAAM,CAAC;KAC3C,CAAC;IACF,aAAa,EAAE;QACX,MAAM;KACT,CAAC;CACL;AACD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,qBAAqB,IAMjD,IAAI,WAAW,0DAO1B;AACD,MAAM,WAAW,0BAA0B;IACvC,IAAI,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;IACrC,QAAQ,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;CAC5C;AACD,MAAM,WAAW,wBAAwB;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,0BAA0B,GAAG;QACpC,IAAI,EAAE,sBAAsB,CAAC,MAAM,CAAC;QACpC,QAAQ,EAAE,sBAAsB,CAAC,MAAM,CAAC;KAC3C,CAAC;IACF,aAAa,EAAE;QACX,MAAM;QACN,MAAM;KACT,CAAC;CACL;AACD,iFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,IAOvD,IAAI,WAAW,0DAO1B"}

package/dist/contracts/royalty_pool/pool.js

@@ -2,7 +2,7 @@
  * THIS FILE IS GENERATED AND SHOULD NOT BE MANUALLY MODIFIED *
  **************************************************************/
 /**
- * Generic accumulator-based royalty distribution pool.
+ * Accumulator-based royalty distribution pool for the protocol's share tokens.
  *
  * A `RoyaltyPool<Share, Currency>` is a derived object of any UID-bearing parent.
  * Its address is deterministically derived from `(parent_id, Currency)` — at most
@@ -19,7 +19,33 @@
  * transfers or balances credited to the pool's funds-accumulator. Both are
  * permissionless: anyone who notices stuck funds can fold them in. The canonical
  * funding path remains `deposit(balance)` from a higher-layer extension (e.g.
- * `composition_royalty_distributor`) that pulls from the parent's address.
+ * `composition_royalty_distributor`) that pulls from the parent's address. Note
+ * the recovery valves run through `deposit`, which aborts while no shares are
+ * staked — and the pool has no other withdrawal path — so funds sent to the pool's
+ * address before the first registration stay locked until a stake registers.
+ * Payers should always target the parent's address, never the pool's.
+ *
+ * ### No activation delay (deliberate)
+ *
+ * Registration earns from the next deposit onward; there is no bonding or
+ * unbonding period (contrast Sui native staking's next-epoch activation). With the
+ * protocol's fixed-supply share token this is safe: a stake's take of any deposit
+ * is `v · s / S` with `S` (total registered) bounded by the share supply, so a
+ * continuously registered stake is guaranteed at least its pro-rata share of total
+ * supply on every deposit. Short-lived or just-in-time registrations can only
+ * compete for the _unregistered_ supply's drift — the designed incentive for being
+ * registered — never below any registered stake's floor.
+ *
+ * ### Precision
+ *
+ * The share token's shape is fixed at issuance by the protocol — exactly 10¹³ base
+ * units, 6 decimals, supply made immutable via `miso_share::share::initialize`
+ * (`make_supply_fixed`) — so `staked_shares ≤ 10¹³` objectively. A deposit of
+ * `value ≥ 1` base units therefore advances the accumulator by
+ * `value · PRECISION / staked_shares ≥ 10¹⁸ / 10¹³ = 10⁵`: the truncation-to-zero
+ * case that would permanently lock a deposit in the pool balance is impossible by
+ * construction, not by convention. Sub-base-unit claim residue (the remaining
+ * source of locked dust) is documented on `unregister_stake`.
  */
 import { MoveStruct, MoveTuple, normalizeMoveArguments } from '../utils/index.js';
 import { bcs } from '@mysten/sui/bcs';