@misofm/platform 0.0.0 → 0.18.0

package/dist/release-extensions.js

@@ -0,0 +1,190 @@
+// Copyright (c) Miso Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+import { bcs } from "@mysten/sui/bcs";
+import { deriveDynamicFieldID, deriveObjectID } from "@mysten/sui/utils";
+import * as genre from "@misofm/protocol/contracts/genre/genre";
+import * as releaseDescription from "@misofm/protocol/contracts/release_description/release_description";
+import * as releaseDspLink from "@misofm/protocol/contracts/release_dsp_link/release_dsp_link";
+import * as releaseGenre from "@misofm/protocol/contracts/release_genre/release_genre";
+import * as releaseKind from "@misofm/protocol/contracts/release_kind/release_kind";
+import { asU64, directAdminCap, invokeWithAdminCap } from "./vault.js";
+function object(tx, value) {
+    return typeof value === "string" ? tx.object(value) : value;
+}
+function authority(p) {
+    if (p.authority !== undefined)
+        return p.authority;
+    if (p.releaseAdminCapId !== undefined)
+        return directAdminCap(p.releaseAdminCapId);
+    throw new Error("release authority is required");
+}
+/** Attach the release's self-declared kind (for example "EP" or "Mixtape"). */
+export function setReleaseKind(p) {
+    const bytes = new TextEncoder().encode(p.kind).length;
+    if (bytes === 0)
+        throw new Error("setReleaseKind: kind must not be empty");
+    if (bytes > 32) {
+        throw new Error(`setReleaseKind: kind must be at most 32 UTF-8 bytes (got ${bytes})`);
+    }
+    return (tx) => {
+        invokeWithAdminCap(tx, authority(p), {
+            target: `${p.releaseKindPackageId}::release_kind::set_kind`,
+            arguments: [object(tx, p.releaseId), tx.pure.string(p.kind)],
+            adminCapIndex: 1,
+        });
+    };
+}
+const ReleaseKindField = bcs.struct("Field", {
+    id: bcs.Address,
+    name: releaseKind.ExtensionKey,
+    value: bcs.string(),
+});
+const RELEASE_KIND_KEY_BYTES = releaseKind.ExtensionKey.serialize([
+    false,
+]).toBytes();
+/** Deterministic dynamic-field id for a Release's optional self-declared kind. */
+export function releaseKindFieldId(releaseId, releaseKindPackageId) {
+    return deriveDynamicFieldID(releaseId, `${releaseKindPackageId}::release_kind::ExtensionKey`, RELEASE_KIND_KEY_BYTES);
+}
+/** Parse the dynamic field storing `Option<String>` as its present string. */
+export function parseReleaseKindContent(content) {
+    return ReleaseKindField.parse(content).value;
+}
+/** Read a Release's self-declared kind, or `null` when the extension is absent. */
+export async function getReleaseKind(client, releaseId, releaseKindPackageId) {
+    const { objects } = await client.core.getObjects({
+        objectIds: [releaseKindFieldId(releaseId, releaseKindPackageId)],
+        include: { content: true },
+    });
+    const object = objects[0];
+    if (!object || object instanceof Error || !object.content)
+        return null;
+    return parseReleaseKindContent(object.content);
+}
+/** Attach the release's editorial description. */
+export function setReleaseDescription(p) {
+    const bytes = new TextEncoder().encode(p.description).length;
+    if (bytes === 0) {
+        throw new Error("setReleaseDescription: description must not be empty");
+    }
+    if (bytes > 8192) {
+        throw new Error(`setReleaseDescription: description must be at most 8192 UTF-8 bytes (got ${bytes})`);
+    }
+    return (tx) => {
+        invokeWithAdminCap(tx, authority(p), {
+            target: `${p.releaseDescriptionPackageId}::release_description::set_description`,
+            arguments: [object(tx, p.releaseId), tx.pure.string(p.description)],
+            adminCapIndex: 1,
+        });
+    };
+}
+const GENRE_NAME_RE = /^[A-Z]+(?:_[A-Z]+)*$/;
+/** Validate the canonical on-chain genre vocabulary spelling. */
+export function assertCanonicalGenreName(name) {
+    const bytes = new TextEncoder().encode(name).length;
+    if (bytes === 0 || bytes > 64 || !GENRE_NAME_RE.test(name)) {
+        throw new Error(`Genre name must be 1-64 bytes of uppercase A-Z and underscores; got ${JSON.stringify(name)}`);
+    }
+}
+/** Derive the immutable Genre object address for a canonical vocabulary name.
+ * `genrePackageId` must be the genre package's defining (original publish)
+ * address — the on-chain derivation hashes type names with defining IDs. */
+export function deriveGenreAddress(genreRegistryId, genrePackageId, canonicalName) {
+    assertCanonicalGenreName(canonicalName);
+    return deriveObjectID(genreRegistryId, `${genrePackageId}::genre::GenreKey`, genre.GenreKey.serialize([canonicalName]).toBytes());
+}
+/** Attach primary/secondary release genres and optional per-track overrides. */
+export function setReleaseGenres(p) {
+    return (tx) => {
+        invokeWithAdminCap(tx, authority(p), {
+            target: `${p.releaseGenrePackageId}::release_genre::set_primary_genre`,
+            arguments: [object(tx, p.releaseId), tx.object(p.primaryGenreId)],
+            adminCapIndex: 1,
+        });
+        for (const genreId of p.secondaryGenreIds ?? []) {
+            invokeWithAdminCap(tx, authority(p), {
+                target: `${p.releaseGenrePackageId}::release_genre::add_secondary_genre`,
+                arguments: [object(tx, p.releaseId), tx.object(genreId)],
+                adminCapIndex: 1,
+            });
+        }
+        for (const assignment of p.trackPrimaryGenres ?? []) {
+            invokeWithAdminCap(tx, authority(p), {
+                target: `${p.releaseGenrePackageId}::release_genre::set_track_primary_genre`,
+                arguments: [
+                    object(tx, p.releaseId),
+                    tx.pure.u64(asU64("trackIndex", assignment.trackIndex)),
+                    tx.object(assignment.genreId),
+                ],
+                adminCapIndex: 1,
+            });
+        }
+    };
+}
+function buildDspLink(tx, packageId, link) {
+    switch (link.platform) {
+        case "Spotify":
+            return tx.add(releaseDspLink.newSpotify({ package: packageId, arguments: [link.id] }));
+        case "AppleMusic":
+            return tx.add(link.trackId === undefined
+                ? releaseDspLink.newAppleMusicAlbum({
+                    package: packageId,
+                    arguments: [link.storefront, link.albumId],
+                })
+                : releaseDspLink.newAppleMusicTrack({
+                    package: packageId,
+                    arguments: [link.storefront, link.albumId, link.trackId],
+                }));
+        case "AmazonMusic":
+            return tx.add(link.trackId === undefined
+                ? releaseDspLink.newAmazonMusicAlbum({
+                    package: packageId,
+                    arguments: [link.albumId],
+                })
+                : releaseDspLink.newAmazonMusicTrack({
+                    package: packageId,
+                    arguments: [link.albumId, link.trackId],
+                }));
+        case "Bandcamp":
+            return tx.add(releaseDspLink.newBandcamp({
+                package: packageId,
+                arguments: [link.subdomain, link.slug],
+            }));
+        case "Deezer":
+            return tx.add(releaseDspLink.newDeezer({ package: packageId, arguments: [link.id] }));
+        case "SoundCloud":
+            return tx.add(releaseDspLink.newSoundcloud({
+                package: packageId,
+                arguments: [link.user, link.slug],
+            }));
+        case "Tidal":
+            return tx.add(releaseDspLink.newTidal({ package: packageId, arguments: [link.id] }));
+        case "YouTubeMusic":
+            return tx.add(releaseDspLink.newYoutubeMusic({
+                package: packageId,
+                arguments: [link.id],
+            }));
+    }
+}
+/** Attach release-level and per-track DSP links. */
+export function setReleaseDspLinks(p) {
+    return (tx) => {
+        for (const link of p.releaseLinks ?? []) {
+            const value = buildDspLink(tx, p.releaseDspLinkPackageId, link);
+            invokeWithAdminCap(tx, authority(p), {
+                target: `${p.releaseDspLinkPackageId}::release_dsp_link::set_release_link`,
+                arguments: [object(tx, p.releaseId), value],
+                adminCapIndex: 1,
+            });
+        }
+        for (const item of p.trackLinks ?? []) {
+            const value = buildDspLink(tx, p.releaseDspLinkPackageId, item.link);
+            invokeWithAdminCap(tx, authority(p), {
+                target: `${p.releaseDspLinkPackageId}::release_dsp_link::set_track_link`,
+                arguments: [object(tx, p.releaseId), tx.pure.u64(asU64("trackIndex", item.trackIndex)), value],
+                adminCapIndex: 1,
+            });
+        }
+    };
+}
+//# sourceMappingURL=release-extensions.js.map

