status-im
/
eth2.0-specs
mirror of https://github.com/status-im/eth2.0-specs.git
2
0
Fork 0
Code Issues Projects Releases Wiki Activity

Update README

This commit is contained in:
Hsiao-Wei Wang 2020-05-15 23:38:25 +08:00
parent d07e594f92
commit fd3cce0d2c
No known key found for this signature in database
GPG Key ID: 95B070122902DEA4
2 changed files with 9 additions and 20 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
tests/formats/bls/README.md
View File

@ -5,11 +5,10 @@ We do not recommend rolling your own crypto or using an untested BLS library.
The BLS test suite runner has the following handlers: The BLS test suite runner has the following handlers:
- [`aggregate_pubkeys`](./aggregate_pubkeys.md) - [`aggregate_verify`](./aggregate_verify.md)
- [`aggregate_sigs`](./aggregate_sigs.md) - [`aggregate`](./aggregate.md)
- [`msg_hash_g2_compressed`](./msg_hash_g2_compressed.md) - [`fast_aggregate_verify`](./fast_aggregate_verify.md)
- [`msg_hash_g2_uncompressed`](./msg_hash_g2_uncompressed.md) - [`sign`](./sign.md)
- [`priv_to_pub`](./priv_to_pub.md) - [`verify`](./verify.md)
- [`sign_msg`](./sign_msg.md)
*Note*: Signature-verification and aggregate-verify test cases are not yet supported. *Note*: Signature-verification and aggregate-verify test cases are not yet supported.

16
tests/generators/bls/README.md
View File

@ -1,21 +1,11 @@
# BLS Test Generator # BLS Test Generator
Explanation of BLS12-381 type hierarchy The [BLS Signature APIs](../../../specs/phase0/beacon-chain.md#bls-signatures)
The base unit is bytes48 of which only 381 bits are used
- FQ: uint381 modulo field modulus Information on the format of the tests can be found in the [BLS test formats documentation](../../formats/bls/README.md).
- FQ2: (FQ, FQ)
- G2: (FQ2, FQ2, FQ2)
## Resources ## Resources
- [Eth2 spec](../../../specs/phase0/beacon-chain.md#bls-signatures) - [IETF BLS Signature Scheme](https://datatracker.ietf.org/doc/draft-irtf-cfrg-bls-signature/)
- [Finite Field Arithmetic](http://www.springeronline.com/sgw/cda/pageitems/document/cda_downloaddocument/0,11996,0-0-45-110359-0,00.pdf) - [Finite Field Arithmetic](http://www.springeronline.com/sgw/cda/pageitems/document/cda_downloaddocument/0,11996,0-0-45-110359-0,00.pdf)
- Chapter 2 of [Elliptic Curve Cryptography](http://cacr.uwaterloo.ca/ecc/). Darrel Hankerson, Alfred Menezes, and Scott Vanstone - Chapter 2 of [Elliptic Curve Cryptography](http://cacr.uwaterloo.ca/ecc/). Darrel Hankerson, Alfred Menezes, and Scott Vanstone
- [Zcash BLS parameters](https://github.com/zkcrypto/pairing/tree/master/src/bls12_381)
- [Trinity implementation](https://github.com/ethereum/trinity/blob/master/eth2/_utils/bls.py)
## Comments
Compared to Zcash, Ethereum specs always requires the compressed form (c_flag / most significant bit always set).
Also note that pubkeys and privkeys are reversed.