Raven Trader Pro (EXTREMELY ALPHA!)

The first and (currently) only integrated application for creating asset buy and sell orders for the ravencoin network via raw transactions. These transactions are signed using SIGHASH_SINGLE|SIGHASH_ANYONECANPAY which allows for on-chain swaps to take place with only 2 steps of user interaction, one for each party, and only a single transaction published to the chain. The order is fully inspectable at all steps along the way, leading to maximum transparency, while ensuring fast efficient orders can take place.

Disclaimer: This software is in still in early development, and potentially involves financial transactions, please havily review all transactions to watch for any potential errors

Screenshot

Setup:

• Install Python 3.7 & PIP
• Windows: pip install -r requirements.txt
• Linux: python3.7 -m pip install -r requirements.txt
• Make sure raven core wallet is running with the following raven.conf variables
• Set the values in config.py accordingly

Running:

• Windows: python main.py
• Linux: python3.7 main.py

raven.conf Variables

server=1
rpcuser=<user>
rpcpassword=<password>

Features (Roughly in order)

• Adding "Pro" to the name
• Create Buy Orders.
• Create Sell Orders.
• Complete Buy/Sell Orders.
• Asset List
• Soft-locking UTXO's (UTXO's setup on the buy/sell screen are locked to prevent use when setting up future UTXO's.)
• Soft-Remove Trade Order (Hide, but remember so it can be displayed if executed.)
• Hard-Remove Trade Order (Invalidate the previous UTXO by using it in a transaction to yourself.)
• Asset <-> Asset swaps
• [Optional] Hard-Locking of UTXO's (UTXOs will appear gone and will be unspendable to core wallet.) This prevents accidental order invalidation
• Bulk buy/sell order creation. Would require making & locking many UTXO's individually.
• System notification on completed trade
• Proxy asset signing/reissuing. (Party A owns admin asset, Party B requests a child asset be minted/reissued/etc under A's admin asset.)
• Proper asset decimal/metadata support.
• Available UTXO dialog (with option to manually lock/unlock? UTXO's.)
• Settings menu
• -- Preferred rvn/asset destination address
• -- Previous order history age (remove records after x days)
• -- Adjustable fee rate for optionally faster confirmation
• IPFS content preview

Side-Channel Support

There is a companion repository raven-trader-server, a C# Asp.Net Core cross-platform web-server for indexing the chain for exectued swaps and providing that data via an API. This site will hopefully serve as a baseline implementation for an open standard of an api trading interface.

Client Features

• Post orders to API
• Purchase from API
• Preview historical asset prices on buy/sell
• Local automated purchase/sale at specific price (you are executing and therefore paying fees, but get guaranteed execution if there is an available order at a given price)

Server Features

• Indexer: Blocks, transaction count, asset volume, and swap history.
• Indexer: Asset metadata, full tx history.
• Indexer: Invalidate orders on execution
• Indexer: Re-org detection and handling
• API: Validate & Store swaps
• API: Get swap history
• API: Get active listings
• Web: 24hr volume, recent swaps, add new swap
• Web: Asset list & history, omnisearch, documentation/guide
• General: Asset <-> Asset swap support

Process

This application follows the RIP-15 procedure for creating and completing 2-step swap transactions. At a high-level the process looks like this:

1. A creates a partial order (buy or sell)
2. A announces that order over a side-channel, such as Dicord, a trading website, direct messaging or any other means
3. B gets the order from A
4. B verifies the order is as-advertised, and executes at-will

Technical

UTXO's (Unspent Transaction Outputs)

This is important related information to how these trades operate. At a high-level, all blockchain balances are stored as a collection of UTXO's. For example, if A sends B 10 RVN, B will then have a 10 RVN UTXO in his wallet, in addition to all his previous. When he goes to spend it, he must use it in it's entirety, so he might pay someone 1 RVN for goods/services, and he would then send the remaining 9 RVN (minus fees) to himself, leaving himself with an 8.99## RVN UTXO.

tl;dr: Total wallet balances are made up of individual UTXO's, UTXO's must be spent in full during a transaction, so any change is created as a new UTXO.

• The party creating the order
• The selling party must sell using a single UTXO, which in almost-all cases will require explicity setting up a UTXO to prepare a buy order.
• The buying party mu

Important Considerations

• After creation, orders are not published anywhere, they are simply a partially signed transaction stating one of the following
  • Buy: "I will provide {total price} RVN, send {quantity} of {asset} to this destination"
  • Sell: "I will provide {quantity} of {asset}, send {total price} RVN to this destination"
  • These partial transaction are invalid by themselves (missing assets/rvn from one side) so must be made valid by a second party to complete
  • The partial transaction cannot be modified as it has been signed with [SIGHASH_SINGLE|SIGHASH_ANYONECANPAY]
• Due to the nature of how these orders are constructed, a Signed Partial is indefinietly valid as long as that UTXO is, this is why a Hard-Remove of an order is needed.
• The party setting up the order will almost

Instructions

Creating a Buy/Sell Order

1. Click "New Buy/Sell Order"
2. For buying, type and verify an asset name. It will also show the total quantity available.
3. For selling, select an asset from the list of your assets.
4. Enter the quantity and per-unit price for the sell order
5. Create a UTXO if needed (see section about UTXO's)
6. [Optional] Specify a destination for where the output RVN/Assets should be sent. If not supplied one will be automatically generated like normal.
7. Accept the order
8. The "Signed Partial" can be posted or provided to a second party for them to complete an order
9. The completed order will stay in the corresponding buy/sell list until it is recognized as completed, at which point it will move to the order history.

Completing an Order

1. Click "Verify/Complete Order"
2. Paste the hex provided into the "Signed Partial" field.
3. Verify all the order details look as-advertised (make sure the asset name, quantity and unit-price all line up) and Cofirm
4. Verify the final preview order looks accurate.
5. Execute when ready