package/dist/release-extensions.js.map

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

package/dist/release-graph.d.ts

@@ -0,0 +1,65 @@
+import { Transaction } from "@mysten/sui/transactions";
+import { type AdminCustodyInput, type RecordingAuthorityInput, type ShareRecipient } from "./transactions.ts";
+interface CompositionNodeBase {
+    shareType: string;
+    shareCurrencyId: string;
+    shareTreasuryCapId: string;
+    title: string;
+    royaltyRateBps: number;
+    shareRecipients: ShareRecipient[];
+}
+export type CompositionNode = CompositionNodeBase & AdminCustodyInput;
+interface RecordingNodeBase {
+    shareType: string;
+    shareCurrencyId: string;
+    shareTreasuryCapId: string;
+    /** The parent composition's share type. */
+    compositionShareType: string;
+    shareRecipients: ShareRecipient[];
+}
+type RecordingParent = {
+    readonly parentCompositionIndex: number;
+    readonly parentCompositionId?: never;
+} | {
+    readonly parentCompositionIndex?: never;
+    readonly parentCompositionId: string;
+};
+export type RecordingNode = RecordingNodeBase & RecordingParent & AdminCustodyInput;
+/** A track whose recording is created in THIS PTB. */
+export interface FreshTrackNode {
+    /** Index into `recordings[]`. */
+    recordingIndex: number;
+    splitBps: number;
+}
+/**
+ * A track over an EXISTING recording, authorized by its admin cap held by the
+ * sender. This can coexist with recordings created in this PTB.
+ */
+interface CapTrackNodeBase {
+    recordingId: string;
+    recordingShareType: string;
+    compositionShareType: string;
+    splitBps: number;
+}
+export type CapTrackNode = CapTrackNodeBase & RecordingAuthorityInput;
+export type TrackNode = FreshTrackNode | CapTrackNode;
+interface ReleaseNodeBase {
+    title: string;
+    /** u256 nonce as a decimal string (deterministic release id). */
+    nonce: string;
+    releaseRegistryId: string;
+    /** The ordered tracklist. Display grouping (discs/sides) is extension data. */
+    tracks: TrackNode[];
+}
+export type ReleaseNode = ReleaseNodeBase & AdminCustodyInput;
+export interface PublishReleaseGraphParams {
+    compositions: CompositionNode[];
+    recordings: RecordingNode[];
+    release?: ReleaseNode;
+    misoPackageId: string;
+    minatoPackageId: string;
+}
+/** Builds the entire graph in a single transaction (see file header for ordering). */
+export declare function publishReleaseGraph(params: PublishReleaseGraphParams): (tx: Transaction) => void;
+export {};
+//# sourceMappingURL=release-graph.d.ts.map

