@misofm/platform 0.0.0 → 0.19.0

package/dist/share.js

@@ -0,0 +1,157 @@
+// Copyright (c) Miso Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+import { fromBase64, fromHex, toBase64 } from "@mysten/sui/utils";
+import { update_constants } from "@mysten/move-bytecode-template";
+import { execThunks, publishedPackageId, allPublishedPackageIds, createdByType, allCreatedByType, } from "@misofm/protocol";
+import { publishShareCurrency, initializeShareCurrency } from "./transactions.js";
+import { SHARE_TEMPLATE } from "./share-template.js";
+import { executeViaExecutor } from "./execute.js";
+/** The protocol cap on Publish/Upgrade commands per programmable transaction. */
+const PUBLISHES_PER_PTB = 5;
+/** Initializes batched per PTB (each is one moveCall + transfer; all share the 0xc registry). */
+const INITS_PER_PTB = 10;
+// Address-free type markers: gRPC object types carry fully-normalized addresses
+// (e.g. 0x0000…0002::coin::TreasuryCap), so we match on module::type rather than a
+// short "0x2" prefix that would never match.
+const CURRENCY_TYPE = "::coin_registry::Currency<";
+const TREASURY_CAP_TYPE = "::coin::TreasuryCap<";
+// ── Bytecode patching ────────────────────────────────────────────────────────
+/**
+ * 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 function patchInitializer(template, initializerAddress) {
+    const moduleBytes = fromBase64(template.modules[0]);
+    // BCS-encoded vector<u8> of 32 zero bytes: [length=32, 0×32].
+    const oldValue = new Uint8Array(33);
+    oldValue[0] = 32;
+    // BCS-encoded vector<u8> of the initializer's 32 address bytes.
+    const newValue = new Uint8Array(33);
+    newValue[0] = 32;
+    newValue.set(fromHex(initializerAddress), 1);
+    const patched = update_constants(moduleBytes, newValue, oldValue, "Vector(U8)");
+    return { ...template, modules: [toBase64(patched)] };
+}
+/** Publishes an immutable package, then initializes a fresh share currency in a second tx. */
+export async function createShareCurrency(client, signer, params) {
+    const signerAddress = signer.toSuiAddress();
+    const initializer = params.initializerAddress ?? signerAddress;
+    const recipient = params.treasuryCapRecipient ?? signerAddress;
+    // Tx 1: publish the share package with the initializer baked in.
+    const patched = patchInitializer(params.template ?? SHARE_TEMPLATE, initializer);
+    const publishRes = await execThunks(client, signer, publishShareCurrency(patched));
+    const packageId = publishedPackageId(publishRes);
+    // Tx 2: initialize → creates the Currency object + transfers the TreasuryCap.
+    const initRes = await execThunks(client, signer, initializeShareCurrency({
+        shareCurrencyPackageId: packageId,
+        name: params.name,
+        description: params.description,
+        iconUrl: params.iconUrl ?? "",
+        treasuryCapRecipient: recipient,
+    }));
+    return {
+        packageId,
+        currencyId: createdByType(initRes, CURRENCY_TYPE),
+        shareType: `${packageId}::share::Share`,
+        treasuryCapId: createdByType(initRes, TREASURY_CAP_TYPE),
+        gasUsed: publishRes.gasUsed + initRes.gasUsed,
+    };
+}
+// ── Batched (parallel) ─────────────────────────────────────────────────────
+/** Splits an array into fixed-size chunks. */
+function chunk(items, size) {
+    const out = [];
+    for (let i = 0; i < items.length; i += size)
+        out.push(items.slice(i, i + size));
+    return out;
+}
+/**
+ * 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 async function publishShareCurrencies(executor, initializerAddress, count, template = SHARE_TEMPLATE) {
+    if (count <= 0)
+        return { packageIds: [], gasUsed: 0 };
+    // One patched template, reused for every publish (identical bytecode → distinct packages).
+    const patched = patchInitializer(template, initializerAddress);
+    const batchSizes = [];
+    for (let remaining = count; remaining > 0; remaining -= PUBLISHES_PER_PTB) {
+        batchSizes.push(Math.min(PUBLISHES_PER_PTB, remaining));
+    }
+    const results = await Promise.all(batchSizes.map((n) => executeViaExecutor(executor, ...Array.from({ length: n }, () => publishShareCurrency(patched)))));
+    const packageIds = results.flatMap(allPublishedPackageIds);
+    const gasUsed = results.reduce((sum, r) => sum + r.gasUsed, 0);
+    if (packageIds.length !== count) {
+        throw new Error(`Expected ${count} published share packages, got ${packageIds.length}.`);
+    }
+    return { packageIds, gasUsed };
+}
+/** Re-associates one init PTB's created objects back to their packages by share type. */
+function currenciesFromResult(res, batchPkgs) {
+    const currencies = allCreatedByType(res, CURRENCY_TYPE);
+    const treasuries = allCreatedByType(res, TREASURY_CAP_TYPE);
+    return batchPkgs.map((pkg) => {
+        const shareType = `${pkg}::share::Share`;
+        const currency = currencies.find((o) => o.objectType.includes(shareType));
+        const treasury = treasuries.find((o) => o.objectType.includes(shareType));
+        if (!currency)
+            throw new Error(`No Currency<${shareType}> created during initialize.`);
+        if (!treasury)
+            throw new Error(`No TreasuryCap<${shareType}> created during initialize.`);
+        return { packageId: pkg, currencyId: currency.objectId, shareType, treasuryCapId: treasury.objectId, gasUsed: 0 };
+    });
+}
+/**
+ * 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 async function initializeShareCurrencies(executor, signerAddress, packageIds, metaOf, onBatch) {
+    if (packageIds.length === 0)
+        return { currencies: [], gasUsed: 0 };
+    const batches = chunk(packageIds, INITS_PER_PTB);
+    const settled = await Promise.allSettled(batches.map(async (batchPkgs) => {
+        const res = await executeViaExecutor(executor, ...batchPkgs.map((pkg) => {
+            const meta = metaOf(pkg);
+            return initializeShareCurrency({
+                shareCurrencyPackageId: pkg,
+                name: meta.name,
+                description: meta.description,
+                iconUrl: meta.iconUrl ?? "",
+                treasuryCapRecipient: signerAddress,
+            });
+        }));
+        const batchCurrencies = currenciesFromResult(res, batchPkgs);
+        if (onBatch)
+            await onBatch(batchCurrencies, res.gasUsed);
+        return { batchCurrencies, gasUsed: res.gasUsed };
+    }));
+    const currencies = [];
+    const errors = [];
+    let gasUsed = 0;
+    for (const s of settled) {
+        if (s.status === "fulfilled") {
+            currencies.push(...s.value.batchCurrencies);
+            gasUsed += s.value.gasUsed;
+        }
+        else {
+            errors.push(s.reason);
+        }
+    }
+    if (errors.length > 0) {
+        const msg = errors.map((e) => (e instanceof Error ? e.message : String(e))).join("; ");
+        throw new Error(`${errors.length}/${batches.length} initialize batch(es) failed: ${msg}`);
+    }
+    return { currencies, gasUsed };
+}
+//# sourceMappingURL=share.js.map

package/dist/share.js.map

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

package/dist/transactions.d.ts

@@ -0,0 +1,216 @@
+import { Transaction, type TransactionObjectArgument } from "@mysten/sui/transactions";
+import { type CompositionParts, type RecordingParts, type ShareCurrencyBinding, type TxThunk } from "@misofm/protocol";
+import { type AdminCapAuthority, type AdminCapCustody, type U64Input } from "./vault.ts";
+interface ReleaseParts {
+    release: TransactionObjectArgument;
+    adminCap: TransactionObjectArgument;
+}
+export type { TxThunk };
+/** New custody is explicit; the legacy address shape remains mutually exclusive. */
+export type AdminCustodyInput = {
+    readonly adminCustody: AdminCapCustody;
+    readonly adminAddress?: never;
+} | {
+    readonly adminCustody?: never;
+    readonly adminAddress: string;
+};
+export type RecordingAuthorityInput = {
+    readonly recordingAuthority: AdminCapAuthority;
+    readonly recordingAdminCapId?: never;
+} | {
+    readonly recordingAuthority?: never;
+    readonly recordingAdminCapId: string;
+};
+export declare function custodyOf(input: AdminCustodyInput): AdminCapCustody;
+export declare function recordingAuthorityOf(input: RecordingAuthorityInput): AdminCapAuthority;
+/** Reject a malformed multi-result command before it becomes a PTB argument. */
+export declare function requiredCommandResult<T>(result: {
+    readonly [index: number]: T | undefined;
+}, index: number, command: string): T;
+export interface ShareRecipient {
+    address: string;
+    value: U64Input;
+}
+export interface CreateShareStakeParams {
+    readonly balance: TransactionObjectArgument;
+    readonly shareType: string;
+    readonly value: U64Input;
+    readonly royaltyPoolPackageId: string;
+}
+/** Split shares from a Balance and return a fresh, unregistered Stake object. */
+export declare function createShareStake(tx: Transaction, params: CreateShareStakeParams): TransactionObjectArgument;
+export interface RegisterShareStakeParams {
+    readonly stake: TransactionObjectArgument;
+    readonly pool: TransactionObjectArgument;
+    readonly shareType: string;
+    readonly currencyType: string;
+    readonly royaltyPoolPackageId: string;
+}
+/** Register an existing Stake with one RoyaltyPool. */
+export declare function registerShareStake(tx: Transaction, params: RegisterShareStakeParams): void;
+export interface CreateShareStakesParams {
+    readonly balance: TransactionObjectArgument;
+    readonly shareType: string;
+    readonly recipients: readonly ShareRecipient[];
+    readonly royaltyPoolPackageId: string;
+}
+/**
+ * Convert an entire share Balance into one unregistered Stake per recipient.
+ * The emptied Balance is destroyed, so recipient values must consume it exactly.
+ * Returned stakes remain caller-controlled for optional registration and transfer.
+ */
+export declare function createShareStakes(tx: Transaction, params: CreateShareStakesParams): TransactionObjectArgument[];
+export interface ShareRoyaltyPoolParams {
+    readonly pool: TransactionObjectArgument;
+    readonly shareType: string;
+    readonly currencyType: string;
+    readonly royaltyPoolPackageId: string;
+}
+/** Consume an unshared RoyaltyPool and make it globally accessible. */
+export declare function shareRoyaltyPool(tx: Transaction, params: ShareRoyaltyPoolParams): void;
+/**
+ * Splits a share `Balance` across `recipients` via `minato::disperse_balance`, then
+ * destroys the emptied balance. Exposed for consumers assembling custom share
+ * distributions in their own PTBs.
+ */
+export declare function disperseShares(tx: Transaction, minatoPackageId: string, shareType: string, balance: TransactionObjectArgument, recipients: ShareRecipient[]): void;
+export interface PackageBytecode {
+    modules: string[];
+    dependencies: string[];
+    digest: number[];
+}
+/** Publish a share package and permanently destroy its UpgradeCap in the same PTB. */
+export declare function publishShareCurrency(bytecode: PackageBytecode): TxThunk;
+export interface InitializeShareCurrencyParams {
+    shareCurrencyPackageId: string;
+    name: string;
+    description: string;
+    iconUrl: string;
+    treasuryCapRecipient: string;
+}
+export declare function initializeShareCurrency(params: InitializeShareCurrencyParams): TxThunk;
+interface FinalizeCompositionParamsBase extends CompositionParts {
+    /** The composition's `share::Share` type. */
+    shareType: string;
+    shareRecipients: ShareRecipient[];
+    misoPackageId: string;
+    minatoPackageId: string;
+}
+export type FinalizeCompositionParams = FinalizeCompositionParamsBase & AdminCustodyInput;
+/**
+ * The opinionated finish for a composition: disperse its share supply to
+ * `shareRecipients`, publish (share) it, and transfer its admin cap to
+ * `adminAddress`. Consumers that want different economics skip this and act on
+ * the `CompositionParts` from `@misofm/protocol`'s `createComposition` directly.
+ */
+export declare function finalizeComposition(tx: Transaction, params: FinalizeCompositionParams): void;
+interface PublishCompositionParamsBase extends ShareCurrencyBinding {
+    title: string;
+    royaltyRateBps: number;
+    shareRecipients: ShareRecipient[];
+    misoPackageId: string;
+    minatoPackageId: string;
+}
+export type PublishCompositionParams = PublishCompositionParamsBase & AdminCustodyInput;
+/** Convenience: publish a composition end-to-end (createComposition → finalizeComposition). */
+export declare function publishComposition(params: PublishCompositionParams): TxThunk;
+interface FinalizeRecordingParamsBase extends RecordingParts {
+    /** The recording's own `share::Share` type. */
+    recordingShareType: string;
+    /** Share type of the parent composition. */
+    compositionShareType: string;
+    shareRecipients: ShareRecipient[];
+    misoPackageId: string;
+    minatoPackageId: string;
+}
+export type FinalizeRecordingParams = FinalizeRecordingParamsBase & AdminCustodyInput;
+/**
+ * The opinionated finish for a recording: publish (share) it, disperse its
+ * share supply, and transfer its admin cap to `adminAddress`. A recording has
+ * no embedded metadata to set — naming lives in the metadata extension.
+ */
+export declare function finalizeRecording(tx: Transaction, params: FinalizeRecordingParams): void;
+interface PublishRecordingParamsBase extends ShareCurrencyBinding {
+    /**
+     * Parent composition, referenced as an on-chain object. Read-only at
+     * `recording::new` (only its royalty rate and id are read).
+     */
+    compositionId: string;
+    /** Share type of the parent composition (the recording's `CompositionShare` phantom). */
+    compositionShareType: string;
+    shareRecipients: ShareRecipient[];
+    misoPackageId: string;
+    minatoPackageId: string;
+}
+export type PublishRecordingParams = PublishRecordingParamsBase & AdminCustodyInput;
+/** Convenience: publish a recording against an already-on-chain composition. */
+export declare function publishRecording(params: PublishRecordingParams): TxThunk;
+export interface PublishCompositionAndRecordingParams {
+    title: string;
+    royaltyRateBps: number;
+    /** Share-currency binding for the composition. */
+    composition: ShareCurrencyBinding & {
+        shareRecipients: ShareRecipient[];
+    } & AdminCustodyInput;
+    /** Share-currency binding for the recording. */
+    recording: ShareCurrencyBinding & {
+        shareRecipients: ShareRecipient[];
+    } & AdminCustodyInput;
+    misoPackageId: string;
+    minatoPackageId: string;
+}
+/**
+ * Publishes a composition and its recording in a single atomic PTB.
+ *
+ * The ordering is load-bearing: `recording::new` borrows the composition by
+ * immutable reference, so it must run while the composition is still an unshared,
+ * transaction-local value — i.e. AFTER `composition::new` but BEFORE
+ * `composition::publish` (which moves the composition into `share_object`). Hence:
+ * `composition::new` → `recording::new(&comp)` → finalize composition (publish) →
+ * finalize recording (publish).
+ */
+export declare function publishCompositionAndRecording(params: PublishCompositionAndRecordingParams): TxThunk;
+interface FinalizeReleaseParamsBase extends ReleaseParts {
+    /** Explicit direct delivery or Vault custody for the ReleaseAdminCap. */
+    misoPackageId: string;
+}
+export type FinalizeReleaseParams = FinalizeReleaseParamsBase & AdminCustodyInput;
+/**
+ * The opinionated finish for a release: publish (share) it and transfer its
+ * admin cap to `adminAddress`.
+ *
+ * MUST run in the same PTB as `release::new(registry, …)` that produced
+ * these parts —
+ * `Release` is `key`-only with no `drop`, so an unpublished release cannot
+ * outlive its transaction. Splitting create from finalize is what lets a caller
+ * do something else with the cap (route it to a vault, hand it to another
+ * package, keep it for later commands) instead of a plain address transfer.
+ */
+export declare function finalizeRelease(tx: Transaction, params: FinalizeReleaseParams): void;
+interface TrackInputBase {
+    recordingId: string;
+    /** Explicit legacy direct cap or Vault custody authority for this recording. */
+    /** Share type of the recording (the track `RecordingShare` phantom). */
+    recordingShareType: string;
+    /** Share type of the parent composition (the track `CompositionShare` phantom). */
+    compositionShareType: string;
+    splitBps: number;
+}
+export type TrackInput = TrackInputBase & RecordingAuthorityInput;
+interface PublishReleaseParamsBase {
+    title: string;
+    /** The ordered tracklist. Display grouping (discs/sides) is extension data. */
+    tracks: TrackInput[];
+    /** Shared core `miso::release::ReleaseRegistry` object. */
+    releaseRegistryId: string;
+    releaseId: string;
+    releaseNonce: string;
+    misoPackageId: string;
+}
+export type PublishReleaseParams = PublishReleaseParamsBase & AdminCustodyInput;
+/**
+ * Convenience: publish a release end-to-end, assembling its tracklist from
+ * recording admin caps held by the sender.
+ */
+export declare function publishRelease(params: PublishReleaseParams): TxThunk;
+//# sourceMappingURL=transactions.d.ts.map

package/dist/transactions.d.ts.map

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