KarpelesLab / libwallet / 26146692490
22%

DEFAULT BRANCH: master
Ran
Jobs 1
Files 119
Run time 1min
Badge
Embed ▾
README BADGES
x

If you need to use a raster PNG badge, change the '.svg' to '.png' in the link

Markdown

Textile

RDoc

HTML

Rst
coverage: 22.105%. Remained the same
26146692490

push

github

MagicalTux 
dart/doc: device-share backup-and-restore guide for implementors

After a JSON-only restore on a fresh device the wallet's StoreKey
private key isn't reachable — it lives in the host's platform
keystore, never in the libwallet backup blob. The hosts that
discovered this in practice (Tibane: "Device share not found on
this device") then have to decide between rotating the device
share via reshare or bundling the device key into the backup file;
both work, both have tradeoffs, and neither was documented.

Write the canonical implementor guide describing:
  - the 1-of-3 (StoreKey + RemoteKey + Password, T=1) committee
    shape and why two of those shares are always reachable after
    a JSON restore (Remote + Password) — so the rotation flow
    always has its T+1=2 inputs;
  - the recommended restore path: detect missing device share,
    mint a fresh StoreKey, reshare onto the new committee (the
    wallet's pubkey survives, so funds stay put);
  - the opt-in manual-transfer case where the device share IS
    bundled into the backup, with the security tradeoffs spelled
    out so a host that ships this knows what UX warnings to
    paint;
  - what NEVER to do — bundle the device share into the default
    backup, prompt the user to "re-import" when only one share is
    missing, etc.

Drop the file at `dart/doc/device_share.md`, point at it from the
WalletApi.backup / WalletApi.restore docstrings, and surface it
from the package README's Backup / Restore section.

Docs-only change; no version bump.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

3798 of 17182 relevant lines covered (22.1%)

110.7 hits per line

Jobs
ID Job ID Ran Files Coverage
1 26146692490.1 119
22.1
 GitHub Action Run
Source Files on build 26146692490