github.com/arjunbeliever/ignite@v0.0.0-20220406110515-46bbbbec2587/crypto/bls12381/fp2.go (about) 1 // Copyright 2020 The go-ethereum Authors 2 // This file is part of the go-ethereum library. 3 // 4 // The go-ethereum library is free software: you can redistribute it and/or modify 5 // it under the terms of the GNU Lesser General Public License as published by 6 // the Free Software Foundation, either version 3 of the License, or 7 // (at your option) any later version. 8 // 9 // The go-ethereum library is distributed in the hope that it will be useful, 10 // but WITHOUT ANY WARRANTY; without even the implied warranty of 11 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 12 // GNU Lesser General Public License for more details. 13 // 14 // You should have received a copy of the GNU Lesser General Public License 15 // along with the go-ethereum library. If not, see <http://www.gnu.org/licenses/>. 16 17 package bls12381 18 19 import ( 20 "errors" 21 "math/big" 22 ) 23 24 type fp2Temp struct { 25 t [4]*fe 26 } 27 28 type fp2 struct { 29 fp2Temp 30 } 31 32 func newFp2Temp() fp2Temp { 33 t := [4]*fe{} 34 for i := 0; i < len(t); i++ { 35 t[i] = &fe{} 36 } 37 return fp2Temp{t} 38 } 39 40 func newFp2() *fp2 { 41 t := newFp2Temp() 42 return &fp2{t} 43 } 44 45 func (e *fp2) fromBytes(in []byte) (*fe2, error) { 46 if len(in) != 96 { 47 return nil, errors.New("length of input string should be 96 bytes") 48 } 49 c1, err := fromBytes(in[:48]) 50 if err != nil { 51 return nil, err 52 } 53 c0, err := fromBytes(in[48:]) 54 if err != nil { 55 return nil, err 56 } 57 return &fe2{*c0, *c1}, nil 58 } 59 60 func (e *fp2) toBytes(a *fe2) []byte { 61 out := make([]byte, 96) 62 copy(out[:48], toBytes(&a[1])) 63 copy(out[48:], toBytes(&a[0])) 64 return out 65 } 66 67 func (e *fp2) new() *fe2 { 68 return new(fe2).zero() 69 } 70 71 func (e *fp2) zero() *fe2 { 72 return new(fe2).zero() 73 } 74 75 func (e *fp2) one() *fe2 { 76 return new(fe2).one() 77 } 78 79 func (e *fp2) add(c, a, b *fe2) { 80 add(&c[0], &a[0], &b[0]) 81 add(&c[1], &a[1], &b[1]) 82 } 83 84 func (e *fp2) addAssign(a, b *fe2) { 85 addAssign(&a[0], &b[0]) 86 addAssign(&a[1], &b[1]) 87 } 88 89 func (e *fp2) ladd(c, a, b *fe2) { 90 ladd(&c[0], &a[0], &b[0]) 91 ladd(&c[1], &a[1], &b[1]) 92 } 93 94 func (e *fp2) double(c, a *fe2) { 95 double(&c[0], &a[0]) 96 double(&c[1], &a[1]) 97 } 98 99 func (e *fp2) doubleAssign(a *fe2) { 100 doubleAssign(&a[0]) 101 doubleAssign(&a[1]) 102 } 103 104 func (e *fp2) ldouble(c, a *fe2) { 105 ldouble(&c[0], &a[0]) 106 ldouble(&c[1], &a[1]) 107 } 108 109 func (e *fp2) sub(c, a, b *fe2) { 110 sub(&c[0], &a[0], &b[0]) 111 sub(&c[1], &a[1], &b[1]) 112 } 113 114 func (e *fp2) subAssign(c, a *fe2) { 115 subAssign(&c[0], &a[0]) 116 subAssign(&c[1], &a[1]) 117 } 118 119 func (e *fp2) neg(c, a *fe2) { 120 neg(&c[0], &a[0]) 121 neg(&c[1], &a[1]) 122 } 123 124 func (e *fp2) mul(c, a, b *fe2) { 125 t := e.t 126 mul(t[1], &a[0], &b[0]) 127 mul(t[2], &a[1], &b[1]) 128 add(t[0], &a[0], &a[1]) 129 add(t[3], &b[0], &b[1]) 130 sub(&c[0], t[1], t[2]) 131 addAssign(t[1], t[2]) 132 mul(t[0], t[0], t[3]) 133 sub(&c[1], t[0], t[1]) 134 } 135 136 func (e *fp2) mulAssign(a, b *fe2) { 137 t := e.t 138 mul(t[1], &a[0], &b[0]) 139 mul(t[2], &a[1], &b[1]) 140 add(t[0], &a[0], &a[1]) 141 add(t[3], &b[0], &b[1]) 142 sub(&a[0], t[1], t[2]) 143 addAssign(t[1], t[2]) 144 mul(t[0], t[0], t[3]) 145 sub(&a[1], t[0], t[1]) 146 } 147 148 func (e *fp2) square(c, a *fe2) { 149 t := e.t 150 ladd(t[0], &a[0], &a[1]) 151 sub(t[1], &a[0], &a[1]) 152 ldouble(t[2], &a[0]) 153 mul(&c[0], t[0], t[1]) 154 mul(&c[1], t[2], &a[1]) 155 } 156 157 func (e *fp2) squareAssign(a *fe2) { 158 t := e.t 159 ladd(t[0], &a[0], &a[1]) 160 sub(t[1], &a[0], &a[1]) 161 ldouble(t[2], &a[0]) 162 mul(&a[0], t[0], t[1]) 163 mul(&a[1], t[2], &a[1]) 164 } 165 166 func (e *fp2) mulByNonResidue(c, a *fe2) { 167 t := e.t 168 sub(t[0], &a[0], &a[1]) 169 add(&c[1], &a[0], &a[1]) 170 c[0].set(t[0]) 171 } 172 173 func (e *fp2) mulByB(c, a *fe2) { 174 t := e.t 175 double(t[0], &a[0]) 176 double(t[1], &a[1]) 177 doubleAssign(t[0]) 178 doubleAssign(t[1]) 179 sub(&c[0], t[0], t[1]) 180 add(&c[1], t[0], t[1]) 181 } 182 183 func (e *fp2) inverse(c, a *fe2) { 184 t := e.t 185 square(t[0], &a[0]) 186 square(t[1], &a[1]) 187 addAssign(t[0], t[1]) 188 inverse(t[0], t[0]) 189 mul(&c[0], &a[0], t[0]) 190 mul(t[0], t[0], &a[1]) 191 neg(&c[1], t[0]) 192 } 193 194 func (e *fp2) mulByFq(c, a *fe2, b *fe) { 195 mul(&c[0], &a[0], b) 196 mul(&c[1], &a[1], b) 197 } 198 199 func (e *fp2) exp(c, a *fe2, s *big.Int) { 200 z := e.one() 201 for i := s.BitLen() - 1; i >= 0; i-- { 202 e.square(z, z) 203 if s.Bit(i) == 1 { 204 e.mul(z, z, a) 205 } 206 } 207 c.set(z) 208 } 209 210 func (e *fp2) frobeniusMap(c, a *fe2, power uint) { 211 c[0].set(&a[0]) 212 if power%2 == 1 { 213 neg(&c[1], &a[1]) 214 return 215 } 216 c[1].set(&a[1]) 217 } 218 219 func (e *fp2) frobeniusMapAssign(a *fe2, power uint) { 220 if power%2 == 1 { 221 neg(&a[1], &a[1]) 222 return 223 } 224 } 225 226 func (e *fp2) sqrt(c, a *fe2) bool { 227 u, x0, a1, alpha := &fe2{}, &fe2{}, &fe2{}, &fe2{} 228 u.set(a) 229 e.exp(a1, a, pMinus3Over4) 230 e.square(alpha, a1) 231 e.mul(alpha, alpha, a) 232 e.mul(x0, a1, a) 233 if alpha.equal(negativeOne2) { 234 neg(&c[0], &x0[1]) 235 c[1].set(&x0[0]) 236 return true 237 } 238 e.add(alpha, alpha, e.one()) 239 e.exp(alpha, alpha, pMinus1Over2) 240 e.mul(c, alpha, x0) 241 e.square(alpha, c) 242 return alpha.equal(u) 243 } 244 245 func (e *fp2) isQuadraticNonResidue(a *fe2) bool { 246 // https://github.com/leovt/constructible/wiki/Taking-Square-Roots-in-quadratic-extension-Fields 247 c0, c1 := new(fe), new(fe) 248 square(c0, &a[0]) 249 square(c1, &a[1]) 250 add(c1, c1, c0) 251 return isQuadraticNonResidue(c1) 252 }