@easy1staking/cip113-sdk-ts 0.7.0 → 0.9.0

package/dist/standard/blueprint.d.ts

@@ -5,55 +5,105 @@ import type { PlutusBlueprint, BlueprintValidator, HexString } from "../types.js
 /**
  * Standard validator titles as they appear in the blueprint.
  *
- * Targets CIP-113 0.5.0-alpha.2 (upstream commit 9db7e06). See PLAN.md D-11.
+ * Targets CIP-113 0.5.0-alpha.4 (upstream commit 7e8a631). See PLAN.md D-11.
  *
- * --- The dissolution of programmable_logic_global ------------------------
+ * --- What alpha.4 moved --------------------------------------------------
  *
- * Upstream #110 dissolved the PLG coordinator. Its transfer arm was RENAMED
- * `transfer`; third-party (seize/clawback) logic moved to a new standalone
- * `third_party`; `unfracking` is no longer reached through it. Instead
- * `programmable_logic_base` dispatches straight to one of the three.
- *
- * The practical consequence for this table: the title
- * `programmable_logic_global.programmable_logic_global.withdraw` NO LONGER
- * EXISTS in any 0.5.x blueprint. Its removal is why validateStandardBlueprint()
- * fails closed on the new artifact rather than silently building transactions
- * against a validator that is not there — the loud failure is deliberate and
- * must not be "fixed" by relaxing the check.
+ * ADDITIONS ONLY, at the level of titles: 28 -> 34 handlers, and no title this
+ * SDK requires was retired. What DID move is arity — `issuance_mint` went from
+ * four parameters to two, `upgrade_multisig` from `(signers, threshold)` to a
+ * single `utxo_ref` — plus one new validator, `issuance_logic`. An arity change
+ * is invisible to every title check in this file; see `src/standard/scripts.ts`
+ * for the builders that encode it and `test/blueprint-version-guard.test.mjs`
+ * for the pin that catches upstream moving it again.
  *
  * --- Do not read upstream's CONTRACT_SURFACE_CHANGES.md for these ---------
  *
  * That document contains an SDK impact map naming this repository by path, and
- * it is WRONG about the params datum in a way that produces malformed
- * transactions (it says 6 fields; the artifact has 7, and one line is phrased
- * as an instruction to build the 6-field shape). Every title, arity and field
- * order here comes from the blueprint itself. See PLAN.md, W-D hazard box.
+ * it has been WRONG about this repository twice. Once about the params datum in
+ * a way that produces malformed transactions (it said 6 fields; the artifact
+ * had 7, and one line was phrased as an instruction to build the 6-field
+ * shape). Every title, arity and field order here comes from the blueprint
+ * itself. See PLAN.md, W-D hazard box.
  */
 export declare const STANDARD_VALIDATORS: {
     readonly ALWAYS_FAIL: "always_fail.always_fail.spend";
-    readonly PROTOCOL_PARAMS_MINT: "protocol_params_mint.protocol_params_mint.mint";
+    /**
+     * ⚑ ONE HASH FOR POLICY *AND* ADDRESS. `protocol_params_mint` and
+     * `protocol_params_spend` merged into one multi-purpose validator (#118), so
+     * the params-NFT policy id and the params address's payment credential are
+     * now THE SAME VALUE. Two derivations that used to be independently correct
+     * are one; deriving them separately yields a valid-looking address that holds
+     * nothing.
+     */
+    readonly PROTOCOL_PARAMS: "protocol_params.protocol_params.mint";
     readonly PROGRAMMABLE_LOGIC_BASE: "programmable_logic_base.programmable_logic_base.spend";
     readonly ISSUANCE_CBOR_HEX_MINT: "issuance_cbor_hex_mint.issuance_cbor_hex_mint.mint";
     readonly ISSUANCE_MINT: "issuance_mint.issuance_mint.mint";
-    readonly REGISTRY_MINT: "registry_mint.registry_mint.mint";
-    readonly REGISTRY_SPEND: "registry_spend.registry_spend.spend";
-    /** PLG's transfer arm, renamed by #110. Withdraw-0. */
+    /** ⚑ ONE HASH FOR POLICY *AND* ADDRESS — same merge as PROTOCOL_PARAMS (#117). */
+    readonly REGISTRY: "registry.registry.mint";
+    /**
+     * The dispatcher, REINTRODUCED by #117 after #110 dissolved it.
+     *
+     * ⚠ Its title is identical to the one 0.3.x used, and its ROLE is not: it
+     * carries the three delegate hashes as compile-time parameters and every
+     * programmable transaction now withdraws through it. Do not read its presence
+     * as evidence of any protocol version — see RETIRED_VALIDATORS.
+     */
+    readonly PROGRAMMABLE_LOGIC_GLOBAL: "programmable_logic_global.programmable_logic_global.withdraw";
+    /** Withdraw-0 delegates. Arity 1 -> 3 in alpha.3; the titles did not change. */
     readonly TRANSFER: "transfer.transfer.withdraw";
-    /** Seize / clawback, split out of PLG by #110. Withdraw-0. */
     readonly THIRD_PARTY: "third_party.third_party.withdraw";
-    /** Now dispatched to directly by PLB, with no PLG hop. Withdraw-0. */
     readonly UNFRACKING: "unfracking.unfracking.withdraw";
-    /** Holds the coordination UTxO — the live protocol wiring. Spend. */
-    readonly COORDINATION_SPEND: "coordination_spend.coordination_spend.spend";
     /** Reference upgrade authority; the initial `upgrade_cred` target. Withdraw-0. */
     readonly UPGRADE_MULTISIG: "upgrade_multisig.upgrade_multisig.withdraw";
+    /**
+     * `issuance_logic` — NEW in alpha.4, and the replaceable half of issuance.
+     *
+     * The params datum's FIELD 1 names its credential (see
+     * `ProgrammableLogicGlobalParams.issuanceLogicCred`), and `issuance_mint`
+     * dispatches to whatever that field says — so this validator's withdraw-0
+     * rides on EVERY mint and EVERY burn.
+     *
+     * ⚠ Its credential must be REGISTERED before it can withdraw. An unregistered
+     * stake credential does not fail with "not registered"; the ledger reports
+     * code 3141, *"rewards withdrawals must consume rewards in full"*, which
+     * reads as a balance problem. That is how S-11 lost an afternoon on the
+     * dispatcher.
+     */
+    readonly ISSUANCE_LOGIC: "issuance_logic.issuance_logic.withdraw";
 };
 /**
- * Validator titles that existed in earlier CIP-113 releases and are GONE.
+ * The protocol version this SDK builds transactions for.
+ *
+ * ⚠ SINGLE SOURCE OF TRUTH for the version verdict. A migration flips this one
+ * constant; nothing else should encode a target version.
+ */
+export declare const TARGET_PROTOCOL_VERSION = "0.5.0-alpha.4";
+/** Upstream commit the target version's blueprint was built from. */
+export declare const TARGET_PROTOCOL_COMMIT = "7e8a631";
+/**
+ * Validator titles that existed in an ADJACENT CIP-113 release and are absent
+ * from the target one.
  *
- * Kept so that loading an old blueprint produces a diagnosis instead of a bare
- * "missing required validator", which reads as a corrupt file rather than as
- * "this SDK no longer targets that protocol version".
+ * ⛔ THESE ARE HINTS, NEVER A VERSION VERDICT, AND THE DISTINCTION IS THE WHOLE
+ * POINT OF THIS BLOCK. This map used to DRIVE the diagnosis: any present title
+ * appearing here meant "an EARLIER protocol version". That inference is unsound,
+ * and it broke the first time it was tested against reality —
+ * `programmable_logic_global` was dissolved by upstream #110 and then
+ * REINTRODUCED by #117 as the PLG dispatcher, so a blueprint strictly NEWER
+ * than the target was reported as too OLD, sending the reader to hunt for a
+ * stale checkout.
+ *
+ * A symbol's absence tells you nothing about direction, because a symbol can
+ * come back. The version comes from the PREAMBLE; these strings only add colour
+ * once the direction is already known.
+ *
+ * ⚠ ALPHA.4 ADDS NOTHING HERE, and that is measured rather than assumed: no
+ * alpha.3 title is absent from alpha.4 (28 -> 34 handlers, additions only; the
+ * delta is pinned in `test/blueprint-version-guard.test.mjs`). Do not add
+ * speculative entries — a title listed here that is also required makes the
+ * guard contradict itself, which is the original defect's exact shape.
  */
 export declare const RETIRED_VALIDATORS: Record<string, string>;
 /**
@@ -71,8 +121,57 @@ export declare function getValidatorHash(blueprint: PlutusBlueprint, title: stri
  * Get a validator entry from a blueprint by title.
  */
 export declare function getValidator(blueprint: PlutusBlueprint, title: string): BlueprintValidator;
