CMakeLists.txt

@@ -14,7 +14,7 @@ else()
     add_compile_options(-Wall -Wextra -pedantic)
 endif()
 
-project(oc-issuer VERSION 0.0.2 LANGUAGES CXX)
+project(oc-mint VERSION 0.0.1 LANGUAGES CXX)
 
 include(FetchContent)
 
@@ -64,10 +64,10 @@ find_package(Doxygen
              REQUIRED dot
              OPTIONAL_COMPONENTS mscgen dia)
 set(DOXYGEN_HAVE_DOT YES)
-doxygen_add_docs( doc
+doxygen_add_docs(
-                  README.md 
+    doc
-                  src
+    src
-		  COMMENT "Generate documentation"
+    COMMENT "Generate documentation"
 )
 
 # build common library
@@ -76,8 +76,8 @@ add_library(oc-mint-lib ${LIB_SOURCES})
 target_link_libraries(oc-mint-lib PUBLIC Crow::Crow)
 target_include_directories(oc-mint-lib PUBLIC ${expected_SOURCE_DIR}/include src) 
 
-add_executable(${PROJECT_NAME} src/main.cpp)
+add_executable(oc-mint src/main.cpp)
-target_link_libraries(${PROJECT_NAME} PRIVATE oc-mint-lib INTERFACE tl::expected::expected)
+target_link_libraries(oc-mint PRIVATE oc-mint-lib INTERFACE tl::expected::expected)
 
 ## these are unittests that can be run on any platform
 add_executable(tests  test/test_big_int.cpp test/test.cpp)

README.md

@@ -1,47 +1,23 @@
-opencoin-issuer-cpp - a C++ OpenCoin Issuer REST-API implementation {#mainpage}
+![build](https://github.com/OpenCoin/oc-mint-cpp/actions/workflows/cmake.yaml/badge.svg)
-=============================================================
 
-![build](https://github.com/OpenCoin/opencoin-issuer-cpp/actions/workflows/cmake.yaml/badge.svg)
+# oc mint sample
-[![Documentation](https://github.com/OpenCoin/opencoin-issuer-cpp/actions/workflows/doxygen-gh-pages.yml/badge.svg)](https://github.com/OpenCoin/opencoin-issuer-cpp/actions/workflows/doxygen-gh-pages.yml)
 
-# opencoin issuer
+this is a C++ implementation of the opencoin protocol 
+as mapping to some kind of REST interface 
 
-this is a C++ implementation of the [opencoin protocol](https://opencoin.org/0.4/OpenCoin.html)
+actually it is a work in progress.
-done as mapping to some kind of REST interface.
-
-As all issuer related interactions of the protocol follows a request/response mechanism we are able to map all of them to Http-Requests.
-
-We decided to use POST-Requests in all cases, 
-as the protocol uses JSON-formatted messages for requests.
-
-The following table gives an overview of the mapping of requests to URLs:
-
-| Request           | URL          | Response                      | C++ Interface Method                               |
-|:------------------|:-------------|:------------------------------|:---------------------------------------------------|
-| RequestCDDCSerial | /cddc/serial | ResponseCDDCSerial            | cdd.cdd_serial of Model::getCurrentCDDC() |
-| RequestCDDC       | /cddc        | ResponseCDDC                  | Model::getCurrentCDDC()                            |
-| RequestMKCs       | /mkcs        | ResponseMKCs                  | Model::getMKCs                                     |
-| RequestMint       | /mint        | ResponseMint                  | Model::mint                                        |
-| RequestRenew      | /renew       | ResponseMint or ResponseDelay | ?                                                  |
-| RequestResume     | /resume      | ResponseMint or ResponseDelay | ?                                                  |
-| RequestRedeem     | /redeem      | ResponseRedeem                | Model::redeem                                      |
-
-actually the implementation is a work in progress.
-
-## TODO
-
-- [ ] select crypto library
-   + https://en.wikipedia.org/wiki/Comparison_of_cryptography_libraries
-+ [ ] blinding utilizing crypto++
-+ [ ] integrate session and login to make transactions account based
-+ [ ] bookkeeping for accounts
 
 ## Protocol Questions
 
 + What is signed as cdd - only the content of the cdd item with curly braces 
 or also the key?
 + the weighted URL as array has a different js encoding as other elements
-+ Clarify PSS usage (see https://crypto.stackexchange.com/questions/12707/usability-of-padding-scheme-in-blinded-rsa-signature) 
++ Clarify PSS usage (see https://crypto.stackexchange.com/questions/12707/usability-of-padding-scheme-in-blinded-rsa-signature)
+
+## TODO
+
++ [ ] bigint type for big integers encoded as string
++ [ ] blinding utilizing crypto++
 
 ### Blinding Notes
 

src/main.cpp

@@ -29,11 +29,11 @@ int main() {
 
   CROW_ROUTE(app, "/cddc/serial")
       .methods(crow::HTTPMethod::POST)([&model](const crow::request &request) {
-        auto req = RequestCDDCSerial::from_string(request.body);
+        auto req = RequestCDDSerial::from_string(request.body);
         if (!req) {
           return crow::response(crow::status::BAD_REQUEST);
         } else {
-          ResponseCDDCSerial res;
+          ResponseCDDSerial res;
           res.message_reference = req->message_reference;
 
           auto cddc = model->getCurrentCDDC();

src/model.cpp

@@ -104,7 +104,7 @@ crow::json::wvalue Response::to_json() const {
   return r;
 }
 
-crow::json::wvalue ResponseCDDCSerial::to_json() const {
+crow::json::wvalue ResponseCDDSerial::to_json() const {
   crow::json::wvalue r = Response::to_json();
   TO_JSON(cdd_serial);
 
@@ -112,8 +112,8 @@ crow::json::wvalue ResponseCDDCSerial::to_json() const {
   return r;
 }
 
-tl::expected<RequestCDDCSerial, eError>
+tl::expected<RequestCDDSerial, eError>
-RequestCDDCSerial::from_string(const std::string &str) {
+RequestCDDSerial::from_string(const std::string &str) {
   auto json = crow::json::load(str);
   if (!json) {
     return tl::make_unexpected(eError::JSON_PARSE_ERROR);
@@ -122,7 +122,7 @@ RequestCDDCSerial::from_string(const std::string &str) {
   } else if (json["type"] != "request cdd serial") {
     return tl::make_unexpected(eError::JSON_ERROR);
   } else {
-    RequestCDDCSerial r;
+    RequestCDDSerial r;
     r.message_reference = json["message_reference"].u();
     return r;
   }

src/model.hpp

@@ -25,36 +25,30 @@ struct WeightedUrl {
   crow::json::wvalue to_json() const;
 };
 
-/** @brief currency description document 
+/** currency description document */
- *
- * this structure describes a currency based on opencoin protocol. 
- * It can be converted to json to provide the specified currency 
- * description document. 
- */
 struct CDD {
 
   std::string additional_info;
-  time_t cdd_expiry_date;    /// expiry date of this document (e.g.
+  time_t cdd_expiry_date;//: 2023-07-22T15:45:53.164685
-                             ///2023-07-22T15:45:53.164685)
+  std::string  cdd_location;//: https://opencent.org,
-  std::string cdd_location;  /// URL of location of this document (e.g
+  size_t cdd_serial;//: 1,
-                             ///https://opencent.org)
+  time_t  cdd_signing_date;//: 2022-07-22T15:45:53.164685,
-  size_t cdd_serial;         /// serial number of currency description document
+  size_t  currency_divisor;//: 100,
-  time_t cdd_signing_date;   /// date of signing this document (e.g.
+  std::string  currency_name;//: OpenCent,
-                             ///2022-07-22T15:45:53.164685)
+  std::vector<unsigned>  denominations;//: [1, 2, 5],
-  size_t currency_divisor;   /// divisor used for coins of this currency
+  BigInt id;//: 23ed956e629ba35f0002eaf833ea436aea7db5c2,
-  std::string currency_name; /// name of the currency (e.g. OpenCent)
-  std::vector<unsigned>
-      denominations; /// the available denominations of this currency
-  BigInt id;         /// an identity for this currency
 
-  std::vector<WeightedUrl> info_service;
+std::vector<WeightedUrl> info_service;
-  /* eCipherSuite*/
+  /* eCipherSuite*/ std::string issuer_cipher_suite; //: RSA-SHA256-PSS-CHAUM82,
-  std::string issuer_cipher_suite; /// the cipher suite used for this currencey
+  PublicKey
-                                   /// (currently only RSA-SHA256-PSS-CHAUM82 
+      issuer_public_master_key; //: {
-                                   ///  is supported)
+                                //  modulus:
-  PublicKey issuer_public_master_key; /// the public key of this currency
+                                //  daaa63ddda38c189b8c49020c8276adbe0a695685a...,
+                                // public_exponent: 65537,
+                                // type: rsa public key
+  //},
   std::vector<WeightedUrl> mint_service;
-  std::string protocol_version; // e.g. https://opencoin.org/1.0
+  std::string protocol_version; //: https://opencoin.org/1.0,
   std::vector<WeightedUrl> redeem_service;
   std::vector<WeightedUrl> renew_service;
 
@@ -106,14 +100,14 @@ struct Response {
   virtual crow::json::wvalue to_json() const;
 };
 
-struct RequestCDDCSerial {
+struct RequestCDDSerial {
   unsigned int message_reference; /// Client internal message reference.
                                   /// (Integer)
-  static tl::expected<RequestCDDCSerial, eError>
+  static tl::expected<RequestCDDSerial, eError>
   from_string(const std::string &str);
 };
 
-struct ResponseCDDCSerial : Response {
+struct ResponseCDDSerial : Response {
   unsigned int cdd_serial;
 
   crow::json::wvalue to_json() const override;
@@ -243,63 +237,18 @@ class Model {
 public:
   virtual ~Model(){};
 
-  /** 
-   * return the CurrencyDocumentDescription certifikate for a specific 
-   * serial version number of it.
-   * [see spec](https://opencoin.org/0.4/schemata.html#cddc)
-   * @return returns a pointer to the CDDC if successful, false otherwise
-   */
   virtual tl::expected<CDDC *, bool> getCDDC(unsigned int cdd_serial) = 0;
+  virtual tl::expected<CDDC *, bool> getCurrentCDDC() = 0;
 
-  /** 
-   * return the CurrencyDocumentDescription certifikate 
-   * [see spec](https://opencoin.org/0.4/schemata.html#cddc)
-   * @return returns a pointer to the CDDC if successful, false otherwise
-   */virtual tl::expected<CDDC *, bool> getCurrentCDDC() = 0;
-
-  /** 
-   * return the MintKey certificates for a given list of denominations 
-   * and mint key ids
-   *
-   * @param denominations 
-   * @param mint_key_ids 
-   *
-   * @return mint key certificates for given denominations and mint_key_ids
-   */
   virtual const std::vector<MintKeyCert>
   getMKCs(const std::vector<unsigned int> &denominations,
           const std::vector<BigInt> &mint_key_ids) = 0;
 
-
-  /** 
-   * returns the vector of blind signatures for a given vector of blinds
-   *
-   * @param transaction_reference reference to a transaction (send from client)
-   * @param blinds the vector of blinds to sign
-   *
-   * @return 
-   */
   virtual std::vector<BlindSignature>
   mint(std::string const& transaction_reference,
        const std::vector<Blind> &blinds) = 0;
-
-  /** 
-   * redeem valid coins into real money
-   *
-   * @param coins the coins to redeem
-   *
-   * @return true if successful, false on error
-   */
   virtual bool redeem(const std::vector<Coin> &coins) = 0;
 
-  /** 
-   * factory function returning a concrete backend for Opencoin API handling.
-   * based on backend_name a concrete backend will be returned 
-   * or in case of error null.
-   * @param backend_name 
-   *
-   * @return pointer to backend instance or null on invalid backend name
-   */
   static std::unique_ptr<Model> getModel(const std::string &backend_name);
 
 private:

test/test.cpp

@@ -15,32 +15,32 @@ TEST_CASE( "PublicKey::to_json", "[to_json]" ) {
   REQUIRE( json.keys().size() == 3 );
 }
 
-TEST_CASE("RequestCDDCSerial::from_string", "[from_string]") {
+TEST_CASE("RequestCDDSerial::from_string", "[from_string]") {
   // good case
   std::string good = "{"
                      "\"message_reference\": 100000,"
                      "\"type\": \"request cdd serial\""
                      "}";
 
-  auto res = RequestCDDCSerial::from_string(good);
+  auto res = RequestCDDSerial::from_string(good);
   REQUIRE(res.has_value() == true);
   REQUIRE(res->message_reference == 100000);
 
   // bad cases
-  res = RequestCDDCSerial::from_string("");
+  res = RequestCDDSerial::from_string("");
   REQUIRE(res.has_value() == false);
 
   // invalid type
-  res = RequestCDDCSerial::from_string("{"
+  res = RequestCDDSerial::from_string("{"
-                                       "\"message_reference\": 100000,"
+                                      "\"message_reference\": 100000,"
-                                       "\"type\": \"request something wrong\""
+                                      "\"type\": \"request something wrong\""
-                                       "}");
+                                      "}");
   REQUIRE(res.has_value() == false);
 
   // invalid attribute name
-  res = RequestCDDCSerial::from_string("{"
+  res = RequestCDDSerial::from_string("{"
-                                       "\"x_message_reference\": 100000,"
+                                      "\"x_message_reference\": 100000,"
-                                       "}");
+                                      "}");
   REQUIRE(res.has_value() == false);
 }