protolambda/bls12-381-util
0
Fork 0
mirror of https://github.com/protolambda/bls12-381-util.git synced 2026-10-22 19:09:03 +00:00
Code Issues Releases Packages Activity
BLS 12-381 utils, POP signature scheme, pure Go (use at own risk).
18 commits 1 branch 1 tag 72 KiB
  • Go 99.7%
  • Makefile 0.3%
Find a file
Exact
protolambda 8c499a1eab
 go.mod,ci: update to Go 1.21
History 2024-02-19 02:08:15 -06:00
.github/workflows go.mod,ci: update to Go 1.21 2024-02-19 02:08:15 -06:00
.gitignore remove yaml dep, pull test vectors, update to json test vector parsing 2021-08-12 14:58:50 +02:00
go.mod go.mod,ci: update to Go 1.21 2024-02-19 02:08:15 -06:00
go.sum go.mod,ci: update to Go 1.21 2024-02-19 02:08:15 -06:00
LICENSE start of bls utils package 2021-07-13 22:57:40 +02:00
Makefile test updates + defer-bls: aggregate bls calls and check at the end 2022-04-17 00:08:08 +02:00
README.md update readme 2021-08-06 16:22:32 +02:00
sigagg.go test updates + defer-bls: aggregate bls calls and check at the end 2022-04-17 00:08:08 +02:00
sigagg_test.go test updates + defer-bls: aggregate bls calls and check at the end 2022-04-17 00:08:08 +02:00
signatures.go test updates + defer-bls: aggregate bls calls and check at the end 2022-04-17 00:08:08 +02:00
signatures_test.go test updates + defer-bls: aggregate bls calls and check at the end 2022-04-17 00:08:08 +02:00
sigset.go test updates + defer-bls: aggregate bls calls and check at the end 2022-04-17 00:08:08 +02:00
sigset_bench_test.go signature set support 2021-07-20 12:52:58 +02:00
sigset_test.go test updates + defer-bls: aggregate bls calls and check at the end 2022-04-17 00:08:08 +02:00

README.md

BLS 12-381 util

BLS 12-381 util (BLSU, "bless you") is a collection of utils to work with BLS 12-381 in Go.

Warning: these wrapper utils have not been audited.

This package wraps github.com/kilic/bls12-381, a pure Go implementation of BLS, no CGO involved, no special dependencies. Instead, this BLS implementation uses Go-assembly to optimize the lower level computations. audit info.

This package implements the BLS_SIG_BLS12381G2_XMD:SHA-256_SSWU_RO_POP_ ciphersuite.

TODO: not safe for 32 bit usage: kilic BLS Fr.FromBytes->Fr.fromBytes->Fr.fromBig assumes word size is 64 bits.

Utils

  • Eth2 Typing
    • Pubkeys: PointG1 wrapper
    • Signatures: PointG2 wrapper
    • Secret keys: Fr wrapper
    • Signatures sets: see below
  • Draft 4 for signatures
    • Hash to curve, from kilic/bls12-381: BLS12381G2_XMD:SHA-256_SSWU_RO_
    • Schemes:
      • Core operations:
        • KeyGen (TODO)
        • SkToPk
        • KeyValidate, implemented as part of Pubkey deserialization, except identity-pubkey check (checked in verify functions instead).
        • CoreSign
        • CoreVerify
        • Aggregate
        • CoreAggregateVerify
      • Basic scheme, not supported
      • Message Augmentation scheme, not supported
      • POP, Proof of Possession scheme (used in Eth2):
        • PopProve, not supported, assumed through application-specific implementation
        • PopVerify, not supported, assumed through application-specific implementation
        • FastAggregateVerify
  • Eth2 additions
  • Signature sets: verify non-singular set of signatures and its respective pubkeys and messages

Testing

  • Unit tests
    • SecretKey deserialization/serialization
    • Pubkey deserialization/serialization (with KeyValidate routine, except identity-pubkey check)
    • Signature deserialization/serialization
    • SkToPk (TODO: expand)
    • SignatureSetVerify
  • Eth2 BLS tests
    • Sign
    • Aggregate
    • Verify
    • AggregateVerify
    • FastAggregateVerify
    • AggregatePubkeys
    • Eth2FastAggregateVerify
  • Eth2 spec tests
    • Integrate into ZRNT, run full eth2 test-suite
  • standard tests (if any)
    • TODO, need standard signature-scheme test vectors (Work in progress)
    • Run Hash-to-curve test-vectors on kilic/bls12-381 internals

License

MIT, see LICENSE file.