@arcadiasystems/morse-sdk 0.1.0

package/dist/codecs.js

@@ -0,0 +1,132 @@
+/**
+ * Runtime codecs: branded-ID constructors and enum converters between
+ * TypeScript values and on-chain Move representations.
+ */
+import { ValidationError } from "./errors.js";
+import { AccessPolicy, QUILT_PATCH_ID_LENGTH, StorageMode, } from "./types.js";
+// ID validation
+/** `0x` + 1 to 64 lowercase hex chars. */
+const OBJECT_ID_PATTERN = /^0x[0-9a-f]{1,64}$/;
+const OBJECT_ID_HEX_LENGTH = 64;
+/**
+ * Validate the input shape and return its zero-padded canonical form.
+ * Sui represents object IDs as 32-byte values rendered `0x`+64 hex chars.
+ * Short forms (e.g. `"0x1"`) are accepted as input — they're convenient in
+ * Move source — but the brand always carries the canonical 64-char form so
+ * downstream string equality works against RPC responses (which are always
+ * canonical).
+ */
+function normalizeObjectId(value, field) {
+    if (!OBJECT_ID_PATTERN.test(value)) {
+        throw new ValidationError(`Invalid ${field}: expected lowercase hex prefixed with "0x" and up to 64 hex characters, got ${JSON.stringify(value)}`, field);
+    }
+    const hex = value.slice(2);
+    if (hex.length === OBJECT_ID_HEX_LENGTH) {
+        return value;
+    }
+    return `0x${hex.padStart(OBJECT_ID_HEX_LENGTH, "0")}`;
+}
+/**
+ * Construct a `PackageId`. Input may be `0x` + 1-64 lowercase hex chars;
+ * the result is always zero-padded to 64 hex chars (Sui canonical form).
+ * @throws {ValidationError} On invalid shape.
+ */
+export function toPackageId(value) {
+    return normalizeObjectId(value, "PackageId");
+}
+/** Construct a `RegistryId`. Input is normalized to canonical 64-char form. @throws {ValidationError} On invalid shape. */
+export function toRegistryId(value) {
+    return normalizeObjectId(value, "RegistryId");
+}
+/** Construct a `PublicationId`. Input is normalized to canonical 64-char form. @throws {ValidationError} On invalid shape. */
+export function toPublicationId(value) {
+    return normalizeObjectId(value, "PublicationId");
+}
+/** Construct an `OwnerCapId`. Input is normalized to canonical 64-char form. @throws {ValidationError} On invalid shape. */
+export function toOwnerCapId(value) {
+    return normalizeObjectId(value, "OwnerCapId");
+}
+/** Construct a `PublisherCapId`. Input is normalized to canonical 64-char form. @throws {ValidationError} On invalid shape. */
+export function toPublisherCapId(value) {
+    return normalizeObjectId(value, "PublisherCapId");
+}
+/** Construct a `BlobObjectId`. Input is normalized to canonical 64-char form. @throws {ValidationError} On invalid shape. */
+export function toBlobObjectId(value) {
+    return normalizeObjectId(value, "BlobObjectId");
+}
+/** Construct a `SuiAddress`. Input is normalized to canonical 64-char form. @throws {ValidationError} On invalid shape. */
+export function toSuiAddress(value) {
+    return normalizeObjectId(value, "SuiAddress");
+}
+/** Construct a `SuiObjectId`. Input is normalized to canonical 64-char form. @throws {ValidationError} On invalid shape. */
+export function toSuiObjectId(value) {
+    return normalizeObjectId(value, "SuiObjectId");
+}
+// Walrus blob id
+/** URL-safe base64 alphabet, no padding. 43 chars carries 32 bytes. */
+const WALRUS_BLOB_ID_PATTERN = /^[A-Za-z0-9_-]{43}$/;
+/**
+ * Construct a `WalrusBlobId` from a URL-safe base64 string (43 chars,
+ * unpadded). @throws {ValidationError} On invalid shape.
+ */
+export function toWalrusBlobId(value) {
+    if (!WALRUS_BLOB_ID_PATTERN.test(value)) {
+        throw new ValidationError(`Invalid WalrusBlobId: expected 43 URL-safe base64 chars (unpadded), got ${JSON.stringify(value)}`, "WalrusBlobId");
+    }
+    return value;
+}
+// Quilt patch id
+/**
+ * Construct a `QuiltPatchId` by validating length only. Use the structural
+ * codec in `walrus/quilt-patch-id.ts` for `{quiltId, version, startIndex,
+ * endIndex}` round-trips. @throws {ValidationError} On wrong length.
+ */
+export function toQuiltPatchId(bytes) {
+    if (bytes.length !== QUILT_PATCH_ID_LENGTH) {
+        throw new ValidationError(`Invalid QuiltPatchId: expected ${QUILT_PATCH_ID_LENGTH} bytes, got ${bytes.length}`, "QuiltPatchId");
+    }
+    return bytes;
+}
+// Storage mode
+/** Convert `StorageMode` to Move `u8`. */
+export function storageModeToU8(mode) {
+    if (mode === StorageMode.Blob) {
+        return 0;
+    }
+    return 1;
+}
+/** Convert Move `u8` to `StorageMode`. @throws {ValidationError} On unknown values. */
+export function storageModeFromU8(value) {
+    if (value === 0) {
+        return StorageMode.Blob;
+    }
+    if (value === 1) {
+        return StorageMode.Quilt;
+    }
+    throw new ValidationError(`Invalid storage_mode: expected 0 (blob) or 1 (quilt), got ${value}`, "storage_mode");
+}
+// Access policy
+/** Convert `AccessPolicy` to Move `u8`. */
+export function accessPolicyToU8(policy) {
+    if (policy === AccessPolicy.Public) {
+        return 0;
+    }
+    if (policy === AccessPolicy.Publisher) {
+        return 1;
+    }
+    return 2;
+}
+/** Convert Move `u8` to `AccessPolicy`. @throws {ValidationError} On unknown values. */
+export function accessPolicyFromU8(value) {
+    if (value === 0) {
+        return AccessPolicy.Public;
+    }
+    if (value === 1) {
+        return AccessPolicy.Publisher;
+    }
+    if (value === 2) {
+        return AccessPolicy.Subscription;
+    }
+    throw new ValidationError(`Invalid access_policy: expected 0, 1, or 2, got ${value}`, "access_policy");
+}
+//# sourceMappingURL=codecs.js.map

