diff --git a/Cargo.lock b/Cargo.lock index 2fe1d489..efc5e7ec 100644 --- a/Cargo.lock +++ b/Cargo.lock @@ -3474,7 +3474,7 @@ dependencies = [ [[package]] name = "guardian-client" -version = "0.19.0" +version = "0.19.1" dependencies = [ "chrono", "guardian-shared", @@ -3582,7 +3582,7 @@ dependencies = [ [[package]] name = "guardian-server" -version = "0.19.0" +version = "0.19.1" dependencies = [ "aes-gcm", "alloy", @@ -3676,7 +3676,7 @@ dependencies = [ [[package]] name = "guardian-shared" -version = "0.19.0" +version = "0.19.1" dependencies = [ "async-trait", "base64", @@ -4994,7 +4994,7 @@ dependencies = [ [[package]] name = "miden-confidential-contracts" -version = "0.19.0" +version = "0.19.1" dependencies = [ "anyhow", "assert_matches", @@ -5282,7 +5282,7 @@ dependencies = [ [[package]] name = "miden-multisig-client" -version = "0.19.0" +version = "0.19.1" dependencies = [ "anyhow", "async-trait", @@ -5563,7 +5563,7 @@ dependencies = [ [[package]] name = "miden-rpc-client" -version = "0.19.0" +version = "0.19.1" dependencies = [ "async-trait", "guardian-shared", diff --git a/Cargo.toml b/Cargo.toml index 31d21004..4aaeb1c8 100644 --- a/Cargo.toml +++ b/Cargo.toml @@ -25,7 +25,7 @@ default-members = [ resolver = "2" [workspace.package] -version = "0.19.0" +version = "0.19.1" edition = "2024" rust-version = "1.98.1" authors = ["OpenZeppelin"] diff --git a/crates/client/Cargo.toml b/crates/client/Cargo.toml index 61c716af..f70e3c21 100644 --- a/crates/client/Cargo.toml +++ b/crates/client/Cargo.toml @@ -11,7 +11,7 @@ description = "Client library for Guardian" include = ["src/**/*", "proto/**/*", "build.rs", "Cargo.toml", "LICENSE", "README.md"] [dependencies] -guardian-shared = { version = "=0.19.0", path = "../shared" } +guardian-shared = { version = "=0.19.1", path = "../shared" } miden-protocol = { workspace = true } serde = { workspace = true } serde_json = { workspace = true } diff --git a/crates/contracts/Cargo.toml b/crates/contracts/Cargo.toml index c2287128..8a2d4a37 100644 --- a/crates/contracts/Cargo.toml +++ b/crates/contracts/Cargo.toml @@ -14,7 +14,7 @@ miden-standards = { workspace = true } miden-protocol = { workspace = true } anyhow = { workspace = true } -guardian-shared = { version = "=0.19.0", path = "../shared" } +guardian-shared = { version = "=0.19.1", path = "../shared" } [features] testing = ["miden-protocol/testing"] diff --git a/crates/miden-multisig-client/Cargo.toml b/crates/miden-multisig-client/Cargo.toml index 9773f3f7..b3deb2b9 100644 --- a/crates/miden-multisig-client/Cargo.toml +++ b/crates/miden-multisig-client/Cargo.toml @@ -11,9 +11,9 @@ description = "High-level SDK for interacting with multisig accounts on Miden vi [dependencies] # Internal crates -guardian-client = { version = "=0.19.0", path = "../client" } -guardian-shared = { version = "=0.19.0", path = "../shared" } -miden-confidential-contracts = { version = "=0.19.0", path = "../contracts" } +guardian-client = { version = "=0.19.1", path = "../client" } +guardian-shared = { version = "=0.19.1", path = "../shared" } +miden-confidential-contracts = { version = "=0.19.1", path = "../contracts" } # Miden miden-client = { workspace = true, features = ["tonic"] } @@ -52,9 +52,9 @@ default = ["legacy-consume-notes"] legacy-consume-notes = [] [dev-dependencies] -guardian-client = { version = "=0.19.0", path = "../client", features = ["testing"] } +guardian-client = { version = "=0.19.1", path = "../client", features = ["testing"] } tempfile = { workspace = true } tokio = { workspace = true, features = ["test-util"] } -miden-confidential-contracts = { version = "=0.19.0", path = "../contracts", features = ["testing"] } +miden-confidential-contracts = { version = "=0.19.1", path = "../contracts", features = ["testing"] } miden-client = { workspace = true, features = ["tonic", "testing"] } miden-rpc-client = { path = "../miden-rpc-client", features = ["scripted-node"] } diff --git a/docs/MIDEN_COMPATIBILITY.md b/docs/MIDEN_COMPATIBILITY.md index 4605039d..327837f4 100644 --- a/docs/MIDEN_COMPATIBILITY.md +++ b/docs/MIDEN_COMPATIBILITY.md @@ -20,6 +20,7 @@ elsewhere and link here: | Guardian | Miden protocol | `miden-protocol` / `miden-standards` | `miden-client` (Rust) | `@miden-sdk/miden-sdk` (npm) | |---|---|---|---|---| +| 0.19.1 | 0.18 (Rust), 0.17 (TypeScript) | `=0.18.0` | `=0.18.0` | `0.17.8` (exact) | | 0.19.0 | 0.18 (Rust), 0.17 (TypeScript) | `=0.18.0` | `=0.18.0` | `0.17.8` (exact) | | 0.18.3 | 0.17 | `=0.17.1` | `=0.17.3` | `0.17.3` (exact) | | 0.18.2 | 0.17 | `=0.17.1` | `=0.17.3` | `0.17.3` (exact) | @@ -32,6 +33,8 @@ elsewhere and link here: | 0.13.x | 0.13 | n/a | `0.13.0` | `^0.13.0` | | 0.12.x | 0.12 | n/a | `0.12.5` | `^0.12.5` | +0.19.1 keeps the 0.19.0 pins. + 0.18.2 and 0.18.3 keep the 0.18.1 pins. 0.19.0 splits the pins: the server and the Rust SDK move to Miden 0.18.0, and the @@ -137,6 +140,25 @@ Execute or cancel every pending proposal on the rc version, have GUARDIAN drop a cannot be executed, then recreate the account on 0.17.0. Recreating the account does not clear proposals served for the old one. +**Upgrading from 0.19.0 to 0.19.1: startup account recovery.** The Miden pins, the +`auth_tx` procedure root, stored account data, existing contracts and the wire contract +are unchanged, so accounts and stores carry over and 0.19.0 SDKs keep working against a +0.19.1 server. The SDK packages change in version only. The release is a server image: + +- **Startup account recovery (#607).** An optional check, off by default, that runs + before the API listeners open. It compares each stored account record with the + network and brings a record that differs in line with the account's canonical + delta history. Set `GUARDIAN_STARTUP_ACCOUNT_RECOVERY` to `dry-run` to preview and + to `apply` to write. It needs the Postgres backend. See + [Startup account recovery](./PRODUCTION.md#startup-account-recovery). +- **Postgres migrations.** Three additive migrations create + `account_recovery_backups`, `account_recovery_startup` and + `account_recovery_pending`. They run at startup in every mode and no data reset + runs. +- **Terraform.** The AWS stack gains `guardian_startup_account_recovery` (default + `"off"`), which passes the mode to the task and lengthens its health check + timings while the check is on. + **Upgrading from 0.18.3 to 0.19.0: accounts that mix Falcon and ECDSA cosigners (issue #563).** GUARDIAN can now register and operate a guarded multisig whose approvers use different schemes, for example an ECDSA wallet or hardware signer next to a diff --git a/docs/MULTISIG_SDK.md b/docs/MULTISIG_SDK.md index 1ec01434..ad989970 100644 --- a/docs/MULTISIG_SDK.md +++ b/docs/MULTISIG_SDK.md @@ -27,13 +27,13 @@ The multisig sdk has as peer dependency on the miden-sdk, you will need to insta **TypeScript (npm)** ```bash -npm install @openzeppelin/miden-multisig-client@0.19.0 @miden-sdk/miden-sdk@0.17.8 +npm install @openzeppelin/miden-multisig-client@0.19.1 @miden-sdk/miden-sdk@0.17.8 ``` **Rust (Cargo.toml)** ```toml [dependencies] -miden-multisig-client = "=0.19.0" +miden-multisig-client = "=0.19.1" miden-client = "=0.18.0" ``` diff --git a/docs/openapi-client.json b/docs/openapi-client.json index c2a165fa..734c297a 100644 --- a/docs/openapi-client.json +++ b/docs/openapi-client.json @@ -7,7 +7,7 @@ "name": "AGPL-3.0", "identifier": "AGPL-3.0" }, - "version": "0.19.0" + "version": "0.19.1" }, "paths": { "/": { diff --git a/docs/openapi-dashboard.json b/docs/openapi-dashboard.json index 2dcc3357..88bf699f 100644 --- a/docs/openapi-dashboard.json +++ b/docs/openapi-dashboard.json @@ -7,7 +7,7 @@ "name": "AGPL-3.0", "identifier": "AGPL-3.0" }, - "version": "0.19.0" + "version": "0.19.1" }, "paths": { "/auth/challenge": { diff --git a/docs/openapi-evm.json b/docs/openapi-evm.json index 73920c10..69ac00c9 100644 --- a/docs/openapi-evm.json +++ b/docs/openapi-evm.json @@ -7,7 +7,7 @@ "name": "AGPL-3.0", "identifier": "AGPL-3.0" }, - "version": "0.19.0" + "version": "0.19.1" }, "paths": { "/evm/accounts": { diff --git a/docs/openapi.json b/docs/openapi.json index 65a829eb..b87a93e6 100644 --- a/docs/openapi.json +++ b/docs/openapi.json @@ -7,7 +7,7 @@ "name": "AGPL-3.0", "identifier": "AGPL-3.0" }, - "version": "0.19.0" + "version": "0.19.1" }, "paths": { "/": { diff --git a/examples/_shared/multisig-browser/package-lock.json b/examples/_shared/multisig-browser/package-lock.json index 4e5ff202..fcb2a2cf 100644 --- a/examples/_shared/multisig-browser/package-lock.json +++ b/examples/_shared/multisig-browser/package-lock.json @@ -19,7 +19,7 @@ }, "../../../packages/guardian-client": { "name": "@openzeppelin/guardian-client", - "version": "0.19.0", + "version": "0.19.1", "license": "MIT", "devDependencies": { "typescript": "^5.7.2", @@ -31,16 +31,16 @@ }, "../../../packages/miden-multisig-client": { "name": "@openzeppelin/miden-multisig-client", - "version": "0.19.0", + "version": "0.19.1", "license": "MIT", "dependencies": { "@miden-sdk/miden-sdk": "0.17.8", "@noble/curves": "^1.9.7", "@noble/hashes": "^2.0.1", - "@openzeppelin/guardian-client": "^0.19.0" + "@openzeppelin/guardian-client": "^0.19.1" }, "devDependencies": { - "@openzeppelin/guardian-operator-client": "^0.19.0", + "@openzeppelin/guardian-operator-client": "^0.19.1", "@playwright/test": "^1.60.0", "@types/node": "^24.13.5", "fake-indexeddb": "^6.2.5", diff --git a/examples/evm-smoke-web/package-lock.json b/examples/evm-smoke-web/package-lock.json index 21d37a55..d72ea162 100644 --- a/examples/evm-smoke-web/package-lock.json +++ b/examples/evm-smoke-web/package-lock.json @@ -22,7 +22,7 @@ }, "../../packages/guardian-evm-client": { "name": "@openzeppelin/guardian-evm-client", - "version": "0.19.0", + "version": "0.19.1", "license": "MIT", "dependencies": { "viem": "^2.47.5" diff --git a/examples/operator-smoke-web/package-lock.json b/examples/operator-smoke-web/package-lock.json index e2853028..a9785f36 100644 --- a/examples/operator-smoke-web/package-lock.json +++ b/examples/operator-smoke-web/package-lock.json @@ -27,7 +27,7 @@ }, "../../packages/guardian-operator-client": { "name": "@openzeppelin/guardian-operator-client", - "version": "0.19.0", + "version": "0.19.1", "license": "MIT", "devDependencies": { "typescript": "^5.7.2", diff --git a/examples/smoke-web/package-lock.json b/examples/smoke-web/package-lock.json index 5ad3221c..2a93eaed 100644 --- a/examples/smoke-web/package-lock.json +++ b/examples/smoke-web/package-lock.json @@ -27,7 +27,7 @@ }, "../../packages/guardian-client": { "name": "@openzeppelin/guardian-client", - "version": "0.19.0", + "version": "0.19.1", "license": "MIT", "devDependencies": { "typescript": "^5.7.2", @@ -39,16 +39,16 @@ }, "../../packages/miden-multisig-client": { "name": "@openzeppelin/miden-multisig-client", - "version": "0.19.0", + "version": "0.19.1", "license": "MIT", "dependencies": { "@miden-sdk/miden-sdk": "0.17.8", "@noble/curves": "^1.9.7", "@noble/hashes": "^2.0.1", - "@openzeppelin/guardian-client": "^0.19.0" + "@openzeppelin/guardian-client": "^0.19.1" }, "devDependencies": { - "@openzeppelin/guardian-operator-client": "^0.19.0", + "@openzeppelin/guardian-operator-client": "^0.19.1", "@playwright/test": "^1.60.0", "@types/node": "^24.13.5", "fake-indexeddb": "^6.2.5", diff --git a/examples/web/package-lock.json b/examples/web/package-lock.json index a6dde230..9f8cf0ab 100644 --- a/examples/web/package-lock.json +++ b/examples/web/package-lock.json @@ -43,7 +43,7 @@ }, "../../packages/guardian-client": { "name": "@openzeppelin/guardian-client", - "version": "0.19.0", + "version": "0.19.1", "license": "MIT", "devDependencies": { "typescript": "^5.7.2", @@ -55,16 +55,16 @@ }, "../../packages/miden-multisig-client": { "name": "@openzeppelin/miden-multisig-client", - "version": "0.19.0", + "version": "0.19.1", "license": "MIT", "dependencies": { "@miden-sdk/miden-sdk": "0.17.8", "@noble/curves": "^1.9.7", "@noble/hashes": "^2.0.1", - "@openzeppelin/guardian-client": "^0.19.0" + "@openzeppelin/guardian-client": "^0.19.1" }, "devDependencies": { - "@openzeppelin/guardian-operator-client": "^0.19.0", + "@openzeppelin/guardian-operator-client": "^0.19.1", "@playwright/test": "^1.60.0", "@types/node": "^24.13.5", "fake-indexeddb": "^6.2.5", diff --git a/packages/guardian-client/package.json b/packages/guardian-client/package.json index cc57611c..11fd864d 100644 --- a/packages/guardian-client/package.json +++ b/packages/guardian-client/package.json @@ -1,6 +1,6 @@ { "name": "@openzeppelin/guardian-client", - "version": "0.19.0", + "version": "0.19.1", "description": "TypeScript HTTP client for Guardian server", "repository": { "type": "git", diff --git a/packages/guardian-evm-client/package.json b/packages/guardian-evm-client/package.json index 91ace142..a3dd31a3 100644 --- a/packages/guardian-evm-client/package.json +++ b/packages/guardian-evm-client/package.json @@ -1,6 +1,6 @@ { "name": "@openzeppelin/guardian-evm-client", - "version": "0.19.0", + "version": "0.19.1", "description": "TypeScript EVM client for Guardian server proposal workflows", "repository": { "type": "git", diff --git a/packages/guardian-operator-client/package.json b/packages/guardian-operator-client/package.json index 12a90ab8..79d9f230 100644 --- a/packages/guardian-operator-client/package.json +++ b/packages/guardian-operator-client/package.json @@ -1,6 +1,6 @@ { "name": "@openzeppelin/guardian-operator-client", - "version": "0.19.0", + "version": "0.19.1", "description": "TypeScript HTTP client for Guardian operator dashboard endpoints", "repository": { "type": "git", diff --git a/packages/miden-multisig-client/README.md b/packages/miden-multisig-client/README.md index 6950bc29..c1409116 100644 --- a/packages/miden-multisig-client/README.md +++ b/packages/miden-multisig-client/README.md @@ -17,7 +17,7 @@ Miden multisig accounts store their authentication logic on-chain, but **their s ## Installation ```bash -npm install @openzeppelin/miden-multisig-client@0.19.0 @miden-sdk/miden-sdk@0.17.8 +npm install @openzeppelin/miden-multisig-client@0.19.1 @miden-sdk/miden-sdk@0.17.8 ``` Miden 0.17 requires a new client database: a store created under 0.16 does not diff --git a/packages/miden-multisig-client/package.json b/packages/miden-multisig-client/package.json index 5e7a34c5..d08e8454 100644 --- a/packages/miden-multisig-client/package.json +++ b/packages/miden-multisig-client/package.json @@ -1,6 +1,6 @@ { "name": "@openzeppelin/miden-multisig-client", - "version": "0.19.0", + "version": "0.19.1", "description": "TypeScript SDK for Miden multisig accounts with GUARDIAN integration", "repository": { "type": "git", @@ -45,10 +45,10 @@ "@miden-sdk/miden-sdk": "0.17.8", "@noble/curves": "^1.9.7", "@noble/hashes": "^2.0.1", - "@openzeppelin/guardian-client": "^0.19.0" + "@openzeppelin/guardian-client": "^0.19.1" }, "devDependencies": { - "@openzeppelin/guardian-operator-client": "^0.19.0", + "@openzeppelin/guardian-operator-client": "^0.19.1", "@playwright/test": "^1.60.0", "@types/node": "^24.13.5", "fake-indexeddb": "^6.2.5", diff --git a/packages/package-lock.json b/packages/package-lock.json index ba22e335..8cfed084 100644 --- a/packages/package-lock.json +++ b/packages/package-lock.json @@ -21,7 +21,7 @@ }, "guardian-client": { "name": "@openzeppelin/guardian-client", - "version": "0.19.0", + "version": "0.19.1", "license": "MIT", "devDependencies": { "typescript": "^5.7.2", @@ -33,7 +33,7 @@ }, "guardian-evm-client": { "name": "@openzeppelin/guardian-evm-client", - "version": "0.19.0", + "version": "0.19.1", "license": "MIT", "dependencies": { "viem": "^2.47.5" @@ -48,7 +48,7 @@ }, "guardian-operator-client": { "name": "@openzeppelin/guardian-operator-client", - "version": "0.19.0", + "version": "0.19.1", "license": "MIT", "devDependencies": { "typescript": "^5.7.2", @@ -60,16 +60,16 @@ }, "miden-multisig-client": { "name": "@openzeppelin/miden-multisig-client", - "version": "0.19.0", + "version": "0.19.1", "license": "MIT", "dependencies": { "@miden-sdk/miden-sdk": "0.17.8", "@noble/curves": "^1.9.7", "@noble/hashes": "^2.0.1", - "@openzeppelin/guardian-client": "^0.19.0" + "@openzeppelin/guardian-client": "^0.19.1" }, "devDependencies": { - "@openzeppelin/guardian-operator-client": "^0.19.0", + "@openzeppelin/guardian-operator-client": "^0.19.1", "@playwright/test": "^1.60.0", "@types/node": "^24.13.5", "fake-indexeddb": "^6.2.5",