This is the backend application for a lightweight Ethereum wallet. The backend for this application is written in Node.js, and utilizes the serverless framework for AWS Lambda. Authentication is handled via Auth0.
The front-end companion project can be found here: Serverless Ethereum Wallet Frontend
This is both a WIP, and a proof of concept, and is very limited in functionality. As such, it should only be used with the Ethereum testnet.
- To run this application you must have an AWS account and be familiar with deploying serverless applications.
- You must have an Auth0 account.
- You must either be running an Ethereum node, or use a service such as Infura
- Install npm dependencies:
npm install
- Install DynamoDB locally
sls dynamodb install
-
You must create and populate a
secrets.ymlfile. Reference theenvironment.ymlfile to see which items are required. -
The default configuration assumes you are using Infura. If you are using your own node, you will need to swap the
HttpProviderURL in theobjects/Wallet.jsfile. -
To run the app locally:
npm start
If you are running npm install on OSX or Windows, you may need to rebuild the node_modules folder from within a Docker container running Linux before this app will work on AWS Lambda. An explanation of this workaround can be found here.
If this is the case, simply run the following commands:
- Build the container
docker build -t eth .
- Run the container. This will open up the terminal within the container:
docker run -v $(pwd):/eth -it eth:latest
- Run the commands manually from the
./bin/dockerCommands.shfile:
source /root/.nvm/nvm.sh
nvm use 6.10
cd eth && npm rebuild
- This should update your node_modules folder with the proper modules compiled for linux. You can now run
npm run deployto deploy to AWS.
All authentication is handled via Auth0. You will need to obtain an access token (JWT) to submit requests to the API.
The following endpoints are current available:
-
Wallets
- /wallet/create
- /wallet/balance
-
Users
- /user/get