UTXOs Accounting

UTXOs & Balances
If you are a developer coming from Ethereum, the biggest practical difference is that Hydra's account model is built on Bitcoin's UTXOs.
In Ethereum, you'd typically have an account with an unique address that holds a balance. You'd be sending/receiving money and interacting with Smart Contracts using one account.
In HYDRA, you don't really have accounts. Instead, you have a collection of UTXOs, each of which has its own address. An UTXO may be used only once when you send money or interact with a Smart Contract. If an UTXO has more value than you intend to use, it'd be split up into multiple UTXOs after a transaction.
In this chapter we'll explore the UTXO model by sending some money using the cli command, and peeking into the transaction data.
Later in Part II we'll see how HYDRA's Smart Contract implementation bridges Bitcoin's UTXO model with Ethereum's account model.
UTXO Address
With UTXO, you can reuse a payment address. For better anonymity, though, you'd typically generate new addresses for each payment you'd like to receive.
Let's generate an address:
1
hydra-cli getnewaddress
Copied!
You get a new address:
1
HfsPCLrjjmqXptxWNXXg3wQruzC8bhPx63
Copied!
Get as many as you want:
1
> hydra-cli getnewaddress
2
HZWeFWECjKQ3KstHhCjxFj9hiM7jzXWw3p
3
​
4
> hydra-cli getnewaddress
5
HJbSKruSXWnjSRZvSXMf2Y33gEw9FqHMHf
6
​
7
> hydra-cli getnewaddress
8
Hdiqg2mp646KhSQjVud3whv6C34hNHQnL2
Copied!
An UTXO address is 20 bytes (160 bits) long, base58 encoded. This is the same length as Ethereum's address. We can convert it to an Ethereum compatible hexadecimal address:
1
hydra-cli gethexaddress Hdiqg2mp646KhSQjVud3whv6C34hNHQnL2
2
​
3
dd2c6512563e4274dafd8312e0e738ede48f3046
Copied!
And to convert it back to base58 UTXO address:
1
hydra-cli fromhexaddress dd2c6512563e4274dafd8312e0e738ede48f3046
2
​
3
Hdiqg2mp646KhSQjVud3whv6C34hNHQnL2
Copied!
Send Money Transaction
Now let's send money to an UTXO address. You'd be sending money to yourself, but this is exactly the same process as when you send money to somebody else.
First generate a new receiving address:
1
hydra-cli getnewaddress
2
​
3
Hdiqg2mp646KhSQjVud3whv6C34hNHQnL2
Copied!
(You should replace the following commands with the address you've generated.)
Next, send 10 Hydras to this address:
1
hydra-cli sendtoaddress Hdiqg2mp646KhSQjVud3whv6C34hNHQnL2 10
Copied!
A transaction ID (txid) is returned for this transfer:
1
11e790d26d6996803960ef1586cbaeb54af20fd3e1f41508843c36f2ef60bb9d
Copied!
Wait for a minute or two for the transaction be be confirmed. You should see something like this in the container's log:
1
07:25:54  hydrad | CTransaction(hash=11e790d26d, ver=2, vin.size=1, vout.size=2, nLockTime=1680)
2
07:25:54  hydrad |     CTxIn(COutPoint(5ada2447bc, 1), scriptSig=473044022063b61ff64f6340, nSequence=4294967294)
3
07:25:54  hydrad |     CScriptWitness()
4
07:25:54  hydrad |     CTxOut(nValue=19979.99832800, scriptPubKey=76a914dc41025b0c419681bffc3446)
5
07:25:54  hydrad |     CTxOut(nValue=10.00000000, scriptPubKey=76a914dd2c6512563e4274dafd8312)
Copied!
Use gettransaction to get some general information about this transaction:
1
hydra-cli gettransaction 11e790d26d6996803960ef1586cbaeb54af20fd3e1f41508843c36f2ef60bb9d
2
​
3
{
4
  "amount": 0.00000000,
5
  "fee": -0.00090400,
6
  "confirmations": 2,
7
  "blockhash": "63b646290e7924a15073b7a2b1bde9f35c40d8de73a15eeea00d80a3ee7f7f70",
8
  "blockindex": 2,
9
  "blocktime": 1513149968,
10
  "txid": "11e790d26d6996803960ef1586cbaeb54af20fd3e1f41508843c36f2ef60bb9d",
11
  "walletconflicts": [
12
  ],
13
  "time": 1513149954,
14
  "timereceived": 1513149954,
15
  "bip125-replaceable": "no",
16
  "details": [
17
    {
18
      "account": "",
19
      "address": "hdiqg2mp646KhSQjVud3whv6C34hNHQnL2",
20
      "category": "send",
21
      "amount": -10.00000000,
22
      "label": "",
23
      "vout": 1,
24
      "fee": -0.00090400,
25
      "abandoned": false
26
    },
27
    {
28
      "account": "",
29
      "address": "hdiqg2mp646KhSQjVud3whv6C34hNHQnL2",
30
      "category": "receive",
31
      "amount": 10.00000000,
32
      "label": "",
33
      "vout": 1
34
    }
35
  ],
36
  "hex": "02000000017d2c908ccf224c7204024699fa9bee9cafc4319297e3c682b2d2d4bc4724da5a010000006a473044022063b61ff64f63407a7ef1e2060d6f54cae987a10b30d20b55d722f69e0bcc225e0220340fa34885cb0bdf056067d90f16b53318d44861872635051963237623c63699012102dd47f2c6e005fdc2182135ffe72c985a095ca9c59000d7f1576ed8717ef6e017feffffff02e0fe1132d10100001976a914dc41025b0c419681bffc3446ee8b506dde59e18e88ac00ca9a3b000000001976a914dd2c6512563e4274dafd8312e0e738ede48f304688ac90060000"
37
}
Copied!
This transaction had been confirmed twice so far:
1
"confirmations": 2,
Copied!
Let's now use listunspent to list recently created UTXOs. List UTXOs that had been confirmed less than 20 times:
1
hydra-cli listunspent 0 20
2
​
3
[
4
  {
5
    "txid": "11e790d26d6996803960ef1586cbaeb54af20fd3e1f41508843c36f2ef60bb9d",
6
    "vout": 0,
7
    "address": "hddyh9oMU44qZ28bEY9WhCDbmCaALVDr1k",
8
    "scriptPubKey": "76a914dc41025b0c419681bffc3446ee8b506dde59e18e88ac",
9
    "amount": 19989.99923200,
10
    "confirmations": 11,
11
    "spendable": true,
12
    "solvable": true
13
  },
14
  {
15
    "txid": "11e790d26d6996803960ef1586cbaeb54af20fd3e1f41508843c36f2ef60bb9d",
16
    "vout": 1,
17
    "address": "hdiqg2mp646KhSQjVud3whv6C34hNHQnL2",
18
    "account": "",
19
    "scriptPubKey": "76a914dd2c6512563e4274dafd8312e0e738ede48f304688ac",
20
    "amount": 10.00000000,
21
    "confirmations": 11,
22
    "spendable": true,
23
    "solvable": true
24
  }
25
]
Copied!
Note that both of these UTXOs share the same txid. In other words, one send money transaction created two new UTXOs:
hdiqg2mp646KhSQjVud3whv6C34hNHQnL2: Receiving address, holding value of 10.
hddyh9oMU44qZ28bEY9WhCDbmCaALVDr1k: The original sender UTXO had 20k HYDRA, the amount generated. This a new UTXO created to hold the change, minus fees.
Decoding Transaction Data
We can dig a little deeper into the transaction data to see that HYDRA really shares the same UTXO data structure as Bitcoin. From the earlier gettransaction output, we got the raw transaction data in hexadecimals (i.e. 02000000017d2...ac90060000).
Let's decode the transaction data:
1
hydra-cli decoderawtransaction \
2
02000000017d2c908ccf224c7204024699fa9bee9cafc4319297e3c682b2d2d4bc4724da5a010000006a473044022063b61ff64f63407a7ef1e2060d6f54cae987a10b30d20b55d722f69e0bcc225e0220340fa34885cb0bdf056067d90f16b53318d44861872635051963237623c63699012102dd47f2c6e005fdc2182135ffe72c985a095ca9c59000d7f1576ed8717ef6e017feffffff02e0fe1132d10100001976a914dc41025b0c419681bffc3446ee8b506dde59e18e88ac00ca9a3b000000001976a914dd2c6512563e4274dafd8312e0e738ede48f304688ac90060000
Copied!
The decoded transaction:
1
{
2
  "txid": "11e790d26d6996803960ef1586cbaeb54af20fd3e1f41508843c36f2ef60bb9d",
3
  "hash": "11e790d26d6996803960ef1586cbaeb54af20fd3e1f41508843c36f2ef60bb9d",
4
  "size": 225,
5
  "vsize": 225,
6
  "version": 2,
7
  "locktime": 1680,
8
  "vin": [
9
    {
10
      "txid": "5ada2447bcd4d2b282c6e3979231c4af9cee9bfa99460204724c22cf8c902c7d",
11
      "vout": 1,
12
      "scriptSig": {
13
        "asm": "3044022063b61ff64f63407a7ef1e2060d6f54cae987a10b30d20b55d722f69e0bcc225e0220340fa34885cb0bdf056067d90f16b53318d44861872635051963237623c63699[ALL] 02dd47f2c6e005fdc2182135ffe72c985a095ca9c59000d7f1576ed8717ef6e017",
14
        "hex": "473044022063b61ff64f63407a7ef1e2060d6f54cae987a10b30d20b55d722f69e0bcc225e0220340fa34885cb0bdf056067d90f16b53318d44861872635051963237623c63699012102dd47f2c6e005fdc2182135ffe72c985a095ca9c59000d7f1576ed8717ef6e017"
15
      },
16
      "sequence": 4294967294
17
    }
18
  ],
19
  "vout": [
20
    {
21
      "value": 19989.99923200,
22
      "n": 0,
23
      "scriptPubKey": {
24
        "asm": "OP_DUP OP_HASH160 dc41025b0c419681bffc3446ee8b506dde59e18e OP_EQUALVERIFY OP_CHECKSIG",
25
        "hex": "76a914dc41025b0c419681bffc3446ee8b506dde59e18e88ac",
26
        "reqSigs": 1,
27
        "type": "pubkeyhash",
28
        "addresses": [
29
          "hddyh9oMU44qZ28bEY9WhCDbmCaALVDr1k"
30
        ]
31
      }
32
    },
33
    {
34
      "value": 10.00000000,
35
      "n": 1,
36
      "scriptPubKey": {
37
        "asm": "OP_DUP OP_HASH160 dd2c6512563e4274dafd8312e0e738ede48f3046 OP_EQUALVERIFY OP_CHECKSIG",
38
        "hex": "76a914dd2c6512563e4274dafd8312e0e738ede48f304688ac",
39
        "reqSigs": 1,
40
        "type": "pubkeyhash",
41
        "addresses": [
42
          "qdiqg2mp646KhSQjVud3whv6C34hNHQnL2"
43
        ]
44
      }
45
    }
46
  ]
47
}
Copied!
As you can see, this is a Pay-to-PubkeyHash transaction!
Summary
HYDRA manages money using Bitcoin's UTXO model. Instead of using accounts to track balances, a HYDRA wallet keeps track of the collection of UTXOs. When a transaction is created, the wallet searches the collection to find UTXOs that add up to enough value to pay for the amount transferred and the fees.

Essentials

Test & Main Networks

Last modified 11mo ago

Copy link

Contents

UTXOs & Balances

UTXO Address

Send Money Transaction

Decoding Transaction Data

Summary