+/**
+ * Compare two semver-ish version strings.
+ *
+ * Returns a negative number if `a < b`, positive if `a > b`, 0 if equal, and
+ * `null` if either string cannot be parsed.
+ *
+ * ⛔ `null` IS A REAL ANSWER AND MUST NOT BE COERCED TO 0. "I cannot tell which
+ * is newer" and "they are the same" are different facts, and collapsing them is
+ * how a guard starts reporting a confident direction it never established.
+ *
+ * Prerelease handling follows semver: a version WITH a prerelease tag sorts
+ * BELOW the same core version without one (`0.5.0-alpha.2` < `0.5.0`), and tags
+ * compare identifier by identifier, numerically where both sides are numeric.
+ * That last rule is what orders `alpha.2` before `alpha.10` — a plain string
+ * compare puts them the other way round.
+ */
+export declare function compareProtocolVersions(a: string, b: string): number | null;
 /**
  * Validate that a blueprint contains all required standard validators.
+ *
+ * ⛔ THE VERSION VERDICT COMES FROM THE PREAMBLE, NEVER FROM WHICH SYMBOLS ARE
+ * PRESENT. The first implementation inferred "this blueprint is OLDER" from the
+ * presence of any retired validator title, and reality broke it on first
+ * contact: `programmable_logic_global` was removed by upstream #110 and brought
+ * BACK by #117 in a new role, so 0.5.0-alpha.3 — strictly newer than the target
+ * — was reported as "an earlier protocol version that this SDK no longer
+ * supports". The guard fired correctly and named the wrong cause, which is
+ * worse than not firing: it sends the reader to look for a stale checkout.
+ *
+ * A symbol can come back. A version number cannot go backwards.
+ *
+ * ⛔⛔ AND THE SAME DEFECT CLASS SURVIVED ONE LEVEL UP IN CONTROL FLOW, WHICH IS
+ * WHAT THIS ORDERING FIXES. The version comparison used to sit BELOW an early
+ * `if (missing.length === 0) return;`, so symbol presence still decided the
+ * verdict — it just decided it by returning silently instead of by throwing.
+ * alpha.4 retires no title this SDK requires, so a strictly LATER blueprint
+ * produced `missing: []` and was ACCEPTED, while
+ * `compareProtocolVersions("0.5.0-alpha.4", TARGET_PROTOCOL_VERSION)` was
+ * returning `1` the whole time. The comparator was correct; the gate never
+ * called it.
+ *
+ * ⚠ The file's own "newer" fixture could not catch that, and the reason
+ * generalises: `NEWER_WITH_SAME_SYMBOL` is built from the alpha.2-shaped v0.3.0
+ * artefact, which is ALSO missing titles — so it entered through the
+ * missing-title door and only ever exercised the comparator. A fixture that
+ * reaches a branch by the wrong route proves nothing about the route that
+ * matters.
+ *
+ * ⇒ THE ORDER BELOW IS LOAD-BEARING: preamble verdict first, `missing` second.
+ * Every case that reaches the `missing` branch has already been established to
+ * be AT the target version.
  */
 export declare function validateStandardBlueprint(blueprint: PlutusBlueprint): void;
 //# sourceMappingURL=blueprint.d.ts.map

