​

Changelog

​

Latest Release

​

[2.0.7] - 2025-12-31

​

Changed

• Updated documentation structure for improved navigation
• Enhanced reference documentation with network info and error codes
• Improved TypeScript type exports for better IDE support

​

Fixed

• Minor documentation typos and formatting issues
• Type inference for credential module methods

​

[2.0.5] - 2025-12-30

​

Added

• GHOST Token Integration: Full support for GHOST token staking and burning
• Staking Tiers: Basic, Verified, Pro, Whale staking tiers with benefits
• Payment Options: USDC payment or GHOST burning (25% discount)
• Revenue Sharing: Staker revenue distribution from protocol fees

​

Changed

• Updated contract deployment to devnet program 4wHjA2a5YC4twZb4NQpwZpixo5FgxxzuJUrCG7UnF9pB
• Improved error handling with user-friendly messages
• Enhanced RPC client with better retry logic

​

Fixed

• Staking account PDA derivation issues
• Token-2022 compatibility improvements
• Cache invalidation bugs in credential module

​

[2.0.0] - 2025-01-31

​

🚀 Major Production Release

​

Added

• Complete Module Test Coverage: 1,800+ lines of comprehensive unit tests for all 6 core modules
• Full Bulletproof Verification: Real ZK proof verification system with hybrid validation approach
• Enhanced Type Safety: 100% TypeScript compliance with zero any types where avoidable
• Professional Documentation: Complete API documentation, troubleshooting guides, and examples
• Production Build System: Optimized bundles with tree-shaking and modern ESM exports
• Credential Module: W3C-compliant verifiable credentials with Crossmint cross-chain sync
• DID Module: Decentralized identifier management with W3C DID specification support
• Privacy Module: 5 privacy modes (Public, Tier Only, Range Only, Private, Custom)
• Governance Module: On-chain proposals, voting, and parameter updates
• Multisig Module: Multi-signature authorization for critical operations

​

Fixed

• All ESLint Warnings: Resolved 21 ESLint warnings for perfect code quality
• Test Infrastructure: Fixed vitest mocking issues allowing comprehensive testing
• ElGamal ZK Integration: Replaced placeholder with actual ZK ElGamal Proof Program integration
• Address Validation: Fixed native mint address and PDA derivation issues
• Type Consistency: Resolved all TypeScript strict mode violations

​

Changed

• Agent Module: Implemented proper async PDA derivation using getProgramDerivedAddress
• Compliance System: Added real ed25519 signature generation for audit reports
• Wallet Integration: Added base58 private key loading with proper validation
• Error Handling: Enhanced user-friendly error messages throughout SDK

​

Breaking Changes

• Renamed cluster option from 'localnet' to 'devnet' (localnet deprecated)
• GhostSpeakClient constructor now requires cluster parameter
• Removed deprecated ConnectionManager class (use GhostSpeakClient directly)
• Changed return type of agents.register() to include full transaction signature

​

Migration Guide

​

[1.6.0] - 2025-01-18

​

Added

• Advanced monitoring system with performance metrics, alerts, and distributed tracing
• Multi-tier caching system (LRU, LFU, TTL, Adaptive, Dependency, Tag-based)
• Specialized helper methods for batch operations and common patterns
• Comprehensive RPC type definitions for Solana Web3.js v2
• Simple RPC client for improved @solana/kit compatibility

​

Changed

• Refactored RPC client architecture for July 2025 best practices
• Updated instruction classes to use modern TypeScript patterns
• Improved type safety throughout the codebase
• Enhanced error handling and recovery strategies

​

Technical Notes

• Implements July 2025 TypeScript features (satisfies operator, const assertions)
• Full Solana Web3.js v2 compatibility
• BigInt usage throughout for numeric precision
• Tree-shakeable module architecture

​

[1.5.1] - 2025-01-10

​

Added

• Initial SDK implementation
• Agent registration and management
• Basic reputation tracking
• Credential issuance (Solana-only)
• Escrow module for x402 marketplace

​

Fixed

• Connection pool memory leaks
• Incorrect PDA derivation for reputation accounts
• Transaction confirmation timeout issues

​

[1.0.0] - 2024-12-15

​

Added

• Initial alpha release
• Core agent operations
• Basic credential support
• Devnet deployment

​

Upcoming Releases

​

[2.1.0] - Planned Q1 2026

• ✅ Mainnet program deployment
• ✅ Production-grade monitoring and analytics
• ✅ Enhanced security auditing tools
• ✅ Performance optimizations for high-throughput applications
• ✅ Additional credential types (Skill Badges, Compliance Certificates)
• ✅ Advanced governance features (Quadratic voting, Delegation)
• ✅ Zero-knowledge proof integration for privacy-preserving credentials

• cluster: 'mainnet-beta' will require mainnet program ID
• Staking minimum amounts may be adjusted for mainnet economics

​

Release Schedule

​

Deprecation Notices

​

Deprecated in 2.0.0

​

Migration Timeline

v2.0.x (Current)  →  v2.1.x (Q1 2026)  →  v3.0.x (Q2 2026)
   Warnings              Final warnings      Removal

​

Versioning Policy

• API changes requiring code updates
• Removal of deprecated features
• Major architectural changes

• New modules or functionality
• Performance improvements
• Deprecation notices

• Bug fixes and security patches
• Documentation updates
• Minor performance tweaks

​

Breaking Changes by Version

// ❌ OLD (v1.x)
const client = new GhostSpeakClient()

// ✅ NEW (v2.x)
const client = new GhostSpeakClient({ cluster: 'devnet' })

// ❌ OLD (v1.x)
const agentId = await client.agents.register(signer, data)
// Returns: string (agent ID)

// ✅ NEW (v2.x)
const result = await client.agents.register(signer, data)
// Returns: { address: Address, signature: Signature }
console.log(result.address) // Agent address
console.log(result.signature) // Transaction signature

// ❌ OLD (v1.x)
catch (error) {
  if (error.message.includes('not found')) {
    // String matching
  }
}

// ✅ NEW (v2.x)
catch (error) {
  if (error instanceof AccountNotFoundError) {
    console.log(error.address) // Typed error properties
    console.log(error.userFriendlyMessage)
  }
}

// ❌ OLD (v1.5.x)
import { PublicKey } from '@solana/web3.js'
const pubkey = new PublicKey('...')

// ✅ NEW (v1.6.x+)
import { address } from '@solana/addresses'
const addr = address('...')

// ❌ OLD (v1.5.x)
const amount = 1000000 // number

// ✅ NEW (v1.6.x+)
const amount = 1_000_000n // bigint

​

Security Updates

​

CVE Disclosures

• Email: [email protected]
• Bug Bounty: Coming with mainnet launch

​

Dependency Updates

​

Major Dependency Versions

​

Installation History

bun add @ghostspeak/sdk@latest
# or
npm install @ghostspeak/sdk@latest

bun add @ghostspeak/[email protected]

bun add @ghostspeak/sdk@beta

bun add @ghostspeak/[email protected]

​

Release Notes Archive

​

Subscribe to Updates