package/dist/release-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-graph.d.ts","sourceRoot":"","sources":["../src/release-graph.ts"],"names":[],"mappings":"AA0BA,OAAO,EAAE,WAAW,EAAkC,MAAM,0BAA0B,CAAC;AAEvF,OAAO,EAA2F,KAAK,iBAAiB,EAAE,KAAK,uBAAuB,EAAE,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAKvM,UAAU,mBAAmB;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,cAAc,EAAE,CAAC;CACnC;AACD,MAAM,MAAM,eAAe,GAAG,mBAAmB,GAAG,iBAAiB,CAAC;AAEtE,UAAU,iBAAiB;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,2CAA2C;IAC3C,oBAAoB,EAAE,MAAM,CAAC;IAC7B,eAAe,EAAE,cAAc,EAAE,CAAC;CACnC;AACD,KAAK,eAAe,GAChB;IAAE,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,KAAK,CAAA;CAAE,GACjF;IAAE,QAAQ,CAAC,sBAAsB,CAAC,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAA;CAAE,CAAC;AACtF,MAAM,MAAM,aAAa,GAAG,iBAAiB,GAAG,eAAe,GAAG,iBAAiB,CAAC;AAEpF,sDAAsD;AACtD,MAAM,WAAW,cAAc;IAC7B,iCAAiC;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,UAAU,gBAAgB;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;CAClB;AACD,MAAM,MAAM,YAAY,GAAG,gBAAgB,GAAG,uBAAuB,CAAC;AAEtE,MAAM,MAAM,SAAS,GAAG,cAAc,GAAG,YAAY,CAAC;AAUtD,UAAU,eAAe;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB,EAAE,MAAM,CAAC;IAC1B,+EAA+E;IAC/E,MAAM,EAAE,SAAS,EAAE,CAAC;CACrB;AACD,MAAM,MAAM,WAAW,GAAG,eAAe,GAAG,iBAAiB,CAAC;AAE9D,MAAM,WAAW,yBAAyB;IACxC,YAAY,EAAE,eAAe,EAAE,CAAC;IAChC,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;CACzB;AAQD,sFAAsF;AACtF,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,yBAAyB,GAAG,CAAC,EAAE,EAAE,WAAW,KAAK,IAAI,CA4GhG"}