package/dist/codecs.js.map

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

package/dist/compatibility.d.ts

@@ -0,0 +1,22 @@
+/**
+ * The Mysten substrate versions morse-sdk has been tested end-to-end
+ * against. Compatibility is enforced at install time via peer-dependency
+ * ranges in `package.json` (`bun install` warns if mismatched). Runtime
+ * version checks are not provided because the Mysten libraries do not
+ * expose their `package.json` `version` through their `exports` maps; a
+ * hand-rolled "open the package.json from disk" check would be fragile in
+ * browser bundlers and silent on misconfiguration.
+ *
+ * This constant is exported so consumers can display the tested matrix in
+ * their own diagnostics, log it during initialization, or compare it
+ * against bundler-resolved versions in CI.
+ */
+/** Mysten substrate library versions verified end-to-end on testnet. */
+export declare const TESTED_SUBSTRATE: {
+    readonly "@mysten/sui": string;
+    readonly "@mysten/seal": string;
+    readonly "@mysten/walrus": string;
+    readonly verifiedOn: string;
+    readonly suiNetwork: "testnet";
+};
+//# sourceMappingURL=compatibility.d.ts.map

package/dist/compatibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compatibility.d.ts","sourceRoot":"","sources":["../src/compatibility.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,wEAAwE;AACxE,eAAO,MAAM,gBAAgB,EAAE;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC;CAO/B,CAAC"}

package/dist/compatibility.js

@@ -0,0 +1,22 @@
+/**
+ * The Mysten substrate versions morse-sdk has been tested end-to-end
+ * against. Compatibility is enforced at install time via peer-dependency
+ * ranges in `package.json` (`bun install` warns if mismatched). Runtime
+ * version checks are not provided because the Mysten libraries do not
+ * expose their `package.json` `version` through their `exports` maps; a
+ * hand-rolled "open the package.json from disk" check would be fragile in
+ * browser bundlers and silent on misconfiguration.
+ *
+ * This constant is exported so consumers can display the tested matrix in
+ * their own diagnostics, log it during initialization, or compare it
+ * against bundler-resolved versions in CI.
+ */
+/** Mysten substrate library versions verified end-to-end on testnet. */
+export const TESTED_SUBSTRATE = {
+    "@mysten/sui": "2.16.2",
+    "@mysten/seal": "1.1.3",
+    "@mysten/walrus": "1.1.6",
+    verifiedOn: "2026-05-10",
+    suiNetwork: "testnet",
+};
+//# sourceMappingURL=compatibility.js.map

