From nothing to your first ORN

Open a terminal and paste one line. It picks the right version for your computer and checks it before installing.

Then open a new terminal window, so it can find orien.

You get an address to be paid at, and a recovery phrase: 24 words that can rebuild your wallet on any computer. Write them on paper and keep them safe. You can also choose a password, so that a copy of your wallet file is useless to anyone else.

Anyone who sees your 24 words can take your coins. Never type them into a website, and never give them to anyone, an AI assistant included.

Your computer starts doing proof-of-work. Every hour, the new ORN released in that hour are shared out among everyone who mined, in proportion to the work they did. It keeps going until you press Ctrl-C.

A payment is final in a fraction of a second. It pays a fee of 0.1% of the amount, never more than 1 ORN. Payments cannot be undone, so check the address before you send.

This teaches Claude Code and Codex to use orien for you. Start a new conversation and ask in plain words: “what’s my ORN balance?”, “send 5 ORN to Bob”, “start mining on this computer”. It asks before every payment, and never sees your 24 words or your password.

If your wallet has a password, let the assistant send for a while, up to an amount you choose. It can then send without ever learning the password:

End it early with orien lock. For another assistant, orien skill install --dir FOLDER puts the skill in its skills folder.

Type your 24 words when asked. Each computer should use its own account number: 1 on your first, 2 on the next, and so on. They all come from the same 24 words, so one phrase backs them all up.

It installs a newer version only if it carries the Orien release signature, so nobody can slip in a fake one. It updates the AI skill too.

Validators check payments and earn the network’s fees, shared by stake. You need at least 10,000 ORN to stake, and a server that stays on, ideally running Linux.

Staking needs your wallet on the server too, as its own account (step 6 shows how), holding the ORN you stake.

At the next hourly checkpoint, if its stake is among the largest, it joins the validators. To stop, unstake with orien unstake --amount 10000: the ORN come back after a week.