@misofm/sdk 0.7.1 → 0.8.1

package/dist/index.js

@@ -25,7 +25,8 @@
 // off it is business logic, and business logic ships from the platform package.
 // The recommended entry point is the client extension (see ./client.ts); the bare
 // builders and readers stay exported for callers that hold ids themselves.
-export { misoPlatform, MisoPlatformClient } from "./client.js";
+export { miso, misoPlatform, MisoClient, MisoPlatformClient } from "./client.js";
+export * from "./deployments.js";
 export * from "./pressing.js";
 export * from "./transactions.js";
 export * from "./execute.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,sCAAsC;AAEtC,sCAAsC;AACtC,EAAE;AACF,6EAA6E;AAC7E,oEAAoE;AACpE,EAAE;AACF,+EAA+E;AAC/E,oFAAoF;AACpF,8EAA8E;AAC9E,4EAA4E;AAC5E,kEAAkE;AAClE,EAAE;AACF,6EAA6E;AAC7E,iFAAiF;AACjF,iFAAiF;AACjF,gFAAgF;AAChF,kFAAkF;AAClF,EAAE;AACF,gFAAgF;AAChF,6EAA6E;AAC7E,gFAAgF;AAChF,gFAAgF;AAChF,iFAAiF;AACjF,gFAAgF;AAEhF,kFAAkF;AAClF,2EAA2E;AAC3E,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAE/D,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAE7B,6EAA6E;AAC7E,+EAA+E;AAC/E,oEAAoE;AACpE,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC;AAExC,yEAAyE;AACzE,kBAAkB;AAClB,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,8BAA8B,CAAC;AAE7C,sEAAsE;AACtE,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,sCAAsC;AAEtC,sCAAsC;AACtC,EAAE;AACF,6EAA6E;AAC7E,oEAAoE;AACpE,EAAE;AACF,+EAA+E;AAC/E,oFAAoF;AACpF,8EAA8E;AAC9E,4EAA4E;AAC5E,kEAAkE;AAClE,EAAE;AACF,6EAA6E;AAC7E,iFAAiF;AACjF,iFAAiF;AACjF,gFAAgF;AAChF,kFAAkF;AAClF,EAAE;AACF,gFAAgF;AAChF,6EAA6E;AAC7E,gFAAgF;AAChF,gFAAgF;AAChF,iFAAiF;AACjF,gFAAgF;AAEhF,kFAAkF;AAClF,2EAA2E;AAC3E,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAMjF,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAE7B,6EAA6E;AAC7E,+EAA+E;AAC/E,oEAAoE;AACpE,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC;AAExC,yEAAyE;AACzE,kBAAkB;AAClB,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,8BAA8B,CAAC;AAE7C,sEAAsE;AACtE,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC"}

package/dist/read/config.d.ts

@@ -1,5 +1,5 @@
 export type Network = "testnet" | "mainnet";
-/** Anything but "mainnet" — including unset — is testnet. Mirrors miso-api's `networkFromEnv`. */
+/** Missing defaults to Testnet for local development; invalid values fail closed. */
 export declare function networkFrom(value: string | undefined): Network;
 /** Package ids for the miso protocol core and the extensions the read layer touches. */
 export interface ProtocolIds {
@@ -11,6 +11,9 @@ export interface ProtocolIds {
     record: string;
     /** `miso_record` shared `Settings` object — the mint witness authorizer. */
     recordSettings: string;
+    /** Release coordinator package and its shared derivation-parent object. */
+    releaseRegistry: string;
+    releaseRegistryId: string;
     /** `release_cover_art` — the release cover extension. */
     releaseCoverArt: string;
     /** `composition_credits` / `recording_credits` / `release_credits` extensions. */

package/dist/read/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/read/config.ts"],"names":[],"mappings":"AAYA,MAAM,MAAM,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;AAE5C,kGAAkG;AAClG,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAE9D;AAED,wFAAwF;AACxF,MAAM,WAAW,WAAW;IAC1B,kGAAkG;IAClG,IAAI,EAAE,MAAM,CAAC;IACb,gFAAgF;IAChF,IAAI,EAAE,MAAM,CAAC;IACb,mFAAmF;IACnF,MAAM,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,cAAc,EAAE,MAAM,CAAC;IACvB,yDAAyD;IACzD,eAAe,EAAE,MAAM,CAAC;IACxB,kFAAkF;IAClF,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,mFAAmF;IACnF,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,oFAAoF;AACpF,MAAM,WAAW,QAAQ;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,0BAA0B,EAAE,MAAM,CAAC;IACnC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,0BAA0B,EAAE,MAAM,CAAC;IACnC,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,gFAAgF;AAChF,MAAM,WAAW,QAAQ;IACvB,mEAAmE;IACnE,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,WAAW,CAAC;IACtB,KAAK,EAAE,QAAQ,CAAC;IAChB,KAAK,EAAE,QAAQ,CAAC;IAChB,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,4EAA4E;IAC5E,mBAAmB,EAAE,MAAM,CAAC;IAC5B;;;;OAIG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,qGAAqG;IACrG,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC;AAcD,4FAA4F;AAC5F,MAAM,MAAM,mBAAmB,GAAG,OAAO,CACvC,IAAI,CAAC,UAAU,EAAE,SAAS,GAAG,YAAY,GAAG,qBAAqB,GAAG,YAAY,GAAG,oBAAoB,CAAC,CACzG,CAAC;AAEF;;;GAGG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,GAAE,mBAAwB,GAAG,UAAU,CAO5F"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/read/config.ts"],"names":[],"mappings":"AAcA,MAAM,MAAM,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;AAE5C,qFAAqF;AACrF,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAI9D;AAED,wFAAwF;AACxF,MAAM,WAAW,WAAW;IAC1B,kGAAkG;IAClG,IAAI,EAAE,MAAM,CAAC;IACb,gFAAgF;IAChF,IAAI,EAAE,MAAM,CAAC;IACb,mFAAmF;IACnF,MAAM,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,cAAc,EAAE,MAAM,CAAC;IACvB,2EAA2E;IAC3E,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,yDAAyD;IACzD,eAAe,EAAE,MAAM,CAAC;IACxB,kFAAkF;IAClF,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,mFAAmF;IACnF,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,oFAAoF;AACpF,MAAM,WAAW,QAAQ;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,0BAA0B,EAAE,MAAM,CAAC;IACnC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,0BAA0B,EAAE,MAAM,CAAC;IACnC,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,gFAAgF;AAChF,MAAM,WAAW,QAAQ;IACvB,mEAAmE;IACnE,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,WAAW,CAAC;IACtB,KAAK,EAAE,QAAQ,CAAC;IAChB,KAAK,EAAE,QAAQ,CAAC;IAChB,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,4EAA4E;IAC5E,mBAAmB,EAAE,MAAM,CAAC;IAC5B;;;;OAIG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,qGAAqG;IACrG,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC;AA8BD,4FAA4F;AAC5F,MAAM,MAAM,mBAAmB,GAAG,OAAO,CACvC,IAAI,CAAC,UAAU,EAAE,SAAS,GAAG,YAAY,GAAG,qBAAqB,GAAG,YAAY,GAAG,oBAAoB,CAAC,CACzG,CAAC;AAEF;;;GAGG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,GAAE,mBAAwB,GAAG,UAAU,CAO5F"}

