summaryrefslogtreecommitdiff
path: root/content/openalias.md
diff options
context:
space:
mode:
Diffstat (limited to 'content/openalias.md')
-rw-r--r--content/openalias.md103
1 files changed, 103 insertions, 0 deletions
diff --git a/content/openalias.md b/content/openalias.md
new file mode 100644
index 0000000..49c73fe
--- /dev/null
+++ b/content/openalias.md
@@ -0,0 +1,103 @@
+---
+title: "OpenAlias"
+date: 2021-07-01
+tags: ["server"]
+---
+
+## The Problem
+
+Cryptocurrency can be unintuitive. After all, look at this annoying
+Monero address of ours:
+
+- `84RXmrsE7ffCe1ADprxLMHRpmyhZuWYScDR4YghE8pFRFSyLtiZFYwD6EPijVzD3aZiEpg57MfHEr1pGJNPXyJgENMnWrSh`
+
+It breaks up pages and looks ugly. When you copy and paste it to send
+money, you might be paranoid that you somehow added an extra character
+in there. That\'s all around a bad user experience.
+
+### It would be nice\...
+
+It would be nice if we could just input someone\'s email address or
+maybe a website and send Bitcoin or Monero to that instead. So instead
+of that long jumble, it would be easier to just type in someone\'s
+website or email and sending them money that way.
+
+## The Solution
+
+The [OpenAlias](https://openalias.org/) standards are just that. It uses
+[DNS](/basic/dns) settings, which you know something about, to link a
+website or an email address with a cryptocurrency address. It allows
+someone to simply put `chad.thesiah.xyz` or `chad@thesiah.xyz` as a payment
+recipient and that will direct to that long address above.
+
+The default Monero wallet and Bitcoin\'s Electrum are already compatible
+with OpenAlias, as are a growing group of wallet software.
+
+## Let\'s do it.
+
+Open up your domain registar and open up your DNS settings for the
+website you would like to add.
+
+Open the **TXT record** section. Now, create an entry with text like
+that below:
+
+```txt
+oa1:xmr recipient_address=84RXmrsE7ffCe1ADprxLMHRpmyhZuWYScDR4YghE8pFRFSyLtiZFYwD6EPijVzD3aZiEpg57MfHEr1pGJNPXyJgENMnWrSh; recipient_name=SiCh;
+```
+
+Obviously change the address to your desired address and you may also
+give a proper name for yourself (this may be multiple words). Note that
+the entry above is **all one line**.
+
+Now create a new TXT entry and input this text into the **TXT Value**
+input box. Note here that I have create two entries:
+
+{{< img alt="openalias" src="/pix/openalias-01.png" link="/pix/openalias-01.png" >}}
+
+One entry\'s \"Host\" is left empty, this will allow people to send
+Monero by merely typing `chad.thesiah.xyz`.
+
+The second entry has \"chad\" as the \"Host\"; this will allow people to
+send money to `chad@thesiah.xyz`, i.e. this is how you allow people to
+connect a Monero address with an email address.
+
+### Checking to see if it works\...
+
+Let\'s check to see if it works. In the Monero wallet, we can now type
+in `chad.thesiah.xyz` as a recipient:
+
+{{< img alt="checking" src="/pix/openalias-02.png" link="/pix/openalias-02.png" >}}
+
+And once we press the \"Resolve\" button, it automatically turns into
+that address we gave to the DNS!
+
+{{< img alt="It works!" src="/pix/openalias-03.png" link="/pix/openalias-03.png" >}}
+
+Now people can donate Monero to you without having to worry about QR
+codes or copying-and-pasting super-long public addresses!
+
+### Now with Bitcoin!
+
+OpenAlias was originally developed for Monero, but since it\'s such a
+good idea, Bitcoin wallets have implemented it as well, so let\'s add
+some TXT entries for Bitcoin. The OpenAlias TXT records have the same
+format, except for the **xmr** at the beginning is replaced with **btc**
+and obviously we use a Bitcoin address instead of Monero.
+
+```txt
+oa1:btc recipient_address=bc1q9f3tmkhnxj8gduytdktlcw8yrnx3g028nzzsc5; recipient_name=SiCh;
+```
+
+Add the TXT entries in and save:
+
+{{< img alt="bitcoin openalias entries" src="/pix/openalias-04.png" link="/pix/openalias-04.png" >}}
+
+And we can then check that it\'s working by trying to send money to
+`chad.thesiah.xyz` in Electrum. See that it automatically appends the
+address!
+
+{{< img alt="electrum resolves an openalias" src="/pix/openalias-05.png" link="/pix/openalias-05.png" >}}
+
+And that\'s it. Now users can easily send your website or email address
+Bitcoin or Monero without having to worry about hard to read addresses
+and QR codes.