Installation

Deployment guide to run your own SPV Wallet

Step 1

Set up your own AWS account with sufficient credit or a valid payment method.

Step 2

Register a root domain name you would like to use for the wallet. This will be how counterparties address users of your wallet: [email protected] The domain will be used as a root domain, and the cloud formation template will create subdomains under it.

Registering a new domain - Amazon Route 53Amazon Route 53

Step 3

Pick the AWS region closest to your customer(s). To determine which region is closest to your current location you can use a service like Cloud Ping.

AWS Console

Step 4

Launch the software using one of the CloudFormation template links below for your chosen region.

Region	CloudFormation template link
AP	ap-south-1 ap-northeast-1 ap-northeast-2 ap-northeast-3 ap-southeast-1 ap-southeast-2
CA	ca-central-1
EU	eu-central-1 eu-west-1 eu-west-2 eu-west-3 eu-north-1
SA	sa-east-1
US	us-east-1 us-east-2 us-west-1 us-west-2

If you don't know which link to pick, just use us-east-1.

Step 5

Fill in the required template settings:

• Stack name - this name will be dispayed on the list of Cloud Formation stacks in the AWS console

• Domain name - type the domain nama that you registered at the step 2

• Hosted zone ID for domain - choose exactly the one that is matching the domain name above

Step 6

After submitting stack creation it will take up to 30 minutes to create all resources. You can check the status in the Resources tab.

AWS CLI

Prerequisite

Make sure you have AWS CLI installed and authenticated

Install AWS CLI

Authenticate AWS CLI

Step 4

Issue the following command and find hosted zone id for registered domain in the Step 2.

ℹ️Make sure to use the id without the prefix /hostedzone/

 aws route53 list-hosted-zones --query "HostedZones[*].[Id,Name]" --output text

Step 5

Replace variables described below with chosen options in the following command and run it to deploy the stack.

aws cloudformation create-stack \
--stack-name ${Stack_Name} \
--region ${AWS_Region} \
--parameters ParameterKey=domainName,ParameterValue=${Domain_Name} ParameterKey=hostedzoneId,ParameterValue=${Hosted_Zone_Id} \
--template-url https://spv-wallet-template.s3.amazonaws.com/spv-wallet/latest/EksStack.template.json --capabilities CAPABILITY_IAM

Where:

• ${Stack_Name} - this name will be used to refer the stack in any following command

• ${AWS_Region} - region you choose in the Step 3

• ${Domain_Name} - domain name you registered in the Step 2

• ${Hosted_Zone_Id} - hosted zone id found in Step 4

Step 6

After submitting stack creation it will take up to 30 minutes to create all resources. You can check the status by issuing the following command.

aws cloudformation describe-stacks --stack-name ${Stack_Name} --region ${AWS_Region}

These subdomains will be created for the application

• wallet.yourdomain.com

• admin.yourdomain.com

• api.yourdomain.com

• headers.yourdomain.com

What resources are created?

· VPC with CIDR 10.0.0.0/16

· EKS Cluster with a Single Node Group (2 x t3.small instances)

· Wildcard certificate in ACM for provided domain

· Route53 entries for Bux components

· Load Balancer Controller for EKS

· SPV Wallet Components:

o Web App & API

o SPV Wallet Server

o PostgreSQL Database

o Web Admin

o Block Headers Service