AdaBot

AdaBot is a tipping bot for use with Cardano blockchain, which is being operated on Libera IRC network. You can find it in channels such as #cardano on irc.libera.chat

The concept of tipping bot is very simple - users can deposit and withdraw ADA tokens in or from the tipping bot into their personal account. Then they can use the off-chain capabilities of this bot to transfer any amount they wish to other users on Libera IRC network, free of charge, instantly off-chain. Any user that holds enough funds (1ADA + transfer fee of ~0.18ADA) can withdraw these funds anytime from the bot back to their private wallets.

Basically, you could say that AdaBot is IRC based Cardano Wallet. Each user can deposit to their personal Cardano address, send to other users and withdraw back to their private wallets.

Why?

You may ask - what is this actually good for? For convenience and simplicity mostly. Cardano blockchain comes with certain limitations as any blockchain - first of all, each on-chain transaction must be at least 1 ADA in volume. This is not convenient, given that price of ADA tokens is becoming higher over time. With tipping bot you can easily send much lower amounts of ADA to your friends over IRC. Smallest amount you can send is 1 lovelace.

In addition to that, bot transactions are for free, compared to ~0.18 on-chain transaction fee and basically instant. You can also send to IRC users without knowing their wallet addresses, in fact, you can even send ADA to users who don't even have a Cardano wallet! These users can either send the ADA to someone else using bot, or they can withdraw it once they create their own private wallet.

How much does it cost?

Nothing. Depositing, storing, or sending is completely free of charge. Withdrawals contain fee, but that is imposed by cardano network, not by the bot. Bot operators get nothing from withdrawal fees. The only reward that bot operators get are from staking rewards of the underlying cardano wallet.

Security basics

Bot primarily identifies users by their hostname. It's recommended to use it only when your hostname is static and not easily overtaken by other users. You should request a cloak on libera to make sure your hostname is unique and protected. In addition the bot comes with concept of password protection. You can password protect your account and use unique account ID and password to claim the account should your hostname change. You can also protect it with additional layer that will lock your account everytime you log-off (or after specific time). Your account will not be allowed to withdraw or send ADA to anyone unless you unlock it using your password.

Commands

@balance

Shows your current balance, works in channel or private message

@deposit

Shows your personal deposit address to which you can send ADA to increase your off-chain holdings. Works in channel or private message.

@withdraw amount_in_lovelace@address

Example: @withdraw 200000000@addr_xxxxxxxx will send 200ADA to addr_xxxxxxxx. Works in channel or private message.

@fee amount_in_lovelace@address

Example: @fee 200000000@addr_xxxxxxxx will display max_fee. Cardano can't guarantee how much the transaction will cost, but it can calculate minimal and maximal potential cost. This will display the maximal potential cost of transaction. Bot will require your account to have at least this fee and amount you want to withdraw in your balance in order to withdraw from it. The actual fee may be lower. The bot will only deduct the actual fee from your balance when you withdraw, but this is maximum that it might be.

@send amount nick

Example: @send 800 petan Sends amount to nickname in channel. Works only in channel. Amount is in lovelace, but you can suffix it with ADA to send million times more, for example 1ADA will send 1000000 lovelace.

Private message commands

@password PW

Sets a password for your UUID, this is very useful and recommended action for anyone who has any positive balance on bot. You can use combination of UUID and password to regain access to your balance in case your hostname changes. You can also lock your account and prevent fund theft in case someone overtakes your hostname or hacks your IRC account.

@protect

Locks your account, it will be impossible to withdraw or send to anyone

@unprotect PW

Unlocks your account

@get-uuid

Display your UUID, it's recommended to save your UUID and password on safe place in order to regain access to your balance in future.

@claim-uuid UUID PW

In case your hostname changes and you lose access to your balance, you can use this command to merge balances of your both accounts into your old one and to change your old hostname to new one