Change Logs

Version 1.1.5 (Latest) - November 27, 2025

🛠️ Core Utilities

Key Management Utilities: Updated and expanded key management functions (keygen, verification key, Hydra key) in @hydra-sdk/core
- Added unit tests for key generation functions
- Standardized and optimized key management API for Hydra and Cardano CLI
Blockfrost Integration: Added configuration files and Blockfrost integration for demo applications

🧪 Testing & Metadata

SDK API Metadata Extraction: Added script to automatically generate SDK API metadata (extract-sdk-api.ts)
Test Coverage: Added unit tests for key utilities

📦 Updated Packages

@hydra-sdk/core@1.1.5
@hydra-sdk/transaction@1.1.5
@hydra-sdk/bridge@1.1.5

Version 1.1.3 - October 29, 2025

🧪 Testing & CI/CD Infrastructure

GitHub Actions Workflows: Comprehensive CI/CD pipeline cho automated testing
- Jest Configuration: Thêm Jest config với coverage reporting và JUnit support
- Test Workflow: Automated testing workflow với detailed reporting và coverage metrics
- GitHub Secrets Setup: Documentation và configuration cho environment variables trong CI/CD
- Test Commands: Thêm test:ci script cho continuous integration testing

🛠️ Core Utilities Improvements

Metadata Utilities: Thêm utility functions để convert các loại metadata khác nhau sang CardanoWASM.TransactionMetadatum
- Support cho Map, List, String, Number, Boolean metadata types
- Enhanced type safety cho Plutus datum operations
Converter Fixes: Fix và optimize converter utilities cho UTxO transformation
- Improved performance cho conversion operations
- Better error handling và validation

🏗️ Package Refactoring

Package Rename: Rename hydra-wallet thành core để đồng nhất với package naming convention
Import Updates: Refactor imports để sử dụng Deserializer và Converter từ centralized locations

🧹 Code Quality & Maintenance

Debug Logs Cleanup: Remove unnecessary debug logs trong WebsocketConnector
Test Improvements: Remove unnecessary logs và ensure conversion performance trong tests
Dependencies Update: Update pnpm lock với các dependency mới nhất

📚 Documentation Updates

CI/CD Documentation: Thêm comprehensive documentation cho GitHub Actions workflows
Secrets Management: Setup guide cho GitHub Secrets và environment variables
Testing Guide: Documentation cho Jest configuration và test workflows

📦 Updated Packages

@hydra-sdk/core@1.1.3
@hydra-sdk/transaction@1.1.3
@hydra-sdk/bridge@1.1.3

🔧 Developer Experience

Automated Testing: CI/CD pipeline tự động chạy tests trên mọi PR và push
Coverage Reports: Detailed coverage metrics và reporting trong GitHub Actions
Better Tooling: Improved development workflow với automated checks

Version 1.1.2 - October 22, 2025

🎉 New Features

CardanoCliWallet Implementation: New wallet class for Cardano CLI-based key management and transaction handling
- Key Management: Support for signing keys, verification keys, and address generation
- Transaction Signing: Direct transaction signing using Cardano CLI wallet format
- Node.js Integration: Seamless integration with Node.js environments for CLI-based workflows

🛠️ Technical Improvements

Wallet Abstraction: Added CardanoCliWallet class to @hydra-sdk/core for CLI-based wallet operations
Enhanced Flexibility: Support for multiple wallet types (Browser extension, CLI, Hardware)
Developer Experience: Simplified wallet integration for Node.js applications and automation scripts

📦 Updated Packages

@hydra-sdk/core@1.1.2
@hydra-sdk/transaction@1.1.2
@hydra-sdk/bridge@1.1.2

📚 Package Updates

Apps: Updated dependencies across playground, nodejs-playground, and web applications
Documentation: Updated to reflect new CardanoCliWallet functionality

Version 1.1.1 - October 8, 2025

🎉 New Features

Hydra Concept Documentation: Comprehensive new documentation section covering Hydra Layer 2 concepts and usage
- Why Hydra?: Complete guide explaining benefits, use cases, and when to use Hydra for your project
- Commit to Hydra: Detailed documentation on committing UTxOs into Hydra Heads with blueprint transaction support
- Blueprint Transaction Support: Enhanced TxBuilder with blueprint transaction functionality for Hydra deposits
- Incremental Commit: Added support for partial deposits with blueprint transactions and change address handling

