Set up your wallet. Receive your first RVN.

Prepare the app for offline use

1. Your first visit to the web app needs a connection. You can use it in the browser even if there is no install option.
2. Wait for the offline-ready status in Settings. It means the app itself is saved; your files and wallet backup need separate preparation.
3. On iPhone, use Safari → Share → Add to Home Screen. On Android or a computer, use your browser’s install or home-screen option if offered. For the computer app, follow the download guide.
4. Try opening it once without a connection and check the files you will need. Installing the app does not back up your wallet.

Write down your 12 recovery words in order, keep them safe and finish the app’s backup check. If both your device data and recovery words are lost, we cannot restore your wallet.

Make room for your files

Import music, videos, photos, PDFs and documents into Photo storage. Organize folders and playlists. Playback depends on the formats your browser supports.

Write and save documents offline, attach files from storage and export them. An asset draft does not issue an asset or reserve its name.

A browser or user can clear site data. Keep another copy of important files and documents. Storage settings are no substitute for a backup.

A QR can carry the file itself

Both devices need RavenVault ready. File-transfer QR codes carry encrypted pieces of the file itself, rather than a link or payment address.

1. Choose a file and show its transfer invitation. The other person scans it and agrees to receive that file.
2. Keep scanning the file QR pieces. If it stops, keep the transfer and resume with the missing pieces.
3. Wait until all pieces have arrived and the complete file has been checked for a match. Then save it to Photo storage.

The web app allows 32 MiB (about 34 MB) per file. QR transfers can be slow, so try a small file first. Exchanging QR data does not need internet or Wi-Fi.

Allow camera access in a supported browser, keep the QR in focus and watch the progress. The web app cannot transfer files to nearby devices over Bluetooth.

When you need a server connection

A server lets you read the public ledger and deliver approved transactions. Connect to check balances, asset holders, payment completion and final auction results. An undelivered transaction is not a completed payment.

Companion connects the app to your computer for public-ledger lookups and delivery of approved transactions. You do not need to move your secret spending key or recovery words to the computer.

Start with the app’s public connection. For an advanced connection to your computer, use an encrypted HTTPS address. Browsers may block local HTTP addresses; a connection working in a native app may not work on the web.

Subscriptions and saved updates remain readable offline. New updates need a connection. An electronic signature identifies the approving key; it does not guarantee identity, copyright or an unused ticket.

Keep your earlier wallet within reach

PLAY X Raven is now RavenVault. Your computer’s server, mining, Photo storage, shop, asset and conversation tools continue under the new name.

Server

Look up public records and send transactions

Mining

Use your computer’s mining tools

Photo storage

Store and share photos, videos and documents

Your shop

Manage your menus and orders

Create an asset

Prepare items to register on the public ledger

Conversations

Nostr carries conversations through multiple servers

Your earlier web wallet stays with the site address and browser where you used it. This site cannot import it automatically. Use the previous-wallet entry when you need it.

Keep the old site’s data. Opening the new app does not automatically move or merge wallets, assets or stored files.

Wake Ravi up. Ask away.

Built-in help needs no key. An AI key comes from your own AI account. Choose a provider, add the key and test the connection to wake Ravi. On supported devices, tap the microphone, speak, review the text and press Send. Ravi helps with questions and payment preparation; voice cannot approve a payment. Review the amount, recipient and fees, then approve it yourself.

The web app can connect to Claude (Anthropic), OpenAI, Gemini (Google), Groq or OpenRouter. Lock your wallet before testing or asking an online AI. You can also choose a local AI on this computer. The phone uses the provider address you configure.

Connection tests and questions send your key and the required request to your chosen AI provider, whose pricing applies. The phone uses secure key storage; the web keeps the key in browser storage only if you choose to save it. Recovery words, AI keys and computer-backup passwords are different. Read-aloud replies can be switched off, and answers stay readable as text.

Install on your phone

Add the web app to your home screen and it opens like an app. No store download is needed, and it is always up to date. This is the easiest way, so we suggest it first.

iPhone (Safari)

1. Open the web app in Safari. If you opened it inside another app, such as a chat or social app, copy the address and paste it into Safari.
2. Tap the Share button at the bottom (or top). It looks like a square with an arrow pointing up.
3. Scroll the list and tap “Add to Home Screen”.
4. Check the name, then tap “Add”.
5. From now on, open it with the RavenVault icon on your home screen.

On iPhone, deleting the home-screen app can also delete the wallet data inside it. Please write your recovery words on paper first. Without them, even the operator cannot get your wallet back.

Android (Chrome)

1. Open the web app in Chrome.
2. Tap the menu (three dots) at the top right.
3. Tap “Install app” or “Add to Home screen”.
4. If you prefer a store app, you can get the Google Play app instead.

Which one is better?

The web app opens right away without installing and is always current. The Play app is downloaded from the store. If you are new, we suggest the web app.

Common problems

• I cannot see “Add to Home Screen”. On iPhone, look for it in Safari. If you are in another app’s browser, copy the address and open it in Safari. Scroll the Share list all the way.
• I do not see the update. Close the app completely, then open it again. Swipe it away in the app list.
• My wallet looks empty. Check that you opened the wallet with the same recovery words. On another device or a fresh install, open it again with your recovery words. The balance shows only when you are connected.

Using several wallets

Wallets come in two layers. The top layer is a recovery-word wallet, and sub-wallets live inside it. Tap the wallet name at the top to open the picker.

Recovery-word wallets

Each set of recovery words is one wallet. One device can hold up to 4. The words differ, so the keys are separate. Keep larger amounts in a different recovery-word wallet.

Sub-wallets

