> ## Documentation Index
> Fetch the complete documentation index at: https://docs.phala.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Changelog

> Version history and release notes for the Phala Cloud Go SDK.

## [v0.1.1](https://github.com/Phala-Network/phala-cloud/compare/go-v0.1.0...go-v0.1.1) (2026-03-27)

### Features

* add webhook signature verification utilities ([e97b3a6](https://github.com/Phala-Network/phala-cloud/commit/e97b3a6))
* add is-allowed API ([1fa61f0](https://github.com/Phala-Network/phala-cloud/commit/1fa61f0581ce111213f721f1c2d2f4744c3c2f00))
* add structured error codes and idempotency support across all SDKs ([2dd6d0b](https://github.com/Phala-Network/phala-cloud/commit/2dd6d0bae4d5fd7acdef551c3c9bf507ac1b0e4e))
* add ReplicateAppCVM for app-scoped replica creation ([22acec1](https://github.com/Phala-Network/phala-cloud/commit/22acec1))
* add Region field to ProvisionCVMRequest ([ab5eaf1](https://github.com/Phala-Network/phala-cloud/commit/ab5eaf1))
* add visibility and storage fields to ComposeFile struct ([0443f82](https://github.com/Phala-Network/phala-cloud/commit/0443f82))
* enhance SDK types for Terraform provider integration ([ba9ecb4](https://github.com/Phala-Network/phala-cloud/commit/ba9ecb4))

### Bug Fixes

* add timestamp freshness check to VerifyWebhookSignature ([7e714bd](https://github.com/Phala-Network/phala-cloud/commit/7e714bd))
* preserve endpoint instance and error detail values ([d3fd65f](https://github.com/Phala-Network/phala-cloud/commit/d3fd65f))
* make WatchCVMState MaxRetries default to unlimited ([c4b7eb4](https://github.com/Phala-Network/phala-cloud/commit/c4b7eb4))

## v0.1.0

*Initial release*

The first public release of the Phala Cloud Go SDK, providing full coverage of the Phala Cloud REST API.

### Features

* **Client initialization** with functional options pattern (`NewClient`, `WithAPIKey`, `WithBaseURL`, etc.)
* **CVM lifecycle** — provision, commit, start, stop, shutdown, restart, delete, replicate
* **CVM configuration** — update Docker Compose, pre-launch scripts, resources, visibility, env vars, OS images
* **Multi-field patch** — `PatchCVM` and `ConfirmCVMPatch` for atomic multi-field updates with on-chain confirmation support
* **Real-time state watching** — `WatchCVMState` via SSE with Go channels, automatic reconnection, and configurable retries
* **App management** — list apps, get info, query CVMs, revisions, attestations, and device allowlists
* **Workspace operations** — list workspaces, get details, query nodes and quotas
* **KMS** — list servers, get info, fetch encryption public keys, query on-chain details
* **SSH key management** — list, create, delete, import from GitHub profile, sync from linked GitHub account
* **Automatic retries** — exponential backoff (1s base, 20s cap) for 409/429/503 responses
* **Structured error handling** — `APIError` with classification methods, error codes, suggestions, and documentation links
* **CVM ID resolution** — automatic normalization of UUIDs, app IDs, hashed IDs, and names
* **Pointer helpers** — `String()`, `Int()`, `Int64()`, `Float64()`, `Bool()` for optional fields
* **Environment variable fallbacks** — `PHALA_CLOUD_API_KEY` and `PHALA_CLOUD_API_PREFIX`

### Requirements

* Go 1.25 or later
* API version: `2026-01-21`