package/dist/release-graph.js

@@ -0,0 +1,136 @@
+// Copyright (c) Miso Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+// Single-PTB publisher for a whole release graph: creates every composition and
+// recording, derives the release id ON-CHAIN
+// (so recordings need not be shared first), builds the tracks/release,
+// then shares everything and transfers the admin caps — all in ONE transaction.
+//
+// Share currencies must already be published + initialized (their Currency objects
+// shared on-chain); their ids/types are passed in. Ordering is load-bearing:
+//   1. composition::new → recording::new(&comp)  (borrow-before-share)
+//   2. release::derive_target_release_id(<recording::id results>) →
+//      track::new(cap, &rec, derivedId, split) → release::new(registry, …)
+//   3. publish (share) comps + recs + release, disperse supply, transfer caps
+// Steps 1–2 borrow the works; step 3 consumes them into share_object.
+//
+// Release tracks come in two shapes (see TrackNode): recordings created in THIS
+// PTB, and existing recordings authorized by their admin cap.
+//
+// This is the whole-graph orchestration half of the opinionated publish flow —
+// it composes `@misofm/protocol`'s bare `composition`/`recording`/`track`/
+// `release` core call bindings with its
+// own `disperseShares`/`finalizeRelease` helpers into one PTB. Royalty pools are
+// installed later through an admin-cap Vault plugin; the retired raw-cap helper
+// is intentionally not used here.
+import { Transaction } from "@mysten/sui/transactions";
+import { contracts } from "@misofm/protocol";
+import { custodyOf, disperseShares, finalizeRelease, recordingAuthorityOf, requiredCommandResult } from "./transactions.js";
+import { disposeNewAdminCap, invokeWithAdminCap } from "./vault.js";
+const { composition, recording, track } = contracts;
+const isFresh = (t) => "recordingIndex" in t;
+function requiredAt(items, index, description) {
+    const item = items[index];
+    if (item === undefined)
+        throw new Error(`${description} index ${index} is out of range`);
+    return item;
+}
+/** Builds the entire graph in a single transaction (see file header for ordering). */
+export function publishReleaseGraph(params) {
+    const { misoPackageId: pkg, minatoPackageId } = params;
+    return (tx) => {
+        // ── 1) Create every composition, then every recording (borrow-before-share) ──
+        const comps = params.compositions.map((c) => {
+            const r = tx.add(composition._new({
+                package: pkg,
+                typeArguments: [c.shareType],
+                arguments: [tx.pure.string(c.title), tx.pure.u16(c.royaltyRateBps), tx.object(c.shareCurrencyId), tx.object(c.shareTreasuryCapId)],
+            }));
+            const parts = {
+                work: requiredCommandResult(r, 0, "composition::_new"),
+                adminCap: requiredCommandResult(r, 1, "composition::_new"),
+                balance: requiredCommandResult(r, 2, "composition::_new"),
+            };
+            return parts;
+        });
+        const recTypeArgs = (i) => {
+            const n = requiredAt(params.recordings, i, "recording");
+            return [n.shareType, n.compositionShareType];
+        };
+        const recs = params.recordings.map((rec, i) => {
+            const parent = rec.parentCompositionIndex !== undefined
+                ? requiredAt(comps, rec.parentCompositionIndex, "parent composition").work
+                : tx.object(rec.parentCompositionId);
+            const typeArgs = recTypeArgs(i);
+            const r = tx.add(recording._new({ package: pkg, typeArguments: typeArgs, arguments: [parent, tx.object(rec.shareCurrencyId), tx.object(rec.shareTreasuryCapId)] }));
+            const parts = {
+                work: requiredCommandResult(r, 0, "recording::_new"),
+                adminCap: requiredCommandResult(r, 1, "recording::_new"),
+                balance: requiredCommandResult(r, 2, "recording::_new"),
+            };
+            return parts;
+        });
+        // ── 2) Release: derive the id on-chain, then tracks → release ──────────
+        if (params.release) {
+            const rel = params.release;
+            const ordered = rel.tracks;
+            const idVec = tx.makeMoveVec({
+                type: "0x2::object::ID",
+                elements: ordered.map((t) => isFresh(t)
+                    ? tx.moveCall({
+                        target: "0x2::object::id",
+                        typeArguments: [
+                            `${pkg}::recording::Recording<${recTypeArgs(t.recordingIndex).join(",")}>`,
+                        ],
+                        arguments: [requiredAt(recs, t.recordingIndex, "fresh recording").work],
+                    })
+                    : tx.pure.id(t.recordingId)),
+            });
+            const splitVec = tx.makeMoveVec({ type: "u64", elements: ordered.map((t) => tx.pure.u64(t.splitBps)) });
+            // This returns an ID value (not an object); pass the result straight to
+            // `track::new` so every track consents to this exact release target.
+            const releaseId = tx.moveCall({
+                target: `${pkg}::release::derive_target_release_id`,
+                arguments: [tx.object(rel.releaseRegistryId), idVec, splitVec, tx.pure.u256(BigInt(rel.nonce))],
+            });
+            const trackArgs = ordered.map((t) => {
+                if (isFresh(t)) {
+                    const typeArgs = recTypeArgs(t.recordingIndex);
+                    const parts = requiredAt(recs, t.recordingIndex, "fresh recording");
+                    return tx.add(track._new({ package: pkg, typeArguments: typeArgs, arguments: [parts.adminCap, parts.work, releaseId, tx.pure.u16(t.splitBps)] }));
+                }
+                const typeArgs = [t.recordingShareType, t.compositionShareType];
+                const rec = tx.object(t.recordingId);
+                return invokeWithAdminCap(tx, recordingAuthorityOf(t), {
+                    target: `${pkg}::track::new`,
+                    typeArguments: typeArgs,
+                    arguments: [rec, releaseId, tx.pure.u16(t.splitBps)],
+                    adminCapIndex: 0,
+                });
+            });
+            const trackVec = tx.makeMoveVec({ type: `${pkg}::track::Track`, elements: trackArgs });
+            const created = tx.moveCall({
+                target: `${pkg}::release::new`,
+                arguments: [tx.object(rel.releaseRegistryId), tx.pure.string(rel.title), trackVec, tx.pure.u256(BigInt(rel.nonce))],
+            });
+            const releaseParts = {
+                release: requiredCommandResult(created, 0, "release::new"),
+                adminCap: requiredCommandResult(created, 1, "release::new"),
+            };
+            finalizeRelease(tx, { ...releaseParts, adminCustody: custodyOf(rel), misoPackageId: pkg });
+        }
+        // ── 3) Share every work, disperse its supply, transfer admin caps ──
+        params.compositions.forEach((c, i) => {
+            const parts = requiredAt(comps, i, "composition");
+            disperseShares(tx, minatoPackageId, c.shareType, parts.balance, c.shareRecipients);
+            tx.add(composition.publish({ package: pkg, typeArguments: [c.shareType], arguments: [parts.work, parts.adminCap] }));
+            disposeNewAdminCap(tx, parts.adminCap, custodyOf(c));
+        });
+        params.recordings.forEach((rec, i) => {
+            const parts = requiredAt(recs, i, "recording");
+            tx.add(recording.publish({ package: pkg, typeArguments: recTypeArgs(i), arguments: [parts.work, parts.adminCap] }));
+            disperseShares(tx, minatoPackageId, rec.shareType, parts.balance, rec.shareRecipients);
+            disposeNewAdminCap(tx, parts.adminCap, custodyOf(rec));
+        });
+    };
+}
+//# sourceMappingURL=release-graph.js.map

