Demo Video Link: https://vimeo.com/420360884
Move-Near is an application powered by the NEAR Protocol that helps bring Financial and Social Inclusion. One of the major problems it solves is that of travel during this world-wide pandemic. With inputs from the local goverment I have created a system which allows everyone to travel with a Pass issued. This would stop useless travel and help prevent further spread of Coronoavirus. This systems signitficantly brings in transparency to the entire centralized system. Move-Near is also a platform where people can easily create DAOs and Campaigns for fundraising in just few clicks. People from all around the globe can contirbute towards it. There is also an option to get the DAO verified which increases the chance of more funding. However, it is not a must. The sytem is robust enough to support the Scheme and Stimulus Package distribution which will ease the work a lot.
With Move-Near we are bringing in Social and Financial inclusion in a decentralized way.
Shout out to the Amazing NEAR team for helping me in building this application. There are tons of things I have learnt and possible have some ideas for more contribution to the NEAR community.
Below are the steps to start the application.
To run this project locally:
- Prerequisites: Make sure you have node.js installed (we like asdf for
this), then use it to install yarn:
npm install --global yarn
(or justnpm i -g yarn
) - Install dependencies:
yarn install
(or justyarn
) - Run the local development server:
yarn dev
(seepackage.json
for a full list ofscripts
you can run withyarn
)
Now you'll have a local development environment backed by the NEAR TestNet! Running yarn dev
will tell you the URL you can visit in your browser to see the app.
- The backend code lives in the
/assembly
folder. This code gets deployed to the NEAR blockchain when you runyarn deploy:contract
. This sort of code-that-runs-on-a-blockchain is called a "smart contract" – learn more about NEAR smart contracts. - The frontend code lives in the
/src
folder. /src/index.html is a great place to start exploring. Note that it loads in/src/index.js
, where you can learn how the frontend connects to the NEAR blockchain. - Tests: there are different kinds of tests for the frontend and backend. The
backend code gets tested with the asp command for running the backend
AssemblyScript tests, and jest for running frontend tests. You can run
both of these at once with
yarn test
.
Both contract and client-side code will auto-reload as you change source files.
Every smart contract in NEAR has its own associated account. When you run yarn dev
, your smart contracts get deployed to the live NEAR TestNet with a throwaway account. When you're ready to make it permanent, here's how.
You need near-shell installed globally. Here's how:
npm install --global near-shell
This will give you the near
CLI tool. Ensure that it's installed with:
near --version
Visit NEAR Wallet and make a new account. You'll be deploying these smart contracts to this new account.
Now authorize NEAR shell for this new account, and follow the instructions it gives you:
near login
Modify the line in src/config.js
that sets the account name of the contract. Set it to the account id you used above.
const CONTRACT_NAME = process.env.CONTRACT_NAME || 'your-account-here!'
One command:
yarn deploy
As you can see in package.json
, this does two things:
- builds & deploys smart contracts to NEAR TestNet
- builds & deploys frontend code to GitHub using gh-pages. This will only work if the project already has a repository set up on GitHub. Feel free to modify the
deploy
script inpackage.json
to deploy elsewhere.