Skip to content

Commit f387464

Browse files
sirtimidclaude
andcommitted
docs(evm-wallet-experiment): clarify throwaway keyring is ephemeral
Document that throwaway keyrings regenerate their private key on each `makeKeyring` call (including vat restarts), since baggage only persists `{ type: 'throwaway' }`. Callers needing stability across restarts must use `type: 'srp'`. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent d00e27e commit f387464

1 file changed

Lines changed: 5 additions & 0 deletions

File tree

packages/evm-wallet-experiment/src/lib/keyring.ts

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,11 @@ const harden = globalThis.harden ?? (<T>(value: T): T => value);
1414

1515
/**
1616
* Options for initializing a keyring.
17+
*
18+
* Throwaway keyrings are intentionally ephemeral: each call to `makeKeyring`
19+
* generates a fresh private key, so the key does not survive a vat restart.
20+
* Baggage only persists `{ type: 'throwaway' }`; callers that need key
21+
* stability across restarts must use `type: 'srp'`.
1722
*/
1823
export type KeyringInitOptions =
1924
| { type: 'srp'; mnemonic: string; addressIndex?: number }

0 commit comments

Comments
 (0)