ssi

• FIX: v4 tag (#296).

4.0.1

• FIX: v4 tag (#296).

2026-07-23

Changes

Packages with breaking changes:

• ssi - v4.0.0

Packages with other changes:

• There are no other changes in this release.

• FIX: close connection for webhv.

3.9.5

• FIX: close connection for webhv.

2026-06-30

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• ssi - v3.9.4

• FIX: verify did:webvh SCID over the published log entry (#290).

3.9.4

• FIX: verify did:webvh SCID over the published log entry (#290).

2026-06-09

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• ssi - v3.9.3

• FIX: cache RevocationList2020 JSON-LD context (#288).

3.9.3

• FIX: cache RevocationList2020 JSON-LD context (#288).

2026-05-22

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• ssi - v3.9.2

• FIX: linting errors for unnecessary_import (#289).

3.9.2

• FIX: linting errors for unnecessary_import (#289).

2026-05-22

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• ssi - v3.9.1

• FIX: remove intl package dependency (#286).

3.9.1

• FIX: remove intl package dependency (#286).

2026-04-28

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• ssi - v3.9.0

• FEAT: did manager multi key support did web did peer v2 (#284).

3.9.0

• FEAT: did manager multi key support did web did peer v2 (#284).

2026-04-22

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• ssi - v3.8.0

• FEAT: enhance DID Manager with multi-key support for did:peer:2 and did:web methods (#274)" (#280).

3.8.0

• FEAT: enhance DID Manager with multi-key support for did:peer:2 and did:web methods (#274)" (#280).

2026-04-17

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• ssi - v3.7.0

• FEAT: enhance DID Manager with multi-key support for did:peer:2 and did:web methods (#274).

3.7.0

• FEAT: enhance DID Manager with multi-key support for did:peer:2 and did:web methods (#274).

2026-04-17

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• ssi - v3.6.2

• FIX: remove empty objects in cleanempty method (#278).

3.6.2

• FIX: remove empty objects in cleanempty method (#278).

2026-04-09

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• ssi - v3.6.1

• FIX: broken example link for did signer (#276).

3.6.1

• FIX: broken example link for did signer (#276).

2026-03-05

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• ssi - v3.6.0

• FEAT: Add did:webvh resolution based on v1.0 log & witness verification (#252).

3.6.0

• FEAT: Add did:webvh resolution based on v1.0 log & witness verification .

• FEAT: Full support for resolving did:webvh identifiers (v1.0).

• FEAT: HTTPS transformation logic for did:webvh, including /.well-known handling.

• FEAT: JSON Lines (did.jsonl) parsing and latest-state DID Document resolution.

• FEAT: Injection of implicit #files and #whois services per WebVH v1.0 specification.

• FEAT: Historical DID resolution via versionId, versionTime, and versionNumber query parameters.

• FEAT: Witness validation via did-witness.json, including threshold enforcement and proof verification.

• FEAT: Support for did:webvh:1.0 specification version enforcement.

• SECURITY: Strict WebVH log integrity validation:

• Enforced versionId format (<versionNumber>-<hash>).

• Monotonic version sequencing and chronological versionTime validation.

• SCID presence and hash verification (required in first entry, forbidden thereafter).

• Entry hash chaining verification against computed digest.

• Data Integrity proof verification (eddsa-jcs-2022, assertionMethod).

• Signer authorization enforced via updateKeys.

• Pre-rotation rules enforced (nextKeyHashes → updateKeys).

• Deactivation enforcement (deactivated=true blocks further updates).

• Prevention of duplicate witness approvals.

• Support for "later proofs satisfy earlier entries" rule.

What This Release Provides

This minor release introduces full WebVH v1.0 DID resolution support, including strict log chain validation, witness enforcement, and historical DID state resolution.

• Complete did:webvh v1.0 resolution support.
• Cryptographically verified DID history log chaining.
• Strict enforcement of WebVH integrity and authorization model.
• Witness threshold validation compliant with the v1.0 specification.
• Deterministic historical DID state resolution.
• Improved interoperability with WebVH-compliant ecosystems.

Additional Resources

• The did:webvh DID Method v1.0

2026-02-24

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• ssi - v3.5.0

• FEAT: add did web manager class for multi-key support (#257).

3.5.0

• FEAT: add did web manager class for multi-key support (#257).

2026-02-23

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• ssi - v3.4.1

• FIX: update melos to 7+ (#255).

3.4.1

• FIX: update melos to 7+ (#255).

2026-01-23

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• ssi - v3.4.0

• FEAT: improve verification error message (#236).

3.4.0

• FEAT: improve verification error message (#236).

2026-01-09

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• ssi - v3.3.0

• FEAT: jwt util helper class (#235).

3.3.0

• FEAT: jwt util helper class (#235).

2026-01-06

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• ssi - v3.2.1

• FIX: skip holder binding check for delegated credentials in HolderBindingVerifier (#234).

3.2.1

• FIX: skip holder binding check for delegated credentials in HolderBindingVerifier (#234).

2025-12-12

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• ssi - v3.2.0

• FIX: jwt vc verification for all supported alg.
• FEAT: update example input (#233).

3.2.0

• FIX: jwt vc verification for all supported alg.
• FEAT: update example input (#233).

2025-12-12

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• ssi - v3.1.1

• FIX: jwt vc verification for all supported alg.
• FIX: revocation list 2020 handle numeric index (#231).

2025-12-11

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• ssi - v3.1.1

• FEAT: add JSON-LD exception handling and error propagation (#230).

3.1.0

• FEAT: add JSON-LD exception handling and error propagation (#230).

2025-11-28

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• ssi - v3.0.2

• FIX: changelog entry (#229).

3.0.2

• FIX: changelog entry (#229).

2025-11-28

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• ssi - v3.0.1

• FIX: updated changelog entry for v3 (#228).

3.0.1

• FIX: updated changelog entry for v3 (#228).

2025-11-28

Changes

Packages with breaking changes:

• ssi - v3.0.0

Packages with other changes:

• There are no other changes in this release.

• BREAKING: VerifiableCredential MUST exist in VC type field (v1) (#205).
• BREAKING: VerifiablePresentation MUST exist in VP type fields (v1 & v2) (#216).
• BREAKING: Data Integrity proofs require proper @context entries (VC v2 context OR Data Integrity context) (#198).
• BREAKING: Service types must use StringServiceType or SetServiceType classes (#208).
• BREAKING: Issuer DID must match proof verificationMethod DID (#199).
• BREAKING: Proof IDs must be unique and non-empty within credentials (#201).
• BREAKING: Proof types cannot be null or empty strings (#202).
• BREAKING: Proof purpose must match document type - VCs use assertionMethod, VPs use authentication (#214).
• BREAKING: Credentials and presentations must be within their validity period for verification (#206).
• BREAKING: SD-JWT credentials validate exp and nbf claims (#211).
• BREAKING: Stricter proof field structure validation (#204).
• FEAT: automatic nonce generation for data integrity proofs to prevent replay attacks (#215).
• FIX: tests and melos issue (#203).
• FIX: type issues (#218).

3.0.0

Note: This release has breaking changes.

• BREAKING: VerifiableCredential MUST exist in VC type field (v1) (#205).
• BREAKING: VerifiablePresentation MUST exist in VP type fields (v1 & v2) (#216).
• BREAKING: Data Integrity proofs require proper @context entries (VC v2 context OR Data Integrity context) (#198).
• BREAKING: Service types must use StringServiceType or SetServiceType classes (#208).
• BREAKING: Issuer DID must match proof verificationMethod DID (#199).
• BREAKING: Proof IDs must be unique and non-empty within credentials (#201).
• BREAKING: Proof types cannot be null or empty strings (#202).
• BREAKING: Proof purpose must match document type - VCs use assertionMethod, VPs use authentication (#214).
• BREAKING: Credentials and presentations must be within their validity period for verification (#206).
• BREAKING: SD-JWT credentials validate exp and nbf claims (#211).
• BREAKING: Stricter proof field structure validation (#204).
• FEAT: automatic nonce generation for data integrity proofs to prevent replay attacks (#215).
• FIX: tests and melos issue (#203).
• FIX: type issues (#218).

This major release enforces strict W3C specification compliance and introduces important security enhancements for Verifiable Credentials and Decentralized Identifiers.

What This Release Provides

• Improved W3C VC Data Model v1.1 and v2.0 compliance
• Improved W3C Data Integrity specification compliance
• Enhanced security against fraudulent credentials
• Temporal validation for credential lifecycle management
• Stricter proof validation and consistency checks
• Improved DID service endpoint handling
• Automatic nonce generation for replay attack prevention
• Better interoperability with W3C-compliant systems

Migration Guide

• FIX: null safe toJson for credential status id (#224).
• FEAT: add JWK validation against issuer did (#226).

2025-11-26

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• ssi - v2.20.0

• FIX: support secp256k1 VPs that include DataIntegrityProof VCs (#220).

2.19.3

• FIX: support secp256k1 VPs that include DataIntegrityProof VCs (#220).

2025-11-24

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• ssi - v2.19.2

• FIX: better jwt errors for unsupported model versions (#221).

2.19.2

• FIX: better jwt errors for unsupported model versions (#221).

2025-11-18

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• ssi - v2.19.1

• FIX: didweb test failures by using mock did resolver (#217).

2.19.1

• FIX: didweb test failures by using mock did resolver (#217).

2025-11-18

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• ssi - v2.19.0

• FEAT: add custom DID resolvers and base58 public key support (#209).

2.19.0

• FEAT: add custom DID resolvers and base58 public key support (#209).

2025-11-17

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• ssi - v2.18.0

• FEAT: export full public_key_utils.dart (#213).

2.18.0

• FEAT: export full public_key_utils.dart (#213).

2025-11-12

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• ssi - v2.17.1

• FIX: accept lists with one element (#210).

2.17.1

• FIX: accept lists with one element (#210).

2025-11-04

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• ssi - v2.17.0

• FEAT: added context to the default document loader of data integrity verifier (#200).
• DOCS: revocation vc issuance example and tests (#197).

2025-11-04

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• ssi - v2.17.0

• FEAT: export DidSignerAdapter (#196).

2.16.0

• FEAT: export DidSignerAdapter (#196).

2025-10-23

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• ssi - v2.15.1

• FIX: did peer verification method id and did peer 0 relationships (#195).

2.15.1

• FIX: did peer verification method id and did peer 0 relationships (#195).

2025-10-17

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• ssi - v2.15.0

• FEAT: implement DidWeb.generateDocument functionality (#192).

2.15.0

• FEAT: implement DidWeb.generateDocument functionality (#192).

2025-10-17

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• ssi - v2.14.2

• FIX: rejection sampling for p256/p384/p521 keys from seed (#190).
• FIX: improve secp256k1 jws verifier to support DER encoded signatures (#186).
• FIX: fix jcs hash calculation on issuance (#193).

2025-10-17

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• ssi - v2.14.2

• FIX: add check for type to be VerifiableCredential (#191).

2.14.1

• FIX: add check for type to be VerifiableCredential (#191).

2025-10-09

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• ssi - v2.14.0

• FEAT: secp256k1 key pair factory from seed (#189).

2.14.0

• FEAT: secp256k1 key pair factory from seed (#189).

2025-10-08

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• ssi - v2.13.0

• FEAT: add holder binding verifier (#188).

2.13.0

• FEAT: add holder binding verifier (#188).

2025-08-28

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• ssi - v2.12.4

• FIX: return did key id correctly (#184).

2.12.4

• FIX: return did key id correctly (#184).

2025-08-15

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• ssi - v2.12.3

• FIX: Update vc revocation verifier (#182).

2.12.3

• FIX: Update vc revocation verifier (#182).

2025-08-12

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• ssi - v2.12.2

• FIX: use the utc time in examples to fix the failing vp when verified (#181).

2.12.2

• FIX: use the utc time in examples to fix the failing vp when verified (#181).

2025-08-07

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• ssi - v2.12.1

• DOCS: update change log with missing info (#179).

2.12.1

• DOCS: update change log with missing info (#179).

2025-08-07

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• ssi - v2.12.0

• FEAT: enhance UniversalPresentationVerifier to allow custom credential verifiers (#176).

2.12.0

• FEAT: enhance UniversalPresentationVerifier to allow custom credential verifiers (#176).

• UniversalPresentationVerifier

  • Updated UniversalPresentationVerifier to use UniversalVerifier for individual credential verification within presentations.
  • Added support for custom VC verifiers (customVclVerifiers) to allow more flexible credential-level verification.

• VpIntegrityVerifier

  • Updated to handle VP-level integrity checks only. Individual credentials within the VP should be verified using VcIntegrityVerifier.

2025-08-04

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• ssi - v2.11.3

• FIX: initial DID verifier update (#172).

2.11.3

• FIX: initial DID verifier update (#172).

2025-08-01

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• ssi - v2.11.2

• REFACTOR: improve data integrity suite naming and add JCS compliance tests (#178).

2.11.2

• REFACTOR: improve data integrity suite naming and add JCS compliance tests (#178).

2025-07-30

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• ssi - v2.11.1

• FIX: jcs proof context (#175).

2.11.1

• FIX: jcs proof context (#175).

2025-07-29

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• ssi - v2.11.0

• FEAT: jcs variation (#170).

2.11.0

• FEAT: jcs variation (#170).

2025-07-29

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• ssi - v2.10.4

• FIX: wasm compatibility (#173).

2.10.4

• FIX: wasm compatibility (#173).

2025-07-28

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• ssi - v2.10.3

• FIX: vc signature (#169).

2.10.3

• FIX: vc signature (#169).

2025-07-28

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• ssi - v2.10.2

• REFACTOR: remove live key (#166).

2.10.2

• REFACTOR: remove live key (#166).

2025-07-28

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• ssi - v2.10.1

• FIX: remove obsolete workaround for key generation (#143).

2.10.1

• FIX: remove obsolete workaround for key generation (#143).

2025-07-25

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• ssi - v2.10.0

• FEAT: improve didverifier (#156).

2.10.0

• FEAT: improve didverifier (#156).

2025-07-25

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• ssi - v2.9.1

• FIX: package publishing.

2.9.1

• FIX: package publishing.

2025-07-24

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• ssi - v2.9.0

• FEAT: implement delegation vc verifier (#146).

2.5.0

• FEAT: implement delegation vc verifier (#146).

2025-07-16

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• ssi - v2.4.0

• FEAT: update secp keys decryption (#150).

2.4.0

• FEAT: update secp keys decryption (#150).

2025-07-16

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• ssi - v2.3.2

• FIX: specify 'meta' dependency version (#154).
• FIX: change meta dependency to 'any' and update version to '2.3.1' (#153).
• DOCS: fix the VCDM 2 context in description (#152).

2.3.2

• FIX: specify 'meta' dependency version (#154).
• FIX: change meta dependency to 'any' and update version to '2.3.1' (#153).
• DOCS: fix the VCDM 2 context in description (#152).

2025-07-15

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• ssi - v2.3.0

• FEAT: Add custom document loader support for verifiable credential verification (#141).

2.3.0

• FEAT: Add custom document loader support for verifiable credential verification (#141).

2025-07-15

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• ssi - v2.2.1

• DOCS: fix the VCDM 2 description (#151).

2.2.1

• DOCS: fix the VCDM 2 description (#151).

2025-07-10

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• ssi - v2.2.0

• FEAT: v2 release with major improvements.

2.2.0

• FEAT: v2 release with major improvements.

2025-07-10

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• ssi - v2.1.0