package/dist/release-graph.js.map

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

package/dist/share-template.d.ts

@@ -0,0 +1,3 @@
+import type { PackageBytecode } from "./transactions.ts";
+export declare const SHARE_TEMPLATE: PackageBytecode;
+//# sourceMappingURL=share-template.d.ts.map

package/dist/share-template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"share-template.d.ts","sourceRoot":"","sources":["../src/share-template.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,eAAO,MAAM,cAAc,EAAE,eA0C5B,CAAC"}

package/dist/share-template.js

@@ -0,0 +1,46 @@
+// Copyright (c) Miso Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+export const SHARE_TEMPLATE = {
+    "modules": [
+        "oRzrCwYAAAAKAQAOAg4gAy4gBE4EBVJHB5kB1QEI7gJgBs4DNwqFBAYMiwQ4ABEBEgIHAggCCQIPAhMAAggAAQMHAAMEDAEAAQQACAAEAQABAAEFBgQABgUCAAANAAEAARQFBgACCwUEAAQKCgIBAAQOCAkBCAYQAwQABAcDBwUIAQgBCAEHCAMHCAYBCwIBCAAAAQYIBgEFAQoCAQgBAQgABwcIAwIIAQgBCAEIAQcIBgILBAEJAAsCAQkAAgsEAQkABwgGDENvaW5SZWdpc3RyeRNDdXJyZW5jeUluaXRpYWxpemVyBVNoYXJlBlN0cmluZwtUcmVhc3VyeUNhcAlUeENvbnRleHQDVUlEB2FkZHJlc3MEY29pbg1jb2luX3JlZ2lzdHJ5IGZpbmFsaXplX2FuZF9kZWxldGVfbWV0YWRhdGFfY2FwCmZyb21fYnl0ZXMCaWQKaW5pdGlhbGl6ZQxuZXdfY3VycmVuY3kGb2JqZWN0BnNlbmRlcgVzaGFyZQZzdHJpbmcKdHhfY29udGV4dAR1dGY4AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACCgIhIAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAwgAAAAAAAAAAAoCBgVTSEFSRQACAQwIBQABAAABHAoELhEFBwARAiEECAUOCwQBCwMBBwEnCwMxBgcCEQELAAsBCwIKBDgADAULBDgBCwUCAA=="
+    ],
+    "dependencies": [
+        "0x0000000000000000000000000000000000000000000000000000000000000001",
+        "0x0000000000000000000000000000000000000000000000000000000000000002"
+    ],
+    "digest": [
+        191,
+        44,
+        36,
+        112,
+        72,
+        10,
+        163,
+        173,
+        88,
+        79,
+        123,
+        99,
+        33,
+        92,
+        255,
+        215,
+        122,
+        199,
+        22,
+        101,
+        247,
+        141,
+        222,
+        237,
+        187,
+        42,
+        28,
+        13,
+        201,
+        193,
+        173,
+        204
+    ]
+};
+//# sourceMappingURL=share-template.js.map

