创建钱包，收取第一笔 RVN。

准备离线使用

1. 首次打开网页版需要联网。没有安装选项，也可以直接在浏览器中使用。
2. 在设置中等待离线准备完成。这表示应用本身已保存，个人文件和钱包备份仍需单独准备。
3. iPhone 使用 Safari → 分享 → 添加到主屏幕。Android 或电脑可使用浏览器提供的安装或主屏幕选项。电脑应用请按下载指南安装。
4. 断网后打开一次，检查所需文件能否打开。安装应用不能代替钱包备份。

按顺序记下 12 个恢复词，妥善保管，并完成应用内的备份确认。如果设备数据和恢复词都丢失，我们也无法恢复你的钱包。

把需要的文件存好

把音乐、视频、照片、PDF 和文档导入照片保管库，用文件夹和播放列表整理。能否播放取决于浏览器支持的格式。

离线也能编写和保存文档，添加保管库文件后导出。资产草稿不会自动发行资产，也不会预留名称。

浏览器或用户可能清除网站数据。重要文件和文档请另存一份；存储设置不能代替备份。

二维码也能传文件本身

两台设备都需要准备好 RavenVault。文件传输二维码携带的是文件本身的加密片段，不是链接或付款地址。

1. 发送方选好文件，展示传输邀请。接收方扫描后同意接收该文件。
2. 继续扫描文件二维码片段。中断时保留传输进度，之后继续接收缺少的片段。
3. 收到全部片段后，等待完整文件核对结束，再保存到照片保管库。

网页版每个文件上限为 32 MiB（约 34 MB）。二维码传输可能较慢，建议先试小文件。交换二维码数据无需互联网或 Wi-Fi。

在支持的浏览器中允许使用摄像头，对准二维码并查看进度。网页版不能通过 Bluetooth 向附近设备传文件。

哪些操作需要连接服务器

服务器用于查询公开账本、发送已批准的交易。余额、资产持有人、付款完成和拍卖最终结果都需要连接后确认。尚未发送的交易不等于付款完成。

Companion 用于把应用连接到自己的电脑，查询公开账本、发送已批准的交易。无需把控制资金的私密密钥或恢复词转移到电脑。

开始时可使用应用的公共连接。连接自己电脑的高级设置应使用加密的 HTTPS 地址。浏览器可能阻止本地 HTTP 地址，原生应用能连接，不代表网页版也能连接。

订阅和已保存动态可离线查看，新动态需要联网接收。电子签名标识批准消息的密钥，不保证身份、版权或门票未使用。

旧钱包也可以继续使用

PLAY X Raven 已更名为 RavenVault。电脑上的服务器、挖矿、照片保管库、店铺、资产和聊天工具继续保留。

服务器

查询公开记录，发送交易

挖矿

使用电脑上的挖矿工具

照片保管库

保存和分享照片、视频、文档

自己的店铺

管理菜单和订单

发行资产

准备要登记到公开账本的项目

聊天

Nostr 是通过多个服务器传递消息的方式

旧网页版钱包仍保存在原来的网站地址和浏览器中。新网站无法自动导入，需要时请从旧钱包入口进入。

请保留旧网站的数据。打开新应用，不会自动迁移或合并钱包、资产和保管库。

唤醒拉比，开口提问

内置指南无需密钥。AI 密钥由你自己的 AI 账户提供。选择服务商、输入密钥、确认连接后，拉比就会醒来。支持的设备上，点击麦克风说话，检查文字后再发送。拉比帮助解答问题和准备转账，但语音不能批准付款；请核对金额、地址和费用后亲自批准。

网页版可连接 Claude（Anthropic）、OpenAI、Gemini（Google）、Groq 或 OpenRouter。测试在线 AI 连接或提问前，请先锁定钱包；也可以选择本机的本地 AI。手机使用你配置的服务商地址。

连接测试和提问会把密钥及必要请求发送给所选 AI 服务商，费用按该服务商的规则计算。手机使用安全存储；网页版仅在你选择保存时存入浏览器。恢复词、AI 密钥、电脑备份密码各不相同。回答朗读可以关闭，没有声音也能阅读文字。

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.

聊天 — 房间与一对一私信

在动态的第一个标签「聊天」里，可以在任何人都能加入的房间聊天，也可以和知道地址（npub）的人互发一对一私信。发帖和私信需要先打开钱包。

房间里的帖子是公开的。它们会发到多个公共聊天服务器（Nostr），任何人都能看到，发出后很难彻底删除。一对一私信经过三层加密，连聊天服务器也无法读取。

通知

依次点 聊天 → 我的名牌 → 「开启通知」。Android 应用会收到应用通知，网页应用会收到浏览器通知（iPhone 需使用添加到主屏幕的网页应用）。通知不包含内容和发送者。每台设备需要分别开启。

换手机或用恢复词恢复时

聊天身份由恢复词生成。用相同的恢复词恢复，会回到相同的地址和名牌，和电脑上的 RavenVault 也是同一个人。

仍保存在聊天服务器上的私信可以再次打开，自己发出的私信也有副本，同样能看到。不过这些是公共服务器，很久以前的私信可能已被删除。

加入的房间、「不显示」的人、隐藏的房间和私信只保存在设备上，恢复后会消失。请重新加入或重新选择。通知也需要在新设备上重新开启。

知道恢复词的人不仅能拿走你的钱，还能读到你所有的私信。索要钱、恢复词或验证码的帖子都是诈骗。运营方绝不会通过私信询问恢复词。

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.