@misofm/sdk 0.9.0 → 0.11.0

package/dist/contracts/recording_royalty_pool/recording_royalty_pool.js

@@ -2,31 +2,62 @@
  * THIS FILE IS GENERATED AND SHOULD NOT BE MANUALLY MODIFIED *
  **************************************************************/
 /**
- * Cap-gated royalty-pool extension for `Recording`.
+ * Vault-authorized royalty-pool business logic for Miso Recordings.
  *
- * Royalty payers send `Coin<Currency>` directly to the recording's address — a
- * stable, well-known inbox available from the recording's creation. The recording
- * admin (cap holder) folds those funds into the underlying
- * `royalty_pool::pool::RoyaltyPool` via `receive_and_deposit` (for direct coin
- * transfers) or `redeem_and_deposit` (for funds-accumulator balances).
- *
- * All three entry points require `&RecordingAdminCap`, so timing of fold
- * operations stays under admin control.
+ * The plugin temporarily leases the RecordingAdminCap from its Vault, uses it only
+ * to reach the matching Recording UID, and returns it before calling external pool
+ * logic. Pools remain derived from the Recording, not the Vault, so their
+ * canonical identity survives vault replacement.
  */
 import {} from '@mysten/sui/transactions';
 import { normalizeMoveArguments } from '../utils/index.js';
+/** Authorize this package on a Recording capability Vault. */
+export function install(options) {
+    const packageAddress = options.package ?? '@local-pkg/recording_royalty_pool';
+    const argumentsTypes = [
+        null,
+        null
+    ];
+    const parameterNames = ["vault", "vaultAdminCap"];
+    return (tx) => tx.moveCall({
+        package: packageAddress,
+        module: 'recording_royalty_pool',
+        function: 'install',
+        arguments: normalizeMoveArguments(options.arguments, argumentsTypes, parameterNames),
+        typeArguments: options.typeArguments
+    });
+}
+/** Revoke this package from a Recording capability Vault. */
+export function uninstall(options) {
+    const packageAddress = options.package ?? '@local-pkg/recording_royalty_pool';
+    const argumentsTypes = [
+        null,
+        null
+    ];
+    const parameterNames = ["vault", "vaultAdminCap"];
+    return (tx) => tx.moveCall({
+        package: packageAddress,
+        module: 'recording_royalty_pool',
+        function: 'uninstall',
+        arguments: normalizeMoveArguments(options.arguments, argumentsTypes, parameterNames),
+        typeArguments: options.typeArguments
+    });
+}
 /**
- * Create a royalty pool for a recording. Pool address derives from
- * `(recording_id, Currency)` — calling twice with the same Currency aborts because
- * the address is already claimed.
+ * Create and share the canonical pool derived from this Recording.
+ *
+ * The matching VaultAdminCap chooses which Currency pools may be created. The
+ * result cannot be redirected: the pool ID is claimed from the Recording UID and
+ * is typed by both RecordingShare and Currency.
  */
 export function initializePool(options) {
     const packageAddress = options.package ?? '@local-pkg/recording_royalty_pool';
     const argumentsTypes = [
+        null,
         null,
         null
     ];
-    const parameterNames = ["recording", "cap"];
+    const parameterNames = ["vault", "recording", "vaultAdminCap"];
     return (tx) => tx.moveCall({
         package: packageAddress,
         module: 'recording_royalty_pool',
@@ -36,18 +67,19 @@ export function initializePool(options) {
     });
 }
 /**
- * Receive `Coin<Currency>` objects sent to the recording's address and fold them
- * into the pool's accumulator.
+ * Receive coins sent to the Recording and deposit them into its canonical pool.
+ * Anyone may crank this after the plugin is installed, but the funds can only
+ * reach the pool derived from this Recording.
  */
 export function receiveAndDeposit(options) {
     const packageAddress = options.package ?? '@local-pkg/recording_royalty_pool';
     const argumentsTypes = [
         null,
         null,
-        'vector<null>',
-        null
+        null,
+        'vector<null>'
     ];
-    const parameterNames = ["recording", "cap", "coins", "pool"];
+    const parameterNames = ["vault", "recording", "pool", "coins"];
     return (tx) => tx.moveCall({
         package: packageAddress,
         module: 'recording_royalty_pool',
@@ -57,18 +89,18 @@ export function receiveAndDeposit(options) {
     });
 }
 /**
- * Redeem `value` base units from the recording's funds accumulator and fold the
- * resulting balance into the pool's accumulator.
+ * Redeem funds accumulated at the Recording address and deposit them into its
+ * canonical pool. Anyone may crank this after installation.
  */
 export function redeemAndDeposit(options) {
     const packageAddress = options.package ?? '@local-pkg/recording_royalty_pool';
     const argumentsTypes = [
         null,
         null,
-        'u64',
-        null
+        null,
+        'u64'
     ];
-    const parameterNames = ["recording", "cap", "value", "pool"];
+    const parameterNames = ["vault", "recording", "pool", "value"];
     return (tx) => tx.moveCall({
         package: packageAddress,
         module: 'recording_royalty_pool',
@@ -77,4 +109,33 @@ export function redeemAndDeposit(options) {
         typeArguments: options.typeArguments
     });
 }
+export function isInstalled(options) {
+    const packageAddress = options.package ?? '@local-pkg/recording_royalty_pool';
+    const argumentsTypes = [
+        null
+    ];
+    const parameterNames = ["vault"];
+    return (tx) => tx.moveCall({
+        package: packageAddress,
+        module: 'recording_royalty_pool',
+        function: 'is_installed',
+        arguments: normalizeMoveArguments(options.arguments, argumentsTypes, parameterNames),
+        typeArguments: options.typeArguments
+    });
+}
+/** The canonical pool address for this Recording, share type, and Currency. */
+export function poolAddress(options) {
+    const packageAddress = options.package ?? '@local-pkg/recording_royalty_pool';
+    const argumentsTypes = [
+        null
+    ];
+    const parameterNames = ["recording"];
+    return (tx) => tx.moveCall({
+        package: packageAddress,
+        module: 'recording_royalty_pool',
+        function: 'pool_address',
+        arguments: normalizeMoveArguments(options.arguments, argumentsTypes, parameterNames),
+        typeArguments: options.typeArguments
+    });
+}
 //# sourceMappingURL=recording_royalty_pool.js.map

package/dist/contracts/recording_royalty_pool/recording_royalty_pool.js.map

@@ -1 +1 @@
-{"version":3,"file":"recording_royalty_pool.js","sourceRoot":"","sources":["../../../src/contracts/recording_royalty_pool/recording_royalty_pool.ts"],"names":[],"mappings":"AAAA;;gEAEgE;AAGhE;;;;;;;;;;;GAWG;AAEH,OAAO,EAA8C,MAAM,0BAA0B,CAAC;AACtF,OAAO,EAAE,sBAAsB,EAA+B,MAAM,mBAAmB,CAAC;AAiBxF;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,OAA8B;IACzD,MAAM,cAAc,GAAG,OAAO,CAAC,OAAO,IAAI,mCAAmC,CAAC;IAC9E,MAAM,cAAc,GAAG;QACnB,IAAI;QACJ,IAAI;KACqB,CAAC;IAC9B,MAAM,cAAc,GAAG,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IAC5C,OAAO,CAAC,EAAe,EAAE,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC;QACpC,OAAO,EAAE,cAAc;QACvB,MAAM,EAAE,wBAAwB;QAChC,QAAQ,EAAE,iBAAiB;QAC3B,SAAS,EAAE,sBAAsB,CAAC,OAAO,CAAC,SAAS,EAAE,cAAc,EAAE,cAAc,CAAC;QACpF,aAAa,EAAE,OAAO,CAAC,aAAa;KACvC,CAAC,CAAC;AACP,CAAC;AAqBD;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAiC;IAC/D,MAAM,cAAc,GAAG,OAAO,CAAC,OAAO,IAAI,mCAAmC,CAAC;IAC9E,MAAM,cAAc,GAAG;QACnB,IAAI;QACJ,IAAI;QACJ,cAAc;QACd,IAAI;KACqB,CAAC;IAC9B,MAAM,cAAc,GAAG,CAAC,WAAW,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAC7D,OAAO,CAAC,EAAe,EAAE,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC;QACpC,OAAO,EAAE,cAAc;QACvB,MAAM,EAAE,wBAAwB;QAChC,QAAQ,EAAE,qBAAqB;QAC/B,SAAS,EAAE,sBAAsB,CAAC,OAAO,CAAC,SAAS,EAAE,cAAc,EAAE,cAAc,CAAC;QACpF,aAAa,EAAE,OAAO,CAAC,aAAa;KACvC,CAAC,CAAC;AACP,CAAC;AAqBD;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAgC;IAC7D,MAAM,cAAc,GAAG,OAAO,CAAC,OAAO,IAAI,mCAAmC,CAAC;IAC9E,MAAM,cAAc,GAAG;QACnB,IAAI;QACJ,IAAI;QACJ,KAAK;QACL,IAAI;KACqB,CAAC;IAC9B,MAAM,cAAc,GAAG,CAAC,WAAW,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAC7D,OAAO,CAAC,EAAe,EAAE,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC;QACpC,OAAO,EAAE,cAAc;QACvB,MAAM,EAAE,wBAAwB;QAChC,QAAQ,EAAE,oBAAoB;QAC9B,SAAS,EAAE,sBAAsB,CAAC,OAAO,CAAC,SAAS,EAAE,cAAc,EAAE,cAAc,CAAC;QACpF,aAAa,EAAE,OAAO,CAAC,aAAa;KACvC,CAAC,CAAC;AACP,CAAC"}
+{"version":3,"file":"recording_royalty_pool.js","sourceRoot":"","sources":["../../../src/contracts/recording_royalty_pool/recording_royalty_pool.ts"],"names":[],"mappings":"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"}

package/dist/contracts/recording_royalty_pool/witness.d.ts

@@ -0,0 +1,6 @@
+/**************************************************************
+ * THIS FILE IS GENERATED AND SHOULD NOT BE MANUALLY MODIFIED *
+ **************************************************************/
+import { MoveTuple } from '../utils/index.js';
+export declare const Witness: MoveTuple<readonly [import("@mysten/sui/bcs").BcsType<boolean, boolean, "bool">], "@local-pkg/recording_royalty_pool::witness::Witness">;
+//# sourceMappingURL=witness.d.ts.map

package/dist/contracts/recording_royalty_pool/witness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"witness.d.ts","sourceRoot":"","sources":["../../../src/contracts/recording_royalty_pool/witness.ts"],"names":[],"mappings":"AAAA;;gEAEgE;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAG9C,eAAO,MAAM,OAAO,0IAA2E,CAAC"}

package/dist/contracts/recording_royalty_pool/witness.js

@@ -0,0 +1,8 @@
+/**************************************************************
+ * THIS FILE IS GENERATED AND SHOULD NOT BE MANUALLY MODIFIED *
+ **************************************************************/
+import { MoveTuple } from '../utils/index.js';
+import { bcs } from '@mysten/sui/bcs';
+const $moduleName = '@local-pkg/recording_royalty_pool::witness';
+export const Witness = new MoveTuple({ name: `${$moduleName}::Witness`, fields: [bcs.bool()] });
+//# sourceMappingURL=witness.js.map

package/dist/contracts/recording_royalty_pool/witness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"witness.js","sourceRoot":"","sources":["../../../src/contracts/recording_royalty_pool/witness.ts"],"names":[],"mappings":"AAAA;;gEAEgE;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AACtC,MAAM,WAAW,GAAG,4CAA4C,CAAC;AACjE,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,SAAS,CAAC,EAAE,IAAI,EAAE,GAAG,WAAW,WAAW,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC"}

package/dist/contracts/release_description/release_description.d.ts

@@ -0,0 +1,112 @@
+/**************************************************************
+ * THIS FILE IS GENERATED AND SHOULD NOT BE MANUALLY MODIFIED *
+ **************************************************************/
+/**
+ * What a release says about itself — the paragraph that runs under the title,
+ * written by whoever holds the release's admin cap, and believed.
+ *
+ * A free string, deliberately. Nothing on-chain reads it and nothing derives from
+ * it: this is editorial prose, not a fact the protocol can check. The facts a
+ * release carries that _are_ checkable — its tracklist, its splits, its state —
+ * live on the core object, and the claims two releases have to agree about to be
+ * comparable (genre, credits, languages) each get their own typed extension so
+ * they can be queried rather than read. What is left over is what a person wants
+ * to say, and the only useful thing to do with it is store it and attribute it to
+ * the cap holder.
+ *
+ * One slot, not a set. A release has one thing to say about itself; per-track
+ * notes and per-language translations are different concerns and would be
+ * different extensions. Folding either in here would turn a paragraph into a
+ * schema, and a schema is exactly what prose is not.
+ *
+ * The 8 KB ceiling is storage hygiene, not an editorial opinion — a backstop
+ * against pathological bloat in a shared object, deliberately set well above any
+ * description anyone is expected to write. It is the most generous free-text bound
+ * in the stack, and that is the intended asymmetry: this package publishes
+ * immutable, so a ceiling that turns out to be too low can never be raised, while
+ * one that is too high costs only the gas of the writer who fills it. A
+ * description is also edited rarely, so the cost of rewriting the field in full
+ * lands on almost nobody.
+ *
+ * Genuinely long-form writing — an essay, a full set of liner notes — still
+ * belongs where the artwork goes, in a Walrus blob referenced by an extension.
+ * Nothing here stops someone using the whole 8 KB; the bound is a limit, not a
+ * recommendation.
+ *
+ * Attaching nothing and attaching a description are distinct states: absence means
+ * nobody has written one, which is why an empty string is rejected rather than
+ * stored. There is no such thing as an empty description.
+ */
+import { MoveTuple, MoveStruct, type RawTransactionArgument } from '../utils/index.js';
+import { type Transaction } from '@mysten/sui/transactions';
+export declare const ExtensionKey: MoveTuple<readonly [import("@mysten/sui/bcs").BcsType<boolean, boolean, "bool">], "@local-pkg/release_description::release_description::ExtensionKey">;
+export declare const DescriptionSetEvent: MoveStruct<{
+    release_id: import("@mysten/sui/bcs").BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
+    description: import("@mysten/sui/bcs").BcsType<string, string, "string">;
+}, "@local-pkg/release_description::release_description::DescriptionSetEvent">;
+export declare const DescriptionClearedEvent: MoveStruct<{
+    release_id: import("@mysten/sui/bcs").BcsType<string, string | Uint8Array<ArrayBufferLike>, "bytes[32]">;
+}, "@local-pkg/release_description::release_description::DescriptionClearedEvent">;
+export interface SetDescriptionArguments {
+    self: RawTransactionArgument<string>;
+    cap: RawTransactionArgument<string>;
+    description: RawTransactionArgument<string>;
+}
+export interface SetDescriptionOptions {
+    package?: string;
+    arguments: SetDescriptionArguments | [
+        self: RawTransactionArgument<string>,
+        cap: RawTransactionArgument<string>,
+        description: RawTransactionArgument<string>
+    ];
+}
+/**
+ * Sets (or replaces) what the release says about itself.
+ *
+ * Stored exactly as given — whitespace, line breaks and case included. It is the
+ * release's own words, and normalising them here would be the protocol editing
+ * prose it has already declined to interpret.
+ */
+export declare function setDescription(options: SetDescriptionOptions): (tx: Transaction) => import("@mysten/sui/transactions").TransactionResult;
+export interface ClearDescriptionArguments {
+    self: RawTransactionArgument<string>;
+    cap: RawTransactionArgument<string>;
+}
+export interface ClearDescriptionOptions {
+    package?: string;
+    arguments: ClearDescriptionArguments | [
+        self: RawTransactionArgument<string>,
+        cap: RawTransactionArgument<string>
+    ];
+}
+/**
+ * Removes the description, if any. Idempotent. Leaves the release having said
+ * nothing about itself, which is where every release starts.
+ */
+export declare function clearDescription(options: ClearDescriptionOptions): (tx: Transaction) => import("@mysten/sui/transactions").TransactionResult;
+export interface HasDescriptionArguments {
+    self: RawTransactionArgument<string>;
+}
+export interface HasDescriptionOptions {
+    package?: string;
+    arguments: HasDescriptionArguments | [
+        self: RawTransactionArgument<string>
+    ];
+}
+/** Whether a description is attached to this release. */
+export declare function hasDescription(options: HasDescriptionOptions): (tx: Transaction) => import("@mysten/sui/transactions").TransactionResult;
+export interface DescriptionArguments {
+    self: RawTransactionArgument<string>;
+}
+export interface DescriptionOptions {
+    package?: string;
+    arguments: DescriptionArguments | [
+        self: RawTransactionArgument<string>
+    ];
+}
+/**
+ * What the release says about itself. Aborts if nothing is attached — absence is a
+ * distinct state and must not collapse into an empty string.
+ */
+export declare function description(options: DescriptionOptions): (tx: Transaction) => import("@mysten/sui/transactions").TransactionResult;
+//# sourceMappingURL=release_description.d.ts.map

package/dist/contracts/release_description/release_description.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"release_description.d.ts","sourceRoot":"","sources":["../../../src/contracts/release_description/release_description.ts"],"names":[],"mappings":"AAAA;;gEAEgE;AAGhE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,EAAE,SAAS,EAAE,UAAU,EAA0B,KAAK,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAE/G,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,eAAO,MAAM,YAAY,wJAAgF,CAAC;AAC1G,eAAO,MAAM,mBAAmB;;;8EAGxB,CAAC;AACT,eAAO,MAAM,uBAAuB;;kFAE5B,CAAC;AACT,MAAM,WAAW,uBAAuB;IACpC,IAAI,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;IACrC,GAAG,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;IACpC,WAAW,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;CAC/C;AACD,MAAM,WAAW,qBAAqB;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,uBAAuB,GAAG;QACjC,IAAI,EAAE,sBAAsB,CAAC,MAAM,CAAC;QACpC,GAAG,EAAE,sBAAsB,CAAC,MAAM,CAAC;QACnC,WAAW,EAAE,sBAAsB,CAAC,MAAM,CAAC;KAC9C,CAAC;CACL;AACD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,qBAAqB,IAQjD,IAAI,WAAW,0DAM1B;AACD,MAAM,WAAW,yBAAyB;IACtC,IAAI,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;IACrC,GAAG,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;CACvC;AACD,MAAM,WAAW,uBAAuB;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,yBAAyB,GAAG;QACnC,IAAI,EAAE,sBAAsB,CAAC,MAAM,CAAC;QACpC,GAAG,EAAE,sBAAsB,CAAC,MAAM,CAAC;KACtC,CAAC;CACL;AACD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,IAOrD,IAAI,WAAW,0DAM1B;AACD,MAAM,WAAW,uBAAuB;IACpC,IAAI,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;CACxC;AACD,MAAM,WAAW,qBAAqB;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,uBAAuB,GAAG;QACjC,IAAI,EAAE,sBAAsB,CAAC,MAAM,CAAC;KACvC,CAAC;CACL;AACD,yDAAyD;AACzD,wBAAgB,cAAc,CAAC,OAAO,EAAE,qBAAqB,IAMjD,IAAI,WAAW,0DAM1B;AACD,MAAM,WAAW,oBAAoB;IACjC,IAAI,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;CACxC;AACD,MAAM,WAAW,kBAAkB;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,oBAAoB,GAAG;QAC9B,IAAI,EAAE,sBAAsB,CAAC,MAAM,CAAC;KACvC,CAAC;CACL;AACD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,IAM3C,IAAI,WAAW,0DAM1B"}

