@misofm/musicos 0.1.0

package/dist/contracts/musicos/deps/bps/bps.js

@@ -0,0 +1,19 @@
+/**************************************************************
+ * THIS FILE IS GENERATED AND SHOULD NOT BE MANUALLY MODIFIED *
+ **************************************************************/
+/**
+ * Basis-points arithmetic with a newtype wrapper.
+ *
+ * 1 bps = 0.01%. 10_000 bps = 100%.
+ *
+ * Storage-optimal: `BPS` stores a `u16` (2 bytes), the tightest width that fits
+ * the `[0, 10_000]` range. Apply functions cover every standard integer width
+ * (`u8` through `u256`). Arithmetic on `u8`–`u128` widens to the next-larger type
+ * before multiplying. `u256` uses quotient/remainder decomposition and is total
+ * over its entire input domain.
+ */
+import { MoveTuple } from '../../../utils/index.js';
+import { bcs } from '@mysten/sui/bcs';
+const $moduleName = 'bps::bps';
+export const BPS = new MoveTuple({ name: `${$moduleName}::BPS`, fields: [bcs.u16()] });
+//# sourceMappingURL=bps.js.map

package/dist/contracts/musicos/deps/bps/bps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bps.js","sourceRoot":"","sources":["../../../../../src/contracts/musicos/deps/bps/bps.ts"],"names":[],"mappings":"AAAA;;gEAEgE;AAGhE;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAEtC,MAAM,WAAW,GAAG,UAAU,CAAC;AAC/B,MAAM,CAAC,MAAM,GAAG,GAAG,IAAI,SAAS,CAAC,EAAE,IAAI,EAAE,GAAG,WAAW,OAAO,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC"}

package/dist/contracts/musicos/recording.d.ts