🛠️ Technical Improvements

TxBuilder Enhancement: Added blueprint transaction support for building transactions compatible with Hydra commit operations
HydraApi Extensions: New commit() and partialDeposit() methods in nodejs-playground for Hydra operations
Namespace Imports: Migrated from direct function imports to namespace exports (Deserializer, ParserUtils)
Package Export Optimization: Updated package exports to use source files for better development experience

📚 Documentation Updates

Hydra Concept Section: Complete bilingual documentation (English/Vietnamese) for Hydra Layer 2 concepts
Interactive Examples: Added practical Node.js examples for empty commits and blueprint-based commits
Navigation Enhancement: New "Hydra Concept" section in documentation sidebar with comprehensive guides
Code Examples: Real-world examples for partial commits, blueprint transactions, and change address handling

📦 Updated Packages

@hydra-sdk/core@1.1.1
@hydra-sdk/transaction@1.1.1
@hydra-sdk/bridge@1.1.1

⚡ Performance & Development Experience

Source-based Exports: Package exports now point to source files instead of built files for faster development
Enhanced Type Safety: Improved TypeScript definitions for Hydra operations
Better Error Handling: Enhanced error logging and debugging for Hydra transactions

Version 1.1.0 - September 26, 2025

🎉 New Features

Utilities Modernization: Major update to core utilities with enhanced APIs and modern patterns
- TimeUtils: New unixTimeToEnclosingSlot() and slotToBeginUnixTime() functions replacing deprecated resolveSlotNo()
- SLOT_CONFIG_NETWORK: Network-specific slot configuration constants (MAINNET, PREPROD, PREVIEW)
- Serializer/Deserializer: Namespace exports for Serializer.serializeAssetUnit() and Deserializer.deserializeAssetUnit()
- DatumSchema: Simplified to constants-only API (Basic, Detailed) - removed deprecated methods

📚 Documentation Overhaul (September 26, 2025)

Comprehensive Documentation Modernization: Complete rewrite of utilities examples and guides (50-75% size reduction)
TimeUtils API Updates: Updated all examples to use new unixTimeToEnclosingSlot() patterns with SLOT_CONFIG_NETWORK
API Accuracy Fixes: Corrected DatumSchema documentation to reflect actual implementation (constants only)
Transaction Signing Streamline: Reduced transaction signing examples from ~400 to ~150 lines, focusing on 4 core patterns
Working with Utilities Modernization: Updated guides with actual patterns from nodejs-playground
Serializer/Deserializer Patterns: Modernized all examples to use namespace exports and round-trip workflows
Perfect EN/VI Sync: Maintained 100% consistency between English and Vietnamese documentation

🛠️ Technical Improvements

Breaking API Changes: Deprecated legacy utility functions in favor of modern patterns
Namespace Exports: Migrated from direct function imports to namespace pattern for better organization
Production Patterns: All examples now based on real implementation patterns from nodejs-playground
Enhanced Error Handling: Added comprehensive error handling patterns for utilities
Performance Optimizations: Streamlined utility functions for better performance

📦 Updated Packages

@hydra-sdk/core@1.1.0
@hydra-sdk/transaction@1.1.0
@hydra-sdk/bridge@1.1.0

⚠️ Breaking Changes

TimeUtils: resolveSlotNo() deprecated - use unixTimeToEnclosingSlot() with SLOT_CONFIG_NETWORK
DatumSchema: fromJSON()/toJSON() methods removed - use DatumSchema.Basic/DatumSchema.Detailed constants
Serializer Import: Direct serializeAssetUnit import deprecated - use Serializer.serializeAssetUnit

Version 1.0.14 - September 24, 2025

🎉 New Features

Token Minting & Burning: Implemented comprehensive minting and burning functionality with policy scripts and datum utilities
Plutus Schema Support: Added detailed schema support for Plutus datums in DatumSchema with enhanced type safety
Policy Management: Added PolicyUtils for creating and managing minting policies with time-based constraints
Native Token Operations: Full support for Cardano native token creation, metadata handling, and lifecycle management

