From e827894a10a6b471317b7c75743be256e89b2178 Mon Sep 17 00:00:00 2001 From: Dendi Suhubdy <4477337+dendisuhubdy@users.noreply.github.com> Date: Sat, 21 Nov 2026 12:46:37 +0800 Subject: [PATCH] =?UTF-8?q?release:=20wallet=200.8.7=20=E2=80=94=20chain?= =?UTF-8?q?=2022=20(fullnode=20v0.8.7,=20constraint=20set=2011),=20deriveK?= =?UTF-8?q?ey,=20the=20audit=20v14=20fixes?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The core vendors fullnode's v0.8.7 tag (bf5aabdf; was feat/cs11-revendor 60a7d03): Cargo.lock moves only the vendored path crates 0.8.6 -> 0.8.7. Versions 0.8.7 (Android versionCode 14), README, the store notes, docs/releases/v0.8.7.md. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01GFs5gyuBMf1nCmyHCP3AT8 --- README.md | 14 +++---- android/app/build.gradle | 4 +- chrome/STORE.md | 7 ++++ chrome/manifest.json | 2 +- core/Cargo.lock | 10 ++--- core/vendor/fullnode | 2 +- desktop/src-tauri/Cargo.lock | 12 +++--- desktop/src-tauri/Cargo.toml | 2 +- docs/releases/v0.8.7.md | 49 ++++++++++++++++++++++++ firefox/STORE.md | 7 ++++ firefox/manifest.json | 2 +- ios/RandWallet.xcodeproj/project.pbxproj | 4 +- ios/project.yml | 2 +- 13 files changed, 90 insertions(+), 27 deletions(-) create mode 100644 docs/releases/v0.8.7.md diff --git a/README.md b/README.md index 19bcece7..059f163a 100644 --- a/README.md +++ b/README.md @@ -44,7 +44,7 @@ Design: `docs/superpowers/specs/2026-09-13-rand-wallet-clients-design.md`. Every release is on [GitHub Releases](https://github.com/randprotocol/clients/releases/latest), and https://randprotocol.org/clients links the same files with their checksums. `` below is -the version, `0.8.3` today. +the version, `0.8.7` today. | you have | download | then | |---|---|---| @@ -77,7 +77,7 @@ shasum -a 256 -c SHA256SUMS --ignore-missing # macOS sha256sum -c SHA256SUMS --ignore-missing # Linux ``` ```powershell -Get-FileHash .\rand-wallet-0.8.3-windows-x64.msi -Algorithm SHA256 # Windows: compare with the line in SHA256SUMS +Get-FileHash .\rand-wallet-0.8.7-windows-x64.msi -Algorithm SHA256 # Windows: compare with the line in SHA256SUMS ``` A matching sum says the file is the one that was published. It does not say the file was built @@ -110,7 +110,7 @@ STARK proof, keys are Poseidon2 hashes, envelopes are ML-KEM-768 + ChaCha20-Poly primitives exist only in the fullnode's Rust crates, and a wallet that re-implemented them in Swift, Java or JavaScript would have to be byte-identical to the node or every transfer is refused. So `core/` vendors the fullnode crates (`core/vendor/fullnode`, -a submodule at fullnode `feat/cs11-revendor` `60a7d03` (fullnode PR #194, the v0.8.7 candidate: **constraint set 11**, new Poseidon2 constants, so every commitment, nullifier, key and genesis hash moves; chain 22 only; before it `v0.8.5` `d8efd47`, constraint set 9, chain 21), with the `randprotocol-msig` signer checks with the payee check a signer runs, and the verified fold in the verify cache: **split authorisation**, where a transaction carries a bundle proof made from the viewing key and a small authorisation proof the wallet always makes itself from the spend key; **BIND-1**, a transaction bound to its chain's genesis; program state and the `Invoke` action (RPL-2); and the chain's bridge fee) and exposes one JSON entry point, `call(method, params)`, that each +a submodule at fullnode's `v0.8.7` tag `bf5aabdf` (**constraint set 11**, new Poseidon2 constants, so every commitment, nullifier, key and genesis hash moves; chain 22 only; before it `v0.8.5` `d8efd47`, constraint set 9, chain 21), with the `randprotocol-msig` signer checks with the payee check a signer runs, and the verified fold in the verify cache: **split authorisation**, where a transaction carries a bundle proof made from the viewing key and a small authorisation proof the wallet always makes itself from the spend key; **BIND-1**, a transaction bound to its chain's genesis; program state and the `Invoke` action (RPL-2); and the chain's bridge fee) and exposes one JSON entry point, `call(method, params)`, that each client wraps: an XCFramework on iOS, a `.so` on Android, WebAssembly in the browser. Everything above that line — the RPC client, note store, scan and send flow, key storage and the UI — is Swift, Java and JavaScript. @@ -199,10 +199,10 @@ The first build of any client compiles the prover and takes several minutes. ```bash git clone --recurse-submodules https://github.com/randprotocol/clients.git cd clients -git checkout v0.8.3 && git submodule update --init # the newest clients release, rather than main +git checkout v0.8.7 && git submodule update --init # the newest clients release, rather than main ``` -`v0.8.3` is the newest clients release tag. `v0.8.4` and `v0.8.5` are fullnode tags, not clients tags: `main` vendors fullnode `feat/cs11-revendor` `60a7d03` (constraint set 11, chain 22, the v0.8.7 candidate; v0.8.5 before it), and there is no clients release built on it yet. +`v0.8.7` is the newest clients release tag: wallet 0.8.7 on fullnode `v0.8.7` (constraint set 11, chain 22). `v0.8.4` and `v0.8.5` are fullnode tags, not clients tags; wallet 0.8.3 (`v0.8.3`) is the last release for chain 21. **A `v0.8.x` tag on this repository is not always a wallet release.** At a node release every repository of the project is tagged with the node's version, as a snapshot of the whole at that @@ -211,11 +211,11 @@ released, on a commit whose manifests say wallet 0.8.3 and whose vendored node i no wallet version, nothing was built from it, and it is not what to check out to build a wallet. The wallet releases are the tags that have a [GitHub release](https://github.com/randprotocol/clients/releases) with its installers and -`SHA256SUMS` — the newest is `v0.8.3` — and a tag matching no wallet version in the manifests is a +`SHA256SUMS` — the newest is `v0.8.7` — and a tag matching no wallet version in the manifests is a snapshot tag. or unpack `rand-wallet--source.tar.gz` from a release, which has the submodule in it already. -The submodule is the full node (`core/vendor/fullnode`, at `feat/cs11-revendor` `60a7d03`, constraint set 11 for chain 22): the wallet's +The submodule is the full node (`core/vendor/fullnode`, at its `v0.8.7` tag `bf5aabdf`, constraint set 11 for chain 22): the wallet's cryptography is the node's own code. ### 3. Test the core (optional, about a minute) diff --git a/android/app/build.gradle b/android/app/build.gradle index 3d10e23a..0c662aef 100644 --- a/android/app/build.gradle +++ b/android/app/build.gradle @@ -16,8 +16,8 @@ android { applicationId 'org.randprotocol.wallet' minSdk 26 targetSdk 36 - versionCode 13 - versionName '0.8.3' + versionCode 14 + versionName '0.8.7' // The app's languages (res/xml/locales_config.xml, LOCALIZATION.md): library resources in // any other language are left out of the APK. resourceConfigurations += ['en', 'ru', 'zh-rCN', 'zh-rHK', 'ko', 'in', 'ms', 'ja', 'ar', 'fa', 'ur', 'ps', 'hi', 'ta', diff --git a/chrome/STORE.md b/chrome/STORE.md index e04beb7a..e1161fb3 100644 --- a/chrome/STORE.md +++ b/chrome/STORE.md @@ -7,6 +7,13 @@ stores': one document, so that what the four listings say about the wallet canno The file to upload is `rand-wallet-chrome-.zip`, built by `chrome/pack.sh` and attached to every [release](https://github.com/randprotocol/clients/releases/latest). +## Version 0.8.7 + +For Rand testnet chain 22 (fullnode v0.8.7, constraint set 11): every address and key moves, so the +wallet rescans and shows its new chain-22 address. Sites can ask for an origin-bound key +(`deriveKey`, used by durian.market's perps), and the audit v14 fixes to the note store, sends and +history are in. The permissions, the hosts and the content scripts are the same as in 0.8.3. + ## Version 0.8.3 A bundle proof made in the wallet is about 40% faster (its core vendors fullnode `97bcf4b`, the diff --git a/chrome/manifest.json b/chrome/manifest.json index 6e281508..2ca5f4a9 100644 --- a/chrome/manifest.json +++ b/chrome/manifest.json @@ -2,7 +2,7 @@ "manifest_version": 3, "name": "__MSG_appName__", "short_name": "__MSG_appShortName__", - "version": "0.8.3", + "version": "0.8.7", "description": "__MSG_appDescription__", "default_locale": "en", "author": "RandProtocol Contributors", diff --git a/core/Cargo.lock b/core/Cargo.lock index f1f196f1..095405cd 100644 --- a/core/Cargo.lock +++ b/core/Cargo.lock @@ -149,7 +149,7 @@ dependencies = [ [[package]] name = "bridge-codec" -version = "0.8.6" +version = "0.8.7" [[package]] name = "bs58" @@ -1388,7 +1388,7 @@ checksum = "63b8176103e19a2643978565ca18b50549f6101881c443590420e4dc998a3c69" [[package]] name = "randprotocol-core" -version = "0.8.6" +version = "0.8.7" dependencies = [ "bincode", "blake3", @@ -1408,7 +1408,7 @@ dependencies = [ [[package]] name = "randprotocol-msig" -version = "0.8.6" +version = "0.8.7" dependencies = [ "getrandom 0.2.17", "getrandom 0.4.3", @@ -1422,7 +1422,7 @@ dependencies = [ [[package]] name = "randprotocol-prover" -version = "0.8.6" +version = "0.8.7" dependencies = [ "blake3", "bs58", @@ -1442,7 +1442,7 @@ dependencies = [ [[package]] name = "randprotocol-zkvm" -version = "0.8.6" +version = "0.8.7" dependencies = [ "chacha20", "chacha20poly1305", diff --git a/core/vendor/fullnode b/core/vendor/fullnode index 60a7d031..bf5aabdf 160000 --- a/core/vendor/fullnode +++ b/core/vendor/fullnode @@ -1 +1 @@ -Subproject commit 60a7d031a79d35fd9042f6ded3762f206a143c5e +Subproject commit bf5aabdfa5f806e7e97b5843687b2753d6e0651d diff --git a/desktop/src-tauri/Cargo.lock b/desktop/src-tauri/Cargo.lock index 51504e99..bf0706b1 100644 --- a/desktop/src-tauri/Cargo.lock +++ b/desktop/src-tauri/Cargo.lock @@ -476,7 +476,7 @@ dependencies = [ [[package]] name = "bridge-codec" -version = "0.8.6" +version = "0.8.7" [[package]] name = "brotli" @@ -3890,7 +3890,7 @@ dependencies = [ [[package]] name = "rand-wallet-desktop" -version = "0.8.3" +version = "0.8.7" dependencies = [ "dirs 6.0.0", "randprotocol-prover", @@ -3934,7 +3934,7 @@ checksum = "63b8176103e19a2643978565ca18b50549f6101881c443590420e4dc998a3c69" [[package]] name = "randprotocol-core" -version = "0.8.6" +version = "0.8.7" dependencies = [ "bincode", "blake3", @@ -3954,7 +3954,7 @@ dependencies = [ [[package]] name = "randprotocol-msig" -version = "0.8.6" +version = "0.8.7" dependencies = [ "getrandom 0.2.17", "getrandom 0.4.3", @@ -3968,7 +3968,7 @@ dependencies = [ [[package]] name = "randprotocol-prover" -version = "0.8.6" +version = "0.8.7" dependencies = [ "anyhow", "axum", @@ -3998,7 +3998,7 @@ dependencies = [ [[package]] name = "randprotocol-zkvm" -version = "0.8.6" +version = "0.8.7" dependencies = [ "chacha20", "chacha20poly1305", diff --git a/desktop/src-tauri/Cargo.toml b/desktop/src-tauri/Cargo.toml index 58eb298c..6a94dee8 100644 --- a/desktop/src-tauri/Cargo.toml +++ b/desktop/src-tauri/Cargo.toml @@ -1,6 +1,6 @@ [package] name = "rand-wallet-desktop" -version = "0.8.3" +version = "0.8.7" edition = "2021" license = "GPL-3.0-only" authors = ["RandProtocol Contributors"] diff --git a/docs/releases/v0.8.7.md b/docs/releases/v0.8.7.md new file mode 100644 index 00000000..9878159a --- /dev/null +++ b/docs/releases/v0.8.7.md @@ -0,0 +1,49 @@ +Built for Rand testnet **chain 22** (cut 2026-11-21 on fullnode `v0.8.7`, `bf5aabdf`; genesis `29d67542941f2eb6f2c1bb68c759926f5d814c9e2c7a934292806a2d98b7e9c0`), on fullnode's `v0.8.7` tag, which this wallet core vendors. **Constraint set 11 changes every address**: the same recovery phrase opens a wallet with a new `rand1…` address and a new fingerprint on chain 22, and the note store starts empty (the wallet rescans). Wallet 0.8.3 and older serve chain 21 only, which halted at height 2 105 486; they cannot prove for chain 22. + +**Testnet software: not audited, not for real value.** + +## Download + +| you have | file | +|---|---| +| macOS, Apple silicon | `rand-wallet-0.8.7-macos-arm64.dmg` | +| macOS, Intel | `rand-wallet-0.8.7-macos-x64.dmg` | +| Windows 10 / 11 | `rand-wallet-0.8.7-windows-x64.msi` (or `…-setup.exe`, the same app) | +| Debian, Ubuntu | `rand-wallet-0.8.7-linux-x86_64.deb` | +| Fedora, openSUSE | `rand-wallet-0.8.7-linux-x86_64.rpm` | +| any other Linux | `rand-wallet-0.8.7-linux-x86_64.AppImage`, or the bare binary in `…-linux-x86_64.tar.gz` | +| Linux on arm64 | the same four, named `…-linux-arm64.…` | +| Chrome, Edge, Brave | `rand-wallet-chrome-0.8.7.zip` — unzip, then Load unpacked at `chrome://extensions` | +| Firefox 140+ | `rand-wallet-firefox-0.8.7.zip` — Load Temporary Add-on… at `about:debugging` | +| Android 8+ | `rand-wallet-0.8.7-android.apk` | +| to build it yourself | `rand-wallet-0.8.7-source.tar.gz` — this repository and its submodule | + +iOS has no download (Apple installs only from TestFlight or the App Store); build it in Xcode from the source. `rand-wallet-0.8.7-android.aab` is the bundle submitted to Google Play, attached for the record; a phone installs the `.apk`. + +## Check it + +```bash +shasum -a 256 -c SHA256SUMS --ignore-missing # macOS +sha256sum -c SHA256SUMS --ignore-missing # Linux +``` +```powershell +Get-FileHash .\rand-wallet-0.8.7-windows-x64.msi -Algorithm SHA256 +``` + +## First launch + +Nothing here is signed with a paid developer certificate yet. + +- **macOS**: System Settings → Privacy & Security → **Open Anyway**, or `xattr -dr com.apple.quarantine "/Applications/Rand Wallet.app"`. +- **Windows**: SmartScreen → **More info → Run anyway**. +- **Linux AppImage**: `chmod +x` it first. +- **Android**: signed with this project's upload key, certificate SHA-256 `75:22:2E:BF:22:D3:95:80:A5:11:2A:AC:B7:EC:2E:03:93:91:07:77:96:E0:45:1D:7B:CF:E3:7E:FA:06:53:52`. + +A device that can make a proof (the desktop app, about 8 GiB) makes it. One that cannot — a browser, most phones — uses **the RandProtocol prover** by default (https://prover.randprotocol.org, two machines operated by RandProtocol, no fee), after a one-time notice: like any prover it is sent the wallet's viewing key, so its operators can read the wallet's whole history, and it can never spend. Settings → Prover chooses your own prover instead (the desktop app's **Prove for my other devices**, or your own server), or none ([docs/prover.md](../prover.md)). Details, and how to build every client from source: the [README](https://github.com/randprotocol/clients#readme) and https://randprotocol.org/clients. + +## Since v0.8.3 + +- **Chain 22, constraint set 11.** The core vendors fullnode `v0.8.7` (was `97bcf4b`, constraint set 9): new Poseidon2 round constants (the Grain derivation), a proof-declared Poseidon2 height and the rate-¼ quotient layout. Every note commitment, nullifier, address, key and genesis hash moves, so proofs made by this wallet verify only on chain 22, and chain 21's notes are not carried: chain 22's genesis re-created the operator wallets' balances at their new addresses, and RAND held by other wallets on chain 21 was not carried (the cut record, fullnode `deploy/cut-records/chain22.record`). +- **`deriveKey` for sites** (#16): a site can ask the extension for a key bound to its own origin (durian.market's perps trading keys); the wallet's spend key never leaves it. +- **Audit v14 fixes**: the note-store merge is monotone and a shell without a conditional write merges instead of overwriting (CLI-1001); one wallet per create (CLI-1002); a transfer's outcome follows its phase, so nothing after the broadcast reads as cancelled (CLI-1006); a block whose header announced transactions and whose body is missing no longer reads as empty (CLI-1009); a note is Sent only when this wallet created it (VK-751); retired RandProtocol prover keys are refused wherever they come from (VK-9). +- A withdraw from a browser or phone goes through a prover route (the paired desktop app or the RandProtocol prover), or is refused up front. diff --git a/firefox/STORE.md b/firefox/STORE.md index 747bfb5a..616e56c5 100644 --- a/firefox/STORE.md +++ b/firefox/STORE.md @@ -7,6 +7,13 @@ stores': one document, so that what the four listings say about the wallet canno The file to upload is `rand-wallet-firefox-.zip`, built by `firefox/pack.sh` and attached to every [release](https://github.com/randprotocol/clients/releases/latest). +## Version 0.8.7 + +For Rand testnet chain 22 (fullnode v0.8.7, constraint set 11): every address and key moves, so the +wallet rescans and shows its new chain-22 address. Sites can ask for an origin-bound key +(`deriveKey`, used by durian.market's perps), and the audit v14 fixes to the note store, sends and +history are in. The permissions, the hosts and the content scripts are the same as in 0.8.3. + ## Version 0.8.3 A bundle proof made in the wallet is about 40% faster (its core vendors fullnode `97bcf4b`, the diff --git a/firefox/manifest.json b/firefox/manifest.json index 9593057c..4acd6e5a 100644 --- a/firefox/manifest.json +++ b/firefox/manifest.json @@ -2,7 +2,7 @@ "manifest_version": 3, "name": "__MSG_appName__", "short_name": "__MSG_appShortName__", - "version": "0.8.3", + "version": "0.8.7", "description": "__MSG_appDescription__", "default_locale": "en", "author": "RandProtocol Contributors", diff --git a/ios/RandWallet.xcodeproj/project.pbxproj b/ios/RandWallet.xcodeproj/project.pbxproj index 098aea57..9fa36e8c 100644 --- a/ios/RandWallet.xcodeproj/project.pbxproj +++ b/ios/RandWallet.xcodeproj/project.pbxproj @@ -779,7 +779,7 @@ IPHONEOS_DEPLOYMENT_TARGET = 16.0; LOCALIZATION_PREFERS_STRING_CATALOGS = YES; LOCALIZED_STRING_SWIFTUI_SUPPORT = YES; - MARKETING_VERSION = 0.8.3; + MARKETING_VERSION = 0.8.7; MTL_ENABLE_DEBUG_INFO = NO; MTL_FAST_MATH = YES; PRODUCT_NAME = "$(TARGET_NAME)"; @@ -850,7 +850,7 @@ IPHONEOS_DEPLOYMENT_TARGET = 16.0; LOCALIZATION_PREFERS_STRING_CATALOGS = YES; LOCALIZED_STRING_SWIFTUI_SUPPORT = YES; - MARKETING_VERSION = 0.8.3; + MARKETING_VERSION = 0.8.7; MTL_ENABLE_DEBUG_INFO = INCLUDE_SOURCE; MTL_FAST_MATH = YES; ONLY_ACTIVE_ARCH = YES; diff --git a/ios/project.yml b/ios/project.yml index f7e0c483..c9575139 100644 --- a/ios/project.yml +++ b/ios/project.yml @@ -15,7 +15,7 @@ options: settings: base: SWIFT_VERSION: "5.0" - MARKETING_VERSION: "0.8.3" + MARKETING_VERSION: "0.8.7" CURRENT_PROJECT_VERSION: "1" # Set your Apple Developer team id here (or pass DEVELOPMENT_TEAM=… to xcodebuild). DEVELOPMENT_TEAM: ""