package/dist/standard/blueprint.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"blueprint.d.ts","sourceRoot":"","sources":["../../src/standard/blueprint.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAElF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;IAS9B,uDAAuD;;IAEvD,8DAA8D;;IAE9D,sEAAsE;;IAEtE,qEAAqE;;IAErE,kFAAkF;;CAE1E,CAAC;AAEX;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAKrD,CAAC;AAEF;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,eAAe,EAC1B,KAAK,EAAE,MAAM,GACZ,SAAS,CAQX;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,eAAe,EAC1B,KAAK,EAAE,MAAM,GACZ,SAAS,CAEX;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,eAAe,EAC1B,KAAK,EAAE,MAAM,GACZ,kBAAkB,CAQpB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,eAAe,GAAG,IAAI,CA4B1E"}
+{"version":3,"file":"blueprint.d.ts","sourceRoot":"","sources":["../../src/standard/blueprint.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAElF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,mBAAmB;;IAG9B;;;;;;;OAOG;;;;;IAOH,kFAAkF;;IAGlF;;;;;;;OAOG;;IAGH,gFAAgF;;;;IAKhF,kFAAkF;;IAGlF;;;;;;;;;;;;;OAaG;;CAEK,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,kBAAkB,CAAC;AAEvD,qEAAqE;AACrE,eAAO,MAAM,sBAAsB,YAAY,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAcrD,CAAC;AAEF;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,eAAe,EAC1B,KAAK,EAAE,MAAM,GACZ,SAAS,CAQX;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,eAAe,EAC1B,KAAK,EAAE,MAAM,GACZ,SAAS,CAEX;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,eAAe,EAC1B,KAAK,EAAE,MAAM,GACZ,kBAAkB,CAQpB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA2C3E;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,eAAe,GAAG,IAAI,CAmF1E"}

package/dist/standard/blueprint.js

@@ -4,60 +4,115 @@
 /**
  * Standard validator titles as they appear in the blueprint.
  *
- * Targets CIP-113 0.5.0-alpha.2 (upstream commit 9db7e06). See PLAN.md D-11.
+ * Targets CIP-113 0.5.0-alpha.4 (upstream commit 7e8a631). See PLAN.md D-11.
  *
- * --- The dissolution of programmable_logic_global ------------------------
+ * --- What alpha.4 moved --------------------------------------------------
  *
- * Upstream #110 dissolved the PLG coordinator. Its transfer arm was RENAMED
- * `transfer`; third-party (seize/clawback) logic moved to a new standalone
- * `third_party`; `unfracking` is no longer reached through it. Instead
- * `programmable_logic_base` dispatches straight to one of the three.
- *
- * The practical consequence for this table: the title
- * `programmable_logic_global.programmable_logic_global.withdraw` NO LONGER
- * EXISTS in any 0.5.x blueprint. Its removal is why validateStandardBlueprint()
- * fails closed on the new artifact rather than silently building transactions
- * against a validator that is not there — the loud failure is deliberate and
- * must not be "fixed" by relaxing the check.
+ * ADDITIONS ONLY, at the level of titles: 28 -> 34 handlers, and no title this
+ * SDK requires was retired. What DID move is arity — `issuance_mint` went from
+ * four parameters to two, `upgrade_multisig` from `(signers, threshold)` to a
+ * single `utxo_ref` — plus one new validator, `issuance_logic`. An arity change
+ * is invisible to every title check in this file; see `src/standard/scripts.ts`
+ * for the builders that encode it and `test/blueprint-version-guard.test.mjs`
+ * for the pin that catches upstream moving it again.
  *
  * --- Do not read upstream's CONTRACT_SURFACE_CHANGES.md for these ---------
  *
  * That document contains an SDK impact map naming this repository by path, and
- * it is WRONG about the params datum in a way that produces malformed
- * transactions (it says 6 fields; the artifact has 7, and one line is phrased
- * as an instruction to build the 6-field shape). Every title, arity and field
- * order here comes from the blueprint itself. See PLAN.md, W-D hazard box.
+ * it has been WRONG about this repository twice. Once about the params datum in
+ * a way that produces malformed transactions (it said 6 fields; the artifact
+ * had 7, and one line was phrased as an instruction to build the 6-field
+ * shape). Every title, arity and field order here comes from the blueprint
+ * itself. See PLAN.md, W-D hazard box.
  */
 export const STANDARD_VALIDATORS = {
     ALWAYS_FAIL: "always_fail.always_fail.spend",
-    PROTOCOL_PARAMS_MINT: "protocol_params_mint.protocol_params_mint.mint",
+    /**
+     * ⚑ ONE HASH FOR POLICY *AND* ADDRESS. `protocol_params_mint` and
+     * `protocol_params_spend` merged into one multi-purpose validator (#118), so
+     * the params-NFT policy id and the params address's payment credential are
+     * now THE SAME VALUE. Two derivations that used to be independently correct
+     * are one; deriving them separately yields a valid-looking address that holds
+     * nothing.
+     */
+    PROTOCOL_PARAMS: "protocol_params.protocol_params.mint",
     PROGRAMMABLE_LOGIC_BASE: "programmable_logic_base.programmable_logic_base.spend",
     ISSUANCE_CBOR_HEX_MINT: "issuance_cbor_hex_mint.issuance_cbor_hex_mint.mint",
     ISSUANCE_MINT: "issuance_mint.issuance_mint.mint",
-    REGISTRY_MINT: "registry_mint.registry_mint.mint",
-    REGISTRY_SPEND: "registry_spend.registry_spend.spend",
-    /** PLG's transfer arm, renamed by #110. Withdraw-0. */
+    /** ⚑ ONE HASH FOR POLICY *AND* ADDRESS — same merge as PROTOCOL_PARAMS (#117). */
+    REGISTRY: "registry.registry.mint",
+    /**
+     * The dispatcher, REINTRODUCED by #117 after #110 dissolved it.
+     *
+     * ⚠ Its title is identical to the one 0.3.x used, and its ROLE is not: it
+     * carries the three delegate hashes as compile-time parameters and every
+     * programmable transaction now withdraws through it. Do not read its presence
+     * as evidence of any protocol version — see RETIRED_VALIDATORS.
+     */
+    PROGRAMMABLE_LOGIC_GLOBAL: "programmable_logic_global.programmable_logic_global.withdraw",
+    /** Withdraw-0 delegates. Arity 1 -> 3 in alpha.3; the titles did not change. */
     TRANSFER: "transfer.transfer.withdraw",
-    /** Seize / clawback, split out of PLG by #110. Withdraw-0. */
     THIRD_PARTY: "third_party.third_party.withdraw",
-    /** Now dispatched to directly by PLB, with no PLG hop. Withdraw-0. */
     UNFRACKING: "unfracking.unfracking.withdraw",
-    /** Holds the coordination UTxO — the live protocol wiring. Spend. */
-    COORDINATION_SPEND: "coordination_spend.coordination_spend.spend",
     /** Reference upgrade authority; the initial `upgrade_cred` target. Withdraw-0. */
     UPGRADE_MULTISIG: "upgrade_multisig.upgrade_multisig.withdraw",
+    /**
+     * `issuance_logic` — NEW in alpha.4, and the replaceable half of issuance.
+     *
+     * The params datum's FIELD 1 names its credential (see
+     * `ProgrammableLogicGlobalParams.issuanceLogicCred`), and `issuance_mint`
+     * dispatches to whatever that field says — so this validator's withdraw-0
+     * rides on EVERY mint and EVERY burn.
+     *
+     * ⚠ Its credential must be REGISTERED before it can withdraw. An unregistered
+     * stake credential does not fail with "not registered"; the ledger reports
+     * code 3141, *"rewards withdrawals must consume rewards in full"*, which
+     * reads as a balance problem. That is how S-11 lost an afternoon on the
+     * dispatcher.
+     */
+    ISSUANCE_LOGIC: "issuance_logic.issuance_logic.withdraw",
 };
 /**
- * Validator titles that existed in earlier CIP-113 releases and are GONE.
+ * The protocol version this SDK builds transactions for.
  *
- * Kept so that loading an old blueprint produces a diagnosis instead of a bare
- * "missing required validator", which reads as a corrupt file rather than as
- * "this SDK no longer targets that protocol version".
+ * ⚠ SINGLE SOURCE OF TRUTH for the version verdict. A migration flips this one
+ * constant; nothing else should encode a target version.
+ */
+export const TARGET_PROTOCOL_VERSION = "0.5.0-alpha.4";
+/** Upstream commit the target version's blueprint was built from. */
+export const TARGET_PROTOCOL_COMMIT = "7e8a631";
+/**
+ * Validator titles that existed in an ADJACENT CIP-113 release and are absent
+ * from the target one.
+ *
+ * ⛔ THESE ARE HINTS, NEVER A VERSION VERDICT, AND THE DISTINCTION IS THE WHOLE
+ * POINT OF THIS BLOCK. This map used to DRIVE the diagnosis: any present title
+ * appearing here meant "an EARLIER protocol version". That inference is unsound,
+ * and it broke the first time it was tested against reality —
+ * `programmable_logic_global` was dissolved by upstream #110 and then
+ * REINTRODUCED by #117 as the PLG dispatcher, so a blueprint strictly NEWER
+ * than the target was reported as too OLD, sending the reader to hunt for a
+ * stale checkout.
+ *
+ * A symbol's absence tells you nothing about direction, because a symbol can
+ * come back. The version comes from the PREAMBLE; these strings only add colour
+ * once the direction is already known.
+ *
+ * ⚠ ALPHA.4 ADDS NOTHING HERE, and that is measured rather than assumed: no
+ * alpha.3 title is absent from alpha.4 (28 -> 34 handlers, additions only; the
+ * delta is pinned in `test/blueprint-version-guard.test.mjs`). Do not add
+ * speculative entries — a title listed here that is also required makes the
+ * guard contradict itself, which is the original defect's exact shape.
  */
 export const RETIRED_VALIDATORS = {
-    "programmable_logic_global.programmable_logic_global.withdraw": "dissolved by upstream #110 — its transfer arm is now `transfer.transfer.withdraw`, " +
-        "seize/clawback is `third_party.third_party.withdraw`, and unfracking is reached " +
-        "directly by programmable_logic_base",
+    "protocol_params_mint.protocol_params_mint.mint": "merged with protocol_params_spend into `protocol_params` by upstream #118 — one validator, " +
+        "one hash serving as BOTH the params-NFT policy id and the params address's payment credential",
+    "protocol_params_spend.protocol_params_spend.spend": "merged into `protocol_params` by upstream #118 (it was itself the #117 rename of " +
+        "`coordination_spend`)",
+    "coordination_spend.coordination_spend.spend": "renamed `protocol_params_spend` by upstream #117, then merged into `protocol_params` by #118",
+    "registry_mint.registry_mint.mint": "merged with registry_spend into `registry` by upstream #117 — one validator, one hash serving " +
+        "as BOTH the registry-node policy id and the node address's payment credential",
+    "registry_spend.registry_spend.spend": "merged into `registry` by upstream #117",
 };
 /**
  * Get a validator's compiled code from a blueprint by title.
@@ -88,28 +143,170 @@ export function getValidator(blueprint, title) {
     }
     return validator;
 }
+/**
+ * Compare two semver-ish version strings.
+ *
+ * Returns a negative number if `a < b`, positive if `a > b`, 0 if equal, and
+ * `null` if either string cannot be parsed.
+ *
+ * ⛔ `null` IS A REAL ANSWER AND MUST NOT BE COERCED TO 0. "I cannot tell which
+ * is newer" and "they are the same" are different facts, and collapsing them is
+ * how a guard starts reporting a confident direction it never established.
+ *
+ * Prerelease handling follows semver: a version WITH a prerelease tag sorts
+ * BELOW the same core version without one (`0.5.0-alpha.2` < `0.5.0`), and tags
+ * compare identifier by identifier, numerically where both sides are numeric.
+ * That last rule is what orders `alpha.2` before `alpha.10` — a plain string
+ * compare puts them the other way round.
+ */
+export function compareProtocolVersions(a, b) {
+    const parse = (v) => {
+        const m = /^v?(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?(?:\+[0-9A-Za-z.-]+)?$/.exec(v.trim());
+        if (!m)
+            return null;
+        return {
+            core: [Number(m[1]), Number(m[2]), Number(m[3])],
+            pre: m[4] === undefined ? null : m[4].split("."),
+        };
+    };
+    const pa = parse(a);
+    const pb = parse(b);
+    if (!pa || !pb)
+        return null;
+    for (let i = 0; i < 3; i++) {
+        const d = pa.core[i] - pb.core[i];
+        if (d !== 0)
+            return d;
+    }
+    // No prerelease outranks any prerelease.
+    if (pa.pre === null && pb.pre === null)
+        return 0;
+    if (pa.pre === null)
+        return 1;
+    if (pb.pre === null)
+        return -1;
+    const n = Math.max(pa.pre.length, pb.pre.length);
+    for (let i = 0; i < n; i++) {
+        const x = pa.pre[i];
+        const y = pb.pre[i];
+        if (x === undefined)
+            return -1;
+        if (y === undefined)
+            return 1;
+        const xn = /^\d+$/.test(x);
+        const yn = /^\d+$/.test(y);
+        if (xn && yn) {
+            const d = Number(x) - Number(y);
+            if (d !== 0)
+                return d;
+        }
+        else if (xn !== yn) {
+            // Numeric identifiers always sort below alphanumeric ones.
+            return xn ? -1 : 1;
+        }
+        else if (x !== y) {
+            return x < y ? -1 : 1;
+        }
+    }
+    return 0;
+}
 /**
  * Validate that a blueprint contains all required standard validators.
+ *
+ * ⛔ THE VERSION VERDICT COMES FROM THE PREAMBLE, NEVER FROM WHICH SYMBOLS ARE
+ * PRESENT. The first implementation inferred "this blueprint is OLDER" from the
+ * presence of any retired validator title, and reality broke it on first
+ * contact: `programmable_logic_global` was removed by upstream #110 and brought
+ * BACK by #117 in a new role, so 0.5.0-alpha.3 — strictly newer than the target
+ * — was reported as "an earlier protocol version that this SDK no longer
+ * supports". The guard fired correctly and named the wrong cause, which is
+ * worse than not firing: it sends the reader to look for a stale checkout.
+ *
+ * A symbol can come back. A version number cannot go backwards.
+ *
+ * ⛔⛔ AND THE SAME DEFECT CLASS SURVIVED ONE LEVEL UP IN CONTROL FLOW, WHICH IS
+ * WHAT THIS ORDERING FIXES. The version comparison used to sit BELOW an early
+ * `if (missing.length === 0) return;`, so symbol presence still decided the
+ * verdict — it just decided it by returning silently instead of by throwing.
+ * alpha.4 retires no title this SDK requires, so a strictly LATER blueprint
+ * produced `missing: []` and was ACCEPTED, while
+ * `compareProtocolVersions("0.5.0-alpha.4", TARGET_PROTOCOL_VERSION)` was
+ * returning `1` the whole time. The comparator was correct; the gate never
+ * called it.
+ *
+ * ⚠ The file's own "newer" fixture could not catch that, and the reason
+ * generalises: `NEWER_WITH_SAME_SYMBOL` is built from the alpha.2-shaped v0.3.0
+ * artefact, which is ALSO missing titles — so it entered through the
+ * missing-title door and only ever exercised the comparator. A fixture that
+ * reaches a branch by the wrong route proves nothing about the route that
+ * matters.
+ *
+ * ⇒ THE ORDER BELOW IS LOAD-BEARING: preamble verdict first, `missing` second.
+ * Every case that reaches the `missing` branch has already been established to
+ * be AT the target version.
  */
 export function validateStandardBlueprint(blueprint) {
     const titles = blueprint.validators.map((v) => v.title);
     const missing = Object.entries(STANDARD_VALIDATORS).filter(([, title]) => !titles.includes(title));
-    if (missing.length === 0)
-        return;
-    const label = `${blueprint.preamble.title} v${blueprint.preamble.version}`;
-    // If the blueprint carries a validator this SDK has retired, it is an OLD
-    // protocol version, not a damaged file. Say so — otherwise the reader spends
-    // the next hour looking for a corrupt artifact.
+    const version = blueprint.preamble.version;
+    const label = `${blueprint.preamble.title} v${version}`;
+    // ⚠ `detail` must stay honest in BOTH cases. Emitting
+    // "Missing required validator(s): ." with an empty list would be a guard
+    // naming a defect it did not find — the same failure mode as reporting a
+    // direction the comparator never established.
+    const detail = missing.length > 0
+        ? `Missing required validator(s): ` +
+            missing.map(([name, title]) => `${name} (title: "${title}")`).join(", ") + `.`
+        : `Every required validator title IS present, which is exactly why this is not a ` +
+            `missing-symbol failure: the PROTOCOL VERSION ITSELF is the mismatch.`;
+    // Hints, added only once direction is known from the preamble — never used to
+    // decide it. See RETIRED_VALIDATORS.
     const retired = titles.filter((t) => t in RETIRED_VALIDATORS);
-    if (retired.length > 0) {
-        throw new Error(`Blueprint "${label}" targets an earlier CIP-113 protocol version that this SDK no ` +
-            `longer supports. It still declares ${retired.map((t) => `"${t}"`).join(", ")} — ` +
-            retired.map((t) => RETIRED_VALIDATORS[t]).join("; ") +
-            `. This SDK targets 0.5.0-alpha.2 (upstream 9db7e06); use a blueprint from ` +
-            `blueprints/standard/v0.5.0-alpha.2/, or an SDK release pinned to the older contracts.`);
+    const hint = retired.length > 0
+        ? ` It declares ${retired.map((t) => `"${t}"`).join(", ")} — ` +
+            retired.map((t) => RETIRED_VALIDATORS[t]).join("; ") + `.`
+        : "";
+    const cmp = compareProtocolVersions(version, TARGET_PROTOCOL_VERSION);
+    // ⛔ THE RULING ON AN UNPARSEABLE PREAMBLE, AND THE REASON, so nobody relaxes
+    // it back. This file's doctrine is that the verdict comes from the preamble;
+    // a preamble that cannot be read therefore cannot yield a verdict, and
+    // accepting-because-the-symbols-look-right is the precise defect fixed above.
+    // So an unreadable version is refused EVEN WHEN EVERY REQUIRED TITLE IS
+    // PRESENT.
+    //
+    // ACCEPTED CONSEQUENCE: a fork carrying a non-semver version string ("main",
+    // "2026-09-10", a git describe) is now refused. It is refused LOUDLY and the
+    // message names the remedy, which is the trade being made — a fork that wants
+    // to be usable gives its preamble a semver-parseable version.
+    if (cmp === null) {
+        throw new Error(`Standard blueprint "${label}" cannot be used: its preamble version could not be ` +
+            `parsed, so this SDK cannot establish whether it is behind or ahead of the target ` +
+            `${TARGET_PROTOCOL_VERSION} (upstream ${TARGET_PROTOCOL_COMMIT}), and a verdict this ` +
+            `SDK cannot establish is not one it will guess. ${detail}${hint} ` +
+            `Give the blueprint a semver-parseable preamble version (e.g. "${TARGET_PROTOCOL_VERSION}"), ` +
+            `or use one from blueprints/standard/v${TARGET_PROTOCOL_VERSION}/. ` +
+            `Present titles: ${titles.join(", ")}`);
+    }
+    if (cmp < 0) {
+        throw new Error(`Blueprint "${label}" targets an EARLIER CIP-113 protocol version than this SDK ` +
+            `supports (target ${TARGET_PROTOCOL_VERSION}, upstream ${TARGET_PROTOCOL_COMMIT}). ` +
+            `${detail}${hint} Use a blueprint from blueprints/standard/v${TARGET_PROTOCOL_VERSION}/, ` +
+            `or an SDK release pinned to the older contracts.`);
     }
-    throw new Error(`Standard blueprint "${label}" is missing required validator(s): ` +
-        missing.map(([name, title]) => `${name} (title: "${title}")`).join(", ") +
-        `. Present titles: ${titles.join(", ")}`);
+    if (cmp > 0) {
+        throw new Error(`Blueprint "${label}" targets a LATER CIP-113 protocol version than this SDK supports ` +
+            `(target ${TARGET_PROTOCOL_VERSION}, upstream ${TARGET_PROTOCOL_COMMIT}). This is not a ` +
+            `stale or corrupt file — the SDK has not been migrated to it yet. ${detail}${hint} ` +
+            `Upgrade the SDK, or pin the blueprint to v${TARGET_PROTOCOL_VERSION}.`);
+    }
+    // At the target version, with every required title present: usable.
+    if (missing.length === 0)
+        return;
+    // Same version, still missing validators: the artifact does not match what
+    // this version is supposed to contain. Neither older nor newer explains it.
+    throw new Error(`Standard blueprint "${label}" declares this SDK's target version ` +
+        `(${TARGET_PROTOCOL_VERSION}) but does not contain the validators that version should ` +
+        `have — the artifact does not match its own version string. ${detail}${hint} ` +
+        `Present titles: ${titles.join(", ")}`);
 }
 //# sourceMappingURL=blueprint.js.map

package/dist/standard/blueprint.js.map

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