ishidad2/symbol-desktop-wallet

Desktop wallet for Symbol.

TypeScriptApache-2.0

Symbol Desktop Wallet

Cross-platform client for Symbol to manage accounts, mosaics, namespaces, and issue transactions.

Installation

Symbol Desktop Wallet is available for Mac, Windows, and as a web application.

Download Symbol Desktop Wallet from the releases section.
Launch the executable file and follow the installation instructions.
Create a profile. Remember to save the mnemonic somewhere safe (offline).

Building instructions

Symbol CLI require Node.js 16 LTS to execute.

Clone the project.

git clone https://github.com/symbol/desktop-wallet.git

Install the dependencies.

cd symbol-desktop-wallet
npm install

Start the development server.

npm run dev

Visit http://localhost:8080/#/ in your browser.

Release

For local use, build Symbol Wallet Electron app (only Electron version support Ledger wallets), default build for MacOS, Windows and Linux

# to skip code signing
export CSC_IDENTITY_AUTO_DISCOVERY=false

npm run release

Release for distribution: (Code signing for Apple builds - requires Developer ID Certificate)

2.1 On a MacOS machine, download the zip file containing the app signing certificates (ask team)

2.2 Extract the certificates and double click each one of them to add to the keychain (ask the team for private key password)

2.3 Starting with MacOS 10.14.5, all signed applications by new Developer ID Certificate will need to be notarized. This is an automated step in the process. You'll need to enable notarization by setting the following env vars.
```
 export DESKTOP_APP_NOTARIZE=true
 export DESKTOP_APP_APPLE_ID=VALID_APPLE_DEV_ID
 export DESKTOP_APP_APPLE_PASSWORD=VALID_APPLE_DEV_PASSWORD
 export DESKTOP_APP_APPLE_TEAM_ID=VALID_APPLE_TEAM_ID
 
```
2.4 Enable auto discovery for code signing process to pick up the certificates from the keychain
```
export CSC_IDENTITY_AUTO_DISCOVERY=true
```
2.5 Run release
```
npm run release
```
2.6 Validate if the app is signed with a Developer ID Certificate and notarized
```
spctl -a -t exec -v ./release/mac/Symbol\ Wallet.app
 # Output(Success): ./release/mac/Symbol Wallet.app: accepted source=Notarized Developer ID
 # Output(Failure): ./release/mac/Symbol Wallet.app: rejected source=Unnotarized Developer ID
 
```

Getting help

Use the following available resources to get help:

Symbol Documentation
Join the community discord group, slack group (#sig-client)
If you found a bug, open a new issue

Contributing

Contributions are welcome and appreciated. Check CONTRIBUTING for information on how to contribute.

License

(C) Symbol Contributors 2022

Licensed under the Apache License 2.0