@arcadiasystems/morse-sdk 0.1.0

package/dist/ops/entry-from-bytes.d.ts

@@ -0,0 +1,129 @@
+/**
+ * High-level entry ops that compose Walrus upload + add_entry into 2 wallet
+ * popups instead of 3.
+ *
+ * Background: a naive `uploadBlob` then `addEntry` flow emits three popups
+ * (`register_blob`, `certify_blob`, `add_entry_to_collection`). The first
+ * cannot be combined because the off-chain blob upload to storage nodes
+ * happens between register and certify. The second and third are both
+ * on-chain Sui transactions and can be packed into one PTB.
+ *
+ * `addEntryFromBytes` and `addEncryptedEntryFromBytes` use the
+ * `WalrusFlowCapable.startBlobUpload` capability to drive the register
+ * step, then append `add_entry_to_collection` to the certify `Transaction`
+ * and submit once. The default `DefaultWalrusWriteAdapter` implements the
+ * capability; consumers passing a custom `WalrusWriteAdapter` without
+ * `WalrusFlowCapable` get a clear `TransportError` and should compose
+ * `walrus.uploadBlob` + `addEntry` (3 popups) instead.
+ */
+import type { MorsePackageConfig } from "../config.js";
+import type { SealAdapter } from "../seal/adapter.js";
+import type { BlobObjectId, PublicationId, PublisherCapId, SealId, WalrusBlobId } from "../types.js";
+import type { WalletAdapter } from "../wallets/adapter.js";
+import { type UploadBlobOptions, type WalrusFlowCapable, type WalrusWriteAdapter } from "../walrus/adapter.js";
+/**
+ * Coarse-grained progress phases emitted by `addEntryFromBytes` and
+ * `addEncryptedEntryFromBytes` for UI spinners and ETA hints.
+ *
+ * - `encrypting`: emitted once at the start of `addEncryptedEntryFromBytes`
+ *   before the Seal call. Not emitted for the unencrypted variant.
+ * - `uploading`: emitted before `register_blob` (popup 1) and again before
+ *   the off-chain upload to storage nodes; UI can keep one spinner up
+ *   across both.
+ * - `submitting`: emitted before the combined `certify_blob + add_entry`
+ *   PTB (popup 2).
+ * - `complete`: emitted after the entry has been successfully added.
+ *   Equivalent to the function's return; provided for symmetry so a single
+ *   handler can cover the full lifecycle.
+ */
+export type ProgressEvent = {
+    readonly phase: "encrypting";
+} | {
+    readonly phase: "uploading";
+} | {
+    readonly phase: "submitting";
+} | {
+    readonly phase: "complete";
+};
+/** Optional callback shape for progress events. */
+export type ProgressCallback = (event: ProgressEvent) => void;
+/** Result of `addEntryFromBytes` / `addEncryptedEntryFromBytes`. */
+export interface AddEntryFromBytesResult {
+    readonly digest: string;
+    readonly gasUsedMist: bigint;
+    readonly entryId: number;
+    /** Always `0` for the entry's first revision; surfaced for symmetry. */
+    readonly revisionId: number;
+    /** Sui object id of the newly-created `Blob` referenced by the entry. */
+    readonly blobObjectId: BlobObjectId;
+    /** Walrus content-addressed blob id (43-char URL-safe-base64). */
+    readonly blobId: WalrusBlobId;
+}
+/** Args for `addEntryFromBytes`. */
+export interface AddEntryFromBytesArgs {
+    readonly walrus: WalrusWriteAdapter & WalrusFlowCapable;
+    readonly publicationId: PublicationId;
+    readonly publisherCapId: PublisherCapId;
+    readonly collectionName: string;
+    readonly name: string;
+    readonly bytes: Uint8Array;
+    readonly contentType: string;
+    readonly upload: UploadBlobOptions;
+    readonly signal?: AbortSignal;
+    /**
+     * Optional callback invoked at coarse-grained phase boundaries:
+     * `uploading` before the register popup, `submitting` before the combined
+     * certify+addEntry popup, `complete` after the entry is added. Errors
+     * thrown by the callback are propagated.
+     */
+    readonly onProgress?: ProgressCallback;
+}
+/**
+ * Upload `bytes` to Walrus and add the resulting blob as a new entry in one
+ * collection in 2 wallet popups: register_blob, then a combined
+ * certify_blob + add_entry_to_collection PTB.
+ *
+ * @throws {UncertifiedBlobError} If the second popup fails after upload
+ *   succeeded; the blob is uploaded but uncertified and storage is held
+ *   until expiry. The original error is preserved as `cause`.
+ * @throws {ContractAbortError} On Move abort during the simulation pass
+ *   before any popup happens.
+ * @throws {TransportError} On RPC, network, or upload-step failure before
+ *   the blob is uploaded.
+ */
+export declare function addEntryFromBytes(adapter: WalletAdapter, config: MorsePackageConfig, args: AddEntryFromBytesArgs): Promise<AddEntryFromBytesResult>;
+/** Args for `addEncryptedEntryFromBytes`. */
+export interface AddEncryptedEntryFromBytesArgs {
+    readonly walrus: WalrusWriteAdapter & WalrusFlowCapable;
+    readonly seal: SealAdapter;
+    readonly publicationId: PublicationId;
+    readonly publisherCapId: PublisherCapId;
+    readonly collectionName: string;
+    readonly name: string;
+    readonly plaintext: Uint8Array;
+    readonly contentType: string;
+    readonly sealId: SealId;
+    readonly upload: UploadBlobOptions;
+    readonly signal?: AbortSignal;
+    /**
+     * Optional callback invoked at coarse-grained phase boundaries:
+     * `encrypting` (Seal call), `uploading` (register + off-chain upload),
+     * `submitting` (combined certify+addEntry popup), `complete`. Errors
+     * thrown by the callback are propagated.
+     */
+    readonly onProgress?: ProgressCallback;
+}
+/**
+ * Encrypt `plaintext` via Seal, upload the ciphertext to Walrus, and add the
+ * resulting blob as a new encrypted entry in 2 wallet popups (encryption is
+ * popup-free; popups are register_blob then certify_blob + add_entry).
+ *
+ * @throws {SealError} If encryption fails (no popup yet).
+ * @throws {UncertifiedBlobError} If the second popup fails after upload
+ *   succeeded.
+ * @throws {ContractAbortError} On Move abort during simulation.
+ * @throws {TransportError} On RPC, network, or upload-step failure before
+ *   the blob is uploaded.
+ */
+export declare function addEncryptedEntryFromBytes(adapter: WalletAdapter, config: MorsePackageConfig, args: AddEncryptedEntryFromBytesArgs): Promise<AddEntryFromBytesResult>;
+//# sourceMappingURL=entry-from-bytes.d.ts.map

package/dist/ops/entry-from-bytes.d.ts.map

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

package/dist/ops/entry-from-bytes.js

@@ -0,0 +1,137 @@
+/**
+ * High-level entry ops that compose Walrus upload + add_entry into 2 wallet
+ * popups instead of 3.
+ *
+ * Background: a naive `uploadBlob` then `addEntry` flow emits three popups
+ * (`register_blob`, `certify_blob`, `add_entry_to_collection`). The first
+ * cannot be combined because the off-chain blob upload to storage nodes
+ * happens between register and certify. The second and third are both
+ * on-chain Sui transactions and can be packed into one PTB.
+ *
+ * `addEntryFromBytes` and `addEncryptedEntryFromBytes` use the
+ * `WalrusFlowCapable.startBlobUpload` capability to drive the register
+ * step, then append `add_entry_to_collection` to the certify `Transaction`
+ * and submit once. The default `DefaultWalrusWriteAdapter` implements the
+ * capability; consumers passing a custom `WalrusWriteAdapter` without
+ * `WalrusFlowCapable` get a clear `TransportError` and should compose
+ * `walrus.uploadBlob` + `addEntry` (3 popups) instead.
+ */
+import { TransportError, UncertifiedBlobError } from "../errors.js";
+import { buildAddEncryptedEntry, buildAddEntry } from "../ptb/entry.js";
+import { isWalrusFlowCapable, } from "../walrus/adapter.js";
+import { decodeU64ReturnValue } from "./internal.js";
+/**
+ * Upload `bytes` to Walrus and add the resulting blob as a new entry in one
+ * collection in 2 wallet popups: register_blob, then a combined
+ * certify_blob + add_entry_to_collection PTB.
+ *
+ * @throws {UncertifiedBlobError} If the second popup fails after upload
+ *   succeeded; the blob is uploaded but uncertified and storage is held
+ *   until expiry. The original error is preserved as `cause`.
+ * @throws {ContractAbortError} On Move abort during the simulation pass
+ *   before any popup happens.
+ * @throws {TransportError} On RPC, network, or upload-step failure before
+ *   the blob is uploaded.
+ */
+export async function addEntryFromBytes(adapter, config, args) {
+    assertFlowCapable(args.walrus);
+    args.onProgress?.({ phase: "uploading" });
+    const upload = await args.walrus.startBlobUpload(args.bytes, args.upload);
+    try {
+        const tx = upload.certifyTransaction;
+        buildAddEntry(tx, {
+            packageId: config.packageId,
+            publication: args.publicationId,
+            publisherCap: args.publisherCapId,
+            collectionName: args.collectionName,
+            name: args.name,
+            blobObjectId: upload.blobObjectId,
+            contentType: args.contentType,
+        });
+        args.onProgress?.({ phase: "submitting" });
+        const result = await submitCombinedTx(adapter, tx, {
+            blobObjectId: upload.blobObjectId,
+            blobId: upload.blobId,
+            ...(args.signal === undefined ? {} : { signal: args.signal }),
+        });
+        args.onProgress?.({ phase: "complete" });
+        return result;
+    }
+    catch (cause) {
+        if (cause instanceof UncertifiedBlobError)
+            throw cause;
+        throw new UncertifiedBlobError(upload.blobObjectId, upload.blobId, {
+            cause,
+        });
+    }
+}
+/**
+ * Encrypt `plaintext` via Seal, upload the ciphertext to Walrus, and add the
+ * resulting blob as a new encrypted entry in 2 wallet popups (encryption is
+ * popup-free; popups are register_blob then certify_blob + add_entry).
+ *
+ * @throws {SealError} If encryption fails (no popup yet).
+ * @throws {UncertifiedBlobError} If the second popup fails after upload
+ *   succeeded.
+ * @throws {ContractAbortError} On Move abort during simulation.
+ * @throws {TransportError} On RPC, network, or upload-step failure before
+ *   the blob is uploaded.
+ */
+export async function addEncryptedEntryFromBytes(adapter, config, args) {
+    assertFlowCapable(args.walrus);
+    args.onProgress?.({ phase: "encrypting" });
+    const { ciphertext } = await args.seal.encrypt(args.plaintext, {
+        sealId: args.sealId,
+    });
+    args.onProgress?.({ phase: "uploading" });
+    const upload = await args.walrus.startBlobUpload(ciphertext, args.upload);
+    try {
+        const tx = upload.certifyTransaction;
+        buildAddEncryptedEntry(tx, {
+            packageId: config.packageId,
+            publication: args.publicationId,
+            publisherCap: args.publisherCapId,
+            collectionName: args.collectionName,
+            name: args.name,
+            blobObjectId: upload.blobObjectId,
+            contentType: args.contentType,
+            sealId: args.sealId,
+        });
+        args.onProgress?.({ phase: "submitting" });
+        const result = await submitCombinedTx(adapter, tx, {
+            blobObjectId: upload.blobObjectId,
+            blobId: upload.blobId,
+            ...(args.signal === undefined ? {} : { signal: args.signal }),
+        });
+        args.onProgress?.({ phase: "complete" });
+        return result;
+    }
+    catch (cause) {
+        if (cause instanceof UncertifiedBlobError)
+            throw cause;
+        throw new UncertifiedBlobError(upload.blobObjectId, upload.blobId, {
+            cause,
+        });
+    }
+}
+function assertFlowCapable(walrus) {
+    if (!isWalrusFlowCapable(walrus)) {
+        throw new TransportError("addEntryFromBytes / addEncryptedEntryFromBytes require a WalrusWriteAdapter that implements WalrusFlowCapable (i.e. exposes startBlobUpload). The default DefaultWalrusWriteAdapter does. Custom adapters that do not implement the capability should compose walrus.uploadBlob + addEntry (3 popups) instead.");
+    }
+}
+async function submitCombinedTx(adapter, tx, args) {
+    const simulated = await adapter.simulateTransaction(tx, args.signal);
+    // Combined PTB: certify_blob is move call 0, add_entry_to_collection is
+    // move call 1; the entryId u64 is the return value of call 1.
+    const entryId = decodeU64ReturnValue(simulated, 1, 0);
+    const receipt = await adapter.signAndExecuteTransaction(tx, args.signal);
+    return {
+        digest: receipt.digest,
+        gasUsedMist: receipt.gasUsedMist,
+        entryId,
+        revisionId: 0,
+        blobObjectId: args.blobObjectId,
+        blobId: args.blobId,
+    };
+}
+//# sourceMappingURL=entry-from-bytes.js.map

