Skip to content

Commit

Permalink
whitepapers: document signing prefixes used
Browse files Browse the repository at this point in the history
  • Loading branch information
evan-gray committed Aug 30, 2024
1 parent 2cce7a5 commit ddeb560
Showing 1 changed file with 30 additions and 3 deletions.
33 changes: 30 additions & 3 deletions whitepapers/0009_guardian_key.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,10 +14,16 @@ The Guardian Key is used to:

1. Sign gossip messages
1. heartbeat
2. governor config and governor status
3. observation request
2. Sign Observations
1. governor config and governor status
1. observation request
1. Sign Observations
1. Version 1 VAAs
1. Sign Guardian identification
1. Wormchain account registration
1. Sign Accountant observations
1. Token Bridge
1. NTT
1. Sign Query responses

## Detailed Design

Expand All @@ -35,3 +41,24 @@ Rationale

- Gossip messages cannot be confused with other gossip messages because the message type prefix is prepended.
- Gossip messages cannot be confused with observations because observations utilize a double-Keccak256 and the payload is enforced to be `>=34` bytes.

## Prefixes Used

<!-- cspell:disable -->

```go
acct_sub_obsfig_000000000000000000| // token bridge accountant observation
ntt_acct_sub_obsfig_00000000000000| // ntt accountant observation
governor_config_000000000000000000| // gossip governor config
governor_status_000000000000000000| // gossip governor status
heartbeat| // gossip heartbeat
signed_observation_request| // gossip signed observation request
mainnet_query_request_000000000000| // query request (mainnet, not signed by guardian)
testnet_query_request_000000000000| // query request (testnet, not signed by guardian)
devnet_query_request_0000000000000| // query request (devnet, not signed by guardian)
query_response_0000000000000000000| // query response
query_response_0000000000000000000| // query response
signed_wormchain_address_00000000| // wormchain register account as guardian
```

<!-- cspell:enable -->

0 comments on commit ddeb560

Please sign in to comment.