@@ -0,0 +1,238 @@
+/**************************************************************
+ * THIS FILE IS GENERATED AND SHOULD NOT BE MANUALLY MODIFIED *
+ **************************************************************/
+/**
+ * Represents an audio recording of a composition in musicos. Recordings are the
+ * audio performances that are distributed and played. Each recording has its own
+ * share token for ownership distribution.
+ *
+ * ### Key Features:
+ *
+ * - Share token initialization with fixed supply (10M tokens, 6 decimals)
+ * - State machine: Initialized -> Published (embedded fields immutable after
+ *   publish; dynamic fields remain extensible via `uid_mut`, e.g. masters, and
+ *   credits/attribution attached by the credits extension)
+ * - Deterministic addresses via derived object pattern
+ *
+ * Attribution (credits, primary/featured artists) is intentionally NOT part of
+ * core: it is display-oriented, varies across platforms, and is never read by the
+ * economics. It lives in a first-party credits extension attached via `uid_mut`,
+ * so core takes no dependency on an identity package and core publish enforces no
+ * attribution.
+ *
+ * A recording carries no name of its own. Its display title is its composition's
+ * title, read by reference — composition titles are immutable, so an embedded copy
+ * would carry no information. Anything that names this particular take — "(Live)",
+ * "Radio Edit", a translated title — has more than one correct rendering, which
+ * makes it presentation, and presentation lives in the metadata extension, never
+ * in the frozen core. Core stores what a recording _is_; extensions describe it.
+ *
+ * ### Lifecycle and trust model
+ *
+ * A recording is `key`-only with no `drop`: a fresh `Initialized` object cannot be
+ * transferred, wrapped, publicly shared, or discarded, and its only by-value
+ * consumer is `publish`. Create-and-publish is therefore atomic by construction —
+ * an `Initialized` recording cannot outlive its creating transaction, and every
+ * recording that exists on-chain is `Published` and shared. There is deliberately
+ * no keep function; staged building must fit one transaction.
+ *
+ * `uid_mut` works in any lifecycle state and is permanent root over ALL dynamic
+ * fields on the object — including fields attached by other extensions. "Immutable
+ * after publish" covers the embedded fields only; extension-layer data stays
+ * admin-mutable in perpetuity. This is the designed extension surface, and it is
+ * the one trust assumption that never expires: integrators should model the cap
+ * holder as able to mutate or delete any extension data, forever.
+ *
+ * The recording carries its parent composition's identity two ways. The
+ * `CompositionShare` phantom type parameter is the durable identity (a share
+ * currency is published independently of musicos and survives a fresh republish,
+ * whereas an object ID does not) and makes the recording↔composition lineage
+ * compile-time enforced wherever the two meet. The embedded `composition_id` is
+ * the address-level handle: Move cannot chase a type (or an ID) to an object, so
+ * on-chain consumers holding only `&Recording` — or a bare `Track` — could not
+ * otherwise reach the composition at all. Both are set at creation and immutable,
+ * so they cannot diverge.
+ *
+ * A recording is its own freshly-created object (`object::new`), not a derived
+ * child of its composition: `recording::new` takes a read-only `&Composition`
+ * (only to read its royalty rate and id), so publishing recordings under a
+ * composition neither contends on the composition's shared-object version nor
+ * collides on a per-composition index.
+ */
+import { MoveEnum, MoveStruct, MoveTuple, type RawTransactionArgument } from '../utils/index.ts';
+import { type Transaction } from '@mysten/sui/transactions';
+/** Lifecycle state of a recording. */
+export declare const RecordingState: MoveEnum<{
+    /** Recording is being set up and can be modified. */
+    Initialized: null;
+    /** Recording is published and immutable. Includes publication timestamp. */
+    Published: import("@mysten/bcs").BcsType<string, string | number | bigint, "u64">;
+}, "@local-pkg/musicos::recording::RecordingState">;
+export declare const Recording: MoveStruct<{
+    /** Unique identifier for this recording. */
+    id: import("@mysten/bcs").BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
+    /** Current lifecycle state. */
+    state: MoveEnum<{
+        /** Recording is being set up and can be modified. */
+        Initialized: null;
+        /** Recording is published and immutable. Includes publication timestamp. */
+        Published: import("@mysten/bcs").BcsType<string, string | number | bigint, "u64">;
+    }, "@local-pkg/musicos::recording::RecordingState">;
+    /**
+     * Object ID of the parent composition. The address-level counterpart of the
+     * `CompositionShare` phantom, set from the `&Composition` passed to `new` (the
+     * shared phantom proves the pairing). An identity handle — not a revenue routing
+     * target: the composition is paid through its recording-share ownership, settled
+     * at creation.
+     */
+    composition_id: import("@mysten/bcs").BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
+}, "@local-pkg/musicos::recording::Recording<phantom RecordingShare, phantom CompositionShare>">;
+export declare const RecordingAdminCap: MoveStruct<{
+    /** Unique identifier for this capability. */
+    id: import("@mysten/bcs").BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
+}, "@local-pkg/musicos::recording::RecordingAdminCap<phantom RecordingShare>">;
+export declare const RecordingAdminCapKey: MoveTuple<readonly [import("@mysten/bcs").BcsType<boolean, boolean, "bool">], "@local-pkg/musicos::recording::RecordingAdminCapKey">;
+export declare const RecordingPublishedEvent: MoveStruct<{
+    recording_id: import("@mysten/bcs").BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
+}, "@local-pkg/musicos::recording::RecordingPublishedEvent<phantom RecordingShare, phantom CompositionShare>">;
+export declare const CompositionSharesGrantedEvent: MoveStruct<{
+    recording_id: import("@mysten/bcs").BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
+    composition_id: import("@mysten/bcs").BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
+    /** Recording-share base units granted to the composition. */
+    value: import("@mysten/bcs").BcsType<string, string | number | bigint, "u64">;
+    /** The composition royalty rate applied at creation, in basis points. */
+    rate_bps: import("@mysten/bcs").BcsType<number, number, "u16">;
+    granted_by: import("@mysten/bcs").BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
+}, "@local-pkg/musicos::recording::CompositionSharesGrantedEvent<phantom RecordingShare, phantom CompositionShare>">;
+export interface NewArguments {
+    composition: RawTransactionArgument<string>;
+    shareCurrency: RawTransactionArgument<string>;
+    shareTreasuryCap: RawTransactionArgument<string>;
+}
+export interface NewOptions {
+    package?: string;
+    arguments: NewArguments | [
+        composition: RawTransactionArgument<string>,
+        shareCurrency: RawTransactionArgument<string>,
+        shareTreasuryCap: RawTransactionArgument<string>
+    ];
+    typeArguments: [
+        string,
+        string
+    ];
+}
+/**
+ * Creates a new recording for a composition.
+ *
+ * Initializes share tokens (10M supply, 6 decimals), then splits the composition's
+ * royalty-rate worth of those shares off the freshly minted supply and
+ * `send_funds`es them to the composition's address. This settles the composition's
+ * cut as cap-table ownership: the composition literally owns its share of the
+ * recording, so its claim on recording revenue is enforced by share ownership
+ * rather than by any revenue distributor choosing to honor a rate. What the
+ * composition owner then does with the shares (hold, stake, sell) is outside the
+ * protocol's scope.
+ *
+ * The composition's royalty rate is immutable, so the rate a recorder's client
+ * displayed is exactly the rate applied here — no slippage protection is needed or
+ * possible. Whether that rate is acceptable is the recorder's decision to make
+ * before calling; per-deal deviations settle as voluntary share transfers after
+ * creation.
+ *
+ * The composition need not be `Published`: within the composition's own creating
+ * transaction its creator can already mint recordings against it. Third parties
+ * only ever see `Published`, shared compositions (an `Initialized` one cannot
+ * escape its creating transaction), so indexers may observe a recording created
+ * "against an unpublished composition" only as an intra-transaction ordering,
+ * never across transactions.
+ *
+ * Returns:
+ *
+ * - The recording object (typed to its parent composition's `CompositionShare`)
+ * - Admin capability for the owner
+ * - The creator's remaining share balance (full supply minus the composition's
+ *   cut)
+ */
+export declare function _new(options: NewOptions): (tx: Transaction) => import("@mysten/sui/transactions").TransactionResult;
+export interface PublishArguments {
+    self: RawTransactionArgument<string>;
+    _: RawTransactionArgument<string>;
+}
+export interface PublishOptions {
+    package?: string;
+    arguments: PublishArguments | [
+        self: RawTransactionArgument<string>,
+        _: RawTransactionArgument<string>
+    ];
+    typeArguments: [
+        string,
+        string
+    ];
+}
+/**
+ * Publishes the recording, making its embedded fields immutable. Required State:
+ * Initialized
+ *
+ * Note: core enforces no attribution requirement — credits live in the credits
+ * extension and may be attached before or after publish via `uid_mut`.
+ */
+export declare function publish(options: PublishOptions): (tx: Transaction) => import("@mysten/sui/transactions").TransactionResult;
+export interface CompositionIdArguments {
+    self: RawTransactionArgument<string>;
+}
+export interface CompositionIdOptions {
+    package?: string;
+    arguments: CompositionIdArguments | [
+        self: RawTransactionArgument<string>
+    ];
+    typeArguments: [
+        string,
+        string
+    ];
+}
+/**
+ * Returns the object ID of the parent composition. An identity/membership handle
+ * (the address-level counterpart of the `CompositionShare` phantom) — not a
+ * revenue routing target: the composition is paid via its recording-share
+ * ownership.
+ */
+export declare function compositionId(options: CompositionIdOptions): (tx: Transaction) => import("@mysten/sui/transactions").TransactionResult;
+export interface UidArguments {
+    self: RawTransactionArgument<string>;
+}
+export interface UidOptions {
+    package?: string;
+    arguments: UidArguments | [
+        self: RawTransactionArgument<string>
+    ];
+    typeArguments: [
+        string,
+        string
+    ];
+}
+/** Returns a reference to the recording's UID for reading dynamic fields. */
+export declare function uid(options: UidOptions): (tx: Transaction) => import("@mysten/sui/transactions").TransactionResult;
+export interface UidMutArguments {
+    self: RawTransactionArgument<string>;
+    _: RawTransactionArgument<string>;
+}
+export interface UidMutOptions {
+    package?: string;
+    arguments: UidMutArguments | [
+        self: RawTransactionArgument<string>,
+        _: RawTransactionArgument<string>
+    ];
+    typeArguments: [
+        string,
+        string
+    ];
+}
+/**
+ * Returns a mutable reference to the recording's UID. Requires the admin
+ * capability. Works in any lifecycle state — dynamic fields are the extension
+ * surface (e.g. masters, credits) and stay admin-mutable after publish; only the
+ * embedded fields are frozen. The reference is root over every dynamic field on
+ * the object, including fields attached by other extensions.
+ */
+export declare function uidMut(options: UidMutOptions): (tx: Transaction) => import("@mysten/sui/transactions").TransactionResult;
+//# sourceMappingURL=recording.d.ts.map