package/dist/read/config.js

@@ -7,30 +7,51 @@
 // `lib/money.ts`, `lib/drops.ts`) lives here instead, so a redeploy is a change
 // in ONE file that every surface picks up.
 //
-// Both networks stay unavailable until the fresh protocol publish is configured;
-// pre-launch has no compatibility lane for the old deployment.
-/** Anything but "mainnet" — including unset — is testnet. Mirrors miso-api's `networkFromEnv`. */
+// Testnet values are baked from the verified 2026-08-19 deployment. Mainnet is
+// deliberately unavailable until this ABI is deployed there.
+import { MISO_PLATFORM_DEPLOYMENTS } from "../deployments.js";
+/** Missing defaults to Testnet for local development; invalid values fail closed. */
 export function networkFrom(value) {
-    return value === "mainnet" ? "mainnet" : "testnet";
+    if (value === undefined || value === "testnet")
+        return "testnet";
+    if (value === "mainnet")
+        return "mainnet";
+    throw new Error(`@misofm/sdk/read: unsupported network "${value}".`);
 }
-// TODO(publish): replace this guard with a fresh `TESTNET: MisoConfig` after
-// republishing every protocol package. Set every `protocol` package/object id
-// from that publish; do not reuse any id from the retired deployment.
-// TODO(publish): set `protocol.record` to the fresh `miso_record` package id;
-// it is distinct from the `protocol.recordSettings` shared object id.
-// TODO(publish): at the `ProtocolIds` declaration above, add `releaseRegistry`
-// and `releaseRegistryId`; set the latter from
-// `ReleaseRegistryCreatedEvent.registry_id` in the release_registry publish tx.
-// TODO(publish): recreate Discover content under the fresh packages, then add
-// only those release ids to `discoverReleaseIds`.
-const TESTNET = null;
+const TESTNET = {
+    network: "testnet",
+    protocol: {
+        miso: MISO_PLATFORM_DEPLOYMENTS.testnet.protocol.packageId,
+        drop: MISO_PLATFORM_DEPLOYMENTS.testnet.packages.drop,
+        record: MISO_PLATFORM_DEPLOYMENTS.testnet.packages.record,
+        recordSettings: MISO_PLATFORM_DEPLOYMENTS.testnet.objects.recordSettings,
+        releaseRegistry: MISO_PLATFORM_DEPLOYMENTS.testnet.packages.releaseRegistry,
+        releaseRegistryId: MISO_PLATFORM_DEPLOYMENTS.testnet.objects.releaseRegistry,
+        releaseCoverArt: MISO_PLATFORM_DEPLOYMENTS.testnet.packages.releaseCoverArt,
+        compositionCredits: MISO_PLATFORM_DEPLOYMENTS.testnet.packages.compositionCredits,
+        recordingCredits: MISO_PLATFORM_DEPLOYMENTS.testnet.packages.recordingCredits,
+        releaseCredits: MISO_PLATFORM_DEPLOYMENTS.testnet.packages.releaseCredits,
+        credit: MISO_PLATFORM_DEPLOYMENTS.testnet.packages.credit,
+    },
+    party: MISO_PLATFORM_DEPLOYMENTS.testnet.party,
+    money: {
+        usdCoinType: "0x77774cb7b8cb5622b4ef2658101bf5f1e965418297fe874b683df8f760b6e749::fakeusd::FakeUsd",
+        usdDecimals: 6,
+    },
+    grpcUrl: "https://fullnode.testnet.sui.io",
+    graphqlUrl: "https://graphql.testnet.sui.io/graphql",
+    walrusAggregatorUrl: "https://aggregator.walrus-testnet.walrus.space",
+    apiBaseUrl: "https://api.testnet.miso.fm",
+    // Content from the retired deployment is intentionally not carried forward.
+    discoverReleaseIds: [],
+};
 /**
  * The config for `network`. Mainnet throws until its packages are deployed and
  * filled in here — a mainnet worker must fail loudly, never read testnet ids.
  */
 export function misoConfig(network, overrides = {}) {
-    if (network === "mainnet" || !TESTNET) {
-        throw new Error("@misofm/sdk/read: no fresh deployment configuration yet. Publish the protocol packages, then fill in src/read/config.ts.");
+    if (network === "mainnet") {
+        throw new Error(`@misofm/sdk/read: no bundled Miso platform deployment for network "${network}".`);
     }
     return { ...TESTNET, ...stripUndefined(overrides) };
 }

package/dist/read/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/read/config.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,sCAAsC;AACtC,EAAE;AACF,iFAAiF;AACjF,+EAA+E;AAC/E,yEAAyE;AACzE,gFAAgF;AAChF,2CAA2C;AAC3C,EAAE;AACF,iFAAiF;AACjF,+DAA+D;AAI/D,kGAAkG;AAClG,MAAM,UAAU,WAAW,CAAC,KAAyB;IACnD,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;AACrD,CAAC;AAyED,6EAA6E;AAC7E,8EAA8E;AAC9E,sEAAsE;AACtE,8EAA8E;AAC9E,sEAAsE;AACtE,+EAA+E;AAC/E,+CAA+C;AAC/C,gFAAgF;AAChF,8EAA8E;AAC9E,kDAAkD;AAClD,MAAM,OAAO,GAAsB,IAAI,CAAC;AAOxC;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,OAAgB,EAAE,YAAiC,EAAE;IAC9E,IAAI,OAAO,KAAK,SAAS,IAAI,CAAC,OAAO,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CACb,0HAA0H,CAC3H,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,GAAG,OAAO,EAAE,GAAG,cAAc,CAAC,SAAS,CAAC,EAAE,CAAC;AACtD,CAAC;AAED,sEAAsE;AACtE,SAAS,cAAc,CAAmB,CAAI;IAC5C,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAe,CAAC;AAChG,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/read/config.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,sCAAsC;AACtC,EAAE;AACF,iFAAiF;AACjF,+EAA+E;AAC/E,yEAAyE;AACzE,gFAAgF;AAChF,2CAA2C;AAC3C,EAAE;AACF,+EAA+E;AAC/E,6DAA6D;AAE7D,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAI9D,qFAAqF;AACrF,MAAM,UAAU,WAAW,CAAC,KAAyB;IACnD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACjE,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,MAAM,IAAI,KAAK,CAAC,0CAA0C,KAAK,IAAI,CAAC,CAAC;AACvE,CAAC;AA4ED,MAAM,OAAO,GAAe;IAC1B,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE;QACR,IAAI,EAAE,yBAAyB,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS;QAC1D,IAAI,EAAE,yBAAyB,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI;QACrD,MAAM,EAAE,yBAAyB,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM;QACzD,cAAc,EAAE,yBAAyB,CAAC,OAAO,CAAC,OAAO,CAAC,cAAc;QACxE,eAAe,EAAE,yBAAyB,CAAC,OAAO,CAAC,QAAQ,CAAC,eAAe;QAC3E,iBAAiB,EAAE,yBAAyB,CAAC,OAAO,CAAC,OAAO,CAAC,eAAe;QAC5E,eAAe,EAAE,yBAAyB,CAAC,OAAO,CAAC,QAAQ,CAAC,eAAe;QAC3E,kBAAkB,EAAE,yBAAyB,CAAC,OAAO,CAAC,QAAQ,CAAC,kBAAkB;QACjF,gBAAgB,EAAE,yBAAyB,CAAC,OAAO,CAAC,QAAQ,CAAC,gBAAgB;QAC7E,cAAc,EAAE,yBAAyB,CAAC,OAAO,CAAC,QAAQ,CAAC,cAAc;QACzE,MAAM,EAAE,yBAAyB,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM;KAC1D;IACD,KAAK,EAAE,yBAAyB,CAAC,OAAO,CAAC,KAAK;IAC9C,KAAK,EAAE;QACL,WAAW,EAAE,sFAAsF;QACnG,WAAW,EAAE,CAAC;KACf;IACD,OAAO,EAAE,iCAAiC;IAC1C,UAAU,EAAE,wCAAwC;IACpD,mBAAmB,EAAE,gDAAgD;IACrE,UAAU,EAAE,6BAA6B;IACzC,4EAA4E;IAC5E,kBAAkB,EAAE,EAAE;CACvB,CAAC;AAOF;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,OAAgB,EAAE,YAAiC,EAAE;IAC9E,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CACb,sEAAsE,OAAO,IAAI,CAClF,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,GAAG,OAAO,EAAE,GAAG,cAAc,CAAC,SAAS,CAAC,EAAE,CAAC;AACtD,CAAC;AAED,sEAAsE;AACtE,SAAS,cAAc,CAAmB,CAAI;IAC5C,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAe,CAAC;AAChG,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@misofm/sdk",
-  "version": "0.7.1",
-  "description": "Complete client SDK for the Miso platform on Sui \u2014 high-level reads, pressings, listings, records, and work publishing.",
+  "version": "0.8.1",
+  "description": "Complete client SDK for the Miso platform on Sui — high-level reads, pressings, listings, records, and work publishing.",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -36,6 +36,10 @@
       "types": "./dist/client.d.ts",
       "default": "./dist/client.js"
     },
