WAB (Wallet Authentication Backend)

1. Pull the container image from AWS Marketplace ECR

   • After subscribing, the image will be available in your region

2. Create a task definition

{ "family": "wab-task", "containerDefinitions": [{ "name": "wab", "image": "709825985650.dkr.ecr.us-east-1.amazonaws.com/bsv-blockchain/wab:1.0.0", "memory": 512, "cpu": 256, "essential": true, "portMappings": [{ "containerPort": 8080, "protocol": "tcp" }], "environment": [ {"name": "NODE_ENV", "value": "production"}, {"name": "PORT", "value": "8080"}, {"name": "DB_CLIENT", "value": "pg"}, {"name": "DB_HOST", "value": "your-rds-endpoint"}, {"name": "DB_USER", "value": "your-db-user"}, {"name": "DB_PASS", "value": "your-db-password"}, {"name": "DB_NAME", "value": "wab_database"}, {"name": "TWILIO_ACCOUNT_SID", "value": "ACxxxxxxxxxx"}, {"name": "TWILIO_AUTH_TOKEN", "value": "your-auth-token"}, {"name": "TWILIO_VERIFY_SERVICE_SID", "value": "VAxxxxxxxxxx"} ] }] }

3. Create an ECS service

aws ecs create-service \ --cluster your-cluster \ --service-name wab-service \ --task-definition wab-task \ --desired-count 1 \ --launch-type FARGATE

1. Create a Kubernetes deployment manifest

apiVersion: apps/v1 kind: Deployment metadata: name: wab-deployment spec: replicas: 2 selector: matchLabels: app: wab template: metadata: labels: app: wab spec: containers: - name: wab image: 709825985650.dkr.ecr.us-east-1.amazonaws.com/bsv-blockchain/wab:1.0.0 ports: - containerPort: 8080 env: - name: NODE_ENV value: "production" - name: DB_CLIENT value: "pg" - name: DB_HOST valueFrom: secretKeyRef: name: wab-secrets key: db-host # Add other environment variables

2. Apply the deployment

kubectl apply -f wab-deployment.yaml

Database Configuration:

• DB_CLIENT: Database type (pg, mysql, or sqlite3)
• DB_HOST: Database hostname
• DB_USER: Database username
• DB_PASS: Database password
• DB_NAME: Database name
• DB_PORT: Database port (optional, default: 5432 for pg, 3306 for mysql)

Twilio SMS Authentication (optional):

• TWILIO_ACCOUNT_SID: Your Twilio Account SID
• TWILIO_AUTH_TOKEN: Your Twilio Auth Token
• TWILIO_VERIFY_SERVICE_SID: Your Twilio Verify Service SID

Application Settings:

• NODE_ENV: Set to "production"
• PORT: Application port (default: 8080)

1. Run migrations after first deployment:

# Connect to container docker exec -it <container-id> /bin/sh # Run migrations npm run migrate

Test your deployment:

curl http://your-service-url:8080/info

Expected response: JSON with WAB configuration details

Complete documentation: https://github.com/bsv-blockchain/wab 

• Setup guide
• Authentication method configuration
• API reference
• Troubleshooting

For issues and questions, visit: https://github.com/bsv-blockchain/wab/issues