package/dist/compatibility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compatibility.js","sourceRoot":"","sources":["../src/compatibility.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,wEAAwE;AACxE,MAAM,CAAC,MAAM,gBAAgB,GAMzB;IACH,aAAa,EAAE,QAAQ;IACvB,cAAc,EAAE,OAAO;IACvB,gBAAgB,EAAE,OAAO;IACzB,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE,SAAS;CACrB,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Network configuration types, defaults, and the `morseConfig` factory that
+ * hides deployed package addresses from consumers using known networks.
+ */
+import type { KeyServerConfig } from "@mysten/seal";
+import type { PackageId, RegistryId } from "./types.js";
+/** Supported Sui networks. */
+export declare const Network: {
+    readonly Mainnet: "mainnet";
+    readonly Testnet: "testnet";
+    readonly Localnet: "localnet";
+};
+export type Network = (typeof Network)[keyof typeof Network];
+/** Public Sui RPC endpoints per network. Override via `NetworkConfig.rpcUrl` if needed. */
+export declare const DEFAULT_RPC_URLS: Readonly<Record<Network, string>>;
+/**
+ * Points the SDK at a Morse deployment. Values come from the deployment's
+ * `Published.toml`.
+ *
+ * `packageId` is the `published-at` address (current upgrade) used as the
+ * target of Move calls. `originalPackageId` is the `original-id` (genesis
+ * publish address) used as the canonical type identity that Sui surfaces in
+ * `objectType` strings and type filters; defaults to `packageId` when
+ * omitted (correct for a fresh deploy with no upgrades). Swapping the two
+ * values causes type-filter reads (e.g. `listPublicationsOwnedBy`) to return
+ * empty.
+ */
+/**
+ * Walrus aggregator / publisher HTTP endpoints. The aggregator URL is the
+ * canonical Mysten-run service for the network; the publisher URL is left
+ * undefined by default because publishers are operator-specific (paid
+ * tiers, region pinning) and picking one for everyone is a trust decision
+ * the SDK should not make. Consumers using a specific publisher supply
+ * the URL explicitly via `morseConfig({ walrusEndpoints: { ... } })` or
+ * pass it directly to `HttpPublisherWriteAdapter.fromConfig`.
+ */
+export interface WalrusEndpoints {
+    /** Aggregator base URL for HTTP reads. No trailing slash. */
+    readonly aggregator: string;
+    /** Optional publisher base URL for HTTP writes. No trailing slash. */
+    readonly publisher?: string;
+}
+export interface NetworkConfig {
+    readonly network: Network;
+    readonly rpcUrl: string;
+    readonly packageId: PackageId;
+    readonly originalPackageId?: PackageId;
+    readonly registryId: RegistryId;
+    /**
+     * Canonical Seal threshold-encryption key servers for the network. Used by
+     * `DefaultSealAdapter.fromMorseConfig` when the consumer omits an explicit
+     * `serverConfigs`. Empty for networks where the allowlist isn't pinned yet
+     * (e.g. mainnet pre-freeze).
+     */
+    readonly sealKeyServers: readonly KeyServerConfig[];
+    /**
+     * Canonical Walrus HTTP endpoints for the network. Used by
+     * `HttpAggregatorReadAdapter.fromMorseConfig` (and the future publisher
+     * equivalent when a "canonical" publisher exists). Aggregator is pinned
+     * to Mysten's testnet service; publisher is intentionally left
+     * undefined — pass `walrusEndpoints.publisher` to override.
+     */
+    readonly walrusEndpoints: WalrusEndpoints;
+}
+/**
+ * Subset of `NetworkConfig` used by ops that touch only the package (cap and
+ * collection ops). Excludes `registryId`, which only registry-aware ops
+ * (publication creation/deletion) need.
+ */
+export type MorsePackageConfig = Pick<NetworkConfig, "packageId" | "originalPackageId">;
+/**
+ * Options for `morseConfig`. `network` is required; address fields are
+ * optional and override the canonical deployment when supplied. Use them
+ * for forks or local deployments.
+ */
+export interface MorseConfigOptions {
+    readonly network: Network;
+    readonly rpcUrl?: string;
+    readonly packageId?: PackageId;
+    readonly originalPackageId?: PackageId;
+    readonly registryId?: RegistryId;
+    readonly sealKeyServers?: readonly KeyServerConfig[];
+    readonly walrusEndpoints?: WalrusEndpoints;
+}
+/**
+ * Build a `NetworkConfig` pointing at the canonical Morse deployment for the
+ * chosen network, with optional per-field overrides for forks and local nodes.
+ * @throws {ConfigurationError} If the chosen network has no canonical deployment
+ *   and `packageId` and `registryId` are not supplied as overrides.
+ */
+export declare function morseConfig(options: MorseConfigOptions): NetworkConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAIpD,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAIxD,8BAA8B;AAC9B,eAAO,MAAM,OAAO;;;;CAIV,CAAC;AACX,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,OAAO,CAAC,CAAC,MAAM,OAAO,OAAO,CAAC,CAAC;AAI7D,2FAA2F;AAC3F,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAI9D,CAAC;AAIF;;;;;;;;;;;GAWG;AACH;;;;;;;;GAQG;AACH,MAAM,WAAW,eAAe;IAC/B,6DAA6D;IAC7D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,sEAAsE;IACtE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,CAAC;IACvC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC;;;;;OAKG;IACH,QAAQ,CAAC,cAAc,EAAE,SAAS,eAAe,EAAE,CAAC;IACpD;;;;;;OAMG;IACH,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;CAC1C;AAED;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,IAAI,CACpC,aAAa,EACb,WAAW,GAAG,mBAAmB,CACjC,CAAC;AA2DF;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC;IAC/B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,CAAC;IACvC,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;IACjC,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IACrD,QAAQ,CAAC,eAAe,CAAC,EAAE,eAAe,CAAC;CAC3C;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,aAAa,CA4BtE"}

