From 4b84c9136219662dfc0875c47d40c0e0b1aa9744 Mon Sep 17 00:00:00 2001
From: Casey Rodarmor <casey@rodarmor.com>
Date: Wed, 7 Dec 2022 14:20:56 -0800
Subject: [PATCH 01/32] Add Inscription guide

---
 docs/book.toml                                |   2 +-
 docs/src/SUMMARY.md                           |  11 +-
 docs/src/{bounty.md => bounties.md}           |   4 +-
 docs/src/guides.md                            |   0
 .../{block-explorer.md => guides/explorer.md} |   4 +-
 docs/src/guides/inscriptions.md               | 209 ++++++++++++++++++
 .../{hunting.md => guides/ordinal-hunting.md} |  19 +-
 docs/src/introduction.md                      |  35 ++-
 docs/src/{theory.md => overview.md}           |  85 +++----
 src/subcommand/server/templates/home.rs       |   3 +-
 templates/home.html                           |  10 +
 11 files changed, 325 insertions(+), 57 deletions(-)
 rename docs/src/{bounty.md => bounties.md} (83%)
 create mode 100644 docs/src/guides.md
 rename docs/src/{block-explorer.md => guides/explorer.md} (97%)
 create mode 100644 docs/src/guides/inscriptions.md
 rename docs/src/{hunting.md => guides/ordinal-hunting.md} (91%)
 rename docs/src/{theory.md => overview.md} (75%)

diff --git a/docs/book.toml b/docs/book.toml
index 1970cc7aac..ae8685741a 100644
--- a/docs/book.toml
+++ b/docs/book.toml
@@ -1,5 +1,5 @@
 [book]
-title = "Ordinal Hunter's Manual"
+title = "Ordinal Theory Handbook"
 language = "en"
 src = "src"
 
diff --git a/docs/src/SUMMARY.md b/docs/src/SUMMARY.md
index 3ad3e91d83..75400b77b4 100644
--- a/docs/src/SUMMARY.md
+++ b/docs/src/SUMMARY.md
@@ -2,12 +2,15 @@
 
 [Introduction](introduction.md)
 
-- [Theory](theory.md)
-- [Block Explorer](block-explorer.md)
-- [Hunting](hunting.md)
+- [Overview](overview.md)
 - [FAQ](faq.md)
 
-- [Bounties](bounty.md)
+- [Guides](guides.md)
+  - [Explorer](guides/explorer.md)
+  - [Inscriptions](guides/inscriptions.md)
+  - [Ordinal Hunting](guides/ordinal-hunting.md)
+
+- [Bounties](bounties.md)
   - [Bounty 0: 100,000 sats Claimed!](bounty/0.md)
   - [Bounty 1: 200,000 sats Claimed!](bounty/1.md)
   - [Bounty 2: 300,000 sats Claimed!](bounty/2.md)
diff --git a/docs/src/bounty.md b/docs/src/bounties.md
similarity index 83%
rename from docs/src/bounty.md
rename to docs/src/bounties.md
index cbe914e200..2dbc2093e3 100644
--- a/docs/src/bounty.md
+++ b/docs/src/bounties.md
@@ -1,9 +1,9 @@
 Ordinal Bounty Hunting Hints
 ============================
 
-- There are no ordinal wallets or transaction construction libraries. However,
+- The `ord` wallet can send and receive specific satoshis. Additionally,
   ordinal theory is extremely simple. A clever hacker should be able to write
-  code to manipulate ordinals in no time.
+  code from scratch to manipulate satoshis using ordinal theory in no time.
 
 - For more information about ordinals, check out the [FAQ](./faq.md) for an
   overview, the [BIP](https://github.com/casey/ord/blob/master/bip.mediawiki)
diff --git a/docs/src/guides.md b/docs/src/guides.md
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/docs/src/block-explorer.md b/docs/src/guides/explorer.md
similarity index 97%
rename from docs/src/block-explorer.md
rename to docs/src/guides/explorer.md
index 0279c86a36..8899cdf001 100644
--- a/docs/src/block-explorer.md
+++ b/docs/src/guides/explorer.md
@@ -1,5 +1,5 @@
-Ordinal Block Explorer
-======================
+Ordinal Explorer
+================
 
 The `ord` binary includes a block explorer. We host a instance of the block
 explorer on mainnet at [ordinals.com](https://ordinals.com), and on signet at
diff --git a/docs/src/guides/inscriptions.md b/docs/src/guides/inscriptions.md
new file mode 100644
index 0000000000..227b92368c
--- /dev/null
+++ b/docs/src/guides/inscriptions.md
@@ -0,0 +1,209 @@
+Ordinal Inscription Guide
+=========================
+
+Individual satoshis can be inscribed with arbitrary content, creating
+Bitcoin-native digital artifacts that can be held in a Bitcoin wallet and
+transferred using Bitcoin transactions. Inscriptions are as durable, immutable,
+secure, and decentralized as the Bitcoin blockchain itself.
+
+Working with inscriptions requires a Bitcoin full node, to give you a view of
+the current state of the Bitcoin blockchain, and a wallet that can make
+ordinal-aware transactions that inscribe satoshis with content and transfer
+individual satoshis using ordinal theory.
+
+Bitcoin Core provides both a Bitcoin full node and Bitcoin wallet. However, the
+Bitcoin Core wallet cannot make ordinal-aware transactions. Making
+ordinal-aware transactions requires [`ord`](https://github.com/casey/ord), the
+ordinal theory utility. `ord wallet` subcommands wrap an existing Bitcoin Core
+wallet.
+
+This guide contains everything you need to know about creating, sending, and
+receiving inscriptions:
+
+1. Installing Bitcoin Core
+2. Syncing the Bitcoin blockchain
+3. Creating a Bitcoin Core wallet
+4. Using `ord wallet receive` to receive satoshis
+5. Creating inscriptions with `ord wallet inscribe`
+6. Sending inscriptions with `ord wallet send`
+7. Receiving inscriptions with `ord wallet receive`
+
+Getting Help
+------------
+
+A guide can only do so much! If you get stuck, try asking for help on the
+[Ordinal Theory Discord Server](https://discord.com/invite/87cjuz4FYg), or
+checking GitHub for relevant [issues](https://github.com/casey/ord/issues) and
+[discussions](https://github.com/casey/ord/discussions).
+
+Installing Bitcoin Core
+-----------------------
+
+Bitcoin Core is available from [bitcoincore.org](https://bitcoincore.org/) on
+the [download page](https://bitcoincore.org/en/download/).
+
+This guide does not cover installing Bitcoin Core in detail. Once Bitcoin Core
+is installed, you should be able to run `bitcoind -version` successfully from
+the command line.
+
+Configuring Bitcoin Core to use Signet
+--------------------------------------
+
+`ord wallet` subcommands cannot yet be used on mainnet, so your Bitcoin Core
+node must be configured to use another chain. This guide uses signet, but
+testnet or regtest mode may also be used.
+
+To configure your Bitcoin Core node to use signet, add `signet=1` to your
+`bitcoin.conf` configuration file, or pass `-signet` to `bitcoind` and
+`bitcoin-cli`, e.g. `bitcoind -signet` and `bitcoin-cli -signet`.
+
+Syncing the Bitcoin Blockchain
+------------------------------
+
+Once Bitcoin Core has been configured to use signet, you'll need to sync the
+blockchain. Signet is a low-volume test network, so this shoudln't take long.
+
+To sync the chain, run `bitcoind -signet` and leave it running until
+`bitcoin-cli -signet getblockcount` agrees with the block count on a block
+explorer like [the mempool.space signet block
+explorer](https://mempool.space/signet).
+
+Creating a Bitcoin Core Wallet
+------------------------------
+
+`ord` uses Bitcoin Core to manage private keys, sign transactions, and
+broadcast transactions to the Bitcoin network.
+
+`ord` wallets must be named `ord`, or start with `ord-`, to avoid
+unintentionally using the `ord` utility with non-ordinal Bitcoin wallets.
+
+To create a wallet for use with `ord`, run:
+
+```
+bitcoin-wallet -signet -wallet=ord create
+```
+
+Loading the Bitcoin Core Wallet
+-------------------------------
+
+Bitcoin Core wallets must be loaded before the can be used with `ord`. To load
+your wallet, run:
+
+```
+bitcoin-cli -signet loadwallet ord
+```
+
+Installing `ord`
+----------------
+
+The `ord` utility is written in Rust and can be built from
+[source](https://github.com/casey/ord). Pre-built binaries are available on the
+[releases page](https://github.com/casey/ord/releases).
+
+Once `ord` is installed, you shoud be able to run `ord --version` on the
+command line.
+
+Receiving Satoshis
+------------------
+
+Inscriptions are made on individual satoshis, using normal Bitcoin transactions
+that pay fees in satoshis, so your wallet will need some sats.
+
+
+Get a new address from your `ord` wallet by running `ord --chain=signet wallet
+receive`
+
+Use a signet faucet to send satoshis to the address you generated. Two faucets
+you might try are [signet.bc-2.jp](https://signet.bc-2.jp/) and
+[alt.signetfaucet.com](https://alt.signetfaucet.com/).
+
+Once the faucet transaction confirms, you should be able to see the
+transactions outputs with `ord --chain=signet wallet utxos`.
+
+Creating Inscription Content
+----------------------------
+
+Create a `.png` or `.txt` file smaller than 1024 bytes to inscribe.
+
+Satoshis can be inscribed with any kind of content, but the `ord` wallet and
+explorer are currently limited to `.png` and `.txt` files.
+
+Additionally, inscriptions made on signet must be 1024 bytes or less, to avoid
+congesting signet for other users. Inscriptions are stored in Taproot input
+witnesses, so mainnet inscriptions will only be limited by the 4,000,000 byte
+witness size limit.
+
+Creating Inscriptions
+---------------------
+
+To create an inscription with the contents of `CONTENTS`, run:
+
+```
+ord --chain=signet wallet inscribe --file CONTENTS
+```
+
+Ord will output two transactions IDs, one for the commit transaction, and one
+for the reveal transaction.
+
+The commit transaction commits to a tapscript containing the contents of the
+inscription, and the reveal transaction spends from that tapscript, reaveling
+the contents on chain and inscribing them on the first satoshi of the first
+output of the reveal transaction.
+
+Wait for the reveal transaction to be mined. You can check the status of the
+commit and reveal transactions using  [the mempool.space signet block
+explorer](https://mempool.space/signet).
+
+Once the reveal transaction has been mined, the inscription ID should be
+printed when you run:
+
+```
+ord --chain=signet wallet inscriptions
+```
+
+And when you visit [the signet ordinals explorer](https://signet.ordinals.com/)
+at `signet.ordinals.com/inscription/INSCRIPTION_ID`.
+
+
+Sending Inscriptions
+--------------------
+
+Ask the recipient to generate a new address by running:
+
+```
+ord --chain=signet wallet receive
+```
+
+Send the inscription by running:
+
+```
+ord --chain=signet wallet send INSCRIPTION_ID ADDRESS
+```
+
+Once the send transaction confirms, the recipient can confirm receipt by
+running:
+
+```
+ord --chain=signet wallet inscriptions
+```
+
+Receiving Inscriptions
+----------------------
+
+Generate a new receive address using:
+
+```
+ord --chain=signet wallet receive
+```
+
+The sender can transfer the inscription to your address using:
+
+```
+ord --chain=signet wallet send INSCRIPTION_ID ADDRESS
+```
+
+Once the send transaction confirms, you can can confirm receipt by running:
+
+```
+ord --chain=signet wallet inscriptions
+```
diff --git a/docs/src/hunting.md b/docs/src/guides/ordinal-hunting.md
similarity index 91%
rename from docs/src/hunting.md
rename to docs/src/guides/ordinal-hunting.md
index eb275c150c..013366a24f 100644
--- a/docs/src/hunting.md
+++ b/docs/src/guides/ordinal-hunting.md
@@ -1,9 +1,13 @@
 Ordinal Hunting
 ===============
 
+*This guide is out of date. Since it was written, the `ord` binary was changed
+to only build the full ordinal index when the `--ordinal-index` flag is
+supplied. Additionally, `ord` now has built-in wallet that wraps a Bitcoin Core
+wallet. See `ord wallet --help`.*
+
 Ordinal hunting is difficult but rewarding. The feeling of owning a wallet full
-of UTXOs, redolent with the scent of rare and exotic ordinals, is beyond
-compare.
+of UTXOs, redolent with the scent of rare and exotic sats, is beyond compare.
 
 Ordinals are numbers for satoshis. Every satoshi has an ordinal number and
 every ordinal number has a satoshi.
@@ -234,11 +238,12 @@ those multiple descriptors into Bitcoin Core.
 
 #### Sparrow Wallet
 
-Navigate to the `Settings` tab, then to `Script Policy`, and press the edit button to display the descriptor.
+Navigate to the `Settings` tab, then to `Script Policy`, and press the edit
+button to display the descriptor.
 
 ### Transferring Ordinals
 
-`ord` does not yet support transferring specific ordinals. Currently, your best
-bet is to use the `bitcoin-cli` commands `createrawtransaction`,
-`signrawtransactionwithwallet`, and `sendrawtransaction`, however, how to do so
-is complex and outside the scope of this guide.
+The `ord` wallet supports transferring specific satoshis. You can also use
+`bitcoin-cli` commands `createrawtransaction`, `signrawtransactionwithwallet`,
+and `sendrawtransaction`, how to do so is complex and outside the scope of this
+guide.
diff --git a/docs/src/introduction.md b/docs/src/introduction.md
index 62b7f1c0a9..1568b8db71 100644
--- a/docs/src/introduction.md
+++ b/docs/src/introduction.md
@@ -1,4 +1,35 @@
-Ordinals are a namespace for Bitcoin. For an overview, check out the [theory](theory.md) page.
+Introduction
+============
+
+This handbook is a guide to ordinal theory. Ordinal theory concerns itself with
+distinguishing satoshis, giving them an identity and allowing them to be
+tracked and transferred individually.
+
+Satoshis, not bitcoin, are the atomic, native currency of the Bitcoin network.
+One bitcoin can be sub-divided into 100,000,000 satoshis, but no further.
+
+Ordinal theory is not a side chain, does not require any token aside from
+Bitcoin, and can be used without any changes to the Bitcoin network. It works
+right now.
+
+Ordinal theory imbues satoshis with numismatic value, allowing them to
+collected and traded as curios.
+
+Individual satoshis can be inscribed with arbitrary content, creating
+Bitcoin-native digital artifacts that can be held in a Bitcoin wallet and
+transferred using Bitcoin transactions. Inscriptions are as durable, immutable,
+secure, and decentralized as the Bitcoin blockchain itself.
+
+Other, more unusual use-cases are possible: off-chain colored-coins, public key
+infrastructure with key rotation, a decentralized replacement for the DNS. For
+now though, such use cases are theoretical, and exist only in the minds of
+fringe ordinal theorists.
+
+For more details on ordinal theory, see the [overview](overview.md).
+
+When you're ready to get your hands dirty, a good place to start is with
+[inscriptions](guides/inscriptions.md), a curious species of digital artifact
+enabled by ordinal theory.
 
 Links
 -----
@@ -7,7 +38,7 @@ Links
 - [BIP](https://github.com/casey/ord/blob/master/bip.mediawiki)
 - [Discord](https://discord.gg/87cjuz4FYg)
 - [Mainnet Block Explorer](https://ordinals.com)
-- [Signet Block Explorer](https://ordinals.com)
+- [Signet Block Explorer](https://signet.ordinals.com)
 
 Videos
 ------
diff --git a/docs/src/theory.md b/docs/src/overview.md
similarity index 75%
rename from docs/src/theory.md
rename to docs/src/overview.md
index 22420b6234..97abe084d0 100644
--- a/docs/src/theory.md
+++ b/docs/src/overview.md
@@ -1,17 +1,17 @@
-Ordinal Theory
-==============
+Ordinal Theory Overview
+=======================
 
 Ordinals are numbering scheme for satoshis that allows tracking and
-transferring individual sats. These numbers are called
-[ordinals](https://ordinals.com). Satoshis are numbered in the order in which
+transferring individual sats. These numbers are called [ordinal
+numbers](https://ordinals.com). Satoshis are numbered in the order in which
 they're mined, and transferred from transaction inputs to transaction outputs
-in first-in-first-out order. More details are available in [the
+with first-in-first-out order. More details are available in [the
 BIP](https://github.com/casey/ord/blob/master/bip.mediawiki).
 
 Ordinals don't require a separate token, another blockchain, or any changes to
 Bitcoin. They work right now.
 
-Ordinals have a few different representations:
+Ordinal numbers have a few different representations:
 
 - *Integer notation*:
   [`2099994106992659`](https://ordinals.com/ordinal/2099994106992659). The
@@ -19,9 +19,9 @@ Ordinals have a few different representations:
   symbol.
 
 - *Decimal notation*:
-  [`3891094.16797`](https://ordinals.com/ordinal/3891094.16797)The first number
-  is the block height in which the ordinal was created, the second the offset
-  of the ordinal within the block.
+  [`3891094.16797`](https://ordinals.com/ordinal/3891094.16797) The first
+  number is the block height in which the ordinal was created, the second the
+  offset of the ordinal within the block.
 
 - *Degree notation*:
   [`3°111094′214″16797‴`](https://ordinals.com/ordinal/3%C2%B0111094%E2%80%B2214%E2%80%B316797%E2%80%B4).
@@ -29,27 +29,27 @@ Ordinals have a few different representations:
 
 - *Percentile notation*:
   [`99.99971949060254%`](https://ordinals.com/ordinal/99.99971949060254%25) .
-  The ordinals position in Bitcoin's supply, expressed as a percentage.
+  The satoshi's position in Bitcoin's supply, expressed as a percentage.
 
 - *Name*: [`satoshi`](https://ordinals.com/ordinal/satoshi). An encoding of the
   ordinal number using the characters `a` through `z`.
 
 Arbitrary assets, such as NFTs, security tokens, accounts, or stablecoins can
-be attached to Ordinals.
+be attached to satoshis using ordinal numbers as stable identifiers.
 
 Ordinals is an open-source project, developed [on
 GitHub](https://github.com/casey/ord). The project consists of a BIP describing
 the ordinal scheme, an index that communicates with a Bitcoin Core node to
-track the location of all ordinals, a wallet that allows making ordinal-aware
+track the location of all satoshis, a wallet that allows making ordinal-aware
 transactions, a block explorer for interactive exploration of the blockchain,
-functionality for minting ordinal NFTs, and this manual.
+functionality for inscribing satoshis with digital artifacts, and this manual.
 
 Rarity
 ------
 
-Humans are collectors, and since ordinals can be tracked and transferred,
+Humans are collectors, and since satoshis can now be tracked and transferred,
 people will naturally want to collect them. Ordinal theorists can decide for
-themselves which sats are rare and desirable, but there are some hints.
+themselves which sats are rare and desirable, but there are some hints…
 
 Bitcoin has periodic events, some frequent, some more uncommon, and these
 naturally lend themselves to a system of rarity. These periodic events are:
@@ -79,7 +79,7 @@ This gives us the following rarity levels:
 - `mythic`: The first sat of the genesis block
 
 Which brings us to degree notation, which unambiguously represents an ordinal
-in a way that makes rarity easy to see at a glance:
+number in a way that makes the rarity of a satoshi easy to see at a glance:
 
 ```
 A°B′C″D‴
@@ -92,7 +92,7 @@ A°B′C″D‴
 Ordinal theorists often use the terms "hour", "minute", "second", and "third"
 for *A*, *B*, *C*, and *D*, respectively.
 
-Now for some examples. This ordinal is common:
+Now for some examples. This satoshi is common:
 
 ```
 1°1′1″1‴
@@ -103,7 +103,7 @@ Now for some examples. This ordinal is common:
 ```
 
 
-This ordinal is uncommon:
+This satoshi is uncommon:
 
 ```
 1°1′1″0‴
@@ -113,7 +113,7 @@ This ordinal is uncommon:
 ╰─────── Second cycle
 ```
 
-This ordinal is rare:
+This satoshi is rare:
 
 ```
 1°1′0″0‴
@@ -123,7 +123,7 @@ This ordinal is rare:
 ╰─────── Second cycle
 ```
 
-This ordinal is epic:
+This satoshi is epic:
 
 ```
 1°0′1″0‴
@@ -133,7 +133,7 @@ This ordinal is epic:
 ╰─────── Second cycle
 ```
 
-This ordinal is legendary:
+This satoshi is legendary:
 
 ```
 1°0′0″0‴
@@ -143,7 +143,7 @@ This ordinal is legendary:
 ╰─────── Second cycle
 ```
 
-And this ordinal is mythic:
+And this satoshi is mythic:
 
 ```
 0°0′0″0‴
@@ -153,7 +153,7 @@ And this ordinal is mythic:
 ╰─────── First cycle
 ```
 
-If the block offset is zero, it may be omitted. This is the uncommon ordinal
+If the block offset is zero, it may be omitted. This is the uncommon satoshi
 from above:
 
 ```
@@ -163,8 +163,8 @@ from above:
 ╰───── Second cycle
 ```
 
-Ordinal Supply
---------------
+Rare Satoshi Supply
+-------------------
 
 ### Total Supply
 
@@ -184,35 +184,44 @@ Ordinal Supply
 - `legendary`: 0
 - `mythic`: 1
 
-At the moment, even uncommon ordinals are quite rare. As of this writing,
-745,855 uncommon ordinals have been mined - one per 25.6 bitcoin in
+At the moment, even uncommon satoshis are quite rare. As of this writing,
+745,855 uncommon satoshis have been mined - one per 25.6 bitcoin in
 circulation.
 
 Names
 -----
 
-Each ordinal has a name, consisting of the letters *A* through *Z*, that get
-shorter the larger the ordinal is. They could start short and get longer, but
-then all the good, short names would be trapped in the unspendable genesis
-block.
+Each satoshi has a name, consisting of the letters *A* through *Z*, that get
+shorter the further into the future the satoshi was mined. They could start
+short and get longer, but then all the good, short names would be trapped in
+the unspendable genesis block.
 
-As an example, 1905530482684727°'s name is "iaiufjszmoba". The name of the last
-ordinal to be mined is "a". Every combination of 10 characters or less is out
-there, or will be out there, some day.
+As isan example, 1905530482684727°'s name is "iaiufjszmoba". The name of the
+last satoshi to be mined is "a". Every combination of 10 characters or less is
+out there, or will be out there, some day.
 
 Exotics
 -------
 
-Ordinals may be prized for reasons other than their name or rarity. This might
+Satoshis may be prized for reasons other than their name or rarity. This might
 be due to a quality of the number itself, like having an integer square or cube
 root. Or it might be due to a connection to a historical event, such as
-ordinals from block 477,120, the block in which SegWit activated, or ordinal
-2099999997689999°, the last ordinal that will ever be mined.
+satoshis from block 477,120, the block in which SegWit activated,
+2099999997689999°, the last satoshi that will ever be mined.
 
-Such ordinals are termed "exotic". Which ordinals are exotic and what makes
+Such satoshis are termed "exotic". Which satoshis are exotic and what makes
 them so is subjective. Ordinal theorists are are encouraged to seek out exotics
 based on criteria of their own devising.
 
+Inscriptions
+------------
+
+Satoshis can be inscribed with arbitrary content, creating Bitcoin-native
+digital artifacts. Inscribing is done by sending the satoshi to be inscrbied in
+a transaction that reveals the inscription content on-chain. This content is
+then inextricably linked to that satoshi, turning it into an immutable digital
+artifact that can be tracked, transfered, hoarded, bought, and sold.
+
 Archaeology
 -----------
 
diff --git a/src/subcommand/server/templates/home.rs b/src/subcommand/server/templates/home.rs
index 6b387e6ec8..76059305b7 100644
--- a/src/subcommand/server/templates/home.rs
+++ b/src/subcommand/server/templates/home.rs
@@ -51,7 +51,8 @@ mod tests {
         )
       ],)
       .to_string(),
-      "<h2>Status</h2>
+      "<h1>Create, explore, and collect digital artifacts on Bitcoin.</h1>
+<h2>Status</h2>
 <dl>
   <dt>cycle</dt><dd>1</dd>
   <dt>epoch</dt><dd>6</dd>
diff --git a/templates/home.html b/templates/home.html
index bb83e3cb4e..9cabd76b2b 100644
--- a/templates/home.html
+++ b/templates/home.html
@@ -1,3 +1,13 @@
+<h1>Explore digital artifacts on Bitcoin</h1>
+
+<p>Ordinal theory unlocks Bitcoin-native digital artifacts.</p>
+
+<p>Rare and exotic sats, and NFTs that are as durable, immutable, secure,
+scarce, and decentralized as the Bitcoin blockchain itself. Natively. no
+sidechain or token required.</p>
+
+<p><a href=http://docs.ordinals.com>Learn more.</a></p>
+
 %% if let Some(starting_ordinal) = self.starting_ordinal {
 <h2>Status</h2>
 <dl>

From 77d8706e36afd8b850d71e77c9b713b15c8e987d Mon Sep 17 00:00:00 2001
From: Casey Rodarmor <casey@rodarmor.com>
Date: Thu, 8 Dec 2022 15:05:37 -0800
Subject: [PATCH 02/32] tweak

---
 templates/home.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/templates/home.html b/templates/home.html
index 9cabd76b2b..5a269b5e15 100644
--- a/templates/home.html
+++ b/templates/home.html
@@ -3,7 +3,7 @@ <h1>Explore digital artifacts on Bitcoin</h1>
 <p>Ordinal theory unlocks Bitcoin-native digital artifacts.</p>
 
 <p>Rare and exotic sats, and NFTs that are as durable, immutable, secure,
-scarce, and decentralized as the Bitcoin blockchain itself. Natively. no
+scarce, and decentralized as the Bitcoin blockchain itself. Natively. No
 sidechain or token required.</p>
 
 <p><a href=http://docs.ordinals.com>Learn more.</a></p>

From 17dd77a12a1747098ff7abcca0b3a6941c1db715 Mon Sep 17 00:00:00 2001
From: Casey Rodarmor <casey@rodarmor.com>
Date: Thu, 8 Dec 2022 15:06:48 -0800
Subject: [PATCH 03/32] tweak

---
 docs/src/guides/ordinal-hunting.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/src/guides/ordinal-hunting.md b/docs/src/guides/ordinal-hunting.md
index 013366a24f..f3a12b1e86 100644
--- a/docs/src/guides/ordinal-hunting.md
+++ b/docs/src/guides/ordinal-hunting.md
@@ -3,8 +3,8 @@ Ordinal Hunting
 
 *This guide is out of date. Since it was written, the `ord` binary was changed
 to only build the full ordinal index when the `--ordinal-index` flag is
-supplied. Additionally, `ord` now has built-in wallet that wraps a Bitcoin Core
-wallet. See `ord wallet --help`.*
+supplied. Additionally, `ord` now has a built-in wallet that wraps a Bitcoin
+Core wallet. See `ord wallet --help`.*
 
 Ordinal hunting is difficult but rewarding. The feeling of owning a wallet full
 of UTXOs, redolent with the scent of rare and exotic sats, is beyond compare.

From 37ad1718d9decdf16b7fdcf82f52176e390f1785 Mon Sep 17 00:00:00 2001
From: Casey Rodarmor <casey@rodarmor.com>
Date: Thu, 8 Dec 2022 15:08:17 -0800
Subject: [PATCH 04/32] Fix tests

---
 src/subcommand/server/templates/home.rs | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/src/subcommand/server/templates/home.rs b/src/subcommand/server/templates/home.rs
index 76059305b7..124956611c 100644
--- a/src/subcommand/server/templates/home.rs
+++ b/src/subcommand/server/templates/home.rs
@@ -51,8 +51,7 @@ mod tests {
         )
       ],)
       .to_string(),
-      "<h1>Create, explore, and collect digital artifacts on Bitcoin.</h1>
-<h2>Status</h2>
+      "<h1>Explore digital artifacts on Bitcoin</h1>.*<h2>Status</h2>
 <dl>
   <dt>cycle</dt><dd>1</dd>
   <dt>epoch</dt><dd>6</dd>

From 0bb05f095ae51a2aebfc4e43befe88157211b751 Mon Sep 17 00:00:00 2001
From: Casey Rodarmor <casey@rodarmor.com>
Date: Thu, 8 Dec 2022 15:09:11 -0800
Subject: [PATCH 05/32] tweak

---
 docs/src/overview.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/src/overview.md b/docs/src/overview.md
index 97abe084d0..0aeebaff30 100644
--- a/docs/src/overview.md
+++ b/docs/src/overview.md
@@ -1,7 +1,7 @@
 Ordinal Theory Overview
 =======================
 
-Ordinals are numbering scheme for satoshis that allows tracking and
+Ordinals are a numbering scheme for satoshis that allows tracking and
 transferring individual sats. These numbers are called [ordinal
 numbers](https://ordinals.com). Satoshis are numbered in the order in which
 they're mined, and transferred from transaction inputs to transaction outputs

From 57dde42ac84b01bd13056ac1925eb43f6d948021 Mon Sep 17 00:00:00 2001
From: Casey Rodarmor <casey@rodarmor.com>
Date: Thu, 8 Dec 2022 15:10:04 -0800
Subject: [PATCH 06/32] tweak

---
 docs/src/overview.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/src/overview.md b/docs/src/overview.md
index 0aeebaff30..2b4ff8c39f 100644
--- a/docs/src/overview.md
+++ b/docs/src/overview.md
@@ -5,7 +5,7 @@ Ordinals are a numbering scheme for satoshis that allows tracking and
 transferring individual sats. These numbers are called [ordinal
 numbers](https://ordinals.com). Satoshis are numbered in the order in which
 they're mined, and transferred from transaction inputs to transaction outputs
-with first-in-first-out order. More details are available in [the
+first-in-first-out. Technical details are available in [the
 BIP](https://github.com/casey/ord/blob/master/bip.mediawiki).
 
 Ordinals don't require a separate token, another blockchain, or any changes to

From 67e9f92b6ab5057163b206b0a55479cfcd1a9fc2 Mon Sep 17 00:00:00 2001
From: Casey Rodarmor <casey@rodarmor.com>
Date: Thu, 8 Dec 2022 15:10:55 -0800
Subject: [PATCH 07/32] tweak

---
 docs/src/overview.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/src/overview.md b/docs/src/overview.md
index 2b4ff8c39f..6ba03bc4bb 100644
--- a/docs/src/overview.md
+++ b/docs/src/overview.md
@@ -14,7 +14,7 @@ Bitcoin. They work right now.
 Ordinal numbers have a few different representations:
 
 - *Integer notation*:
-  [`2099994106992659`](https://ordinals.com/ordinal/2099994106992659). The
+  [`2099994106992659°`](https://ordinals.com/ordinal/2099994106992659). The
   number is the ordinal number, and the "°" is the Romance language ordinal
   symbol.
 

From 074d177c43a50e3b5c80452cc3e5ab2835b1e52c Mon Sep 17 00:00:00 2001
From: Casey Rodarmor <casey@rodarmor.com>
Date: Thu, 8 Dec 2022 15:11:25 -0800
Subject: [PATCH 08/32] tweak

---
 docs/src/overview.md | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/docs/src/overview.md b/docs/src/overview.md
index 6ba03bc4bb..0f8f7710d1 100644
--- a/docs/src/overview.md
+++ b/docs/src/overview.md
@@ -14,9 +14,7 @@ Bitcoin. They work right now.
 Ordinal numbers have a few different representations:
 
 - *Integer notation*:
-  [`2099994106992659°`](https://ordinals.com/ordinal/2099994106992659). The
-  number is the ordinal number, and the "°" is the Romance language ordinal
-  symbol.
+  [`2099994106992659`](https://ordinals.com/ordinal/2099994106992659)
 
 - *Decimal notation*:
   [`3891094.16797`](https://ordinals.com/ordinal/3891094.16797) The first

From 44ba26dbc465b49ba0ad125648a6e1f4922741d7 Mon Sep 17 00:00:00 2001
From: Casey Rodarmor <casey@rodarmor.com>
Date: Thu, 8 Dec 2022 15:12:34 -0800
Subject: [PATCH 09/32] tweak

---
 docs/src/overview.md | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/docs/src/overview.md b/docs/src/overview.md
index 0f8f7710d1..f52db68076 100644
--- a/docs/src/overview.md
+++ b/docs/src/overview.md
@@ -14,12 +14,13 @@ Bitcoin. They work right now.
 Ordinal numbers have a few different representations:
 
 - *Integer notation*:
-  [`2099994106992659`](https://ordinals.com/ordinal/2099994106992659)
+  [`2099994106992659`](https://ordinals.com/ordinal/2099994106992659) The
+  ordinal number, assigned according to the order the satoshi was mined.
 
 - *Decimal notation*:
   [`3891094.16797`](https://ordinals.com/ordinal/3891094.16797) The first
-  number is the block height in which the ordinal was created, the second the
-  offset of the ordinal within the block.
+  number is the block height in which the satoshi was mined, the second the
+  offset of the satoshi within the block.
 
 - *Degree notation*:
   [`3°111094′214″16797‴`](https://ordinals.com/ordinal/3%C2%B0111094%E2%80%B2214%E2%80%B316797%E2%80%B4).

From 23eadd79c5986ab3768d04dbb632b902de51a335 Mon Sep 17 00:00:00 2001
From: Casey Rodarmor <casey@rodarmor.com>
Date: Thu, 8 Dec 2022 15:13:20 -0800
Subject: [PATCH 10/32] tweak

---
 docs/src/guides/inscriptions.md | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/docs/src/guides/inscriptions.md b/docs/src/guides/inscriptions.md
index 227b92368c..83751c80f4 100644
--- a/docs/src/guides/inscriptions.md
+++ b/docs/src/guides/inscriptions.md
@@ -11,11 +11,10 @@ the current state of the Bitcoin blockchain, and a wallet that can make
 ordinal-aware transactions that inscribe satoshis with content and transfer
 individual satoshis using ordinal theory.
 
-Bitcoin Core provides both a Bitcoin full node and Bitcoin wallet. However, the
-Bitcoin Core wallet cannot make ordinal-aware transactions. Making
-ordinal-aware transactions requires [`ord`](https://github.com/casey/ord), the
-ordinal theory utility. `ord wallet` subcommands wrap an existing Bitcoin Core
-wallet.
+Bitcoin Core provides both a Bitcoin full node and wallet. However, the Bitcoin
+Core wallet cannot make ordinal-aware transactions. Making ordinal-aware
+transactions requires [`ord`](https://github.com/casey/ord), the ordinal theory
+utility. `ord wallet` subcommands wrap an existing Bitcoin Core wallet.
 
 This guide contains everything you need to know about creating, sending, and
 receiving inscriptions:

From 5ba41bb5e14c4b33e4a3c72d5d859556a18c7891 Mon Sep 17 00:00:00 2001
From: Casey Rodarmor <casey@rodarmor.com>
Date: Thu, 8 Dec 2022 15:13:52 -0800
Subject: [PATCH 11/32] tweak

---
 docs/src/guides/inscriptions.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/docs/src/guides/inscriptions.md b/docs/src/guides/inscriptions.md
index 83751c80f4..6cf6f92514 100644
--- a/docs/src/guides/inscriptions.md
+++ b/docs/src/guides/inscriptions.md
@@ -14,7 +14,8 @@ individual satoshis using ordinal theory.
 Bitcoin Core provides both a Bitcoin full node and wallet. However, the Bitcoin
 Core wallet cannot make ordinal-aware transactions. Making ordinal-aware
 transactions requires [`ord`](https://github.com/casey/ord), the ordinal theory
-utility. `ord wallet` subcommands wrap an existing Bitcoin Core wallet.
+utility. `ord wallet` subcommands interact with an existing Bitcoin Core
+wallet.
 
 This guide contains everything you need to know about creating, sending, and
 receiving inscriptions:

From 645f19a516f53c5eb0514ffdfe0789aa9b31fabb Mon Sep 17 00:00:00 2001
From: Casey Rodarmor <casey@rodarmor.com>
Date: Thu, 8 Dec 2022 15:14:33 -0800
Subject: [PATCH 12/32] tweak

---
 docs/src/guides/inscriptions.md | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/docs/src/guides/inscriptions.md b/docs/src/guides/inscriptions.md
index 6cf6f92514..66b0135b2e 100644
--- a/docs/src/guides/inscriptions.md
+++ b/docs/src/guides/inscriptions.md
@@ -17,8 +17,7 @@ transactions requires [`ord`](https://github.com/casey/ord), the ordinal theory
 utility. `ord wallet` subcommands interact with an existing Bitcoin Core
 wallet.
 
-This guide contains everything you need to know about creating, sending, and
-receiving inscriptions:
+This guide covers:
 
 1. Installing Bitcoin Core
 2. Syncing the Bitcoin blockchain

From 7f50335c4426564410f6d46e5f7bc76de68de326 Mon Sep 17 00:00:00 2001
From: Casey Rodarmor <casey@rodarmor.com>
Date: Thu, 8 Dec 2022 15:15:24 -0800
Subject: [PATCH 13/32] tweak

---
 docs/src/guides/inscriptions.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/src/guides/inscriptions.md b/docs/src/guides/inscriptions.md
index 66b0135b2e..1e984d6cc7 100644
--- a/docs/src/guides/inscriptions.md
+++ b/docs/src/guides/inscriptions.md
@@ -30,9 +30,9 @@ This guide covers:
 Getting Help
 ------------
 
-A guide can only do so much! If you get stuck, try asking for help on the
-[Ordinal Theory Discord Server](https://discord.com/invite/87cjuz4FYg), or
-checking GitHub for relevant [issues](https://github.com/casey/ord/issues) and
+If you get stuck, try asking for help on the [Ordinal Theory Discord
+Server](https://discord.com/invite/87cjuz4FYg), or checking GitHub for relevant
+[issues](https://github.com/casey/ord/issues) and
 [discussions](https://github.com/casey/ord/discussions).
 
 Installing Bitcoin Core

From 99629ddbfde25d9063143c4b76ba1b33f3d0c8d3 Mon Sep 17 00:00:00 2001
From: Casey Rodarmor <casey@rodarmor.com>
Date: Thu, 8 Dec 2022 15:17:19 -0800
Subject: [PATCH 14/32] tweak

---
 docs/src/guides/inscriptions.md | 22 +++++++++++-----------
 1 file changed, 11 insertions(+), 11 deletions(-)

diff --git a/docs/src/guides/inscriptions.md b/docs/src/guides/inscriptions.md
index 1e984d6cc7..96ff539001 100644
--- a/docs/src/guides/inscriptions.md
+++ b/docs/src/guides/inscriptions.md
@@ -79,7 +79,7 @@ unintentionally using the `ord` utility with non-ordinal Bitcoin wallets.
 To create a wallet for use with `ord`, run:
 
 ```
-bitcoin-wallet -signet -wallet=ord create
+bitcoin-cli -signet createwallet ord
 ```
 
 Loading the Bitcoin Core Wallet
@@ -109,7 +109,7 @@ Inscriptions are made on individual satoshis, using normal Bitcoin transactions
 that pay fees in satoshis, so your wallet will need some sats.
 
 
-Get a new address from your `ord` wallet by running `ord --chain=signet wallet
+Get a new address from your `ord` wallet by running `ord --chain signet wallet
 receive`
 
 Use a signet faucet to send satoshis to the address you generated. Two faucets
@@ -117,7 +117,7 @@ you might try are [signet.bc-2.jp](https://signet.bc-2.jp/) and
 [alt.signetfaucet.com](https://alt.signetfaucet.com/).
 
 Once the faucet transaction confirms, you should be able to see the
-transactions outputs with `ord --chain=signet wallet utxos`.
+transactions outputs with `ord --chain signet wallet utxos`.
 
 Creating Inscription Content
 ----------------------------
@@ -138,7 +138,7 @@ Creating Inscriptions
 To create an inscription with the contents of `CONTENTS`, run:
 
 ```
-ord --chain=signet wallet inscribe --file CONTENTS
+ord --chain signet wallet inscribe --file CONTENTS
 ```
 
 Ord will output two transactions IDs, one for the commit transaction, and one
@@ -157,7 +157,7 @@ Once the reveal transaction has been mined, the inscription ID should be
 printed when you run:
 
 ```
-ord --chain=signet wallet inscriptions
+ord --chain signet wallet inscriptions
 ```
 
 And when you visit [the signet ordinals explorer](https://signet.ordinals.com/)
@@ -170,20 +170,20 @@ Sending Inscriptions
 Ask the recipient to generate a new address by running:
 
 ```
-ord --chain=signet wallet receive
+ord --chain signet wallet receive
 ```
 
 Send the inscription by running:
 
 ```
-ord --chain=signet wallet send INSCRIPTION_ID ADDRESS
+ord --chain signet wallet send INSCRIPTION_ID ADDRESS
 ```
 
 Once the send transaction confirms, the recipient can confirm receipt by
 running:
 
 ```
-ord --chain=signet wallet inscriptions
+ord --chain signet wallet inscriptions
 ```
 
 Receiving Inscriptions
@@ -192,17 +192,17 @@ Receiving Inscriptions
 Generate a new receive address using:
 
 ```
-ord --chain=signet wallet receive
+ord --chain signet wallet receive
 ```
 
 The sender can transfer the inscription to your address using:
 
 ```
-ord --chain=signet wallet send INSCRIPTION_ID ADDRESS
+ord --chain signet wallet send INSCRIPTION_ID ADDRESS
 ```
 
 Once the send transaction confirms, you can can confirm receipt by running:
 
 ```
-ord --chain=signet wallet inscriptions
+ord --chain signet wallet inscriptions
 ```

From d7b53dc8e56afb71fa0d9b71deeffe9f81b004f6 Mon Sep 17 00:00:00 2001
From: Casey Rodarmor <casey@rodarmor.com>
Date: Thu, 8 Dec 2022 15:21:51 -0800
Subject: [PATCH 15/32] tweak

---
 docs/src/guides/inscriptions.md | 23 +++++++++++++++++------
 1 file changed, 17 insertions(+), 6 deletions(-)

diff --git a/docs/src/guides/inscriptions.md b/docs/src/guides/inscriptions.md
index 96ff539001..13fc64a6e6 100644
--- a/docs/src/guides/inscriptions.md
+++ b/docs/src/guides/inscriptions.md
@@ -45,16 +45,27 @@ This guide does not cover installing Bitcoin Core in detail. Once Bitcoin Core
 is installed, you should be able to run `bitcoind -version` successfully from
 the command line.
 
-Configuring Bitcoin Core to use Signet
---------------------------------------
+Configuring Bitcoin Core
+------------------------
 
 `ord wallet` subcommands cannot yet be used on mainnet, so your Bitcoin Core
 node must be configured to use another chain. This guide uses signet, but
-testnet or regtest mode may also be used.
+testnet or regtest mode may also be used. Additionally, `ord` uses Bitcoin
+Core's transaction index.
 
-To configure your Bitcoin Core node to use signet, add `signet=1` to your
-`bitcoin.conf` configuration file, or pass `-signet` to `bitcoind` and
-`bitcoin-cli`, e.g. `bitcoind -signet` and `bitcoin-cli -signet`.
+To configure your Bitcoin Core node to use signet and maintain the transaction
+index, add the following to your `bitcoin.conf`:
+
+```
+signet=1
+txindex=1
+```
+
+Or, run `bitcoind` with `-signet` and `-txindex`:
+
+```
+bitcoind -signet -txindex
+```
 
 Syncing the Bitcoin Blockchain
 ------------------------------

From 17aefd50333abcc1f8c412b3c09cfcbed776cb04 Mon Sep 17 00:00:00 2001
From: Casey Rodarmor <casey@rodarmor.com>
Date: Thu, 8 Dec 2022 15:22:34 -0800
Subject: [PATCH 16/32] tweak

---
 docs/src/guides/inscriptions.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/src/guides/inscriptions.md b/docs/src/guides/inscriptions.md
index 13fc64a6e6..fdf5d9cf41 100644
--- a/docs/src/guides/inscriptions.md
+++ b/docs/src/guides/inscriptions.md
@@ -50,7 +50,7 @@ Configuring Bitcoin Core
 
 `ord wallet` subcommands cannot yet be used on mainnet, so your Bitcoin Core
 node must be configured to use another chain. This guide uses signet, but
-testnet or regtest mode may also be used. Additionally, `ord` uses Bitcoin
+testnet or regtest mode may also be used. Additionally, `ord` requires Bitcoin
 Core's transaction index.
 
 To configure your Bitcoin Core node to use signet and maintain the transaction

From 52327093f51a5664dedf618c5c0f419b563eed9a Mon Sep 17 00:00:00 2001
From: Casey Rodarmor <casey@rodarmor.com>
Date: Thu, 8 Dec 2022 15:23:48 -0800
Subject: [PATCH 17/32] tweak

---
 docs/src/guides/inscriptions.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/src/guides/inscriptions.md b/docs/src/guides/inscriptions.md
index fdf5d9cf41..525190ebc0 100644
--- a/docs/src/guides/inscriptions.md
+++ b/docs/src/guides/inscriptions.md
@@ -53,7 +53,7 @@ node must be configured to use another chain. This guide uses signet, but
 testnet or regtest mode may also be used. Additionally, `ord` requires Bitcoin
 Core's transaction index.
 
-To configure your Bitcoin Core node to use signet and maintain the transaction
+To configure your Bitcoin Core node to use signet and maintain a transaction
 index, add the following to your `bitcoin.conf`:
 
 ```

From 2ae1b1ef44be74a64501e0355fa244b496223688 Mon Sep 17 00:00:00 2001
From: Casey Rodarmor <casey@rodarmor.com>
Date: Thu, 8 Dec 2022 15:24:24 -0800
Subject: [PATCH 18/32] tweak

---
 docs/src/guides/inscriptions.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/src/guides/inscriptions.md b/docs/src/guides/inscriptions.md
index 525190ebc0..825898034d 100644
--- a/docs/src/guides/inscriptions.md
+++ b/docs/src/guides/inscriptions.md
@@ -73,7 +73,7 @@ Syncing the Bitcoin Blockchain
 Once Bitcoin Core has been configured to use signet, you'll need to sync the
 blockchain. Signet is a low-volume test network, so this shoudln't take long.
 
-To sync the chain, run `bitcoind -signet` and leave it running until
+To sync the chain, run `bitcoind -signet -txindex` and leave it running until
 `bitcoin-cli -signet getblockcount` agrees with the block count on a block
 explorer like [the mempool.space signet block
 explorer](https://mempool.space/signet).

From 8b462daa232e5b416faeecd4a7f8492d78441f25 Mon Sep 17 00:00:00 2001
From: Casey Rodarmor <casey@rodarmor.com>
Date: Thu, 8 Dec 2022 15:25:17 -0800
Subject: [PATCH 19/32] tweak

---
 docs/src/guides/inscriptions.md | 1 -
 1 file changed, 1 deletion(-)

diff --git a/docs/src/guides/inscriptions.md b/docs/src/guides/inscriptions.md
index 825898034d..8a2ef74305 100644
--- a/docs/src/guides/inscriptions.md
+++ b/docs/src/guides/inscriptions.md
@@ -119,7 +119,6 @@ Receiving Satoshis
 Inscriptions are made on individual satoshis, using normal Bitcoin transactions
 that pay fees in satoshis, so your wallet will need some sats.
 
-
 Get a new address from your `ord` wallet by running `ord --chain signet wallet
 receive`
 

From 05800a82dec0ae250cbf987c2bbf00229f9bf788 Mon Sep 17 00:00:00 2001
From: Casey Rodarmor <casey@rodarmor.com>
Date: Thu, 8 Dec 2022 15:27:33 -0800
Subject: [PATCH 20/32] tweak

---
 docs/src/guides/inscriptions.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/src/guides/inscriptions.md b/docs/src/guides/inscriptions.md
index 8a2ef74305..84675545a9 100644
--- a/docs/src/guides/inscriptions.md
+++ b/docs/src/guides/inscriptions.md
@@ -139,8 +139,8 @@ explorer are currently limited to `.png` and `.txt` files.
 
 Additionally, inscriptions made on signet must be 1024 bytes or less, to avoid
 congesting signet for other users. Inscriptions are stored in Taproot input
-witnesses, so mainnet inscriptions will only be limited by the 4,000,000 byte
-witness size limit.
+witnesses, so mainnet inscriptions will only be limited by the depth of you
+pockets and the 4,000,000 byte witness size limit.
 
 Creating Inscriptions
 ---------------------

From 29de2413460e32687cc7d6c518a2062a3870d28f Mon Sep 17 00:00:00 2001
From: Casey Rodarmor <casey@rodarmor.com>
Date: Thu, 8 Dec 2022 15:28:38 -0800
Subject: [PATCH 21/32] tweak

---
 docs/src/guides/inscriptions.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/src/guides/inscriptions.md b/docs/src/guides/inscriptions.md
index 84675545a9..38751c0c42 100644
--- a/docs/src/guides/inscriptions.md
+++ b/docs/src/guides/inscriptions.md
@@ -71,7 +71,7 @@ Syncing the Bitcoin Blockchain
 ------------------------------
 
 Once Bitcoin Core has been configured to use signet, you'll need to sync the
-blockchain. Signet is a low-volume test network, so this shoudln't take long.
+blockchain. Signet is a low-volume test network, so this shouldn't take long.
 
 To sync the chain, run `bitcoind -signet -txindex` and leave it running until
 `bitcoin-cli -signet getblockcount` agrees with the block count on a block
@@ -110,7 +110,7 @@ The `ord` utility is written in Rust and can be built from
 [source](https://github.com/casey/ord). Pre-built binaries are available on the
 [releases page](https://github.com/casey/ord/releases).
 
-Once `ord` is installed, you shoud be able to run `ord --version` on the
+Once `ord` is installed, you should be able to run `ord --version` on the
 command line.
 
 Receiving Satoshis
@@ -155,7 +155,7 @@ Ord will output two transactions IDs, one for the commit transaction, and one
 for the reveal transaction.
 
 The commit transaction commits to a tapscript containing the contents of the
-inscription, and the reveal transaction spends from that tapscript, reaveling
+inscription, and the reveal transaction spends from that tapscript, revealing
 the contents on chain and inscribing them on the first satoshi of the first
 output of the reveal transaction.
 

From c57bdb3ed5e0fb38ada49e7e73f32f5f7dbffa99 Mon Sep 17 00:00:00 2001
From: Casey Rodarmor <casey@rodarmor.com>
Date: Thu, 8 Dec 2022 15:35:46 -0800
Subject: [PATCH 22/32] tweak

---
 docs/src/guides/inscriptions.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/src/guides/inscriptions.md b/docs/src/guides/inscriptions.md
index 38751c0c42..b1b2f3cf76 100644
--- a/docs/src/guides/inscriptions.md
+++ b/docs/src/guides/inscriptions.md
@@ -127,7 +127,7 @@ you might try are [signet.bc-2.jp](https://signet.bc-2.jp/) and
 [alt.signetfaucet.com](https://alt.signetfaucet.com/).
 
 Once the faucet transaction confirms, you should be able to see the
-transactions outputs with `ord --chain signet wallet utxos`.
+transactions outputs in `ord --chain signet wallet utxos`.
 
 Creating Inscription Content
 ----------------------------

From 6d5f9e2d574e79f1163e0e90b011e27ad2809510 Mon Sep 17 00:00:00 2001
From: Casey Rodarmor <casey@rodarmor.com>
Date: Thu, 8 Dec 2022 15:35:59 -0800
Subject: [PATCH 23/32] tweak

---
 docs/src/guides/inscriptions.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/src/guides/inscriptions.md b/docs/src/guides/inscriptions.md
index b1b2f3cf76..38751c0c42 100644
--- a/docs/src/guides/inscriptions.md
+++ b/docs/src/guides/inscriptions.md
@@ -127,7 +127,7 @@ you might try are [signet.bc-2.jp](https://signet.bc-2.jp/) and
 [alt.signetfaucet.com](https://alt.signetfaucet.com/).
 
 Once the faucet transaction confirms, you should be able to see the
-transactions outputs in `ord --chain signet wallet utxos`.
+transactions outputs with `ord --chain signet wallet utxos`.
 
 Creating Inscription Content
 ----------------------------

From 4321249c7603e180dea73fab3c41cb7106311bf0 Mon Sep 17 00:00:00 2001
From: Casey Rodarmor <casey@rodarmor.com>
Date: Thu, 8 Dec 2022 15:36:57 -0800
Subject: [PATCH 24/32] tweak

---
 docs/src/guides/inscriptions.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/src/guides/inscriptions.md b/docs/src/guides/inscriptions.md
index 38751c0c42..8ca66977b0 100644
--- a/docs/src/guides/inscriptions.md
+++ b/docs/src/guides/inscriptions.md
@@ -139,7 +139,7 @@ explorer are currently limited to `.png` and `.txt` files.
 
 Additionally, inscriptions made on signet must be 1024 bytes or less, to avoid
 congesting signet for other users. Inscriptions are stored in Taproot input
-witnesses, so mainnet inscriptions will only be limited by the depth of you
+witnesses, so mainnet inscriptions will only be limited by the depths of you
 pockets and the 4,000,000 byte witness size limit.
 
 Creating Inscriptions

From c365dea242154a0a6d6b3d4b0373c45ee49047fc Mon Sep 17 00:00:00 2001
From: Casey Rodarmor <casey@rodarmor.com>
Date: Thu, 8 Dec 2022 15:37:10 -0800
Subject: [PATCH 25/32] tweak

---
 docs/src/guides/inscriptions.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/src/guides/inscriptions.md b/docs/src/guides/inscriptions.md
index 8ca66977b0..12af0cc658 100644
--- a/docs/src/guides/inscriptions.md
+++ b/docs/src/guides/inscriptions.md
@@ -139,7 +139,7 @@ explorer are currently limited to `.png` and `.txt` files.
 
 Additionally, inscriptions made on signet must be 1024 bytes or less, to avoid
 congesting signet for other users. Inscriptions are stored in Taproot input
-witnesses, so mainnet inscriptions will only be limited by the depths of you
+witnesses, so mainnet inscriptions will only be limited by the depths of your
 pockets and the 4,000,000 byte witness size limit.
 
 Creating Inscriptions

From a41b58fdffeef6a8c76db2fb6897a96ba02a05e1 Mon Sep 17 00:00:00 2001
From: Casey Rodarmor <casey@rodarmor.com>
Date: Thu, 8 Dec 2022 15:37:33 -0800
Subject: [PATCH 26/32] tweak

---
 docs/src/guides/inscriptions.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/src/guides/inscriptions.md b/docs/src/guides/inscriptions.md
index 12af0cc658..67a3caf883 100644
--- a/docs/src/guides/inscriptions.md
+++ b/docs/src/guides/inscriptions.md
@@ -145,10 +145,10 @@ pockets and the 4,000,000 byte witness size limit.
 Creating Inscriptions
 ---------------------
 
-To create an inscription with the contents of `CONTENTS`, run:
+To create an inscription with the contents of `FILE`, run:
 
 ```
-ord --chain signet wallet inscribe --file CONTENTS
+ord --chain signet wallet inscribe --file FILE
 ```
 
 Ord will output two transactions IDs, one for the commit transaction, and one

From 98e7e2ca68124660cc8d7f125485ffbec65d11ac Mon Sep 17 00:00:00 2001
From: Casey Rodarmor <casey@rodarmor.com>
Date: Thu, 8 Dec 2022 15:39:09 -0800
Subject: [PATCH 27/32] tweak

---
 docs/src/introduction.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/src/introduction.md b/docs/src/introduction.md
index 1568b8db71..afe7a22c8e 100644
--- a/docs/src/introduction.md
+++ b/docs/src/introduction.md
@@ -2,8 +2,8 @@ Introduction
 ============
 
 This handbook is a guide to ordinal theory. Ordinal theory concerns itself with
-distinguishing satoshis, giving them an identity and allowing them to be
-tracked and transferred individually.
+satoshis, giving them identifies and allowing them to be tracked, transferred,
+and imbued with meaning.
 
 Satoshis, not bitcoin, are the atomic, native currency of the Bitcoin network.
 One bitcoin can be sub-divided into 100,000,000 satoshis, but no further.

From ed6b895b772e90519569a418c8dd66968f3a4cd5 Mon Sep 17 00:00:00 2001
From: Casey Rodarmor <casey@rodarmor.com>
Date: Thu, 8 Dec 2022 15:40:48 -0800
Subject: [PATCH 28/32] tweak

---
 docs/src/introduction.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/src/introduction.md b/docs/src/introduction.md
index afe7a22c8e..7d5e332164 100644
--- a/docs/src/introduction.md
+++ b/docs/src/introduction.md
@@ -2,8 +2,8 @@ Introduction
 ============
 
 This handbook is a guide to ordinal theory. Ordinal theory concerns itself with
-satoshis, giving them identifies and allowing them to be tracked, transferred,
-and imbued with meaning.
+satoshis, giving them individual identities and allowing them to be tracked,
+transferred, and imbued with meaning.
 
 Satoshis, not bitcoin, are the atomic, native currency of the Bitcoin network.
 One bitcoin can be sub-divided into 100,000,000 satoshis, but no further.

From ccb5965d99bee6a9166648ee7e67e7b47763dc92 Mon Sep 17 00:00:00 2001
From: Casey Rodarmor <casey@rodarmor.com>
Date: Thu, 8 Dec 2022 15:44:28 -0800
Subject: [PATCH 29/32] tweak

---
 docs/src/introduction.md | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/docs/src/introduction.md b/docs/src/introduction.md
index 7d5e332164..0a0e3bc1a7 100644
--- a/docs/src/introduction.md
+++ b/docs/src/introduction.md
@@ -8,9 +8,8 @@ transferred, and imbued with meaning.
 Satoshis, not bitcoin, are the atomic, native currency of the Bitcoin network.
 One bitcoin can be sub-divided into 100,000,000 satoshis, but no further.
 
-Ordinal theory is not a side chain, does not require any token aside from
-Bitcoin, and can be used without any changes to the Bitcoin network. It works
-right now.
+Ordinal theory does not require a sidechain or token aside from Bitcoin, and
+can be used without any changes to the Bitcoin network. It works right now.
 
 Ordinal theory imbues satoshis with numismatic value, allowing them to
 collected and traded as curios.

From c8be08911f509ab6603ea93a6519b2bb00fbea0e Mon Sep 17 00:00:00 2001
From: Casey Rodarmor <casey@rodarmor.com>
Date: Thu, 8 Dec 2022 15:45:23 -0800
Subject: [PATCH 30/32] tweak

---
 docs/src/introduction.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/src/introduction.md b/docs/src/introduction.md
index 0a0e3bc1a7..8802badb57 100644
--- a/docs/src/introduction.md
+++ b/docs/src/introduction.md
@@ -15,7 +15,7 @@ Ordinal theory imbues satoshis with numismatic value, allowing them to
 collected and traded as curios.
 
 Individual satoshis can be inscribed with arbitrary content, creating
-Bitcoin-native digital artifacts that can be held in a Bitcoin wallet and
+Bitcoin-native digital artifacts that can be held in Bitcoin wallets and
 transferred using Bitcoin transactions. Inscriptions are as durable, immutable,
 secure, and decentralized as the Bitcoin blockchain itself.
 

From e3bec72fea5b339833e34a6ae19006fbb946fba0 Mon Sep 17 00:00:00 2001
From: Casey Rodarmor <casey@rodarmor.com>
Date: Thu, 8 Dec 2022 15:48:40 -0800
Subject: [PATCH 31/32] tweak

---
 docs/src/introduction.md | 2 +-
 docs/src/overview.md     | 7 ++++++-
 2 files changed, 7 insertions(+), 2 deletions(-)

diff --git a/docs/src/introduction.md b/docs/src/introduction.md
index 8802badb57..0ede3bea8d 100644
--- a/docs/src/introduction.md
+++ b/docs/src/introduction.md
@@ -21,7 +21,7 @@ secure, and decentralized as the Bitcoin blockchain itself.
 
 Other, more unusual use-cases are possible: off-chain colored-coins, public key
 infrastructure with key rotation, a decentralized replacement for the DNS. For
-now though, such use cases are theoretical, and exist only in the minds of
+now though, such use-cases are theoretical, and exist only in the minds of
 fringe ordinal theorists.
 
 For more details on ordinal theory, see the [overview](overview.md).
diff --git a/docs/src/overview.md b/docs/src/overview.md
index f52db68076..c9f94a61b9 100644
--- a/docs/src/overview.md
+++ b/docs/src/overview.md
@@ -5,7 +5,12 @@ Ordinals are a numbering scheme for satoshis that allows tracking and
 transferring individual sats. These numbers are called [ordinal
 numbers](https://ordinals.com). Satoshis are numbered in the order in which
 they're mined, and transferred from transaction inputs to transaction outputs
-first-in-first-out. Technical details are available in [the
+first-in-first-out. Both the numbering scheme and the transfer scheme rely on
+*order*, the numbering scheme on the *order* in which satoshis are mined, and
+the transfer scheme on the *order* of transaction inputs and outputs. Thus the
+name, *ordinals*.
+
+Technical details are available in [the
 BIP](https://github.com/casey/ord/blob/master/bip.mediawiki).
 
 Ordinals don't require a separate token, another blockchain, or any changes to

From bfe6a1d0e3c5e6a4c27e9b6a4d21c819058d08a0 Mon Sep 17 00:00:00 2001
From: Casey Rodarmor <casey@rodarmor.com>
Date: Thu, 8 Dec 2022 15:51:56 -0800
Subject: [PATCH 32/32] tweak

---
 docs/src/overview.md | 16 +++++++++-------
 1 file changed, 9 insertions(+), 7 deletions(-)

diff --git a/docs/src/overview.md b/docs/src/overview.md
index c9f94a61b9..cc169cc1a9 100644
--- a/docs/src/overview.md
+++ b/docs/src/overview.md
@@ -13,14 +13,15 @@ name, *ordinals*.
 Technical details are available in [the
 BIP](https://github.com/casey/ord/blob/master/bip.mediawiki).
 
-Ordinals don't require a separate token, another blockchain, or any changes to
+Ordinals do not require a separate token, another blockchain, or any changes to
 Bitcoin. They work right now.
 
 Ordinal numbers have a few different representations:
 
 - *Integer notation*:
   [`2099994106992659`](https://ordinals.com/ordinal/2099994106992659) The
-  ordinal number, assigned according to the order the satoshi was mined.
+  ordinal number, assigned according to the order in which the satoshi was
+  mined.
 
 - *Decimal notation*:
   [`3891094.16797`](https://ordinals.com/ordinal/3891094.16797) The first
@@ -200,9 +201,9 @@ shorter the further into the future the satoshi was mined. They could start
 short and get longer, but then all the good, short names would be trapped in
 the unspendable genesis block.
 
-As isan example, 1905530482684727°'s name is "iaiufjszmoba". The name of the
-last satoshi to be mined is "a". Every combination of 10 characters or less is
-out there, or will be out there, some day.
+As an example, 1905530482684727°'s name is "iaiufjszmoba". The name of the last
+satoshi to be mined is "a". Every combination of 10 characters or less is out
+there, or will be out there, some day.
 
 Exotics
 -------
@@ -221,10 +222,11 @@ Inscriptions
 ------------
 
 Satoshis can be inscribed with arbitrary content, creating Bitcoin-native
-digital artifacts. Inscribing is done by sending the satoshi to be inscrbied in
+digital artifacts. Inscribing is done by sending the satoshi to be inscribed in
 a transaction that reveals the inscription content on-chain. This content is
 then inextricably linked to that satoshi, turning it into an immutable digital
-artifact that can be tracked, transfered, hoarded, bought, and sold.
+artifact that can be tracked, transferred, hoarded, bought, sold, lost, and
+rediscovered.
 
 Archaeology
 -----------