hypersdk 0.3.0

Rust SDK for Hyperliquid
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

# Regenerate from the repository root:
# uv run --with hyperliquid-python-sdk==0.24.0 python src/hypercore/testdata/generate_signing.py
# The fixture uses only throwaway keys and performs no network/API transactions.
import json
from importlib.metadata import version
from pathlib import Path
from eth_account import Account
from eth_account.messages import encode_typed_data
from eth_utils import keccak
from hyperliquid.utils import signing as ref

nonce = 1700000000000
user = '0x1111111111111111111111111111111111111111'
key = Account.from_key('0x' + '00' * 31 + '01')
lead = key.address.lower()
other = '0x2222222222222222222222222222222222222222'
agent_types = [dict(name=n, type=t) for n,t in [('hyperliquidChain','string'),('agentAddress','address'),('agentName','string'),('nonce','uint64')]]
def encoded(data):
    signable = encode_typed_data(full_message=data)
    return '0x' + keccak(b'\x19' + signable.version + signable.header + signable.body).hex()

cases = []
contexts = []
for chain,chain_id in [('Mainnet',42161),('Testnet',421614)]:
    base = dict(signatureChainId=hex(chain_id), hyperliquidChain=chain)
    actions = [
      ('ApproveAgent', dict(type='approveAgent', **base, agentAddress=other, agentName=name, nonce=nonce), agent_types)
      for name in ['', 'bot']
    ] + [
      ('TokenDelegate', dict(type='tokenDelegate', **base, validator=other, wei=100000000, isUndelegate=undelegate, nonce=nonce), ref.TOKEN_DELEGATE_TYPES)
      for undelegate in [False, True]
    ]
    for kind, action, types in actions:
      normal = ref.user_signed_payload('HyperliquidTransaction:'+kind, types, action)
      multi = ref.user_signed_payload('HyperliquidTransaction:'+kind, ref.add_multi_sig_types(types), ref.add_multi_sig_fields(action,user,lead))
      cases.append(dict(chain=chain,nonce=nonce,action=action,prehash=encoded(normal),multisigPrehash=encoded(multi)))
    for vault in [None, other]:
      for expiry in [None, nonce+10000]:
        action = dict(type='borrowLend',operation='supply',token=0,amount='10')
        connection = ref.action_hash([user,lead,action],vault,nonce,expiry)
        data = ref.l1_payload(ref.construct_phantom_agent(connection,chain=='Mainnet'))
        contexts.append(dict(chain=chain,nonce=nonce,action=action,vault=vault,expiresAfter=expiry,prehash=encoded(data)))
fixture = dict(source='hyperliquid-python-sdk '+version('hyperliquid-python-sdk')+' hyperliquid/utils/signing.py',multisigUser=user,leader=lead,userSigned=cases,l1Contexts=contexts)
Path('src/hypercore/testdata/signing.json').write_text(json.dumps(fixture,indent=2)+'\n')
print(fixture['source'], ':', len(cases), 'user-signed and',len(contexts),'L1 fixtures')