Skip to content

[Guardian] [2/3] Support multiple KP certs per share#791

Open
mskd12 wants to merge 1 commit into
mainfrom
deepakmaram/iop-487-kp-cert-groups
Open

[Guardian] [2/3] Support multiple KP certs per share#791
mskd12 wants to merge 1 commit into
mainfrom
deepakmaram/iop-487-kp-cert-groups

Conversation

@mskd12

@mskd12 mskd12 commented Jul 9, 2026

Copy link
Copy Markdown
Contributor

Stacked on #840.

Summary

This PR lets each KP roster entry contain more than one PGP certificate. The roster order still assigns one share to each KP.

The guardian encrypts that share separately for every certificate in the entry and stores each ciphertext by fingerprint. It rejects duplicate fingerprints and verifies that each ciphertext is encrypted to the matching certificate.

The KP ceremony uses kp_pgp_cert_path to find the KP roster entry, then decrypts every copy and checks the share commitment. Provisioning decrypts and signs with only the selected certificate.

Validation

  • make fmt
  • CI

@github-actions

github-actions Bot commented Jul 9, 2026

Copy link
Copy Markdown
PR Preview Action v1.8.1

QR code for preview link

🚀 View preview at
https://MystenLabs.github.io/hashi/pr-preview/pr-791/

Built to branch gh-pages at 2026-07-18 00:28 UTC.
Preview will be ready when the GitHub Pages deployment is complete.

@mskd12 mskd12 changed the title [guardian] support multiple KP certs per share [Guardian] Support multiple certs per KP Jul 15, 2026
@mskd12
mskd12 marked this pull request as ready for review July 15, 2026 23:17
@mskd12
mskd12 requested a review from bmwill as a code owner July 15, 2026 23:17
@mskd12
mskd12 requested a review from dlukegordon July 15, 2026 23:18
@mskd12 mskd12 changed the title [Guardian] Support multiple certs per KP [Guardian] Support multiple KP certs per share Jul 15, 2026
@jessiemongeon1

Copy link
Copy Markdown
Collaborator

Style Guide Audit

All 1 file(s) pass the style guide audit.

@mskd12 mskd12 changed the title [Guardian] Support multiple KP certs per share [Guardian] [1/2] Support multiple KP certs per share Jul 16, 2026
@mskd12
mskd12 requested a review from 0xsiddharthks July 17, 2026 20:53
pub sharing_seq: u64,
pub cert_seq: u64,
pub encrypted_shares: KPEncryptedShares,
pub encrypted_shares: KPEncryptedSharesRoster,

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This changes the persisted kp-shares v1 format, so existing signed recovery records will no longer deserialize. Can we introduce a v2 log schema and retain v1 decoding? Otherwise upgraded guardians cannot recover the existing BTC key.

Comment thread crates/hashi-guardian-init/README.md
@mskd12 mskd12 changed the title [Guardian] [1/2] Support multiple KP certs per share [Guardian] [2/3] Support multiple KP certs per share Jul 17, 2026
@mskd12
mskd12 changed the base branch from main to deepakmaram/remove-shares-from-guardian-info July 17, 2026 23:40
Base automatically changed from deepakmaram/remove-shares-from-guardian-info to main July 18, 2026 00:10
@mskd12
mskd12 force-pushed the deepakmaram/iop-487-kp-cert-groups branch from bcd3101 to 54d25a0 Compare July 18, 2026 00:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants