-
Notifications
You must be signed in to change notification settings - Fork 22
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Browse files
Browse the repository at this point in the history
#262 New release v0.4.1 after this is merged
- Loading branch information
1 parent
fdc18c8
commit a4257b4
Showing
4 changed files
with
357 additions
and
113 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,80 @@ | ||
# Proof of Possession (PoP) Specification | ||
|
||
## Overview | ||
|
||
The Proof of Possession (PoP) structured specification outlined in this | ||
document allows for the verification of the mutual ownership of a Babylon | ||
key pair and an EOTS key pair. In the following, we outline the five essential | ||
attributes exposed by the `PoPExport` structure and provide examples and | ||
validation procedures. | ||
|
||
## Attributes | ||
|
||
The `PoPExport` structure is defined bellow: | ||
|
||
```go | ||
// PoPExport the data needed to prove ownership of the eots and babylon key pairs. | ||
type PoPExport struct { | ||
// Btc public key is the EOTS PK *bbntypes.BIP340PubKey marshal hex | ||
EotsPublicKey string `json:"eotsPublicKey"` | ||
// Babylon public key is the *secp256k1.PubKey marshal hex | ||
BabyPublicKey string `json:"babyPublicKey"` | ||
|
||
// Babylon key pair signs EOTS public key as hex | ||
BabySignEotsPk string `json:"babySignEotsPk"` | ||
// Schnorr signature of EOTS private key over the SHA256(Baby address) | ||
EotsSignBaby string `json:"eotsSignBaby"` | ||
|
||
// Babylon address ex.: bbn1f04czxeqprn0s9fe7kdzqyde2e6nqj63dllwsm | ||
BabyAddress string `json:"babyAddress"` | ||
} | ||
``` | ||
|
||
Detailed specification of each field: | ||
|
||
- `EotsPublicKey`: The EOTS public key of the finality provider in hexadecimal format. | ||
- `BabyPublicKey` – The Babylon secp256k1 public key in base64 format. | ||
- `BabyAddress` – The Babylon account address (`bbn` prefix). The address is | ||
derived from the `BabyPublicKey` and used as the primary identifier on the | ||
Babylon network. | ||
- `EotsSignBaby` – A Schnorr signature in base64 format, created by signing the | ||
`sha256(BabyAddress)` with the EOTS private key. | ||
- `BabySignEotsPk` – A signature of the `EotsPublicKey`, created by the Babylon | ||
private key. This signature follows the Cosmos | ||
[ADR-036](https://github.com/cosmos/cosmos-sdk/blob/main/docs/architecture/adr-036-arbitrary-signature.md) | ||
specification and is encoded in base64. | ||
|
||
## Example | ||
|
||
Below is an example JSON representation of the PoPExport structure: | ||
|
||
```json | ||
{ | ||
"eotsPublicKey": "3d0bebcbe800236ce8603c5bb1ab6c2af0932e947db4956a338f119797c37f1e", | ||
"babyPublicKey": "A0V6yw74EdvoAWVauFqkH/GVM9YIpZitZf6bVEzG69tT", | ||
"babySignEotsPk": "AOoIG2cwC2IMiJL3OL0zLEIUY201X1qKumDr/1qDJ4oQvAp78W1nb5EnVasRPQ/XrKXqudUDnZFprLd0jaRJtQ==", | ||
"eotsSignBaby": "pR6vxgU0gXq+VqO+y7dHpZgHTz3zr5hdqXXh0WcWNkqUnRjHrizhYAHDMV8gh4vks4PqzKAIgZ779Wqwf5UrXQ==", | ||
"babyAddress": "bbn1f04czxeqprn0s9fe7kdzqyde2e6nqj63dllwsm" | ||
} | ||
``` | ||
|
||
## Validation | ||
|
||
The function responsible for validating the `PoPExport` is `VerifyPopExport`, | ||
which can be found [here](https://github.com/babylonlabs-io/finality-provider/blob/cc07bcd4dc434f7095668724aad6865bffe425e0/eotsmanager/cmd/eotsd/daemon/pop.go#L211). | ||
|
||
`VerifyPopExport` ensures the authenticity and integrity of the `PoPExport` | ||
by cross-verifying the provided signatures and public keys. This process | ||
consists of two core validation steps: | ||
|
||
- `ValidEotsSignBaby` – This function checks the validity of the Schnorr | ||
signature `(EotsSignBaby)` by verifying that the EOTS private key has correctly | ||
signed the SHA256 hash of the BABY address. | ||
- `ValidBabySignEots` – This function confirms that the BABY private key has | ||
signed the EOTS public key `(EotsPublicKey)`, ensuring mutual validation | ||
between the key pairs. | ||
|
||
If both signatures pass verification, the export is deemed valid, confirming | ||
that the finality provider holds both key pairs. This function plays a critical | ||
role in maintaining trust and security in the finality provider's key | ||
management process. |
Oops, something went wrong.