{"id":21375021,"url":"https://github.com/nathanwoodburn/hsdbatchergui","last_synced_at":"2025-08-09T23:37:15.906Z","repository":{"id":156144664,"uuid":"588007960","full_name":"Nathanwoodburn/HSDBatcherGUI","owner":"Nathanwoodburn","description":"GUI for sending transaction batches on the Handshake blockchain using the HSD API.","archived":false,"fork":false,"pushed_at":"2023-07-13T11:08:54.000Z","size":574,"stargazers_count":9,"open_issues_count":0,"forks_count":2,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-06-12T01:03:30.241Z","etag":null,"topics":["handshake","handshake-domains","handshake-protocol"],"latest_commit_sha":null,"homepage":"","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-01-12T05:14:51.000Z","updated_at":"2024-04-26T04:06:42.000Z","dependencies_parsed_at":"2024-11-22T09:15:23.744Z","dependency_job_id":null,"html_url":"https://github.com/Nathanwoodburn/HSDBatcherGUI","commit_stats":null,"previous_names":[],"tags_count":17,"template":false,"template_full_name":null,"purl":"pkg:github/Nathanwoodburn/HSDBatcherGUI","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nathanwoodburn%2FHSDBatcherGUI","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nathanwoodburn%2FHSDBatcherGUI/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nathanwoodburn%2FHSDBatcherGUI/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nathanwoodburn%2FHSDBatcherGUI/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Nathanwoodburn","download_url":"https://codeload.github.com/Nathanwoodburn/HSDBatcherGUI/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nathanwoodburn%2FHSDBatcherGUI/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":269654121,"owners_count":24454318,"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","status":"online","status_checked_at":"2025-08-09T02:00:10.424Z","response_time":111,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["handshake","handshake-domains","handshake-protocol"],"created_at":"2024-11-22T08:46:33.098Z","updated_at":"2025-08-09T23:37:15.894Z","avatar_url":"https://github.com/Nathanwoodburn.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# **NEW WALLET**\nFireWallet is a new wallet for Handshake.  \nIt runs on Windows (using .net framework).  \nIt includes the same functionality as this Batcher tool and much more.\nYou can have a look at it [here](https://github.com/Nathanwoodburn/FireWallet/)\n\n\n# BidderGUI\n![image](https://github.com/Nathanwoodburn/HSDBatcherGUI/blob/master/HSDBatcher-v4.1.png)\n\nWatch this video for a short intro on how this tool works:\n[https://youtu.be/w8NUjOqySiM](https://youtu.be/w8NUjOqySiM)\n\nEasy to use HSD Bidder built on C# .net framework  \nThis version only works with HSD v5 or greater.  \nIf you have below this version use [this release](https://github.com/Nathanwoodburn/HSDBatcherGUI/releases/tag/1.1.0.0)\n\nTo use this you need to be running a HSD node (either Full or SPV).  \nBob comes with this node built in.\n\nThe API key is set using the HSD flag `--api-key=\u003ckey\u003e`.  \nBob automatically generates an API key for you. This can be obtained from Bob wallet in Settings \u003e wallet \u003e API Key.\n\nThe wallet name and passphrase are the same as you set on Bob or HSD.\n\n## Instructions\n1. Enter API key\n2. Enter wallet name and password.\n3. Test your connection to the HSD node. To connect you need to be running HSD (or Bob Wallet).\n4. Add domains either using the text box or by importing a text file. (See example-domains.txt for formatting)\n5. Select mode from [available transaction types](#transactions)\n   \n6. Set batching settings\n7. Press start to begin batching transactions\n8. Pause at any time by pressing Stop\n\n\n## Transactions\n1. OPEN: Opens domains for auction\n2. BID: Send bids with specified bid and blind  \n     • Set bid and blind in HNS values (not dollarydoos)\n3. REVEAL: Reveal bids\n4. REDEEM: Redeems lost auction bids\n5. REGISTER: Registers domain to winning bid and burns second highest bid value (can use UPDATE instead)\n6. UPDATE: Updates domains' resource (Blockchain DNS) records\n     • Add DNS records\n7. RENEW: Renews domains\n8. TRANSFER: Start domain transfers to a new address (Not implemented yet)\n9.  FINALIZE: Finalize transfers. You need to wait at least 288 blocks between TRANSFER \u0026 FINALIZE (Not implemented yet)\n\n## Settings\n- Batch size\nThis sets how many domains are sent in each transaction. If you send too many the transaction might fail to send.\n- Batch interval\nThis sets how many minutes are between sending batch transactions. If you set this too low the transactions might fail to send.\n- Log length\nThis sets how many lines of log are shown in the log box. If you set this too high the log box might become slow to update (and in extreme cases cause crashing).\n- Skip Errors\nThis will continue to send transactions even if one fails. This is useful if you have a large number of domains and one fails to send.\n\n## Ledger\n1. Clone the HSD ledger repo and build it  \n`git clone https://github.com/handshake-org/hsd-ledger.git`  \n`cd hsd-ledger`  \n`npm install`\n\n2. Replace the `hsd-ledger` file in the `bin` folder with [this file](hsd-ledger). This file adds the sendraw transaction command required to send a batch.\n3. Open the HSD GUI and fill in your API key, wallet name and password. Also check the `Use Ledger` box.\n4. Create a file in the `hsd-ledger` folder called `names.txt` and paste in the domains you want to send. Each domain should be separated by a `,` in a single line. eg `domain1,domain2,domain3`\n5. Send a batch like you would normally. Press the Start and wait for the log to say `Saved to clipboard.` then press Stop (as you now need to sign and send this transaction).\n6. Create a file in the `hsd-ledger` folder called `batch.json` and paste the contents of the clipboard into this file. This will be the transaction you tell your ledger to sign.\n7. Connect your ledger to your computer and open the Handshake app.\n8. Run the command `node bin/hsd-ledger sendraw --http-host 127.0.0.1 --api-key=\u003cyour-api-key\u003e -w \u003cyour-wallet-name-as-shown-in-bob\u003e batch.json names.txt` and follow the instructions on your ledger to sign the transaction.  \nExample `node bin/hsd-ledger sendraw --http-host 127.0.0.1 --api-key=1234 -w coldwallet batch.json names.txt`\n9. Sign the transaction on your ledger.\n\n\n## Theme\nYou can change the theme by editing the `theme.txt` file in `%appdata%/HSDBidderGUI`.  \nHere is a list of options:\n\n### background:\nSets the background color of the form.\n\n### background-alt:\nSets the background color of the controls.\n\n### foreground:\nSets the foreground color of the form.\n\n### foreground-alt:\nSets the foreground color of the controls.\n\n### trantransparent-mode:\nSets the transparency of the form.\nOptions are:\n1. off (or delete the line)\n2. mica (styled like some newer windows apps)\n3. key (transparent with a key color)\n     This will also make the transparent colour clickthroughable.\n4. percent (transparent with a percentage)\n     This will affect all parts of the form.\n\n### transparency-key:\nSets the key color for the form. Required if transparent-mode is set to key.  \nCan also be set to `main` or `alt` to use the main or alt background colors.  \n! Warning if you set this to be black the menu options (Minimize, Close) will be a bit buggy.\n\n### transparency-percent:\nSets the transparency percentage for the form. Required if transparent-mode is set to percent.  \n0 is fully transparent and 100 is fully opaque.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnathanwoodburn%2Fhsdbatchergui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnathanwoodburn%2Fhsdbatchergui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnathanwoodburn%2Fhsdbatchergui/lists"}