Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 7 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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. `<v>` below is
the version, `0.8.3` today.
the version, `0.8.7` today.

| you have | download | then |
|---|---|---|
Expand Down Expand Up @@ -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
Expand Down Expand Up @@ -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.
Expand Down Expand Up @@ -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
Expand All @@ -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-<v>-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)
Expand Down
4 changes: 2 additions & 2 deletions android/app/build.gradle
Original file line number Diff line number Diff line change
Expand Up @@ -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',
Expand Down
7 changes: 7 additions & 0 deletions chrome/STORE.md
Original file line number Diff line number Diff line change
Expand Up @@ -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-<version>.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
Expand Down
2 changes: 1 addition & 1 deletion chrome/manifest.json
Original file line number Diff line number Diff line change
Expand Up @@ -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",
Expand Down
10 changes: 5 additions & 5 deletions core/Cargo.lock

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion core/vendor/fullnode
Submodule fullnode updated 67 files
+5 −5 .github/workflows/ci.yml
+19 −2 .github/workflows/release.yml
+31 −3 AGENTS.md
+62 −0 CHANGELOG.md
+9 −9 Cargo.lock
+1 −1 Cargo.toml
+1 −0 README.md
+29 −0 crates/randprotocol-client/src/perps.rs
+1 −0 crates/randprotocol-client/tests/wallet_flow.rs
+20 −1 crates/randprotocol-core/src/confidential.rs
+33 −0 crates/randprotocol-core/src/genesis.rs
+1 −0 crates/randprotocol-core/src/ledger/mod.rs
+330 −6 crates/randprotocol-core/src/ledger/perps.rs
+24 −24 crates/randprotocol-core/tests/vectors/perps-v1.json
+12 −0 crates/randprotocol-node/src/agg_executor.rs
+1 −0 crates/randprotocol-node/src/lib.rs
+69 −1 crates/randprotocol-node/src/main.rs
+1 −0 crates/randprotocol-node/src/msauth_key.rs
+13 −0 crates/randprotocol-node/src/node.rs
+411 −0 crates/randprotocol-node/src/perps_key.rs
+9 −1 crates/randprotocol-node/src/rpc.rs
+1 −0 crates/randprotocol-node/src/storage.rs
+12 −0 crates/randprotocol-node/src/verify_cache.rs
+1 −0 crates/randprotocol-node/tests/burst_memory.rs
+1 −0 crates/randprotocol-node/tests/cluster.rs
+1 −0 crates/randprotocol-node/tests/common/cluster.rs
+1 −0 crates/randprotocol-node/tests/common/mod.rs
+1 −0 crates/randprotocol-node/tests/dandelion.rs
+1 −0 crates/randprotocol-node/tests/genesis_cli.rs
+2 −0 crates/randprotocol-node/tests/prover_hosted.rs
+1 −0 crates/randprotocol-node/tests/public_rpc_check.rs
+1 −0 crates/randprotocol-node/tests/rpc_contract.rs
+1 −0 crates/randprotocol-node/tests/split_auth.rs
+1 −1 crates/randprotocol-rvm/Cargo.toml
+1 −1 crates/randprotocol-zkvm/Cargo.toml
+1 −1 crates/randprotocol-zkvm/guests-compiled/PROVENANCE.md
+4 −4 crates/randprotocol-zkvm/guests-compiled/SHA256SUMS
+ − crates/randprotocol-zkvm/guests-compiled/bin/evm-v1.bin
+1 −1 crates/randprotocol-zkvm/guests-compiled/bin/evm-v1.bin.sha256
+ − crates/randprotocol-zkvm/guests-compiled/bin/evm.bin
+1 −1 crates/randprotocol-zkvm/guests-compiled/bin/evm.bin.sha256
+ − crates/randprotocol-zkvm/keys/perp-vk-production-t18-pg14-in16-pub10-p2h20.bin
+ − crates/randprotocol-zkvm/keys/perp-vk-production-t18-pg14-in16-pub7-p2h20.bin
+ − crates/randprotocol-zkvm/keys/perp-vk-production-t18-pg14-in16-pub8-p2h20.bin
+ − crates/randprotocol-zkvm/keys/perp-vk-production-t18-pg14-in16-pub9-p2h20.bin
+91 −2 crates/randprotocol-zkvm/src/evm.rs
+209 −5 crates/randprotocol-zkvm/src/executor.rs
+72 −0 crates/randprotocol-zkvm/tests/emulated_guests.rs
+165 −0 crates/randprotocol-zkvm/tests/evm_interp.rs
+199 −0 crates/randprotocol-zkvm/tests/invoke_at_context.rs
+63 −0 crates/randprotocol-zkvm/tests/perp_vk.rs
+1,069 −169 deploy/cut-chain22-genesis.sh
+1,155 −0 deploy/cutover-fleet-chain22.sh
+645 −0 deploy/rehearse-cutover-fleet-chain22.sh
+39 −1 deploy/roll-all.sh
+4 −2 deploy/sync-zkvm.sh
+121 −6 docs/deploy.md
+17 −15 docs/evm-block-context.md
+18 −5 docs/perps.md
+272 −0 docs/releases/v0.8.7.md
+1 −1 vendor/circuits/PROVENANCE.md
+5 −4 vendor/circuits/SHA256SUMS
+3 −1 vendor/circuits/evm-core/src/abi.rs
+114 −0 vendor/circuits/evm-core/src/block.rs
+24 −0 vendor/circuits/evm-core/src/ffi.rs
+46 −5 vendor/circuits/evm-core/src/interp.rs
+9 −0 vendor/circuits/evm-core/src/lib.rs
12 changes: 6 additions & 6 deletions desktop/src-tauri/Cargo.lock

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion desktop/src-tauri/Cargo.toml
Original file line number Diff line number Diff line change
@@ -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"]
Expand Down
49 changes: 49 additions & 0 deletions docs/releases/v0.8.7.md
Original file line number Diff line number Diff line change
@@ -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.
7 changes: 7 additions & 0 deletions firefox/STORE.md
Original file line number Diff line number Diff line change
Expand Up @@ -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-<version>.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
Expand Down
2 changes: 1 addition & 1 deletion firefox/manifest.json
Original file line number Diff line number Diff line change
Expand Up @@ -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",
Expand Down
4 changes: 2 additions & 2 deletions ios/RandWallet.xcodeproj/project.pbxproj
Original file line number Diff line number Diff line change
Expand Up @@ -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)";
Expand Down Expand Up @@ -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;
Expand Down
2 changes: 1 addition & 1 deletion ios/project.yml
Original file line number Diff line number Diff line change
Expand Up @@ -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: ""
Expand Down
Loading