package/dist/contracts/musicos/recording.d.ts.map

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

package/dist/contracts/musicos/recording.js

@@ -0,0 +1,232 @@
+/**************************************************************
+ * THIS FILE IS GENERATED AND SHOULD NOT BE MANUALLY MODIFIED *
+ **************************************************************/
+/**
+ * Represents an audio recording of a composition in musicos. Recordings are the
+ * audio performances that are distributed and played. Each recording has its own
+ * share token for ownership distribution.
+ *
+ * ### Key Features:
+ *
+ * - Share token initialization with fixed supply (10M tokens, 6 decimals)
+ * - State machine: Initialized -> Published (embedded fields immutable after
+ *   publish; dynamic fields remain extensible via `uid_mut`, e.g. masters, and
+ *   credits/attribution attached by the credits extension)
+ * - Deterministic addresses via derived object pattern
+ *
+ * Attribution (credits, primary/featured artists) is intentionally NOT part of
+ * core: it is display-oriented, varies across platforms, and is never read by the
+ * economics. It lives in a first-party credits extension attached via `uid_mut`,
+ * so core takes no dependency on an identity package and core publish enforces no
+ * attribution.
+ *
+ * A recording carries no name of its own. Its display title is its composition's
+ * title, read by reference — composition titles are immutable, so an embedded copy
+ * would carry no information. Anything that names this particular take — "(Live)",
+ * "Radio Edit", a translated title — has more than one correct rendering, which
+ * makes it presentation, and presentation lives in the metadata extension, never
+ * in the frozen core. Core stores what a recording _is_; extensions describe it.
+ *
+ * ### Lifecycle and trust model
+ *
+ * A recording is `key`-only with no `drop`: a fresh `Initialized` object cannot be
+ * transferred, wrapped, publicly shared, or discarded, and its only by-value
+ * consumer is `publish`. Create-and-publish is therefore atomic by construction —
+ * an `Initialized` recording cannot outlive its creating transaction, and every
+ * recording that exists on-chain is `Published` and shared. There is deliberately
+ * no keep function; staged building must fit one transaction.
+ *
+ * `uid_mut` works in any lifecycle state and is permanent root over ALL dynamic
+ * fields on the object — including fields attached by other extensions. "Immutable
+ * after publish" covers the embedded fields only; extension-layer data stays
+ * admin-mutable in perpetuity. This is the designed extension surface, and it is
+ * the one trust assumption that never expires: integrators should model the cap
+ * holder as able to mutate or delete any extension data, forever.
+ *
+ * The recording carries its parent composition's identity two ways. The
+ * `CompositionShare` phantom type parameter is the durable identity (a share
+ * currency is published independently of musicos and survives a fresh republish,
+ * whereas an object ID does not) and makes the recording↔composition lineage
+ * compile-time enforced wherever the two meet. The embedded `composition_id` is
+ * the address-level handle: Move cannot chase a type (or an ID) to an object, so
+ * on-chain consumers holding only `&Recording` — or a bare `Track` — could not
+ * otherwise reach the composition at all. Both are set at creation and immutable,
+ * so they cannot diverge.
+ *
+ * A recording is its own freshly-created object (`object::new`), not a derived
+ * child of its composition: `recording::new` takes a read-only `&Composition`
+ * (only to read its royalty rate and id), so publishing recordings under a
+ * composition neither contends on the composition's shared-object version nor
+ * collides on a per-composition index.
+ */
+import { MoveEnum, MoveStruct, MoveTuple, normalizeMoveArguments } from '../utils/index.js';
+import { bcs } from '@mysten/sui/bcs';
+import {} from '@mysten/sui/transactions';
+const $moduleName = '@local-pkg/musicos::recording';
+/** Lifecycle state of a recording. */
+export const RecordingState = new MoveEnum({ name: `${$moduleName}::RecordingState`, fields: {
+        /** Recording is being set up and can be modified. */
+        Initialized: null,
+        /** Recording is published and immutable. Includes publication timestamp. */
+        Published: bcs.u64()
+    } });
+export const Recording = new MoveStruct({ name: `${$moduleName}::Recording<phantom RecordingShare, phantom CompositionShare>`, fields: {
+        /** Unique identifier for this recording. */
+        id: bcs.Address,
+        /** Current lifecycle state. */
+        state: RecordingState,
+        /**
+         * Object ID of the parent composition. The address-level counterpart of the
+         * `CompositionShare` phantom, set from the `&Composition` passed to `new` (the
+         * shared phantom proves the pairing). An identity handle — not a revenue routing
+         * target: the composition is paid through its recording-share ownership, settled
+         * at creation.
+         */
+        composition_id: bcs.Address
+    } });
+export const RecordingAdminCap = new MoveStruct({ name: `${$moduleName}::RecordingAdminCap<phantom RecordingShare>`, fields: {
+        /** Unique identifier for this capability. */
+        id: bcs.Address
+    } });
+export const RecordingAdminCapKey = new MoveTuple({ name: `${$moduleName}::RecordingAdminCapKey`, fields: [bcs.bool()] });
+export const RecordingPublishedEvent = new MoveStruct({ name: `${$moduleName}::RecordingPublishedEvent<phantom RecordingShare, phantom CompositionShare>`, fields: {
+        recording_id: bcs.Address
+    } });
+export const CompositionSharesGrantedEvent = new MoveStruct({ name: `${$moduleName}::CompositionSharesGrantedEvent<phantom RecordingShare, phantom CompositionShare>`, fields: {
+        recording_id: bcs.Address,
+        composition_id: bcs.Address,
+        /** Recording-share base units granted to the composition. */
+        value: bcs.u64(),
+        /** The composition royalty rate applied at creation, in basis points. */
+        rate_bps: bcs.u16(),
+        granted_by: bcs.Address
+    } });
+/**
+ * Creates a new recording for a composition.
+ *
+ * Initializes share tokens (10M supply, 6 decimals), then splits the composition's
+ * royalty-rate worth of those shares off the freshly minted supply and
+ * `send_funds`es them to the composition's address. This settles the composition's
+ * cut as cap-table ownership: the composition literally owns its share of the
+ * recording, so its claim on recording revenue is enforced by share ownership
+ * rather than by any revenue distributor choosing to honor a rate. What the
+ * composition owner then does with the shares (hold, stake, sell) is outside the
+ * protocol's scope.
+ *
+ * The composition's royalty rate is immutable, so the rate a recorder's client
+ * displayed is exactly the rate applied here — no slippage protection is needed or
+ * possible. Whether that rate is acceptable is the recorder's decision to make
+ * before calling; per-deal deviations settle as voluntary share transfers after
+ * creation.
+ *
+ * The composition need not be `Published`: within the composition's own creating
+ * transaction its creator can already mint recordings against it. Third parties
+ * only ever see `Published`, shared compositions (an `Initialized` one cannot
+ * escape its creating transaction), so indexers may observe a recording created
+ * "against an unpublished composition" only as an intra-transaction ordering,
+ * never across transactions.
+ *
+ * Returns:
+ *
+ * - The recording object (typed to its parent composition's `CompositionShare`)
+ * - Admin capability for the owner
+ * - The creator's remaining share balance (full supply minus the composition's
+ *   cut)
+ */
+export function _new(options) {
+    const packageAddress = options.package ?? '@local-pkg/musicos';
+    const argumentsTypes = [
+        null,
+        null,
+        null
+    ];
+    const parameterNames = ["composition", "shareCurrency", "shareTreasuryCap"];
+    return (tx) => tx.moveCall({
+        package: packageAddress,
+        module: 'recording',
+        function: 'new',
+        arguments: normalizeMoveArguments(options.arguments, argumentsTypes, parameterNames),
+        typeArguments: options.typeArguments
+    });
+}
+/**
+ * Publishes the recording, making its embedded fields immutable. Required State:
+ * Initialized
+ *
+ * Note: core enforces no attribution requirement — credits live in the credits
+ * extension and may be attached before or after publish via `uid_mut`.
+ */
+export function publish(options) {
+    const packageAddress = options.package ?? '@local-pkg/musicos';
+    const argumentsTypes = [
+        null,
+        null,
+        '0x2::clock::Clock'
+    ];
+    const parameterNames = ["self", "_"];
+    return (tx) => tx.moveCall({
+        package: packageAddress,
+        module: 'recording',
+        function: 'publish',
+        arguments: normalizeMoveArguments(options.arguments, argumentsTypes, parameterNames),
+        typeArguments: options.typeArguments
+    });
+}
+/**
+ * Returns the object ID of the parent composition. An identity/membership handle
+ * (the address-level counterpart of the `CompositionShare` phantom) — not a
+ * revenue routing target: the composition is paid via its recording-share
+ * ownership.
+ */
+export function compositionId(options) {
+    const packageAddress = options.package ?? '@local-pkg/musicos';
+    const argumentsTypes = [
+        null
+    ];
+    const parameterNames = ["self"];
+    return (tx) => tx.moveCall({
+        package: packageAddress,
+        module: 'recording',
+        function: 'composition_id',
+        arguments: normalizeMoveArguments(options.arguments, argumentsTypes, parameterNames),
+        typeArguments: options.typeArguments
+    });
+}
+/** Returns a reference to the recording's UID for reading dynamic fields. */
+export function uid(options) {
+    const packageAddress = options.package ?? '@local-pkg/musicos';
+    const argumentsTypes = [
+        null
+    ];
+    const parameterNames = ["self"];
+    return (tx) => tx.moveCall({
+        package: packageAddress,
+        module: 'recording',
+        function: 'uid',
+        arguments: normalizeMoveArguments(options.arguments, argumentsTypes, parameterNames),
+        typeArguments: options.typeArguments
+    });
+}
+/**
+ * Returns a mutable reference to the recording's UID. Requires the admin
+ * capability. Works in any lifecycle state — dynamic fields are the extension
+ * surface (e.g. masters, credits) and stay admin-mutable after publish; only the
+ * embedded fields are frozen. The reference is root over every dynamic field on
+ * the object, including fields attached by other extensions.
+ */
+export function uidMut(options) {
+    const packageAddress = options.package ?? '@local-pkg/musicos';
+    const argumentsTypes = [
+        null,
+        null
+    ];
+    const parameterNames = ["self", "_"];
+    return (tx) => tx.moveCall({
+        package: packageAddress,
+        module: 'recording',
+        function: 'uid_mut',
+        arguments: normalizeMoveArguments(options.arguments, argumentsTypes, parameterNames),
+        typeArguments: options.typeArguments
+    });
+}
+//# sourceMappingURL=recording.js.map

package/dist/contracts/musicos/recording.js.map

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