- 1 Sending coins by text
- 2 Technical
- 3 Security
- 4 Human-friendly
- 5 No third party
- 6 Server-side
- 7 Cashback
- 8 Sending funds directly to email addresses
- 9 Batch creation of textcoins
- 10 External links
- 11 References
Sending coins by text
With the release of wallet version 2.0, Obyte users can send Bytes by email. Even if the recipient is not in Obyte yet. The sender just writes an email address where he would normally write a Obyte address. When he hits “Send”, his email app is opened with prefilled text for the recipient. The sender can edit it before sending.
The recipient receives an email with a link. For example:
Here is your link to receive 0.001 GB. https://byteball.org/openapp.html#textcoin?pact-volume-lazy-midnight-mix-cool-fiction-symbol-tag-fiction-coral-sibling
He clicks the link and the money is added to his balance. If he doesn’t have a wallet yet, he is prompted to install one in order to receive the money.
There are more options. When the sender is on a mobile phone and switches to the wallet "Share via message" tab, he is able to use all the options available through the phone’s standard "Share" menu: text message, Telegram, WhatsApp, WeChat, Signal, Viber, Slack, Facebook Messenger, Skype, etc. The recipient receives the same link, but through a chat app.
You can "refill" a textcoin address you have created/emptied. Simply find the interim address in your wallet history, top it up, and when the new transaction is confirmed the original link will work again.
All public assets
With version 2.1, you can send any public asset by textcoin, not only Bytes.
All private assets
With version 2.3, you can send any private asset by textcoin, not only Blackbytes. To maintain privacy, Blackbytes are sent peer-to-peer and contain the entire history of the coin. That is why they carry a lot more information than public textcoins and have to be delivered as digital files.
So, unlike regular textcoins sent as Bytes, Blackbyte textcoins must be transferred via a medium which permits the sending of digital files, such as email or WhatsApp.
To claim the funds, click on the file.
Another small but important update: when a textcoin link is clicked on Android which doesn't have Obyte app installed yet, the user will be automatically redirected to our app on Google Play and the textcoin will be passed on to Google Play, then to the newly installed app, and claimed immediately after the wallet is created. Which is a very smooth process for new users. 
On the technical part, the link which is delivered contains a BIP39 mnemonic (we use dashes instead of spaces to avoid confusion with a wallet seed). Only one address, with path m/44'/0'/0'/0/0, is generated from the mnemonic, and the coins are actually sent to this address. When the recipient claims the funds his wallet restores the private key from the mnemonic (everything happens in the background and looks instantaneous), and sweeps the entire balance from this address to one of his own addresses.
Two fees have to be paid, first to fill the temporary address where the money is stored in transit, then to sweep its balance. The sender adds a small amount to cover the fees spent when sweeping. So the amount displayed in the email or text message is the exact net amount. This is to make it clearer for the recipient, especially when he is new to crypto.
The textcoins might be delivered through insecure media, such as emails or unencrypted chats. That’s why it is recommended to use them only for small amounts or through end-to-end encrypted chats, such as Signal, WhatsApp, and iMessage.
If the sender makes a mistake in the email address or chooses a wrong recipient, the money is not lost. The sender can claim the money back using the same mnemonic. It is saved in the wallet for such occasions, and a "claim back" link is available on the transaction details page.
No third party
This is like PayPal but with one important difference: the money is not kept in the custody of PayPal or any other third party. The money is sent directly from sender to recipient, peer-to-peer, in the spirit of crypto.
Now textcoins are enabled in server-side (headless) wallets and are available to developers.
See the doc about sending them.
Now, any service that has email addresses of its users (that is, almost any service) can easily mass-pay them using just email addresses.
Textcoins are also easy to integrate with chatbots. For example, a Telegram bot could reward its users for certain actions, e.g. for taking surveys or writing reviews.
You can automatically send a different textcoin to everyone on an email list you have. Then claim back the ones unclaimed after 7 days, or whatever time you choose.
See the Medium article: Using MailChimp to mass send payments as textcoins
The cashback program supports textcoins: merchants don't have to update their order forms to ask users about their Byteball address; instead they can give us the user's email address and we send a textcoin.
Sending funds directly to email addresses
You can attest an email address using the Email attestation bot. After this, anyone can send funds to your attested email address, and this will automatically be converted to the related single-address.
Batch creation of textcoins
- Updated API description
- Google Doc guide by @punqtured on how to create physical textcoins to hand out at events etc