Merge pull request #95 from scryptonight/main

Added web front-end for the identity portion of the project

Author: klembee

3-lending/demifi/.gitignore

@@ -0,0 +1 @@
+*~

3-lending/demifi/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "demifi"
-version = "1.0.0"
+version = "2.0.0"
 edition = "2021"
 
 [dependencies]

3-lending/demifi/README.md

@@ -0,0 +1,34 @@
+![](./web/public/DeMiFi%20logo.png)
+
+# DeMiFi - Decentralized Micro-Finance
+This project provides a set of blueprints which when used together
+will allow you to offer micro-finance services on the ledger.
+
+It consists of three different blueprints working together, with one
+blueprint offering identity services for the participants and the two
+other handling loan requests and loan management.
+
+## How to build and test the web front-end
+You need to have npm installed on your system. You do not need to
+build the blueprints themselves to build and run the front-end.
+- From the command line, in the `demifi/web` directory, run `npm
+  install && npm run dev`
+- Connect your web browser to the URL it shows you
+
+## How to build the blueprints
+Make sure you have the necessary toolchain installed, including the
+resim tool, see
+[here](https://docs.radixdlt.com/main/scrypto/getting-started/install-scrypto.html)
+for details.
+- From the command line, in the `demifi` directory, run `cargo build`
+
+### How to run the test suite
+- Make sure you have the resim tool installed, see above.
+- From the command line, in the `demifi` directory, run `cargo test --
+  --test-threads=1`
+
+### How to generate the documentation
+- From the command line, in the `demifi` directory, run `cargo doc`
+
+The generated web pages contain detailed documentation on how the
+blueprints work.

3-lending/demifi/src/loanrequestor.rs

@@ -194,10 +194,11 @@
 //! Participants catalog should get the job done --- but I don't know
 //! your business.)
 //!
-//! Each LoanRequestor instance needs to paired with one LoanAcceptor
-//! instance (see [crate::loanacceptor]). The requestor manages the
-//! loan request negotiation, and the acceptor converts the request
-//! into an actual loan and manages the repayment etc. of that loan.
+//! Each LoanRequestor instance needs to be paired with one
+//! LoanAcceptor instance (see [crate::loanacceptor]). The requestor
+//! manages the loan request negotiation, and the acceptor converts
+//! the request into an actual loan and manages the repayment etc. of
+//! that loan.
 //!
 //! # Load balancing
 //!

3-lending/demifi/src/participants.rs

@@ -123,6 +123,9 @@ blueprint! {
         /// The NFT resource address of this Participant catalog.
         nft_address: ResourceAddress,
 
+        /// NonFungibleIds are allocated from this counter.
+        nft_serial: u64,
+
         /// Our admin badge, used to manage the Participent NFTs.
         admin_badge: Vault,
 
@@ -181,6 +184,7 @@ blueprint! {
             let (nft, nfid) = Participants::create_participant(
                 &badge,
                 nft_address,
+                0,
                 root_participant_name.unwrap_or(
                     "Loan market creator".to_string()),
                 "".to_string(),
@@ -190,6 +194,7 @@ blueprint! {
             let participants =
                 Self {
                     nft_address,
+                    nft_serial: 0,
                     admin_badge: badge,
                     catalog_creator: nfid.clone(),
                 }
@@ -217,14 +222,16 @@ blueprint! {
         /// ```text
         #[doc = include_str!("../rtm/participants/new_participant.rtm")]
         /// ```
-        pub fn new_participant(&self,
+        pub fn new_participant(&mut self,
                                name: String,
                                url: String,
                                id_ref: String,
                                expect_sponsor: Option<NonFungibleId>) -> (Bucket, NonFungibleId)
         {
+            self.nft_serial += 1;
             Participants::create_participant(&self.admin_badge,
                                              self.nft_address,
+                                             self.nft_serial,
                                              name,
                                              url,
                                              id_ref,
@@ -525,6 +532,18 @@ blueprint! {
             self.nft_address
         }
 
+        /// Retrieves the last serial number used to create a
+        /// Participant NFT.
+        ///
+        /// ---
+        ///
+        /// **Access control:** Read only, allows anyone.
+        ///
+        /// **Transaction manifest:** TODO
+        pub fn read_participants_nft_serial(&self) -> u64 {
+            self.nft_serial
+        }
+
         /// Retrieves address of the catalog creator's Participant
         /// NFT.
         ///
@@ -548,12 +567,13 @@ blueprint! {
         /// Helper function to create a new Participant.
         fn create_participant(admin_badge: &Vault,
                               nft_address: ResourceAddress,
+                              nft_serial: u64,
                               name: String,
                               url: String,
                               id_ref: String,
                               expect_sponsor: Option<NonFungibleId>) -> (Bucket, NonFungibleId)
         {
-            let nfid: NonFungibleId = NonFungibleId::random();
+            let nfid: NonFungibleId = NonFungibleId::from_u64(nft_serial);
             let nft: Bucket = admin_badge.authorize(||
                 borrow_resource_manager!(nft_address)
                     .mint_non_fungible(

3-lending/demifi/web/.gitignore

@@ -1,3 +1,25 @@
-.snowpack
-build
-node_modules
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+node_modules
+dist
+dist-ssr
+*.local
+
+# Editor directories and files
+.vscode/*
+!.vscode/extensions.json
+.idea
+.DS_Store
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?
+*~

3-lending/demifi/web/.prettierrc

@@ -0,0 +1,16 @@
+<!DOCTYPE html>
+<html lang="en">
+    <head>
+	<meta charset="UTF-8" />
+	<link rel="apple-touch-icon" sizes="180x180" href="/apple-touch-icon.png">
+	<link rel="icon" type="image/png" sizes="32x32" href="favicon-32x32.png">
+	<link rel="icon" type="image/png" sizes="16x16" href="favicon-16x16.png">
+	<link rel="manifest" href="site.webmanifest">
+	<meta name="viewport" content="width=device-width, initial-scale=1.0" />
+	<title>DeMiFi</title>
+    </head>
+    <body>
+	<div id="app"></div>
+	<script type="module" src="/src/main.ts"></script>
+    </body>
+</html>