Thanks, @jame
The tutorial and detail will available when we release the beta test version next week.
Isyyyy - WIC - Desktop Wallet
Cheers!
Progress update:
Hi all, we are ready to release the first version this week with basic features:
- Create and import wallet
- Add and import account
- Show balance and transaction history (send & receiver transactions)
- Create and send PRV or pToken
Here is the guide to run IncWallet on your PC.
Step 1: Install docker
Step 2: Create file run.sh
as follows:
#!/bin/sh bash
ps aux | grep '[r]un.sh' | awk '{ print $2}' | grep -v "^$$\$" | xargs kill -9
docker rm -f incwallet
docker network create --driver bridge incwallet_net || true
docker pull isyyyy/incwallet
docker run -ti --restart=always --net incwallet_net --name incwallet -d -p 9000:9000 isyyyy/incwallet
docker run --net incwallet_net --name mongo -d -p 27018:27017 mongo
shopt -s expand_aliases
alias wic='docker exec -it incwallet wic'
Step 3: Try with command wic
in your terminal. If you cannot see the welcome message. Try with this command:
alias wic='docker exec -it incwallet wic'
Step 4: Welcome to WIC
If you have any bugs, feedbacks or suggestions, please reply in this thread.
Thank you so much!
WIC Tutorial
Start with wic
you will see
__ __ .__ __ __ __.__
/ \ / \ ____ | | ____ ____ _____ ____ _/ |_ ____ / \ / \__| ____
\ \/\/ // __ \| | _/ ___\/ _ \ / \_/ __ \ \ __\/ _ \ \ \/\/ / |/ ___\
\ /\ ___/| |_\ \__( <_> ) Y Y \ ___/ | | ( <_> ) \ /| \ \___
\__/\ / \___ >____/\___ >____/|__|_| /\___ > |__| \____/ \__/\ / |__|\___ >
\/ \/ \/ \/ \/ \/ \/
Usage:
wic [command]
Available Commands:
account account commands for add, import, switch, and ls
balance show current balance
help Help about any command
tx tx commands for history, send, and receive
version current version
wallet wallet commands for import and create
Flags:
-h, --help help for wic
Use "wic [command] --help" for more information about a command.
List of commands
wallet
command
Usage:
wic wallet [command]
Available Commands:
create create a new wallet
import import wallet by seed phrase
Flags:
-h, --help help for wallet
Example:
Create a new wallet: wic wallet create -s 256 -n mainnet
- Create a new wallet with 256 bits security level (24 seed words) on
mainnet
. Note that you can create a wallet ontestnet
with-n testnet
. - Remember to set up a password to protect your wallet in the system.
Import a wallet from seed words: wic import -n mainnet -m "24 seed words"
Note:
- Remember to back up your seed words and password to recover the wallet in case you delete or remove
wic
- Multiple wallets is not supported in this version. That means you only can create a mainnet or testnet wallet.
account
command
After create or import a wallet. You can add or import accounts into the wallet.
Usage:
wic account [command]
Available Commands:
add add new account
export export private key & info
import import account by private key
info show wallet info
ls show all imported/added accounts
switch switch between accounts by name
Flags:
-h, --help help for account
Example:
-
Add account belonging wallet:
wic account add -n account_name
-
Import account from another wallet (e.g., web, mobile wallets):
wic account import -n account_name -k private_key
-
Switch account by name:
wic account switch -n account_name
-
List add accounts:
wic account ls
-
View account info:
wic account info
-
Export private key:
wic account export
Note:
- For all accounts generated by
add
command will be fully recovered if you know the seed words and password. That means you do not need to back up the private key fromexport
command. - Imported accounts do not belong to the wallet, remember to back up private keys for them.
tx
command
Usage:
wic tx [command]
Available Commands:
history Show send/receive transactions history
receive generate QR code to receive PRV or pToken
send create PRV/pToken transaction
Flags:
-h, --help help for tx
Example
- Show transaction history:
wic tx history
- Create and send PRV:
wic tx send -r receiver_address -a amount
- Create and send pToken:
wic tx send -r receiver_address -a amount -t token_id
Note:
- Using flag
-t token_id
to filter by token ID inhistory
command. - The amount is in nano. For example
-a 1000000
that means send0.001
PRV. - You can change the transaction fee (default
5
) using flag-f
.
balance
command
Usage:
wic balance [flags]
wic balance [command]
Available Commands:
utxo show current unspent coins
Flags:
-h, --help help for balance
-t, --token string Add your token
Example
- Show balance:
wic balance
- Show balance with utxo:
wic balance utxo
Note:
- Using flag
-t token_id
to filter by token ID inbalance
command. - The balance is in nano. For example,
-a 1000000
that means you have0.001
PRV.
Hi @Isyyyy,
Thanks for this awesome tool!
You can create a docker compose file if you want to simplify deployment
Is there a reason to not publish the source code on a public repository? I started to read it by extracting it from the docker image but that’s not the easiest way.
As a paranoid, I always read wallet’s code before I start using it , because it’s about money.
Technical question: Why do you use a Mongo database and not a simpler database like SQLite, as your storage needs seems pretty simple?
Thank you again, i’ll daily use this wallet if my review is ok
Thanks for your comments @inccry.
You can create a docker compose file if you want to simplify deployment
- I appreciate it if you can help me to create it. I have a problem with deployment. Actually, I have a docker-compose file and it works well locally. But I don’t know how to deploy it.
Is there a reason to not publish the source code on a public repository?
- The source code will be published soon (this week).
Technical question: Why do you use a Mongo database and not a simpler database like SQLite, as your storage needs seems pretty simple?
- MongoDB is probably suitable for me now . Moreover, data structure is not stable and I need to change with high frequency
Update Progress:
Hi Incognito’s community,
Finally, we have the first GUI version for WIC. Although it is the local web app, we will port to the desktop app soon.
For the CLI, we have finished pDEX and Stake with the following features:
- pDEX:
– Transaction trade history
– Trade between PRV-pToken and vice versa
– Trade between pToken-pToken based on PRV - Stake:
– Node status (e.g., pending, candidate, validator)
– Node reward
– Withdraw reward
– Unstake reward
Community Vote: What is the preferred next feature for GUI:
- pDEX
- Stake
0 voters
Thank you for your vote!!!
Here are some screenshots.
Impressive, even if it is only local yet. I like the clean layout.
Hi Incognito’s community,
The first MVP version for the local web app is now ready. Please update the run.sh file as follows:
#!/bin/sh bash
ps aux | grep '[r]un.sh' | awk '{ print $2}' | grep -v "^$$\$" | xargs kill -9
docker rm -f incwallet
docker rm -f incwalletapp
docker network create --driver bridge incwallet_net || true
docker pull isyyyy/incwallet
docker pull isyyyy/incwalletapp
docker run -ti --restart=always --net incwallet_net --name incwallet -d -p 9000:9000 isyyyy/incwallet
docker run -ti --restart=always --net incwallet_net --name incwalletapp -d -p 80:80/tcp isyyyy/incwalletapp
docker run --net incwallet_net --name mongo -d -p 27018:27017 mongo
shopt -s expand_aliases
alias wic='docker exec -it incwallet wic'
Try with localhost
on any browser to start your new wallet.
We are working on pDex and Staking feature for the next release. We also start to implement the desktop app now.
Please let us know your feedback and comments to make it better.
Thank you so much
Hey @Isyyyy, according to the community reaction on your proposal, a desktop wallet is definitely a useful product for the community and ecosystem.
Really cool idea to let the community vote for the upcoming feature If you don’t mind, have two questions:
-
Would be awesome if you guys could also share a longer road map for product development. How do you see your product in the upcoming months?
-
Majority of user are not technically at all and they might find quite difficult to install WIC thought docker, and use commands for operating it. Do you guys plan to pack it into .dmg & .exe files?
@Isyyyy: Really nice work. Can you maybe share your progress on the hardware wallet support? Is there any work being done already? If not, I could work on the Ledger app side of a HW wallet, which could integrate with your wallet then.
Hey @sayne, currently we did not start to implement the integration with any hardware wallet yet.
I could work on the Ledger app side of a HW wallet, which could integrate with your wallet then.
Sure, it is really cool for Incognito, we will have HW wallet soon.
Hey @andrey,
We also realize the problem for the docker version last month . So, we are working on the desktop version for WIC. That means we will have the execution file like *.dmg or *.exe for non-tech users.
About the road map, we will update the detail soon. Roughly, we will try to bring as much as features from the Incognito mobile app to WIC.
This is exciting news, I would love to use the CLI for automating some transactions. Is there going to be an EXE version of the CLI for windows machines.
Awesome, is there a git repo available or something similar? I could integrate the Ledger support right into that product. I would want to strictly focus on the Ledger side and avoid writing an entire wallet integration on the computer side from scratch.
Hi @sayne, we are porting from the web app to desktop app for WIC, the basic features will available in the first release next week. We will publish the source code next Tuesday.
Btw, you can check the source code of web app in the docker image. You can check it here
Hi Incognito’s community,
Here is the progress update for WIC:
- The project is now open-source here: https://github.com/IncWallet
- Due to some issues when porting from web app to desktop app, the source code for the desktop version will be published in the next few days when we release the first version. Now you can use the web app from docker or build from source code.
Accordingly the request about roadmap from @andrey, we provide the plan for WIC here:
- November: Release Desktop version with all basic features such as history, send/receive prv and pToken, miner, and pDex.
- December: Release Desktop version with shield/unshield, add liquidity, provide features (need to collaborate with core team).
- 2021: Integrate with a hardware wallet.
Hey @Isyyyy, it’s been a while that haven’t heard anything new from you. How is the desktop version for WIC? Any progress update?