Skip to content

Commit da0cf45

Browse files
docs: update design/docs/service.mdx for PR MystenLabs#568
Automated update based on: New SignCommitteeTransition RPC added where peers sign with historical epoch BLS keys. Leader now drives guardian committee handoff to match on-chain epoch.
1 parent a935966 commit da0cf45

1 file changed

Lines changed: 26 additions & 1 deletion

File tree

design/docs/service.mdx

Lines changed: 26 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,31 @@ Hashi node exposes an HTTP service, secured by Transport Layer Security (TLS)
99
using a self-signed cert (the ed25519 public key is available in the Hashi
1010
System State object), and serves a gRPC `HashiService`.
1111

12+
## HashiService RPCs
13+
14+
The `HashiService` gRPC interface exposes the following RPCs:
15+
16+
- **SignCommitteeTransition:** Peers sign committee transition messages using their historical epoch BLS keys. The leader invokes this RPC on other committee members to collect signatures needed to advance the guardian committee to match the current on-chain epoch.
17+
18+
## Committee transitions
19+
20+
When the on-chain epoch changes, the guardian committee must transition to
21+
reflect the updated committee composition. The leader drives this handoff
22+
process:
23+
24+
1. The leader detects that the on-chain epoch has advanced beyond the current
25+
guardian committee epoch.
26+
2. The leader calls `SignCommitteeTransition` on each peer, requesting a
27+
signature over the new committee state.
28+
3. Each peer signs the transition message using its historical epoch BLS key
29+
that corresponds to the epoch in which the transition originates.
30+
4. Once the leader collects enough signatures, it finalizes the guardian
31+
committee handoff so that the guardian committee matches the on-chain epoch.
32+
33+
This mechanism ensures that the guardian committee stays in sync with the
34+
on-chain committee state and that transitions are authenticated by the members
35+
of the originating epoch.
36+
1237
## Sui contracts
1338

1439
- The Hashi Move packages are published as normal packages. The Hashi packages
@@ -43,4 +68,4 @@ block-beta
4368
end
4469
4570
broadcast["Ordered broadcast channel"]
46-
```
71+
```

0 commit comments

Comments
 (0)