package/dist/ops/entry-from-bytes.js.map

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

package/dist/ops/entry.d.ts

@@ -0,0 +1,173 @@
+/**
+ * High-level entry/revision ops. Non-encrypted, public access policy.
+ * Encrypted variants are exposed through a separate set of ops with their
+ * own args types.
+ *
+ * To surface the `u64` returned by Move (`entry_id` on add, `revision_id` on
+ * appends/publishes), each id-returning op simulates the PTB first to read
+ * the BCS-encoded return value, then signs and executes. Two RPC round-trips
+ * per call.
+ *
+ * Race-window caveat: there is a brief window between the simulate and the
+ * execute calls where another transaction can mutate the publication's
+ * shared state. In single-publisher write paths this window is narrow and
+ * the returned `entryId`/`revisionId` is reliable in practice. Under
+ * concurrent writes from multiple `PublisherCap` holders, the simulated
+ * id can be invalidated by an interleaving transaction; the SDK does not
+ * detect this and the returned id may be stale. Consumers running
+ * concurrent writers should treat the returned id as advisory and rely on
+ * `reader.listEntries(...)` for the authoritative entry set.
+ */
+import type { MorsePackageConfig } from "../config.js";
+import type { BlobObjectId, PublicationId, PublisherCapId, QuiltPatchId, SealId, TxReceipt } from "../types.js";
+import type { WalletAdapter } from "../wallets/adapter.js";
+export interface AddEntryArgs {
+    readonly publicationId: PublicationId;
+    readonly publisherCapId: PublisherCapId;
+    readonly collectionName: string;
+    readonly name: string;
+    readonly blobObjectId: BlobObjectId;
+    readonly quiltPatchId?: QuiltPatchId;
+    readonly contentType: string;
+    readonly signal?: AbortSignal;
+}
+export interface AddEntryResult {
+    readonly digest: string;
+    readonly gasUsedMist: bigint;
+    /** Stable monotonic ID assigned to the new entry. */
+    readonly entryId: number;
+    /** Always `0` for the entry's first revision; surfaced for symmetry with append/publish. */
+    readonly revisionId: number;
+}
+/**
+ * Add a new entry to a collection with its first revision, given a
+ * pre-uploaded `blobObjectId`. For the typical "upload-then-add" flow,
+ * prefer `addEntryFromBytes`, which packs upload + addEntry into 2 wallet
+ * popups instead of 3. Use this lower-level form when reusing a blob across
+ * multiple entries (deduplication), decoupling upload time from publish
+ * time, or pre-uploading from a server.
+ *
+ * @throws {ContractAbortError} On Move abort.
+ * @throws {TransportError} On RPC, network, or response-parsing failure.
+ */
+export declare function addEntry(adapter: WalletAdapter, config: MorsePackageConfig, args: AddEntryArgs): Promise<AddEntryResult>;
+export interface AppendDraftRevisionArgs {
+    readonly publicationId: PublicationId;
+    readonly publisherCapId: PublisherCapId;
+    readonly collectionName: string;
+    readonly entryId: number;
+    readonly blobObjectId: BlobObjectId;
+    readonly quiltPatchId?: QuiltPatchId;
+    readonly contentType: string;
+    readonly signal?: AbortSignal;
+}
+export interface RevisionAppendResult {
+    readonly digest: string;
+    readonly gasUsedMist: bigint;
+    /** Index of the newly appended revision in the entry's revision vector. */
+    readonly revisionId: number;
+}
+/**
+ * Append a draft revision to an existing entry.
+ * @throws {ContractAbortError} On Move abort (e.g. entry not found surfaces as
+ *   `module: "collection", reason: "EEntryNotFound"`).
+ * @throws {TransportError} On RPC, network, or response-parsing failure.
+ */
+export declare function appendDraftRevision(adapter: WalletAdapter, config: MorsePackageConfig, args: AppendDraftRevisionArgs): Promise<RevisionAppendResult>;
+export interface PublishFromDraftArgs {
+    readonly publicationId: PublicationId;
+    readonly publisherCapId: PublisherCapId;
+    readonly collectionName: string;
+    readonly entryId: number;
+    readonly draftRevisionId: number;
+    readonly blobObjectId: BlobObjectId;
+    readonly quiltPatchId?: QuiltPatchId;
+    readonly contentType: string;
+    readonly signal?: AbortSignal;
+}
+/**
+ * Promote a draft to public. Despite the name, this appends a *new* public
+ * revision; `draftRevisionId` is only used by the contract to validate that
+ * the draft exists. `blobObjectId`/`quiltPatchId` are the published content
+ * and may differ from the draft's.
+ * @throws {ContractAbortError} On Move abort.
+ * @throws {TransportError} On RPC, network, or response-parsing failure.
+ */
+export declare function publishFromDraft(adapter: WalletAdapter, config: MorsePackageConfig, args: PublishFromDraftArgs): Promise<RevisionAppendResult>;
+export interface PublishDirectArgs {
+    readonly publicationId: PublicationId;
+    readonly publisherCapId: PublisherCapId;
+    readonly collectionName: string;
+    readonly entryId: number;
+    readonly blobObjectId: BlobObjectId;
+    readonly quiltPatchId?: QuiltPatchId;
+    readonly contentType: string;
+    readonly signal?: AbortSignal;
+}
+/**
+ * Append a public, non-encrypted revision in one step (no draft).
+ * @throws {ContractAbortError} On Move abort.
+ * @throws {TransportError} On RPC, network, or response-parsing failure.
+ */
+export declare function publishDirect(adapter: WalletAdapter, config: MorsePackageConfig, args: PublishDirectArgs): Promise<RevisionAppendResult>;
+export interface DeleteEntryArgs {
+    readonly publicationId: PublicationId;
+    readonly publisherCapId: PublisherCapId;
+    readonly collectionName: string;
+    readonly entryId: number;
+    readonly signal?: AbortSignal;
+}
+export type DeleteEntryResult = TxReceipt;
+/**
+ * Delete an entry from a collection. No client-side preflight.
+ * @throws {ContractAbortError} On Move abort. Missing entry surfaces as
+ *   `module: "collection", reason: "EEntryNotFound"`.
+ * @throws {TransportError} On RPC, network, or response-parsing failure.
+ */
+export declare function deleteEntry(adapter: WalletAdapter, config: MorsePackageConfig, args: DeleteEntryArgs): Promise<DeleteEntryResult>;
+export interface AddEncryptedEntryArgs {
+    readonly publicationId: PublicationId;
+    readonly publisherCapId: PublisherCapId;
+    readonly collectionName: string;
+    readonly name: string;
+    readonly blobObjectId: BlobObjectId;
+    readonly quiltPatchId?: QuiltPatchId;
+    readonly contentType: string;
+    readonly sealId: SealId;
+    readonly signal?: AbortSignal;
+}
+/**
+ * Add a new entry whose first revision is encrypted under the supplied
+ * `sealId` with the Publisher access policy, given pre-encrypted ciphertext
+ * already uploaded to Walrus. For the typical encrypt-upload-add flow,
+ * prefer `addEncryptedEntryFromBytes`, which handles encryption and 2-popup
+ * upload in a single call. Use this lower-level form when ciphertext
+ * already exists, you want to attach the same ciphertext to multiple
+ * entries, or you upload from a different process than the one calling
+ * this op.
+ *
+ * @throws {ContractAbortError} On Move abort.
+ * @throws {TransportError} On RPC, network, or response-parsing failure.
+ */
+export declare function addEncryptedEntry(adapter: WalletAdapter, config: MorsePackageConfig, args: AddEncryptedEntryArgs): Promise<AddEntryResult>;
+export interface AppendEncryptedDraftRevisionArgs {
+    readonly publicationId: PublicationId;
+    readonly publisherCapId: PublisherCapId;
+    readonly collectionName: string;
+    readonly entryId: number;
+    readonly blobObjectId: BlobObjectId;
+    readonly quiltPatchId?: QuiltPatchId;
+    readonly contentType: string;
+    readonly sealId: SealId;
+    readonly signal?: AbortSignal;
+}
+/**
+ * Append an encrypted draft revision to an existing entry. Each revision
+ * carries its own `sealId`; passing a different identity from the prior
+ * revision is valid on-chain.
+ *
+ * @throws {ContractAbortError} On Move abort.
+ * @throws {TransportError} On RPC, network, or response-parsing failure.
+ */
+export declare function appendEncryptedDraftRevision(adapter: WalletAdapter, config: MorsePackageConfig, args: AppendEncryptedDraftRevisionArgs): Promise<RevisionAppendResult>;
+//# sourceMappingURL=entry.d.ts.map

package/dist/ops/entry.d.ts.map

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