@orexdotrun/orex
v1.0.3
Published
Mine OREX from your terminal
Downloads
2,498
Maintainers
Readme
What is OREX?
OREX is a mining network you join with one command. There are no rigs to buy, no pools to configure and no upgrades for sale: your computer does real proof-of-work, and every minute a fixed amount of OREX is split between everyone who mined in that minute, by the work they did.
- Any CPU. Laptop, desktop or server. Difficulty adjusts to your machine automatically.
- Fixed supply. 50 million OREX in total, with emission halving every 30 days.
- Fair split. More miners never print more OREX; they share the same amount.
- Wallet account. Sign in with your wallet. No email, no password.
Quick start
You need Node.js 18 or newer.
# 1. Install the CLI
npm install -g @orexdotrun/orex
# 2. Log in (opens your browser to approve this terminal)
orex login
# 3. Start mining
orex mineOn first login, connect your wallet at orex.run. Your terminal shows a code like KQ7M-3XPA; check that the browser shows the same code, then click Authorize.
Commands
| Command | What it does |
|---|---|
| orex login | Log in through the browser (or paste an API key from the dashboard) |
| orex mine [-t N] | Start mining with N threads (default: all cores minus one) |
| orex status | Show your balance, total earned and hashrate |
| orex logout | Remove the API key from this computer |
| orex help | Show all commands |
While mining, the terminal shows a live dashboard: hashrate, the current job, the round countdown, your estimated share of this round and your last payout. Press Ctrl+C to stop and see a session summary.
How it works
your terminal OREX network
┌──────────────┐ 1. get a job ┌──────────────────┐
│ orex mine │ ◄────────────────── │ challenge + │
│ │ │ difficulty │
│ CPU threads │ 2. find a nonce │ │
│ hash, hash, │ sha256(...) │ │
│ hash ... │ │ │
│ │ 3. submit share │ verify with one │
│ │ ──────────────────► │ hash, record work│
└──────────────┘ └────────┬─────────┘
│ every 60 s
▼
┌────────────────────┐
│ round payout: │
│ fixed emission │
│ split by work │
└────────────────────┘- The CLI asks for a job: a random challenge and a difficulty.
- Your CPU threads search for a nonce so that
sha256(challenge + nonce)starts with enough zero bits. - The CLI submits it. The server checks it with a single hash and records the work it represents.
- Every 60 seconds the round closes and its emission is split between the round's miners, in proportion to their work.
Economy at a glance
| | | |---|---| | Max supply | 50,000,000 OREX | | Round length | 60 seconds | | Emission at launch | ~578.7 OREX per minute | | Halving | every 30 days | | Empty rounds | release nothing | | Paid upgrades | none |
| Period | Per minute | Released | Total so far | |---|---|---|---| | Month 1 | 578.70 | 25,000,000 | 25,000,000 | | Month 2 | 289.35 | 12,500,000 | 37,500,000 | | Month 3 | 144.68 | 6,250,000 | 43,750,000 | | Month 4 | 72.34 | 3,125,000 | 46,875,000 | | Month 5 | 36.17 | 1,562,500 | 48,437,500 | | … | halves again | … | approaches 50,000,000 |
Early miners earn the most. Live numbers: orex.run/economy.
Fair play
- Work-based split. Running 100 accounts on one computer earns the same as one account, because the CPU is shared.
- Per-network limit. At most 3 accounts can mine at the same time from one IP address.
- Human check. The miner asks a short question when it starts and about every 30 minutes.
- Server-side checks. Every share is verified by the server, and every job can be used only once.
Security
- HTTPS only. The CLI talks to the network only over HTTPS.
- API key stays local. It is stored in
~/.orex/config.json, readable only by you. If it leaks, regenerate it on the dashboard and the old key stops working immediately. - Login confirmation. Browser login shows the code and the network the request came from, and warns if it differs from yours.
- Withdrawal signatures. Withdrawals, when they launch, will require a signature from your wallet, so an API key alone can never move your OREX.
Withdrawals
Coming soon. Mined OREX stays on your account and will be withdrawable as a token on Robinhood Chain to the wallet you connected with.
FAQ
Do I need a GPU? No. OREX is built for ordinary CPUs and there is nothing to buy.
Why did my earnings per minute go down? Either more miners joined (the same amount split more ways) or a halving happened.
Can I mine on several computers? Yes, with the same account. Each computer adds its work to your share.
What happens when I stop mining? You stop earning. A round only pays the miners who submitted work during it.
Is mining going to hurt my computer?
It uses your CPU like any heavy program. Use orex mine -t 2 to leave more cores free.
