dydx-v3-rust 0.2.3

Rust SDK for dYdX v3 API
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

from collections import namedtuple
import math

from dydx_constants import COLLATERAL_ASSET
from dydx_constants import COLLATERAL_ASSET_ID_BY_NETWORK_ID
from starkex.constants import ONE_HOUR_IN_SECONDS
from starkex.constants import TRANSFER_FIELD_BIT_LENGTHS
from starkex.constants import TRANSFER_PADDING_BITS
from starkex.constants import TRANSFER_PREFIX
from starkex.constants import TRANSFER_FEE_ASSET_ID
from starkex.constants import TRANSFER_MAX_AMOUNT_FEE
from starkex.helpers import nonce_from_client_id
from starkex.helpers import to_quantums_exact
from starkex.signable import Signable
from starkex.starkex_resources.proxy import get_hash

StarkwareTransfer = namedtuple(
    'StarkwareTransfer',
    [
        'sender_position_id',
        'receiver_position_id',
        'receiver_public_key',
        'quantums_amount',
        'nounce',
        'expiration_epoch_hours',
    ],
)


class SignableTransfer(Signable):
    """
    Wrapper object to convert a transfer, and hash, sign, and verify its
    signature.
    """

    def __init__(
        self,
        network_id,
        sender_position_id,
        receiver_position_id,
        receiver_public_key,
        human_amount,
        client_id,
        expiration_epoch_seconds,
    ):
        nounce = nonce_from_client_id(client_id)

        # The transfer asset is always the collateral asset.
        quantums_amount = to_quantums_exact(
            human_amount,
            COLLATERAL_ASSET,
        )

        # Convert to a Unix timestamp (in hours).
        expiration_epoch_hours = math.ceil(
            float(expiration_epoch_seconds) / ONE_HOUR_IN_SECONDS,
        )

        receiver_public_key = (
            receiver_public_key
            if isinstance(receiver_public_key, int)
            else int(receiver_public_key, 16)
        )

        message = StarkwareTransfer(
            sender_position_id=int(sender_position_id),
            receiver_position_id=int(receiver_position_id),
            receiver_public_key=receiver_public_key,
            quantums_amount=quantums_amount,
            nounce=nounce,
            expiration_epoch_hours=expiration_epoch_hours
        )

        super(SignableTransfer, self).__init__(network_id, message)

    def to_starkware(self):
        return self._message

    def _calculate_hash(self):
        """Calculate the hash of the Starkware order."""
        # TODO: Check values are in bounds

        asset_ids = get_hash(
            COLLATERAL_ASSET_ID_BY_NETWORK_ID[self.network_id],
            TRANSFER_FEE_ASSET_ID,
        )

        part1 = get_hash(
            asset_ids,
            self._message.receiver_public_key,
        )

        part2 = self._message.sender_position_id
        part2 <<= TRANSFER_FIELD_BIT_LENGTHS['position_id']
        part2 += self._message.receiver_position_id
        part2 <<= TRANSFER_FIELD_BIT_LENGTHS['position_id']
        part2 += self._message.sender_position_id
        part2 <<= TRANSFER_FIELD_BIT_LENGTHS['nonce']
        part2 += self._message.nounce

        part3 = TRANSFER_PREFIX
        part3 <<= TRANSFER_FIELD_BIT_LENGTHS['quantums_amount']
        part3 += self._message.quantums_amount
        part3 <<= TRANSFER_FIELD_BIT_LENGTHS['quantums_amount']
        part3 += TRANSFER_MAX_AMOUNT_FEE
        part3 <<= TRANSFER_FIELD_BIT_LENGTHS['expiration_epoch_hours']
        part3 += self._message.expiration_epoch_hours
        part3 <<= TRANSFER_PADDING_BITS

        return get_hash(
            get_hash(
                part1,
                part2,
            ),
            part3,
        )