iuna

iuna - experimental devnet protocol
git clone https://iuna.jhx.app/git/iuna.git
Log | Files | Refs | README | LICENSE

README.md (4223B)

      1 # iuna
      2 
      3 iuna is an experimental cryptocurrency devnet.
      4 
      5 It combines three ideas:
      6 
      7 - **VDF finalization:** each block waits on verifiable sequential delay work.
      8 - **Burn lottery:** nodes burn IUNA to enter the lottery for who may finalize the next block.
      9 - **Proof-of-work issuance:** new IUNA is created through open PoW mine actions.
     10 
     11 ## Status
     12 
     13 iuna is still in development. It is not a mainnet, not money, and not something to treat as financially valuable yet.
     14 
     15 The goal right now is to run a real test network, improve the wallet and node software, and learn how the protocol behaves with real users.
     16 
     17 ## Why Another Crypto?
     18 
     19 Most chains lean heavily on one scarce resource:
     20 
     21 - Proof-of-work chains rely on hashpower.
     22 - Proof-of-stake chains rely on existing stake.
     23 
     24 iuna tries a different split. Finalization is lightweight and based on a burn lottery plus VDF timing, while new supply stays open to proof-of-work. Burns do not remove wealth advantage, but they make finalization power temporary and repeatedly paid for instead of a permanent stake position. The intended benefit is better decentralization pressure than pure PoW or pure PoS: finalizing blocks should not require owning specialized mining scale, and burn-based timing power should expire instead of accumulating into lasting control.
     25 
     26 This is still an experiment. The design needs real-world testing before those goals can be treated as proven.
     27 
     28 ## Install
     29 
     30 The simplest way to run iuna is:
     31 
     32 1. Go to [iuna.jhx.app/downloads/](https://iuna.jhx.app/downloads/).
     33 2. Download the latest available build.
     34 3. Start the app or binary.
     35 4. Follow the setup screen.
     36 
     37 The setup flow helps you create or import a wallet, back up your recovery phrase, and connect to the devnet.
     38 
     39 You do not need Rust or Cargo unless you want to work on the code.
     40 
     41 ## Source
     42 
     43 The public source browser is published at [iuna.jhx.app/git/iuna/](https://iuna.jhx.app/git/iuna/).
     44 
     45 Clone the static HTTP repo with:
     46 
     47 ```sh
     48 git clone https://iuna.jhx.app/git/iuna.git
     49 ```
     50 
     51 ## Static Site Image
     52 
     53 The Docker image publishes the website, a static git browser, a clonable HTTP repo, and release downloads.
     54 
     55 ```sh
     56 docker build -t iuna-static-site:test .
     57 docker run --rm -p 8080:80 iuna-static-site:test
     58 ```
     59 
     60 The deployment script builds Linux CLI archives for x86_64 and aarch64, builds the macOS desktop artifact on Apple silicon, and tries to cross-build the Windows NSIS installer in Docker. Prebuilt desktop artifacts can still be added before the image build:
     61 
     62 - `downloads/iuna-v0.3.0-macos-aarch64-desktop.app.zip`
     63 - `downloads/iuna-v0.3.0-windows-x86_64-desktop-setup.exe`
     64 
     65 Release and deploy with:
     66 
     67 ```sh
     68 ./deployment.sh 0.2.48
     69 ```
     70 
     71 Deployment publishes two images to the `jhx-app` k3s cluster:
     72 
     73 - `https://iuna.jhx.app/` routes to the static website image.
     74 - `https://admin.iuna.jhx.app/` routes to the node management UI.
     75 - `iuna.jhx.app:9444` routes to the node P2P listener.
     76 
     77 Useful overrides:
     78 
     79 ```sh
     80 IUNA_DEPLOY_HOST=root@jhx.app IUNA_KUBECTL_CONTEXT=jhx-app ./deployment.sh 0.2.48
     81 ```
     82 
     83 ## What You Can Run
     84 
     85 You can use iuna as a wallet, a node, or a public peer.
     86 
     87 - **Wallet:** send, receive, and inspect activity.
     88 - **Node:** keep a local chain copy and participate in mining/finalization settings.
     89 - **Public peer:** same as a node, but reachable by other nodes through a public P2P address.
     90 
     91 Keep the management UI local. Only the P2P listener should be reachable by other nodes.
     92 
     93 ## Optional: CLI
     94 
     95 Release archives also include a command-line binary.
     96 
     97 On macOS or Linux:
     98 
     99 ```sh
    100 chmod +x ./iuna
    101 ./iuna
    102 ```
    103 
    104 On Windows PowerShell:
    105 
    106 ```powershell
    107 .\iuna.exe
    108 ```
    109 
    110 The binary prints a local management URL. Open it and follow setup.
    111 
    112 ## Optional: Stratum Mining
    113 
    114 iuna can expose a Stratum V1 endpoint for SHA-256 ASIC miners such as a Bitaxe:
    115 
    116 ```sh
    117 ./iuna --stratum <bind-address>:<port>
    118 ```
    119 
    120 Use your iuna wallet address as the worker username. Accepted shares become PoW mine actions in the node mempool and are gossiped to peers.
    121 
    122 ## Contributing
    123 
    124 We are open to PRs and help running, testing, and improving the devnet.
    125 
    126 See [THANKS.md](THANKS.md) for people who have helped test and improve iuna.
    127 
    128 ## License
    129 
    130 iuna is licensed under the Apache License 2.0. See `LICENSE`.