Ğ1nkgo

Ğ1nkgo (aka Ginkgo) is a lightweight Ğ1 wallet for Duniter v1 written in Flutter. The app allows users to manage their Ğ1 currency on their mobile device using just a browser.

Features

• Introduction for beginners
• Generation of Cesium wallet and persistence (if you refresh the page, it should display the same wallet address).
• A point-of-sale device that generates a QR code for the public address and other QR codes with amounts (which lightweight wallets will understand).
• Send Ğ1 transactions
• Transactions history page and Balance with persistence to load last transactions on boot
• Contact management and cache (to avoid too much API petitions)
• Internationalization (i18n)
• QR code reader
• Import/export of your wallet
• Automatic discover and selection of nodes, error recovery & retry
• Customizable via env file
• Inline tutorials
• Pagination of transactions
• Some contextual help (for example, by tapping on "Validity").

Demo

This is a demo used for testing a development, please use a production server for stability:

https://g1demo.comunes.net/

Ğ1nkgo in production

• https://g1nkgo.comunes.org
• (...)

Translations

First of all, you can contribute translating Ğ1nkgo to your language:

https://weblate.duniter.org/projects/g1nkgo/g1nkgo/

Docker

mkdir -p ~/.ginkgo/nginx-conf mkdir -p ~/.ginkgo/www

Dev contributions

Prerequisites

This repository requires Flutter to be installed and present in your development environment.

Clone the project and enter the project folder.

git clone https://git.duniter.org/vjrj/ginkgo.git
cd ginkgo

Get the dependencies.

flutter pub get

Build & deploy

Launch all the tests

flutter test

Build for web (release version)

flutter build web --release --no-tree-shake-icons

Build and deploy to your server

rsync --progress=info2 --delete -aH build/web/ youruser@yourserver:/var/www/ginkgo/

Run dev environment

Run the app via command line or through your development environment.

flutter run

In order to do gva operations, you should disable cors in the flutter run config:

--web-browser-flag "--disable-web-security"

Pub packages used

This repository makes use of the following pub packages:

Easy Localization

To add translations, add it to assets/translations and enable it in main.dart. Also go to ios/Runner/Info.plist and update the following code:

<key>CFBundleLocalizations</key>
<array>
  <string>en</string>
  <string>es</string>
  <string>fr</string>
  <string>ca</string>
</array>

``

Screenshots

Wallet	Terminal card

Credits

Translations

• ast: dixebral
• ca: calbasi
• de: FW
• eu: Anna Ayala Alcalá
• fr: vincentux, poka, Hugo and Maaltir
• gl: Vijitâtman
• it: Anna Ayala Alcalá
• nl: Maria Rosa Costa i Alandi
• pt: Carlos Neto

Thanks!

Others

• Ğ1 logos from duniter.org
• undraw intro images: https://undraw.co/license
• Chipcard https://commons.wikimedia.org/wiki/File:Chipcard.svg under the Creative Commons Attribution-Share Alike 3.0 Unported license.
• POS svg from wikimedia CC-BY-SA 4.0

Thanks!

License

GNU AGPL v3 (see LICENSE)