Both Altme and Talao Wallets's code isnow in the following repository : https://github.com/TalaoDAO/AltMe
Especially, Talao code is in Talao branch: https://github.com/TalaoDAO/AltMe/tree/TALAO
ALTME
β THE UNIVERSAL WALLET THAT WORKS FOR YOU
The Web 3 revolution is all about redistributing the power to the average consumer.
This is why we are building Altme, to help you get control over your data back.
This project contains 3 flavors:
To run the desired flavor either use the launch configuration in VSCode/Android Studio or use the following commands:
# Development
$ flutter run --flavor development --target lib/main_development.dart
# Staging
$ flutter run --flavor staging --target lib/main_staging.dart
# Production
$ flutter run --flavor production --target lib/main_production.dart
*Talao works on iOS and Android.
To manually build Altme for either Android or iOS, you will need to install the following dependencies:
dev
channel)It is recommended to use rustup to manage your Rust installation.
On Ubuntu you could run:
$ apt update
$ apt install openjdk-8-jdk
For more information, please refer to the documentation of your favorite flavour of Java and your operating system/package manager.
Please follow the official instalation instructions available here to install Flutter, don't forget to also install the build dependencies for the platform you will be building (Android SDK/NDK, Xcode, etc).
We currently only support build this project using the dev
channel of Flutter.
To change your installation to the dev
channel, please execute the following command:
$ flutter channel dev
$ flutter upgrade
To confirm that everything is setup correctly, please run the following command and resolve any issues that arise before proceeding to the next steps.
$ flutter doctor
This project also depends on two other Spruce
projects,
DIDKit
and
SSI
.
These projects are all configured to work with relative paths by default,
so it is recommended to clone them all under the same root directory, for
example $HOME/$FOLDER_NAME/{didkit,ssi,altme}
.
This is a flutter Plugin for PolygonID Mobile SDK (https://polygon.technology/polygon-id) This plugin provides a cross-platform tool (iOS, Android) to communicate with the PolygonID platform.
To build Altme for Android, you will require both the Android SDK and NDK.
These two dependencies can be easily obtained with Android Studio, which install further dependencies upon first being opened after installation. Installing the appropriate Android NDK (often not the newest) in Android Studio can be accomplished by going to Settings > Appearance & Behavior > System Settings > Android SDK and selecting to install the "NDK (Side by Side)".
An alternative method of installing SDK and NDK without Android Studio can be found in the script below:
cd $HOME
wget https://dl.google.com/android/repository/sdk-tools-linux-4333796.zip
unzip sdk-tools-linux-4333796.zip -d Android
rm sdk-tools-linux-4333796.zip
wget https://dl.google.com/android/repository/commandlinetools-linux-6200805_latest.zip
unzip commandlinetools-linux-6200805_latest.zip -d Android/cmdline-tools
rm commandlinetools-linux-6200805_latest.zip
echo 'export ANDROID_SDK_ROOT=$HOME/Android' >> $HOME/.bashrc
echo 'export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64' >> $HOME/.bashrc
echo 'export PATH=$ANDROID_SDK_ROOT/cmdline-tools/tools/bin:"$PATH"' >> $HOME/.bashrc
echo 'export PATH=$ANDROID_SDK_ROOT/cmdline-tools/tools/lib:"$PATH"' >> $HOME/.bashrc
echo 'export PATH=$ANDROID_SDK_ROOT/tools:"$PATH"' >> $HOME/.bashrc
echo 'export PATH=$JAVA_HOME/bin:"$PATH"' >> $HOME/.bashrc
. $HOME/.bashrc
sdkmanager --sdk_root=$ANDROID_SDK_ROOT --install "system-images;android-29;google_apis;x86" "system-images;android-29;google_apis;x86_64" "platform-tools" "platforms;android-29" "build-tools;29.0.3" "ndk;22.0.7026061" "cmdline-tools;latest"
sdkmanager --licenses
If your Android SDK doesn't live at $HOME/Android/Sdk
you will need to set
ANDROID_SDK_ROOT
like so:
$ export ANDROID_SDK_ROOT=/path/to/Android/Sdk
Note: Some users have experienced difficulties with cross-compilation artefacts missing from the newest NDK, which is downloaded by default in the installation process. If you experience errors of this kind, you may have to manually downgrade or install multiple NDK versions as [shown here])(img/ndk_downgrade.png) in the Android Studio installer (screengrabbed from an Ubuntu installation).
If your build-tools
and/or NDK
live in different locations than the default ones inside /SDK/, or if you want to specify a specific NDK or build-tools version, you can manually configure the following two environment variables:
$ export ANDROID_TOOLS=/path/to/SDK/build-tools/XX.X.X/
$ export ANDROID_NDK_HOME=/path/to/SDK/ndk/XX.X.XXXXX/
:::
To build Altme for iOS you will need to install CocoaPods, which can be done with Homebrew on MacOS.
$ brew install cocoapods
To build DIDKit
for the Android targets, you will go to the root of DIDKit
and run:
$ make -C lib install-rustup-android
$ make -C lib ../target/test/java.stamp
$ make -C lib ../target/test/android.stamp
$ make -C lib ../target/test/flutter.stamp
$ cargo build
This may take some time as it compiles the entire project for multiple targets
To build DIDKit for the iOS targets, you will go to the root of DIDKit
and run:
$ make -C lib install-rustup-ios
$ make -C lib ../target/test/ios.stamp
$ cargo build
NETWORK_NAME - Blockchain name.
NETWORK_ENV - Network name.
INFURA_URL - Infura base url.
INFURA_RDP_URL - Infura base rdp url.
INFURA_API_KEY - Infura api key.
ID_STATE_CONTRACT_ADDR - Identity state smart contract address.
PUSH_URL - Polygon push gateway server base url.
.env
and .env.dev
files in the root folder of the project.NETWORK_NAME="polygon"
NETWORK_ENV="mumbai"
INFURA_URL="https://polygon-mumbai.infura.io/v3/"
INFURA_RDP_URL="wss://polygon-mumbai.infura.io/v3/"
INFURA_API_KEY="secret"
ID_STATE_CONTRACT_ADDR="sc_address"
PUSH_URL="push_url"
build_runner
to generate .g.dart
files:flutter pub run build_runner build --delete-conflicting-outputs
Using iOS simulator for testing wallet sdk is right now under maintenance and will be available soon.
In order to handle installation of didkit, ssi, polygonid-flutter-sdk and altme, we can run shortcut script. We can also get the warnings if we have not configured the required things for building Altme.
For consistent app builts we can use fvm
.
You have to add the install_altme.sh
in the directory $HOME/$FOLDER_NAME/
. Then run the following command to
do the setup:
# Android
$ ./install_altme.sh -android
# iOS
$ ./install_altme.sh -ios
In order to generate all *.g.dart files, run the following command:
$ flutter packages pub run build_runner build --delete-conflicting-outputs
For smooth running of the functionalities of Altme, you need to add the following keys:
PASSBASE_WEBHOOK_AUTH_TOKEN
You can get this key from here
.
PASSBASE_CHECK_DID_AUTH_TOKEN
The key is available here
.
YOTI_AI_API_KEY
This key can be obtained from here
.
TALAO_ISSUER_API_KEY
The key is available here
.
INFURA_API_KEY
This key can be obtained from here
.
MORALIS_API_KEY
You can get this key from here
.
Please check the [Setting Up PolygonID Flutter SDK] section for key-dependencies of polygonid-flutter-sdk.
You are now ready to build or run Altme.
If you want to run the project on your connected device, you can use:
# Development
$ flutter run --flavor development --target lib/main_development.dart
# Staging
$ flutter run --flavor staging --target lib/main_staging.dart
# Production
$ flutter run --flavor production --target lib/main_production.dart
# Development
$ flutter build apk --release --split-per-abi --flavor development -t lib/main_development.dart
# Staging
$ flutter build apk --release --split-per-abi --flavor staging -t lib/main_staging.dart
# Production
$ flutter build apk --release --split-per-abi --flavor production -t lib/main_production.dart
# Development
$ flutter build appbundle --flavor "development" --target "lib/main_development.dart"
# Staging
$ flutter build appbundle --flavor "staging" --target "lib/main_staging.dart"
# Production
$ flutter build appbundle --flavor "production" --target "lib/main_production.dart"
# Development
$ flutter build ios --simulator --flavor "development" --target "lib/main_development.dart"
# Staging
$ flutter build ios --simulator --flavor "staging" --target "lib/main_staging.dart"
# Production
$ flutter build ios --simulator --flavor "production" --target "lib/main_production.dart"
# Development
$ flutter build ios --no-codesign --flavor "development" --target "lib/main_development.dart"
# Staging
$ flutter build ios --no-codesign --flavor "staging" --target "lib/main_staging.dart"
# Production
$ flutter build ios --no-codesign --flavor "production" --target "lib/main_production.dart"
# Development
$ flutter build ipa --flavor "development" --target "lib/main_development.dart"
# Staging
$ flutter build ipa --flavor "staging" --target "lib/main_staging.dart"
# Production
$ flutter build ipa --flavor "production" --target "lib/main_production.dart"
If you have setup the fastlane
for continuous delivery, then you can run the following command to publish:
$ flutter pub get
$ flutter packages pub run build_runner build --delete-conflicting-outputs
$ flutter build ios --release --flavor "production" --target "lib/main_production.dart"
$ $cd ios
$ fastlane beta
If you encounter any errors in the build process described here, please first try clean builds of the projects listed.
For instance, on Flutter, you can delete build files to start over by running:
$ flutter clean
Also, reviewing the
install_altme.sh
script may be helpful.
All QRCode interactions start as listed below:
Then, depending on the type of message, one of the following protocols will be executed.
After receiving a CredentialOffer
from a trusted host, the app calls the API
with subject_id
in the form body, that value is the didKey obtained from the
private key stored in the FlutterSecureStorage
, which is backed by KeyStore
on Android and Keychain on iOS.
The flow of events and actions is listed below:
didKey
from the stored private key using DIDKit.keyToDIDKey
;didKey
;And below is another version of the step-by-step:
Wallet | 1 | Server | |
---|---|---|---|
Scan QRCode 2 | |||
Trust Host | β / Γ | ||
HTTP GET | β | https://domain.tld/endpoint | |
β | CredentialOffer | ||
Preview Credential | |||
Choose DID | β / Γ | ||
HTTP POST 3 | β | https://domain.tld/endpoint | |
β | VerifiableCredential | ||
Verify Credential | |||
Store Credential |
1 Whether this action requires user confirmation, exiting the flow
early when the user denies.
2 The QRCode should contain the HTTP endpoint where the requests
will be made.
_3 The body of the request contains a field subject_id
set to the
chosen DID._
After receiving a VerifiablePresentationRequest
from a trusted host, the app
calls the API with presentation
the form body, that value is a JSON encoded
string with the presentation obtained from the selected credential and signed
with the credential's private key using DIDKit.issuePresentation
.
Here are some of the parameters used to generate a presentation:
presentation
id
is set to a random UUID.v4
string;holder
is set to the selected credential's didKey
;verifiableCredential
is set to the credential value;options
verificationMethod
is set to the DID's verificationMethod
id
;proofPurpose
is set to 'authentication'
;challenge
is set to the request's `challenge';domain
is set to the request's `domain';key
is the credential's stored private key;The flow of events and actions is listed below:
didKey
from the stored private key using DIDKit.keyToDIDKey
;DIDKit.issuePresentation
;And below is another version of the step-by-step:
Wallet | 1 | Server | |
---|---|---|---|
Scan QRCode 2 | |||
Trust Host | β / Γ | ||
HTTP GET | β | https://domain.tld/endpoint | |
β | VerifiablePresentationRequest | ||
Preview Presentation | |||
Choose Verifiable Credential | β / Γ | ||
HTTP POST 3 | β | https://domain.tld/endpoint | |
β | Result |
To run all unit and widget tests use the following command:
$ flutter test --coverage --test-randomize-ordering-seed random
To view the generated coverage report you can use lcov.
# Generate Coverage Report
$ genhtml coverage/lcov.info -o coverage/
# Open Coverage Report
$ open coverage/index.html
This project relies on flutter_localizations and follows the official internationalization guide for Flutter.
app_en.arb
file at lib/l10n/arb/app_en.arb
.{
"@@locale": "en",
"counterAppBarTitle": "Counter",
"@counterAppBarTitle": {
"description": "Text shown in the AppBar of the Counter Page"
}
}
{
"@@locale": "en",
"counterAppBarTitle": "Counter",
"@counterAppBarTitle": {
"description": "Text shown in the AppBar of the Counter Page"
},
"helloWorld": "Hello World",
"@helloWorld": {
"description": "Hello World Text"
}
}
import 'package:altme/l10n/l10n.dart';
@override
Widget build(BuildContext context) {
final l10n = context.l10n;
return Text(l10n.helloWorld);
}
Update the CFBundleLocalizations
array in the Info.plist
at ios/Runner/Info.plist
to include the new locale.
...
<key>CFBundleLocalizations</key>
<array>
<string>en</string>
<string>es</string>
</array>
...
lib/l10n/arb
.βββ l10n
β βββ arb
β β βββ app_en.arb
β β βββ app_es.arb
.arb
file:app_en.arb
{
"@@locale": "en",
"counterAppBarTitle": "Counter",
"@counterAppBarTitle": {
"description": "Text shown in the AppBar of the Counter Page"
}
}
app_es.arb
{
"@@locale": "es",
"counterAppBarTitle": "Contador",
"@counterAppBarTitle": {
"description": "Texto mostrado en la AppBar de la pΓ‘gina del contador"
}
}
# generate .g.dart files
$ ./script.sh -build_runner
# build app for development
$ ./script.sh -rundev
# build app for stage
$ ./script.sh -runstage
# build app for production
$ ./script.sh -run
# add/update pod
$ ./script.sh -pod install
# build app bundle for ios
$ ./script.sh -build appbundle
# deploy ios app with fastlane setup
$ ./script.sh -deploy ios
#For permission
$ sudo chmod 777 script.sh