feat(epic): implement cashouts/topups/transfers

.github/workflows/conventional.yaml

@@ -1,7 +1,7 @@
 name: "Conventional commits"
 on:
   pull_request:
-    branches: [main]
+    branches: [main, feat/fygaro]
 jobs:
   conventional:
     name: "Conventional commits"
@@ -14,3 +14,6 @@ jobs:
         message: this PR needs to be updated to follow conventional commits message
         body: false
         issue: false
+        # Report on invalid PRs instead of closing them (avoids nuking
+        # long-lived PRs like the feat/fygaro umbrella #621).
+        close: false

.github/workflows/spelling.yml

@@ -1,7 +1,7 @@
 name: Spelling
 on:
   pull_request:
-    branches: [main]
+    branches: [main, feat/fygaro]
 
 jobs:
   spelling:

.storybook/views/story-screen.tsx

@@ -5,11 +5,14 @@ const PersistentStateWrapper: React.FC<React.PropsWithChildren> = ({ children })
   <PersistentStateContext.Provider
     value={{
       persistentState: {
-        schemaVersion: 6,
+        schemaVersion: 7,
         galoyInstance: {
           id: "Main",
         },
         galoyAuthToken: "",
+        hasInitializedBreezSDK: false,
+        unclaimedDeposits: 0,
+        closedQuickStartTypes: [],
       },
       updateState: () => {},
       resetState: () => {},

.typesafe-i18n.json

@@ -1,5 +1,5 @@
 {
    "adapter": "react",
-   "$schema": "https://unpkg.com/typesafe-i18n@5.26.2/schema/typesafe-i18n.json",
+   "$schema": "https://unpkg.com/typesafe-i18n@5.27.1/schema/typesafe-i18n.json",
    "outputPath": "./app/i18n"
 }

__mocks__/@breeztech/breez-sdk-spark-react-native.js

@@ -0,0 +1,46 @@
+const SdkEvent_Tags = {
+  PaymentPending: "PaymentPending",
+  PaymentSucceeded: "PaymentSucceeded",
+  PaymentFailed: "PaymentFailed",
+  Synced: "Synced",
+  Optimization: "Optimization",
+}
+
+const PaymentType = {
+  Send: "Send",
+  Receive: "Receive",
+}
+
+const PaymentStatus = {
+  Pending: "Pending",
+  Complete: "Complete",
+  Failed: "Failed",
+}
+
+class Bolt11Invoice {
+  constructor(args) {
+    Object.assign(this, args)
+  }
+}
+
+class BitcoinAddress {
+  constructor(args) {
+    Object.assign(this, args)
+  }
+}
+
+module.exports = {
+  __esModule: true,
+  BitcoinAddress,
+  Bolt11Invoice,
+  PaymentStatus,
+  PaymentType,
+  ReceivePaymentMethod: {
+    BitcoinAddress,
+    Bolt11Invoice,
+  },
+  SdkEvent_Tags,
+  connect: jest.fn(),
+  defaultConfig: jest.fn(),
+  disconnect: jest.fn(),
+}

__mocks__/@env.js

@@ -0,0 +1,12 @@
+module.exports = {
+  API_KEY: "test-api-key",
+  APP_CHECK_ANDROID_DEBUG_TOKEN: "test-android-app-check-token",
+  APP_CHECK_IOS_DEBUG_TOKEN: "test-ios-app-check-token",
+  BREEZ_LNURL_DOMAIN: "test.flashapp.me",
+  GOOGLE_PLACE_API_KEY: "test-google-place-api-key",
+  GREENLIGHT_PARTNER_CERT: "test-greenlight-partner-cert",
+  GREENLIGHT_PARTNER_KEY: "test-greenlight-partner-key",
+  INVITE_CODE: "test-invite-code",
+  MIGRATION_FEE_LNURL_W: "https://test.flashapp.me/lnurlw",
+  MNEMONIC_WORDS: "abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon about",
+}

__mocks__/@react-native-async-storage/async-storage.js

@@ -1 +1 @@
-export { AsyncStorageMock as default } from "@react-native-async-storage/async-storage/jest/async-storage-mock"
+module.exports = require("@react-native-async-storage/async-storage/jest/async-storage-mock")

__mocks__/@react-native-community/netinfo.js

@@ -0,0 +1 @@
+module.exports = require("@react-native-community/netinfo/jest/netinfo-mock")

__mocks__/breez-sdk.js

@@ -0,0 +1,4 @@
+module.exports = {
+  receiveOnchainBreez: jest.fn(() => Promise.resolve({ paymentRequest: "" })),
+  receivePaymentBreez: jest.fn(() => Promise.resolve({ paymentRequest: "" })),
+}

__mocks__/react-native-fs.js

@@ -0,0 +1,19 @@
+const RNFS = {
+  CachesDirectoryPath: "/tmp",
+  DocumentDirectoryPath: "/tmp",
+  DownloadDirectoryPath: "/tmp",
+  TemporaryDirectoryPath: "/tmp",
+  appendFile: jest.fn(() => Promise.resolve()),
+  copyFile: jest.fn(() => Promise.resolve()),
+  downloadFile: jest.fn(() => ({
+    jobId: 1,
+    promise: Promise.resolve({ statusCode: 200 }),
+  })),
+  exists: jest.fn(() => Promise.resolve(false)),
+  readFile: jest.fn(() => Promise.resolve("")),
+  unlink: jest.fn(() => Promise.resolve()),
+  writeFile: jest.fn(() => Promise.resolve()),
+}
+
+module.exports = RNFS
+module.exports.default = RNFS

__mocks__/react-native-google-places-autocomplete.js

@@ -0,0 +1,11 @@
+const React = require("react")
+const { View } = require("react-native")
+
+const GooglePlacesAutocomplete = React.forwardRef((props, ref) =>
+  React.createElement(View, { ...props, ref }),
+)
+
+module.exports = {
+  __esModule: true,
+  GooglePlacesAutocomplete,
+}

__mocks__/react-native-haptic-feedback.js

@@ -0,0 +1,7 @@
+const trigger = jest.fn()
+
+module.exports = {
+  __esModule: true,
+  default: { trigger },
+  trigger,
+}

__mocks__/react-native-image-picker.js

@@ -0,0 +1,23 @@
+const emptyResult = { assets: [], didCancel: true }
+
+const launchImageLibrary = jest.fn((_, callback) => {
+  if (typeof callback === "function") {
+    callback(emptyResult)
+  }
+
+  return Promise.resolve(emptyResult)
+})
+
+const launchCamera = jest.fn((_, callback) => {
+  if (typeof callback === "function") {
+    callback(emptyResult)
+  }
+
+  return Promise.resolve(emptyResult)
+})
+
+module.exports = {
+  __esModule: true,
+  launchCamera,
+  launchImageLibrary,
+}

__mocks__/react-native-keychain.js

@@ -0,0 +1,26 @@
+const credentialsByServer = new Map()
+
+const getServer = (serverOrOptions) =>
+  typeof serverOrOptions === "string" ? serverOrOptions : serverOrOptions?.server
+
+const getInternetCredentials = jest.fn((serverOrOptions) =>
+  Promise.resolve(credentialsByServer.get(getServer(serverOrOptions)) || false),
+)
+
+const setInternetCredentials = jest.fn((server, username, password) => {
+  credentialsByServer.set(server, { password, server, username })
+  return Promise.resolve(true)
+})
+
+const resetInternetCredentials = jest.fn((serverOrOptions) => {
+  credentialsByServer.delete(getServer(serverOrOptions))
+  return Promise.resolve(true)
+})
+
+module.exports = {
+  __esModule: true,
+  ACCESSIBLE: {},
+  getInternetCredentials,
+  resetInternetCredentials,
+  setInternetCredentials,
+}

__mocks__/react-native-nfc-manager.js

@@ -0,0 +1,21 @@
+const NfcManager = {
+  cancelTechnologyRequest: jest.fn(),
+  getTag: jest.fn(),
+  isEnabled: jest.fn(async () => false),
+  isSupported: jest.fn(async () => false),
+  requestTechnology: jest.fn(),
+  start: jest.fn(),
+}
+
+module.exports = {
+  __esModule: true,
+  default: NfcManager,
+  Ndef: {
+    text: {
+      decodePayload: jest.fn(() => ""),
+    },
+  },
+  NfcTech: {
+    Ndef: "Ndef",
+  },
+}

__mocks__/react-native-vision-camera.js

@@ -0,0 +1,19 @@
+const React = require("react")
+
+const requestPermission = jest.fn(() => Promise.resolve(true))
+
+const Camera = React.forwardRef((props, ref) =>
+  React.createElement("Camera", { ...props, ref }),
+)
+
+module.exports = {
+  __esModule: true,
+  Camera,
+  CameraRuntimeError: Error,
+  useCameraDevice: jest.fn(() => ({ id: "back" })),
+  useCameraPermission: jest.fn(() => ({
+    hasPermission: true,
+    requestPermission,
+  })),
+  useCodeScanner: jest.fn((config) => config),
+}

__mocks__/react-native-walkthrough-tooltip.js

@@ -0,0 +1,6 @@
+const React = require("react")
+
+const Tooltip = ({ children }) => React.createElement(React.Fragment, null, children)
+
+module.exports = Tooltip
+module.exports.default = Tooltip

__tests__/components/currency-tag.spec.tsx

@@ -0,0 +1,28 @@
+import * as React from "react"
+import { describe, expect, it } from "@jest/globals"
+import { render } from "@testing-library/react-native"
+import { ThemeProvider } from "@rneui/themed"
+
+import { CurrencyTag } from "@app/components/currency-tag"
+import { WalletCurrency } from "@app/graphql/generated"
+import { displayCurrencyCode } from "@app/utils/currency-display"
+import theme from "@app/rne-theme/theme"
+
+const renderCurrencyTag = (walletCurrency: WalletCurrency) =>
+  render(
+    <ThemeProvider theme={theme}>
+      <CurrencyTag walletCurrency={walletCurrency} />
+    </ThemeProvider>,
+  )
+
+describe("CurrencyTag", () => {
+  it.each([WalletCurrency.Btc, WalletCurrency.Usd, WalletCurrency.Usdt])(
+    "renders a %s tag",
+    (walletCurrency: WalletCurrency) => {
+      const { getByText } = renderCurrencyTag(walletCurrency)
+
+      // USDT displays as USD (stablecoin → fiat mapping)
+      expect(getByText(displayCurrencyCode(walletCurrency))).toBeTruthy()
+    },
+  )
+})

__tests__/config/galoy-instances.spec.ts

@@ -22,6 +22,7 @@ it("get a full object with Custom", () => {
     posUrl: "https://pay.custom.com/",
     lnAddressHostname: "custom.com",
     blockExplorer: "https://mempool.space/tx/",
+    relayUrl: "wss://relay.custom.com",
   } as const
 
   const res = resolveGaloyInstanceOrDefault(CustomInstance)

__tests__/hooks/use-display-currency.spec.tsx

@@ -5,7 +5,11 @@ import { MockedProvider } from "@apollo/client/testing"
 import { PropsWithChildren } from "react"
 import * as React from "react"
 import { IsAuthedContextProvider } from "@app/graphql/is-authed-context"
-import { CurrencyListDocument, RealtimePriceDocument } from "@app/graphql/generated"
+import {
+  CurrencyListDocument,
+  RealtimePriceDocument,
+  WalletCurrency,
+} from "@app/graphql/generated"
 
 const mocksNgn = [
   {
@@ -135,12 +139,32 @@ const wrapWithMocks =
 
 describe("usePriceConversion", () => {
   describe("testing moneyAmountToMajorUnitOrSats", () => {
+    it("formats USDT micros as major units", async () => {
+      const { result } = renderHook(useDisplayCurrency, {
+        wrapper: wrapWithMocks([]),
+      })
+
+      const moneyAmount = {
+        amount: 179_554,
+        currency: WalletCurrency.Usdt,
+        currencyCode: "USD",
+      }
+
+      expect(result.current.moneyAmountToMajorUnitOrSats(moneyAmount)).toBe(0.179554)
+      // USDT displays as USD (stablecoin → fiat display mapping)
+      expect(result.current.formatMoneyAmount({ moneyAmount })).toBe("$0.179554 USD")
+    })
+
     it("with 0 digits", async () => {
-      const { result, waitForNextUpdate } = renderHook(useDisplayCurrency, {
+      const { result, waitFor } = renderHook(useDisplayCurrency, {
         wrapper: wrapWithMocks(mocksJpy),
       })
 
-      await waitForNextUpdate()
+      await waitFor(
+        () =>
+          result.current.displayCurrency === "JPY" &&
+          result.current.fractionDigits === 0,
+      )
 
       const res = result.current.moneyAmountToMajorUnitOrSats({
         amount: 100,
@@ -230,4 +254,29 @@ describe("usePriceConversion", () => {
       displayCurrency: "NGN",
     })
   })
+
+  it("converts USDT micros to display currency using USD-cent price", async () => {
+    const { result, waitFor } = renderHook(useDisplayCurrency, {
+      wrapper: wrapWithMocks(mocksNgn),
+    })
+
+    await waitFor(
+      () => {
+        return result.current.displayCurrency === "NGN"
+      },
+      {
+        timeout: 4000,
+      },
+    )
+
+    const displayAmount = result.current.moneyAmountToDisplayCurrencyString({
+      moneyAmount: {
+        amount: 1_000_000,
+        currency: WalletCurrency.Usdt,
+        currencyCode: "USDT",
+      },
+    })
+
+    expect(displayAmount).toBe("₦100.00")
+  })
 })