Farmworker Wallet OS

The Farmworker Wallet OS is a solution framework built to jumpstart the integration of digital trust technologies with the Mendix low-code application platform. The framework makes it easy for any Mendix app to interoperate with open-standard technologies like decentralized identifiers, DIDComm, and verifiable credentials.

Quick Start

• Clone this project
• Navigate to the project root from a command line Terminal e.g. cd ~/Workspaces/Github/farmworker-wallet-os
• Run ./install.sh
• Download Studio Pro 11.12.2
• Open fwos-demo-app.mpr from Studio Pro
• Run the project from Studio Pro by clicking Run / Run Locally
• Create a custom React Native application from Native Template ./resources/nativeTemplate
• Install and run the application on your mobile device
• Log in using user name, for example Alice or Bob

Run Native app

• cd ~/resources/native_template
• Install Node v24 nvm install 24
• Install npm dependencies
  • npm i --legacy-peer-deps
  • npm run configure

Android build configuration for Android Studio

• Install Android Studio Ladybug Feature Drop | 2024.2.2
• Edit android/app/build.gradle
  • Add JNA as follows

  dependencies {
      ...
      //Required by Credo-ts
      implementation 'net.java.dev.jna:jna:5.2.0'
      ...
  }
  

  • For smaller APK sizes, limit the buildTypes by editing android/app/build.gradle and add abiFilters as follows reference

  ...
   buildTypes {
      release {
          ...
          ndk {
              abiFilters "armeabi-v7a", "arm64-v8a"
          }
      }
      debug {
          ndk {
              abiFilters "armeabi-v7a", "arm64-v8a"
          }
      }
  }
  ...
  

iOS build configuration for Xcode

• Install Xcode 26.3
• Install iOS dependencies
• For iOS builds only, Credo-ts (v0.5.13) cd ~/resources/native_template ** npm install @mendix/react-native-sqlite-storage
• Install Pods

cd ios
pod install --repo-update

Contributing

See CONTRIBUTING.md.

Raising problems/issues

• We encourage everyone to use /issues in case of any problems.

Governance

The Project Charter for Farmworker Wallet OS can be found here: https://github.com/openwallet-foundation/technical-project-charters/blob/main/OpenWallet%20Foundation%20-%20Farmworker%20Wallet%20OS%20Charter%20(FINAL%2009.06.24).pdf