Context
After chain v0.2.0 shipped (2026-05-17), the @ligate-labs/sdk package on npm has:
| dist-tag |
version |
latest |
0.2.0 ✅ |
rc |
0.1.1-devnet ⚠️ stale + wire-incompatible with v0.2.0 |
A consumer who reads an older blog / Stack Overflow / etc. and runs pnpm add @ligate-labs/sdk@rc will get 0.1.1-devnet, which:
- Uses the old compound
<schema_id>:<payload_hash> AttestationId form
- Will not parse
lat1… ids returned by the chain
- Returns confusing decode errors instead of "version mismatch"
Fix options
- Remove the
rc tag entirely. npm dist-tag rm @ligate-labs/sdk rc. Cleanest. Forces consumers onto latest.
- Repoint
rc at 0.2.0. npm dist-tag add @ligate-labs/sdk@0.2.0 rc. Preserves the "rc channel" idea but makes it identical to latest. Pointless during devnet.
- Wait until next pre-release. Repoint
rc to the first 0.x.y-rc.N tag we cut (mainnet-RC era). Until then leave it stale and add a docs warning.
Recommendation: option 1 (remove). Convention is plain semver per ligate-chain#374; there's no rc channel during devnet.
Affected docs
The audit + PR #13 fix already removed all @rc references from docs.ligate.io. This issue is only about the npm registry tag itself.
Action
Related: ligate-io/docs#13, ligate-io/ligate-chain#374, ligate-io/ligate-js@0.2.0 release notes.
Context
After chain v0.2.0 shipped (2026-05-17), the
@ligate-labs/sdkpackage on npm has:latest0.2.0✅rc0.1.1-devnetA consumer who reads an older blog / Stack Overflow / etc. and runs
pnpm add @ligate-labs/sdk@rcwill get0.1.1-devnet, which:<schema_id>:<payload_hash>AttestationId formlat1…ids returned by the chainFix options
rctag entirely.npm dist-tag rm @ligate-labs/sdk rc. Cleanest. Forces consumers ontolatest.rcat0.2.0.npm dist-tag add @ligate-labs/sdk@0.2.0 rc. Preserves the "rc channel" idea but makes it identical tolatest. Pointless during devnet.rcto the first0.x.y-rc.Ntag we cut (mainnet-RC era). Until then leave it stale and add a docs warning.Recommendation: option 1 (remove). Convention is plain semver per ligate-chain#374; there's no rc channel during devnet.
Affected docs
The audit + PR #13 fix already removed all
@rcreferences from docs.ligate.io. This issue is only about the npm registry tag itself.Action
npm dist-tag rm @ligate-labs/sdk rc(requires npm publish credentials on the @ligate-labs org)docs/development/runbooks/release.md(or wherever the JS release process lives)Related:
ligate-io/docs#13,ligate-io/ligate-chain#374,ligate-io/ligate-js@0.2.0release notes.