package/dist/share-template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"share-template.js","sourceRoot":"","sources":["../src/share-template.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,sCAAsC;AAWtC,MAAM,CAAC,MAAM,cAAc,GAAoB;IAC7C,SAAS,EAAE;QACT,s0BAAs0B;KACv0B;IACD,cAAc,EAAE;QACd,oEAAoE;QACpE,oEAAoE;KACrE;IACD,QAAQ,EAAE;QACR,GAAG;QACH,EAAE;QACF,EAAE;QACF,GAAG;QACH,EAAE;QACF,EAAE;QACF,GAAG;QACH,GAAG;QACH,EAAE;QACF,EAAE;QACF,GAAG;QACH,EAAE;QACF,EAAE;QACF,EAAE;QACF,GAAG;QACH,GAAG;QACH,GAAG;QACH,GAAG;QACH,EAAE;QACF,GAAG;QACH,GAAG;QACH,GAAG;QACH,GAAG;QACH,GAAG;QACH,GAAG;QACH,EAAE;QACF,EAAE;QACF,EAAE;QACF,GAAG;QACH,GAAG;QACH,GAAG;QACH,GAAG;KACJ;CACF,CAAC"}

package/dist/share.d.ts

@@ -0,0 +1,67 @@
+import type { ParallelTransactionExecutor } from "@mysten/sui/transactions";
+import type { ClientWithCoreApi } from "@mysten/sui/client";
+import type { Signer } from "@mysten/sui/cryptography";
+import { type PackageBytecode } from "./transactions.ts";
+export interface ShareCurrency {
+    /** The published share package id. */
+    packageId: string;
+    /** The `Currency<Share>` object id. */
+    currencyId: string;
+    /** The fully-qualified share type, `${packageId}::share::Share`. */
+    shareType: string;
+    /** The `TreasuryCap<Share>` object id (held by the treasury-cap recipient). */
+    treasuryCapId: string;
+    /** Net gas (MIST) attributed to this currency, if tracked per-item (else 0). */
+    gasUsed: number;
+}
+export interface ShareCurrencyMeta {
+    name: string;
+    description: string;
+    iconUrl?: string;
+}
+/**
+ * Patches the `INITIALIZER` constant in the share module bytecode, replacing the
+ * 32-byte zero-address placeholder with `initializerAddress`. The template is left
+ * untouched; a fresh patched copy is returned. `share::initialize` asserts the
+ * sender equals this address, so it must be the signer that will initialize.
+ */
+export declare function patchInitializer(template: PackageBytecode, initializerAddress: string): PackageBytecode;
+export interface CreateShareCurrencyParams {
+    /** The share bytecode template. Defaults to the embedded {@link SHARE_TEMPLATE}. */
+    template?: PackageBytecode;
+    name: string;
+    description: string;
+    iconUrl?: string;
+    /** Address baked in as INITIALIZER; must be the signer. Defaults to the signer. */
+    initializerAddress?: string;
+    /** Recipient of the minted `TreasuryCap`. Defaults to the signer. */
+    treasuryCapRecipient?: string;
+}
+/** Publishes an immutable package, then initializes a fresh share currency in a second tx. */
+export declare function createShareCurrency(client: ClientWithCoreApi, signer: Signer, params: CreateShareCurrencyParams): Promise<ShareCurrency>;
+/**
+ * Publishes `count` fresh, permanently immutable share-currency packages, batched
+ * at ≤5 publishes per PTB and run concurrently through the executor. Each publish
+ * consumes its UpgradeCap in the same PTB. Returns the published package ids
+ * (fungible — order is not meaningful; the caller assigns them to work slots).
+ */
+export declare function publishShareCurrencies(executor: ParallelTransactionExecutor, initializerAddress: string, count: number, template?: PackageBytecode): Promise<{
+    packageIds: string[];
+    gasUsed: number;
+}>;
+/**
+ * Initializes each published package into a `Currency<Share>` + `TreasuryCap`,
+ * batched and run concurrently. `metaOf` supplies each package's display metadata,
+ * so a currency destined for a specific work is named for it.
+ *
+ * `share::initialize` is NON-idempotent (`coin_registry` registers one `Currency`
+ * per type), so a batch must never be re-run. Batches run under `Promise.allSettled`
+ * and `onBatch` fires for each SUCCEEDED batch as it lands — letting the caller
+ * persist that batch immediately. If any batch fails, the succeeded ones are already
+ * reported and this throws, so a resume re-initializes only the still-missing packages.
+ */
+export declare function initializeShareCurrencies(executor: ParallelTransactionExecutor, signerAddress: string, packageIds: string[], metaOf: (packageId: string) => ShareCurrencyMeta, onBatch?: (currencies: ShareCurrency[], gasUsed: number) => void | Promise<void>): Promise<{
+    currencies: ShareCurrency[];
+    gasUsed: number;
+}>;
+//# sourceMappingURL=share.d.ts.map

