# Lokiwiki - Flokicoin Knowledge Source

> Guides for Lokichain, the Flokicoin economy, wallets, and mining ops

This file contains all documentation content in a single document following the llmstxt.org standard.

## Economy

import EconomyNow from '@site/src/components/EconomyNow'; // eslint-disable-line no-unused-vars
import Amount from '@site/src/components/Amount'; // eslint-disable-line no-unused-vars
import rewardOverTimeImage from './reward_over_time.webp';
import supplyOverTimeImage from './supply_over_time.webp';
import inflationRateImage from './inflation_rate_over_10_years.webp';

## Overview

Flokicoin uses a decreasing block subsidy that halves on a fixed block interval and then transitions to a fixed tail emission. The goal is predictable issuance with long‑term, stable miner incentives. For live metrics, see [Now](#now).

## Parameters

- Block interval: 1 minute
- Halving interval: 210,000 blocks
- Initial block reward: <Amount value={1000} />
- Tail emission (no hard cap): <Amount value={21} /> per block once the reward would fall below 21
- Coinbase maturity: 300 blocks (~5 hours)

## Issuance Schedule

The initial block reward is <Amount value={1000} /> and halves every 210,000 blocks (~5 months at 1‑minute blocks).

After the reward would drop below <Amount value={21} />, the subsidy remains fixed at <Amount value={21} /> per block (tail emission). This avoids a fee‑only regime and provides a steady, predictable security budget.

:::note
Block counts are exact. Calendar dates below assume an average 1‑minute interval and are approximate.
:::

Block ranges, reward per block, and approximate calendar timing.

| Blocks              | Reward                        | Approx. Halving Date | Cumulative Supply (million FLC) |
|---------------------|------------------------------:|-----------------------|--------------------------------:|
| → 210,000           | <Amount value={1000} />        | 2025-08-28            | 210.00                          |
| 210,000 → 420,000   | <Amount value={500} />         | 2026-01-20            | 315.00                          |
| 420,000 → 630,000   | <Amount value={250} />         | 2026-06-15            | 367.50                          |
| 630,000 → 840,000   | <Amount value={125} />         | 2026-11-08            | 393.75                          |
| 840,000 → 1,050,000 | <Amount value={62.5} decimals={1} />  | 2027-04-03            | 406.88                          |
| 1,050,000 → 1,260,000 | <Amount value={31.25} decimals={2} /> | 2027-08-27            | 413.44                          |
| 1,260,000+          | <Amount value={21} /> (fixed)  | —                     | -                               |

## Inflation After Tail Emission

- Annual issuance remains constant at <Amount value={11037600} /> (<Amount value={21} /> × 525,600 blocks/year).
- As total supply grows, the annual inflation rate declines.

### Definitions

- Annual issuance E = R × B, where R is the per‑block reward (<Amount value={21} />) and B is blocks per year (525,600).
- Annual inflation (%) = (E ÷ total supply at year start) × 100.

:::note
Projections assume the average block interval stays close to 1 minute. Real‑world issuance varies with network conditions.
:::

| Year | Total Supply(million FLC) | Annual Inflation Rate(%) |
|-----:|-------------------------------:|-----------------------------:|
| 1    | 424.48                         | 2.67                          |
| 2    | 435.51                         | 2.60                          |
| 3    | 446.55                         | 2.53                          |
| 4    | 457.59                         | 2.47                          |
| 5    | 468.63                         | 2.41                          |
| 6    | 479.67                         | 2.36                          |
| 7    | 490.70                         | 2.30                          |
| 8    | 501.74                         | 2.25                          |
| 9    | 512.78                         | 2.20                          |
| 10   | 523.82                         | 2.15                          |

## Now

<EconomyNow />

---

## Lokiwiki - Flokicoin Knowledge Source

import heroImage from './hero.webp';
import Link from '@docusaurus/Link'; // eslint-disable-line no-unused-vars
import Heading from '@theme/Heading'; // eslint-disable-line no-unused-vars

  
    <Heading as="h1" style={{marginBottom: '0.25rem'}}>Such Wiki</Heading>
    Practical docs for the Flokicoin ecosystem.
    
      
    
  

  
    
      <Link className="card card--link" to="/lokichain">
        <Heading as="h3">Lokichain</Heading>
        
          Flokicoin Core (go-flokicoin): full node, consensus, RPCs, and FIPs.
        
      </Link>
    
    
      <Link className="card card--link" to="/economy">
        <Heading as="h3">Economy</Heading>
        
          Track issuance, halving schedule, supply growth, and inflation projections.
        
      </Link>
    
    
      <Link className="card card--link" to="/wallets/twallet">
        <Heading as="h3">Wallets</Heading>
        
          Guides covering wallet setup, daily operations, and recovery.
        
      </Link>
    
    
      <Link className="card card--link" to="/mining">
        <Heading as="h3">Mining</Heading>
        
          PoW mining, AuxPoW merge-mining, pools, GPU/ASIC guides, and testnet CPU.
        
      </Link>
    
    
      <Link className="card card--link" to="/resources">
        
          <Heading as="h3">
            
              <svg xmlns="http://www.w3.org/2000/svg" width="18" height="18" viewBox="0 0 18 18">
                <g fill="none" stroke="currentColor" strokeWidth="1.6" strokeLinecap="round" strokeLinejoin="round">
                  <circle cx="9" cy="3.5" r="2.5" />
                  <circle cx="4" cy="12.5" r="2.5" />
                  <circle cx="14" cy="12.5" r="2.5" />
                  <path d="M7.75 4.9 5.3 11.1M10.25 4.9 12.7 11.1" />
                </g>
              </svg>
            
            Resources
          </Heading>
        
        
          Explorers, faucets, mining pools, and community-maintained tooling.
        
      </Link>
    
    
      <Link className="card card--link" to="/wof">
        
          <Heading as="h3">
            
              <svg xmlns="http://www.w3.org/2000/svg" width="18" height="18" viewBox="0 0 18 18">
                <g fill="none" stroke="currentColor" strokeWidth="1.6" strokeLinecap="round" strokeLinejoin="round">
                  <path d="M9 2.2 10.3 5l3 .22-2.3 2.02.7 2.93L9 9.82l-2.7 1.35.7-2.93L4.7 5.22 7.7 5z" />
                  <path d="M12.8 13.4c1.2-.56 2.2-1.52 2.7-2.82M2.5 10.6c.5 1.3 1.5 2.26 2.7 2.82M9 14.8v-2.3" />
                </g>
              </svg>
            
            Web of Fun
          </Heading>
        
        
          WoF movement drafting FEPs that rebuild everyday services with Nostr protocol, work-backed economies, and joyful UX.
        
      </Link>
    
  

<section className="resources-footer">
  
    <Heading as="h2">Looking for AI Context files?</Heading>
    
    

      We publish llms.txt and llms-full.txt static files containing the full docs
      in a streamlined Markdown-style format optimized for AI.
    
  
</section>

---

## FIP-05: Difficulty Adjustment

Author: Thiniboy  
Status: Final  
Created: 2025-07-18

## Summary

Adopt a per-block, Digishield-style difficulty retarget using an exponential moving average (EMA) toward the one-minute target spacing. The algorithm improves responsiveness to hashrate shocks while damping oscillations and reducing variance.

## Motivation

Long retarget windows allow exploitable oscillations and long periods of off-target difficulty. A per-block EMA responds quickly to changes while preserving stability.

## Specification

- Target spacing T = 60 seconds.
- At each block n, update an EMA of observed spacings with amplitude divisor 8 (effectively an 8-sample EWMA).
- Apply bounded damping on each step to limit the effective spacing influence to the range [0.75·T, 1.5·T].
- Compute the next target by scaling the previous target by the ratio of clamped spacing to T, subject to consensus limits.
- Allow minimum-difficulty blocks when the observed spacing exceeds a chain-parameterized threshold (where enabled).

:::important
**Activation (mainnet):** block 115,000.
:::

## Rationale

Per-block EMA reduces lag compared to long-window retargets while the clamp prevents over-reaction to outliers. Similar approaches were proven in other UTXO chains under the “Digishield” family.

## Reference Implementation

Implemented in `go-flokicoin` and enabled via chain parameters. See release [0.25.7-beta](/lokichain/releases/0.25.7-beta) and consensus changes therein.

```text
Inputs:
  T           := 60 seconds (target spacing)
  Divisor     := DigishieldAmplitudeDivisor (8 in Flokicoin)
  ClampMin    := 0.75 × T
  ClampMax    := 1.50 × T
  prevTarget  := last difficulty target (integer)
  actualSpan  := timestamp_n - timestamp_{n-1}

Algorithm:
  1. modulatedSpan ← T + (actualSpan - T) / Divisor
  2. modulatedSpan ← clamp(modulatedSpan, ClampMin, ClampMax)
  3. nextTarget ← prevTarget × modulatedSpan / T
  4. nextTarget ← min(nextTarget, PowLimit)

Result:
  Convert nextTarget back to compact bits for the header.

Note: when ReduceMinDifficulty is enabled, a separate rule mints a
minimum-difficulty block if actualSpan exceeds DigishieldLateBlockMultiple × T.
That shortcut is orthogonal to the per-block EMA above.
```

---

## FIP-06: Merge Mining

Author: Izimmerma &lt;izimer@ohstr.com&gt;  
Status: Final   
Created: 2025-08-15

## Abstract

Lokichain adopts Auxiliary Proof-of-Work (AuxPoW) so miners can reuse work found on a parent proof-of-work chain. The AuxPoW envelope supplies the parent header, coinbase commitment, and merkle proofs needed to show that the Lokichain block header was embedded in the parent block’s work.

## Motivation

Merge mining allows Lokichain to inherit a larger network’s hashrate without demanding miners split their effort. Following established AuxPoW conventions reduces the integration burden for mining pools while preserving consensus clarity.

## Terminology

- **Parent blockchain:** The network whose valid block header and proof-of-work are reused by Lokichain (e.g., any scrypt-family PoW chain).
- **Auxiliary blockchain:** Lokichain, which validates AuxPoW data and accepts the parent work as its own.
- **AuxPoW block:** A Lokichain block that may not satisfy the child difficulty target on its own but includes proofs that the parent block’s work does.
- **Aux work merkle tree:** The commitment structure rooted in the parent coinbase that yields both the coinbase branch (into the parent merkle root) and the chain branch (down to the Lokichain header commitment), enabling multiple auxiliary chains to share a single parent block.

## Specification

Lokichain marks a header as AuxPoW-enabled by setting bit 8 of the version field (`VersionAuxPow`) and writing the six-bit chain identifier into bits [16..21]. When this flag is present the node appends the following payload immediately after the 80-byte base header and before the transaction vector:

| Field | Type | Purpose |
| --- | --- | --- |
| `aux_version` | 1 byte | AuxPoW payload version. Lokichain uses `0x00`. |
| `parent_coinbase_tx` | Serialized transaction | Full parent coinbase transaction containing the merge-mining commitment. |
| `coinbase_branch` | Merkle branch (`var_int` length, 32-byte hashes, 32-bit side mask) | Proves the coinbase transaction is included in the parent merkle root. |
| `chain_branch` | Merkle branch (optional) | Proves the Lokichain commitment within the Aux work merkle tree; empty when the parent block services only Lokichain. |
| `parent_header` | 80-byte serialized header | Parent chain header whose proof-of-work will be validated against Lokichain’s requirement. |

### Aux proof-of-work block

Fields serialize in the table order above. `aux_version` is fixed at `0x00`; `coinbase_branch` must have a side mask of `0` because the coinbase resides at index 0; `chain_branch` may be length zero when Lokichain is the only auxiliary chain. Lokichain omits the legacy standalone `block_hash` element—nodes recompute it from the provided header and merkle data.

### Parent coinbase commitment

Miners place the merged-mining marker `0xfa 0xbe 'm' 'm'` in the `scriptSig` of `parent_coinbase_tx`, immediately followed by:

1. `chain_root` — the double-SHA256 root obtained by folding `chain_branch` over the current Lokichain block hash, encoded little-endian in the script.
2. `tree_size` — a little-endian `uint32` that must equal `1 << chain_branch.Size()`.
3. `merkle_nonce` — a little-endian `uint32` mixed with the AuxPoW `chain_id` to pick Lokichain’s deterministic slot in the Aux work tree.

:::tip
Lokichain uses `0x21` as its AuxPoW `chain_id`.
:::

When only Lokichain participates, `chain_branch` is length zero and `chain_root` is just the current Lokichain block hash. With multiple auxiliary chains, miners supply the branch proving Lokichain’s leaf inside the shared Aux work tree.

### Validation rules

Lokichain consensus validates AuxPoW blocks as follows:

- Require the AuxPoW header bit and correct `ChainID` encoding for the current network parameters.
- Hash `parent_header` and ensure the resulting proof-of-work meets or exceeds the Lokichain difficulty target for the block height.
- Recalculate the parent merkle root using `parent_coinbase_tx` and `coinbase_branch`, ensuring it matches the root in `parent_header`.
- Verify `coinbase_branch.SideMask` is zero and the coinbase transaction size stays within consensus limits.
- Combine the current Lokichain block hash with `chain_branch` (if present) to derive `chain_root`, and verify the little-endian bytes appear in the parent coinbase exactly after the merged-mining marker.
- Check that `tree_size` equals `1 << chain_branch.Size()` and that the `SideMask` from `chain_branch` matches the deterministic index `getExpectedIndex(merkle_nonce, chain_id, branch_size)`.
- Confirm standard Lokichain consensus rules on the current block header (previous-hash linkage, difficulty bits, median time, and contextual checks).
- Reject AuxPoW payloads that include the deprecated `block_hash` field or otherwise mismatch the expected serialization.

:::important
**Activation (mainnet):** block 115,840.
:::

## Rationale

Reusing the long-standing merged-mining structure keeps BIP-compliant semantics while the omission of the redundant `block_hash` field delivers a modest bandwidth and storage optimisation. The structure is compatible with existing pool software that already supports AuxPoW networks.

## Reference Implementation

Implemented in `go-flokicoin` (wire + consensus). See release [0.25.7-beta](/lokichain/releases/0.25.7-beta) for activation parameters and wire structs.

### RPC Support

AuxPoW mining is exposed over the standard RPC interface:

```
createauxblock <payout_address>
```

Returns an object containing:

- `hash` — identifier miners must hash in the parent chain coinbase.
- `chainid` — Lokichain’s chain identifier (decimal `33`, hex `0x21`).
- `previousblockhash`, `height`, `bits`, `target` — child-chain context and work target.
- `coinbasevalue` — child-chain coinbase payout in atomic units.

Example response:

```
{
  "hash": "0c63598bf66646ee9bf80797a40d607d12db9a6bc97fd4b98da70c904dd250c8",
  "chainid": 33,
  "previousblockhash": "94f1f588f620713ef99dfb1b2f3079a0f4545d4e15035e8227c5534dea965f33",
  "coinbasevalue": 100000000000,
  "bits": "202f725e",
  "height": 13,
  "target": "2f725e0000000000000000000000000000000000000000000000000000000000"
}
```

Miners call:

```
submitauxblock <hash> <auxpow_hex>
```

Where `auxpow_hex` is the serialized AuxPoW payload built from the parent block template.

---

## FIPs

Flokicoin Improvement Proposals (FIPs) are design documents providing information to the Flokicoin community, or describing new features, their rationale, and technical specifications.

Current proposals:

- [FIP-06: Merge Mining](/lokichain/fips/FIP-06)
- [FIP-05: Difficulty Adjustment](/lokichain/fips/FIP-05)

---

## Lokichain

Lokichain is the public, permissionless blockchain that secures Flokicoin. Flokicoin Core is the reference node software: it validates blocks and transactions, enforces consensus rules, and exposes network and wallet interfaces.

:::release
Latest Flokicoin Core [v0.25.7-beta Read the release notes →](/lokichain/releases/0.25.7-beta)
:::

## Run a node

- Verifies the chain and serves RPCs for apps, operators, and miners.

:::note
Guide coming soon. Community plug‑and‑play option: https://myfloki.com/operator
:::

## Wallets

- tWallet v1 (Neutrino, recommended) → [/wallets/twallet/v1](/wallets/twallet/v1)

## Developers

- Use a local node for RPCs and tests
- FIPs → [/lokichain/fips](/lokichain/fips)
- Releases → [/lokichain/releases](/lokichain/releases)
- Source → https://github.com/flokiorg/go-flokicoin

## Miners

- Fully‑synced node required
- Mining → [/mining](/mining)

## How Lokichain works

- Network: peer-to-peer protocol for block and transaction propagation.
- Consensus: rule set governing block validity and chain selection, evolved via FIPs.
- Node software: Flokicoin Core implements validation, mempool, mining RPCs, and wallet/RPC interfaces.
- Interfaces: P2P, JSON‑RPC, and streaming where applicable.
## Community and support

- Questions and discussion: Discord → https://flokicoin.org/discord
- Report bugs in Flokicoin Core via GitHub issues → https://github.com/flokiorg/go-flokicoin/issues

---

## 0.25.1-beta

Please report bugs using the issue tracker at GitHub:

https://github.com/flokiorg/go-flokicoin/issues

## Notes

- This is a pre-release for testing and feedback.
- Developers and early adopters are encouraged to report issues.

## Assets

| OS/Arch | Asset |
| --- | --- |
| macOS (Apple Silicon) | https://github.com/flokiorg/go-flokicoin/releases/download/v0.25.1-beta/flokicoind-darwin-arm64-v0.25.1-beta.tar.gz |
| macOS (Intel) | https://github.com/flokiorg/go-flokicoin/releases/download/v0.25.1-beta/flokicoind-darwin-amd64-v0.25.1-beta.tar.gz |
| Linux x86_64 | https://github.com/flokiorg/go-flokicoin/releases/download/v0.25.1-beta/flokicoind-linux-amd64-v0.25.1-beta.tar.gz |
| Linux arm64 | https://github.com/flokiorg/go-flokicoin/releases/download/v0.25.1-beta/flokicoind-linux-arm64-v0.25.1-beta.tar.gz |
| Windows x86_64 | https://github.com/flokiorg/go-flokicoin/releases/download/v0.25.1-beta/flokicoind-windows-amd64-v0.25.1-beta.zip |

---

## 0.25.5-beta

Please report bugs using the issue tracker at GitHub:

https://github.com/flokiorg/go-flokicoin/issues

## Notable changes

- Added new blockchain checkpoints, including at block 0 and later heights.
- Enhanced PSBT handling: support for extended public keys (XPubs) and path validation.
- Added PSBT test coverage for BIP32 path serialization/deserialization.
- Improved validation of PSBT path minimum length.
- Improved block header timestamp validation.
- Updated mempool, txscript, and wallet to use `maps.Copy` for safer and cleaner map handling.
- Fixed typo: corrected PSBT constant from `XpubType` to `XPubType`.
- Fixed minor issues in PSBT encoding/decoding and comments.
- Renamed `flokicoin-cli` to `flokicoind-cli` across all binaries, config paths, and documentation.

## Assets

| OS/Arch | Asset |
| --- | --- |
| macOS (Apple Silicon) | https://github.com/flokiorg/go-flokicoin/releases/download/v0.25.5-beta/flokicoind-darwin-arm64-v0.25.5-beta.tar.gz |
| macOS (Intel) | https://github.com/flokiorg/go-flokicoin/releases/download/v0.25.5-beta/flokicoind-darwin-amd64-v0.25.5-beta.tar.gz |
| Linux x86_64 | https://github.com/flokiorg/go-flokicoin/releases/download/v0.25.5-beta/flokicoind-linux-amd64-v0.25.5-beta.tar.gz |
| Linux arm64 | https://github.com/flokiorg/go-flokicoin/releases/download/v0.25.5-beta/flokicoind-linux-arm64-v0.25.5-beta.tar.gz |
| Windows x86_64 | https://github.com/flokiorg/go-flokicoin/releases/download/v0.25.5-beta/flokicoind-windows-amd64-v0.25.5-beta.zip |

---

## 0.25.6-beta

Please report bugs using the issue tracker at GitHub:

https://github.com/flokiorg/go-flokicoin/issues

## Notable changes

- Update testnet3 and regression chain parameters.
- Adjust difficulty logic for testnet4.
- Restore default PoW limits for regression network.
- Update version bits deployment thresholds and timings.
- Remove legacy difficulty calculation fallback.
- Clean up block version test formatting.

## Assets

| OS/Arch | Asset |
| --- | --- |
| macOS (Apple Silicon) | https://github.com/flokiorg/go-flokicoin/releases/download/v0.25.6-beta/flokicoind-darwin-arm64-v0.25.6-beta.tar.gz |
| macOS (Intel) | https://github.com/flokiorg/go-flokicoin/releases/download/v0.25.6-beta/flokicoind-darwin-amd64-v0.25.6-beta.tar.gz |
| Linux x86_64 | https://github.com/flokiorg/go-flokicoin/releases/download/v0.25.6-beta/flokicoind-linux-amd64-v0.25.6-beta.tar.gz |
| Linux arm64 | https://github.com/flokiorg/go-flokicoin/releases/download/v0.25.6-beta/flokicoind-linux-arm64-v0.25.6-beta.tar.gz |
| Windows x86_64 | https://github.com/flokiorg/go-flokicoin/releases/download/v0.25.6-beta/flokicoind-windows-amd64-v0.25.6-beta.zip |

---

## 0.25.7-beta

Please report bugs using the issue tracker at GitHub:

https://github.com/flokiorg/go-flokicoin/issues

This is a minor beta release of Flokicoin Core with a new per-block difficulty retarget algorithm (Digishield-style), AuxPoW header and consensus support, testnet feature updates, RPC corrections, and build/test improvements. This release schedules `MAINNET ACTIVATION` for both Digishield and AuxPoW via chain parameters. All mainnet nodes must upgrade before the activation heights below to avoid chain splits.

## Notable changes

- Consensus: Digishield difficulty retarget
  - Introduces a per-block exponential moving average retarget toward the target spacing with amplitude divisor 8.
  - Applies bounded damping each step (min 0.75x, max 1.5x of target spacing influence) to reduce volatility.
  - Supports min-difficulty on late blocks where enabled by chain parameters.
  - Integrates into validation and mining (next-required-bits, block template target) and expands unit/full-block tests.

- P2P/Wire: AuxPoW header support
  - Adds AuxPoW structures (coinbase, merkle branches, parent header) and serialization helpers.
  - Extends `BlockHeader` with AuxPoW flag and ChainID utilities plus optional AuxPoW payload encode/decode.
  - Updates `MsgBlock` decoding to parse AuxPoW payloads when present; adds coverage for read/write paths.
  - Consensus: AuxPoW is activated on mainnet at the height listed below.

- Testnet/regtest updates
  - Enables SegWit and Taproot features on testnet where configured.
  - Tunes `MinHighPriority` and increases the `MaxLoki` bound used in RPC amount validation.

- RPC fixes and improvements
  - Aligns reported P2P protocol version with `wire.ProtocolVersion` and fills `getinfo` fields (subversion, localservices, connections_in/out, localaddresses) from live server state.

- Tooling and tests
  - Adds `make testexport` target and a deterministic test-data exporter.
  - Unifies block dataset loader with mandatory network-magic validation; refactors call sites.
  - Adds an end-to-end difficulty validation over curated datasets and emits steady-state tuning metrics.

- Build and configuration
  - Drops local `replace` override for `flokicoin-neutrino` to avoid developer-only paths.
  - Prints a single startup banner with semantic version during config load; refactors ASCII-art constants.

## Compatibility

- Mainnet will activate Digishield and AuxPoW at fixed heights (below). These are consensus changes and constitute a hard fork at activation. All miners, validators, and services must upgrade before those heights.
- AuxPoW wire support remains backward compatible for non-AuxPoW headers until activation height.
- No database format changes are introduced.

## Activation schedule (mainnet)

- Digishield difficulty retarget: activates at height 115,000 (`DigishieldActivationHeight` in `chaincfg/params.go`).
- AuxPoW consensus: activates at height 115,840 (`AuxpowHeightEffective` in `chaincfg/params.go`).

These activations are parameterized in `repos/flokiorg/go-flokicoin/chaincfg/params.go` under `MainNetParams`.

## Upgrade notices

- Mainnet node operators: upgrade to 0.25.7-beta before heights 115,000 (Digishield) and 115,840 (AuxPoW) to remain on the canonical chain.
- Testnet/regtest operators should upgrade to participate in the updated difficulty and feature policies.
- Application developers should re-vendor/update to pick up RPC schema fixes and wire additions related to AuxPoW.

## RPC changes

- `getinfo` now reports accurate `subversion`, `localservices`, `localservicesnames`, `connections_in`, `connections_out`, and `localaddresses`.
- Reported max protocol version aligns with `wire.ProtocolVersion` (70016).

## Build system and tooling

- New `make testexport` target to export block datasets for deterministic tests.
- Removed local `replace` for `flokicoin-neutrino` to produce clean module graphs in builds.

## Tests and QA

- Unified block loader enforces network magic and uses buffered, full-length reads.
- Added E2E difficulty validation with metrics output for steady-state analysis.
- Curated, smaller test datasets improve determinism and CI time.

## Changelog since [v0.25.6-beta](/lokichain/releases/0.25.6-beta)

- b4f439e consensus: add Digishield difficulty retarget
- dec0948 wire: integrate AuxPoW header support
- 31eff16 chore: repo updates for rpc/db, tests, fixtures
- e2ac6e7 tests: validate difficulty dataset and expose tuning metrics
- 735410f tests: unify block loader to enforce network magic; refactor call sites
- 0e5dcd3 make: add testexport target for exporting block datasets
- 651a453 rpc: report correct p2p protocol and fill getinfo fields
- bea6a7a build: drop local replace for flokicoin-neutrino
- 2e92497 config: print startup banner with version; refactor art constants
- b24e870 wire: remove stale TODO comment in protocol.go
- 60460f8 enable segiwit/taproot for testnet
- f9bf3ae increase maxloki const
- 712355d update MinHighPriority const
- fa96bbd bump version 0.25.7-dev
- 4523b79 version: bump to 0.25.7-beta

## Credits

Thanks to everyone who directly contributed to this release:

- naliyi
- izimmerma
- mechion
- repins
- nanovex
- liarpo11
- arowqo
- thiniboy

## Assets

| OS/Arch | Asset |
| --- | --- |
| macOS (Apple Silicon) | https://github.com/flokiorg/go-flokicoin/releases/download/v0.25.7-beta/flokicoind-darwin-arm64-v0.25.7-beta.tar.gz |
| macOS (Intel) | https://github.com/flokiorg/go-flokicoin/releases/download/v0.25.7-beta/flokicoind-darwin-amd64-v0.25.7-beta.tar.gz |
| Linux x86_64 | https://github.com/flokiorg/go-flokicoin/releases/download/v0.25.7-beta/flokicoind-linux-amd64-v0.25.7-beta.tar.gz |
| Linux arm64 | https://github.com/flokiorg/go-flokicoin/releases/download/v0.25.7-beta/flokicoind-linux-arm64-v0.25.7-beta.tar.gz |
| Windows x86_64 | https://github.com/flokiorg/go-flokicoin/releases/download/v0.25.7-beta/flokicoind-windows-amd64-v0.25.7-beta.zip |

---

## Release Notes

Flokicoin Core is the reference full node for the Lokichain. It validates blocks and transactions, enforces consensus, and exposes RPCs for wallets and services.

Please report bugs on GitHub:
https://github.com/flokiorg/go-flokicoin/issues

## Releases

- [0.25.7-beta](/lokichain/releases/0.25.7-beta)
- [0.25.6-beta](/lokichain/releases/0.25.6-beta)
- [0.25.5-beta](/lokichain/releases/0.25.5-beta)
- [0.25.1-beta](/lokichain/releases/0.25.1-beta)

---

## Gminer

:::warning[CPU miner notice]
Gminer is a CPU miner. CPU mining is only practical on test networks; on mainnet it is not competitive. Use GPU or scrypt ASIC for mainnet.
:::

This guide provides step-by-step instructions to download, configure, and begin mining Flokicoin with Gminer.

- [Download and Installation](#download-and-installation): Guide to download and install `gminer`
- [Configuration](#configuration): Instructions for configuring `gminer.conf`.
- [How to Run](#how-to-run): Guide to start mining Flokicoin.
- [Monitoring](#monitoring): Monitor mining performance and status information
- [Troubleshooting and recommendations](#troubleshooting-and-recommendations): Common issues and their solutions
- [Support](#support)
---

## Download and Installation

Download the latest miner release:

- Go to the [releases](https://github.com/flokiorg/grpc-miner/releases/tag/v0.1.1-beta) page.
- Download the version suitable for your operating system and architecture.

gminer is available on:
- Mac
- Linux
- Windows

### Install `gminer` on Mac
#### **Mac with apple silicon**
Download [gminer-darwin-arm64-v0.1.1-beta.tar.gz](https://github.com/flokiorg/grpc-miner/releases/download/v0.1.1-beta/gminer-darwin-arm64-v0.1.1-beta.tar.gz) then extract the archive:

```bash
tar -xvf gminer-darwin-arm64-v0.1.0-alpha.tar.gz
chmod +x gminer
```

#### **Mac with Intel chip**
Download [gminer-darwin-amd64-v0.1.1-beta.tar.gz](https://github.com/flokiorg/grpc-miner/releases/download/v0.1.1-beta/gminer-darwin-amd64-v0.1.1-beta.tar.gz) then extract the archive:

```bash
tar -xvf gminer-darwin-amd64-v0.1.0-alpha.tar.gz
chmod +x gminer
```
&nbsp;

### Install on Linux
Download [gminer-linux-amd64-v0.1.1-beta.tar.gz
](https://github.com/flokiorg/grpc-miner/releases/download/v0.1.1-beta/gminer-linux-amd64-v0.1.1-beta.tar.gz) then extract the archive:

```bash
tar -xvf gminer-linux-amd64-v0.1.0-alpha.tar.gz
chmod +x gminer
```

&nbsp;

### Install on Windows
Download [gminer-windows-386-v0.1.1-beta.zip](https://github.com/flokiorg/grpc-miner/releases/download/v0.1.1-beta/gminer-windows-386-v0.1.1-beta.zip) then extract the archive.

&nbsp;

## Configuration
Before running the miner, ensure a configuration file (`gminer.conf`) exists in the same directory as the `gminer` executable file. You can download a [sample config file](https://raw.githubusercontent.com/flokiorg/grpc-miner/refs/heads/main/sample-gminer.conf) from grpc-miner repository.

You need to update the following parameters:

**Mining pool endpoint**
```ini
pool = solo.example.com:5055
```

Find below the list of community-known pools:
| Author | Dev fee | Pool | Port |
| --- | --- | --- | --- |
| myf | - | gpool.myfloki.com | 5055 |

You’re encouraged to create your own pool, set a developer fee if desired, and share it with the Flokicoin community in **#Mining** channel on [Discord](https://flokicoin.org/discord).

**Mining addresses**

You can specify one or more mining addresses:
```ini
miningaddr = YOUR_FLOKICOIN_ADDRESS_1
miningaddr = YOUR_FLOKICOIN_ADDRESS_2
```

**Threads**

Set the number of CPU threads to dedicate for mining. By default, if unspecified, gminer uses all available threads.
```ini
threads = 16
```

&nbsp;

## How to run
**On Mac and Linux:** Navigate to the directory containing the extracted binary and run:

```bash
./gminer
```

💡 On macOS, authorize `gminer` by navigating to System Settings → Privacy & Security → General and click “Open Anyway” to trust the developer.

**On Windows:** Navigate to the directory containing the extracted `gminer.exe` and double-click it or run it from the command line:
```bash
gminer.exe
```

💡 If Windows Defender or another antivirus blocks `gminer.exe`, you might need to explicitly allow or unblock it.

&nbsp;

## Monitoring
You can monitor the mining performance and status directly in the terminal. The information includes:

- Hashrate
- Blocks found
- Possible errors

&nbsp;

## Troubleshooting and recommendations
- Verify that your `gminer.conf` file is in the correct directory and that pool addresses, mining addresses, and ports match your intended configuration.
- On macOS, authorize `gminer` in System Settings and mark the developer as trusted.
- Verify the server address and port in `gminer.conf`.
- Ensure your internet connection is active.
- Regularly update the `gminer` from the releases page.

&nbsp;

## Support
For further assistance, join the `#mining` channel in the [Flokicoin Discord Community](https://flokicoin.org/discord).

---

## Mining

## Overview
- Flokicoin uses proof‑of‑work with the scrypt algorithm and a 1‑minute target block interval.
- Auxiliary proof‑of‑work (AuxPoW, merge mining) is enabled from block 115,840, allowing Flokicoin to be merge‑mined alongside scrypt‑family networks (for example, Litecoin, Dogecoin) where pool support exists.
- On mainnet, effective mining requires GPU or scrypt ASIC hardware. CPU mining is only practical on test networks.

## Disclaimer

:::danger[Rule N°1: Zero-trust and sandbox first]
This page references third-party miners, pools, and guides.

- Verify binaries and checksums; prefer reproducible builds.
- Test in a sandbox or VM before production use.
- Keep miners isolated from wallets and any sensitive data.

Proceed carefully and assume untrusted defaults.
:::

## Parameters
- Algorithm: scrypt (PoW)
- Target block interval: 1 minute
- AuxPoW: active since block 115,840

## Hardware
- GPU: Use a scrypt‑capable miner for your vendor (e.g., ccminer‑family for NVIDIA). Tune power/thermals conservatively.
- ASIC: Scrypt ASICs (Litecoin‑class) deliver the best efficiency; follow vendor firmware and safety guidance.
- CPU: Testnet only. On mainnet, CPU hashrate is not competitive.

## Mining Modes
- Pool mining (recommended): Connect to a Stratum‑compatible pool to receive steady payouts. See [Pools](/mining/pools).
- Solo mining (advanced): Operate your own infrastructure and accept variance; ensure reliable connectivity and monitoring.
- Merge mining (AuxPoW): Mine a scrypt‑family parent chain (e.g., LTC/DOGE) on a pool that forwards AuxPoW to Flokicoin, or use a Flokicoin pool that integrates AuxPoW. Configuration varies by pool—follow the pool’s instructions.

## Getting Started
1. Choose hardware: scrypt‑capable GPU or scrypt ASIC.
2. Choose mode: a reputable pool (recommended) or solo.
3. Configure your miner for scrypt and Stratum per your pool’s guide (e.g., `stratum+tcp://host:port`, wallet address as username).
4. For merge mining, ensure your chosen scrypt‑family parent pool explicitly supports AuxPoW forwarding to Flokicoin and follow its aux configuration.

## Miners
- ccminer (NVIDIA): https://github.com/tpruvot/ccminer
- CGMiner (ASIC/GPU): https://github.com/ckolivas/cgminer
- BFGMiner (ASIC/GPU): https://github.com/luke-jr/bfgminer
- nevermore (GPU): https://github.com/brian112358/nevermore-miner
- cpuminer (CPU; testnet/learning only): https://github.com/pooler/cpuminer

## Testnet Mining
For learning and testing purposes, you can use a CPU miner on the testnet network:

- [Gminer](/mining/gminer): A CPU gRPC mining client  
- [Fminer](https://github.com/fpoolnet/fminer): A Stratum CPU mining client

## Security & Ops
- Isolate miners from wallets and personal machines; use dedicated hosts or containers.
- Keep firmware and miners up to date; monitor temperatures, hashrate, and rejects.
- Never expose miner dashboards or RPC to the public internet; use firewalls and VPNs.

## Support
Join the [#mining](https://flokicoin.org/discord) channel on Discord for help.

---

## Pools

:::danger[Disclaimer]
Pools and miners listed here are third‑party. Verify binaries and configs yourself and prefer sandboxed testing before production use.
:::

## Pools
- [fpool.net](https://fpool.net) Mining has never been so easy 🐟 (solo, PPLNS)
- [viaflc.com](https://viaflc.com) More Coins Same Power (PPLNS, merge-mining)

### Notes
- Mainnet: use GPU or scrypt ASIC. CPU mining is not competitive; reserve cpuminer for testnet or experimentation.
- AuxPoW: If the pool supports merge mining with a scrypt‑family parent and forwards AuxPoW to Flokicoin, follow the pool’s specific instructions. Details vary by pool.

## Stratum Basics
- URL: `stratum+tcp://POOL_HOST:PORT`
- Username: your Flokicoin payout address (or pool account)
- Password: often `x` or pool‑specific token

## Support
Join the [#mining](https://flokicoin.org/discord) channel on Discord for help.

---

## Resources

import resourcesImage from './resources.webp';
import Link from '@docusaurus/Link'; // eslint-disable-line no-unused-vars
import Heading from '@theme/Heading'; // eslint-disable-line no-unused-vars

<section className="resources-hero">
  
    
      
        
          Community Ecosystem • Maintained &amp; Supported
          <Heading as="h1">Lokichain Resources</Heading>
          
            Browse community explorers, faucets, mining pools, and helper tooling. Every link here is maintained by trusted operators to keep your nodes, tests, and monitoring on track.
          
          
            <Link className="button button--primary button--lg resources-cta" to="https://flokicoin.org/discord" target="_blank" rel="noreferrer">Suggest via Discord</Link>
            <Link className="button button--outline button--lg resources-cta-secondary" to="https://github.com/flokiorg/docs/edit/main/docs/resources/index.mdx" target="_blank" rel="noreferrer">Open a pull request</Link>
          
        
        
          
        
      
    
  
</section>

<section className="resources-section">
  
    
      <article className="resource-card resource-card--explorer">
        🔭
        <Heading as="h2">Network Explorers</Heading>
        Track blocks, transactions, and address balances on mainnet and testnet.
        
          <Link to="https://flokichain.info" target="_blank" rel="noreferrer">flokichain.info</Link> • Mainnet
          <Link to="https://testnet.flokichain.info" target="_blank" rel="noreferrer">testnet.flokichain.info</Link> • Testnet
        
      </article>

      <article className="resource-card resource-card--faucet">
        🎮
        <Heading as="h2">Faucet &amp; Mini-Game</Heading>
        Collect testnet coins by playing a short community mini-game.
        
          <Link to="https://lokirace.com" target="_blank" rel="noreferrer">lokirace.com</Link>
        
      </article>

      <article className="resource-card resource-card--mining">
        ⛏️
        <Heading as="h2">Mining Pool</Heading>
        Pool that accepts Lokichain workshares and offers both solo and shared payouts.
        
          <Link to="https://fpool.net" target="_blank" rel="noreferrer">fpool.net</Link> • Solo &amp; PPLNS
        
      </article>

      <article className="resource-card resource-card--tooling">
        🛠️
        <Heading as="h2">Community Tooling</Heading>
        Ready-to-run bundles and services that streamline node operations and improve everyday Lokichain workflows.
        
          <Link to="https://myfloki.com" target="_blank" rel="noreferrer">myfloki.com</Link> • Plug-and-play stack
        
      </article>
    
  
</section>

<section className="resources-footer">
  
    <Heading as="h2">Keep the list fresh</Heading>
    
      Run a new explorer, tooling bundle, or pool? Open a pull request or drop a link in <Link to="https://flokicoin.org/discord" target="_blank" rel="noreferrer">#builders on Discord</Link> and we’ll review it.
    
  
</section>

---

## tWallet

import Link from '@docusaurus/Link';

Welcome to tWallet — a terminal UI (TUI) wallet for Flokicoin focused on speed, clarity, and self-custody.

Two major lines are available:

- v1 (Neutrino light client): Latest, trust-minimized, no external Electrum server required.
- v0 (Electrum client): Legacy, requires you to point at an Electrum server.

If you’re unsure which to use, choose v1.

## What “t” stands for

“tWallet” is a TUI app. It runs in your terminal and keeps interactions efficient and scriptable. No browser, no heavyweight GUI.

:::note
Currently, tWallet is the only available wallet. More wallets will be listed here as they become available.
:::

{/* --- Responsive version chooser --- */}

  
    Choose your version
    
      <Link className="button button--primary" to="/wallets/twallet/v1" aria-label="Install v1 (Neutrino)">Install v1 (Neutrino)</Link>
      <Link className="button button--secondary" to="/wallets/twallet/v0" aria-label="Install v0 (Electrum)">Install v0 (Electrum)</Link>
    
  

## Versions

### v1 — Neutrino (recommended)

:::important
Have a [BIP39](https://bips.dev/39/) seed? Use v0 to restore. v1 does not import [BIP39](https://bips.dev/39/).
:::

Neutrino ([BIP157](https://bips.dev/157/)/[BIP158](https://bips.dev/158/)) downloads compact block filters and only fetches full blocks as needed.

- Trust-minimized: No third-party server dictates your view of the chain.
- Better privacy: Queries are not centralized on a single Electrum server.
- Simple setup: No Electrum URL to configure.

**What’s new in v1**
- Built-in FLND (Flokicoin Lightning Network Daemon) for integrated Lightning operations.
- Modern addresses: segwit ([BIP173](https://bips.dev/173/)) and taproot ([BIP341](https://bips.dev/341/), [BIP342](https://bips.dev/342/)).
- Seed format: aezeed (LND seed, new format). Not compatible with [BIP39](https://bips.dev/39/).

  
  
    <Link className="button button--primary button--lg section-footer__btn" to="/wallets/twallet/v1" aria-label="Install v1 (Neutrino)">Install v1</Link>
  

### v0 — Electrum (legacy)

v0 connects to an Electrum server you specify (a server indexes the chain and answers wallet queries).

- You must configure `electserver = <host>:<port>`.
- Public Electrum endpoints previously listed are deprecated; run your own or use a trusted provider.
- Trade-off: Simpler sync but you trust the server for your balance/tx history view.

**Limitations in v0**
- Addresses: legacy Flokicoin addresses only (no segwit/taproot generation).
- Seed format: [BIP39](https://bips.dev/39/) mnemonic (not compatible with v1’s aezeed).

  
  
    <Link className="button button--secondary button--lg section-footer__btn" to="/wallets/twallet/v0" aria-label="Install v0 (Electrum)">Install v0</Link>
  

## Support

For help, join the #tWallet channel on Discord: https://flokicoin.org/discord

<style>
{`
/* ---- Responsive version chooser ---- */
.version-chooser {
  margin: 1rem 0 1.5rem 0;
  border: 1px solid var(--ifm-toc-border-color);
  border-radius: 0.5rem;
  background: var(--ifm-background-surface-color);
}
.version-chooser__content {
  display: flex;
  flex-wrap: wrap;
  align-items: center;
  gap: .75rem;
  padding: .9rem 1rem;
}
.version-chooser__text {
  font-weight: 600;
  flex: 1 1 240px;
  min-width: 160px;
}
.version-chooser__actions {
  display: flex;
  gap: .5rem;
  flex: 1 1 auto;
  justify-content: flex-end;
}
.version-chooser__actions .button {
  white-space: nowrap;
}

/* Mobile: stack actions full width */
@media (max-width: 640px) {
  .version-chooser__actions {
    width: 100%;
    justify-content: stretch;
    flex-direction: column;
  }
  .version-chooser__actions .button {
    width: 100%;
    text-align: center;
  }
}

/* ---- Section footers ---- */
.section-footer {
  margin-top: 1rem;
}
.section-footer__divider {
  height: 2px;
  background: var(--ifm-color-emphasis-200);
  margin: 1.25rem 0 .9rem 0;
  border-radius: 1px;
}

/* Right-aligned on desktop, full-width on mobile */
.section-footer__actions {
  display: flex;
  justify-content: flex-end;
}
.section-footer__btn { /* allow full-width on small screens */
  max-width: 20rem;
}
@media (max-width: 640px) {
  .section-footer__actions {
    justify-content: stretch;
  }
  .section-footer__btn {
    width: 100%;
    max-width: none;
    text-align: center;
  }
}
`}
</style>

---

## 0.1.0-alpha

- This is a **pre-release** for testing and feedback.

## Assets

| OS/Arch | Asset |
| --- | --- |
| macOS (Apple Silicon) | https://github.com/flokiorg/tWallet/releases/download/v0.1.0-alpha/twallet-darwin-arm64-v0.1.0-alpha.tar.gz |
| macOS (Intel) | https://github.com/flokiorg/tWallet/releases/download/v0.1.0-alpha/twallet-darwin-amd64-v0.1.0-alpha.tar.gz |
| Linux x86_64 | https://github.com/flokiorg/tWallet/releases/download/v0.1.0-alpha/twallet-linux-amd64-v0.1.0-alpha.tar.gz |
| Linux arm64 | https://github.com/flokiorg/tWallet/releases/download/v0.1.0-alpha/twallet-linux-arm64-v0.1.0-alpha.tar.gz |
| Windows x86_64 | https://github.com/flokiorg/tWallet/releases/download/v0.1.0-alpha/twallet-windows-amd64-v0.1.0-alpha.zip |

---

## 0.1.1-alpha

- This is a **pre-release** for testing and feedback.
- Developers and early adopters are encouraged to **report issues**.
- Fee configuration options: `feeslow`, `feemedium`, `feefast`
- Renamed app data directory from `flcwallet` to `twallet`

## Assets

| OS/Arch | Asset |
| --- | --- |
| macOS (Apple Silicon) | https://github.com/flokiorg/tWallet/releases/download/v0.1.1-alpha/twallet-darwin-arm64-v0.1.1-alpha.tar.gz |
| macOS (Intel) | https://github.com/flokiorg/tWallet/releases/download/v0.1.1-alpha/twallet-darwin-amd64-v0.1.1-alpha.tar.gz |
| Linux x86_64 | https://github.com/flokiorg/tWallet/releases/download/v0.1.1-alpha/twallet-linux-amd64-v0.1.1-alpha.tar.gz |
| Linux arm64 | https://github.com/flokiorg/tWallet/releases/download/v0.1.1-alpha/twallet-linux-arm64-v0.1.1-alpha.tar.gz |
| Windows x86_64 | https://github.com/flokiorg/tWallet/releases/download/v0.1.1-alpha/twallet-windows-amd64-v0.1.1-alpha.zip |

---

## tWallet v0 (Electrum)

v0 is the legacy tWallet line. It connects to an Electrum server that indexes the blockchain and serves wallet queries.

## Electrum
- Electrum is a light-client protocol: the server maintains an index; clients query balances, history, and broadcast transactions.
- Simplicity: Quick to get started, minimal sync.
- Trade-offs: You trust the server’s view of the chain. Public servers also see your query patterns.

### Electrum Setup

:::note[Not a technical user or don’t want to deal with setup?]
Check out the community plug-and-play option: https://myfloki.com/operator
:::

:::tip
Need help or want a ready-made Electrum endpoint?  
Join the **Flokicoin Discord**; community members may share public Electrum instances.
👉 [Join Discord](https://flokicoin.org/discord)
:::

To use **tWallet v0**, you must run your own Electrum-compatible server.  
For Flokicoin, the reference implementation is [`flokicoin-electrs`](https://github.com/flokiorg/flokicoin-electrs), a fork of `electrs` that indexes the chain and serves both Electrum and [Esplora APIs](https://github.com/Blockstream/esplora/blob/master/API.md).

#### Requirements
- A **fully synced Flokicoin full node daemon** (`flokicoind`)  
- RPC credentials for your node (`rpcuser` / `rpcpassword`)  
- Disk space for the Electrum index database (`--db-dir`)  

#### Example run command
```bash
electrs -vvv \
  --network mainnet \
  --db-dir /data \
  --jsonrpc-import \
  --daemon-rpc-addr <FLOKICOIN_NODE_HOST>:15213 \
  --electrum-rpc-addr 0.0.0.0:50001 \
  --http-addr 0.0.0.0:3000 \
  --cookie <RPCUSER>:<RPCPASS> \
  --enable-json-rpc-logging \
  --index-unspendables
```

Replace:
- `<FLOKICOIN_NODE_HOST>` → hostname or IP of your `flokicoind`  
- `<RPCUSER>` / `<RPCPASS>` → your daemon RPC credentials  

Once running, point `twallet.conf` to your server:

```ini title="twallet.conf (example)"
electserver = 127.0.0.1:50001
```

## tWallet Limitations v0 vs v1

- Addresses: legacy Flokicoin address format only (no segwit/taproot generation).
- No built‑in Lightning daemon (FLND is not included).
- Seed format: [BIP39](https://bips.dev/39/) mnemonic (different from v1’s aezeed).

:::tip
Restoring an existing [BIP39](https://bips.dev/39/) seed? Use v0. v1 (aezeed) is not compatible with [BIP39](https://bips.dev/39/).
:::

**Status:** Public Electrum endpoints previously listed are deprecated. Prefer your own server or a trusted community provider.

## Install

Latest known v0 build: 0.1.1-alpha

| OS/Arch | Asset |
| --- | --- |
| macOS (Apple Silicon) | https://github.com/flokiorg/tWallet/releases/download/v0.1.1-alpha/twallet-darwin-arm64-v0.1.1-alpha.tar.gz |
| macOS (Intel) | https://github.com/flokiorg/tWallet/releases/download/v0.1.1-alpha/twallet-darwin-amd64-v0.1.1-alpha.tar.gz |
| Linux x86_64 | https://github.com/flokiorg/tWallet/releases/download/v0.1.1-alpha/twallet-linux-amd64-v0.1.1-alpha.tar.gz |
| Linux arm64 (Raspberry Pi) | https://github.com/flokiorg/tWallet/releases/download/v0.1.1-alpha/twallet-linux-arm64-v0.1.1-alpha.tar.gz |
| Windows x86_64 | https://github.com/flokiorg/tWallet/releases/download/v0.1.1-alpha/twallet-windows-amd64-v0.1.1-alpha.zip |

Extract and make the binary executable where applicable:

```bash
tar -xvf twallet-*.tar.gz
chmod +x twallet
```

## Configure

Create a `twallet.conf` next to the binary and point it to your Electrum server:

```ini title="twallet.conf (v0 minimal)"
electserver = electrum.example.com:50001
# timeout = 10s
```

Full sample (annotated):

```ini title="Full sample (v0)"
; Directory for the wallet database
; walletdir = /private/link/flc/db

; Network settings (only one can be true)
; If both regtest and testnet are false, mainnet will be used by default.
; Use the regression test network
; regtest = false
; Use the test network
; testnet = false

; Database connection timeout (in seconds)
timeout = 10s

; Electrum server configuration (host:port)
electserver = electrum.example.com:50001

# Fee for slow transactions (in loki/vB)
# feeslow = 1

# Fee for medium transactions (in loki/vB)
# feemedium = 2

# Fee for fast transactions (in loki/vB) # available on v0.1.1
# feefast = 3
```

## Run

On macOS/Linux:

```bash
./twallet
```

On Windows:

```powershell
twallet.exe
```

If your OS flags the binary, allow it explicitly.

## Releases

See the sidebar for the latest v0 release notes and assets.

## Security
- Back up your seed phrase (24 words recommended) and test recovery.
- Set a spending passphrase and lock your wallet when idle.
- Keep tWallet up to date: https://github.com/flokiorg/tWallet/releases

---

## 1.0.1-alpha

This is a **pre-release** for testing and feedback. Developers and early adopters are encouraged to **report issues**.

## Changes

- Registered the WalletKit gRPC service (`walletrpc.WalletKit`) so WalletKit endpoints are now available.

## Assets

| OS/Arch | Asset |
| --- | --- |
| macOS (Apple Silicon) | https://github.com/flokiorg/tWallet/releases/download/v1.0.1-alpha/twallet-darwin-arm64-v1.0.1-alpha.tar.gz |
| macOS (Intel) | https://github.com/flokiorg/tWallet/releases/download/v1.0.1-alpha/twallet-darwin-amd64-v1.0.1-alpha.tar.gz |
| Linux x86_64 | https://github.com/flokiorg/tWallet/releases/download/v1.0.1-alpha/twallet-linux-amd64-v1.0.1-alpha.tar.gz |
| Linux arm64 | https://github.com/flokiorg/tWallet/releases/download/v1.0.1-alpha/twallet-linux-arm64-v1.0.1-alpha.tar.gz |
| Windows x86_64 | https://github.com/flokiorg/tWallet/releases/download/v1.0.1-alpha/twallet-windows-amd64-v1.0.1-alpha.zip |

---

## 1.0.2-alpha

- This is a **pre-release** for testing and feedback.
- Developers and early adopters are encouraged to **report issues**.

## Assets

| OS/Arch | Asset |
| --- | --- |
| macOS (Apple Silicon) | https://github.com/flokiorg/tWallet/releases/download/v1.0.2-alpha/twallet-darwin-arm64-v1.0.2-alpha.tar.gz |
| macOS (Intel) | https://github.com/flokiorg/tWallet/releases/download/v1.0.2-alpha/twallet-darwin-amd64-v1.0.2-alpha.tar.gz |
| Linux x86_64 | https://github.com/flokiorg/tWallet/releases/download/v1.0.2-alpha/twallet-linux-amd64-v1.0.2-alpha.tar.gz |
| Linux arm64 | https://github.com/flokiorg/tWallet/releases/download/v1.0.2-alpha/twallet-linux-arm64-v1.0.2-alpha.tar.gz |
| Windows x86_64 | https://github.com/flokiorg/tWallet/releases/download/v1.0.2-alpha/twallet-windows-amd64-v1.0.2-alpha.zip |

---

## 1.0.3-alpha

This is a **pre-release** for testing and feedback. Developers and early adopters are encouraged to **report issues**.

## Changelog

- Migrated backend from **Electrum** to **Neutrino**
- Integrated **Flokicoin Lightning Node (LN)** with full LN stack support
- Enables **native Lightning development** on the Flokicoin network
- Added configurable address types: `segwit`, `nested-segwit`, `taproot`
- Introduced secure wallet locking/unlocking and password change UI
- Improved transaction builder with live fee estimation
- Enhanced **balance display** with confirmed and unconfirmed amounts
- Enhanced terminal UI with sync status, LN health, and live updates
- Major internal refactor for modular config, stability, and future expansion

## Assets

| OS/Arch | Asset |
| --- | --- |
| macOS (Apple Silicon) | https://github.com/flokiorg/tWallet/releases/download/v1.0.3-alpha/twallet-darwin-arm64-v1.0.3-alpha.tar.gz |
| macOS (Intel) | https://github.com/flokiorg/tWallet/releases/download/v1.0.3-alpha/twallet-darwin-amd64-v1.0.3-alpha.tar.gz |
| Linux x86_64 | https://github.com/flokiorg/tWallet/releases/download/v1.0.3-alpha/twallet-linux-amd64-v1.0.3-alpha.tar.gz |
| Linux arm64 | https://github.com/flokiorg/tWallet/releases/download/v1.0.3-alpha/twallet-linux-arm64-v1.0.3-alpha.tar.gz |
| Windows x86_64 | https://github.com/flokiorg/tWallet/releases/download/v1.0.3-alpha/twallet-windows-amd64-v1.0.3-alpha.zip |

---

## 1.0.4-beta

Please report bugs using the issue tracker on GitHub:  
https://github.com/flokiorg/tWallet/issues

## Changes

### Dependencies
- Updated `go-flokicoin` → **[v0.25.7-beta](/lokichain/releases/0.25.7-beta)**
- Updated `flokicoin-neutrino` → **v0.16.2-beta**
- Updated `walletd` → **v0.1.3-beta**

### Fixes
- General bug fixes and stability improvements  
- Improved reliability of status handling during sync/init  

## Notes
- This release aligns with the latest upstream library updates  
- Users are encouraged to upgrade for better stability and compatibility

## Assets

| OS/Arch | Asset |
| --- | --- |
| macOS (Apple Silicon) | https://github.com/flokiorg/tWallet/releases/download/v1.0.4-beta/twallet-darwin-arm64-v1.0.4-beta.tar.gz |
| macOS (Intel) | https://github.com/flokiorg/tWallet/releases/download/v1.0.4-beta/twallet-darwin-amd64-v1.0.4-beta.tar.gz |
| Linux x86_64 | https://github.com/flokiorg/tWallet/releases/download/v1.0.4-beta/twallet-linux-amd64-v1.0.4-beta.tar.gz |
| Linux arm64 | https://github.com/flokiorg/tWallet/releases/download/v1.0.4-beta/twallet-linux-arm64-v1.0.4-beta.tar.gz |
| Windows x86_64 | https://github.com/flokiorg/tWallet/releases/download/v1.0.4-beta/twallet-windows-amd64-v1.0.4-beta.zip |

---

## 1.0.5-beta

Please report bugs using the issue tracker on GitHub:  
https://github.com/flokiorg/tWallet/issues

## Changes

### Dependencies
- Updated `flokicoin-neutrino` → **v0.16.3-beta**

### Fixes
- Depends on neutrino with params‑sourced filter checkpoints.

## Notes
- This release aligns with the latest upstream library updates  
- Users are encouraged to upgrade for better stability and compatibility

## Assets

| OS/Arch | Asset |
| --- | --- |
| macOS (Apple Silicon) | https://github.com/flokiorg/tWallet/releases/download/v1.0.5-beta/twallet-darwin-arm64-v1.0.5-beta.tar.gz |
| macOS (Intel) | https://github.com/flokiorg/tWallet/releases/download/v1.0.5-beta/twallet-darwin-amd64-v1.0.5-beta.tar.gz |
| Linux x86_64 | https://github.com/flokiorg/tWallet/releases/download/v1.0.5-beta/twallet-linux-amd64-v1.0.5-beta.tar.gz |
| Linux arm64 | https://github.com/flokiorg/tWallet/releases/download/v1.0.5-beta/twallet-linux-arm64-v1.0.5-beta.tar.gz |
| Windows x86_64 | https://github.com/flokiorg/tWallet/releases/download/v1.0.5-beta/twallet-windows-amd64-v1.0.5-beta.zip |

---

## tWallet v1 (Neutrino)

v1 is the recommended tWallet line. It uses the Neutrino light‑client protocol ([BIP157](https://bips.dev/157/)/[BIP158](https://bips.dev/158/)) to sync without relying on a third‑party Electrum server.

## Capabilities

- Built‑in FLND (Flokicoin Lightning Network Daemon) for integrated Lightning operations.
- Address types: segwit ([BIP173](https://bips.dev/173/)) and taproot ([BIP341](https://bips.dev/341/), [BIP342](https://bips.dev/342/)).
- Seed format: aezeed (LND seed, new format) for backup and recovery.

:::note
Default address type is `segwit`. You can switch via `addresstype=segwit|nested-segwit|taproot` in `twallet.conf`.
:::

:::important
Seed compatibility: v1 uses aezeed and cannot import [BIP39](https://bips.dev/39/) mnemonics. To restore a [BIP39](https://bips.dev/39/) seed, use v0 (Electrum) instead.
:::

Why Neutrino
- Built-in: Neutrino is integrated directly into tWallet, no external server required.
- Trust‑minimized: You verify headers and use compact block filters; no single server dictates your view of the chain.
- Privacy: Queries are not centralized at an Electrum server.

## Install

:::tip
Install via [myFloki plug-and-play](https://myfloki.com):
```bash
sh -c "$(curl -fsSL https://raw.githubusercontent.com/myfloki/community-tools/main/downloader.sh)"
```

After installation, run `twallet`.  
See [myfloki.com](https://myfloki.com) for details on the bundled components.
:::

Download the latest v1 release assets from GitHub and extract them.

Latest known build: **1.0.5-beta**
Latest known build: 1.0.5-beta

| OS/Arch | Asset |
| --- | --- |
| macOS (Apple Silicon) | https://github.com/flokiorg/tWallet/releases/download/v1.0.5-beta/twallet-darwin-arm64-v1.0.5-beta.tar.gz |
| macOS (Intel) | https://github.com/flokiorg/tWallet/releases/download/v1.0.5-beta/twallet-darwin-amd64-v1.0.5-beta.tar.gz |
| Linux x86_64 | https://github.com/flokiorg/tWallet/releases/download/v1.0.5-beta/twallet-linux-amd64-v1.0.5-beta.tar.gz |
| Linux arm64 (Raspberry Pi) | https://github.com/flokiorg/tWallet/releases/download/v1.0.5-beta/twallet-linux-arm64-v1.0.5-beta.tar.gz |
| Windows x86_64 | https://github.com/flokiorg/tWallet/releases/download/v1.0.5-beta/twallet-windows-amd64-v1.0.5-beta.zip |

Extract and make the binary executable where applicable:

```bash
tar -xvf twallet-*.tar.gz
chmod +x twallet
```

## Configure

Create a `twallet.conf` file next to the binary or in your app data directory. Minimal example:

```ini title="twallet.conf (v1 minimal)"
# walletdir = ./loki
# addresstype = segwit          # segwit | nested-segwit | taproot
# feeurl = https://flokichain.info/api/v1/fees/recommended
# debuglevel = info
# connectiontimeout = 50s
# rpclisten = 127.0.0.1:10005   # RPC API
# restlisten = 127.0.0.1:5050   # REST API
# restcors = *                  # CORS for REST API
```

Full sample (annotated):

```ini title="Full sample (v1)"
; Directory for the wallet database
# walletdir = ./loki

; Network settings (only one can be true)
; If both regtest and testnet are false, mainnet will be used by default.
; Use the regression test network
; regtest = false
; Use the test network
; testnet = false

; The timeout value for network connections {ms, s, m, h}
; Default is '50s'
;connectiontimeout = 50s

; Logging level for all subsystems {trace, debug, info, warn, error, critical}
; Default is 'info'
;debuglevel=info

; Connect only to the specified peers at startup
; connect=node.example.org

; Use default passphrase for locking (TESTING ONLY, DO NOT USE IN MAINNET OR PRODUCTION ENVIRONMENTS)
# defaultpassword=pass

; Address type to generate (taproot, segwit, or nested-segwit)
; Default is 'segwit'
# addresstype=segwit

; Custom fee estimation API endpoint (Recommended on mainnet)
# feeurl=https://flokichain.info/api/v1/fees/recommended

; Adds an extra IP to the generated certificate. One IP per line.
# tlsextraip=0.0.0.0

; Adds an extra domain to the generated certificate. One domain per line.
# tlsextradomain=localhost

; Re-generate TLS certificate and key if the IPs or domains are changed.
# tlsautorefresh=true

; Add an interface/port/socket to listen for RPC connections.
; One listen address per line. Example: rpclisten=0.0.0.0:10005
# rpclisten=0.0.0.0:10005

; Add an interface/port/socket to listen for REST connections.
; One listen address per line. Example: restlisten=0.0.0.0:5050
# restlisten=0.0.0.0:5050

; Add an interface/port to listen for peer connections.
; One listen address per line. Example: listen=0.0.0.0:5521
# listen=0.0.0.0:5521

; Add an ip:port or hostname to allow cross-origin access to the REST API.
; One entry per line. To allow all origins, use: restcors=*
; Examples:
; restcors=http://localhost:3000
; restcors=https://mydomain.com
# restcors=*
```

## Run

On macOS/Linux:

```bash
./twallet
```

On Windows:

```powershell
twallet.exe
```

If your OS flags the binary, allow it explicitly.

## Releases

See the sidebar for the latest v1 release notes and assets.

## Security
- Back up your seed phrase (24 words recommended) and test recovery.
- Set a spending passphrase and lock your wallet when idle.
- Keep tWallet up to date: https://github.com/flokiorg/tWallet/releases

---

## The WoF Paper

import wofBookImage from './wof_book.png';
import Heading from '@theme/Heading'; // eslint-disable-line no-unused-vars

  
    <Heading as="h2" id="overview">Overview</Heading>
    <blockquote>
      “You never change things by fighting the existing reality. To change something, build a new model that makes the existing model obsolete.” — Buckminster Fuller
    </blockquote>
    
       The internet’s first age connected peers and shared static pages. Services followed, shaped by centralized interfaces that traded convenience for control over our data. Bitcoin reintroduced a public, decentralized mindset, yet the promise of Web3 tangled with speculation, token printing, and platforms that owned the experience.
    
    
WoF is the movement to build the next web by redesigning everyday services so people decide how their data, identity, engagement, and contributions circulate in a work-based economy. If you believe the web can be cooperative, trustless, and permissionless, you belong here.
   

:::warning[Asking about Flokicoin and WoF?]
WoF stands on its own—no coin, no chain, a movement to reimagine the web through [FEPs](#what-is-a-fep).
:::

 
  
  <figure className="wofOverview__figure">
    
    <figcaption className="wofBookCaption">
      
        The next web is transforming energy into shared value and returning ownership to its source.
      
    </figcaption>
  </figure>

## Web2, Web3… and the Next Web

- **Web1** let us publish static pages, but expression was limited.
- **Web2** layered rich interfaces, yet every login, review, and dataset collapsed into walled platforms hungry for our data.
- **Bitcoin** showed a different path. Value could move without middlemen.
- **Web3** made wallets and tokens mainstream but mostly printed assets around the same middlemen; everyday web engagements never changed.

WoF is the reset button. We focus on everyday internet services—maps, messaging, media, commerce—and reimagine them with transparent economics, data ownership, sovereign identity, cohesive collaboration, and measurable engagement. The goal isn’t to decorate the old web; it’s to invent a humane one.

## Why Nostr + POW Are WoF’s Backbone

Most people hear “[Nostr](https://jump.ohstr.com/)” and picture a decentralized social app popularized by Jack Dorsey. In reality, Nostr is a lightweight communication layer—think of it as HTTP for the next web: simple, open, and portable. Proof-of-work is the economic layer that keeps that next web honest. You either spend previously earned work-backed coins to access services, or you contribute fresh work that other people can rely on.

Core principles WoF leans on:

- **Proof-of-work**: offerings price access in energy-backed coins—people can spend previously mined work or pick up new work to earn their way in.
- **Keys as identity**: public/private pairs replace platform-bound usernames, keeping reputation portable.
- **Signed notes**: every interaction is an immutable, timestamped event any client can read, verify, or extend.
- **Relay choice**: participants pick or run relays to route events, so no single intermediary controls communication.

WoF builds on Nostr so every service speaks the same language from day one, and on proof-of-work so every economic promise traces back to real effort. Communication, coordination, and engagement travel through Nostr, while pricing, access, and governance lean on verifiable work.

## What is a FEP?

**FEP** stands for **Fun Enhancement Possibility**.
A FEP is WoF’s proposal blueprint. It lays out the experience issues you want to ease, the journey you’re inviting people into, and the economy that will support it.

It’s not a feature request.
It’s not a pump scheme.
It’s a design challenge that invites anyone to remix the rules of the web.

A clear FEP usually covers:

- What’s happening today and what you want to redesign.
- Who’s involved now and how their experience improves.
- The economic design: how value circulates, what work backs it, and how participants stay aligned.
- The Nostr primitives or new NIP drafts the service depends on.

It isn’t a roadmap—it’s a launchpad. Submit your FEP and let’s buckle in.

:::tip[Need a concrete example?]
Check the [Sharenote case study](/wof/sharenote) for how one mining service is taking shape.
:::

## Who WoF is For

  
    
      <Heading as="h3">Builders</Heading>
      
        Prototype services on top of the Nostr protocol, proof-of-work incentives, and expressive UX that hand ownership back to people.
      
    
  
  
    
      <Heading as="h3">Marketers</Heading>
      
        Craft narratives, campaigns, and rituals that onboard everyday users into decentralized services without losing their sense of wonder.
      
    
  
  
    
      <Heading as="h3">Infrastructure Backers</Heading>
      
        Spot teams and concepts worth funding early. Use FEPs to evaluate adoption models, work-based economies, and resilient infrastructure bets.
      
    
  
  
    
      <Heading as="h3">Donors</Heading>
      
        Fund experiments that create public goods, art, or education. Help teams cross the gap from idea to live prototype with mission-aligned resources.
      
    
  

## Why Build on Top, Not Against?

We’re not here to torch the current web. The habits, networks, and tooling people rely on every day are the launch ramps for what comes next. WoF experiments extend what already works instead of forcing everyone to migrate overnight.

We build on top because:

- **Familiar entry points** let people try new experiences without abandoning their existing workflows.
- **Incremental upgrades** allow teams to ship, measure, and iterate faster than a ground-up rewrite.
- **Interoperability** keeps bridges open between legacy services.

That is why WoF projects plug into today’s services, add transparent communication through Nostr, and weave in work-backed incentives. Evolution beats isolation.

## Ready to Submit Your First FEP?

Start with a question:
> *“Wouldn’t it be fun if…?”*

Sketch the outline using the FEP checklist above, then publish it where the community already gathers. Use the discussion to refine the idea, gather feedback, and find collaborators who want to explore it with you.

Because the only thing better than **thinking outside the box** is **turning the box into a game console**.

:::note[Need a starting point?]
Join the WoF Discord and drop into the discussion channels to swap notes and sharpen your concept.
:::

# WoF is Not a Feature. It’s a Philosophy.

If you're here to speculate, that's okay.
If you're here to innovate — welcome home.

Let’s make the web courageous again.
Let’s make online life resilient again.
Let’s build with intention.

**Let’s create Fun on Purpose.**

- Join the #WoF Discord forum. Post a FEP.
- Launch an experiment.
- And above all—**don’t ask for permission. Ask: what’s the most meaningful move we could make right now?**

---

## Sharenote

import ScratchReveal from '@site/src/components/ScratchReveal'; // eslint-disable-line no-unused-vars

## Abstract

Sharenote is a miner-controlled proof-of-work note: every accepted share mints a signed sharenote, a bearer record of the work the miner resolved. Sharenotes can be spent on social engagements, resolving coin-mining blocks, buying intelligence, and more. Miners keep control of template selection and payout accounting. Learn more at [sharenote.xyz](https://sharenote.xyz).

## Motivation

Even with hashpower growing, miners still rely on a handful of work-provider giants (<ScratchReveal>Foundry USA</ScratchReveal> · <ScratchReveal>AntPool</ScratchReveal> · <ScratchReveal>F2Pool</ScratchReveal> · <ScratchReveal>ViaBTC</ScratchReveal>). Two glaring issues stand out:

**Opaque payouts**
- Outside of solo mining, miners rarely know how their submitted shares translate into rewards. Payout logic lives inside proprietary dashboards.
- Third-party tools estimate earnings, yet miners must trust that their shares were counted correctly, not reprioritized for another client.

**Hidden block-template value**
- Pools can embed auxiliary chains or custom policies into block templates without disclosing the additional rewards.
- Miners have no channel to inspect or propose changes before work is assembled, even if extra value is minted using their hashpower.

WoF aims to redesign everyday internet services around Nostr and work-backed incentives. Without transparent payouts and templates, miners stay dependent on centralized work providers, undermining WoF’s mission of participant-controlled engagement.

## Sharenote Concept Summary (Draft)

Sharenote acts as the connective tissue between the Web of Fun (WoF) vision for playful, work-backed services and the daily routines of miners. Each accepted share becomes a signed receipt the miner can point to, redirect, or burn. The receipt is a sharenote: tangible proof that computational work happened and a programmable ticket that can be spent on social engagements, resolving coin-mining blocks, buying intelligence, and more.

The lifecycle is intentionally simple:
- **Mint** – The miner accepts a template from a work provider, performs the hashing work, and sees the resulting share captured as a sharenote.
- **Record** – A sidecar app signs the sharenote and publishes it as a Notes and Other Stuff Transmitted by Relays (Nostr) event so anyone the miner authorizes can audit the stream.
- **Spend** – The miner redeems the sharenote for social engagements, resolving coin-mining blocks, buying intelligence, and more; burns it; or keeps it as an auditable receipt for payouts.

Sharenote keeps the miner, not the pool, in the driver’s seat. Miners can compare templates, track how many sharenotes each template minted, and decide which ones to support. Pool operators gain a channel to publish template changes, payout adjustments, and anomaly alerts without leaving the miner guessing. Observers—wallet builders, accounting tools, or community auditors—can follow the Nostr feed to build dashboards without depending on closed dashboards or web scraping.

Because this Fun Enhancement Possibility (FEP) is still a draft, Sharenote sticks to a Without Breaking Existing Things (WBET) rollout. Stratum traffic keeps flowing, and the sidecar listens in, signs shares, and broadcasts them without interrupting the main client. That incremental path lets miners test Sharenote privately, pool by pool, before committing to public relays or template governance rituals.

## Status & Next Steps

Sharenote is currently a draft FEP. Immediate work includes:
- Finalizing the NIP references or creating a new NIP for Sharenote-specific events.
- Building a prototype relay/client stack to test with a volunteer pool.
- Following the WBET stage so Sharenote keeps working cleanly alongside existing mining workflows.

If you want to participate, drop into the WoF Discord (#WoF) and look for the Sharenote thread.
Learn more at [sharenote.xyz](https://sharenote.xyz).