rostrum 14.0.1

An efficient implementation of Electrum Server with token support
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203

#!/usr/bin/env python3
# Copyright (c) 2021-2023 The Bitcoin Unlimited developers
import asyncio
from test_framework.utilcompat import lock, unlock
from test_framework.serialize import to_hex
from test_framework.script import OP_DEPTH, CScript, OP_DROP, OP_NOP, OP_TRUE
from test_framework.util import assert_equal
from test_framework.electrumutil import (
    ElectrumTestFramework,
    get_txid_from_idem,
)
from test_framework.environment import on_bch, on_nex
from test_framework.electrumconnection import ElectrumConnection
from test_framework.utiltx import pad_tx

if on_bch():
    from test_framework.bch.blocktools import create_transaction
elif on_nex():
    from test_framework.nex.blocktools import create_transaction
else:
    raise NotImplementedError()

GET_UTXO = "blockchain.utxo.get"
TX_BROADCAST = "blockchain.transaction.broadcast"


class ElectrumUtxoTests(ElectrumTestFramework):
    async def run_test(self):
        await self.bootstrap_p2p()
        cli = ElectrumConnection()
        await cli.connect()
        coinbases = await self.mine_blocks(cli, self.nodes[0], 106)

        try:
            await self.test_get_all(
                cli, self.nodes[0], [coinbases.pop(0), coinbases.pop(0)]
            )

            if not on_nex():
                # TODO: Write filter tests for nexa
                await self.test_scriptsig_filter(
                    cli, self.nodes[0], [coinbases.pop(0), coinbases.pop(0)]
                )

                await self.test_scriptpubkey_filter(
                    cli, self.nodes[0], [coinbases.pop(0), coinbases.pop(0)]
                )

        finally:
            cli.disconnect()

    async def test_get_all(self, cli, n, utxos):
        scriptpubkey = CScript([OP_NOP])

        tx1 = create_transaction(
            utxos[0],
            n=0,
            sig=unlock(CScript([])),
            out=lock(scriptpubkey),
            value=utxos[0].vout[0].n_value - 1000,
        )
        pad_tx(tx1)
        tx2 = create_transaction(
            utxos[1],
            n=0,
            sig=unlock(CScript([])),
            out=lock(scriptpubkey),
            value=utxos[1].vout[0].n_value - 1000,
        )
        pad_tx(tx2)

        n = self.nodes[0]

        # Mempool is empty before broadcast
        mempool = await cli.call("mempool.get")
        assert_equal(0, len(mempool["transactions"]))

        tx1_id = await get_txid_from_idem(n, await cli.call(TX_BROADCAST, tx1.to_hex()))
        tx2_id = await get_txid_from_idem(n, await cli.call(TX_BROADCAST, tx2.to_hex()))

        await self.wait_for_mempool_count(cli, count=2)
        mempool = await cli.call("mempool.get")
        print(mempool)
        assert_equal(2, len(mempool["transactions"]))
        assert tx1_id in mempool["transactions"]
        assert tx2_id in mempool["transactions"]

        # Clean mempool
        await self.mine_blocks(cli, n, 1, [tx1, tx2])

    async def test_scriptsig_filter(self, cli, n, coinbases):
        scriptpubkey = CScript([OP_DROP, OP_TRUE])

        tx1 = create_transaction(
            coinbases[0],
            n=0,
            sig=CScript([OP_TRUE]),
            out=scriptpubkey,
            value=coinbases[0].vout[0].n_value - 1000,
        )
        pad_tx(tx1)
        tx2 = create_transaction(
            tx1,
            n=0,
            sig=CScript([b"FILTERME"]),
            out=scriptpubkey,
            value=tx1.vout[0].n_value - 1000,
        )
        pad_tx(tx2)

        n = self.nodes[0]

        # Mempool is empty before broadcast
        mempool = await cli.call("mempool.get")
        assert_equal(0, len(mempool["transactions"]))

        tx1_id = await get_txid_from_idem(n, await cli.call(TX_BROADCAST, tx1.to_hex()))
        tx2_id = await get_txid_from_idem(n, await cli.call(TX_BROADCAST, tx2.to_hex()))

        await self.wait_for_mempool_count(cli, count=2)
        mempool = await cli.call(
            "mempool.get", {"scriptsig": to_hex(b"FILTERME").decode("ascii")}
        )
        print(mempool)
        assert_equal(1, len(mempool["transactions"]))
        assert tx1_id not in mempool["transactions"]
        assert tx2_id in mempool["transactions"]

        # Clean mempool
        await self.mine_blocks(cli, n, 1, [tx1, tx2])

    async def test_scriptpubkey_filter(self, cli, n, utxos):
        scriptpubkey1 = CScript([OP_DROP, OP_TRUE])
        scriptpubkey2 = CScript([OP_DEPTH])

        tx1 = create_transaction(
            utxos[0],
            n=0,
            sig=CScript([OP_TRUE]),
            out=scriptpubkey1,
            value=utxos[0].vout[0].n_value - 1000,
        )
        pad_tx(tx1)
        tx2 = create_transaction(
            tx1,
            n=0,
            sig=CScript([b"FILTERME"]),
            out=scriptpubkey2,
            value=tx1.vout[0].n_value - 1000,
        )
        pad_tx(tx2)

        n = self.nodes[0]

        # Mempool is empty before broadcast
        mempool = await cli.call("mempool.get")
        assert_equal(0, len(mempool["transactions"]))

        tx1_id = await get_txid_from_idem(n, await cli.call(TX_BROADCAST, tx1.to_hex()))
        tx2_id = await get_txid_from_idem(n, await cli.call(TX_BROADCAST, tx2.to_hex()))

        await self.wait_for_mempool_count(cli, count=2)
        mempool = await cli.call("mempool.get", {"scriptpubkey": scriptpubkey1.hex()})
        assert_equal(1, len(mempool["transactions"]))
        assert tx1_id in mempool["transactions"]
        assert tx2_id not in mempool["transactions"]

        # Try 'union' (should match both)
        both_filter = {
            "scriptpubkey": scriptpubkey1.hex(),
            "scriptsig": to_hex(b"FILTERME").decode("ascii"),
        }
        both_filter["operation"] = "union"
        mempool = await cli.call("mempool.get", both_filter)
        assert_equal(2, len(mempool["transactions"]))

        # 'except' should exclude both in this case
        both_filter["operation"] = "except"
        mempool = await cli.call("mempool.get", both_filter)
        assert_equal(0, len(mempool["transactions"]))

        # 'except' should be default
        del both_filter["operation"]
        mempool = await cli.call("mempool.get", both_filter)
        assert_equal(0, len(mempool["transactions"]))

        # 'except' filter that should match tx2
        both_filter = {
            "scriptpubkey": scriptpubkey2.hex(),
            "scriptsig": to_hex(b"FILTERME").decode("ascii"),
            "operation": "except",
        }
        mempool = await cli.call("mempool.get", both_filter)
        print(mempool)
        assert_equal(1, len(mempool["transactions"]))
        assert tx2_id in mempool["transactions"]

        # Clean mempool
        await self.mine_blocks(cli, n, 1, [tx1, tx2])


if __name__ == "__main__":
    asyncio.run(ElectrumUtxoTests().main())