package/dist/config.js

@@ -0,0 +1,85 @@
+/**
+ * Network configuration types, defaults, and the `morseConfig` factory that
+ * hides deployed package addresses from consumers using known networks.
+ */
+import { toPackageId, toRegistryId } from "./codecs.js";
+import { ConfigurationError } from "./errors.js";
+// Network
+/** Supported Sui networks. */
+export const Network = {
+    Mainnet: "mainnet",
+    Testnet: "testnet",
+    Localnet: "localnet",
+};
+// Default RPC endpoints
+/** Public Sui RPC endpoints per network. Override via `NetworkConfig.rpcUrl` if needed. */
+export const DEFAULT_RPC_URLS = {
+    mainnet: "https://fullnode.mainnet.sui.io:443",
+    testnet: "https://fullnode.testnet.sui.io:443",
+    localnet: "http://127.0.0.1:9000",
+};
+// morseConfig factory
+/**
+ * Canonical Morse deployment addresses per network. Updated on every contract
+ * redeploy during active development; expected to stabilize after Phase 7
+ * when the contracts are frozen for v0.1.0.
+ */
+const KNOWN_DEPLOYMENTS = {
+    testnet: {
+        packageId: toPackageId("0x191946c5dc1ea1b978e664d85455e81ef9bdd1d3dbb221fd48cf9008d46a00f0"),
+        originalPackageId: toPackageId("0x191946c5dc1ea1b978e664d85455e81ef9bdd1d3dbb221fd48cf9008d46a00f0"),
+        registryId: toRegistryId("0xb25e4849d720ad5058c1945a819aa1dc01ff899006e3f0fe7cb9c62668d307e2"),
+        // Canonical Seal testnet allowlist; mirrors the values used in Mysten's
+        // own integration tests at
+        // https://github.com/MystenLabs/ts-sdks/blob/main/packages/seal/test/unit/integration.test.ts
+        // Pulled 2026-05-08. Public, stable; not a secret.
+        sealKeyServers: [
+            {
+                objectId: "0x73d05d62c18d9374e3ea529e8e0ed6161da1a141a94d3f76ae3fe4e99356db75",
+                weight: 1,
+            },
+            {
+                objectId: "0xf5d14a81a982144ae441cd7d64b09027f116a468bd36e7eca494f750591623c8",
+                weight: 1,
+            },
+        ],
+        // Canonical Mysten-run Walrus testnet aggregator. Used by
+        // `HttpAggregatorReadAdapter.fromMorseConfig` for browser dapps that
+        // need a single CORS-friendly endpoint instead of the direct-protocol
+        // shard fanout (which has incomplete CORS coverage on testnet).
+        // Publisher is intentionally undefined — there is no single canonical
+        // testnet publisher; consumers wire their own (Nami, self-hosted, etc).
+        walrusEndpoints: {
+            aggregator: "https://aggregator.walrus-testnet.walrus.space",
+        },
+    },
+};
+/**
+ * Build a `NetworkConfig` pointing at the canonical Morse deployment for the
+ * chosen network, with optional per-field overrides for forks and local nodes.
+ * @throws {ConfigurationError} If the chosen network has no canonical deployment
+ *   and `packageId` and `registryId` are not supplied as overrides.
+ */
+export function morseConfig(options) {
+    const deployment = KNOWN_DEPLOYMENTS[options.network];
+    const packageId = options.packageId ?? deployment?.packageId;
+    const originalPackageId = options.originalPackageId ?? deployment?.originalPackageId;
+    const registryId = options.registryId ?? deployment?.registryId;
+    if (!packageId || !registryId) {
+        if (options.network === "mainnet") {
+            throw new ConfigurationError("Morse is not yet deployed on mainnet. Use { network: 'testnet' } or supply packageId, originalPackageId, and registryId for a custom deployment.");
+        }
+        throw new ConfigurationError(`No canonical Morse deployment for network "${options.network}". Supply packageId, originalPackageId, and registryId for a custom deployment.`);
+    }
+    return {
+        network: options.network,
+        rpcUrl: options.rpcUrl ?? DEFAULT_RPC_URLS[options.network],
+        packageId,
+        registryId,
+        ...(originalPackageId === undefined ? {} : { originalPackageId }),
+        sealKeyServers: options.sealKeyServers ?? deployment?.sealKeyServers ?? [],
+        walrusEndpoints: options.walrusEndpoints ??
+            deployment?.walrusEndpoints ?? { aggregator: "" },
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAGjD,UAAU;AAEV,8BAA8B;AAC9B,MAAM,CAAC,MAAM,OAAO,GAAG;IACtB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,UAAU;CACX,CAAC;AAGX,wBAAwB;AAExB,2FAA2F;AAC3F,MAAM,CAAC,MAAM,gBAAgB,GAAsC;IAClE,OAAO,EAAE,qCAAqC;IAC9C,OAAO,EAAE,qCAAqC;IAC9C,QAAQ,EAAE,uBAAuB;CACjC,CAAC;AAiEF,sBAAsB;AAEtB;;;;GAIG;AACH,MAAM,iBAAiB,GAWnB;IACH,OAAO,EAAE;QACR,SAAS,EAAE,WAAW,CACrB,oEAAoE,CACpE;QACD,iBAAiB,EAAE,WAAW,CAC7B,oEAAoE,CACpE;QACD,UAAU,EAAE,YAAY,CACvB,oEAAoE,CACpE;QACD,wEAAwE;QACxE,2BAA2B;QAC3B,8FAA8F;QAC9F,mDAAmD;QACnD,cAAc,EAAE;YACf;gBACC,QAAQ,EACP,oEAAoE;gBACrE,MAAM,EAAE,CAAC;aACT;YACD;gBACC,QAAQ,EACP,oEAAoE;gBACrE,MAAM,EAAE,CAAC;aACT;SACD;QACD,0DAA0D;QAC1D,qEAAqE;QACrE,sEAAsE;QACtE,gEAAgE;QAChE,sEAAsE;QACtE,wEAAwE;QACxE,eAAe,EAAE;YAChB,UAAU,EAAE,gDAAgD;SAC5D;KACD;CACD,CAAC;AAiBF;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,OAA2B;IACtD,MAAM,UAAU,GAAG,iBAAiB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACtD,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,UAAU,EAAE,SAAS,CAAC;IAC7D,MAAM,iBAAiB,GACtB,OAAO,CAAC,iBAAiB,IAAI,UAAU,EAAE,iBAAiB,CAAC;IAC5D,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,UAAU,EAAE,UAAU,CAAC;IAEhE,IAAI,CAAC,SAAS,IAAI,CAAC,UAAU,EAAE,CAAC;QAC/B,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YACnC,MAAM,IAAI,kBAAkB,CAC3B,kJAAkJ,CAClJ,CAAC;QACH,CAAC;QACD,MAAM,IAAI,kBAAkB,CAC3B,8CAA8C,OAAO,CAAC,OAAO,iFAAiF,CAC9I,CAAC;IACH,CAAC;IAED,OAAO;QACN,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,gBAAgB,CAAC,OAAO,CAAC,OAAO,CAAC;QAC3D,SAAS;QACT,UAAU;QACV,GAAG,CAAC,iBAAiB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,CAAC;QACjE,cAAc,EAAE,OAAO,CAAC,cAAc,IAAI,UAAU,EAAE,cAAc,IAAI,EAAE;QAC1E,eAAe,EAAE,OAAO,CAAC,eAAe;YACvC,UAAU,EAAE,eAAe,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE;KAClD,CAAC;AACH,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Error hierarchy. All errors extend `MorseError`; narrow subclasses via `instanceof`.
+ */
+/** Abstract base for every error thrown by the SDK. */
+export declare abstract class MorseError extends Error {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+/** Client-side precondition failed (malformed ID, invalid enum, etc). */
+export declare class ValidationError extends MorseError {
+    /** Name of the field or parameter that failed validation. */
+    readonly field: string;
+    constructor(message: string, field: string, options?: {
+        cause?: unknown;
+    });
+}
+export type NotFoundResource = "publication" | "collection" | "entry" | "revision" | "publisher-cap" | "owner-cap" | "registry" | "blob";
+/** Resource not found on-chain. */
+export declare class NotFoundError extends MorseError {
+    readonly resource: NotFoundResource;
+    readonly identifier: string;
+    constructor(resource: NotFoundResource, identifier: string, options?: {
+        cause?: unknown;
+    });
+}
+/** Authorization check failed client-side, before the transaction was submitted. */
+export declare class UnauthorizedError extends MorseError {
+}
+/** RPC transport, network, or response-parsing failure. Distinct from contract aborts. */
+export declare class TransportError extends MorseError {
+}
+/** SDK configuration gap (e.g. asking for a network with no canonical deployment). */
+export declare class ConfigurationError extends MorseError {
+}
+/**
+ * Thrown by `addEntryFromBytes` / `addEncryptedEntryFromBytes` when the
+ * register-and-upload step succeeded (the user already paid for storage and
+ * the bytes are on Walrus storage nodes) but the combined `certify_blob +
+ * add_entry` transaction failed (rejected popup, contract abort, network
+ * blip). The blob exists on Sui as an uncertified `Blob` object that is
+ * holding storage until either the consumer certifies it or the storage
+ * registration expires.
+ *
+ * Carries `blobObjectId` and `blobId` so the consumer can surface them to the
+ * user (e.g. "your upload was wasted; here is the blob id for support") or
+ * retry the flow with fresh bytes. The original failure is preserved as
+ * `cause`.
+ */
+export declare class UncertifiedBlobError extends MorseError {
+    readonly blobObjectId: string;
+    readonly blobId: string;
+    constructor(blobObjectId: string, blobId: string, options?: {
+        cause?: unknown;
+    });
+}
+/** Distinct failure modes Seal exposes to consumers. Narrow on `code`. */
+export type SealErrorCode = "no-access" | "decrypt-failed" | "session-expired" | "rate-limited";
+/**
+ * Seal encryption or decryption failed for a content reason (not transport).
+ * Use this to distinguish authorization gaps (`no-access`) from network
+ * blips (`TransportError`).
+ */
+export declare class SealError extends MorseError {
+    readonly code: SealErrorCode;
+    constructor(code: SealErrorCode, message: string, options?: {
+        cause?: unknown;
+    });
+}
+/** Move module whose abort codes the SDK knows about. */
+export type AbortModule = "publication" | "collection" | "entry";
+/** One row of the abort-code table. */
+export interface AbortEntry {
+    readonly name: string;
+    readonly description: string;
+}
+/**
+ * Move abort codes mirrored from `morse-contracts`. Structure: `ABORT_CODES[module][code]`.
+ * New abort constants in the Move package must be added here, or they surface as `UnknownAbort`.
+ */
+export declare const ABORT_CODES: {
+    readonly [M in AbortModule]: {
+        readonly [code: number]: AbortEntry;
+    };
+};
+/** Reason value used when a Move abort code is not in the SDK's table. */
+export declare const UNKNOWN_ABORT_NAME = "UnknownAbort";
+/** Move VM aborted during transaction execution. Narrow on `reason` (e.g. "EPublisherCapRevoked"). */
+export declare class ContractAbortError extends MorseError {
+    readonly module: AbortModule;
+    readonly abortCode: number;
+    readonly reason: string;
+    constructor(module: AbortModule, abortCode: number, reason: string, message: string, options?: {
+        cause?: unknown;
+    });
+    /** Build an error by looking up `(module, abortCode)` in the abort-code table. */
+    static fromAbortCode(module: AbortModule, abortCode: number, options?: {
+        cause?: unknown;
+    }): ContractAbortError;
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

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