1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
|
#!/usr/bin/env python3
import subprocess
from binascii import hexlify, unhexlify
from os import path
from subprocess import Popen
from typing import Mapping, Union, Optional, Tuple
import click
from public import public
from pyecsca.ec.coordinates import CoordinateModel, AffineCoordinateModel
from pyecsca.ec.curves import get_params
from pyecsca.ec.mod import Mod
from pyecsca.ec.model import CurveModel
from pyecsca.ec.params import DomainParameters
from pyecsca.ec.point import Point, InfinityPoint
from pyecsca.sca import SerialTarget
from .common import wrap_enum, Platform, get_model, get_coords
def encode_scalar(val: Union[int, Mod]) -> bytes:
if isinstance(val, int):
return val.to_bytes((val.bit_length() + 7) // 8, "big")
elif isinstance(val, Mod):
return encode_scalar(int(val))
return bytes()
def encode_point(point: Point) -> Mapping:
if isinstance(point, InfinityPoint):
return {"n": bytes([1])}
return {var: encode_scalar(value) for var, value in point.coords.items()}
def encode_data(name: Optional[str], structure: Union[Mapping, bytes]) -> bytes:
if isinstance(structure, bytes):
if name is None:
raise ValueError
header = bytes([ord(name)]) + bytes([len(structure)])
return header + structure
data = bytes()
for k, v in structure.items():
data += encode_data(k, v)
if name is not None:
return bytes([ord(name) | 0x80]) + bytes([len(data)]) + data
return data
def decode_data(data: bytes) -> Mapping:
result = {}
parsed = 0
while parsed < len(data):
name = data[parsed]
length = data[parsed + 1]
if name & 0x80:
sub = decode_data(data[parsed + 2: parsed + 2 + length])
result[chr(name & 0x7f)] = sub
parsed += length + 2
else:
result[chr(name)] = data[parsed + 2: parsed + 2 + length]
parsed += length + 2
return result
@public
def cmd_init_prng(seed: bytes) -> str:
return "i" + hexlify(seed).decode()
@public
def cmd_set_params(group: DomainParameters) -> str:
data = {
"p": encode_scalar(group.curve.prime),
"n": encode_scalar(group.order),
"h": encode_scalar(group.cofactor)
}
for param, value in group.curve.parameters.items():
data[param] = encode_scalar(value)
data["g"] = encode_point(group.generator.to_affine())
data["i"] = encode_point(group.neutral)
return "c" + hexlify(encode_data(None, data)).decode()
@public
def cmd_generate() -> str:
return "g"
@public
def cmd_set_privkey(privkey: int) -> str:
return "s" + hexlify(encode_data(None, {"s": encode_scalar(privkey)})).decode()
@public
def cmd_set_pubkey(pubkey: Point) -> str:
return "w" + hexlify(encode_data(None, {"w": encode_point(pubkey.to_affine())})).decode()
@public
def cmd_scalar_mult(scalar: int) -> str:
return "m" + hexlify(encode_data(None, {"s": encode_scalar(scalar)})).decode()
@public
def cmd_ecdh(pubkey: Point) -> str:
return "e" + hexlify(encode_data(None, {"w": encode_point(pubkey.to_affine())})).decode()
@public
def cmd_ecdsa_sign(data: bytes) -> str:
return "a" + hexlify(encode_data(None, {"d": data})).decode()
@public
def cmd_ecdsa_verify(data: bytes, sig: bytes) -> str:
return "v" + hexlify(encode_data(None, {"d": data, "s": sig})).decode()
@public
def cmd_debug() -> str:
return "d"
class ImplTarget(SerialTarget):
model: CurveModel
coords: CoordinateModel
seed: Optional[bytes]
params: Optional[DomainParameters]
privkey: Optional[int]
pubkey: Optional[Point]
def __init__(self, model: CurveModel, coords: CoordinateModel):
self.model = model
self.coords = coords
self.seed = None
self.params = None
self.privkey = None
self.pubkey = None
def init_prng(self, seed: bytes) -> None:
self.write(cmd_init_prng(seed).encode())
self.read(1)
self.seed = seed
def set_params(self, params: DomainParameters) -> None:
self.write(cmd_set_params(params).encode())
self.read(1)
self.params = params
def generate(self) -> Tuple[int, Point]:
self.write(cmd_generate().encode())
priv = self.read(1).decode()[1:-1]
pub = self.read(1).decode()[1:-1]
self.read(1)
self.privkey = int(priv, 16)
pub_len = len(pub)
x = int(pub[:pub_len // 2], 16)
y = int(pub[pub_len // 2:], 16)
self.pubkey = Point(AffineCoordinateModel(self.model), x=Mod(x, self.params.curve.prime),
y=Mod(y, self.params.curve.prime))
return self.privkey, self.pubkey
def set_privkey(self, privkey: int) -> None:
self.write(cmd_set_privkey(privkey).encode())
self.read(1)
self.privkey = privkey
def set_pubkey(self, pubkey: Point) -> None:
self.write(cmd_set_pubkey(pubkey).encode())
self.read(1)
self.pubkey = pubkey
def scalar_mult(self, scalar: int) -> Point:
self.write(cmd_scalar_mult(scalar).encode())
result = self.read(1)[1:-1]
plen = (self.params.curve.prime + 7) // 8
self.read(1)
params = {var: Mod(int(result[i * plen:(i + 1) * plen], 16), self.params.curve.prime) for
i, var in enumerate(self.coords.variables)}
return Point(self.coords, **params)
def ecdh(self, other_pubkey: Point) -> bytes:
self.write(cmd_ecdh(other_pubkey).encode())
result = self.read(1)
self.read(1)
return unhexlify(result[1:-1])
def ecdsa_sign(self, data: bytes) -> bytes:
self.write(cmd_ecdsa_sign(data).encode())
signature = self.read(1)
self.read(1)
return unhexlify(signature[1:-1])
def ecdsa_verify(self, data: bytes, signature: bytes) -> bool:
self.write(cmd_ecdsa_verify(data, signature).encode())
result = self.read(1)
self.read(1)
return unhexlify(result[1:-1])[0] == 1
def debug(self) -> Tuple[str, str]:
self.write(cmd_debug().encode())
resp = self.read(1)
self.read(1)
model, coords = unhexlify(resp[1:-1]).decode().split(",")
return model, coords
@public
class BinaryTarget(ImplTarget):
binary: str
process: Optional[Popen]
def __init__(self, binary: str, model: CurveModel, coords: CoordinateModel):
super().__init__(model, coords)
self.binary = binary
def connect(self):
self.process = Popen([self.binary], stdin=subprocess.PIPE, stdout=subprocess.PIPE,
text=True, bufsize=1)
def write(self, data: bytes):
if self.process is None:
raise ValueError
self.process.stdin.write(data.decode() + "\n")
self.process.stdin.flush()
def read(self, timeout: int) -> bytes:
if self.process is None:
raise ValueError
return self.process.stdout.readline().encode()
def disconnect(self):
if self.process is None:
return
self.process.stdin.close()
self.process.stdout.close()
self.process.kill()
@click.group(context_settings={"help_option_names": ["-h", "--help"]})
@click.option("--platform", envvar="PLATFORM", required=True,
type=click.Choice(Platform.names()),
callback=wrap_enum(Platform),
help="The target platform to use.")
@click.option("--binary", help="For HOST target only. The binary to run.")
@click.argument("model", required=True,
type=click.Choice(["shortw", "montgom", "edwards", "twisted"]),
callback=get_model)
@click.argument("coords", required=True,
callback=get_coords)
@click.version_option()
@click.pass_context
@public
def main(ctx, platform, binary, model, coords):
"""
A tool for communicating with built and flashed ECC implementations.
"""
ctx.ensure_object(dict)
if platform != Platform.HOST:
from pyecsca.sca.target import has_chipwhisperer
if not has_chipwhisperer:
click.secho("ChipWhisperer not installed, targets require it.", fg="red", err=True)
raise click.Abort
from pyecsca.sca.target import SimpleSerialTarget
import chipwhisperer as cw
from chipwhisperer.capture.targets.simpleserial_readers.cwlite import \
SimpleSerial_ChipWhispererLite
ser = SimpleSerial_ChipWhispererLite()
scope = cw.scope()
scope.default_setup()
ctx.obj["target"] = SimpleSerialTarget(ser, scope)
else:
if binary is None or not path.isfile(binary):
click.secho("Binary is required if the target is the host.", fg="red", err=True)
raise click.Abort
ctx.obj["target"] = BinaryTarget(binary, model, coords)
def get_curve(ctx: click.Context, param, value: Optional[str]) -> DomainParameters:
if value is None:
return None
ctx.ensure_object(dict)
category, name = value.split("/")
curve = get_params(category, name, ctx.obj["coords"].name)
return curve
@main.command("gen")
@click.argument("curve", required=True, callback=get_curve)
@click.pass_context
@public
def generate(ctx: click.Context, curve):
ctx.ensure_object(dict)
target: ImplTarget = ctx.obj["target"]
target.connect()
target.set_params(curve)
click.echo(target.generate())
target.disconnect()
@main.command("ecdh")
@click.pass_context
@public
def ecdh(ctx: click.Context):
ctx.ensure_object(dict)
@main.command("ecdsa")
@click.pass_context
@public
def ecdsa(ctx: click.Context):
ctx.ensure_object(dict)
if __name__ == "__main__":
main(obj={})
|