+    "./deployments": {
+      "types": "./dist/deployments.d.ts",
+      "default": "./dist/deployments.js"
+    },
     "./pressing": {
       "types": "./dist/pressing.d.ts",
       "default": "./dist/pressing.js"
@@ -122,7 +126,7 @@
   },
   "dependencies": {
     "@misonetwork/miso-party": "^0.2.0",
-    "@misonetwork/sdk": "^0.5.0"
+    "@misonetwork/sdk": "^0.6.0"
   },
   "main": "./dist/index.js"
 }

package/src/client.ts

@@ -5,11 +5,11 @@
 // (https://sdk.mystenlabs.com/sui/sdk-building). Register it once and the
 // platform layer hangs off whatever client you already have:
 //
-//   const client = new SuiGrpcClient({ network, baseUrl })
-//     .$extend(misoPlatform({ packageId, settingsId }));
+//   const client = new SuiGrpcClient({ network, baseUrl }).$extend(miso());
 //
-//   await client.misoPlatform.getSale({ releaseId, currencyType });
-//   tx.add(client.misoPlatform.tx.buyRecord({ releaseId, currencyType, amount, recipient }));
+//   await client.miso.getSale({ releaseId, currencyType });
+//   await client.miso.protocol.getReleaseById(releaseId);
+//   tx.add(client.miso.tx.buyRecord({ releaseId, currencyType, amount, recipient }));
 //
 // Two things this buys over calling the bare functions:
 //
