{"id":13307147,"url":"https://github.com/Nathanwoodburn/FireWallet","last_synced_at":"2025-03-10T14:32:27.746Z","repository":{"id":172965922,"uuid":"650017203","full_name":"Nathanwoodburn/FireWallet","owner":"Nathanwoodburn","description":"The Handshake wallet that is Fire","archived":false,"fork":false,"pushed_at":"2024-07-17T08:23:20.000Z","size":1455,"stargazers_count":11,"open_issues_count":1,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-04T17:13:04.958Z","etag":null,"topics":["cryptocurrency","handshake","handshake-domains","handshake-protocol","hsd","wallet"],"latest_commit_sha":null,"homepage":"https://firewallet.au","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Nathanwoodburn.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-06-06T06:45:15.000Z","updated_at":"2024-07-17T08:23:23.000Z","dependencies_parsed_at":null,"dependency_job_id":"1f10ce6b-6ba1-4369-848e-15954386a0b1","html_url":"https://github.com/Nathanwoodburn/FireWallet","commit_stats":null,"previous_names":["nathanwoodburn/firewallet"],"tags_count":19,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nathanwoodburn%2FFireWallet","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nathanwoodburn%2FFireWallet/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nathanwoodburn%2FFireWallet/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nathanwoodburn%2FFireWallet/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Nathanwoodburn","download_url":"https://codeload.github.com/Nathanwoodburn/FireWallet/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":242868543,"owners_count":20198500,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cryptocurrency","handshake","handshake-domains","handshake-protocol","hsd","wallet"],"created_at":"2024-07-29T17:59:34.486Z","updated_at":"2025-03-10T14:32:27.252Z","avatar_url":"https://github.com/Nathanwoodburn.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# FireWallet\nExperimental wallet for Handshake chain  \nThe newer python version is available [here](https://github.com/nathanwoodburn/firewalletbrowser)\nInfo about the project can be found at https://firewallet or https://firewallet.au\n\n## Installation\n### Dependencies\nYou will need .net desktop installed. You can download it from [here](https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/runtime-desktop-6.0.18-windows-x64-installer).  \n\nYou will also need Node, NPM, and git installed if you want to use the internal HSD or Ledger wallets.  \n[Git](https://git-scm.com/downloads)  \n[Node](https://nodejs.org/en/download/)  \n[NPM](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm)\n\n### From Releases\nYou can install the latest release from [here](https://github.com/Nathanwoodburn/FireWallet/releases/).\n\nHere are some videos showing how to install and use FireWallet:\nInstall with a running Bob wallet: https://cloud.woodburn.au/s/pS8e2oQDidrMJWx\nInstall with internal HSD: https://cloud.woodburn.au/s/trwd8TyxbDfqaxF (You NEED to have Node, NPM, and git installed to use internal HSD)\n\n### Build from source\nYou can build from source by cloning this repo.  \nYou will need Visual Studio (recommend a recent version) and .net desktop development tools installed.\n\n## Setup\n### Create a new wallet\nYou can create or import a wallet by clicking on the `New` button from the login screen.  \nYou will need to enter a password to encrypt your wallet.  \nThis password will be used to encrypt your wallet and to login to your wallet.  \n**At the moment exporting your Seed Phase does not work**\n\n![Alt text](assets/account_new.png)\n\n\n## First time setup\nWhen you first open the wallet you will be prompted to set your node settings.\n\nYou can either connect to an existing HSD (or Bob) node or you can run your own node.  \nIf you want to run your own node you should select the `Run HSD` option.  \nThis will take a few minutes to download and install HSD.\n\nYou can get the API key from the HSD launch command or \nin Bob wallet under settings \u003e Wallet \u003e API key.  \nIf you change this key in HSD or Bob you will need to update it in FireWallet.  \n\n![Node settings](assets/node_settings.png)  \nIf you need to change your Node settings you can edit the file in `%appdata%\\FireWallet\\node.txt`\n\n\u003cbr\u003e\u003cbr\u003e\u003cbr\u003e\u003cbr\u003e\n# Usage\n\nLogin to your wallet by entering your password (the same as the Bob password).  \nThis password will be stored in memory until you Logout or close the wallet.  \nThis means you will not need to enter your password again until you close the wallet.  \n\n# Portfolio\nThe portfolio page shows your current balance.  \nThe locked balance is the amount of HNS that is currently locked in auctions.  \nThis also includes the amount of HNS that is locked in closed auctions (aka the spent bid).  \n\nThis page shows a list of your transactions.  \nClicking on a Hash will open the transaction in an explorer.  \nYou can change the number of transactions shown in the `portfolio-tx:` settings.\n\n\u003cbr\u003e\n\n![Portfolio](assets/portfolio.png)\n\n\u003cbr\u003e\u003cbr\u003e\n## Sending HNS\n![Send](assets/send_hns.png)\nThis page lets you send HNS to Handshake addresses or domains using [HIP-02](https://github.com/handshake-org/HIPs/blob/master/HIP-0002.md).  \nTo use HIP-02 you need to have HSD resolver (or any HNS compatible DNS resolver) listening on port 5350 (default HSD port).  \nTo enter a domain to use HIP-02 you need to prefix the domain with `@` (eg. `@nathan.woodburn`).\n\n## Receiving HNS or Domains\nThe receive page shows your current HNS address.  \nThis is the address you can give to people to send you HNS or domains.  \nThis address will change every time you receive HNS or domains to prevent address reuse.\n\n![Receive](assets/receive.png)\n\n\n## Domains\nThe domains page shows a list of your domains.  \nIt also lets you search for domains.\nClicking on a domain will open the domain in the domain windows.\n\n![Domains](assets/domains.png)\n\nThe domain windows shows the details of the domain.  \nThis window also lets you auction and manage domains.  \n\n![Domain_Search](assets/domain_search.png)\n![Domain_Manage](assets/domain_manage.png)\n## Manage Domains\nYou can update the records of your domains by clicking on the `Edit DNS` or `Edit in Batch` buttons.  \nThis will open a window where you can edit the records of your domain.  \nAfter you have made your changes you can click the `Send` button to either send the transaction to the network or to the batch window.\n\n\n![DNS Editor](assets/dns.png)\n\n\n\n# Batching\nThe batch window lets you send multiple transactions at once.  \nYou can add transactions to the batch from the domain window or the DNS editor.  \n\n![Batch](assets/batch.png)\n\n\n## Importing\nYou can also import a list of domains to the batch window.  \nThe \"CANCEL\" transaction type is used to cancel an transfer.\n\nPlease not that the import syntax for BIDs is BID,LOCKUP where LOCKUP is (BID+BLIND)\n![Batch Import](assets/batch_import.png)\n\n## Exporting\nYou can export the batch to a file.  \nThis file will store the transaction type, name, and any data needed to send the transaction.  \nYou can then import this file to send the transactions.  \nAn example of this file can be found [here](example-configs/batch.txt).\n\n\n\n\n# Ledger\nYou can use a Ledger device to sign transactions.  \nYou need to have Node, NPM, and git installed to use Ledger.  \nThe Ledger components are not included in the app.  \nThese will install when you first send HNS (not domains) from a Ledger.\n\n\n# Settings\nFireWallet uses a few different settings files.  \nThey are stored in `%appdata%\\FireWallet\\` (`C:\\Users\\{username}\\AppData\\Roaming\\FireWallet\\`)\n\n## settings.txt\nThis file stores the user settings for the application.  \nIf you want to change the default HIP-02 resolver you can add these settings\n```yaml\nhip-02-ip: 127.0.0.1\nhip-02-port: 5350\n```\n\n\n## node.txt\nThis file stores the node (HSD/Bob connection) settings.  \nThe Network is the network you want to connect to (default is `0` for Mainnet).  \nIf you delete this file, FireWallet will show the node setup screen on next startup.\n\nYou can set a custom HSD launch command by setting the `hsd-command` key.  \nThe default launch is the same as this\n```yaml\nHSD-command: {default-dir} --agent=FireWallet --index-tx --index-address --api-key {key} --prefix {Bob}\n```\nThe `{default-dir}` will be replaced with the HSD directory `%appdata%\\FireWallet\\hsd\\`.  \nThe `{key}` will be replaced with the API key from the node.txt file.  \nThe `{Bob}` will be replaced with the Bob wallet HSD data directory `%appdata%\\Bob\\hsd_data\\` this is used to sync FireWallet with Bob's accounts and also stops you needing to sync the chain twice.\n\nOther settings are here. These are the default and if they are not in the file they revert to these values.\n```yaml\nHideScreen: True # Hide the HSD terminal screen (Set to False for higher reliability)\nTimeout: 10 # The time in seconds to wait for any API request\n```\n\n## theme.txt\nThis file stores the theme settings.  \nThe theme is the color scheme of the application.  \nThe `transparent-mode` key is used to enable or disable transparent modes.  \nThere are 4 modes: `off` is disabled, `mica` is windows app style, `key` is to make 1 colour transparent, and `percent` is to set the opacity of the window.\n\n## log.txt\nThis file stores the logs for the application.  \nYou should check this file if you have any issues with the application.\n\n# Thanks\nThanks to @ponderingken (https://github.com/ponderingken) for designing the logo and splash screen.\n\n\n\n# Support\nIf you have any issues with the application you can open an issue on GitHub or contact me on Discord (NathanWoodburn on most Handshake servers).\n\nIf you would like to support this project you can find out how at https://nathan.woodburn.au/#donate or you can help by contributing to the project on GitHub.  \nAlso you can send HNS directly to `@firewallet`","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FNathanwoodburn%2FFireWallet","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FNathanwoodburn%2FFireWallet","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FNathanwoodburn%2FFireWallet/lists"}