scalar.go 24 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025
  1. // Copyright (c) 2016 The Go Authors. All rights reserved.
  2. // Use of this source code is governed by a BSD-style
  3. // license that can be found in the LICENSE file.
  4. package edwards25519
  5. import (
  6. "crypto/subtle"
  7. "encoding/binary"
  8. "errors"
  9. )
  10. // A Scalar is an integer modulo
  11. //
  12. // l = 2^252 + 27742317777372353535851937790883648493
  13. //
  14. // which is the prime order of the edwards25519 group.
  15. //
  16. // This type works similarly to math/big.Int, and all arguments and
  17. // receivers are allowed to alias.
  18. //
  19. // The zero value is a valid zero element.
  20. type Scalar struct {
  21. // s is the Scalar value in little-endian. The value is always reduced
  22. // between operations.
  23. s [32]byte
  24. }
  25. var (
  26. scZero = Scalar{[32]byte{0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0}}
  27. scOne = Scalar{[32]byte{1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0}}
  28. scMinusOne = Scalar{[32]byte{236, 211, 245, 92, 26, 99, 18, 88, 214, 156, 247, 162, 222, 249, 222, 20, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 16}}
  29. )
  30. // NewScalar returns a new zero Scalar.
  31. func NewScalar() *Scalar {
  32. return &Scalar{}
  33. }
  34. // MultiplyAdd sets s = x * y + z mod l, and returns s.
  35. func (s *Scalar) MultiplyAdd(x, y, z *Scalar) *Scalar {
  36. scMulAdd(&s.s, &x.s, &y.s, &z.s)
  37. return s
  38. }
  39. // Add sets s = x + y mod l, and returns s.
  40. func (s *Scalar) Add(x, y *Scalar) *Scalar {
  41. // s = 1 * x + y mod l
  42. scMulAdd(&s.s, &scOne.s, &x.s, &y.s)
  43. return s
  44. }
  45. // Subtract sets s = x - y mod l, and returns s.
  46. func (s *Scalar) Subtract(x, y *Scalar) *Scalar {
  47. // s = -1 * y + x mod l
  48. scMulAdd(&s.s, &scMinusOne.s, &y.s, &x.s)
  49. return s
  50. }
  51. // Negate sets s = -x mod l, and returns s.
  52. func (s *Scalar) Negate(x *Scalar) *Scalar {
  53. // s = -1 * x + 0 mod l
  54. scMulAdd(&s.s, &scMinusOne.s, &x.s, &scZero.s)
  55. return s
  56. }
  57. // Multiply sets s = x * y mod l, and returns s.
  58. func (s *Scalar) Multiply(x, y *Scalar) *Scalar {
  59. // s = x * y + 0 mod l
  60. scMulAdd(&s.s, &x.s, &y.s, &scZero.s)
  61. return s
  62. }
  63. // Set sets s = x, and returns s.
  64. func (s *Scalar) Set(x *Scalar) *Scalar {
  65. *s = *x
  66. return s
  67. }
  68. // SetUniformBytes sets s to an uniformly distributed value given 64 uniformly
  69. // distributed random bytes.
  70. func (s *Scalar) SetUniformBytes(x []byte) *Scalar {
  71. if len(x) != 64 {
  72. panic("edwards25519: invalid SetUniformBytes input length")
  73. }
  74. var wideBytes [64]byte
  75. copy(wideBytes[:], x[:])
  76. scReduce(&s.s, &wideBytes)
  77. return s
  78. }
  79. // SetCanonicalBytes sets s = x, where x is a 32-byte little-endian encoding of
  80. // s, and returns s. If x is not a canonical encoding of s, SetCanonicalBytes
  81. // returns nil and an error, and the receiver is unchanged.
  82. func (s *Scalar) SetCanonicalBytes(x []byte) (*Scalar, error) {
  83. if len(x) != 32 {
  84. return nil, errors.New("invalid scalar length")
  85. }
  86. ss := &Scalar{}
  87. copy(ss.s[:], x)
  88. if !isReduced(ss) {
  89. return nil, errors.New("invalid scalar encoding")
  90. }
  91. s.s = ss.s
  92. return s, nil
  93. }
  94. // isReduced returns whether the given scalar is reduced modulo l.
  95. func isReduced(s *Scalar) bool {
  96. for i := len(s.s) - 1; i >= 0; i-- {
  97. switch {
  98. case s.s[i] > scMinusOne.s[i]:
  99. return false
  100. case s.s[i] < scMinusOne.s[i]:
  101. return true
  102. }
  103. }
  104. return true
  105. }
  106. // SetBytesWithClamping applies the buffer pruning described in RFC 8032,
  107. // Section 5.1.5 (also known as clamping) and sets s to the result. The input
  108. // must be 32 bytes, and it is not modified.
  109. //
  110. // Note that since Scalar values are always reduced modulo the prime order of
  111. // the curve, the resulting value will not preserve any of the cofactor-clearing
  112. // properties that clamping is meant to provide. It will however work as
  113. // expected as long as it is applied to points on the prime order subgroup, like
  114. // in Ed25519. In fact, it is lost to history why RFC 8032 adopted the
  115. // irrelevant RFC 7748 clamping, but it is now required for compatibility.
  116. func (s *Scalar) SetBytesWithClamping(x []byte) *Scalar {
  117. // The description above omits the purpose of the high bits of the clamping
  118. // for brevity, but those are also lost to reductions, and are also
  119. // irrelevant to edwards25519 as they protect against a specific
  120. // implementation bug that was once observed in a generic Montgomery ladder.
  121. if len(x) != 32 {
  122. panic("edwards25519: invalid SetBytesWithClamping input length")
  123. }
  124. var wideBytes [64]byte
  125. copy(wideBytes[:], x[:])
  126. wideBytes[0] &= 248
  127. wideBytes[31] &= 63
  128. wideBytes[31] |= 64
  129. scReduce(&s.s, &wideBytes)
  130. return s
  131. }
  132. // Bytes returns the canonical 32-byte little-endian encoding of s.
  133. func (s *Scalar) Bytes() []byte {
  134. buf := make([]byte, 32)
  135. copy(buf, s.s[:])
  136. return buf
  137. }
  138. // Equal returns 1 if s and t are equal, and 0 otherwise.
  139. func (s *Scalar) Equal(t *Scalar) int {
  140. return subtle.ConstantTimeCompare(s.s[:], t.s[:])
  141. }
  142. // scMulAdd and scReduce are ported from the public domain, “ref10”
  143. // implementation of ed25519 from SUPERCOP.
  144. func load3(in []byte) int64 {
  145. r := int64(in[0])
  146. r |= int64(in[1]) << 8
  147. r |= int64(in[2]) << 16
  148. return r
  149. }
  150. func load4(in []byte) int64 {
  151. r := int64(in[0])
  152. r |= int64(in[1]) << 8
  153. r |= int64(in[2]) << 16
  154. r |= int64(in[3]) << 24
  155. return r
  156. }
  157. // Input:
  158. // a[0]+256*a[1]+...+256^31*a[31] = a
  159. // b[0]+256*b[1]+...+256^31*b[31] = b
  160. // c[0]+256*c[1]+...+256^31*c[31] = c
  161. //
  162. // Output:
  163. // s[0]+256*s[1]+...+256^31*s[31] = (ab+c) mod l
  164. // where l = 2^252 + 27742317777372353535851937790883648493.
  165. func scMulAdd(s, a, b, c *[32]byte) {
  166. a0 := 2097151 & load3(a[:])
  167. a1 := 2097151 & (load4(a[2:]) >> 5)
  168. a2 := 2097151 & (load3(a[5:]) >> 2)
  169. a3 := 2097151 & (load4(a[7:]) >> 7)
  170. a4 := 2097151 & (load4(a[10:]) >> 4)
  171. a5 := 2097151 & (load3(a[13:]) >> 1)
  172. a6 := 2097151 & (load4(a[15:]) >> 6)
  173. a7 := 2097151 & (load3(a[18:]) >> 3)
  174. a8 := 2097151 & load3(a[21:])
  175. a9 := 2097151 & (load4(a[23:]) >> 5)
  176. a10 := 2097151 & (load3(a[26:]) >> 2)
  177. a11 := (load4(a[28:]) >> 7)
  178. b0 := 2097151 & load3(b[:])
  179. b1 := 2097151 & (load4(b[2:]) >> 5)
  180. b2 := 2097151 & (load3(b[5:]) >> 2)
  181. b3 := 2097151 & (load4(b[7:]) >> 7)
  182. b4 := 2097151 & (load4(b[10:]) >> 4)
  183. b5 := 2097151 & (load3(b[13:]) >> 1)
  184. b6 := 2097151 & (load4(b[15:]) >> 6)
  185. b7 := 2097151 & (load3(b[18:]) >> 3)
  186. b8 := 2097151 & load3(b[21:])
  187. b9 := 2097151 & (load4(b[23:]) >> 5)
  188. b10 := 2097151 & (load3(b[26:]) >> 2)
  189. b11 := (load4(b[28:]) >> 7)
  190. c0 := 2097151 & load3(c[:])
  191. c1 := 2097151 & (load4(c[2:]) >> 5)
  192. c2 := 2097151 & (load3(c[5:]) >> 2)
  193. c3 := 2097151 & (load4(c[7:]) >> 7)
  194. c4 := 2097151 & (load4(c[10:]) >> 4)
  195. c5 := 2097151 & (load3(c[13:]) >> 1)
  196. c6 := 2097151 & (load4(c[15:]) >> 6)
  197. c7 := 2097151 & (load3(c[18:]) >> 3)
  198. c8 := 2097151 & load3(c[21:])
  199. c9 := 2097151 & (load4(c[23:]) >> 5)
  200. c10 := 2097151 & (load3(c[26:]) >> 2)
  201. c11 := (load4(c[28:]) >> 7)
  202. var carry [23]int64
  203. s0 := c0 + a0*b0
  204. s1 := c1 + a0*b1 + a1*b0
  205. s2 := c2 + a0*b2 + a1*b1 + a2*b0
  206. s3 := c3 + a0*b3 + a1*b2 + a2*b1 + a3*b0
  207. s4 := c4 + a0*b4 + a1*b3 + a2*b2 + a3*b1 + a4*b0
  208. s5 := c5 + a0*b5 + a1*b4 + a2*b3 + a3*b2 + a4*b1 + a5*b0
  209. s6 := c6 + a0*b6 + a1*b5 + a2*b4 + a3*b3 + a4*b2 + a5*b1 + a6*b0
  210. s7 := c7 + a0*b7 + a1*b6 + a2*b5 + a3*b4 + a4*b3 + a5*b2 + a6*b1 + a7*b0
  211. s8 := c8 + a0*b8 + a1*b7 + a2*b6 + a3*b5 + a4*b4 + a5*b3 + a6*b2 + a7*b1 + a8*b0
  212. s9 := c9 + a0*b9 + a1*b8 + a2*b7 + a3*b6 + a4*b5 + a5*b4 + a6*b3 + a7*b2 + a8*b1 + a9*b0
  213. s10 := c10 + a0*b10 + a1*b9 + a2*b8 + a3*b7 + a4*b6 + a5*b5 + a6*b4 + a7*b3 + a8*b2 + a9*b1 + a10*b0
  214. s11 := c11 + a0*b11 + a1*b10 + a2*b9 + a3*b8 + a4*b7 + a5*b6 + a6*b5 + a7*b4 + a8*b3 + a9*b2 + a10*b1 + a11*b0
  215. s12 := a1*b11 + a2*b10 + a3*b9 + a4*b8 + a5*b7 + a6*b6 + a7*b5 + a8*b4 + a9*b3 + a10*b2 + a11*b1
  216. s13 := a2*b11 + a3*b10 + a4*b9 + a5*b8 + a6*b7 + a7*b6 + a8*b5 + a9*b4 + a10*b3 + a11*b2
  217. s14 := a3*b11 + a4*b10 + a5*b9 + a6*b8 + a7*b7 + a8*b6 + a9*b5 + a10*b4 + a11*b3
  218. s15 := a4*b11 + a5*b10 + a6*b9 + a7*b8 + a8*b7 + a9*b6 + a10*b5 + a11*b4
  219. s16 := a5*b11 + a6*b10 + a7*b9 + a8*b8 + a9*b7 + a10*b6 + a11*b5
  220. s17 := a6*b11 + a7*b10 + a8*b9 + a9*b8 + a10*b7 + a11*b6
  221. s18 := a7*b11 + a8*b10 + a9*b9 + a10*b8 + a11*b7
  222. s19 := a8*b11 + a9*b10 + a10*b9 + a11*b8
  223. s20 := a9*b11 + a10*b10 + a11*b9
  224. s21 := a10*b11 + a11*b10
  225. s22 := a11 * b11
  226. s23 := int64(0)
  227. carry[0] = (s0 + (1 << 20)) >> 21
  228. s1 += carry[0]
  229. s0 -= carry[0] << 21
  230. carry[2] = (s2 + (1 << 20)) >> 21
  231. s3 += carry[2]
  232. s2 -= carry[2] << 21
  233. carry[4] = (s4 + (1 << 20)) >> 21
  234. s5 += carry[4]
  235. s4 -= carry[4] << 21
  236. carry[6] = (s6 + (1 << 20)) >> 21
  237. s7 += carry[6]
  238. s6 -= carry[6] << 21
  239. carry[8] = (s8 + (1 << 20)) >> 21
  240. s9 += carry[8]
  241. s8 -= carry[8] << 21
  242. carry[10] = (s10 + (1 << 20)) >> 21
  243. s11 += carry[10]
  244. s10 -= carry[10] << 21
  245. carry[12] = (s12 + (1 << 20)) >> 21
  246. s13 += carry[12]
  247. s12 -= carry[12] << 21
  248. carry[14] = (s14 + (1 << 20)) >> 21
  249. s15 += carry[14]
  250. s14 -= carry[14] << 21
  251. carry[16] = (s16 + (1 << 20)) >> 21
  252. s17 += carry[16]
  253. s16 -= carry[16] << 21
  254. carry[18] = (s18 + (1 << 20)) >> 21
  255. s19 += carry[18]
  256. s18 -= carry[18] << 21
  257. carry[20] = (s20 + (1 << 20)) >> 21
  258. s21 += carry[20]
  259. s20 -= carry[20] << 21
  260. carry[22] = (s22 + (1 << 20)) >> 21
  261. s23 += carry[22]
  262. s22 -= carry[22] << 21
  263. carry[1] = (s1 + (1 << 20)) >> 21
  264. s2 += carry[1]
  265. s1 -= carry[1] << 21
  266. carry[3] = (s3 + (1 << 20)) >> 21
  267. s4 += carry[3]
  268. s3 -= carry[3] << 21
  269. carry[5] = (s5 + (1 << 20)) >> 21
  270. s6 += carry[5]
  271. s5 -= carry[5] << 21
  272. carry[7] = (s7 + (1 << 20)) >> 21
  273. s8 += carry[7]
  274. s7 -= carry[7] << 21
  275. carry[9] = (s9 + (1 << 20)) >> 21
  276. s10 += carry[9]
  277. s9 -= carry[9] << 21
  278. carry[11] = (s11 + (1 << 20)) >> 21
  279. s12 += carry[11]
  280. s11 -= carry[11] << 21
  281. carry[13] = (s13 + (1 << 20)) >> 21
  282. s14 += carry[13]
  283. s13 -= carry[13] << 21
  284. carry[15] = (s15 + (1 << 20)) >> 21
  285. s16 += carry[15]
  286. s15 -= carry[15] << 21
  287. carry[17] = (s17 + (1 << 20)) >> 21
  288. s18 += carry[17]
  289. s17 -= carry[17] << 21
  290. carry[19] = (s19 + (1 << 20)) >> 21
  291. s20 += carry[19]
  292. s19 -= carry[19] << 21
  293. carry[21] = (s21 + (1 << 20)) >> 21
  294. s22 += carry[21]
  295. s21 -= carry[21] << 21
  296. s11 += s23 * 666643
  297. s12 += s23 * 470296
  298. s13 += s23 * 654183
  299. s14 -= s23 * 997805
  300. s15 += s23 * 136657
  301. s16 -= s23 * 683901
  302. s23 = 0
  303. s10 += s22 * 666643
  304. s11 += s22 * 470296
  305. s12 += s22 * 654183
  306. s13 -= s22 * 997805
  307. s14 += s22 * 136657
  308. s15 -= s22 * 683901
  309. s22 = 0
  310. s9 += s21 * 666643
  311. s10 += s21 * 470296
  312. s11 += s21 * 654183
  313. s12 -= s21 * 997805
  314. s13 += s21 * 136657
  315. s14 -= s21 * 683901
  316. s21 = 0
  317. s8 += s20 * 666643
  318. s9 += s20 * 470296
  319. s10 += s20 * 654183
  320. s11 -= s20 * 997805
  321. s12 += s20 * 136657
  322. s13 -= s20 * 683901
  323. s20 = 0
  324. s7 += s19 * 666643
  325. s8 += s19 * 470296
  326. s9 += s19 * 654183
  327. s10 -= s19 * 997805
  328. s11 += s19 * 136657
  329. s12 -= s19 * 683901
  330. s19 = 0
  331. s6 += s18 * 666643
  332. s7 += s18 * 470296
  333. s8 += s18 * 654183
  334. s9 -= s18 * 997805
  335. s10 += s18 * 136657
  336. s11 -= s18 * 683901
  337. s18 = 0
  338. carry[6] = (s6 + (1 << 20)) >> 21
  339. s7 += carry[6]
  340. s6 -= carry[6] << 21
  341. carry[8] = (s8 + (1 << 20)) >> 21
  342. s9 += carry[8]
  343. s8 -= carry[8] << 21
  344. carry[10] = (s10 + (1 << 20)) >> 21
  345. s11 += carry[10]
  346. s10 -= carry[10] << 21
  347. carry[12] = (s12 + (1 << 20)) >> 21
  348. s13 += carry[12]
  349. s12 -= carry[12] << 21
  350. carry[14] = (s14 + (1 << 20)) >> 21
  351. s15 += carry[14]
  352. s14 -= carry[14] << 21
  353. carry[16] = (s16 + (1 << 20)) >> 21
  354. s17 += carry[16]
  355. s16 -= carry[16] << 21
  356. carry[7] = (s7 + (1 << 20)) >> 21
  357. s8 += carry[7]
  358. s7 -= carry[7] << 21
  359. carry[9] = (s9 + (1 << 20)) >> 21
  360. s10 += carry[9]
  361. s9 -= carry[9] << 21
  362. carry[11] = (s11 + (1 << 20)) >> 21
  363. s12 += carry[11]
  364. s11 -= carry[11] << 21
  365. carry[13] = (s13 + (1 << 20)) >> 21
  366. s14 += carry[13]
  367. s13 -= carry[13] << 21
  368. carry[15] = (s15 + (1 << 20)) >> 21
  369. s16 += carry[15]
  370. s15 -= carry[15] << 21
  371. s5 += s17 * 666643
  372. s6 += s17 * 470296
  373. s7 += s17 * 654183
  374. s8 -= s17 * 997805
  375. s9 += s17 * 136657
  376. s10 -= s17 * 683901
  377. s17 = 0
  378. s4 += s16 * 666643
  379. s5 += s16 * 470296
  380. s6 += s16 * 654183
  381. s7 -= s16 * 997805
  382. s8 += s16 * 136657
  383. s9 -= s16 * 683901
  384. s16 = 0
  385. s3 += s15 * 666643
  386. s4 += s15 * 470296
  387. s5 += s15 * 654183
  388. s6 -= s15 * 997805
  389. s7 += s15 * 136657
  390. s8 -= s15 * 683901
  391. s15 = 0
  392. s2 += s14 * 666643
  393. s3 += s14 * 470296
  394. s4 += s14 * 654183
  395. s5 -= s14 * 997805
  396. s6 += s14 * 136657
  397. s7 -= s14 * 683901
  398. s14 = 0
  399. s1 += s13 * 666643
  400. s2 += s13 * 470296
  401. s3 += s13 * 654183
  402. s4 -= s13 * 997805
  403. s5 += s13 * 136657
  404. s6 -= s13 * 683901
  405. s13 = 0
  406. s0 += s12 * 666643
  407. s1 += s12 * 470296
  408. s2 += s12 * 654183
  409. s3 -= s12 * 997805
  410. s4 += s12 * 136657
  411. s5 -= s12 * 683901
  412. s12 = 0
  413. carry[0] = (s0 + (1 << 20)) >> 21
  414. s1 += carry[0]
  415. s0 -= carry[0] << 21
  416. carry[2] = (s2 + (1 << 20)) >> 21
  417. s3 += carry[2]
  418. s2 -= carry[2] << 21
  419. carry[4] = (s4 + (1 << 20)) >> 21
  420. s5 += carry[4]
  421. s4 -= carry[4] << 21
  422. carry[6] = (s6 + (1 << 20)) >> 21
  423. s7 += carry[6]
  424. s6 -= carry[6] << 21
  425. carry[8] = (s8 + (1 << 20)) >> 21
  426. s9 += carry[8]
  427. s8 -= carry[8] << 21
  428. carry[10] = (s10 + (1 << 20)) >> 21
  429. s11 += carry[10]
  430. s10 -= carry[10] << 21
  431. carry[1] = (s1 + (1 << 20)) >> 21
  432. s2 += carry[1]
  433. s1 -= carry[1] << 21
  434. carry[3] = (s3 + (1 << 20)) >> 21
  435. s4 += carry[3]
  436. s3 -= carry[3] << 21
  437. carry[5] = (s5 + (1 << 20)) >> 21
  438. s6 += carry[5]
  439. s5 -= carry[5] << 21
  440. carry[7] = (s7 + (1 << 20)) >> 21
  441. s8 += carry[7]
  442. s7 -= carry[7] << 21
  443. carry[9] = (s9 + (1 << 20)) >> 21
  444. s10 += carry[9]
  445. s9 -= carry[9] << 21
  446. carry[11] = (s11 + (1 << 20)) >> 21
  447. s12 += carry[11]
  448. s11 -= carry[11] << 21
  449. s0 += s12 * 666643
  450. s1 += s12 * 470296
  451. s2 += s12 * 654183
  452. s3 -= s12 * 997805
  453. s4 += s12 * 136657
  454. s5 -= s12 * 683901
  455. s12 = 0
  456. carry[0] = s0 >> 21
  457. s1 += carry[0]
  458. s0 -= carry[0] << 21
  459. carry[1] = s1 >> 21
  460. s2 += carry[1]
  461. s1 -= carry[1] << 21
  462. carry[2] = s2 >> 21
  463. s3 += carry[2]
  464. s2 -= carry[2] << 21
  465. carry[3] = s3 >> 21
  466. s4 += carry[3]
  467. s3 -= carry[3] << 21
  468. carry[4] = s4 >> 21
  469. s5 += carry[4]
  470. s4 -= carry[4] << 21
  471. carry[5] = s5 >> 21
  472. s6 += carry[5]
  473. s5 -= carry[5] << 21
  474. carry[6] = s6 >> 21
  475. s7 += carry[6]
  476. s6 -= carry[6] << 21
  477. carry[7] = s7 >> 21
  478. s8 += carry[7]
  479. s7 -= carry[7] << 21
  480. carry[8] = s8 >> 21
  481. s9 += carry[8]
  482. s8 -= carry[8] << 21
  483. carry[9] = s9 >> 21
  484. s10 += carry[9]
  485. s9 -= carry[9] << 21
  486. carry[10] = s10 >> 21
  487. s11 += carry[10]
  488. s10 -= carry[10] << 21
  489. carry[11] = s11 >> 21
  490. s12 += carry[11]
  491. s11 -= carry[11] << 21
  492. s0 += s12 * 666643
  493. s1 += s12 * 470296
  494. s2 += s12 * 654183
  495. s3 -= s12 * 997805
  496. s4 += s12 * 136657
  497. s5 -= s12 * 683901
  498. s12 = 0
  499. carry[0] = s0 >> 21
  500. s1 += carry[0]
  501. s0 -= carry[0] << 21
  502. carry[1] = s1 >> 21
  503. s2 += carry[1]
  504. s1 -= carry[1] << 21
  505. carry[2] = s2 >> 21
  506. s3 += carry[2]
  507. s2 -= carry[2] << 21
  508. carry[3] = s3 >> 21
  509. s4 += carry[3]
  510. s3 -= carry[3] << 21
  511. carry[4] = s4 >> 21
  512. s5 += carry[4]
  513. s4 -= carry[4] << 21
  514. carry[5] = s5 >> 21
  515. s6 += carry[5]
  516. s5 -= carry[5] << 21
  517. carry[6] = s6 >> 21
  518. s7 += carry[6]
  519. s6 -= carry[6] << 21
  520. carry[7] = s7 >> 21
  521. s8 += carry[7]
  522. s7 -= carry[7] << 21
  523. carry[8] = s8 >> 21
  524. s9 += carry[8]
  525. s8 -= carry[8] << 21
  526. carry[9] = s9 >> 21
  527. s10 += carry[9]
  528. s9 -= carry[9] << 21
  529. carry[10] = s10 >> 21
  530. s11 += carry[10]
  531. s10 -= carry[10] << 21
  532. s[0] = byte(s0 >> 0)
  533. s[1] = byte(s0 >> 8)
  534. s[2] = byte((s0 >> 16) | (s1 << 5))
  535. s[3] = byte(s1 >> 3)
  536. s[4] = byte(s1 >> 11)
  537. s[5] = byte((s1 >> 19) | (s2 << 2))
  538. s[6] = byte(s2 >> 6)
  539. s[7] = byte((s2 >> 14) | (s3 << 7))
  540. s[8] = byte(s3 >> 1)
  541. s[9] = byte(s3 >> 9)
  542. s[10] = byte((s3 >> 17) | (s4 << 4))
  543. s[11] = byte(s4 >> 4)
  544. s[12] = byte(s4 >> 12)
  545. s[13] = byte((s4 >> 20) | (s5 << 1))
  546. s[14] = byte(s5 >> 7)
  547. s[15] = byte((s5 >> 15) | (s6 << 6))
  548. s[16] = byte(s6 >> 2)
  549. s[17] = byte(s6 >> 10)
  550. s[18] = byte((s6 >> 18) | (s7 << 3))
  551. s[19] = byte(s7 >> 5)
  552. s[20] = byte(s7 >> 13)
  553. s[21] = byte(s8 >> 0)
  554. s[22] = byte(s8 >> 8)
  555. s[23] = byte((s8 >> 16) | (s9 << 5))
  556. s[24] = byte(s9 >> 3)
  557. s[25] = byte(s9 >> 11)
  558. s[26] = byte((s9 >> 19) | (s10 << 2))
  559. s[27] = byte(s10 >> 6)
  560. s[28] = byte((s10 >> 14) | (s11 << 7))
  561. s[29] = byte(s11 >> 1)
  562. s[30] = byte(s11 >> 9)
  563. s[31] = byte(s11 >> 17)
  564. }
  565. // Input:
  566. // s[0]+256*s[1]+...+256^63*s[63] = s
  567. //
  568. // Output:
  569. // s[0]+256*s[1]+...+256^31*s[31] = s mod l
  570. // where l = 2^252 + 27742317777372353535851937790883648493.
  571. func scReduce(out *[32]byte, s *[64]byte) {
  572. s0 := 2097151 & load3(s[:])
  573. s1 := 2097151 & (load4(s[2:]) >> 5)
  574. s2 := 2097151 & (load3(s[5:]) >> 2)
  575. s3 := 2097151 & (load4(s[7:]) >> 7)
  576. s4 := 2097151 & (load4(s[10:]) >> 4)
  577. s5 := 2097151 & (load3(s[13:]) >> 1)
  578. s6 := 2097151 & (load4(s[15:]) >> 6)
  579. s7 := 2097151 & (load3(s[18:]) >> 3)
  580. s8 := 2097151 & load3(s[21:])
  581. s9 := 2097151 & (load4(s[23:]) >> 5)
  582. s10 := 2097151 & (load3(s[26:]) >> 2)
  583. s11 := 2097151 & (load4(s[28:]) >> 7)
  584. s12 := 2097151 & (load4(s[31:]) >> 4)
  585. s13 := 2097151 & (load3(s[34:]) >> 1)
  586. s14 := 2097151 & (load4(s[36:]) >> 6)
  587. s15 := 2097151 & (load3(s[39:]) >> 3)
  588. s16 := 2097151 & load3(s[42:])
  589. s17 := 2097151 & (load4(s[44:]) >> 5)
  590. s18 := 2097151 & (load3(s[47:]) >> 2)
  591. s19 := 2097151 & (load4(s[49:]) >> 7)
  592. s20 := 2097151 & (load4(s[52:]) >> 4)
  593. s21 := 2097151 & (load3(s[55:]) >> 1)
  594. s22 := 2097151 & (load4(s[57:]) >> 6)
  595. s23 := (load4(s[60:]) >> 3)
  596. s11 += s23 * 666643
  597. s12 += s23 * 470296
  598. s13 += s23 * 654183
  599. s14 -= s23 * 997805
  600. s15 += s23 * 136657
  601. s16 -= s23 * 683901
  602. s23 = 0
  603. s10 += s22 * 666643
  604. s11 += s22 * 470296
  605. s12 += s22 * 654183
  606. s13 -= s22 * 997805
  607. s14 += s22 * 136657
  608. s15 -= s22 * 683901
  609. s22 = 0
  610. s9 += s21 * 666643
  611. s10 += s21 * 470296
  612. s11 += s21 * 654183
  613. s12 -= s21 * 997805
  614. s13 += s21 * 136657
  615. s14 -= s21 * 683901
  616. s21 = 0
  617. s8 += s20 * 666643
  618. s9 += s20 * 470296
  619. s10 += s20 * 654183
  620. s11 -= s20 * 997805
  621. s12 += s20 * 136657
  622. s13 -= s20 * 683901
  623. s20 = 0
  624. s7 += s19 * 666643
  625. s8 += s19 * 470296
  626. s9 += s19 * 654183
  627. s10 -= s19 * 997805
  628. s11 += s19 * 136657
  629. s12 -= s19 * 683901
  630. s19 = 0
  631. s6 += s18 * 666643
  632. s7 += s18 * 470296
  633. s8 += s18 * 654183
  634. s9 -= s18 * 997805
  635. s10 += s18 * 136657
  636. s11 -= s18 * 683901
  637. s18 = 0
  638. var carry [17]int64
  639. carry[6] = (s6 + (1 << 20)) >> 21
  640. s7 += carry[6]
  641. s6 -= carry[6] << 21
  642. carry[8] = (s8 + (1 << 20)) >> 21
  643. s9 += carry[8]
  644. s8 -= carry[8] << 21
  645. carry[10] = (s10 + (1 << 20)) >> 21
  646. s11 += carry[10]
  647. s10 -= carry[10] << 21
  648. carry[12] = (s12 + (1 << 20)) >> 21
  649. s13 += carry[12]
  650. s12 -= carry[12] << 21
  651. carry[14] = (s14 + (1 << 20)) >> 21
  652. s15 += carry[14]
  653. s14 -= carry[14] << 21
  654. carry[16] = (s16 + (1 << 20)) >> 21
  655. s17 += carry[16]
  656. s16 -= carry[16] << 21
  657. carry[7] = (s7 + (1 << 20)) >> 21
  658. s8 += carry[7]
  659. s7 -= carry[7] << 21
  660. carry[9] = (s9 + (1 << 20)) >> 21
  661. s10 += carry[9]
  662. s9 -= carry[9] << 21
  663. carry[11] = (s11 + (1 << 20)) >> 21
  664. s12 += carry[11]
  665. s11 -= carry[11] << 21
  666. carry[13] = (s13 + (1 << 20)) >> 21
  667. s14 += carry[13]
  668. s13 -= carry[13] << 21
  669. carry[15] = (s15 + (1 << 20)) >> 21
  670. s16 += carry[15]
  671. s15 -= carry[15] << 21
  672. s5 += s17 * 666643
  673. s6 += s17 * 470296
  674. s7 += s17 * 654183
  675. s8 -= s17 * 997805
  676. s9 += s17 * 136657
  677. s10 -= s17 * 683901
  678. s17 = 0
  679. s4 += s16 * 666643
  680. s5 += s16 * 470296
  681. s6 += s16 * 654183
  682. s7 -= s16 * 997805
  683. s8 += s16 * 136657
  684. s9 -= s16 * 683901
  685. s16 = 0
  686. s3 += s15 * 666643
  687. s4 += s15 * 470296
  688. s5 += s15 * 654183
  689. s6 -= s15 * 997805
  690. s7 += s15 * 136657
  691. s8 -= s15 * 683901
  692. s15 = 0
  693. s2 += s14 * 666643
  694. s3 += s14 * 470296
  695. s4 += s14 * 654183
  696. s5 -= s14 * 997805
  697. s6 += s14 * 136657
  698. s7 -= s14 * 683901
  699. s14 = 0
  700. s1 += s13 * 666643
  701. s2 += s13 * 470296
  702. s3 += s13 * 654183
  703. s4 -= s13 * 997805
  704. s5 += s13 * 136657
  705. s6 -= s13 * 683901
  706. s13 = 0
  707. s0 += s12 * 666643
  708. s1 += s12 * 470296
  709. s2 += s12 * 654183
  710. s3 -= s12 * 997805
  711. s4 += s12 * 136657
  712. s5 -= s12 * 683901
  713. s12 = 0
  714. carry[0] = (s0 + (1 << 20)) >> 21
  715. s1 += carry[0]
  716. s0 -= carry[0] << 21
  717. carry[2] = (s2 + (1 << 20)) >> 21
  718. s3 += carry[2]
  719. s2 -= carry[2] << 21
  720. carry[4] = (s4 + (1 << 20)) >> 21
  721. s5 += carry[4]
  722. s4 -= carry[4] << 21
  723. carry[6] = (s6 + (1 << 20)) >> 21
  724. s7 += carry[6]
  725. s6 -= carry[6] << 21
  726. carry[8] = (s8 + (1 << 20)) >> 21
  727. s9 += carry[8]
  728. s8 -= carry[8] << 21
  729. carry[10] = (s10 + (1 << 20)) >> 21
  730. s11 += carry[10]
  731. s10 -= carry[10] << 21
  732. carry[1] = (s1 + (1 << 20)) >> 21
  733. s2 += carry[1]
  734. s1 -= carry[1] << 21
  735. carry[3] = (s3 + (1 << 20)) >> 21
  736. s4 += carry[3]
  737. s3 -= carry[3] << 21
  738. carry[5] = (s5 + (1 << 20)) >> 21
  739. s6 += carry[5]
  740. s5 -= carry[5] << 21
  741. carry[7] = (s7 + (1 << 20)) >> 21
  742. s8 += carry[7]
  743. s7 -= carry[7] << 21
  744. carry[9] = (s9 + (1 << 20)) >> 21
  745. s10 += carry[9]
  746. s9 -= carry[9] << 21
  747. carry[11] = (s11 + (1 << 20)) >> 21
  748. s12 += carry[11]
  749. s11 -= carry[11] << 21
  750. s0 += s12 * 666643
  751. s1 += s12 * 470296
  752. s2 += s12 * 654183
  753. s3 -= s12 * 997805
  754. s4 += s12 * 136657
  755. s5 -= s12 * 683901
  756. s12 = 0
  757. carry[0] = s0 >> 21
  758. s1 += carry[0]
  759. s0 -= carry[0] << 21
  760. carry[1] = s1 >> 21
  761. s2 += carry[1]
  762. s1 -= carry[1] << 21
  763. carry[2] = s2 >> 21
  764. s3 += carry[2]
  765. s2 -= carry[2] << 21
  766. carry[3] = s3 >> 21
  767. s4 += carry[3]
  768. s3 -= carry[3] << 21
  769. carry[4] = s4 >> 21
  770. s5 += carry[4]
  771. s4 -= carry[4] << 21
  772. carry[5] = s5 >> 21
  773. s6 += carry[5]
  774. s5 -= carry[5] << 21
  775. carry[6] = s6 >> 21
  776. s7 += carry[6]
  777. s6 -= carry[6] << 21
  778. carry[7] = s7 >> 21
  779. s8 += carry[7]
  780. s7 -= carry[7] << 21
  781. carry[8] = s8 >> 21
  782. s9 += carry[8]
  783. s8 -= carry[8] << 21
  784. carry[9] = s9 >> 21
  785. s10 += carry[9]
  786. s9 -= carry[9] << 21
  787. carry[10] = s10 >> 21
  788. s11 += carry[10]
  789. s10 -= carry[10] << 21
  790. carry[11] = s11 >> 21
  791. s12 += carry[11]
  792. s11 -= carry[11] << 21
  793. s0 += s12 * 666643
  794. s1 += s12 * 470296
  795. s2 += s12 * 654183
  796. s3 -= s12 * 997805
  797. s4 += s12 * 136657
  798. s5 -= s12 * 683901
  799. s12 = 0
  800. carry[0] = s0 >> 21
  801. s1 += carry[0]
  802. s0 -= carry[0] << 21
  803. carry[1] = s1 >> 21
  804. s2 += carry[1]
  805. s1 -= carry[1] << 21
  806. carry[2] = s2 >> 21
  807. s3 += carry[2]
  808. s2 -= carry[2] << 21
  809. carry[3] = s3 >> 21
  810. s4 += carry[3]
  811. s3 -= carry[3] << 21
  812. carry[4] = s4 >> 21
  813. s5 += carry[4]
  814. s4 -= carry[4] << 21
  815. carry[5] = s5 >> 21
  816. s6 += carry[5]
  817. s5 -= carry[5] << 21
  818. carry[6] = s6 >> 21
  819. s7 += carry[6]
  820. s6 -= carry[6] << 21
  821. carry[7] = s7 >> 21
  822. s8 += carry[7]
  823. s7 -= carry[7] << 21
  824. carry[8] = s8 >> 21
  825. s9 += carry[8]
  826. s8 -= carry[8] << 21
  827. carry[9] = s9 >> 21
  828. s10 += carry[9]
  829. s9 -= carry[9] << 21
  830. carry[10] = s10 >> 21
  831. s11 += carry[10]
  832. s10 -= carry[10] << 21
  833. out[0] = byte(s0 >> 0)
  834. out[1] = byte(s0 >> 8)
  835. out[2] = byte((s0 >> 16) | (s1 << 5))
  836. out[3] = byte(s1 >> 3)
  837. out[4] = byte(s1 >> 11)
  838. out[5] = byte((s1 >> 19) | (s2 << 2))
  839. out[6] = byte(s2 >> 6)
  840. out[7] = byte((s2 >> 14) | (s3 << 7))
  841. out[8] = byte(s3 >> 1)
  842. out[9] = byte(s3 >> 9)
  843. out[10] = byte((s3 >> 17) | (s4 << 4))
  844. out[11] = byte(s4 >> 4)
  845. out[12] = byte(s4 >> 12)
  846. out[13] = byte((s4 >> 20) | (s5 << 1))
  847. out[14] = byte(s5 >> 7)
  848. out[15] = byte((s5 >> 15) | (s6 << 6))
  849. out[16] = byte(s6 >> 2)
  850. out[17] = byte(s6 >> 10)
  851. out[18] = byte((s6 >> 18) | (s7 << 3))
  852. out[19] = byte(s7 >> 5)
  853. out[20] = byte(s7 >> 13)
  854. out[21] = byte(s8 >> 0)
  855. out[22] = byte(s8 >> 8)
  856. out[23] = byte((s8 >> 16) | (s9 << 5))
  857. out[24] = byte(s9 >> 3)
  858. out[25] = byte(s9 >> 11)
  859. out[26] = byte((s9 >> 19) | (s10 << 2))
  860. out[27] = byte(s10 >> 6)
  861. out[28] = byte((s10 >> 14) | (s11 << 7))
  862. out[29] = byte(s11 >> 1)
  863. out[30] = byte(s11 >> 9)
  864. out[31] = byte(s11 >> 17)
  865. }
  866. // nonAdjacentForm computes a width-w non-adjacent form for this scalar.
  867. //
  868. // w must be between 2 and 8, or nonAdjacentForm will panic.
  869. func (s *Scalar) nonAdjacentForm(w uint) [256]int8 {
  870. // This implementation is adapted from the one
  871. // in curve25519-dalek and is documented there:
  872. // https://github.com/dalek-cryptography/curve25519-dalek/blob/f630041af28e9a405255f98a8a93adca18e4315b/src/scalar.rs#L800-L871
  873. if s.s[31] > 127 {
  874. panic("scalar has high bit set illegally")
  875. }
  876. if w < 2 {
  877. panic("w must be at least 2 by the definition of NAF")
  878. } else if w > 8 {
  879. panic("NAF digits must fit in int8")
  880. }
  881. var naf [256]int8
  882. var digits [5]uint64
  883. for i := 0; i < 4; i++ {
  884. digits[i] = binary.LittleEndian.Uint64(s.s[i*8:])
  885. }
  886. width := uint64(1 << w)
  887. windowMask := uint64(width - 1)
  888. pos := uint(0)
  889. carry := uint64(0)
  890. for pos < 256 {
  891. indexU64 := pos / 64
  892. indexBit := pos % 64
  893. var bitBuf uint64
  894. if indexBit < 64-w {
  895. // This window's bits are contained in a single u64
  896. bitBuf = digits[indexU64] >> indexBit
  897. } else {
  898. // Combine the current 64 bits with bits from the next 64
  899. bitBuf = (digits[indexU64] >> indexBit) | (digits[1+indexU64] << (64 - indexBit))
  900. }
  901. // Add carry into the current window
  902. window := carry + (bitBuf & windowMask)
  903. if window&1 == 0 {
  904. // If the window value is even, preserve the carry and continue.
  905. // Why is the carry preserved?
  906. // If carry == 0 and window & 1 == 0,
  907. // then the next carry should be 0
  908. // If carry == 1 and window & 1 == 0,
  909. // then bit_buf & 1 == 1 so the next carry should be 1
  910. pos += 1
  911. continue
  912. }
  913. if window < width/2 {
  914. carry = 0
  915. naf[pos] = int8(window)
  916. } else {
  917. carry = 1
  918. naf[pos] = int8(window) - int8(width)
  919. }
  920. pos += w
  921. }
  922. return naf
  923. }
  924. func (s *Scalar) signedRadix16() [64]int8 {
  925. if s.s[31] > 127 {
  926. panic("scalar has high bit set illegally")
  927. }
  928. var digits [64]int8
  929. // Compute unsigned radix-16 digits:
  930. for i := 0; i < 32; i++ {
  931. digits[2*i] = int8(s.s[i] & 15)
  932. digits[2*i+1] = int8((s.s[i] >> 4) & 15)
  933. }
  934. // Recenter coefficients:
  935. for i := 0; i < 63; i++ {
  936. carry := (digits[i] + 8) >> 4
  937. digits[i] -= carry << 4
  938. digits[i+1] += carry
  939. }
  940. return digits
  941. }