gl-sdk 0.2.0

High-level SDK for Greenlight with UniFFI language bindings
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

"""Tests for the parse_input() free function.

Verifies BOLT11 invoice and node ID parsing from arbitrary string input.
"""

import pytest
import glsdk


# Valid BOLT11 invoice (11 sats, mainnet)
BOLT11_INVOICE = (
    "lnbc110n1p38q3gtpp5ypz09jrd8p993snjwnm68cph4ftwp22le34xd4r8ftspwshxhm"
    "nsdqqxqyjw5qcqpxsp5htlg8ydpywvsa7h3u4hdn77ehs4z4e844em0apjyvmqfkzqhh"
    "d2q9qgsqqqyssqszpxzxt9uuqzymr7zxcdccj5g69s8q7zzjs7sgxn9ejhnvdh6gqjcy"
    "22mss2yexunagm5r2gqczh8k24cwrqml3njskm548aruhpwssq9nvrvz"
)

# Valid compressed secp256k1 public key (starts with 02 or 03, 33 bytes = 66 hex chars)
VALID_NODE_ID = "02eec7245d6b7d2ccb30380bfbe2a3648cd7a942653f5aa340edcea1f283686619"


class TestParseInputTypes:
    """Test that parse_input types exist in the bindings."""

    def test_input_type_enum_exists(self):
        assert hasattr(glsdk, "InputType")

    def test_bolt11_invoice_type_exists(self):
        assert hasattr(glsdk, "ParsedInvoice")

    def test_parse_input_function_exists(self):
        assert hasattr(glsdk, "parse_input")


class TestParseInputNodeId:
    """Test node ID parsing."""

    def test_parse_valid_node_id(self):
        result = glsdk.parse_input(VALID_NODE_ID)
        assert isinstance(result, glsdk.InputType)

    def test_parse_node_id_returns_correct_value(self):
        result = glsdk.parse_input(VALID_NODE_ID)
        # Access the NodeId variant
        assert result.is_node_id() if hasattr(result, 'is_node_id') else True
        # UniFFI enums in Python: check the variant
        assert hasattr(result, 'node_id') or hasattr(result, 'invoice')

    def test_invalid_hex_returns_error(self):
        with pytest.raises(glsdk.Error):
            glsdk.parse_input("not_valid_hex_at_all_but_66_chars_long_xxxxxxxxxxxxxxxxxxxxxxxxxxx")

    def test_wrong_length_hex_returns_error(self):
        with pytest.raises(glsdk.Error):
            glsdk.parse_input("02eec7245d6b7d2ccb30380bfbe2a3648cd7a942653f5aa340edcea1f283")

    def test_wrong_prefix_hex_returns_error(self):
        # 04 prefix = uncompressed pubkey, not valid for Lightning
        with pytest.raises(glsdk.Error):
            glsdk.parse_input("04eec7245d6b7d2ccb30380bfbe2a3648cd7a942653f5aa340edcea1f283686619")


class TestParseInputBolt11:
    """Test BOLT11 invoice parsing."""

    def test_parse_valid_bolt11(self):
        result = glsdk.parse_input(BOLT11_INVOICE)
        assert isinstance(result, glsdk.InputType)

    def test_parse_bolt11_with_lightning_prefix(self):
        result = glsdk.parse_input("lightning:" + BOLT11_INVOICE)
        assert isinstance(result, glsdk.InputType)

    def test_parse_bolt11_with_uppercase_prefix(self):
        result = glsdk.parse_input("LIGHTNING:" + BOLT11_INVOICE)
        assert isinstance(result, glsdk.InputType)

    def test_parse_bolt11_with_whitespace(self):
        result = glsdk.parse_input("  " + BOLT11_INVOICE + "  ")
        assert isinstance(result, glsdk.InputType)


class TestParseInputErrors:
    """Test error cases."""

    def test_empty_string_returns_error(self):
        with pytest.raises(glsdk.Error):
            glsdk.parse_input("")

    def test_whitespace_only_returns_error(self):
        with pytest.raises(glsdk.Error):
            glsdk.parse_input("   ")

    def test_garbage_returns_error(self):
        with pytest.raises(glsdk.Error):
            glsdk.parse_input("hello world")

    def test_bitcoin_address_returns_error(self):
        # We don't support bitcoin addresses yet
        with pytest.raises(glsdk.Error):
            glsdk.parse_input("bc1qw508d6qejxtdg4y5r3zarvary0c5xw7kv8f3t4")