📚 Documentation Updates

Mint/Burn Guide: Added comprehensive bilingual guide for token minting and burning operations
Code Examples: Included practical TypeScript examples for mint-burn-token operations
Tutorial Content: Created step-by-step tutorials covering wallet setup, UTxO management, and transaction building
Security Guidelines: Added security best practices and warnings for token operations

🛠️ Technical Improvements

DatumUtils Enhancement: Expanded datum utilities with support for complex Plutus data structures
Transaction Builder: Enhanced TxBuilder with native asset support and policy script integration
WASM Integration: Improved Cardano WASM deserializer for handling complex transaction types
Type Safety: Added comprehensive TypeScript types for Plutus scripts and native assets

📦 Updated Packages

@hydra-sdk/core@1.0.14
@hydra-sdk/transaction@1.0.14
@hydra-sdk/bridge@1.0.14

Version 1.0.13 - September 22, 2025

� New Features

GitHub Actions Integration: Added comprehensive GitHub Actions workflow for automated building and testing
Enhanced Contract Functionality: Implemented era summary retrieval and time-based constraints in unlock processes
Network Utilities: Refactored network constants and added slot configuration utilities for improved time handling

🐛 Bug Fixes

Validity Range: Fixed validity range setup in transaction to correctly handle lower/upper bounds and serialization
Time Utilities: Added TimeUtils to core for common time conversions and helpers

📚 Documentation Updates - September 23, 2025

Vietnamese Documentation: Added complete Vietnamese translation for all documentation pages
i18n Support: Implemented internationalization with language switcher (English/Vietnamese)
Navigation Updates: Added 'Hydra Bridge' entry to navigation and glossary localization
Change Logs Integration: Added 'Change Logs' link to documentation sidebar for better navigation
Configuration Guide: Updated configuration examples to optimize polyfills (Buffer only, disable global/process)
Documentation Links: Updated logo image paths and documentation links to reflect new SDK URLs
License Update: Updated license from MIT to Apache 2.0 across documentation
Support Links: Updated support banner link to point to the new funding page

� Updated Packages

@hydra-sdk/core@1.0.13
@hydra-sdk/transaction@1.0.13
@hydra-sdk/bridge@1.0.13

Version 1.0.12 - September 18, 2025

🎉 New Features

GitHub Actions Integration: Added comprehensive GitHub Actions workflow for automated building and testing
Enhanced Contract Functionality: Implemented era summary retrieval and time-based constraints in unlock processes
Network Utilities: Refactored network constants and added slot configuration utilities for improved time handling
Documentation Updates: Updated logo image paths and documentation links to reflect new SDK URLs

🐛 Bug Fixes

Validity Range: Fixed validity range setup in transaction to correctly handle lower/upper bounds and serialization
Time Utilities: Added TimeUtils to core for common time conversions and helpers

📦 Updated Packages

@hydra-sdk/core@1.0.13
@hydra-sdk/transaction@1.0.13
@hydra-sdk/bridge@1.0.13

Version 1.0.12 - September 18, 2025

🚀 Major Improvements

Transaction Builder: Complete implementation of transaction building and unlocking functionality with Plutus scripts
Custom Signing: Implemented custom transaction signing functionality
Script Enhancement: Enhanced TxBuilder with script data hash recalculation and updated redeemer builder

⚡ Performance Enhancements

Redeemer Handling: Refactored redeemer handling in TxBuilder to use emptyRedeemer utility for improved clarity
Execution Units: Added exUnits parameter to buildRedeemer and emptyRedeemer functions for customizable execution units

🐛 Bug Fixes

Transaction Builder Fixes:
- Updated descriptions for better clarity
- Fixed redeemer builder with more options and changed default exUnits
- Removed debug logs for cleaner output
- Fixed calculate script hash functionality

📦 Updated Packages

@hydra-sdk/core@1.0.12
@hydra-sdk/transaction@1.0.12
@hydra-sdk/bridge@1.0.12

Version 1.0.11 - September 15, 2025

📚 Documentation & UI

