Security Scol plugin
rw.h
Go to the documentation of this file.
1// rw.h - originally written and placed in the public domain by Wei Dai
2
11
12#ifndef CRYPTOPP_RW_H
13#define CRYPTOPP_RW_H
14
15#include "cryptlib.h"
16#include "pubkey.h"
17#include "integer.h"
18
19NAMESPACE_BEGIN(CryptoPP)
20
21
23class CRYPTOPP_DLL RWFunction : public TrapdoorFunction, public PublicKey
24{
25 typedef RWFunction ThisClass;
26
27public:
28
31 void Initialize(const Integer &n)
32 {m_n = n;}
33
34 void BERDecode(BufferedTransformation &bt);
35 void DEREncode(BufferedTransformation &bt) const;
36
38 {DEREncode(bt);}
40 {BERDecode(bt);}
41
42 Integer ApplyFunction(const Integer &x) const;
43 Integer PreimageBound() const {return ++(m_n>>1);}
44 Integer ImageBound() const {return m_n;}
45
46 bool Validate(RandomNumberGenerator &rng, unsigned int level) const;
47 bool GetVoidValue(const char *name, const std::type_info &valueType, void *pValue) const;
48 void AssignFrom(const NameValuePairs &source);
49
50 const Integer& GetModulus() const {return m_n;}
51 void SetModulus(const Integer &n) {m_n = n;}
52
53protected:
54 Integer m_n;
55};
56
59class CRYPTOPP_DLL InvertibleRWFunction : public RWFunction, public TrapdoorFunctionInverse, public PrivateKey
60{
62
63public:
65 InvertibleRWFunction() : m_precompute(false) {}
66
73 void Initialize(const Integer &n, const Integer &p, const Integer &q, const Integer &u);
74
81 void Initialize(RandomNumberGenerator &rng, unsigned int modulusBits)
82 {GenerateRandomWithKeySize(rng, modulusBits);}
83
84 void BERDecode(BufferedTransformation &bt);
85 void DEREncode(BufferedTransformation &bt) const;
86
88 {DEREncode(bt);}
90 {BERDecode(bt);}
91
93
94 // GeneratibleCryptoMaterial
95 bool Validate(RandomNumberGenerator &rng, unsigned int level) const;
96 bool GetVoidValue(const char *name, const std::type_info &valueType, void *pValue) const;
97 void AssignFrom(const NameValuePairs &source);
100
101 const Integer& GetPrime1() const {return m_p;}
102 const Integer& GetPrime2() const {return m_q;}
103 const Integer& GetMultiplicativeInverseOfPrime2ModPrime1() const {return m_u;}
104
105 void SetPrime1(const Integer &p) {m_p = p;}
106 void SetPrime2(const Integer &q) {m_q = q;}
107 void SetMultiplicativeInverseOfPrime2ModPrime1(const Integer &u) {m_u = u;}
108
109 virtual bool SupportsPrecomputation() const {return true;}
110 virtual void Precompute(unsigned int unused = 0) {CRYPTOPP_UNUSED(unused); PrecomputeTweakedRoots();}
111 virtual void Precompute(unsigned int unused = 0) const {CRYPTOPP_UNUSED(unused); PrecomputeTweakedRoots();}
112
113 virtual void LoadPrecomputation(BufferedTransformation &storedPrecomputation);
114 virtual void SavePrecomputation(BufferedTransformation &storedPrecomputation) const;
115
116protected:
117 void PrecomputeTweakedRoots() const;
118
119protected:
120 Integer m_p, m_q, m_u;
121
122 mutable Integer m_pre_2_9p, m_pre_2_3q, m_pre_q_p;
123 mutable bool m_precompute;
124};
125
128struct RW
129{
130 CRYPTOPP_STATIC_CONSTEXPR const char* StaticAlgorithmName() {return "RW";}
131 typedef RWFunction PublicKey;
133};
134
139template <class STANDARD, class H>
140struct RWSS : public TF_SS<RW, STANDARD, H>
141{
142};
143
144NAMESPACE_END
145
146#endif
Interface for buffered transformations.
Definition cryptlib.h:1652
virtual void LoadPrecomputation(BufferedTransformation &storedPrecomputation)
Retrieve previously saved precomputation.
Definition cryptlib.h:2481
virtual void SavePrecomputation(BufferedTransformation &storedPrecomputation) const
Save precomputation for later use.
Definition cryptlib.h:2488
virtual void Precompute(unsigned int precomputationStorage)
Perform precomputation.
Definition cryptlib.h:2472
void GenerateRandomWithKeySize(RandomNumberGenerator &rng, unsigned int keySize)
Generate a random key or crypto parameters.
Definition cryptlib.cpp:840
virtual void GenerateRandom(RandomNumberGenerator &rng, const NameValuePairs &params=g_nullNameValuePairs)
Generate a random key or crypto parameters.
Definition cryptlib.h:2520
Multiple precision integer with arithmetic operations.
Definition integer.h:50
Rabin-Williams trapdoor function using the private key.
Definition rw.h:60
void Save(BufferedTransformation &bt) const
Saves a key to a BufferedTransformation.
Definition rw.h:87
void Load(BufferedTransformation &bt)
Loads a key from a BufferedTransformation.
Definition rw.h:89
void Initialize(RandomNumberGenerator &rng, unsigned int modulusBits)
Create a Rabin-Williams private key.
Definition rw.h:81
virtual bool SupportsPrecomputation() const
Determines whether the object supports precomputation.
Definition rw.h:109
InvertibleRWFunction()
Construct an InvertibleRWFunction.
Definition rw.h:65
virtual void Precompute(unsigned int unused=0)
Perform precomputation.
Definition rw.h:110
Interface for retrieving values given their names.
Definition cryptlib.h:322
Interface for private keys.
Definition cryptlib.h:2541
Interface for public keys.
Definition cryptlib.h:2536
Rabin-Williams trapdoor function using the public key.
Definition rw.h:24
Integer PreimageBound() const
Returns the maximum size of a message before the trapdoor function is applied.
Definition rw.h:43
Integer ImageBound() const
Returns the maximum size of a representation after the trapdoor function is applied.
Definition rw.h:44
void Save(BufferedTransformation &bt) const
Saves a key to a BufferedTransformation.
Definition rw.h:37
void Initialize(const Integer &n)
Initialize a Rabin-Williams public key.
Definition rw.h:31
void AssignFrom(const NameValuePairs &source)
Assign values to this object.
Definition rw.cpp:89
bool GetVoidValue(const char *name, const std::type_info &valueType, void *pValue) const
Get a named value.
Definition rw.cpp:82
void Load(BufferedTransformation &bt)
Loads a key from a BufferedTransformation.
Definition rw.h:39
bool Validate(RandomNumberGenerator &rng, unsigned int level) const
Check this object for errors.
Definition rw.cpp:73
Interface for random number generators.
Definition cryptlib.h:1435
Trapdoor Function (TF) Signature Scheme.
Definition pubkey.h:2316
Applies the trapdoor function.
Definition pubkey.h:126
Applies the inverse of the trapdoor function.
Definition pubkey.h:179
virtual Integer CalculateInverse(RandomNumberGenerator &rng, const Integer &x) const =0
Calculates the inverse of an element.
Abstract base classes that provide a uniform interface to this library.
Multiple precision integer with arithmetic operations.
This file contains helper classes/functions for implementing public key algorithms.
Rabin-Williams keys.
Definition rw.h:129
Rabin-Williams signature scheme.
Definition rw.h:141