Open-source, decentralized and private password manager built on NEAR Protocol.
This project contains a smart contract for the Nearpass app built using Rust and create-near-app. If you are looking for the extension (frontend) for this dapp, visit nearpass-ext repo.
To deploy a new version of smart contract on NEAR testnet
:
- Prerequisites: Make sure you've installed Node.js ≥ 12.
- Install dependencies:
yarn
. - Deploy the smart contract to testnet using:
yarn dev:deploy
.
After it deploys the smart contract, keep the address of the deployment safe. You will need this when building the Nearpass Chrome Extension.
To explore what the smart-contract does go to /contract
folder and read up on the documentation inside.
Every smart contract in NEAR has its own associated account. When you run yarn dev:deploy
, your smart
contract gets deployed to the live NEAR TestNet with a throwaway account. When you're ready to make it permanent, here's
how.
near-cli is a command line interface (CLI) for interacting with the NEAR blockchain. It was installed to the
local node_modules
folder when you ran yarn install
, but for best ergonomics you may want to install it globally:
yarn install --global near-cli
Or, if you'd rather use the locally-installed version, you can prefix all near
commands with npx
Ensure that it's installed with near --version
(or npx near --version
)
Each account on NEAR can have at most one contract deployed to it. If you've already created an account such
as your-name.testnet
, you can deploy your contract to nearpass.your-name.testnet
. Assuming you've already created an
account on NEAR Wallet, here's how to create nearpass.your-name.testnet
:
-
Authorize NEAR CLI, following the commands it gives you:
near login
-
Create a subaccount (replace
YOUR-NAME
below with your actual account name):near create-account nearpass.YOUR-NAME.testnet --masterAccount YOUR-NAME.testnet
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 || 'nearpass.YOUR-NAME.testnet'
One command:
yarn deploy
As you can see in package.json
, this does two things:
- builds & deploys smart contract 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.
On Windows, if you're seeing an error containing EPERM
it may be related to spaces in your path. Please
see this issue for more details.