Add warning to readme (ordinals#1213)

README.md

@@ -1,7 +1,8 @@
 `ord`
 =====
 
-`ord` is an index, block explorer, and command-line wallet.
+`ord` is an index, block explorer, and command-line wallet. It is experimental
+software with no warranty. See [LICENSE](LICENSE) for more details.
 
 Ordinal theory imbues satoshis with numismatic value, allowing them to
 collected and traded as curios.
@@ -23,6 +24,32 @@ where the project is and where it's going.
 Join [the Discord server](https://discord.gg/87cjuz4FYg) to chat with fellow
 ordinal degenerates.
 
+Wallet
+------
+
+`ord` relies on Bitcoin Core for private key managment and transaction signing.
+This has a number of implications that you must understand in order to use
+`ord` wallet commands safely:
+
+- Bitcoin Core does is not aware of inscriptions and does not perform sat
+ control. Using `bitcoin-cli` commands and RPC calls with `ord` wallets may
+ lead to loss of inscriptions.
+
+- `ord wallet` commands automatically load the `ord` wallet given by the
+ `--wallet` option, which defaults to 'ord'. Keep in mind that after running
+ an `ord wallet` command, an `ord` wallet may be loaded.
+
+- Because `ord` has access to your Bitcoin Core wallets, `ord` should not be
+ used with wallets that contain a material amount of funds. Keep ordinal and
+ cardinal wallets segregated.
+
+### Pre-alpha wallet migration
+
+Alpha `ord` wallets are not compatible with wallets created by previous
+versions of `ord`. To migrate, use `ord wallet send` from the old wallet to
+send sats and inscriptions to addresses generated by the new wallet with `ord
+wallet receive`.
+
 Installation
 ------------
 

src/options.rs

@@ -181,7 +181,7 @@ impl Options {
  .count();
 
  if tr != 2 || descriptors.len() != 2 + rawtr {
- bail!("this does not appear to be an ord wallet, create one with `ord wallet create`");
+ bail!("wallet \"{}\" contains unexpected output descriptors, and does not appear to be an `ord` wallet, create a new wallet with `ord wallet create`", self.wallet);
  }
  }
 

tests/wallet/create.rs

@@ -75,7 +75,7 @@ fn detect_wrong_descriptors() {
  CommandBuilder::new("wallet transactions")
  .rpc_server(&rpc_server)
  .stderr_regex(
- "error: this does not appear to be an ord wallet, create one with `ord wallet create`\n",
+ r#"error: wallet "ord" contains unexpected output descriptors, and does not appear to be an `ord` wallet, create a new wallet with `ord wallet create`\n"#,
  )
  .expected_exit_code(1)
  .run();