Inside one set of recovery words you can make up to 20 sub-wallets. No new backup is needed, because the same words recreate them. But they share the same words, so they do not split the risk. If the words leak, all of them are at risk.

Daily and vault wallets

A daily wallet is for everyday use. If you leave the app and come back within 3 minutes, it does not ask again.

A vault wallet is for larger amounts. It locks as soon as you leave the app. It also locks after 1 minute without a touch. It asks you to confirm when you open it and when you send.

The wallet that opens first (star)

Tap the star in the wallet list and the app opens that wallet first. Only daily wallets can have a star. The starred wallet goes to the top of the list.

Reordering and hiding

Press and hold a wallet row and the list wiggles. Then drag to reorder. Small up and down arrows also appear on each row. A vault wallet cannot go above a daily wallet. Tap “Done” when you finish.

In the same state, sub-wallets also show “Hide”. Hiding is not deleting. The money stays and still counts in the total. You can show a hidden wallet again from the hidden list.

Gathering into a larger wallet

It is off at first. In Settings, under “Send safety”, turn on gathering, then set a limit (RVN) and the vault wallet to receive. When your daily wallet goes over the limit, a card appears on Home asking whether to move money.

One tap on the card opens a review screen. Money moves only after you approve there. The receiver can only be your own vault wallet. The app never sends by itself.

Large-amount check

If you send 25% or more of the balance, the review screen shows a “This is a large amount” box. You must tick it to send. You cannot turn this off, only make it stricter. In Settings you can pick 5%, 10%, 20%, or an RVN amount.

Combining coins

If many small deposits pile up, a send may need more pieces than one transaction can hold. Then the Send screen offers “Combine coins”. It gathers small pieces into a larger one inside your own wallet. No money goes to anyone else. After it is in a block (usually a few minutes), send again.

Used-goods market

In the Activity tab, “Neighborhood used goods” lets you buy and sell with neighbors using RVN. Open your own post to see “Manage my post”.

You can switch the status between “For sale” and “Reserved”. When the deal is done, tap “Sold”. This cannot be undone.

To take a post down, tap “Delete post”. It asks once more. On some devices it may disappear from the list a little later.

Read notes from neighbors with “View notes”. A buyer checks the address received from the seller, then checks the amount again on the Send screen.

My tasks

Tap the bell at the top right of Home to open “My tasks”. New money alerts show as a number on the bell.

The “Today” box at the top appears only when there is something new, such as notes, active bookings, or money alerts. Shop owners also see new orders. Tap its button to go straight there.

Below it you find neighborhood map, used goods, chat, shop and assets.

Talk — rooms and 1:1 messages

In the first Activity tab, “Talk”, you chat in open rooms anyone can join and exchange 1:1 messages with people whose address (npub) you know. Posting and messaging work after you open your wallet.

Room posts are public. They go to several shared chat servers (Nostr) where anyone can read them, and a post is hard to remove completely once sent. 1:1 messages are sealed in three layers of encryption, so even the chat servers cannot read them.

Notifications

Go to Talk → My name tag → “Turn on notifications”. The Android app shows app notifications; the web app uses browser notifications (on iPhone, from the web app added to the Home Screen). Notifications never include the message text or the sender. Turn them on separately on each device.

If you change phones or restore with your recovery words

Your Talk identity is made from your recovery words. Restore with the same words and you get the same address and name tag back — the same person as in RavenVault on your computer.

Messages still on the chat servers open again, including the ones you sent, because you keep your own copy. The servers are shared, though, so very old messages may have been deleted.

Your joined rooms, people you Hide, and hidden rooms or messages are stored only on the device, so they are gone after a restore. Join and choose again. Turn notifications on again on the new device too.

Anyone who knows your recovery words can read all your messages as well as take your money. Posts asking for money, recovery words or verification codes are scams. Staff never ask for recovery words by message.

The computer app will not start

Use this when the RVN server will not start in the computer (Windows) app. Find the words that match your screen below. Your wallet and files are not erased by this.

“Starting the RVN server…” never finishes

The first start can take a few minutes. If it stays the same for more than 10 minutes, follow the “Check in this order” steps below.

It says “The server is off”

The server did not start, or it stopped on the way. Tap “Prepare everything at once” in the app again, then follow the steps below.

“Blocks” stays at 0

The server has not started receiving the ledger yet. Check that the internet is on, then follow the steps below.

Check in this order

1. Check that the data folder exists. Press the Windows key and R together, type %APPDATA% and press Enter. If there is no “Raven” folder inside, right-click an empty space, choose New, then Folder, and name it Raven. (From app version 0.9.4 the app makes it for you.)
2. Check free disk space. The ledger needs about 40 GB of free space. If it is short, delete files you do not use.
3. Close other heavy programs. Games or video editors use a lot of memory and can stop the server from starting.
4. Tap “Prepare everything at once” in the app again. If a window asks for administrator permission, tap “Yes”.
5. Check whether antivirus (Windows Security) is blocking it. In Windows Security, under “Virus & threat protection”, use “Add an exclusion” and add the data folder above (%APPDATA%\Raven).

How to see the log

If it still does not work, please send the log. Type %APPDATA%\Raven in the File Explorer address bar and press Enter, then open the file debug.log with Notepad. Take a photo of the last 20 lines and send it. The log does not contain wallet keys or passwords. If you see names or addresses, you may cover them first.

From app version 0.9.4 it is easier. In the app’s “Report a problem”, tick “Send the node log too”. You can preview what is covered before sending, and it is off at first.

About the app folder name: from 0.9.4 the app folder name changed from PlayXRaven to RavenVault. Only the name changed, so your files are not erased.