eth2.0-specs/tests/formats/bls/aggregate_verify.md

# Test format: BLS sign message

Verify the signature against the given pubkeys and one messages.

## Test case format

The test data is declared in a `data.yaml` file:

```yaml
input:
  pubkeys: List[BLS Pubkey] -- the pubkeys
  messages: List[bytes32] -- the messages
  signature: BLS Signature -- the signature to verify against pubkeys and messages
output: bool  --  true (VALID) or false (INVALID)
```

- `BLS Pubkey` here is encoded as a string: hexadecimal encoding of 48 bytes (96 nibbles), prefixed with `0x`.
- `BLS Signature` here is encoded as a string: hexadecimal encoding of 96 bytes (192 nibbles), prefixed with `0x`.

All byte(s) fields are encoded as strings, hexadecimal encoding, prefixed with `0x`.

## Condition

The `aggregate_verify` handler should verify the signature with pubkeys and messages in the `input`, and the result should match the expected `output`.
Update BLS test suite to BLS standard draft v2 format 1. Make sure that BLS -Verify APIs would only return `True` or `False` , no exceptions. 2. Use `eth2spec.utils.bls` instead of py_ecc for test generator 3. Add assertions in test generator 4. Add some special test cases for the -Verify APIs 5. Clean up the test format documents 2020-05-14 16:45:26 +00:00			`# Test format: BLS sign message`

			`Verify the signature against the given pubkeys and one messages.`

			`## Test case format`

			The test data is declared in a `data.yaml` file:

			```yaml
			`input:`
Apply PR feedback from Danny and clean up the BLS test format docs 2021-08-06 08:39:35 +00:00			`pubkeys: List[BLS Pubkey] -- the pubkeys`
Update BLS test suite to BLS standard draft v2 format 1. Make sure that BLS -Verify APIs would only return `True` or `False` , no exceptions. 2. Use `eth2spec.utils.bls` instead of py_ecc for test generator 3. Add assertions in test generator 4. Add some special test cases for the -Verify APIs 5. Clean up the test format documents 2020-05-14 16:45:26 +00:00			`messages: List[bytes32] -- the messages`
Apply PR feedback from Danny and clean up the BLS test format docs 2021-08-06 08:39:35 +00:00			`signature: BLS Signature -- the signature to verify against pubkeys and messages`
			`output: bool -- true (VALID) or false (INVALID)`
Update BLS test suite to BLS standard draft v2 format 1. Make sure that BLS -Verify APIs would only return `True` or `False` , no exceptions. 2. Use `eth2spec.utils.bls` instead of py_ecc for test generator 3. Add assertions in test generator 4. Add some special test cases for the -Verify APIs 5. Clean up the test format documents 2020-05-14 16:45:26 +00:00			```

Apply PR feedback from Danny and clean up the BLS test format docs 2021-08-06 08:39:35 +00:00			- `BLS Pubkey` here is encoded as a string: hexadecimal encoding of 48 bytes (96 nibbles), prefixed with `0x`.
			- `BLS Signature` here is encoded as a string: hexadecimal encoding of 96 bytes (192 nibbles), prefixed with `0x`.

Update BLS test suite to BLS standard draft v2 format 1. Make sure that BLS -Verify APIs would only return `True` or `False` , no exceptions. 2. Use `eth2spec.utils.bls` instead of py_ecc for test generator 3. Add assertions in test generator 4. Add some special test cases for the -Verify APIs 5. Clean up the test format documents 2020-05-14 16:45:26 +00:00			All byte(s) fields are encoded as strings, hexadecimal encoding, prefixed with `0x`.
Apply PR feedback from Danny and clean up the BLS test format docs 2021-08-06 08:39:35 +00:00
			`## Condition`

			The `aggregate_verify` handler should verify the signature with pubkeys and messages in the `input`, and the result should match the expected `output`.