v2.0.1 - Testnet 1 - FishHashPlus - KarlsenHashV2

Mandatory Testnet Update

This release is a mandatory update for testnet-1 introducing KarlsenHashV2 algorithm improvements. This release is intended to be used only in testnet-1. Please don't try use it in mainnet, it will immediately return with non-zero exit code.

• New version of the KarlsenHashV2 algorithm implementing a patch from IronFish algorithm audit suggestion.
• Hardfork at DAA score of 6,000,000, approximately Thu Mar 31 08:30:00 PM UTC 2024.

Additional Information

In the course of a security review of FishHash, a recommendation was made to modify the algorithm to slightly improve it. This suggestion does not have an immediate effect on safety or security, but it was recommended to implement the change. The modifications have been made publicly accessible for review at the following URL: Lolliedieb/FishHashMiner@5d94a52

Setup

Instructions are the same as for v2.0.0-testnet-1-fishhash and can be found here: https://github.com/karlsen-network/karlsend/releases/tag/v2.0.0-testnet-1-fishhash

Thanks

Thanks to everyone who directly contributed to this release:

• @okilisan
• @wam-rd

A very huge kudos is given to @Lolliedieb for his exceptional work on the FishHash algorithm and for his assistance in addressing questions!

v1.2.0 - Mighty Marlsen - Update 2

Recommended Update

Stable release update 2 with the following changes:

• Added support for derivation path from Kaspa as wallet v1 and Karlsen as wallet v2 (see backward compatibility below)
• Added new command line option -l (short) or --legacy (long) to the create subcommand (see backward compatibility below)
• Switched cointype in bip39 derivation to 121337 (see backward compatibility below)
• Changed karlsenwallet listen port from 8082 to 9182
• Fixed karlsend and karlsenminer Go traces
• Fixed all stability and integration tests
• Fixed crash in karlsenminer
• Fixed race in gRPC client send, recv and close handler
• Updated Go modules and dependencies
• Issues closed: #6, #7, #13, #17, #19, #25, #26, #34, #36, #37, #38, #40

Breaking Changes

With the complete decoupling of Karlsen from Kaspa, we've introduced several changes which may require attention from node operators. If you are using --loglevel to specify different subsystem verbosity levels, you need to switch KASD= to KLSD= otherwise node startup will fail with: The specified subsystem [KASD] is invalid.

Backward Compatibility

Following the recent transition from Kaspa coin type 111111 to Karlsen coin type 121337 - a change already documented on https://github.com/satoshilabs/slips/blob/master/slip-0044.md - we're in the process of adopting our specific derivation path. This step is crucial for most integrations that do not operate a node daemon, such as hardware wallets, to ensure address compatibility across different platforms. A unique derivation path is essential for this purpose.

We currently have wallets that use the old coin type, necessitating support for both the legacy and new derivation paths. To facilitate this, a new command line option has been introduced for the create subcommand: -l (short) or --legacy (long). Here's how it functions:

• By default, the command creates or imports a version 2 wallet using the new coin type 121337.
• When the legacy option is invoked, it creates or imports a version 1 wallet with the original coin type 111111.

Although wallets with version 1 will remain operational, migrating KLS to a newly established version 2 wallet is strongly advised for future compatibility with both software and hardware wallets.

Thanks

Thanks to everyone who directly contributed to this release:

• @lemois-1337
• @masben-mb

v2.0.0 - Testnet 1 - FishHash

Testnet Release

This release is intended to be used only in testnet-1 to verify new mining algorithm based on FishHash. Please don't try use it in mainnet, it will immediately return with non-zero exit code. You can find more information about FishHash in the following paper: https://github.com/iron-fish/fish-hash/blob/main/FishHash.pdf

Testnet Purpose

Our goal is to thoroughly evaluate KarlsenHashV2's (FishHash) performance and security. We invite blockchain enthusiasts, developers, and experts to join this open testnet and help us gather crucial data and insights.

Key Indicators for Monitoring

We'll be monitoring several key metrics to ensure our network's strength:

• Blockrate - Understanding the time to mine new blocks under different network conditions.
• Red Block Ratio - Assessing the frequency of orphaned blocks for network stability.
• Validation Time - Measuring transaction validation times on various machines.

Setup

Run the node:

karlsend --testnet --utxoindex --connect 192.99.200.155

Run the miner:

karlsenminer --testnet --miningaddr karlsentest:qrxuvenk483jj5k5zpwgdqyk27eacsgv9fj3kwu6puj38usnaj9uu55cz0y8q

Replace the miningaddr with your wallet address and please be aware of the karlsentest: prefix in testnet.

Thanks

Thanks to everyone who directly contributed to this release:

• @okilisan
• @wam-rd

v1.1.0 - Mighty Marlsen - Update 1

Optional Update

Stable release update 1 with the following features:

• #1 [Fix] Max coin supply fixes
• #2 [Fix] Docker configs
• #15 [Fix] Rename text string kaspa to karlsen in karlsenwallet
• #18 [Testnet] Genesis hash for setup testnet, simnet & devnet for karlsen
• #20 [RPC][Fix] Batch upstream merge including critical RPC bug
• #23 [Fix] Additional DNS seeders and enabled testnet, simnet and devnet
• #24 [Fix] GitHub workflow for automatic and deterministic builds

Notes

It's worth noting that this marks the initial phase of our algorithm modification plan set for Q1/2024. During this period, a variety of algorithms will undergo testing on a public testnet. The team at Karlsen Network has put forward FishHash as our proposed solution, and we openly invite members of our community to either suggest or create their own GPU-compatible algorithms. These submissions will be evaluated by the community and considered for inclusion on the list of algorithms up for voting.

Thanks

Thanks to everyone who directly contributed to this release:

• @lemois-1337
• @okilisan
• @wam-rd
• @nguyenvinhlinh

v1.0.0

first shoot