pairinggroup

class pairinggroup.PairingGroup(param_id, param_file=False, secparam=512, verbose=False, seed1=None, seed2=None)

Bases: object

EndBenchmark()

ends an ongoing benchmark

GetBenchmark(option)

retrieves benchmark results for any of these options: RealTime, CpuTime, Mul, Div, Add, Sub, Exp, Pair, Granular

GetGeneralBenchmarks()

retrieves benchmark count for all group operations

GetGranularBenchmarks()

retrieves group operation count per type: ZR, G1, G2, and GT

InitBenchmark()

initiates the benchmark state

StartBenchmark(options)

starts the benchmark with any of these options: RealTime, CpuTime, Mul, Div, Add, Sub, Exp, Pair, Granular

debug(data, prefix=None)

decode(element)

deserialize(obj, compression=True)

Deserialize a bytes serialized element into a pairing object.

Parameters:

compression – must be used for objects serialized with the compression parameter set to True. Default is True for compatibility with previous versions of charm.

encode(message)

groupSetting()

groupType()

hash(args, type=charm.core.math.pairing.ZR)

hashes objects into ZR, G1 or G2 depending on the pairing curve

init(type, value=None)

initializes an object with a specified type and value

ismember(obj)

membership test for a pairing object

ismemberDict(obj)

membership test for a dict of pairing objects

ismemberList(obj)

membership test for a list of pairing objects

messageSize()

after filling complete bytes with every 8 bits, any remaining 1, 2, …, 7 more bits will occupy an additional byte, even if they do not form a complete byte

order()

returns the order of the group

pair_prod(lhs, rhs)

takes two lists of G1 & G2 and computes a pairing product

paramgen(qbits, rbits)

random(_type=charm.core.math.pairing.ZR, count=1, seed=None)

selects one or more random elements in ZR, G1, G2 and GT

serialize(obj, compression=True)

Serialize a pairing object into bytes.

Parameters:

compression –

serialize the compressed representation of the

curve element, taking about half the space but potentially incurring in non-negligible computation costs when deserializing. Default is True for compatibility with previous versions of charm.

>>> p = PairingGroup('SS512')
>>> v1 = p.random(G1)
>>> b1 = p.serialize(v1)
>>> b1 == p.serialize(v1, compression=True)
True
>>> v1 == p.deserialize(b1)
True
>>> b1 = p.serialize(v1, compression=False)
>>> v1 == p.deserialize(b1, compression=False)
True

pairinggroup.extract_key(g)

Given a group element, extract a symmetric key :param g: :return: