You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

54 lines
2.0 KiB

2 years ago
  1. # kzg-commitments-study [![GoDoc](https://godoc.org/github.com/arnaucube/kzg-commitments-study?status.svg)](https://godoc.org/github.com/arnaucube/kzg-commitments-study) [![Go Report Card](https://goreportcard.com/badge/github.com/arnaucube/kzg-commitments-study)](https://goreportcard.com/report/github.com/arnaucube/kzg-commitments-study) [![Test](https://github.com/arnaucube/kzg-commitments-study/workflows/Test/badge.svg)](https://github.com/arnaucube/kzg-commitments-study/actions?query=workflow%3ATest)
  2. Doing this to study and learn [KZG commitments](http://cacr.uwaterloo.ca/techreports/2010/cacr2010-10.pdf), do not use in production. More details at https://arnaucube.com/blog/kzg-commitments.html .
  3. Thanks to [Dankrad Feist](https://dankradfeist.de/ethereum/2020/06/16/kate-polynomial-commitments.html), [Alin Tomescu](https://alinush.github.io/2020/05/06/kzg-polynomial-commitments.html), [Tom Walton-Pocock](https://hackmd.io/@tompocock/Hk2A7BD6U) for their articles, which helped me understand a bit the KZG Commitments.
  4. It uses the [ethereum bn256](https://github.com/ethereum/go-ethereum/tree/master/crypto/bn256/cloudflare).
  5. ### Usage
  6. ```go
  7. // p(x) = x^3 + x + 5
  8. p := []*big.Int{
  9. big.NewInt(5),
  10. big.NewInt(1), // x^1
  11. big.NewInt(0), // x^2
  12. big.NewInt(1), // x^3
  13. }
  14. assert.Equal(t, "1x³ + 1x¹ + 5", PolynomialToString(p))
  15. // TrustedSetup
  16. ts, err := NewTrustedSetup(p)
  17. assert.Nil(t, err)
  18. // Commit
  19. c := Commit(ts, p)
  20. // p(z)=y --> p(3)=35
  21. z := big.NewInt(3)
  22. y := big.NewInt(35)
  23. // z & y: to prove an evaluation p(z)=y
  24. proof, err := EvaluationProof(ts, p, z, y)
  25. assert.Nil(t, err)
  26. // verification
  27. v := Verify(ts, c, proof, z, y)
  28. assert.True(t, v)
  29. ```
  30. Batch Proofs:
  31. ```go
  32. // zs & ys contain the f(z_i)=y_i values that will be proved inside a batch proof
  33. zs := []*big.Int{z0, z1, z2}
  34. ys := []*big.Int{y0, y1, y2}
  35. // prove an evaluation of the multiple z_i & y_i
  36. proof, err := EvaluationBatchProof(ts, p, zs, ys)
  37. assert.Nil(t, err)
  38. // batch proof verification
  39. v := VerifyBatchProof(ts, c, proof, zs, ys)
  40. assert.True(t, v)
  41. ```