v0.4.0

This major infrastructure update migrates the entire Grat stack from the deprecated Stellar Horizon API to the modern Stellar RPC API, ensuring full compatibility with Soroban-enabled nodes and future Protocol 26+ features.

Added

• Stellar RPC Integration: Migrated the Relay Server and all example applications to use rpc.Server for network interactions, account lookups, and transaction submissions.
• Unified RpcClient: Introduced a resilient RpcClient wrapper that handles SDK version differences and provides stable access to Soroban simulation data and transaction results.

Changed

• Infrastructure Standard: Standardized on RPC_URL as the primary network endpoint; the project no longer requires or supports legacy HORIZON_URL configurations.
• Improved Type Safety: Hardened the sponsorship logic and transaction simulation handlers with TypeScript types and defensive fallback checks for RPC response shapes.

Removed

• Horizon Dependency: Completely purged all references to Horizon.Server and legacy Horizon-based error handling from the server, SDK, and documentation.

v0.3.2

This patch release focuses on relay server stability during network congestion and enhances the developer experience in the USDC Transfer demo.

Added

• Developer Observability: Added detailed logging to the relay server to expose result codes directly in the terminal.
• Improved Demo Diagnostics: The USDC Transfer web example now captures and prints full error details (including inner transaction failures) to the browser console.
• REST API Documentation: Launched a new guide for integrating Grat from any language (Python, Go, Rust, Dart) using the REST API directly.

Fixed

• Relay Stability: Increased channel lock TTL to 120s to prevent sequence conflicts (tx_bad_seq) during periods of high network latency.
• React 18 Compatibility: Fixed a double-initialization race condition in the USDC Transfer demo caused by React StrictMode.
• Build Errors: Resolved a TypeScript type mismatch in the Horizon.Server constructor within the sponsorship service.

v0.3.1

This patch release focuses on establishing the official Grat Network identity and resolving stability issues in the relay server and example projects.

Highlights

• Official Branding: We've introduced the official Grat logo and updated our contact channels. You can now reach us at gratnetworkofficial@gmail.com or follow us on X @gratnetworkHq.
• Infrastructure Stability: Fixed a crash in the relay server's Docker image by implementing a production-ready Redis client and optimizing the environment configuration.
• Examples: All example projects now feature automatic network synchronization (polling), ensuring a seamless "out-of-the-box" experience for new developers.

What’s Fixed & Changed

Relay Server (@grat/server)

• Fix: Replaced the internal mock Redis with a real ioredis implementation, resolving TypeError crashes in the rate-limiter middleware.
• Fix: Resolved 503 Service Unavailable errors caused by missing development dependencies in Docker production builds.
• Improvement: Forced NODE_ENV=production in standard deployments to ensure stable logging.

Examples

• SDK Migration: All examples are now decoupled from the workspace and point directly to the official @grat-official-sdk/sdk NPM package.
• Retry Logic: Implemented getAccountInfo polling in all examples to handle Stellar testnet synchronization delays (fixing the "sequence must be of type string" error).

Documentation

• Branding: Logo and social link integration across README.md, and docs.
• Maintenance: Updated all contact references to the new official support channels.

Installation

To update your projects to the latest stable release:

pnpm update @grat-official-sdk/sdk

v0.3.0

This release brings full compatibility with Stellar Protocol 26 (Yardstick) and introduces a major bump to the underlying SDK dependencies.

Added

• Protocol 26 Compatibility: Upgraded @stellar/stellar-sdk to v15.1.0 across the entire workspace to support new Soroban host functions and features.
• Network Freeze Handling: Introduced FrozenEntryError to properly capture and expose CAP-0077 network-level ledger entry freezes.
• Soroban Fee Buffer: The relay now applies a strict 15% buffer to Soroban resource fee estimates to protect against host function variance during mainnet deployment.

Fixed

• Fixed IPv6 loopback binding issues (EADDRINUSE / fetch failed) on Windows environments by expanding the internal express server host binding.
• Fixed tx_malformed rejections in Soroban examples by correctly attaching SorobanTransactionData footprints generated by simulate().
• Re-enabled critical eslint-disable overrides that were accidentally stripped.

v0.2.0

This release marks the successful completion of Phase 1 development. Grat is now fully verified for production-grade gas abstraction on the Stellar Testnet, covering Classic Payments, Soroban Smart Contracts, and complex Asset Lifecycles.

---

Key Features & Improvements

• Deep Error Diagnostics: The Relay now drills down into fee-bump inner transaction failures, exposing small network error codes (e.g., op_no_issuer, op_low_reserve) directly to the SDK.
• Verified Asset Lifecycle: Successful end-to-end demonstrations of zero-fee USDC onboarding (Trustline → Mint → Payment).
• Enhanced Soroban Support: Robust simulation logic and sponsorship for smart contract resource fees (CPU/Memory).
• Atomic Sequence Management: Improved Redis-backed locking to ensure zero sequence conflicts across multi-channel environments.

---

Documentation Launch

We introduce our Comprehensive Docs!

• Interactive API Reference (OAS 3.0)
• Migration Guide from Launchtube
• Step-by-step Self-Hosting (Docker/Cloud)
• React and TypeScript SDK guides

---

Bug Fixes

• Fixed SubmissionFailedError type signature mismatch.
• Resolved simulation errors for non-Soroban transactions.
• Fixed op_no_destination errors in automated smoke tests.
• Standardized environment variable loading across the monorepo.

v0.1.0

Grat Phase 1: Stellar Fee-Sponsorship

We are excited to announce the initial release of Grat, a production-ready relay server and SDK designed to eliminate gas friction on the Stellar network.

Key Features

• Gas Abstraction: Sponsor transactions (Classic & Soroban) so users don't need XLM.
• TypeScript SDK: A type-safe, resilient client with automatic retries and idempotency.
• Automated Channel Funding: Built-in testnet faucet integration for developers.
• High Concurrency: Redis-backed sequence management to prevent transaction conflicts.
• Docker Ready: One-command deployment via Docker Compose.

Packages

• SDK: npm install @grat-official-sdk/sdk

Fixes in this Release

• Resolved TypeScript build errors in the server package.
• Fixed SDK unit test timeouts for network error handling.
• Optimized Redis atomic lock logic in the Channel Manager.

---

Full Changelog: https://github.com/your-username/grat/commits/v0.1.0