@misonetwork/sdk 0.1.0

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

@@ -0,0 +1,21 @@
+/**************************************************************
+ * 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`); overflow safety on `u8`–`u128` is delegated to
+ * `std::uX::mul_div` / `mul_div_ceil`, which widen to the next-larger type
+ * internally. `u256` has no wider type, so the multiplication is performed
+ * directly and only overflows for amounts exceeding `u256::MAX / 10_000`
+ * (~1.16e73).
+ */
+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/miso/deps/bps/bps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bps.js","sourceRoot":"","sources":["../../../../../src/contracts/miso/deps/bps/bps.ts"],"names":[],"mappings":"AAAA;;gEAEgE;AAGhE;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AACtC,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/miso/recording.d.ts

@@ -0,0 +1,228 @@
+/**************************************************************
+ * THIS FILE IS GENERATED AND SHOULD NOT BE MANUALLY MODIFIED *
+ **************************************************************/
+/**
+ * Represents an audio recording of a composition in Miso. 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 as the
+ * `CompositionShare` phantom type parameter — the composition's share type is its
+ * durable identity (a share currency is published independently of miso and
+ * survives a fresh republish, whereas an object ID does not). This makes the
+ * recording↔composition lineage compile-time enforced wherever the two meet, and
+ * it is the sole link: the composition's object id is not stored on the recording.
+ * Off-chain consumers that need the composition object resolve its share type to
+ * an id via `composition::CompositionPublishedEvent`, which binds the two.
+ *
+ * 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.js';
+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/sui/bcs").BcsType<string, string | number | bigint, "u64">;
+}, "@local-pkg/miso::recording::RecordingState">;
+export declare const Recording: MoveStruct<{
+    /** Unique identifier for this recording. */
+    id: import("@mysten/sui/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/sui/bcs").BcsType<string, string | number | bigint, "u64">;
+    }, "@local-pkg/miso::recording::RecordingState">;
+}, "@local-pkg/miso::recording::Recording<phantom RecordingShare, phantom CompositionShare>">;
+export declare const RecordingAdminCap: MoveStruct<{
+    /** Unique identifier for this capability. */
+    id: import("@mysten/sui/bcs").BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
+}, "@local-pkg/miso::recording::RecordingAdminCap<phantom RecordingShare>">;
+export declare const RecordingAdminCapKey: MoveTuple<readonly [import("@mysten/sui/bcs").BcsType<boolean, boolean, "bool">], "@local-pkg/miso::recording::RecordingAdminCapKey">;
+export declare const RecordingPublishedEvent: MoveStruct<{
+    recording_id: import("@mysten/sui/bcs").BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
+}, "@local-pkg/miso::recording::RecordingPublishedEvent<phantom RecordingShare, phantom CompositionShare>">;
+export declare const CompositionSharesGrantedEvent: MoveStruct<{
+    recording_id: import("@mysten/sui/bcs").BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
+    composition_id: import("@mysten/sui/bcs").BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
+    /** Recording-share base units granted to the composition. */
+    value: import("@mysten/sui/bcs").BcsType<string, string | number | bigint, "u64">;
+    /** The composition royalty rate applied at creation, in basis points. */
+    rate_bps: import("@mysten/sui/bcs").BcsType<number, number, "u16">;
+    granted_by: import("@mysten/sui/bcs").BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
+}, "@local-pkg/miso::recording::CompositionSharesGrantedEvent<phantom RecordingShare, phantom CompositionShare>">;
+export interface NewArguments {
+    composition: RawTransactionArgument<string>;
+    shareCurrency: RawTransactionArgument<string>;
+    shareTreasuryCap: RawTransactionArgument<string>;
+    maxRoyaltyRateBps: RawTransactionArgument<number>;
+}
+export interface NewOptions {
+    package?: string;
+    arguments: NewArguments | [
+        composition: RawTransactionArgument<string>,
+        shareCurrency: RawTransactionArgument<string>,
+        shareTreasuryCap: RawTransactionArgument<string>,
+        maxRoyaltyRateBps: RawTransactionArgument<number>
+    ];
+    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.
+ *
+ * `max_royalty_rate_bps` is a slippage guard: `new` reads the composition's
+ * royalty rate live off a shared object, so a composition owner could land a rate
+ * increase in a transaction ordered just before this one and capture more of the
+ * recording's shares than the recorder saw. The call aborts if the composition's
+ * current rate exceeds `max_royalty_rate_bps`, so the recorder pins the most they
+ * will grant (pass the rate they observed, or `2000` to accept up to the protocol
+ * maximum).
+ *
+ * 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 IdArguments {
+    self: RawTransactionArgument<string>;
+}
+export interface IdOptions {
+    package?: string;
+    arguments: IdArguments | [
+        self: RawTransactionArgument<string>
+    ];
+    typeArguments: [
+        string,
+        string
+    ];
+}
+/** Returns the recording's object ID. */
+export declare function id(options: IdOptions): (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/miso/recording.d.ts.map

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

package/dist/contracts/miso/recording.js

@@ -0,0 +1,221 @@
+/**************************************************************
+ * THIS FILE IS GENERATED AND SHOULD NOT BE MANUALLY MODIFIED *
+ **************************************************************/
+/**
+ * Represents an audio recording of a composition in Miso. 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 as the
+ * `CompositionShare` phantom type parameter — the composition's share type is its
+ * durable identity (a share currency is published independently of miso and
+ * survives a fresh republish, whereas an object ID does not). This makes the
+ * recording↔composition lineage compile-time enforced wherever the two meet, and
+ * it is the sole link: the composition's object id is not stored on the recording.
+ * Off-chain consumers that need the composition object resolve its share type to
+ * an id via `composition::CompositionPublishedEvent`, which binds the two.
+ *
+ * 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/miso::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
+    } });
+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.
+ *
+ * `max_royalty_rate_bps` is a slippage guard: `new` reads the composition's
+ * royalty rate live off a shared object, so a composition owner could land a rate
+ * increase in a transaction ordered just before this one and capture more of the
+ * recording's shares than the recorder saw. The call aborts if the composition's
+ * current rate exceeds `max_royalty_rate_bps`, so the recorder pins the most they
+ * will grant (pass the rate they observed, or `2000` to accept up to the protocol
+ * maximum).
+ *
+ * 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/miso';
+    const argumentsTypes = [
+        null,
+        null,
+        null,
+        'u16'
+    ];
+    const parameterNames = ["composition", "shareCurrency", "shareTreasuryCap", "maxRoyaltyRateBps"];
+    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/miso';
+    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 recording's object ID. */
+export function id(options) {
+    const packageAddress = options.package ?? '@local-pkg/miso';
+    const argumentsTypes = [
+        null
+    ];
+    const parameterNames = ["self"];
+    return (tx) => tx.moveCall({
+        package: packageAddress,
+        module: 'recording',
+        function: '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/miso';
+    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/miso';
+    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/miso/recording.js.map

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