/socialchain

Decentralized full stack social media (Final thesis project) using clean architecture. [Solidity, Hardhat, NextJS, C#, JWT]

Primary LanguageJavaScript

SocialChain - A Decentralized Social Network

SocialChain is a decentralized social media platform, that uses the power of blockchain to eliminate the idea of central authority, and the fact that a central authority owns the users' data.

Table of content

1. Project's description

The project utilize the blockchain technology to build the platform in a decentralized manner. Specifically the core of the application uses the power of smart contracts. The main aim of this project is to show how blockchain technology ensure that users owns their data, and that no one can control their data. Below I will explain for you the architecture of the application, used technologies, what makes this project unique.

1.1 Architecture of the application

The application uses the clean architecture where the client-side, business logic, infrastructure, is separated from each other providing scalable application in a clean form. The whole idea of using clean architecture is that client side and infrastructure can be used in any different technology.


The application contains mainly 3 sides that results in a full stack application:

  • Back-end: ASP.NET core API and MS SQL Database.
    • Purpose: Used for generating JWT (refresh access token) for users to authenticate them to the front-end and API end points.
  • Front-end: Is the user interface using NextJS.
  • Web3: Is where the smart contract and communicating with blockchain is done.

The application contains the following layers:

  • socialchain.api => ASP.NET core API that communicates with the MS SQL Server database
  • socialchain.application => Business logic of the C# (back-end)
  • socialchain.client => The front-end of the application (NextJS)
  • socialchain.contracts => The data transfer object between the API and the front-end
  • socialchain.domain => The main entities of the back-end (e.g User)
  • socialchain.infrastructure => The database configurations, communication with database
  • socialchain.web3 => The blockchain layer, where the smart contract sit and hardhat configuration

1.2 Application's technologies

  • Front-end techs: (NextJS, TailwindCSS, AntDesign, Ethers.js)
  • Back-end techs: (C#, ASP.NET Core API, EntityFrameWork Core, Nethereum library)
  • Web3 techs: (HardHat, Solidity, IPFS distrusted file storage)
  • Database: (MS SQL Server)

1.3 Application authentication and authorization

1.3.1 Generation of the JWT token

The application uses JWT (refresh,access) tokens as a way to authenticate users to the application. The token are stored as HTTP only cookies, to prevent client-side attackers from getting the cookies. The cookies are generated for the user after he signs a message through the digital wallet and prove in the back-end that the message actually signed by the same user, then he is allowed to obtain a token.

1.3.2 Application route protection

The routes of the front-end application are protected using the NextJS middleware, where each request made in the client side the JWT validation runs, if JWT token is not valid users will be forwarded to login page.

2 How to run the application

To run the application I will describe the process step by step:

2.1 Required SDKs and libraries

The following are required to run the application without problems:

2.2 Steps to run the application

  1. Clone the repository from the main branch.
  2. Assuming you have Visual studio installed.
  3. Open "socialchain.solution.sln"
  4. Right click on "socialchain.api" and click "Manage user secrets".
    1. Put your own local ms sql server db connection string.
    2. put random secret for JWT.
    3. Put 60 minutes as expire time of JWT token.
  5. In visual studio click on "View" in the top task bar => "Terminal"
    1. Run the following command in the terminal to create migration (code first approach): dotnet ef migrations add "1stSocialChainMigration" -p .\socialchain.infrastructure\ -s .\socialchain.api\
    2. From the terminal navigate to "socialchain.api" cd .\socialchain.api\
    3. Run the following command to update your database (make sure you are in the api project as step before): dotnet ef database update
  6. Run the visual studio application (To make the api running).

Note: Make sure to grab the address of the API that is running and put it in socialchain.client/constants/api/SocialChainApiConstants.js

  1. Open Visual studio code and navigate to folder "socialchain.api" and run the following (to install all npm packages): npm i
  2. In the root of "socialchain.api" create a file with the name ".env.local" and insert the following with your own values: NEXT_PUBLIC_JWT_SECRET_KEY= {secret key you used in the C# part, it should be the same} NEXT_PUBLIC_IPFS_PROJECT_ID={API key from IPFS} NEXT_PUBLIC_IPFS_API_KEY={API KEY Secret from IPFS}
  3. Run Ganache GUI application and then in vs code Navigate to "socialchain.web3" cd .\socialchain.web3\
    1. run npm i
    2. run in terminal the following to deploy the contract to your Ganache local blockchain: npx hardhat run --network localGanache scripts/deploy.js
    3. Grab the deployed contract address and put it inside the file socialchain.client/constants/blockchain/SocialChainContractConstants.js
  4. Finally forward to "socialchain.client" and run the following: npm run dev ENJOY THE APP :)

3 Application's screen shots

  • Index page:

  • Login/Register page:

  • User profile page:

  • Feed page: