Files
lightning/hsmd/hsm_wire.csv

2.3 KiB

1# Clients should not give a bad request but not the HSM's decision to crash.
2hsmstatus_client_bad_request,1000
3hsmstatus_client_bad_request,,id,struct pubkey
4hsmstatus_client_bad_request,,len,u16
5hsmstatus_client_bad_request,,msg,len*u8
6# Start the HSM.
7hsmctl_init,11
8hsmctl_init,,new,bool
9#include <common/bip32.h>
10hsmctl_init_reply,111
11hsmctl_init_reply,,node_id,struct pubkey
12hsmctl_init_reply,,peer_seed,struct secret
13hsmctl_init_reply,,bip32,struct ext_key
14# Get a new HSM FD, with the specified capabilities
15hsmctl_client_hsmfd,9
16hsmctl_client_hsmfd,,pubkey,struct pubkey # Which identity to report for requests
17hsmctl_client_hsmfd,,capabilities,u64
18# No content, just an fd.
19hsmctl_client_hsmfd_reply,109
20# Return signature for a funding tx.
21#include <common/utxo.h>
22# FIXME: This should also take their commit sig & details, to verify.
23hsmctl_sign_funding,4
24hsmctl_sign_funding,,satoshi_out,u64
25hsmctl_sign_funding,,change_out,u64
26hsmctl_sign_funding,,change_keyindex,u32
27hsmctl_sign_funding,,our_pubkey,struct pubkey
28hsmctl_sign_funding,,their_pubkey,struct pubkey
29hsmctl_sign_funding,,num_inputs,u16
30hsmctl_sign_funding,,inputs,num_inputs*struct utxo
31hsmctl_sign_funding_reply,104
32hsmctl_sign_funding_reply,,num_sigs,u16
33hsmctl_sign_funding_reply,,sig,num_sigs*secp256k1_ecdsa_signature
34# Master asks the HSM to sign a node_announcement
35hsmctl_node_announcement_sig_req,6
36hsmctl_node_announcement_sig_req,,annlen,u16
37hsmctl_node_announcement_sig_req,,announcement,annlen*u8
38hsmctl_node_announcement_sig_reply,106
39hsmctl_node_announcement_sig_reply,,signature,secp256k1_ecdsa_signature
40# Sign a withdrawal request
41hsmctl_sign_withdrawal,7
42hsmctl_sign_withdrawal,,satoshi_out,u64
43hsmctl_sign_withdrawal,,change_out,u64
44hsmctl_sign_withdrawal,,change_keyindex,u32
45hsmctl_sign_withdrawal,,pkh,20*u8
46hsmctl_sign_withdrawal,,num_inputs,u16
47hsmctl_sign_withdrawal,,inputs,num_inputs*struct utxo
48hsmctl_sign_withdrawal_reply,107
49hsmctl_sign_withdrawal_reply,,num_sigs,u16
50hsmctl_sign_withdrawal_reply,,sig,num_sigs*secp256k1_ecdsa_signature
51# Sign an invoice
52hsmctl_sign_invoice,8
53hsmctl_sign_invoice,,len,u16
54hsmctl_sign_invoice,,u5bytes,len*u8
55hsmctl_sign_invoice,,hrplen,u16
56hsmctl_sign_invoice,,hrp,hrplen*u8
57hsmctl_sign_invoice_reply,108
58hsmctl_sign_invoice_reply,,sig,secp256k1_ecdsa_recoverable_signature