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

# Test format: BLS signature aggregation

A BLS signature aggregation combines a series of signatures into a single signature.

## Test case format

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

```yaml
input: List[BLS Signature] -- list of input BLS signatures
output: BLS Signature -- expected output, single BLS signature or `null`.
```

- `BLS Signature` here is encoded as a string: hexadecimal encoding of 96 bytes (192 nibbles), prefixed with `0x`.
- output value is `null` if the input is invalid.

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

## Condition

The `aggregate` handler should aggregate the signatures in the `input`, and the result should match the expected `output`.
minor naming tweaks, document BLS and deposit test formats 2019-04-12 12:15:30 +00:00			`# Test format: BLS signature aggregation`

			`A BLS signature aggregation combines a series of signatures into a single signature.`

			`## Test case format`

update test format docs with new test structure 2019-07-30 12:09:20 +00:00			The test data is declared in a `data.yaml` file:

minor naming tweaks, document BLS and deposit test formats 2019-04-12 12:15:30 +00:00			```yaml
			`input: List[BLS Signature] -- list of input BLS signatures`
Update BLS test format: output `null` for invalid case 2022-09-20 17:20:20 +00:00			output: BLS Signature -- expected output, single BLS signature or `null`.
minor naming tweaks, document BLS and deposit test formats 2019-04-12 12:15:30 +00:00			```

Add `Aggregate()` case 2020-05-15 15:27:35 +00:00			- `BLS Signature` here is encoded as a string: hexadecimal encoding of 96 bytes (192 nibbles), prefixed with `0x`.
Update BLS test format: output `null` for invalid case 2022-09-20 17:20:20 +00:00			- output value is `null` if the input is invalid.
minor naming tweaks, document BLS and deposit test formats 2019-04-12 12:15:30 +00:00
Apply PR feedback from Danny and clean up the BLS test format docs 2021-08-06 08:39:35 +00:00			All byte(s) fields are encoded as strings, hexadecimal encoding, prefixed with `0x`.

minor naming tweaks, document BLS and deposit test formats 2019-04-12 12:15:30 +00:00			`## Condition`

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			The `aggregate` handler should aggregate the signatures in the `input`, and the result should match the expected `output`.