package/dist/share.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"share.d.ts","sourceRoot":"","sources":["../src/share.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAC5E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAYvD,OAAO,EAAiD,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAexG,MAAM,WAAW,aAAa;IAC5B,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,SAAS,EAAE,MAAM,CAAC;IAClB,+EAA+E;IAC/E,aAAa,EAAE,MAAM,CAAC;IACtB,gFAAgF;IAChF,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAID;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,GAAG,eAAe,CAcvG;AAID,MAAM,WAAW,yBAAyB;IACxC,oFAAoF;IACpF,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mFAAmF;IACnF,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,qEAAqE;IACrE,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,8FAA8F;AAC9F,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,iBAAiB,EACzB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,yBAAyB,GAChC,OAAO,CAAC,aAAa,CAAC,CA8BxB;AAWD;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,2BAA2B,EACrC,kBAAkB,EAAE,MAAM,EAC1B,KAAK,EAAE,MAAM,EACb,QAAQ,GAAE,eAAgC,GACzC,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAqBpD;AAgBD;;;;;;;;;;GAUG;AACH,wBAAsB,yBAAyB,CAC7C,QAAQ,EAAE,2BAA2B,EACrC,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,EAAE,EACpB,MAAM,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,iBAAiB,EAChD,OAAO,CAAC,EAAE,CAAC,UAAU,EAAE,aAAa,EAAE,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAC/E,OAAO,CAAC;IAAE,UAAU,EAAE,aAAa,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAyC3D"}