3 * Abstract group inteface
5 * (c) 2004 Straylight/Edgeware
8 /*----- Licensing notice --------------------------------------------------*
10 * This file is part of the Python interface to Catacomb.
12 * Catacomb/Python is free software; you can redistribute it and/or modify
13 * it under the terms of the GNU General Public License as published by
14 * the Free Software Foundation; either version 2 of the License, or
15 * (at your option) any later version.
17 * Catacomb/Python is distributed in the hope that it will be useful,
18 * but WITHOUT ANY WARRANTY; without even the implied warranty of
19 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
20 * GNU General Public License for more details.
22 * You should have received a copy of the GNU General Public License
23 * along with Catacomb/Python; if not, write to the Free Software Foundation,
24 * Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
27 /*----- Header files ------------------------------------------------------*/
29 #include "catacomb-python.h"
31 /*----- DH and binary group infos -----------------------------------------*/
33 static PyTypeObject *fginfo_pytype, *dhinfo_pytype, *bindhinfo_pytype;
35 typedef struct fginfo_pyobj {
40 #define FGINFO_DP(fg) (&((fginfo_pyobj *)(fg))->dp)
42 static PyObject *fginfo_pywrap(gprime_param *dp, PyTypeObject *ty)
44 fginfo_pyobj *z = PyObject_New(fginfo_pyobj, ty);
46 return ((PyObject *)z);
49 static PyObject *fginfo_pynew(PyTypeObject *ty,
50 PyObject *arg, PyObject *kw)
52 static const char *const kwlist[] = { "p", "r", "g", 0 };
53 gprime_param dp = { 0 };
56 if (!PyArg_ParseTupleAndKeywords(arg, kw, "O&O&O&:new", KWLIST,
61 z = PyObject_New(fginfo_pyobj, ty);
63 return ((PyObject *)z);
71 static PyObject *figet_r(PyObject *me, void *hunoz)
72 { return mp_pywrap(MP_COPY(FGINFO_DP(me)->q)); }
74 static PyObject *diget_p(PyObject *me, void *hunoz)
75 { return mp_pywrap(MP_COPY(FGINFO_DP(me)->p)); }
77 static PyObject *diget_g(PyObject *me, void *hunoz)
78 { return mp_pywrap(MP_COPY(FGINFO_DP(me)->g)); }
80 static PyObject *biget_p(PyObject *me, void *hunoz)
81 { return gf_pywrap(MP_COPY(FGINFO_DP(me)->p)); }
83 static PyObject *biget_m(PyObject *me, void *hunoz)
84 { return PyInt_FromLong(mp_octets(FGINFO_DP(me)->p) - 1); }
86 static PyObject *biget_g(PyObject *me, void *hunoz)
87 { return gf_pywrap(MP_COPY(FGINFO_DP(me)->g)); }
89 static void fginfo_pydealloc(PyObject *me)
91 mp_drop(FGINFO_DP(me)->p);
92 mp_drop(FGINFO_DP(me)->q);
93 mp_drop(FGINFO_DP(me)->g);
97 static PyObject *dimeth_generate(PyObject *me, PyObject *arg, PyObject *kw)
102 grand *r = &rand_global;
103 struct excinfo exc = EXCINFO_INIT;
104 pypgev evt = { { 0 } };
105 static const char *const kwlist[] =
106 { "pbits", "qbits", "event", "rng", "nsteps", 0 };
110 if (!PyArg_ParseTupleAndKeywords(arg, kw, "O&|O&O&O&O&:generate", KWLIST,
111 convuint, &pl, convuint, &ql,
112 convpgev, &evt, convgrand, &r,
115 if (dh_gen(&dp, ql, pl, steps, r, evt.ev.proc, evt.ev.ctx))
117 rc = fginfo_pywrap(&dp, dhinfo_pytype);
123 static PyObject *dimeth_genlimlee(PyObject *me, PyObject *arg, PyObject *kw)
128 grand *r = &rand_global;
129 struct excinfo exc = EXCINFO_INIT;
130 pypgev oe = { { 0 } }, ie = { { 0 } };
133 static const char *const kwlist[] = {
134 "pbits", "qbits", "event", "ievent",
135 "rng", "nsteps", "subgroupp", 0
139 PyObject *rc = 0, *vec = 0;
141 oe.exc = ie.exc = &exc;
142 if (!PyArg_ParseTupleAndKeywords(arg, kw,
143 "O&O&|O&O&O&O&O&:genlimlee", KWLIST,
144 convuint, &pl, convuint, &ql,
145 convpgev, &oe, convpgev, &ie,
146 convgrand, &r, convuint, &steps,
147 convbool, &subgroupp))
149 if (subgroupp) f |= DH_SUBGROUP;
150 if (dh_limlee(&dp, ql, pl, f, steps, r,
151 oe.ev.proc, oe.ev.ctx, ie.ev.proc, ie.ev.ctx, &nf, &v))
153 vec = PyList_New(nf);
154 for (i = 0; i < nf; i++)
155 PyList_SET_ITEM(vec, i, mp_pywrap(v[i]));
157 rc = Py_BuildValue("(NN)", fginfo_pywrap(&dp, dhinfo_pytype), vec);
159 droppgev(&oe); droppgev(&ie);
163 static PyObject *dimeth_genkcdsa(PyObject *me, PyObject *arg, PyObject *kw)
168 grand *r = &rand_global;
169 struct excinfo exc = EXCINFO_INIT;
170 pypgev evt = { { 0 } };
171 static const char *const kwlist[] =
172 { "pbits", "qbits", "event", "rng", "nsteps", 0 };
177 if (!PyArg_ParseTupleAndKeywords(arg, kw, "O&O&|O&O&O&:genkcdsa", KWLIST,
178 convuint, &pl, convuint, &ql,
179 convpgev, &evt, convgrand, &r,
182 if (dh_kcdsagen(&dp, ql, pl, 0, steps, r, evt.ev.proc, evt.ev.ctx))
184 mp_div(&v, 0, dp.p, dp.q);
186 rc = Py_BuildValue("(NN)", fginfo_pywrap(&dp, dhinfo_pytype),
193 static PyObject *dimeth_gendsa(PyObject *me, PyObject *arg, PyObject *kw)
200 struct excinfo exc = EXCINFO_INIT;
201 pypgev evt = { { 0 } };
202 static const char *const kwlist[] =
203 { "pbits", "qbits", "seed", "event", "nsteps", 0 };
207 if (!PyArg_ParseTupleAndKeywords(arg, kw, "O&O&O&|O&O&:gendsa", KWLIST,
208 convuint, &pl, convuint, &ql,
210 convpgev, &evt, convuint, &steps))
212 if (dsa_gen(&dp, ql, pl, steps, k.p, k.sz, &ds, evt.ev.proc, evt.ev.ctx))
214 rc = Py_BuildValue("(NNl)", fginfo_pywrap(&dp, dhinfo_pytype),
215 bytestring_pywrap(ds.p, ds.sz), (long)ds.count);
222 static PyObject *meth__parse(PyObject *me, PyObject *arg, PyTypeObject *ty,
223 int (*parse)(qd_parse *, gprime_param *))
230 if (!PyArg_ParseTuple(arg, "s:parse", &p)) goto end;
232 if (parse(&qd, &gp)) VALERR(qd.e);
233 rc = fginfo_pywrap(&gp, ty);
238 static PyObject *dimeth_parse(PyObject *me, PyObject *arg)
239 { return (meth__parse(me, arg, dhinfo_pytype, dh_parse)); }
241 static PyObject *bimeth_parse(PyObject *me, PyObject *arg)
242 { return (meth__parse(me, arg, bindhinfo_pytype, dhbin_parse)); }
244 static const PyGetSetDef fginfo_pygetset[] = {
245 #define GETSETNAME(op, name) fi##op##_##name
246 GET (r, "I.r -> group order")
251 static const PyGetSetDef dhinfo_pygetset[] = {
252 #define GETSETNAME(op, name) di##op##_##name
253 GET (p, "I.p -> prime")
254 GET (g, "I.g -> generator")
259 static const PyMethodDef dhinfo_pymethods[] = {
260 #define METHNAME(name) dimeth_##name
261 SMTH (parse, "parse(STR) -> D, REST")
263 "generate(PBITS, [qbits = 0], [event = pgen_nullev],\n"
264 " [rng = rand], [nsteps = 0]) -> D")
266 "genlimlee(PBITS, QBITS, [event = pgen_nullev], "
267 "[ievent = pgen_nullev],\n"
268 " [rng = rand], [nsteps = 0], [subgroupp = True]) "
271 "gendsa(PBITS, QBITS, SEED, [event = pgen_nullev], [nsteps = 0])\n"
272 " -> (D, SEED, COUNT)")
274 "gendsa(PBITS, QBITS, [event = pgen_nullev], "
275 "[rng = rand], [nsteps = 0])\n"
281 static const PyGetSetDef bindhinfo_pygetset[] = {
282 #define GETSETNAME(op, name) bi##op##_##name
283 GET (p, "I.p -> irreducible polynomial")
284 GET (m, "I.m -> degree of polynomial")
285 GET (g, "I.g -> generator")
290 static const PyMethodDef bindhinfo_pymethods[] = {
291 #define METHNAME(name) bimeth_##name
292 SMTH (parse, "parse(STR) -> D, REST")
297 static const PyTypeObject fginfo_pytype_skel = {
298 PyVarObject_HEAD_INIT(0, 0) /* Header */
299 "FGInfo", /* @tp_name@ */
300 sizeof(fginfo_pyobj), /* @tp_basicsize@ */
301 0, /* @tp_itemsize@ */
303 fginfo_pydealloc, /* @tp_dealloc@ */
305 0, /* @tp_getattr@ */
306 0, /* @tp_setattr@ */
307 0, /* @tp_compare@ */
309 0, /* @tp_as_number@ */
310 0, /* @tp_as_sequence@ */
311 0, /* @tp_as_mapping@ */
315 0, /* @tp_getattro@ */
316 0, /* @tp_setattro@ */
317 0, /* @tp_as_buffer@ */
318 Py_TPFLAGS_DEFAULT | /* @tp_flags@ */
322 "Abstract base class for field-group information objects.",
324 0, /* @tp_traverse@ */
326 0, /* @tp_richcompare@ */
327 0, /* @tp_weaklistoffset@ */
329 0, /* @tp_iternext@ */
330 0, /* @tp_methods@ */
331 0, /* @tp_members@ */
332 PYGETSET(fginfo), /* @tp_getset@ */
335 0, /* @tp_descr_get@ */
336 0, /* @tp_descr_set@ */
337 0, /* @tp_dictoffset@ */
339 PyType_GenericAlloc, /* @tp_alloc@ */
340 abstract_pynew, /* @tp_new@ */
345 static const PyTypeObject dhinfo_pytype_skel = {
346 PyVarObject_HEAD_INIT(0, 0) /* Header */
347 "DHInfo", /* @tp_name@ */
348 sizeof(fginfo_pyobj), /* @tp_basicsize@ */
349 0, /* @tp_itemsize@ */
351 fginfo_pydealloc, /* @tp_dealloc@ */
353 0, /* @tp_getattr@ */
354 0, /* @tp_setattr@ */
355 0, /* @tp_compare@ */
357 0, /* @tp_as_number@ */
358 0, /* @tp_as_sequence@ */
359 0, /* @tp_as_mapping@ */
363 0, /* @tp_getattro@ */
364 0, /* @tp_setattro@ */
365 0, /* @tp_as_buffer@ */
366 Py_TPFLAGS_DEFAULT | /* @tp_flags@ */
370 "DHInfo(P, R, G): standard (integer) Diffie-Hellman group information.",
372 0, /* @tp_traverse@ */
374 0, /* @tp_richcompare@ */
375 0, /* @tp_weaklistoffset@ */
377 0, /* @tp_iternext@ */
378 PYMETHODS(dhinfo), /* @tp_methods@ */
379 0, /* @tp_members@ */
380 PYGETSET(dhinfo), /* @tp_getset@ */
383 0, /* @tp_descr_get@ */
384 0, /* @tp_descr_set@ */
385 0, /* @tp_dictoffset@ */
387 PyType_GenericAlloc, /* @tp_alloc@ */
388 fginfo_pynew, /* @tp_new@ */
393 static const PyTypeObject bindhinfo_pytype_skel = {
394 PyVarObject_HEAD_INIT(0, 0) /* Header */
395 "BinDHInfo", /* @tp_name@ */
396 sizeof(fginfo_pyobj), /* @tp_basicsize@ */
397 0, /* @tp_itemsize@ */
399 fginfo_pydealloc, /* @tp_dealloc@ */
401 0, /* @tp_getattr@ */
402 0, /* @tp_setattr@ */
403 0, /* @tp_compare@ */
405 0, /* @tp_as_number@ */
406 0, /* @tp_as_sequence@ */
407 0, /* @tp_as_mapping@ */
411 0, /* @tp_getattro@ */
412 0, /* @tp_setattro@ */
413 0, /* @tp_as_buffer@ */
414 Py_TPFLAGS_DEFAULT | /* @tp_flags@ */
418 "BinDHInfo(P, R, G): binary-field Diffie-Hellman group information.",
420 0, /* @tp_traverse@ */
422 0, /* @tp_richcompare@ */
423 0, /* @tp_weaklistoffset@ */
425 0, /* @tp_iternext@ */
426 PYMETHODS(bindhinfo), /* @tp_methods@ */
427 0, /* @tp_members@ */
428 PYGETSET(bindhinfo), /* @tp_getset@ */
431 0, /* @tp_descr_get@ */
432 0, /* @tp_descr_set@ */
433 0, /* @tp_dictoffset@ */
435 PyType_GenericAlloc, /* @tp_alloc@ */
436 fginfo_pynew, /* @tp_new@ */
441 /*----- General utilities -------------------------------------------------*/
443 PyTypeObject *ge_pytype, *group_pytype;
444 static PyTypeObject *primegroup_pytype, *bingroup_pytype, *ecgroup_pytype;
446 group *group_copy(group *g)
448 if (STRCMP(G_NAME(g), ==, "prime")) {
449 gctx_prime *gc = (gctx_prime *)g;
451 gp.g = G_TOINT(g, MP_NEW, g->g);
454 g = group_prime(&gp);
456 } else if (STRCMP(G_NAME(g), ==, "bin")) {
457 gctx_bin *gc = (gctx_bin *)g;
459 gb.g = G_TOINT(g, MP_NEW, g->g);
462 g = group_binary(&gb);
464 } else if (STRCMP(G_NAME(g), ==, "ec")) {
465 gctx_ec *gc = (gctx_ec *)g;
467 if ((ei.c = eccurve_copy(gc->ei.c)) == 0)
470 EC_COPY(&ei.g, &gc->ei.g);
471 ei.r = MP_COPY(gc->ei.r);
472 ei.h = MP_COPY(gc->ei.h);
479 PyObject *ge_pywrap(PyObject *gobj, ge *x)
481 ge_pyobj *z = PyObject_New(ge_pyobj, (PyTypeObject *)gobj);
483 z->g = GROUP_G(gobj);
485 return ((PyObject *)z);
488 static PyObject *ge_pynew(PyTypeObject *ty, PyObject *arg, PyObject *kw)
490 static const char *const kwlist[] = { "x", 0 };
500 if (!PyArg_ParseTupleAndKeywords(arg, kw, "O:new", KWLIST, &x)) goto end;
502 if (ECPT_PYCHECK(x)) {
504 if (G_FROMEC(g, xx, &p))
505 TYERR("can't convert from elliptic curve point");
507 } else if ((y = tomp(x)) != 0) {
508 if (G_FROMINT(g, xx, y))
509 TYERR("can't convert from integer");
511 } else if (TEXT_CHECK(x)) {
512 TEXT_PTRLEN(x, sc.buf, n); sc.lim = sc.buf + n;
513 if (G_READ(g, xx, &mptext_stringops, &sc) || sc.buf < sc.lim)
514 VALERR("malformed group element string");
516 TYERR("can't convert to group element");
517 return (ge_pywrap((PyObject *)ty, xx));
521 if (xx) G_DESTROY(g, xx);
525 static PyObject *group_dopywrap(PyTypeObject *ty, group *g)
527 group_pyobj *gobj = newtype(ty, 0, g->ops->name);
529 gobj->ty.ht_type.tp_basicsize = sizeof(ge_pyobj);
530 gobj->ty.ht_type.tp_base = ge_pytype;
531 Py_INCREF(group_pytype);
532 gobj->ty.ht_type.tp_flags = (Py_TPFLAGS_DEFAULT |
533 Py_TPFLAGS_BASETYPE |
534 Py_TPFLAGS_CHECKTYPES |
535 Py_TPFLAGS_HEAPTYPE);
536 gobj->ty.ht_type.tp_alloc = PyType_GenericAlloc;
537 gobj->ty.ht_type.tp_free = 0;
538 gobj->ty.ht_type.tp_new = ge_pynew;
539 typeready(&gobj->ty.ht_type);
540 return ((PyObject *)gobj);
543 PyObject *group_pywrap(group *g)
547 if (STRCMP(G_NAME(g), ==, "prime")) ty = primegroup_pytype;
548 else if (STRCMP(G_NAME(g), ==, "bin")) ty = bingroup_pytype;
549 else if (STRCMP(G_NAME(g), ==, "ec")) ty = ecgroup_pytype;
551 return (group_dopywrap(ty, g));
554 /*----- Group elements ----------------------------------------------------*/
556 #define BINOP(name) \
557 static PyObject *ge_py##name(PyObject *x, PyObject *y) \
561 if (!GE_PYCHECK(x) || !GE_PYCHECK(y) || \
562 (GE_G(x) != GE_G(y) && !group_samep(GE_G(x), GE_G(y)))) \
566 g->ops->name(g, z, GE_X(x), GE_X(y)); \
567 return (ge_pywrap(GE_GOBJ(x), z)); \
574 static PyObject *gemeth_##name(PyObject *me) \
580 g->ops->name(g, z, GE_X(me)); \
581 return (ge_pywrap(GE_GOBJ(me), z)); \
587 static PyObject *ge_pyexp(PyObject *x, PyObject *n, PyObject *m)
592 if (m != Py_None || !GE_PYCHECK(x) || (nn = getmp(n)) == 0)
594 z = G_CREATE(GE_G(x));
595 G_EXP(GE_G(x), z, GE_X(x), nn);
597 return (ge_pywrap(GE_GOBJ(x), z));
600 static void ge_pydealloc(PyObject *me)
602 G_DESTROY(GE_G(me), GE_X(me));
603 Py_DECREF(GE_GOBJ(me));
607 static void group_pydealloc(PyObject *me)
609 G_DESTROYGROUP(GROUP_G(me));
610 PyType_Type.tp_dealloc(me);
613 static PyObject *gmexp_id(PyObject *me)
615 group *g = GROUP_G(me); ge *x = G_CREATE(g);
616 G_COPY(g, x, g->i); return (ge_pywrap(me, x));
619 static int gmexp_fill(void *pp, PyObject *me, PyObject *x, PyObject *m)
621 group_expfactor *f = pp;
623 if (!GE_PYCHECK(x) || GE_G(x) != GROUP_G(me) || (f->exp = getmp(m)) == 0)
629 static PyObject *ge_pyrichcompare(PyObject *x, PyObject *y, int op)
634 if (!GE_PYCHECK(x) || !GE_PYCHECK(y) ||
635 (GE_G(x) != GE_G(y) && !group_samep(GE_G(x), GE_G(y))))
638 case Py_EQ: b = G_EQ(GE_G(x), GE_X(x), GE_X(y)); break;
639 case Py_NE: b = !G_EQ(GE_G(x), GE_X(x), GE_X(y)); break;
640 default: TYERR("group elements are unordered");
647 static PyObject *gemeth_check(PyObject *me)
649 if (group_check(GE_G(me), GE_X(me))) VALERR("bad group element");
655 static int ge_pynonzerop(PyObject *x)
656 { return (!G_IDENTP(GE_G(x), GE_X(x))); }
658 static PyObject *ge_pystr(PyObject *me)
663 group_writedstr(GE_G(me), GE_X(me), &d);
664 rc = TEXT_FROMSTRLEN(d.buf, d.len);
670 static PyObject *ge_pylong(PyObject *me)
675 if ((x = G_TOINT(GE_G(me), MP_NEW, GE_X(me))) == 0)
676 TYERR("can't convert to integer");
684 static PyObject *ge_pyint(PyObject *me)
690 if ((x = G_TOINT(GE_G(me), MP_NEW, GE_X(me))) == 0)
691 TYERR("can't convert to integer");
692 if (!mp_tolong_checked(x, &l, 0)) rc = PyInt_FromLong(l);
693 else rc = mp_topylong(x);
699 static PyObject *gemeth_toint(PyObject *me)
703 if ((x = G_TOINT(GE_G(me), MP_NEW, GE_X(me))) == 0)
704 TYERR("can't convert to integer");
705 return (mp_pywrap(x));
710 static PyObject *gemeth_toec(PyObject *me, PyObject *arg, PyObject *kw)
712 static const char *const kwlist[] = { "curve", 0 };
713 PyTypeObject *cty = 0;
719 if (!PyArg_ParseTupleAndKeywords(arg, kw, "|O:toec", KWLIST,
721 g = GROUP_G(GE_GOBJ(me));
723 if (!PyType_Check(cty) || !PyType_IsSubtype(cty, ecpt_pytype))
724 TYERR("want subtype of catacomb.ECPt");
725 Py_INCREF((PyObject *)cty);
726 } else if (STRCMP(G_NAME(g), ==, "ec")) {
727 c = eccurve_copy(((gctx_ec *)g)->ei.c);
728 cty = (PyTypeObject *)eccurve_pywrap(0, c);
731 Py_INCREF((PyObject *)cty);
733 if (G_TOEC(GE_G(me), &p, GE_X(me))) {
734 Py_DECREF((PyObject *)cty);
735 TYERR("can't convert to ec point");
737 rc = ecpt_pywrapout(cty, &p);
738 Py_DECREF((PyObject *)cty);
743 static PyObject *gemeth_tobuf(PyObject *me)
749 n = GE_G(me)->noctets + 4;
750 rc = bytestring_pywrap(0, n);
751 buf_init(&b, BIN_PTR(rc), n);
752 G_TOBUF(GE_G(me), &b, GE_X(me));
754 BIN_SETLEN(rc, BLEN(&b));
758 static PyObject *gemeth_toraw(PyObject *me)
764 n = GE_G(me)->noctets;
765 rc = bytestring_pywrap(0, n);
766 buf_init(&b, BIN_PTR(rc), n);
767 G_TORAW(GE_G(me), &b, GE_X(me));
769 BIN_SETLEN(rc, BLEN(&b));
773 static PyObject *gmexp_exp(PyObject *me, void *pp, int n)
775 ge *z = G_CREATE(GROUP_G(me));
776 G_MEXP(GROUP_G(me), z, pp, n);
777 return (ge_pywrap(me, z));
780 static void gmexp_drop(void *pp)
782 group_expfactor *f = pp;
786 static PyObject *gmeth_mexp(PyObject *me, PyObject *arg)
788 return (mexp_common(me, arg, sizeof(group_expfactor),
789 gmexp_id, gmexp_fill, gmexp_exp, gmexp_drop));
792 static PyObject *gmeth_checkgroup(PyObject *me, PyObject *arg, PyObject *kw)
794 static const char *const kwlist[] = { "rng", 0 };
795 grand *r = &rand_global;
798 if (!PyArg_ParseTupleAndKeywords(arg, kw, "|O&:checkgroup", KWLIST,
801 if ((p = G_CHECK(GROUP_G(me), r)) != 0)
808 static PyObject *group_pyrichcompare(PyObject *x, PyObject *y, int op)
810 int b = group_samep(GROUP_G(x), GROUP_G(y));
814 default: TYERR("can't order groups");
821 static PyObject *gemeth_frombuf(PyObject *me, PyObject *arg)
828 if (!PyArg_ParseTuple(arg, "O&:frombuf", convbin, &in)) return (0);
830 buf_init(&b, (/*unconst*/ void *)in.p, in.sz);
832 if (G_FROMBUF(g, &b, x)) VALERR("invalid data");
833 return (Py_BuildValue("(NN)", ge_pywrap(me, x), bytestring_pywrapbuf(&b)));
835 if (x) G_DESTROY(g, x);
839 static PyObject *gemeth_fromraw(PyObject *me, PyObject *arg)
846 if (!PyArg_ParseTuple(arg, "O&:fromraw", convbin, &in)) return (0);
848 buf_init(&b, (/*unconst*/ void *)in.p, in.sz);
850 if (G_FROMRAW(g, &b, x)) VALERR("invalid data");
851 return (Py_BuildValue("(NN)", ge_pywrap(me, x), bytestring_pywrapbuf(&b)));
853 if (x) G_DESTROY(g, x);
857 static PyObject *gemeth_fromstring(PyObject *me, PyObject *arg)
865 if (!PyArg_ParseTuple(arg, "s#:fromstring", &p, &n)) return (0);
870 if (G_READ(g, x, &mptext_stringops, &sc))
871 VALERR("bad group element string");
872 return (Py_BuildValue("(Ns#)", ge_pywrap(me, x),
873 sc.buf, (Py_ssize_t)(sc.lim - sc.buf)));
875 if (x) G_DESTROY(g, x);
879 static PyObject *gmeth_parse(PyObject *me, PyObject *arg)
885 if (!PyArg_ParseTuple(arg, "s:parse", &p)) goto end;
887 if ((g = group_parse(&qd)) == 0) VALERR(qd.e);
888 return (group_pywrap(g));
893 static PyObject *geget_group(PyObject *me, void *hunoz)
894 { RETURN_OBJ(GE_GOBJ(me)); }
896 static PyObject *gget_nbits(PyObject *me, void *hunoz)
897 { return (PyInt_FromLong(GROUP_G(me)->nbits)); }
899 static PyObject *gget_noctets(PyObject *me, void *hunoz)
900 { return (PyInt_FromLong(GROUP_G(me)->noctets)); }
902 static PyObject *gget_i(PyObject *me, void *hunoz)
904 group *g = GROUP_G(me); ge *x = G_CREATE(g);
905 G_COPY(g, x, g->i); return (ge_pywrap(me, x));
908 static PyObject *gget_g(PyObject *me, void *hunoz)
910 group *g = GROUP_G(me); ge *x = G_CREATE(g);
911 G_COPY(g, x, g->g); return (ge_pywrap(me, x));
914 static Py_hash_t ge_pyhash(PyObject *me)
917 size_t sz = GE_G(me)->noctets + 4;
918 uint32 h = 0xf672c776 + GE_G(me)->ops->ty;
919 octet *p = xmalloc(sz);
921 G_TOBUF(GE_G(me), &b, GE_X(me));
923 h = unihash_hash(&unihash_global, h, BBASE(&b), BLEN(&b));
925 return (h % LONG_MAX);
928 static PyObject *gget_r(PyObject *me, void *hunoz)
929 { return (mp_pywrap(MP_COPY(GROUP_G(me)->r))); }
931 static PyObject *gget_h(PyObject *me, void *hunoz)
932 { return (mp_pywrap(MP_COPY(GROUP_G(me)->h))); }
934 static const PyGetSetDef ge_pygetset[] = {
935 #define GETSETNAME(op, name) ge##op##_##name
936 GET (group, "X.group -> group containing X")
941 static const PyMethodDef ge_pymethods[] = {
942 #define METHNAME(name) gemeth_##name
943 NAMETH(inv, "X.inv() -> inverse element of X")
944 NAMETH(sqr, "X.sqr() -> X^2 = X * X")
945 NAMETH(check, "X.check() -> check X really belongs to its group")
946 NAMETH(toint, "X.toint() -> X converted to an integer")
947 KWMETH(toec, "X.toec([curve = ECPt]) -> "
948 "X converted to elliptic curve point")
949 NAMETH(tobuf, "X.tobuf() -> X in buffer representation")
950 NAMETH(toraw, "X.toraw() -> X in raw representation")
951 CMTH (frombuf, "frombuf(BUF) -> X, REST")
952 CMTH (fromraw, "fromraw(BUF) -> X, REST")
953 CMTH (fromstring, "fromstring(STR) -> X, REST")
958 static const PyNumberMethods ge_pynumber = {
960 0, /* @nb_subtract@ */
961 ge_pymul, /* @nb_multiply@ */
963 ge_pydiv, /* @nb_divide@ */
965 0, /* @nb_remainder@ */
967 ge_pyexp, /* @nb_power@ */
968 0, /* @nb_negative@ */
969 0, /* @nb_positive@ */
970 0, /* @nb_absolute@ */
971 ge_pynonzerop, /* @nb_nonzero@ */
981 ge_pyint, /* @nb_int@ */
982 PY23(ge_pylong, 0), /* @nb_long@ */
983 0 /* meaningless */, /* @nb_float@ */
989 0, /* @nb_inplace_add@ */
990 0, /* @nb_inplace_subtract@ */
991 0, /* @nb_inplace_multiply@ */
993 0, /* @nb_inplace_divide@ */
995 0, /* @nb_inplace_remainder@ */
996 0, /* @nb_inplace_power@ */
997 0, /* @nb_inplace_lshift@ */
998 0, /* @nb_inplace_rshift@ */
999 0, /* @nb_inplace_and@ */
1000 0, /* @nb_inplace_xor@ */
1001 0, /* @nb_inplace_or@ */
1003 0, /* @nb_floor_divide@ */
1004 ge_pydiv, /* @nb_true_divide@ */
1005 0, /* @nb_inplace_floor_divide@ */
1006 0, /* @nb_inplace_true_divide@ */
1009 static const PyTypeObject ge_pytype_skel = {
1010 PyVarObject_HEAD_INIT(0, 0) /* Header */
1011 "GE", /* @tp_name@ */
1012 sizeof(ge_pyobj), /* @tp_basicsize@ */
1013 0, /* @tp_itemsize@ */
1015 ge_pydealloc, /* @tp_dealloc@ */
1017 0, /* @tp_getattr@ */
1018 0, /* @tp_setattr@ */
1019 0, /* @tp_compare@ */
1021 PYNUMBER(ge), /* @tp_as_number@ */
1022 0, /* @tp_as_sequence@ */
1023 0, /* @tp_as_mapping@ */
1024 ge_pyhash, /* @tp_hash@ */
1026 ge_pystr, /* @tp_str@ */
1027 0, /* @tp_getattro@ */
1028 0, /* @tp_setattro@ */
1029 0, /* @tp_as_buffer@ */
1030 Py_TPFLAGS_DEFAULT | /* @tp_flags@ */
1031 Py_TPFLAGS_CHECKTYPES |
1032 Py_TPFLAGS_BASETYPE,
1035 "Group elements, abstract base class.",
1037 0, /* @tp_traverse@ */
1039 ge_pyrichcompare, /* @tp_richcompare@ */
1040 0, /* @tp_weaklistoffset@ */
1042 0, /* @tp_iternext@ */
1043 PYMETHODS(ge), /* @tp_methods@ */
1044 0, /* @tp_members@ */
1045 PYGETSET(ge), /* @tp_getset@ */
1048 0, /* @tp_descr_get@ */
1049 0, /* @tp_descr_set@ */
1050 0, /* @tp_dictoffset@ */
1052 PyType_GenericAlloc, /* @tp_alloc@ */
1053 abstract_pynew, /* @tp_new@ */
1058 static const PyGetSetDef group_pygetset[] = {
1059 #define GETSETNAME(op, name) g##op##_##name
1060 GET (noctets, "G.noctets -> size in octets of element")
1061 GET (nbits, "G.nbits -> size in bits of element")
1062 GET (i, "G.i -> group identity")
1063 GET (g, "G.g -> group generator")
1064 GET (r, "G.r -> group order")
1065 GET (h, "G.h -> group cofactor")
1070 static const PyMethodDef group_pymethods[] = {
1071 #define METHNAME(name) gmeth_##name
1072 METH (mexp, "G.mexp([(X0, N0), (X1, N1), ...]) -> X0^N0 X1^N1 ...")
1073 KWMETH(checkgroup, "G.checkgroup([rng = rand]): check group is good")
1074 SMTH (parse, "parse(STR) -> G, REST")
1079 static const PyTypeObject group_pytype_skel = {
1080 PyVarObject_HEAD_INIT(0, 0) /* Header */
1081 "Group", /* @tp_name@ */
1082 sizeof(group_pyobj), /* @tp_basicsize@ */
1083 0, /* @tp_itemsize@ */
1085 group_pydealloc, /* @tp_dealloc@ */
1087 0, /* @tp_getattr@ */
1088 0, /* @tp_setattr@ */
1089 0, /* @tp_compare@ */
1091 0, /* @tp_as_number@ */
1092 0, /* @tp_as_sequence@ */
1093 0, /* @tp_as_mapping@ */
1097 0, /* @tp_getattro@ */
1098 0, /* @tp_setattro@ */
1099 0, /* @tp_as_buffer@ */
1100 Py_TPFLAGS_DEFAULT | /* @tp_flags@ */
1101 Py_TPFLAGS_BASETYPE,
1104 "Abstract base class for groups.",
1106 0, /* @tp_traverse@ */
1108 group_pyrichcompare, /* @tp_richcompare@ */
1109 0, /* @tp_weaklistoffset@ */
1111 0, /* @tp_iternext@ */
1112 PYMETHODS(group), /* @tp_methods@ */
1113 0, /* @tp_members@ */
1114 PYGETSET(group), /* @tp_getset@ */
1117 0, /* @tp_descr_get@ */
1118 0, /* @tp_descr_set@ */
1119 0, /* @tp_dictoffset@ */
1121 PyType_GenericAlloc, /* @tp_alloc@ */
1122 abstract_pynew, /* @tp_new@ */
1127 static PyObject *pgget_info(PyObject *me, void *hunoz)
1130 gctx_prime *gg = (gctx_prime *)GROUP_G(me);
1131 dp.p = MP_COPY(gg->mm.m);
1132 dp.q = MP_COPY(gg->g.r);
1133 dp.g = mpmont_reduce(&gg->mm, MP_NEW, gg->gen.x);
1134 return (fginfo_pywrap(&dp, dhinfo_pytype));
1137 static const PyGetSetDef primegroup_pygetset[] = {
1138 #define GETSETNAME(op, name) pg##op##_##name
1139 GET (info, "G.info -> information about the group")
1144 static PyObject *primegroup_pynew(PyTypeObject *ty,
1145 PyObject *arg, PyObject *kw)
1148 static const char *const kwlist[] = { "info", 0 };
1150 if (!PyArg_ParseTupleAndKeywords(arg, kw, "O!:new", KWLIST,
1153 return (group_dopywrap(ty, group_prime(FGINFO_DP(i))));
1156 static const PyTypeObject primegroup_pytype_skel = {
1157 PyVarObject_HEAD_INIT(0, 0) /* Header */
1158 "PrimeGroup", /* @tp_name@ */
1159 sizeof(group_pyobj), /* @tp_basicsize@ */
1160 0, /* @tp_itemsize@ */
1162 group_pydealloc, /* @tp_dealloc@ */
1164 0, /* @tp_getattr@ */
1165 0, /* @tp_setattr@ */
1166 0, /* @tp_compare@ */
1168 0, /* @tp_as_number@ */
1169 0, /* @tp_as_sequence@ */
1170 0, /* @tp_as_mapping@ */
1174 0, /* @tp_getattro@ */
1175 0, /* @tp_setattro@ */
1176 0, /* @tp_as_buffer@ */
1177 Py_TPFLAGS_DEFAULT | /* @tp_flags@ */
1178 Py_TPFLAGS_BASETYPE,
1181 "PrimeGroup(INFO): subgroups of prime fields.",
1183 0, /* @tp_traverse@ */
1185 0, /* @tp_richcompare@ */
1186 0, /* @tp_weaklistoffset@ */
1188 0, /* @tp_iternext@ */
1189 0, /* @tp_methods@ */
1190 0, /* @tp_members@ */
1191 PYGETSET(primegroup), /* @tp_getset@ */
1194 0, /* @tp_descr_get@ */
1195 0, /* @tp_descr_set@ */
1196 0, /* @tp_dictoffset@ */
1198 PyType_GenericAlloc, /* @tp_alloc@ */
1199 primegroup_pynew, /* @tp_new@ */
1204 static PyObject *bgget_info(PyObject *me, void *hunoz)
1207 gctx_bin *gg = (gctx_bin *)GROUP_G(me);
1208 dp.p = MP_COPY(gg->r.p);
1209 dp.q = MP_COPY(gg->g.r);
1210 dp.g = MP_COPY(gg->gen.x);
1211 return (fginfo_pywrap(&dp, bindhinfo_pytype));
1214 static const PyGetSetDef bingroup_pygetset[] = {
1215 #define GETSETNAME(op, name) bg##op##_##name
1216 GET (info, "G.info -> information about the group")
1221 static PyObject *bingroup_pynew(PyTypeObject *ty,
1222 PyObject *arg, PyObject *kw)
1225 static const char *const kwlist[] = { "info", 0 };
1227 if (!PyArg_ParseTupleAndKeywords(arg, kw, "O!:new", KWLIST,
1228 bindhinfo_pytype, &i))
1230 return (group_dopywrap(ty, group_binary(FGINFO_DP(i))));
1233 static const PyTypeObject bingroup_pytype_skel = {
1234 PyVarObject_HEAD_INIT(0, 0) /* Header */
1235 "BinGroup", /* @tp_name@ */
1236 sizeof(group_pyobj), /* @tp_basicsize@ */
1237 0, /* @tp_itemsize@ */
1239 group_pydealloc, /* @tp_dealloc@ */
1241 0, /* @tp_getattr@ */
1242 0, /* @tp_setattr@ */
1243 0, /* @tp_compare@ */
1245 0, /* @tp_as_number@ */
1246 0, /* @tp_as_sequence@ */
1247 0, /* @tp_as_mapping@ */
1251 0, /* @tp_getattro@ */
1252 0, /* @tp_setattro@ */
1253 0, /* @tp_as_buffer@ */
1254 Py_TPFLAGS_DEFAULT | /* @tp_flags@ */
1255 Py_TPFLAGS_BASETYPE,
1258 "BinGroup(INFO): subgroups of binary fields.",
1260 0, /* @tp_traverse@ */
1262 0, /* @tp_richcompare@ */
1263 0, /* @tp_weaklistoffset@ */
1265 0, /* @tp_iternext@ */
1266 0, /* @tp_methods@ */
1267 0, /* @tp_members@ */
1268 PYGETSET(bingroup), /* @tp_getset@ */
1271 0, /* @tp_descr_get@ */
1272 0, /* @tp_descr_set@ */
1273 0, /* @tp_dictoffset@ */
1275 PyType_GenericAlloc, /* @tp_alloc@ */
1276 bingroup_pynew, /* @tp_new@ */
1281 static PyObject *egget_info(PyObject *me, void *hunoz)
1284 gctx_ec *gg = (gctx_ec *)GROUP_G(me);
1286 ecinfo_copy(&ei, &gg->ei);
1287 return (ecinfo_pywrap(&ei));
1290 static const PyGetSetDef ecgroup_pygetset[] = {
1291 #define GETSETNAME(op, name) eg##op##_##name
1292 GET (info, "G.info -> information about the group")
1297 static PyObject *ecgroup_pynew(PyTypeObject *ty,
1298 PyObject *arg, PyObject *kw)
1302 static const char *const kwlist[] = { "info", 0 };
1304 if (!PyArg_ParseTupleAndKeywords(arg, kw, "O!:new", KWLIST,
1307 ecinfo_copy(&ei, ECINFO_EI(i));
1308 return (group_dopywrap(ty, group_ec(&ei)));
1311 static const PyTypeObject ecgroup_pytype_skel = {
1312 PyVarObject_HEAD_INIT(0, 0) /* Header */
1313 "ECGroup", /* @tp_name@ */
1314 sizeof(group_pyobj), /* @tp_basicsize@ */
1315 0, /* @tp_itemsize@ */
1317 group_pydealloc, /* @tp_dealloc@ */
1319 0, /* @tp_getattr@ */
1320 0, /* @tp_setattr@ */
1321 0, /* @tp_compare@ */
1323 0, /* @tp_as_number@ */
1324 0, /* @tp_as_sequence@ */
1325 0, /* @tp_as_mapping@ */
1329 0, /* @tp_getattro@ */
1330 0, /* @tp_setattro@ */
1331 0, /* @tp_as_buffer@ */
1332 Py_TPFLAGS_DEFAULT | /* @tp_flags@ */
1333 Py_TPFLAGS_BASETYPE,
1336 "ECGroup(INFO): elliptic curve groups.",
1338 0, /* @tp_traverse@ */
1340 0, /* @tp_richcompare@ */
1341 0, /* @tp_weaklistoffset@ */
1343 0, /* @tp_iternext@ */
1344 0, /* @tp_methods@ */
1345 0, /* @tp_members@ */
1346 PYGETSET(ecgroup), /* @tp_getset@ */
1349 0, /* @tp_descr_get@ */
1350 0, /* @tp_descr_set@ */
1351 0, /* @tp_dictoffset@ */
1353 PyType_GenericAlloc, /* @tp_alloc@ */
1354 ecgroup_pynew, /* @tp_new@ */
1359 /*----- Global stuff ------------------------------------------------------*/
1361 void group_pyinit(void)
1363 INITTYPE(fginfo, root);
1364 INITTYPE(dhinfo, fginfo);
1365 INITTYPE(bindhinfo, dhinfo);
1367 INITTYPE(group, type);
1368 INITTYPE(primegroup, group);
1369 INITTYPE(bingroup, group);
1370 INITTYPE(ecgroup, group);
1373 static const char *grp_namefn(const void *p)
1374 { const pentry *pt = p; return (pt->name); }
1376 static int grp_ixfn(const pentry *tab, const pentry *pt)
1380 for (i = 0; tab[i].name; i++)
1381 if (tab[i].data == pt->data) return (i);
1384 static int pgrp_ixfn(const void *p) { return (grp_ixfn(ptab, p)); }
1385 static int bgrp_ixfn(const void *p) { return (grp_ixfn(bintab, p)); }
1387 static PyObject *grp_valfn(const pentry *tab, PyTypeObject *ty, int i)
1391 dh_infofromdata(&gp, tab[i].data);
1392 return (fginfo_pywrap(&gp, ty));
1394 static PyObject *pgrp_valfn(int i)
1395 { return (grp_valfn(ptab, dhinfo_pytype, i)); }
1396 static PyObject *bgrp_valfn(int i)
1397 { return (grp_valfn(bintab, bindhinfo_pytype, i)); }
1399 void group_pyinsert(PyObject *mod)
1401 INSERT("FGInfo", fginfo_pytype);
1402 INSERT("DHInfo", dhinfo_pytype);
1403 INSERT("BinDHInfo", bindhinfo_pytype);
1404 INSERT("GE", ge_pytype);
1405 INSERT("Group", group_pytype);
1406 INSERT("PrimeGroup", primegroup_pytype);
1407 INSERT("BinGroup", bingroup_pytype);
1408 INSERT("ECGroup", ecgroup_pytype);
1409 INSERT("primegroups", make_grouptab(ptab, sizeof(*ptab),
1410 grp_namefn, pgrp_ixfn, pgrp_valfn));
1411 INSERT("bingroups", make_grouptab(bintab, sizeof(*bintab),
1412 grp_namefn, bgrp_ixfn, bgrp_valfn));
1415 /*----- That's all, folks -------------------------------------------------*/