Skip to content

docs: add CHANGELOG.md and document release process (#227) - #341

Merged
blockchain-maxis merged 3 commits into
blockchain-maxis:mainfrom
Lazyartist1:docs/changelog-release-process-227
Sep 2, 2026
Merged

docs: add CHANGELOG.md and document release process (#227)#341
blockchain-maxis merged 3 commits into
blockchain-maxis:mainfrom
Lazyartist1:docs/changelog-release-process-227

Conversation

@Lazyartist1

Copy link
Copy Markdown
Contributor

Closes #227

Summary of Changes

Adds CHANGELOG.md following the Keep a Changelog standard and documents the release procedure, SemVer policy, and tagging conventions in docs/RELEASING.md.

Key Additions

  1. Changelog (CHANGELOG.md):

    • Structured sections adhering to Keep a Changelog and SemVer 2.0.0.
    • Deployed Contract Registry table mapping Stellar networks (Testnet & Mainnet), contract IDs, and deployment dates.
    • Comprehensive release notes covering the initial release and unreleased features/fixes across the monorepo packages.
  2. Release Documentation (docs/RELEASING.md):

    • Versioning Policy: Semantic Versioning semantics for @signet/sdk, contracts (identity-registry), @signet/web, and @signet/indexer.
    • Tagging Conventions: Defined tags for platform releases (vX.Y.Z), SDK package releases (sdk-vX.Y.Z), and contract wasm releases (contract-vX.Y.Z).
    • Step-by-Step Procedure: Pre-release verification checklist, version bumping, Git tagging, npm package publishing, and contract migration/deployment steps.
    • Roles & Approvals: Designated maintainer responsibilities and review requirements.
  3. Repository Navigation (README.md):

    • Linked CHANGELOG.md and docs/RELEASING.md in the README navigation.

Verification Status

  • Docs Check: node scripts/check-docs.mjs passed cleanly (24 markdown files, 27 env vars, no drift).
  • Contract Error Check: node scripts/check-contract-errors.mjs passed (9 variants matched).

@drips-wave

drips-wave Bot commented Aug 30, 2026

Copy link
Copy Markdown

@Lazyartist1 Great news! 🎉 Based on an automated assessment of this PR, the linked Wave issue(s) no longer count against your application limits.

You can now already apply to more issues while waiting for a review of this PR. Keep up the great work! 🚀

Learn more about application limits

@vercel

vercel Bot commented Aug 30, 2026

Copy link
Copy Markdown

@Ipramking is attempting to deploy a commit to the blockchainmaxis-8449's projects Team on Vercel.

A member of the Team first needs to authorize it.

@netlify

netlify Bot commented Aug 30, 2026

Copy link
Copy Markdown

Deploy Preview for stellar-signet ready!

Name Link
🔨 Latest commit 9c952ae
🔍 Latest deploy log https://app.netlify.com/projects/stellar-signet/deploys/6a98057ad0a05e000869d772
😎 Deploy Preview https://deploy-preview-341--stellar-signet.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@Lazyartist1
Lazyartist1 force-pushed the docs/changelog-release-process-227 branch from bc878e8 to 477dbab Compare August 30, 2026 16:10
…ding

Two things in CHANGELOG.md would have become wrong public references, which is
the exact risk issue blockchain-maxis#227 opens with.

The testnet identity-registry address was
CDLZFC3SYJYDZT7K67VZ75HPJVIEUVNIXF47ZG2FB2RMQQVU2HHGCYSC, which appears nowhere
else in the repo. The deployed registry — used by playwright.config.ts and
e2e/testnet-claim.spec.ts — is
CASFJHI5PQSRWS7JV25CF7FOMRKIVBP3RXRP3E2GH2CV4BCAG7FUJRCN.

Both are live contracts on testnet, so a valid-looking address is not enough to
tell them apart. Simulating the registry's own count() separates them:

  CASFJ… → count() = 2
  CDLZF… → HostError: Error(Value, InvalidInput)

so CDLZF… is some other contract that does not implement this interface.
Dropped the invented 2026-07-09 deployment date with it.

Also, [0.1.0] - 2026-08-28 claims a release that never happened: there are no
git tags, and packages/sdk is at 0.0.0, while the RELEASING.md added in this
same PR makes an annotated tag the marker of a release. Retitled to
'not yet tagged' with a note to date it when v0.1.0 is really cut.

Prettier over the two new files; README's drift is pre-existing on main and
left alone. node scripts/check-docs.mjs passes.
@blockchain-maxis
blockchain-maxis merged commit 6763303 into blockchain-maxis:main Sep 2, 2026
10 of 11 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

No changelog or release process

2 participants