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
9 changes: 9 additions & 0 deletions docs/prover.md
Original file line number Diff line number Diff line change
Expand Up @@ -227,6 +227,15 @@ pins the four old keys, so it finds no member it trusts and has to prove locally
the user pairs; from 0.8.2 a wallet in that state (a pinned member answering with another key)
says to update Rand Wallet rather than to try again later.

**Retired keys** (VK-9). The keys the pool no longer uses — the one key shared until 0.6.9 and
the four members 0.6.9–0.8.0 pinned — are listed in the engine (`RETIRED_PROVER_KEYS`,
`ui/engine/backend-shared.js`; `rand` carries the same list). A listed key is never paired (a
link that names one is refused before the prover is asked), a pairing stored before its key was
retired is sent nothing after the update, and a pinned member whose key is listed is skipped:
"This prover's key was retired and is no longer used. Pair another prover in Settings, or update
Rand Wallet to the latest version." A wallet released before a key was retired cannot learn of it;
`docs/retired-prover-keys.md` has what that means and the notice to publish.

The wallet pins it from data (`core/crates/wallet-core/src/trusted-prover-pool.json`, copied from
the operators' `pool.json`; the same descriptor is served at
`https://prover.randprotocol.org/.well-known/rand-prover-pool.json` for people and tools — a wallet
Expand Down
53 changes: 53 additions & 0 deletions docs/retired-prover-keys.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,53 @@
# Retired RandProtocol prover keys

| key | what it was | pinned by | retired |
|---|---|---|---|
| `RGTF-7HKJ-XZFV-GQ1J` | the key every pool machine shared | Rand Wallet 0.6.8 | 2026-10-01 |
| `ZEXQ-1JHV-ZT60-KFB5` | member a | Rand Wallet 0.6.9–0.8.0 | 2026-10-22 |
| `D2XV-WXVT-PZRC-D7G8` | member archive2 | Rand Wallet 0.6.9–0.8.0 | 2026-10-22 |
| `SR28-MYT0-GR6A-03DE` | member nyc3 | Rand Wallet 0.6.9–0.8.0 | 2026-10-22 |
| `GMNX-Q1QD-FEXG-JHJM` | member sfo3 | Rand Wallet 0.6.9–0.8.0 | 2026-10-22 |

## What a released wallet can and cannot do

A wallet's pinned provers are compiled into it. **A wallet released before a key was retired
keeps pinning that key, and nothing a server sends or a later release does can change it.** Rand
Wallet 0.6.9–0.8.0 therefore still trusts the four member keys above at
`https://prover.randprotocol.org/m/<name>`: if someone held one of those keys *and* could answer
at that address, such a wallet would seal its viewing key to them (never its spend key — a prover
is not sent it). In practice those versions find no prover today: the pool's members answer with
other keys, the wallet reports that the provers "cannot be reached", and it does not show the
pool's own "retired, update" answer. The remedy is to update.

What each version does:

| version | pins | when its pins are stale |
|---|---|---|
| 0.6.8 | the shared key | finds no prover |
| 0.6.9–0.8.0 | the four retired members | "cannot be reached right now … try again later" |
| 0.8.1 | a, b | — |
| 0.8.2 and later | a, b | "Update Rand Wallet to the latest version" when a pinned member answers with another key |
| the release after 0.8.6 | a, b, **and the retired list** | refuses a retired key wherever it comes from: a link, a stored pairing, or a pinned member |

The retired list (`RETIRED_PROVER_KEYS` in `ui/engine/backend-shared.js`) is how a retirement
reaches every wallet released after it. When a pool key is retired: add its fingerprint there and
to `rand`'s list (fullnode `crates/randprotocol-client/src/retired-provers.txt`) in the same
change that edits `trusted-prover-pool.json`; `ui/test/prover.test.mjs` fails if a pinned member
is on the list.

## The notice (for the release page, the site and the stores)

> **Update Rand Wallet if you run 0.8.0 or earlier.** Rand Wallet 0.6.9 to 0.8.0 pin four
> RandProtocol prover keys that were retired on 22 October 2026. Those versions can no longer use
> the RandProtocol provers — a send that needs them says the provers cannot be reached — and they
> still trust the retired keys. Update to the current Rand Wallet: it pins the current provers,
> tells you itself when its pins go out of date, and refuses the retired keys. Your funds are not
> at risk: a prover is only ever sent a viewing key, never the key that spends.

## The release-notes line (for the next wallet release)

- **Retired prover keys are refused.** The wallet carries the list of RandProtocol prover keys
that were retired (the shared key of 0.6.8 and the four members of 0.6.9–0.8.0) and never pairs
with one, never sends one a job, and skips a pinned member whose key is on it. A prover you
paired yourself is unaffected unless its key is on that list. If you still run 0.8.0 or earlier,
update: those versions cannot be told about a retired key.
30 changes: 30 additions & 0 deletions ui/engine/backend-shared.js
Original file line number Diff line number Diff line change
Expand Up @@ -113,6 +113,23 @@ import { t } from '../i18n.js';
* two strings that drift. Nothing about *where* storage lives belongs in this file: it is handed
* a `storage` and never asks what is behind it.
*/
/**
* RandProtocol prover keys that were retired (VK-9, randprotocol/monorepo#18): the key every pool
* machine shared until wallet 0.6.9, and the four members wallets 0.6.9 to 0.8.0 pinned. A wallet
* released before a key was retired still pins it and cannot be told otherwise; this list is what
* every release after the retirement carries. A listed key is never paired, never probed, never
* sent a job and never used as a pool member, whatever a link, a stored pairing or the pinned
* descriptor says. `rand` carries the same list (fullnode `retired-provers.txt`). Add an entry in
* the change that retires a key; never remove one.
*/
export const RETIRED_PROVER_KEYS = Object.freeze([
{ fingerprint: 'RGTF-7HKJ-XZFV-GQ1J', retiredOn: '2026-10-01' },
{ fingerprint: 'ZEXQ-1JHV-ZT60-KFB5', retiredOn: '2026-10-22' },
{ fingerprint: 'D2XV-WXVT-PZRC-D7G8', retiredOn: '2026-10-22' },
{ fingerprint: 'SR28-MYT0-GR6A-03DE', retiredOn: '2026-10-22' },
{ fingerprint: 'GMNX-Q1QD-FEXG-JHJM', retiredOn: '2026-10-22' },
].map(Object.freeze));

export const UNLOCKED_SESSION_KEY = 'unlocked';

// Storage keys. `unlocked` is the only session one.
Expand Down Expand Up @@ -1636,6 +1653,12 @@ export function makeSharedBackend({
return typeof fp === 'string' && fp === fingerprint;
}

/** The retired keys this build refuses: [`RETIRED_PROVER_KEYS`], or the test seam's list. */
const retiredKeys = proverOptions && Array.isArray(proverOptions.retiredKeys) ? proverOptions.retiredKeys : RETIRED_PROVER_KEYS;
/** Whether `fingerprint` is a retired prover key (VK-9). */
const isRetiredProverKey = (fingerprint) => retiredKeys.some((k) => k.fingerprint === String(fingerprint));
const retiredProverText = () => t('This prover\'s key was retired and is no longer used. Pair another prover in Settings, or update Rand Wallet to the latest version.');

function proverClientFor(url) {
return makeProverClient({ fetch: fetchImpl, url });
}
Expand Down Expand Up @@ -1682,6 +1705,8 @@ export function makeSharedBackend({
if (!p || typeof p.url !== 'string' || !p.url || (p.mode !== undefined && p.mode !== 'remote')) {
return { ok: false, reason: t('No prover is paired.') };
}
// A retired key is not asked anything (VK-9).
if (isRetiredProverKey(p.fingerprint)) return { ok: false, reason: retiredProverText() };
let info;
try {
info = readInfo(await proverClientFor(p.url).info());
Expand Down Expand Up @@ -1711,6 +1736,7 @@ export function makeSharedBackend({
let parsed;
try { parsed = await c.parseProverLink(m.link); } catch { continue; }
if (!m.fingerprint || String(parsed.fingerprint) !== m.fingerprint) continue;
if (isRetiredProverKey(m.fingerprint)) continue;
if (parsed.own === true) continue;
const checked = checkProverUrl(parsed.url);
if (checked.error || checked.url !== checkProverUrl(m.url).url) continue;
Expand Down Expand Up @@ -1847,6 +1873,8 @@ export function makeSharedBackend({
const key = await openVault(password);
if (!key) throw new Error('wrong password');
const parsed = await readProverLink(link);
// Before any network: a link that names a retired key is not paired (VK-9).
if (isRetiredProverKey(parsed.fingerprint)) throw new Error(retiredProverText());
const checked = checkProverUrl(parsed.url);
if (checked.error) throw new Error(checked.error);
let info;
Expand Down Expand Up @@ -2088,6 +2116,8 @@ export function makeSharedBackend({
}
const { token, kemEk, url, fingerprint, own } = pairing;
const refuse = (message) => { const err = new Error(message); err.definite = true; return err; };
// A pairing stored before its key was retired: nothing is built for it or sent to it (VK-9).
if (isRetiredProverKey(fingerprint)) throw refuse(retiredProverText());
return async ({ kind, request, maxProofBytes, hcBundle, hcAuth, meta, onPhase, signal }) => {
// What this chain's bundle guest takes, from the core, before anything is built: the viewing
// key on a split-authorisation chain, the spend key on an older one. It also refuses, here,
Expand Down
1 change: 1 addition & 0 deletions ui/locales/ar.js
Original file line number Diff line number Diff line change
Expand Up @@ -1129,4 +1129,5 @@ export default {
"the record was saved by a newer version of Rand Wallet": "حُفظ السجل بإصدار أحدث من Rand Wallet",
"the record does not open with this password": "لا يُفتح السجل بكلمة المرور هذه",
"block {height} has {got} of the {n} transactions its header announced": "الكتلة {height} تحتوي على {got} من أصل {n} معاملة أعلنت عنها ترويستها",
"This prover's key was retired and is no longer used. Pair another prover in Settings, or update Rand Wallet to the latest version.": "أُوقف العمل بمفتاح هذا المُثبِت ولم يعد مستخدمًا. اقرن مُثبِتًا آخر في الإعدادات، أو حدّث Rand Wallet إلى أحدث إصدار.",
};
1 change: 1 addition & 0 deletions ui/locales/de.js
Original file line number Diff line number Diff line change
Expand Up @@ -1129,4 +1129,5 @@ export default {
"the record was saved by a newer version of Rand Wallet": "der Datensatz wurde von einer neueren Version von Rand Wallet gespeichert",
"the record does not open with this password": "der Datensatz lässt sich mit diesem Passwort nicht öffnen",
"block {height} has {got} of the {n} transactions its header announced": "Block {height} enthält {got} der {n} Transaktionen, die sein Header angekündigt hat",
"This prover's key was retired and is no longer used. Pair another prover in Settings, or update Rand Wallet to the latest version.": "Der Schlüssel dieses Provers wurde außer Betrieb genommen und wird nicht mehr verwendet. Kopple in den Einstellungen einen anderen Prover oder aktualisiere Rand Wallet auf die neueste Version.",
};
3 changes: 2 additions & 1 deletion ui/locales/en.js
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
// value, or an object of CLDR plural categories ({one, few, many, other}) for a key with an
// {n} hole whose translation inflects by number. `{name}` holes and the words in the glossary
// at the top of each dictionary are kept as they are.
// 1122 strings.
// 1123 strings.
export default {
"{amount} {symbol}": "{amount} {symbol}",
"{blocks} blocks left to prove it.": "{blocks} blocks left to prove it.",
Expand Down Expand Up @@ -982,6 +982,7 @@ export default {
"This prover does not know this pairing. Pair it again in Settings.": "This prover does not know this pairing. Pair it again in Settings.",
"This prover will be able to read this wallet's whole history — every payment received and sent, before and after today. It cannot spend. To keep your history private, run your own.": "This prover will be able to read this wallet's whole history — every payment received and sent, before and after today. It cannot spend. To keep your history private, run your own.",
"This prover will be able to read this wallet's whole history. It cannot spend.": "This prover will be able to read this wallet's whole history. It cannot spend.",
"This prover's key was retired and is no longer used. Pair another prover in Settings, or update Rand Wallet to the latest version.": "This prover's key was retired and is no longer used. Pair another prover in Settings, or update Rand Wallet to the latest version.",
"This Rand Wallet cannot run programs.": "This Rand Wallet cannot run programs.",
"This Rand Wallet cannot withdraw to another chain.": "This Rand Wallet cannot withdraw to another chain.",
"this record is {n} bytes; the most it may be is {max}": "this record is {n} bytes; the most it may be is {max}",
Expand Down
1 change: 1 addition & 0 deletions ui/locales/es.js
Original file line number Diff line number Diff line change
Expand Up @@ -1129,4 +1129,5 @@ export default {
"the record was saved by a newer version of Rand Wallet": "el registro se guardó con una versión más reciente de Rand Wallet",
"the record does not open with this password": "el registro no se abre con esta contraseña",
"block {height} has {got} of the {n} transactions its header announced": "el bloque {height} tiene {got} de las {n} transacciones que anunció su cabecera",
"This prover's key was retired and is no longer used. Pair another prover in Settings, or update Rand Wallet to the latest version.": "La clave de este probador fue retirada y ya no se usa. Vincula otro probador en Ajustes o actualiza Rand Wallet a la última versión.",
};
1 change: 1 addition & 0 deletions ui/locales/fa.js
Original file line number Diff line number Diff line change
Expand Up @@ -1130,4 +1130,5 @@ export default {
"the record was saved by a newer version of Rand Wallet": "رکورد با نسخه‌ی جدیدتری از Rand Wallet ذخیره شده است",
"the record does not open with this password": "رکورد با این گذرواژه باز نمی‌شود",
"block {height} has {got} of the {n} transactions its header announced": "بلوک {height} تنها {got} تراکنش از {n} تراکنشی را دارد که سرآیندش اعلام کرده بود",
"This prover's key was retired and is no longer used. Pair another prover in Settings, or update Rand Wallet to the latest version.": "کلید این اثبات‌گر بازنشسته شده و دیگر استفاده نمی‌شود. اثبات‌گر دیگری را در تنظیمات جفت کنید، یا Rand Wallet را به آخرین نسخه به‌روزرسانی کنید.",
};
1 change: 1 addition & 0 deletions ui/locales/fr.js

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

1 change: 1 addition & 0 deletions ui/locales/hi.js
Original file line number Diff line number Diff line change
Expand Up @@ -1129,4 +1129,5 @@ export default {
"the record was saved by a newer version of Rand Wallet": "रिकॉर्ड Rand Wallet के नए संस्करण से सहेजा गया था",
"the record does not open with this password": "रिकॉर्ड इस पासवर्ड से नहीं खुलता",
"block {height} has {got} of the {n} transactions its header announced": "ब्लॉक {height} में उसके हेडर द्वारा घोषित {n} लेनदेन में से {got} हैं",
"This prover's key was retired and is no longer used. Pair another prover in Settings, or update Rand Wallet to the latest version.": "इस प्रूवर की की हटा दी गई है और अब इस्तेमाल नहीं होती। सेटिंग्स में कोई दूसरा प्रूवर पेयर करें, या Rand Wallet को नवीनतम संस्करण में अपडेट करें।",
};
1 change: 1 addition & 0 deletions ui/locales/id.js
Original file line number Diff line number Diff line change
Expand Up @@ -1122,4 +1122,5 @@ export default {
"the record was saved by a newer version of Rand Wallet": "rekaman disimpan oleh versi Rand Wallet yang lebih baru",
"the record does not open with this password": "rekaman tidak terbuka dengan kata sandi ini",
"block {height} has {got} of the {n} transactions its header announced": "blok {height} berisi {got} dari {n} transaksi yang diumumkan header-nya",
"This prover's key was retired and is no longer used. Pair another prover in Settings, or update Rand Wallet to the latest version.": "Kunci prover ini telah dipensiunkan dan tidak lagi digunakan. Pasangkan prover lain di Pengaturan, atau perbarui Rand Wallet ke versi terbaru.",
};
1 change: 1 addition & 0 deletions ui/locales/it.js
Original file line number Diff line number Diff line change
Expand Up @@ -1129,4 +1129,5 @@ export default {
"the record was saved by a newer version of Rand Wallet": "il record è stato salvato da una versione più recente di Rand Wallet",
"the record does not open with this password": "il record non si apre con questa password",
"block {height} has {got} of the {n} transactions its header announced": "il blocco {height} contiene {got} delle {n} transazioni annunciate dalla sua intestazione",
"This prover's key was retired and is no longer used. Pair another prover in Settings, or update Rand Wallet to the latest version.": "La chiave di questo prover è stata ritirata e non è più in uso. Associa un altro prover nelle Impostazioni, oppure aggiorna Rand Wallet all'ultima versione.",
};
1 change: 1 addition & 0 deletions ui/locales/ja.js
Original file line number Diff line number Diff line change
Expand Up @@ -1122,4 +1122,5 @@ export default {
"the record was saved by a newer version of Rand Wallet": "レコードは新しいバージョンの Rand Wallet で保存されています",
"the record does not open with this password": "このパスワードではレコードを開けません",
"block {height} has {got} of the {n} transactions its header announced": "ブロック {height} には、ヘッダーが示した {n} 件のトランザクションのうち {got} 件しかありません",
"This prover's key was retired and is no longer used. Pair another prover in Settings, or update Rand Wallet to the latest version.": "このプルーバーの鍵は廃止され、もう使われていません。設定で別のプルーバーをペアリングするか、Rand Wallet を最新バージョンに更新してください。",
};
1 change: 1 addition & 0 deletions ui/locales/ko.js
Original file line number Diff line number Diff line change
Expand Up @@ -1122,4 +1122,5 @@ export default {
"the record was saved by a newer version of Rand Wallet": "레코드가 더 새로운 버전의 Rand Wallet에서 저장되었습니다",
"the record does not open with this password": "이 비밀번호로는 레코드가 열리지 않습니다",
"block {height} has {got} of the {n} transactions its header announced": "블록 {height}에는 헤더가 알린 트랜잭션 {n}개 중 {got}개만 있습니다",
"This prover's key was retired and is no longer used. Pair another prover in Settings, or update Rand Wallet to the latest version.": "이 프루버의 키는 폐기되어 더 이상 사용되지 않습니다. 설정에서 다른 프루버를 페어링하거나 Rand Wallet을 최신 버전으로 업데이트하세요.",
};
1 change: 1 addition & 0 deletions ui/locales/ms.js
Original file line number Diff line number Diff line change
Expand Up @@ -1124,4 +1124,5 @@ export default {
"the record was saved by a newer version of Rand Wallet": "rekod disimpan oleh versi Rand Wallet yang lebih baharu",
"the record does not open with this password": "rekod tidak terbuka dengan kata laluan ini",
"block {height} has {got} of the {n} transactions its header announced": "blok {height} mengandungi {got} daripada {n} transaksi yang diumumkan oleh pengepalanya",
"This prover's key was retired and is no longer used. Pair another prover in Settings, or update Rand Wallet to the latest version.": "Kunci pembukti ini telah dibersarakan dan tidak lagi digunakan. Pasangkan pembukti lain dalam Tetapan, atau kemas kini Rand Wallet ke versi terkini.",
};
1 change: 1 addition & 0 deletions ui/locales/pl.js
Original file line number Diff line number Diff line change
Expand Up @@ -1125,4 +1125,5 @@ export default {
"the record was saved by a newer version of Rand Wallet": "rekord został zapisany przez nowszą wersję Rand Wallet",
"the record does not open with this password": "rekord nie otwiera się tym hasłem",
"block {height} has {got} of the {n} transactions its header announced": "blok {height} zawiera {got} z {n} transakcji zapowiedzianych w nagłówku",
"This prover's key was retired and is no longer used. Pair another prover in Settings, or update Rand Wallet to the latest version.": "Klucz tego provera został wycofany i nie jest już używany. Sparuj inny prover w Ustawieniach lub zaktualizuj Rand Wallet do najnowszej wersji.",
};
Loading
Loading