Version Badges: Added version badges to package navigation in documentation
Code Examples: Updated code blocks in Vue.js example documentation for proper syntax highlighting
Full App Examples: Added comprehensive React and Vue.js application examples
Links Enhancement: Added links for Full React and Full Vue.js App examples

🧹 Maintenance

Dependencies: Removed chalk dependency from pnpm-lock.yaml
Package Updates: Updated version numbers and changelogs for multiple packages

📦 Updated Packages

@hydra-sdk/core@1.0.11
@hydra-sdk/transaction@1.0.11
@hydra-sdk/bridge@1.0.11

Version 1.0.10 & Earlier Versions

🔧 Core Development Phase

Unit Testing: Added comprehensive unit tests and demo code
API Implementation: Implemented HexcoreApi and OgmiosApi classes
Lock/Unlock Functionality: Added lock and unlock transaction functionality
Connection Management: Updated HexcoreConnector to use new API endpoints
Repository Migration: Updated all GitHub links to point to Vtechcom organization
License: Added MIT License file
Documentation: Created initial documentation for Hydra SDK packages

🏗️ Infrastructure Setup

Build Scripts: Added build script for generating documentation
Metadata Handling: Updated transaction metadata functionality
Node.js Support: Implemented Node.js compatibility
WebSocket Connector: Fixed auto connect with websocket connector
Auth System: Enhanced auth page with version display and safety notice

📦 Package History

Multiple iterations of core packages (@hydra-sdk/core, @hydra-sdk/transaction, @hydra-sdk/bridge)
Legacy packages migration from @hydrawallet-sdk/* to @hydra-sdk/*
Configuration packages (@hydra-sdk/tsconfig, @hydra-sdk/eslint-config)
Cardano WASM integration (@hydra-sdk/cardano-wasm)

🔄 Migration Notes

Package Naming Convention

Starting from version 1.0.5, all packages have been migrated from @hydrawallet-sdk/* to @hydra-sdk/* naming convention for better consistency.

Recommended Configuration (v1.0.13+)

For optimal performance, we recommend updating your Vite configuration:

Recommended Setup:

javascript

nodePolyfills({
  include: ['buffer'],  // ✅ Only include buffer polyfill
  globals: {
    Buffer: true,       // ✅ Required for cryptographic operations
    global: false,      // ✅ Disabled for better performance
    process: false      // ✅ Disabled for better performance
  }
})

Legacy Setup (still supported):

javascript

nodePolyfills({
  globals: {
    Buffer: true,
    global: true,    // ⚠️ Not recommended but still works
    process: true    // ⚠️ Not recommended but still works
  }
})

Breaking Changes

v1.1.0: Major TimeUtils API changes - resolveSlotNo() deprecated, use unixTimeToEnclosingSlot() with SLOT_CONFIG_NETWORK
v1.1.0: DatumSchema API simplified - removed fromJSON()/toJSON() methods, use constants only
v1.1.0: Serializer imports - use namespace exports Serializer.serializeAssetUnit() instead of direct imports
v1.0.14: Added mint/burn token functionality with new DatumUtils and PolicyUtils structures
v1.0.13: License change from MIT to Apache 2.0 (documentation only)
v1.0.12: Updated redeemer builder interface with new exUnits parameter
v1.0.11: Changed transaction validity range handling
v1.0.10: Repository URLs updated to Vtechcom organization

📋 Package Overview

Package	Current Version	Description
`@hydra-sdk/core`	1.1.3	Core library for building decentralized applications
`@hydra-sdk/transaction`	1.1.3	Transaction building and management utilities
`@hydra-sdk/bridge`	1.1.3	Bridge functionality for wallet connections
`@hydra-sdk/cardano-wasm`	0.0.5	Cardano WASM bindings and utilities
`@hydra-sdk/tsconfig`	0.0.4	Shared TypeScript configuration
`@hydra-sdk/eslint-config`	0.0.4	Shared ESLint configuration

🔗 Links & Resources

GitHub Repository: https://github.com/Vtechcom/hydra-sdk
Documentation: https://hydrasdk.com
npm Registry: @hydra-sdk packages

Change logs are automatically generated based on Git history and semantic versioning. For detailed commit information, please refer to the GitHub repository.