package/dist/contracts/release_description/release_description.js

@@ -0,0 +1,123 @@
+/**************************************************************
+ * THIS FILE IS GENERATED AND SHOULD NOT BE MANUALLY MODIFIED *
+ **************************************************************/
+/**
+ * What a release says about itself — the paragraph that runs under the title,
+ * written by whoever holds the release's admin cap, and believed.
+ *
+ * A free string, deliberately. Nothing on-chain reads it and nothing derives from
+ * it: this is editorial prose, not a fact the protocol can check. The facts a
+ * release carries that _are_ checkable — its tracklist, its splits, its state —
+ * live on the core object, and the claims two releases have to agree about to be
+ * comparable (genre, credits, languages) each get their own typed extension so
+ * they can be queried rather than read. What is left over is what a person wants
+ * to say, and the only useful thing to do with it is store it and attribute it to
+ * the cap holder.
+ *
+ * One slot, not a set. A release has one thing to say about itself; per-track
+ * notes and per-language translations are different concerns and would be
+ * different extensions. Folding either in here would turn a paragraph into a
+ * schema, and a schema is exactly what prose is not.
+ *
+ * The 8 KB ceiling is storage hygiene, not an editorial opinion — a backstop
+ * against pathological bloat in a shared object, deliberately set well above any
+ * description anyone is expected to write. It is the most generous free-text bound
+ * in the stack, and that is the intended asymmetry: this package publishes
+ * immutable, so a ceiling that turns out to be too low can never be raised, while
+ * one that is too high costs only the gas of the writer who fills it. A
+ * description is also edited rarely, so the cost of rewriting the field in full
+ * lands on almost nobody.
+ *
+ * Genuinely long-form writing — an essay, a full set of liner notes — still
+ * belongs where the artwork goes, in a Walrus blob referenced by an extension.
+ * Nothing here stops someone using the whole 8 KB; the bound is a limit, not a
+ * recommendation.
+ *
+ * Attaching nothing and attaching a description are distinct states: absence means
+ * nobody has written one, which is why an empty string is rejected rather than
+ * stored. There is no such thing as an empty description.
+ */
+import { MoveTuple, MoveStruct, normalizeMoveArguments } from '../utils/index.js';
+import { bcs } from '@mysten/sui/bcs';
+import {} from '@mysten/sui/transactions';
+const $moduleName = '@local-pkg/release_description::release_description';
+export const ExtensionKey = new MoveTuple({ name: `${$moduleName}::ExtensionKey`, fields: [bcs.bool()] });
+export const DescriptionSetEvent = new MoveStruct({ name: `${$moduleName}::DescriptionSetEvent`, fields: {
+        release_id: bcs.Address,
+        description: bcs.string()
+    } });
+export const DescriptionClearedEvent = new MoveStruct({ name: `${$moduleName}::DescriptionClearedEvent`, fields: {
+        release_id: bcs.Address
+    } });
+/**
+ * Sets (or replaces) what the release says about itself.
+ *
+ * Stored exactly as given — whitespace, line breaks and case included. It is the
+ * release's own words, and normalising them here would be the protocol editing
+ * prose it has already declined to interpret.
+ */
+export function setDescription(options) {
+    const packageAddress = options.package ?? '@local-pkg/release_description';
+    const argumentsTypes = [
+        null,
+        null,
+        '0x1::string::String'
+    ];
+    const parameterNames = ["self", "cap", "description"];
+    return (tx) => tx.moveCall({
+        package: packageAddress,
+        module: 'release_description',
+        function: 'set_description',
+        arguments: normalizeMoveArguments(options.arguments, argumentsTypes, parameterNames),
+    });
+}
+/**
+ * Removes the description, if any. Idempotent. Leaves the release having said
+ * nothing about itself, which is where every release starts.
+ */
+export function clearDescription(options) {
+    const packageAddress = options.package ?? '@local-pkg/release_description';
+    const argumentsTypes = [
+        null,
+        null
+    ];
+    const parameterNames = ["self", "cap"];
+    return (tx) => tx.moveCall({
+        package: packageAddress,
+        module: 'release_description',
+        function: 'clear_description',
+        arguments: normalizeMoveArguments(options.arguments, argumentsTypes, parameterNames),
+    });
+}
+/** Whether a description is attached to this release. */
+export function hasDescription(options) {
+    const packageAddress = options.package ?? '@local-pkg/release_description';
+    const argumentsTypes = [
+        null
+    ];
+    const parameterNames = ["self"];
+    return (tx) => tx.moveCall({
+        package: packageAddress,
+        module: 'release_description',
+        function: 'has_description',
+        arguments: normalizeMoveArguments(options.arguments, argumentsTypes, parameterNames),
+    });
+}
+/**
+ * What the release says about itself. Aborts if nothing is attached — absence is a
+ * distinct state and must not collapse into an empty string.
+ */
+export function description(options) {
+    const packageAddress = options.package ?? '@local-pkg/release_description';
+    const argumentsTypes = [
+        null
+    ];
+    const parameterNames = ["self"];
+    return (tx) => tx.moveCall({
+        package: packageAddress,
+        module: 'release_description',
+        function: 'description',
+        arguments: normalizeMoveArguments(options.arguments, argumentsTypes, parameterNames),
+    });
+}
+//# sourceMappingURL=release_description.js.map

package/dist/contracts/release_description/release_description.js.map

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