getting-started

User Guides

Getting Started

Welcome to the Haircomb blockchain system. This guide will help you get started by walking you through setting up a wallet, claiming Haircomb (COMB), and trading on the Haircomb network.

Setting Up Wallets

Haircomb wallets are essential to interacting with the Haircomb network. You can either generate a new wallet or import an existing one.

Wallet URL Testnet
https://core.haircomber.com No
https://core.haircomb.org No
https://test.haircomber.com Yes

Step 1 - Generating Private Keys

  • 1) Go to the Web Wallet:
    • Navigate to your wallet and click on the "Wallet" option in the top navigation bar.
  • 2) Generate Keys:
    • Select "Mainnet key generate." A public key will appear, which is tied to your private keys.
  • 3) Export Keys:
    • To save your private keys and transaction history, go to the "Export" section, enter a file name under the "Export" field, and click "Export." This will generate a .dat file containing your private keys and history. Keep this file safe—you will need it every time you engage in a Haircomb transaction.

Step 1.5 - Loading Private Keys/History

If you already have a wallet and want to import it into the Haircomb Web Wallet:

  • 1) Go to "Export" and press the "Load" button under the "Load" section.
  • 2) Select all wallet files which you want to load and confirm the dialog.
  • 3) The wallet should load your keys and histories, allowing you to manage your funds.

Alternatively:

  • 1) Go to "Export" and check the "Allow paste import wallet" checkbox.
  • 2) Either paste the wallet file from file explorer into the browser, or open your .dat file in a text editor like Notepad, copy the entire contents, and paste it into the Web Wallet interface.
  • 3) The "Allow paste import wallet" checkbox will become unchecked, confirming the load.
  • 4) The wallet should load your keys and history, allowing you to manage your funds.

After loading a wallet consider pressing Scan mempool to apply any pending transactions inside your wallet.

Claiming Haircomb

To claim COMB to your Haircomb wallet, follow these steps:

Step 2 - Getting a Claiming Address

  • 1) Open the Web Wallet and navigate to the "Wallet" page.
  • 2) Select the public key of the Haircomb account you want to use.
  • 3) Click on "Stealth Addresses" at the bottom left. This will generate a list of stealth addresses for you.
  • 4) Choose one stealth address to use for your claim. Note: A stealth address can only attempt a COMB claim once. If the claim fails, the same address cannot be used again. You must use a different one for the next claim.
  • 5) Scroll down to find the Bitcoin Stealth Claiming burn address (pay 330 sats). This is your BTC CLAIM ADDRESS.

Step 3 - Claiming COMB

Claiming Haircomb requires getting your BTC CLAIM ADDRESS to appear as the highest Pay-to-Witness-Script-Hash (P2WSH) address in the next BTC block. Here's how:

  • 1) Prepare to Bid: Use the Chart tab - Bids section of the wallet to see the current highest BTC P2WSH fee. Press the reload button repeatedly to load more transactions. You can also press filter to clear transactions that are already mined in blocks. Set your fee higher than the one displayed as first.
  • 2) Create a BTC Transaction: Send 330 sats to your BTC CLAIM ADDRESS, setting the fee to be higher than the current highest bid in the Bids section of the Chart tab on the site.
  • 3) Broadcast Your Transaction: Monitor the Bids section tool to ensure your transaction is being broadcasted and stays as the highest fee until the next BTC block is mined.

If someone outbids you, you can use BTC’s replace-by-fee functionality to increase your fee and retry.

Step 4 - Sweeping Claims

Once your claim is successful (after your claim's BTC block gets mined):

  • 1) Navigate to the "Coins" page and click "Load Claims." (Optionally, change the claims to be loaded count to 1000). This will update your balance to reflect the new COMB.
  • 2) Open the Wallet section and note that the claim exists as a balance next to your stealth COMB address.
  • 3) Finally, sweep the claim into your primary Haircomb wallet by clicking "Sweep Stealth Addresses" in the "Wallet" section. Your stealth address balance will transfer to your primary balance.

After this, export a new .dat file to keep your wallet updated.

Trading Haircomb

Market URL Testnet Currency
https://swap.haircomber.com No, Yes Ethereum

Once you have claimed and secured your Haircomb, you can begin trading it with others. Since Haircomb doesn’t store transaction signatures on-chain, you can provide your transaction history from the "Export" tab "Export for Recipient" section during trades to prove ownership of COMB or to prove the deposit of COMB into a contract. Trading often involves:

  • 1) Initiating a Trade commitment: Make commitment using your bitcoin wallet, like when claiming, except you can use any fee.
  • 2) Providing your Transaction History to them: Ensure your transaction history is up-to-date before exporting the history from the "Export" tab "Export for Recipient" section for each deal counterparty or payment recipient.
  • 3) Validating their Transaction History: Always verify that the .dat history file shared by the trading counterparty is legitimate and reflects their true balance, by importing it into your Haircomb wallet and pressing "Scan Mempool".

Trading COMB requires careful management of your private keys, transaction history, and stealth addresses to ensure transparency and security during exchanges.

Note: Losing access to your .dat file means losing your ability to prove COMB ownership, so secure it thoroughly.

For more details, visit Haircomb Official Documentation.