> ## 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

> Release history for the @phala/cloud JavaScript SDK

## [0.2.9](https://github.com/Phala-Network/phala-cloud/compare/js-v0.2.8...js-v0.2.9) (2026-04-17)

### feat

* **sdk,cli:** add POST /apps/{app_id}/instances support ([80498ab](https://github.com/Phala-Network/phala-cloud/commit/80498ab02f56610a21cbbc807b92d878304a1eb2))

## [0.2.7](https://github.com/Phala-Network/phala-cloud/compare/js-v0.2.6...js-v0.2.7) (2026-04-10)

### feat

* add compose\_hash\_registered to provision response schema ([be02cf9](https://github.com/Phala-Network/phala-cloud/commit/be02cf903d1219c63693d2e355ea86114bdf4841))

### fix

* **js:** update addComposeHash test mock for owner pre-check ([456ce00](https://github.com/Phala-Network/phala-cloud/commit/456ce0022f23e315e6e0b06341026fa1ec1a73c0))
* parse StructuredError details array in 465 error handlers ([50129dc](https://github.com/Phala-Network/phala-cloud/commit/50129dcc87803e979fde0d624f3187e0547a5aca))
* preserve StructuredError response body in error conversion ([ae7eecc](https://github.com/Phala-Network/phala-cloud/commit/ae7eecc487ea1c6f0892b383e2a22e41e0e6593d))
* **sdk:** chain resolution, owner pre-check, and ABI error definitions ([0c6a50c](https://github.com/Phala-Network/phala-cloud/commit/0c6a50c7fc57370ecb61359f34f04210c645ca18))

### refactor

* add transaction progress logging and RPC transport timeouts ([29849a2](https://github.com/Phala-Network/phala-cloud/commit/29849a283025fe74543254e75afae888ab29f848))

## [0.2.6](https://github.com/Phala-Network/phala-cloud/compare/js-v0.2.5...js-v0.2.6) (2026-03-27)

### feat

* add is-allowed API to JS, Python, and Go SDKs ([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)), closes [#1041](https://github.com/Phala-Network/phala-cloud/issues/1041)
* display on-chain status in --prepare-only output ([f98f614](https://github.com/Phala-Network/phala-cloud/commit/f98f6149f13b9452099e23409964dcedbfb82ff7))
* **js-sdk:** add webhook signature verification via @phala/cloud/webhook ([3544694](https://github.com/Phala-Network/phala-cloud/commit/3544694efbd70a7f2cbd123b2ca92ccbf3c99428))
* **js,cli:** add on-chain prerequisite checks and improve update flow ([d3209e1](https://github.com/Phala-Network/phala-cloud/commit/d3209e1fd2b0be61455f5ec69de64a7919b1b7e2))
* **js:** add patchCvm and confirmCvmPatch for unified PATCH /cvms/{id} ([30cabaf](https://github.com/Phala-Network/phala-cloud/commit/30cabaf7084e72dbda656504d9f4359db95e2a16))
* **sdk:** add prepareOnly support to patchCvm and new commitCvmUpdate action ([38d6bf4](https://github.com/Phala-Network/phala-cloud/commit/38d6bf40b9209f4fcfae70fcc4c5db2d0de379e8))

### fix

* **js,cli:** add missing files and fix compose hash tx verification ([7656a45](https://github.com/Phala-Network/phala-cloud/commit/7656a459ced2843a03146d6757fd019ede2f1f53))
* **js:** handle FormData Content-Type in post/put/patch methods ([68d77ef](https://github.com/Phala-Network/phala-cloud/commit/68d77ef29a865c4cf8fb8dd91afc703064dac416))
* **js:** send empty body in confirmCvmPatch instead of undefined ([a228001](https://github.com/Phala-Network/phala-cloud/commit/a22800121b6d4db6fa719864f8775cd70c28801d))
* **js:** use toMatchObject for viem Chain comparisons in tests ([5b5d00c](https://github.com/Phala-Network/phala-cloud/commit/5b5d00c0b8f32d8147e2d784e9a10ad7fcaf152e))

## [0.2.5](https://github.com/Phala-Network/phala-cloud/compare/js-v0.2.4...js-v0.2.5) (2026-03-14)

### docs

* **js:** fix ETHEREUM typo in provision example ([15c3940](https://github.com/Phala-Network/phala-cloud/commit/15c394024467085491438fa5a52d0a1eafb565bf))

### feat

* add device management blockchain actions to SDK and CLI ([290ca2a](https://github.com/Phala-Network/phala-cloud/commit/290ca2a8d4b246b8d9d4b87281132bf573128989))
* add getAppAttestation action for app-level attestation API ([4d534e9](https://github.com/Phala-Network/phala-cloud/commit/4d534e91bb3a845ab4a13549bb271f51bf85bc21))
* add getAppDeviceAllowlist SDK action ([9b6fbf4](https://github.com/Phala-Network/phala-cloud/commit/9b6fbf4553a03308fc36783e7911806dd10b9624))
* add os-images listing, kms on-chain detail to SDK and CLI ([9fe5c9a](https://github.com/Phala-Network/phala-cloud/commit/9fe5c9a845ca6c46d3c8777eeb8eec50476a396b))
* **cli,sdk:** add --fs option to deploy command for filesystem selection ([716723d](https://github.com/Phala-Network/phala-cloud/commit/716723d5e6a4ca3f443ee073dc8f74c44af162d6))
* export attestation Zod schemas for frontend reuse ([cbd3245](https://github.com/Phala-Network/phala-cloud/commit/cbd3245bec7448790b4016816cca20ac1bb0c56c))
* **js-sdk:** add instance-id refresh actions and v20260121 field ([038810a](https://github.com/Phala-Network/phala-cloud/commit/038810a87350a00c719c430091b2a1882aed031b))
* **js:** add confidential\_models\_enabled to WorkspaceResponseSchema ([6a8b924](https://github.com/Phala-Network/phala-cloud/commit/6a8b9244d103a5fafdec931270d45259780666ea))
* **kms:** simplify CLI output and include device node names ([e48019c](https://github.com/Phala-Network/phala-cloud/commit/e48019cb972c96c049aadc2e285f4b3a06de0c14))
* query and display contract owner in allow-devices list ([37fe2e1](https://github.com/Phala-Network/phala-cloud/commit/37fe2e124880f59b3e9bb0087cafb71b350781f5))
* **sdk:** add replicateCvm action for CVM scaling ([1cb8203](https://github.com/Phala-Network/phala-cloud/commit/1cb820395a9d835146a034aa33f18062a6c8db40))

### fix

* **js-sdk:** add listed field to CvmInfoV20260121Schema ([a85adaf](https://github.com/Phala-Network/phala-cloud/commit/a85adaf3e650a6af41c27d50748a1a117f29037b))
* make base\_image optional in VMSchema ([043b81b](https://github.com/Phala-Network/phala-cloud/commit/043b81b6be0662d195b202cc28b08fc249f0ceaf))
* replace event scanning with readContract for device allowlist ([fb2a4b2](https://github.com/Phala-Network/phala-cloud/commit/fb2a4b275912d4bd2931c1b12d3b5b1368a26458))
* replay events chronologically in getAllowedDevices ([cccb120](https://github.com/Phala-Network/phala-cloud/commit/cccb120b9af2651e1468d98862bd0a7b713b1a59))

### perf

* use multicall for batch device allowlist checks ([4fb338f](https://github.com/Phala-Network/phala-cloud/commit/4fb338f0f7e383fdfee016e02712075c22ae3af0))

## [0.2.4](https://github.com/Phala-Network/phala-cloud/compare/js-v0.2.3...js-v0.2.4) (2026-02-25)

### feat

* **sdk+cli:** add SSH key and CVM runtime-config commands ([692321a](https://github.com/Phala-Network/phala-cloud/commit/692321a05bacdbc4da9bcfbc9b82ab8fcfc9d25a))
* **sdk:** add create, delete, and sync SSH key actions ([a688f29](https://github.com/Phala-Network/phala-cloud/commit/a688f2909932500be88ac238d5fcb894f7af98d6))

## [0.2.3](https://github.com/Phala-Network/phala-cloud/compare/js-v0.2.2...js-v0.2.3) (2026-02-07)

### feat

* add 200KB size limit for compose file + pre-launch script ([fe45765](https://github.com/Phala-Network/phala-cloud/commit/fe4576593cc08c2576e4c91d1c2b6b68cb3b9601))
* add profile field to app schemas and getAppFilterOptions action ([cf3c2eb](https://github.com/Phala-Network/phala-cloud/commit/cf3c2eb2e1ddc1b9984484630bc603e48f48aafb))
* add public\_tcbinfo to update visibility action ([39cfd3f](https://github.com/Phala-Network/phala-cloud/commit/39cfd3f0c5f0628d8c13a25fb99a400a32cecb06))

### fix

* rename teepod\_name to node in get\_app\_list action ([f863436](https://github.com/Phala-Network/phala-cloud/commit/f8634367fb5b03eb3f84877b56c8e914dc03fd55))

### refactor

* **js:** add revision\_id to app revisions and use revisionId for detail ([8d72149](https://github.com/Phala-Network/phala-cloud/commit/8d72149e69a71bfc11eb35c2240753b4ecc014b7))

## [0.2.2](https://github.com/Phala-Network/phala-cloud/compare/js-v0.2.1...js-v0.2.2) (2026-01-31)

### feat

* **sdk-js:** add is\_default to workspaces response schema ([85996b3](https://github.com/Phala-Network/phala-cloud/commit/85996b395c5fa7efdfe37dbf1a300964d4d441fd))
* use workspace slug as profile name, add profiles command, update default API dom ([5c150a0](https://github.com/Phala-Network/phala-cloud/commit/5c150a024d575414e60d6ead26f19a1fc9eaad4a))

### refactor

* sync NodeRef schema from backend ([f699002](https://github.com/Phala-Network/phala-cloud/commit/f699002fc24785c58cfa0452c0ab151d6c661117))

## [0.2.1](https://github.com/Phala-Network/phala-cloud/compare/js-v0.2.1-beta.4...js-v0.2.1) (2026-01-31)

### feat

* add standalone patch api for docker compose & prelaunch script ([efc9a05](https://github.com/Phala-Network/phala-cloud/commit/efc9a052c2fb0b4cf6eedce628c81ef86826fa4d))
* add validate rule to cvm name when creating cvm ([92138c0](https://github.com/Phala-Network/phala-cloud/commit/92138c0de0021aa06e597aa321c9a293bb078e2a))
* **js:** add batch CVM status action ([e99e0d8](https://github.com/Phala-Network/phala-cloud/commit/e99e0d86b79b9cf871f58d0e878a569e4808d6bc))
* **js:** add workspace nodes and quotas API ([2adf971](https://github.com/Phala-Network/phala-cloud/commit/2adf971646d0b628ad68e9a07a28b98bba02e88d))
* **sdk:** add apps API actions and fix versioned client types ([3ee04e9](https://github.com/Phala-Network/phala-cloud/commit/3ee04e9611047a47890e852bdf6f3244fd457c98))
* **sdk:** add generic request methods with full response support ([b15c2c6](https://github.com/Phala-Network/phala-cloud/commit/b15c2c627ece4472edf1ecb8a877cd619808e662))
* **sdk:** add versioned API client with type-safe return types ([4378e37](https://github.com/Phala-Network/phala-cloud/commit/4378e373966efbd72d987d399e0f7c9136c2d9dd))
* unify name convention across cli & sdk ([9f0d1e5](https://github.com/Phala-Network/phala-cloud/commit/9f0d1e5d5f7b600a1c963816ce38bd1b402885ef))

### fix

* api path for batch cvm status query ([5764b05](https://github.com/Phala-Network/phala-cloud/commit/5764b05be417e568f91b88235d7f1511b62b4724))
* **js:** expose instance\_type in CVM response ([0c30066](https://github.com/Phala-Network/phala-cloud/commit/0c300668e821a58d30cceff5dff264dcbedbddee))
* migrate URLs from cloud.phala.network to cloud.phala.com ([cd48ed4](https://github.com/Phala-Network/phala-cloud/commit/cd48ed4a69ffc3bd4f4c8483946cf21c2b5d38a6))
* **sdk,cli:** send update\_env\_vars flag when updating CVM env vars ([26077d1](https://github.com/Phala-Network/phala-cloud/commit/26077d17e418182d96b995e23e26a48da697d3ea))
* **sdk:** add missing kms\_info field to ProvisionCvmSchema ([6fc3b6a](https://github.com/Phala-Network/phala-cloud/commit/6fc3b6aa9d0c733ad2394108e388ebb907324e22))
* **sdk:** smart default for instance\_type to allow vcpu/memory params to work ([9f0780d](https://github.com/Phala-Network/phala-cloud/commit/9f0780d892d43bcb354a5ada1b8edf7c2912e0fc))

## [0.2.0](https://github.com/Phala-Network/phala-cloud/compare/js-v0.1.2...js-v0.2.0) (2025-11-05)

### feat

* added actions get\_available\_os\_images and update\_os\_image ([95e5688](https://github.com/Phala-Network/phala-cloud/commit/95e5688c14f9451791fd8b59bef6950a5e326652))
* added getCvmState & safeGetCvmState ([fc791ac](https://github.com/Phala-Network/phala-cloud/commit/fc791acc28834f1255b5a8def32494cc128935cf))
* added next-app-ids API ([26d9dfc](https://github.com/Phala-Network/phala-cloud/commit/26d9dfce02e29f80bf572aff1268e60db314d580))
* experimental watchCvmState implementation ([ce316d9](https://github.com/Phala-Network/phala-cloud/commit/ce316d9d3af9c865c7b27471a8844f5d8e025485))

## [0.1.2](https://github.com/Phala-Network/phala-cloud/compare/js-v0.1.1...js-v0.1.2) (2025-10-29)

### feat

* **sdk:** redesign errors & added event emitter support ([c2036fa](https://github.com/Phala-Network/phala-cloud/commit/c2036fa6a87587269c516538ea9573bed7596f9a))

### fix

* **cvms:** include update\_env\_vars in compose file update request body ([f3eb2cd](https://github.com/Phala-Network/phala-cloud/commit/f3eb2cd40ae7515e5e26fd8543e088da780d579c))

## [0.1.1](https://github.com/Phala-Network/phala-cloud/compare/js-v0.1.1-beta.3...js-v0.1.1) (2025-10-24)

### feat

* attach getHash & toString to AppCompose object ([d013f99](https://github.com/Phala-Network/phala-cloud/commit/d013f99ac269a5bea196c801104e1868fcaa91df))
* export utils function in get\_compose\_hash ([4c4c5fc](https://github.com/Phala-Network/phala-cloud/commit/4c4c5fcce1c2cfe2aaaad48f7539512d220e4621))

## [0.0.12](https://github.com/Phala-Network/phala-cloud/compare/57cb8ef05d2227ee6f9fb9135aa9f1ff5dfbd021...js-v0.0.12) (2025-10-11)

Initial release with action functions for deploy, provision, authentication, CVM management, KMS integration, and workspace APIs.