A robosats command-line interface
Roboauto aims to be a full robosats client, and an alternative to the main web client. It is mainly intended for makers with multiple offers. To use it, it requires a lightning node, or a wallet that exposes apis for creating and paying invoices.
Robots are divided in 4 directories: active, pending, paused and inactive.
Active are all the robots that have an active offer not yet taken.
Pending are robots that have pending offers.
Paused are robots that do not currently have an online offer, for example robots just generated, and robots that have a paused offer.
Inactive are old robots that have a completed offer.
Main command of roboauto is keep-online. After you have generated
robots from different coordinators, and created make offers, roboauto keep-online will automatically recreate offers when they expire, and
notify the user when an order is taken, by running the message-notification
script. Optionally it will also automatically pay escrow/send invoice of
taken orders.
Examples scripts for simplex and mutt are provided.
To run roboauto keep-online in the background it is recommended to
use tmux (or others terminal multiplexers), akin to joinmarket
yieldgenerator
$ python3 -m venv robo
$ . robo/bin/activate
$ pip install -r requirements.txt
$ pip install .
$ pip install --break-system-packages -r requirements.txt
$ pip install --break-system-packages .
Copy config/config.ini to ~/.config/roboauto/config.ini and edit it.
Create scripts lightning-node and message-notification in ~/.config/roboauto/, some examples are in data/
lightning-node should support 3 actions:
- check: takes an invoice and an amount and exits with an error status if the invoice is not for the correct amount
- pay: takes an invoice and a label and pays the invoice
- invoice: takes an amount and a label, create the invoice and prints it to stdout
message-notification takes an event and a message, and should send a message notification.
If you use core lightning and simplex for notifications:
cp data/lightning-node-core-lightning ~/.config/roboauto/lightning-node
cp data/message-notification-simplex ~/.config/roboauto/message-notification
Source completions/roboauto.bash-completion in ~/.bashrc
If the bash completion package is installed there are better completions in
create-order, recreate-order and change-order-expire
$ roboauto --help
$ roboauto --verbose-help
# generate a robot with a coordinator
$ roboauto generate-robot --exp
RobotName
# create the order and lock the bond
$ roboauto create-order RobotName type=sell currency=eur min_amount=300 max_amount=900 payment_method="Instant SEPA" premium=5
RobotName order-id sell eur 300-900 5.00 Instant SEPA Waiting for maker bond
invoice checked successfully
checking if order is bonded...
checking if order is bonded...
RobotName bonded successfully, order is public
RobotName order created successfully
# if you have roboauto keep-online running
# (will add to waiting queue if orders this hour exceed maximum orders per hour)
# $ roboauto create-order --no-bond RobotName type=sell currency=eur min_amount=300 max_amount=900 payment_method="Instant SEPA" premium=5
# print the token if you want to import it in the robosats website
$ roboauto print-token RobotName
************************************
$ roboauto import-robot --exp
insert robot name:
insert token:
# get notified when your offers get taken and recreate them when they expire
# if you want to also pay escrow/send invoice check seconds_pending_order in config.ini
$ roboauto keep-online
# or with more logs
# $ roboauto keep-online --verbosity=1
# take a look at the books of all the coordinators
$ roboauto list-offers --all usd "strike"
exp ord-id PeerRobotName sell usd 8h 3.00 4.00% - 150 300 00:00:00 Strike
...
# lock the bond
$ roboauto take-order YourRobotName order-id 200
YourRobotName PeerRobotName order-id sell usd 150-300 4.00 Strike Waiting for taker bond
invoice checked successfully
checking if order is bonded...
checking if order is bonded...
YourRobotName bonded successfully, order is taken
YourRobotName order-id taken successfully
# submit the invoice
$ roboauto invoice-send YourRobotName
YourRobotName order-id sell usd 200 4.00 Strike Waiting for trade collateral and buyer invoice
YourRobotName order-id invoice sent successfully
# or pay the escrow if you are the seller
# roboauto escrow-pay YourRobotName
# or pay the bond and pay the escrow/send the invoice automatically
# $ roboauto take-order --fully YourRobotName order-id 200
# see what your peer is saying
$ roboauto chat-print YourRobotName
1933/04/05 00:00:00 E PeerRobotName
Hello robot!
# chat with your peer
$ roboauto message-send YourRobotName 'Hello! How can I pay you?'
message sent correctly
now E YourRobotName
Hello! How can I pay you?
...
# check the order status to see if the seller confirmed the payment
$ roboauto order-info --simple YourRobotName | jq -r '.status_string'
# confirm you have received the payment
$ roboauto confirm-send YourRobotName
# rate the robosats coordinator 5 stars!
$ roboauto rate-coordinator 5
YourRobotName order-id sell usd 200 4.00 Strike Sucessful trade
YourRobotName order-id robosats rated 5 stars
- simple apis: info historical limits price ticks
- import robot
- generate robot
- list the books of the coordinators
- robot info
- update stealth option
- order info
- create/recreate order
- cancel order
- take order
- toggle pause for order
- pay escrow, send invoice/address for order
- print chat and send messages
- second/undo confirmations of payments
- start dispute
- submit dispute statement
- rate coordinator
- claim rewards
- keep online orders, recreate them when they expire
- change orders next time they expire
- send message notification when an order is taken
- set a maximum of offer per hour
- different tor circuit for each robot
- automatically pay escrow/send invoice
- handle expired/unpaid invoices
- core lightning
- lnd
- eclair, ldk, other nodes or wallets with apis
- other message notification, ex telegram, nostr
- fast chat with websocket
Roboauto is released under the terms of the ISC license. See LICENSE for more details.