@parity/product-sdk-descriptors 0.4.0 → 0.5.0

package/README.md

@@ -9,15 +9,8 @@ PAPI-generated chain descriptors for the Polkadot ecosystem. These provide fully
 | Polkadot Asset Hub | `@parity/product-sdk-descriptors/polkadot-asset-hub` | Production |
 | Kusama Asset Hub | `@parity/product-sdk-descriptors/kusama-asset-hub` | Production |
 | Paseo Asset Hub | `@parity/product-sdk-descriptors/paseo-asset-hub` | Testnet |
-| Previewnet Asset Hub | `@parity/product-sdk-descriptors/previewnet-asset-hub` | Dev (zombienet) |
 | Paseo Bulletin | `@parity/product-sdk-descriptors/paseo-bulletin` | Testnet |
-| Previewnet Bulletin | `@parity/product-sdk-descriptors/previewnet-bulletin` | Dev (zombienet) |
 | Paseo Individuality | `@parity/product-sdk-descriptors/paseo-individuality` | Testnet |
-| Previewnet Individuality | `@parity/product-sdk-descriptors/previewnet-individuality` | Dev (zombienet) |
-
-Bulletin and individuality ship a separate descriptor per environment so that
-`descriptor.genesis` matches the live chain instance. The underlying runtime is
-shared today (all Paseo runtime), but the chain instances are distinct deployments.
 
 ## Usage
 
@@ -83,3 +76,22 @@ pnpm build
    ```
 
 5. Run `pnpm generate` to fetch metadata and generate descriptors
+
+## Detecting Drift
+
+PAPI's bundled type bindings are a frozen snapshot at the moment `pnpm generate` last ran. When a chain runtime upgrades, the bundled descriptors go stale — PAPI then either errors with `Incompatible runtime entry RuntimeCall(...)` or silently mis-decodes a subscription so it never emits an event.
+
+The [`product-sdk: Descriptors drift`](../../../.github/workflows/product-sdk-descriptors-drift.yml) workflow catches this before E2E does. It runs daily, connects to each chain's RPC via `papi update --skip-codegen`, and compares the live `codeHash` and `genesis` against what's pinned in `chains/*/.papi/polkadot-api.json`.
+
+On drift it opens (or updates in place) a single tracking issue labeled `descriptors-drift`. On a fully-clean run it closes the issue.
+
+### What to do when the auto-issue fires
+
+1. `cd packages/descriptors`
+2. `pnpm generate` — fetches fresh metadata from every chain RPC and rewrites `chains/*/.papi/polkadot-api.json` + the `.scale` metadata blobs
+3. `pnpm build` — regenerates the TypeScript bindings under `chains/*/generated/dist/`
+4. `git diff packages/descriptors/` — verify nothing else changed unexpectedly
+5. `pnpm changeset` — add a `@parity/product-sdk-descriptors: patch` entry (or `minor` if the runtime added new pallets or changed decode shape)
+6. Open a PR. Run `pnpm test:e2e` against the regenerated bindings before merging — drift sometimes hides a real consumer-side break (e.g. a pallet rename)
+
+The workflow will close the tracking issue automatically on the next scheduled run once every chain is clean.

package/chains/kusama-asset-hub/.papi/polkadot-api.json

@@ -6,7 +6,7 @@
             "chain": "kusama_asset_hub",
             "metadata": "../../.papi/metadata/kusama_asset_hub.scale",
             "genesis": "0x48239ef607d7928874027a43a67689209727dfb3d3dc5e5b03a39bdc2eda771a",
-            "codeHash": "0xdefa3628d113f815fda8bbf9874c879adec02779df43737d77473347e72138c6"
+            "codeHash": "0x75086dc1a829e7a39bef2398d082e29adb23511defe35fd26a829798af49942b"
         }
     }
 }