Document teleburning handbook (ordinals#2577)

docs/src/SUMMARY.md

@@ -1,4 +1,6 @@
-# Summary
+Summary
+=======
+
 [Introduction](introduction.md)
 - [Overview](overview.md)
 - [Digital Artifacts](digital-artifacts.md)
@@ -15,6 +17,7 @@
   - [Inscriptions](guides/inscriptions.md)
   - [Batch Inscribing](guides/batch-inscribing.md)
   - [Sat Hunting](guides/sat-hunting.md)
+  - [Teleburning](guides/teleburning.md)
   - [Collecting](guides/collecting.md)
     - [Sparrow Wallet](guides/collecting/sparrow-wallet.md)
   - [Testing](guides/testing.md)

docs/src/guides/teleburning.md

@@ -0,0 +1,50 @@
+Teleburning
+===========
+
+Teleburn addresses can be used to burn assets on other blockchains, leaving
+behind in the smoking rubble a sort of forwarding address pointing to an
+inscription on Bitcoin.
+
+Teleburning an asset means something like, "I'm out. Find me on Bitcoin."
+
+Teleburn addresses are derived from inscription IDs. They have no corresponding
+private key, so assets sent to a teleburn address are burned. Currently, only
+Ethereum teleburn addresses are suppported. Pull requests adding teleburn
+addresses for other chains are welcome.
+
+Ethereum
+--------
+
+Ethereum teleburn addresses are derived by taking the first 20 bytes of the
+SHA-256 hash of the inscription ID, serialized as 36 bytes, with the first 32
+bytes containing the transaction ID, and the last four bytes containing
+big-endian inscription index, and interpreting it as an Ethereum address.
+
+Example
+-------
+
+The ENS domain name [rodarmor.eth](https://app.ens.domains/rodarmor.eth), was
+teleburned to [inscription
+zero](https://ordinals.com/inscription/6fb976ab49dcec017f1e201e84395983204ae1a7c2abf7ced0a85d692e442799i0).
+
+Running the inscription ID of inscription zero is
+`6fb976ab49dcec017f1e201e84395983204ae1a7c2abf7ced0a85d692e442799i0`.
+
+Passing `6fb976ab49dcec017f1e201e84395983204ae1a7c2abf7ced0a85d692e442799i0` to
+the teleburn command:
+
+```bash
+$ ord teleburn 6fb976ab49dcec017f1e201e84395983204ae1a7c2abf7ced0a85d692e442799i0
+```
+
+Returns:
+
+```json
+{
+  "ethereum": "0xe43A06530BdF8A4e067581f48Fae3b535559dA9e"
+}
+```
+
+Indicating that `0xe43A06530BdF8A4e067581f48Fae3b535559dA9e` is the Ethereum
+teleburn address for inscription zero, which is, indeed, the current owner, on
+Ethereum, of `rodarmor.eth`.