@@ -26,8 +26,16 @@
 // `tx` builds transactions without executing, `bcs` exposes the generated struct
 // definitions, `ids` is the address math that replaces a registry.
 
-import type { ClientWithCoreApi } from "@mysten/sui/client";
+import type {
+  ClientWithCoreApi,
+  SuiClientRegistration,
+} from "@mysten/sui/client";
 import type { Signer } from "@mysten/sui/cryptography";
+import type { SuiGraphQLClient } from "@mysten/sui/graphql";
+import {
+  miso as protocolMiso,
+  type MisoProtocolClient,
+} from "@misonetwork/sdk/client";
 
 import * as listingContract from "./contracts/miso_pressing/listing.ts";
 import * as pressingContract from "./contracts/miso_pressing/pressing.ts";
@@ -74,6 +82,36 @@ import type {
   PublishReleaseParams,
 } from "./transactions.ts";
 import * as share from "./share.ts";
+import {
+  publishReleaseGraph,
+  type PublishReleaseGraphParams,
+} from "./release-graph.ts";
+import {
+  getMisoPlatformDeployment,
+  type MisoPlatformDeployment,
+} from "./deployments.ts";
+
+/** Defaults `options.package` to `pkg` for every generated call function. */
+function bindModulePackage<M extends object>(mod: M, pkg: string): M {
+  const out: Record<string, unknown> = {};
+  for (const [key, value] of Object.entries({ ...mod })) {
+    out[key] =
+      typeof value === "function"
+        ? (options: { package?: string }) =>
+            (value as (o: unknown) => unknown)({ package: pkg, ...options })
+        : value;
+  }
+  return out as M;
+}
+
+export interface MisoOptions<Name extends string = "miso"> {
+  /** Name for the client extension. Defaults to `miso`. */
+  name?: Name;
+  /** Complete custom deployment; omit to select the bundled client network. */
+  deployment?: MisoPlatformDeployment;
+  /** Required only by protocol methods that perform global type discovery. */
+  graphqlClient?: SuiGraphQLClient;
+}
 
 export interface MisoPlatformConfig {
   /** The published `miso_pressing` package. */
@@ -111,13 +149,36 @@ type ConfiguredPublish<T> = Omit<T, "misoPackageId" | "minatoPackageId">;
 /** Release-builder params with this client's core, share, and registry ids dropped. */
 type ConfiguredRelease<T> = Omit<T, "misoPackageId" | "minatoPackageId" | "releaseRegistryPackageId" | "releaseRegistryId">;
 
+/** Whole-graph params with this client's package ids dropped. */
+export type ConfiguredReleaseGraphParams = Omit<
+  PublishReleaseGraphParams,
+  "misoPackageId" | "minatoPackageId" | "releaseRegistryPackageId"
+>;
+
 export class MisoPlatformClient {
   readonly #client: ClientWithCoreApi;
   readonly #config: MisoPlatformConfig;
+  /** The permissionless protocol layer wrapped by this platform facade. */
+  readonly protocol: MisoProtocolClient;
+  /** Bundled/custom deployment selected for the full facade, when available. */
+  readonly deployment?: MisoPlatformDeployment;
 
-  constructor(client: ClientWithCoreApi, config: MisoPlatformConfig) {
+  constructor(
+    client: ClientWithCoreApi,
+    config: MisoPlatformConfig,
+    protocol?: MisoProtocolClient,
+    deployment?: MisoPlatformDeployment,
+  ) {
     this.#client = client;
     this.#config = config;
+    this.protocol =
+      protocol ??
+      protocolMiso({
+        deployment: config.misoPackageId
+          ? { packageId: config.misoPackageId }
+          : undefined,
+      }).register(client);
+    this.deployment = deployment;
   }
 
   get packageId(): string {
@@ -240,6 +301,15 @@ export class MisoPlatformClient {
         releaseRegistryId: registry.id,
       });
     },
+    publishReleaseGraph: (p: ConfiguredReleaseGraphParams): TxThunk => {
+      const registry = this.#releaseRegistry();
+      return publishReleaseGraph({
+        ...p,
+        misoPackageId: this.#misoPackageId(),
+        minatoPackageId: this.#minatoPackageId(),
+        releaseRegistryPackageId: registry.packageId,
+      });
+    },
   };
 
   // ── Share currency provisioning (executes; Signer pattern) ─────────────────
@@ -252,7 +322,18 @@ export class MisoPlatformClient {
   // ── Generated layer ───────────────────────────────────────────────────────
 
   /** Generated Move-call bindings, for commands this facade doesn't wrap. */
-  readonly call = { listing: listingContract, pressing: pressingContract, releaseRegistry };
+  get call() {
+    return {
+      listing: bindModulePackage(listingContract, this.packageId),
+      pressing: bindModulePackage(pressingContract, this.packageId),
+      releaseRegistry: this.#config.releaseRegistryPackageId
+        ? bindModulePackage(
+            releaseRegistry,
+            this.#config.releaseRegistryPackageId,
+          )
+        : releaseRegistry,
+    };
+  }
 
   /** Generated BCS definitions, for parsing objects or events yourself. */
   readonly bcs = {
@@ -265,8 +346,48 @@ export class MisoPlatformClient {
   };
 }
 
+/** The full Miso client exposed by `@misofm/sdk`. */
+export { MisoPlatformClient as MisoClient };
+
+/**
+ * Registers the complete Miso facade at `client.miso`.
+ *
+ * Platform operations live directly on `client.miso`; the lower-level
+ * permissionless protocol SDK is available at `client.miso.protocol`.
+ */
+export function miso<const Name extends string = "miso">(
+  options: MisoOptions<Name> = {},
+): SuiClientRegistration<ClientWithCoreApi, Name, MisoPlatformClient> {
+  const name = (options.name ?? "miso") as Name;
+  return {
+    name,
+    register: (client: ClientWithCoreApi) => {
+      const deployment =
+        options.deployment ?? getMisoPlatformDeployment(client.network);
+      const protocol = protocolMiso({
+        deployment: deployment.protocol,
+        graphqlClient: options.graphqlClient,
+      }).register(client);
+      return new MisoPlatformClient(
+        client,
+        {
+          packageId: deployment.packages.pressing,
+          settingsId: deployment.objects.recordSettings,
+          misoPackageId: deployment.protocol.packageId,
+          minatoPackageId: deployment.packages.minato,
+          releaseRegistryPackageId: deployment.packages.releaseRegistry,
+          releaseRegistryId: deployment.objects.releaseRegistry,
+        },
+        protocol,
+        deployment,
+      );
+    },
+  };
+}
+
 /**
- * Registers the platform layer on a Sui client. Pass the result to `$extend`.
+ * @deprecated Prefer zero-config `miso()`, which registers the complete facade
+ * at `client.miso` and exposes the protocol layer at `client.miso.protocol`.
  *
  * `settingsId` is optional so a read-only client (an indexer, a catalog page) can
  * skip it; asking to build a purchase without it throws rather than sending a
@@ -275,6 +396,15 @@ export class MisoPlatformClient {
 export function misoPlatform(config: MisoPlatformConfig) {
   return {
     name: "misoPlatform" as const,
-    register: (client: ClientWithCoreApi) => new MisoPlatformClient(client, config),
+    register: (client: ClientWithCoreApi) => {
+      const protocol = protocolMiso({
+        deployment: config.misoPackageId
+          ? {
+              packageId: config.misoPackageId,
+            }
+          : undefined,
+      }).register(client);
+      return new MisoPlatformClient(client, config, protocol);
+    },
   };
 }

package/src/deployments.ts

@@ -0,0 +1,168 @@
+// Copyright (c) Miso Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
+import {
+  MISO_PROTOCOL_DEPLOYMENTS,
+  type MisoNetwork,
+  type MisoProtocolDeployment,
+} from "@misonetwork/sdk/deployments";
+
+/** Complete on-chain identity used by the Miso platform SDK on one network. */
+export interface MisoPlatformDeployment {
+  /** The protocol deployment this platform deployment was built against. */
+  readonly protocol: MisoProtocolDeployment;
+  readonly packages: {
+    readonly pressing: string;
+    readonly record: string;
+    readonly releaseRegistry: string;
+    readonly minato: string;
+    readonly drop: string;
+    readonly credit: string;
+    readonly compositionCredits: string;
+    readonly recordingCredits: string;
+    readonly releaseCredits: string;
+    /** Base royalty-pool value library. */
+    readonly royaltyPool: string;
+    /** Composition royalty-pool extension. */
+    readonly compositionRoyaltyPool: string;
+    /** Recording royalty-pool extension. */
+    readonly recordingRoyaltyPool: string;
+    /** Cover-art value type used by the release cover extension. */
+    readonly coverArt: string;
+    readonly releaseCoverArt: string;
+    /** External `ori::walrus_data::WalrusData` dependency used by cover art. */
+    readonly ori: string;
+  };
+  readonly objects: {
+    readonly recordSettings: string;
+    readonly releaseRegistry: string;
+  };
+  /** PartyOS packages used by the composed artist and wallet reads. */
+  readonly party: {
+    readonly partyPackageId: string;
+    readonly partyProfilePackageId: string;
+    readonly countryCodePackageId: string;
+    readonly languageCodePackageId: string;
+    readonly partyMediaPackageId: string;
+    readonly partyRolesPackageId: string;
+    readonly partyTagsPackageId: string;
+    readonly partyGenrePackageId: string;
+    readonly partyCtaPackageId: string;
+    readonly partyPlatformLinkPackageId: string;
+    readonly partySocialPackageId: string;
+    readonly partyMusicPackageId: string;
+    readonly partyProLinkPackageId: string;
+    readonly partyFeaturedDropPackageId: string;
+    readonly genrePackageId: string;
+  };
+  readonly legacy: {
+    readonly releaseCoverArtPackages: readonly string[];
+  };
+}
+
+/**
+ * Platform deployments bundled with this SDK release.
+ *
+ * Mainnet is intentionally absent until the complete platform stack is live.
+ * Mainnet is intentionally unavailable until this ABI is deployed there.
+ */
+export const MISO_PLATFORM_DEPLOYMENTS = {
+  testnet: {
+    protocol: MISO_PROTOCOL_DEPLOYMENTS.testnet,
+    packages: {
+      pressing:
+        "0xd0913b584d87a3891a8013c58644e3896f438fd948e819a69db256b47314974e",
+      record:
+        "0x97e2772d81528c69e21b6681f6702f90deae2a6b079e19da1df53f9f4fdd3271",
+      releaseRegistry:
+        "0x683b2feb784a815171d2976418345bd41c046e159dcf7a16890c766f69fd7808",
+      minato:
+        "0x8466e9864c1d947888e73b0e349b035bc22805579eef18f132966f56c8efe1d2",
+      drop:
+        "0xfc2b51f068dee9d5482d39fa017164f6a8c3601cabb59084a518de5f609ef1c7",
+      credit:
+        "0x0121926470393cc93b89b5b6d5067737a8bc0c1c545fb96c4447569174116174",
+      compositionCredits:
+        "0xfa2f62db28f2eb42c8c1a6533097fb2095649efab05c0527be1874b9be6cdc73",
+      recordingCredits:
+        "0xc794252bd90efb4cc224107f9dd0a56d4f4f5623783628b6af286f6535dd4c1e",
+      releaseCredits:
+        "0x42e2dbf6098d18782911460ecf79b338af2f1b654ef7ba99c6e7344fd4bf3f94",
+      royaltyPool:
+        "0x798fb353a5dbed51a0df08a7c10fdc432a11d60b55e016102ca635f9033c654d",
+      compositionRoyaltyPool:
+        "0xc22693ec50312492d7da23f3544625df637a92cd2be08e09d0f2eb8ff4e0e7ac",
+      recordingRoyaltyPool:
+        "0x33c9149889ef9e8078a5eba5c5486e8938e2dc69b3bd49a45c5c57e9f3d898a8",
+      coverArt:
+        "0xb29052d1174835a8061149aeca08f53551fa0691de64350247fc5cb558f797a0",
+      releaseCoverArt:
+        "0x831a612920343696de7e8f0603ff4c0b21c43ca3de478feb96d230e263cd11d4",
+      ori:
+        "0x340057f2174fb59e4626742dd2b46c662237837b6187450cb59e4976ce7eac78",
+    },
+    objects: {
+      recordSettings:
+        "0x6a005dad071562d421ad7a9d368289f5c9f0408ca495cd466a1f774d65a21fa7",
+      releaseRegistry:
+        "0x5941b8690916e762a7583363906496d64a6ea3e6cedb078c90e23e7c671544f2",
+    },
+    party: {
+      partyPackageId:
+        "0x09a812d46c3aa3978703c8e5a7409ba67b9ba2dfdb91154e48ebdd9d2415da0c",
+      partyProfilePackageId:
+        "0xce89d3f993dfebc0b697388598c3b01e9db7b73fa2e8df18ed22608cf7ac5aee",
+      countryCodePackageId:
+        "0x6c3a53f228ccd089825d0fb5ee1f0465a4b7a438bc1b1735b4e2f01df8d056e9",
+      languageCodePackageId:
+        "0xa18b786807cfc45488691f93aa647800b77cf9993e420d110afd7024c5b15948",
+      partyMediaPackageId:
+        "0x7db56ef37692f84c1cfb0e0b26bde35ac9f1bc0bcd91ac5d24b3f8b4d1821349",
+      partyRolesPackageId:
+        "0x41a442a2c39368af2181e73ea5b90e2e0b4f89de09050c121a6e7d79e7c84415",
+      partyTagsPackageId:
+        "0xa4c7f6b05bb9b612ea7640974c150ce31ad7927ea82d3f9f4673acac7deef0da",
+      partyGenrePackageId:
+        "0x6ce063438be6cf44ccf5f17bf8892c9e0cef4e2344442aeb44412beead74d3a8",
+      partyCtaPackageId:
+        "0x85a312210d9ddbae535e0f933032c8a56aa3f0fe1d6c3430d4fa538765008da3",
+      partyPlatformLinkPackageId:
+        "0x46d9f3e05d2065a926b010fe833baf61e5c250c233d512a260cbe746b02c56af",
+      partySocialPackageId:
+        "0x438e767ce8f5699f12be1704a12ff69c28045ca241f890ca8a978d55e09f6541",
+      partyMusicPackageId:
+        "0x89add347dfa779aa77e21b1853a37f2054dbecfce29799b61463d9900877b7b1",
+      partyProLinkPackageId:
+        "0xe5e8a0d02b43037abb7e6ddb4b742c6197aadf2dc19910957bba98307bef4103",
+      partyFeaturedDropPackageId:
+        "0x1a7b926686565a6cc82a9e0630839dc1f75c9bf4fafc0ba789a05af2c3c269f0",
+      genrePackageId:
+        "0xcbbce10e8b0781d458e88ce99d08e0c85f1e674c5b7ec975383d74f87a1d76b1",
+    },
+    legacy: {
+      releaseCoverArtPackages: [
+        "0x25c3c87ef4823d62d80dd8bda714ef4976df0f04453997646659a6cebadd655b",
+        "0x1ee2cae0da7595d7973c310c912434ef531589b468cc57839296810c1385f7f6",
+        "0x7d4a205a68f8e768a408c9f4c45a4d4076722c5edeba9068c0ac058f554e964e",
+      ],
+    },
+  },
+} as const satisfies Partial<Record<MisoNetwork, MisoPlatformDeployment>>;
+
+/** Resolve a bundled platform deployment, failing closed when it is unavailable. */
+export function getMisoPlatformDeployment(
+  network: string,
+): MisoPlatformDeployment {
+  const deployment = (
+    MISO_PLATFORM_DEPLOYMENTS as Partial<
+      Record<string, MisoPlatformDeployment>
+    >
+  )[network];
+  if (!deployment) {
+    throw new Error(
+      `@misofm/sdk: no bundled Miso platform deployment for network "${network}". ` +
+        "Pass an explicit deployment to miso() for custom networks.",
+    );
+  }
+  return deployment;
+}

package/src/execute.ts

@@ -13,6 +13,11 @@ import type { SuiClientTypes } from "@mysten/sui/client";
 import { buildTx, toExecResult, FULL_INCLUDE, type ExecResult } from "@misonetwork/sdk";
 import type { TxThunk } from "./transactions.ts";
 
+// Consumers of the platform SDK should not need a second direct dependency on
+// the protocol SDK just to execute a composed PTB. Keep the generic execution
+// surface available through this platform-layer entry point as well.
+export * from "@misonetwork/sdk/execute";
+
 type FullInclude = typeof FULL_INCLUDE;
 
 /**

package/src/index.ts

@@ -27,8 +27,13 @@
 
 // The recommended entry point is the client extension (see ./client.ts); the bare
 // builders and readers stay exported for callers that hold ids themselves.
-export { misoPlatform, MisoPlatformClient } from "./client.ts";
-export type { MisoPlatformConfig } from "./client.ts";
+export { miso, misoPlatform, MisoClient, MisoPlatformClient } from "./client.ts";
+export type {
+  ConfiguredReleaseGraphParams,
+  MisoOptions,
+  MisoPlatformConfig,
+} from "./client.ts";
+export * from "./deployments.ts";
 export * from "./pressing.ts";
 export * from "./transactions.ts";
 export * from "./execute.ts";

package/src/read/config.ts

@@ -7,14 +7,18 @@
 // `lib/money.ts`, `lib/drops.ts`) lives here instead, so a redeploy is a change
 // in ONE file that every surface picks up.
 //
-// Both networks stay unavailable until the fresh protocol publish is configured;
-// pre-launch has no compatibility lane for the old deployment.
+// Testnet values are baked from the verified 2026-08-19 deployment. Mainnet is
+// deliberately unavailable until this ABI is deployed there.
+
+import { MISO_PLATFORM_DEPLOYMENTS } from "../deployments.ts";
 
 export type Network = "testnet" | "mainnet";
 
-/** Anything but "mainnet" — including unset — is testnet. Mirrors miso-api's `networkFromEnv`. */
+/** Missing defaults to Testnet for local development; invalid values fail closed. */
 export function networkFrom(value: string | undefined): Network {
-  return value === "mainnet" ? "mainnet" : "testnet";
+  if (value === undefined || value === "testnet") return "testnet";
+  if (value === "mainnet") return "mainnet";
+  throw new Error(`@misofm/sdk/read: unsupported network "${value}".`);
 }
 
 /** Package ids for the miso protocol core and the extensions the read layer touches. */
@@ -27,6 +31,9 @@ export interface ProtocolIds {
   record: string;
   /** `miso_record` shared `Settings` object — the mint witness authorizer. */
   recordSettings: string;
+  /** Release coordinator package and its shared derivation-parent object. */
+  releaseRegistry: string;
+  releaseRegistryId: string;
   /** `release_cover_art` — the release cover extension. */
   releaseCoverArt: string;
   /** `composition_credits` / `recording_credits` / `release_credits` extensions. */
@@ -88,17 +95,33 @@ export interface MisoConfig {
   discoverReleaseIds: readonly string[];
 }
 
-// TODO(publish): replace this guard with a fresh `TESTNET: MisoConfig` after
-// republishing every protocol package. Set every `protocol` package/object id
-// from that publish; do not reuse any id from the retired deployment.
-// TODO(publish): set `protocol.record` to the fresh `miso_record` package id;
-// it is distinct from the `protocol.recordSettings` shared object id.
-// TODO(publish): at the `ProtocolIds` declaration above, add `releaseRegistry`
-// and `releaseRegistryId`; set the latter from
-// `ReleaseRegistryCreatedEvent.registry_id` in the release_registry publish tx.
-// TODO(publish): recreate Discover content under the fresh packages, then add
-// only those release ids to `discoverReleaseIds`.
-const TESTNET: MisoConfig | null = null;
+const TESTNET: MisoConfig = {
+  network: "testnet",
+  protocol: {
+    miso: MISO_PLATFORM_DEPLOYMENTS.testnet.protocol.packageId,
+    drop: MISO_PLATFORM_DEPLOYMENTS.testnet.packages.drop,
+    record: MISO_PLATFORM_DEPLOYMENTS.testnet.packages.record,
+    recordSettings: MISO_PLATFORM_DEPLOYMENTS.testnet.objects.recordSettings,
+    releaseRegistry: MISO_PLATFORM_DEPLOYMENTS.testnet.packages.releaseRegistry,
+    releaseRegistryId: MISO_PLATFORM_DEPLOYMENTS.testnet.objects.releaseRegistry,
+    releaseCoverArt: MISO_PLATFORM_DEPLOYMENTS.testnet.packages.releaseCoverArt,
+    compositionCredits: MISO_PLATFORM_DEPLOYMENTS.testnet.packages.compositionCredits,
+    recordingCredits: MISO_PLATFORM_DEPLOYMENTS.testnet.packages.recordingCredits,
+    releaseCredits: MISO_PLATFORM_DEPLOYMENTS.testnet.packages.releaseCredits,
+    credit: MISO_PLATFORM_DEPLOYMENTS.testnet.packages.credit,
+  },
+  party: MISO_PLATFORM_DEPLOYMENTS.testnet.party,
+  money: {
+    usdCoinType: "0x77774cb7b8cb5622b4ef2658101bf5f1e965418297fe874b683df8f760b6e749::fakeusd::FakeUsd",
+    usdDecimals: 6,
+  },
+  grpcUrl: "https://fullnode.testnet.sui.io",
+  graphqlUrl: "https://graphql.testnet.sui.io/graphql",
+  walrusAggregatorUrl: "https://aggregator.walrus-testnet.walrus.space",
+  apiBaseUrl: "https://api.testnet.miso.fm",
+  // Content from the retired deployment is intentionally not carried forward.
+  discoverReleaseIds: [],
+};
 
 /** Fields a deployment may override without forking the whole config (endpoints, shelf). */
 export type MisoConfigOverrides = Partial<
@@ -110,9 +133,9 @@ export type MisoConfigOverrides = Partial<
  * filled in here — a mainnet worker must fail loudly, never read testnet ids.
  */
 export function misoConfig(network: Network, overrides: MisoConfigOverrides = {}): MisoConfig {
-  if (network === "mainnet" || !TESTNET) {
+  if (network === "mainnet") {
     throw new Error(
-      "@misofm/sdk/read: no fresh deployment configuration yet. Publish the protocol packages, then fill in src/read/config.ts.",
+      `@misofm/sdk/read: no bundled Miso platform deployment for network "${network}".`,
     );
   }
   return { ...TESTNET, ...stripUndefined(overrides) };