feat: adding card-service and point-of-sale

.eslintrc.yml

@@ -18,7 +18,7 @@ parserOptions:
 plugins:
   - '@typescript-eslint'
 rules:
-  '@typescript-eslint/no-unused-vars': ['warn', { argsIgnorePattern: '^_' }]
+  '@typescript-eslint/no-unused-vars': ['warn', { argsIgnorePattern: '^_', varsIgnorePattern: '^_' }]
 overrides:
   - files: ["*.js"]
     rules:

.github/workflows/node-build.yml

@@ -3,10 +3,10 @@ name: Node Build
 on:
   workflow_dispatch:
   schedule:
-    - cron:  '0 21 * * *'
+    - cron: "0 21 * * *"
   pull_request:
     branches:
-      - '**'
+      - "**"
   push:
     branches:
       - main
@@ -17,9 +17,9 @@ jobs:
     runs-on: ubuntu-latest
     timeout-minutes: 5
     steps:
-    - uses: actions/checkout@v4
-    - uses: ./.github/workflows/rafiki/env-setup
-    - run: pnpm checks
+      - uses: actions/checkout@v4
+      - uses: ./.github/workflows/rafiki/env-setup
+      - run: pnpm checks
 
   backend:
     runs-on: ubuntu-latest
@@ -84,6 +84,32 @@ jobs:
         run: |
           npx @stoplight/spectral-cli lint ./packages/token-introspection/src/openapi/specs/*.yaml
 
+  card-service:
+    runs-on: ubuntu-latest
+    needs: prerequisite
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ./.github/workflows/rafiki/env-setup
+      - run: pnpm --filter card-service test:ci
+      - run: pnpm --filter card-service build
+      - name: AsyncAPI extension
+        run: |
+          echo "{\"extends\":[\"spectral:oas\",\"spectral:asyncapi\"]}" >> .spectral.json
+      - name: Validate Open API specs
+        run: |
+          npx @stoplight/spectral-cli lint ./packages/card-service/src/openapi/specs/*.yaml
+
+  point-of-sale:
+    runs-on: ubuntu-latest
+    needs: prerequisite
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ./.github/workflows/rafiki/env-setup
+      - run: pnpm --filter point-of-sale build
+      - run: pnpm --filter point-of-sale test:ci
+
   mock-account-servicing-entity:
     runs-on: ubuntu-latest
     needs: prerequisite
@@ -127,20 +153,20 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        language: [ 'javascript' ]
+        language: ["javascript"]
         config:
-          - './.github/codeql/source.yml'
-          - './.github/codeql/tests.yml'
+          - "./.github/codeql/source.yml"
+          - "./.github/codeql/tests.yml"
     steps:
-     - uses: actions/checkout@v4
-     - uses: ./.github/workflows/rafiki/env-setup
-     - name: Initialize CodeQL
-       uses: github/codeql-action/init@v3
-       with:
-         languages: ${{ matrix.language }}
-         config-file: ${{ matrix.config }}
-     - name: Perform CodeQL Analysis
-       uses: github/codeql-action/analyze@v3
+      - uses: actions/checkout@v4
+      - uses: ./.github/workflows/rafiki/env-setup
+      - name: Initialize CodeQL
+        uses: github/codeql-action/init@v3
+        with:
+          languages: ${{ matrix.language }}
+          config-file: ${{ matrix.config }}
+      - name: Perform CodeQL Analysis
+        uses: github/codeql-action/analyze@v3
 
   integration-test:
     runs-on: ubuntu-22.04
@@ -160,8 +186,10 @@ jobs:
         run: |
           echo "127.0.0.1 cloud-nine-wallet-test-backend" | sudo tee -a /etc/hosts
           echo "127.0.0.1 cloud-nine-wallet-test-auth" | sudo tee -a /etc/hosts
+          echo "127.0.0.1 cloud-nine-wallet-test-card-service" | sudo tee -a /etc/hosts
           echo "127.0.0.1 happy-life-bank-test-backend" | sudo tee -a /etc/hosts
           echo "127.0.0.1 happy-life-bank-test-auth" | sudo tee -a /etc/hosts
+          echo "127.0.0.1 happy-life-bank-test-point-of-sale" | sudo tee -a /etc/hosts
       - name: Build dependencies
         run: pnpm --filter integration build:deps
 
@@ -188,9 +216,11 @@ jobs:
       - name: Setup hosts
         run: |
           echo "127.0.0.1 cloud-nine-wallet-test-backend" | sudo tee -a /etc/hosts
+          echo "127.0.0.1 cloud-nine-wallet-test-card-service" | sudo tee -a /etc/hosts
           echo "127.0.0.1 cloud-nine-wallet-test-auth" | sudo tee -a /etc/hosts
           echo "127.0.0.1 happy-life-bank-test-backend" | sudo tee -a /etc/hosts
           echo "127.0.0.1 happy-life-bank-test-auth" | sudo tee -a /etc/hosts
+          echo "127.0.0.1 happy-life-bank-test-point-of-sale" | sudo tee -a /etc/hosts
 
       - name: Build dependencies
         run: pnpm --filter performance build:deps
@@ -312,7 +342,19 @@ jobs:
   node-build:
     runs-on: ubuntu-latest
     timeout-minutes: 5
-    needs: [auth, backend, frontend, token-introspection, mock-account-servicing-entity, graphql, codeql-analyze, integration-test]
+    needs:
+      [
+        auth,
+        backend,
+        frontend,
+        token-introspection,
+        card-service,
+        point-of-sale,
+        mock-account-servicing-entity,
+        graphql,
+        codeql-analyze,
+        integration-test
+      ]
     steps:
       - uses: actions/checkout@v4
       - uses: ./.github/workflows/rafiki/env-setup
@@ -410,6 +452,8 @@ jobs:
           - auth
           - backend
           - frontend
+          - card-service
+          - point-of-sale
     steps:
       - name: Checkout code
         uses: actions/checkout@v4
@@ -447,6 +491,8 @@ jobs:
           - auth
           - backend
           - frontend
+          - card-service
+          - point-of-sale
     steps:
       - uses: actions/checkout@v4
       - name: Fetch docker image from cache
@@ -483,6 +529,8 @@ jobs:
           - auth
           - backend
           - frontend
+          - card-service
+          - point-of-sale
     steps:
       - uses: actions/checkout@v4
       - name: Fetch docker image from cache
@@ -515,6 +563,8 @@ jobs:
           - auth
           - backend
           - frontend
+          - card-service
+          - point-of-sale
     steps:
       - uses: actions/checkout@v4
       - uses: ./.github/actions/image-push
@@ -527,7 +577,7 @@ jobs:
 
   push-manifest:
     name: Push multi-arch manifest list
-    needs: [version-generator,push]
+    needs: [version-generator, push]
     runs-on: ubuntu-latest
     if: needs.version-generator.outputs.dockerPush == 'true'
     strategy:
@@ -536,6 +586,8 @@ jobs:
           - auth
           - backend
           - frontend
+          - card-service
+          - point-of-sale
     steps:
       - uses: actions/checkout@v4
       - name: Push manifest list

bruno/collections/Rafiki/POS Service APIs/Get Incoming Payments.bru

@@ -0,0 +1,15 @@
+meta {
+  name: Get Incoming Payments
+  type: http
+  seq: 4
+}
+
+get {
+  url: http://localhost:4008/payments?receiverWalletAddress=https://happy-life-bank-backend/accounts/pfry
+  body: none
+  auth: inherit
+}
+
+params:query {
+  receiverWalletAddress: https://happy-life-bank-backend/accounts/pfry
+}

bruno/collections/Rafiki/POS Service APIs/Initiate Payment.bru

@@ -0,0 +1,26 @@
+meta {
+  name: Initiate Payment
+  type: http
+  seq: 3
+}
+
+post {
+  url: http://localhost:4008/payment
+  body: json
+  auth: inherit
+}
+
+body:json {
+  {
+    "signature": "signature",
+    "payload": "payload",
+    "amount": {
+      "value": "1000",
+      "assetScale": 2,
+      "assetCode": "USD"
+    },
+    "senderWalletAddress": "https://cloud-nine-wallet-backend/accounts/gfranklin",
+    "receiverWalletAddress": "https://happy-life-bank-backend/accounts/pfry",
+    "timestamp": 1758105181325
+  }
+}

bruno/collections/Rafiki/POS Service APIs/folder.bru

@@ -0,0 +1,8 @@
+meta {
+  name: POS Service APIs
+  seq: 8
+}
+
+auth {
+  mode: inherit
+}

bruno/collections/Rafiki/Rafiki Admin APIs/Get Incoming Payments.bru

@@ -0,0 +1,46 @@
+meta {
+  name: Get Incoming Payments
+  type: graphql
+  seq: 60
+}
+
+post {
+  url: {{RafikiGraphqlHost}}/graphql
+  body: graphql
+  auth: none
+}
+
+body:graphql {
+  query IncomingPayments($filter: IncomingPaymentFilter) {
+    incomingPayments(filter: $filter) {
+      edges {
+        node {
+          id
+          walletAddressId
+          client
+          state
+          expiresAt
+          incomingAmount {
+              value
+              assetCode
+              assetScale
+          }
+          receivedAmount {
+              value
+              assetCode
+              assetScale
+          }
+          metadata
+          createdAt
+        }
+        cursor
+      }
+    }
+  }
+}
+
+script:pre-request {
+  const scripts = require('./scripts');
+
+  scripts.addApiSignatureHeader();
+}

localenv/cloud-nine-wallet/docker-compose.yml

@@ -1,5 +1,35 @@
 name: c9
 services:
+  cloud-nine-wallet-card-service:
+    hostname: cloud-nine-wallet-card-service
+    image: rafiki-card-service
+    build:
+      context: ../..
+      dockerfile: ./packages/card-service/Dockerfile.dev
+    restart: always
+    networks:
+      - rafiki
+    ports:
+      - '9234:9229'
+    environment:
+      NODE_ENV: ${NODE_ENV:-development}
+      INSTANCE_NAME: CLOUD-NINE
+      TRUST_PROXY: ${TRUST_PROXY}
+      LOG_LEVEL: debug
+      CARD_SERVICE_PORT: 3007
+      GRAPHQL_URL: http://cloud-nine-wallet-backend:3001/graphql
+      TENANT_ID: 438fa74a-fa7d-4317-9ced-dde32ece1787
+      TENANT_SECRET: iyIgCprjb9uL8wFckR+pLEkJWMB7FJhgkvqhTQR/964=
+      TENANT_SIGNATURE_VERSION: 1
+    depends_on:
+      - shared-database
+    healthcheck:
+      test: ["CMD", "wget", "--spider", "http://localhost:3007/healthz"]
+      start_period: 60s
+      start_interval: 5s
+      interval: 30s
+      retries: 1
+      timeout: 3s
   cloud-nine-mock-ase:
     hostname: cloud-nine-wallet
     image: rafiki-mock-ase
@@ -80,6 +110,8 @@ services:
       ENABLE_TELEMETRY: true
       KEY_ID: 7097F83B-CB84-469E-96C6-2141C72E22C0
       OPERATOR_TENANT_ID: 438fa74a-fa7d-4317-9ced-dde32ece1787
+      CARD_SERVICE_URL: 'http://cloud-nine-wallet-card-service:3007'
+      CARD_WEBHOOK_SERVICE_URL: 'http://cloud-nine-wallet-card-service:3007/webhook'
     depends_on:
       - shared-database
       - shared-redis

localenv/happy-life-bank/docker-compose.yml

@@ -1,5 +1,38 @@
 name: hl
 services:
+  happy-life-bank-point-of-sale: 
+    hostname: happy-life-bank-point-of-sale
+    image: rafiki-point-of-sale 
+    build: 
+      context: ../.. 
+      dockerfile: ./packages/point-of-sale/Dockerfile.dev 
+    restart: always 
+    networks: 
+      - rafiki 
+    ports: 
+      - '4008:4008' 
+      - '9233:9229'
+    environment: 
+      NODE_ENV: ${NODE_ENV:-development} 
+      INSTANCE_NAME: HAPPY-LIFE 
+      TRUST_PROXY: ${TRUST_PROXY} 
+      LOG_LEVEL: debug 
+      PORT: 4008 
+      TENANT_ID: cf5fd7d3-1eb1-4041-8e43-ba45747e9e5d
+      TENANT_SECRET: iyIgCprjb9uL8wFckR+pLEkJWMB7FJhgkvqhTQR/964=
+      GRAPHQL_URL: http://happy-life-bank-backend:3001/graphql
+      WEBHOOK_SIGNATURE_SECRET: iyIgCprjb9uL8wFckR+pLEkJWMB7FJhgkvqhTQR/964=
+      WEBHOOK_SIGNATURE_VERSION: 1
+      USE_HTTP: true
+    depends_on: 
+      - shared-database
+    healthcheck: 
+      test: ["CMD", "wget", "--spider", "http://localhost:4008/healthz"] 
+      start_period: 60s 
+      start_interval: 5s 
+      interval: 30s 
+      retries: 1 
+      timeout: 3s 
   happy-life-mock-ase:
     hostname: happy-life-bank
     image: rafiki-mock-ase
@@ -67,6 +100,8 @@ services:
       ILP_ADDRESS: test.happy-life-bank
       ILP_CONNECTOR_URL: http://happy-life-bank-backend:4002
       STREAM_SECRET: BjPXtnd00G2mRQwP/8ZpwyZASOch5sUXT5o0iR5b5wU=
+      SIGNATURE_SECRET: iyIgCprjb9uL8wFckR+pLEkJWMB7FJhgkvqhTQR/964= # webhook signature
+      SIGNATURE_VERSION: 1
       ADMIN_API_SECRET: iyIgCprjb9uL8wFckR+pLEkJWMB7FJhgkvqhTQR/964=
       WEBHOOK_URL: http://happy-life-bank/webhooks
       EXCHANGE_RATES_URL: http://happy-life-bank/rates
@@ -76,6 +111,8 @@ services:
       ENABLE_TELEMETRY: true
       KEY_ID: 53f2d913-e98a-40b9-b270-372d0547f23d
       OPERATOR_TENANT_ID: cf5fd7d3-1eb1-4041-8e43-ba45747e9e5d
+      CARD_SERVICE_URL: 'http://happy-life-bank-card-service:4007'
+      POS_WEBHOOK_SERVICE_URL: 'http://happy-life-bank-point-of-sale:4008/webhook'
       WALLET_ADDRESS_NOT_FOUND_POLLING_ENABLED: true
     depends_on:
       - cloud-nine-backend