Changelog
Version history and breaking changes
Changelog
Track what changed in each release. For the full changelog with commit links, see the CHANGELOG.md on GitHub.
v0.5.1
Patch — Restore Certificate.ts as self-contained module, fix docgen compatibility.
- Removed convenience re-exports from Time.ts
- Updated stale
@exampleimport paths for flat module structure
v0.5.0
Minor — Flatten module structure to eliminate webpack casing conflicts.
This release changes how modules are organized internally. The public API is preserved, but import paths changed.
Breaking changes:
- Concept-folder subpath imports like
@evolution-sdk/evolution/addressare removed - Use the root barrel (
import { Address } from "@evolution-sdk/evolution") or wildcard (import * as Address from "@evolution-sdk/evolution/Address") MessageSigningrenamed toCOSEin the root barrel export./plutus,./cose, and./blueprintavailable as subpath imports- Blueprint barrel uses
export * asinstead ofexport *
Migration — step by step:
- Update subpath imports (most common change):
// Before (v0.4.x) — lowercase folder subpath
import { Address } from "@evolution-sdk/evolution/address"
import { Assets } from "@evolution-sdk/evolution/assets"
// After (v0.5.0) — root barrel or PascalCase wildcard
import { Address, Assets } from "@evolution-sdk/evolution"
// or
import * as Address from "@evolution-sdk/evolution/Address"- Rename MessageSigning → COSE:
// Before
import { MessageSigning } from "@evolution-sdk/evolution"
// After
import { COSE } from "@evolution-sdk/evolution"- Update Blueprint imports:
// Before — direct exports
import { codegen } from "@evolution-sdk/evolution/blueprint"
// After — namespaced exports
import { Blueprint } from "@evolution-sdk/evolution"
Blueprint.codegen.generateTypeScript(...)- Domain subpaths still work (unchanged):
// These still work in v0.5.0
import { Address } from "@evolution-sdk/evolution/plutus"
import { COSESign1 } from "@evolution-sdk/evolution/cose"
import { Codegen } from "@evolution-sdk/evolution/blueprint"v0.4.0
Minor — Reorganize flat module structure into semantic concept folders.
- Moved ~130 flat root-level files into 24 concept folders following Effect v4 conventions
- Merged
datum/intodata/ - Extracted
certificate/fromgovernance/ - Moved byte primitives to
bytes/, numeric types tonumeric/ - Moved CBOR and Codec to
encoding/ - Deleted dead code:
Combinator.ts,FormatError.ts,NativeScriptsOLD.ts,Function.ts - Conway-era certificate encoding fix: tag 258 for nonempty ordered sets
All public API exports preserved via barrel files and package.json exports map.
Versioning Policy
Evolution SDK follows Semantic Versioning:
| Version bump | Meaning |
|---|---|
| Major (1.0.0) | Breaking API changes |
| Minor (0.X.0) | New features, possible breaking changes (pre-1.0) |
| Patch (0.0.X) | Bug fixes, no API changes |
During the pre-1.0 phase, minor versions may include breaking changes. Always check this page before upgrading.
Staying Updated
- Watch the GitHub releases for notifications
- Check this page before upgrading to a new minor version
- See the Migration Guide if coming from Lucid