stoffelcrypto 0.1.0

Asynchronous HoneyBadgerMPC protocols, preprocessing, and arithmetic for Stoffel.
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
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
/* Don't modify this file manually. It is autogenerated by cbindgen. */

#include <stdarg.h>
#include <stdbool.h>
#include <stdint.h>
#include <stdlib.h>

#define Gf2568_MODULUS 283

enum ProtocolType
#if defined(__cplusplus) || __STDC_VERSION__ >= 202311L
  : uint8_t
#endif // defined(__cplusplus) || __STDC_VERSION__ >= 202311L
 {
  None = 0,
  Rbc = 1,
  Avss = 2,
  Triple = 3,
  Mul = 4,
  Input = 5,
  Output = 6,
};
#ifndef __cplusplus
#if __STDC_VERSION__ >= 202311L
typedef enum ProtocolType ProtocolType;
#else
typedef uint8_t ProtocolType;
#endif // __STDC_VERSION__ >= 202311L
#endif // __cplusplus

typedef enum FieldKind {
  Bls12_381Fr,
} FieldKind;

typedef enum HoneyBadgerErrorCode {
  HoneyBadgerSuccess,
  HoneyBadgerNetworkError,
  HoneyBadgerRanShaError,
  HoneyBadgerInputError,
  HoneyBadgerDouShaError,
  HoneyBadgerRanDouShaError,
  HoneyBadgerNotEnoughPreprocessing,
  HoneyBadgerTripleGenError,
  HoneyBadgerRbcError,
  HoneyBadgerMulError,
  HoneyBadgerOutputError,
  HoneyBadgerBatchReconError,
  HoneyBadgerBincodeSerializationError,
  HoneyBadgerJoinError,
  HoneyBadgerChannelClosed,
  HoneyBadgerOutputNotReady,
  HoneyBadgerRandBitError,
  HoneyBadgerPRandError,
  HoneyBadgerFPMulError,
  HoneyBadgerTruncPrError,
  HoneyBadgerFPDivConstError,
  HoneyBadgerTypesError,
  HoneyBadgerAlreadyReservedError,
  HoneyBadgerInvalidThesholdError,
  HoneyBadgerInvalidPartySizeError,
  HoneyBadgerInvalidPartyIdError,
  HoneyBadgerLimitError,
  HoneyBadgerInstanceIdError,
} HoneyBadgerErrorCode;

typedef enum NetworkErrorCode {
  NetworkSuccess,
  IncorrectNetworkType,
  IncorrectSockAddr,
  ConnectError,
  NetworkAlreadyInUse,
  RecvError,
  SendError,
  Timeout,
  PartyNotFound,
  ClientNotFound,
} NetworkErrorCode;

typedef enum RbcMessageType {
  BrachaInit,
  BrachaEcho,
  BrachaReady,
  BrachaUnknown,
  AvidSend,
  AvidEcho,
  AvidReady,
  AvidUnknown,
  AbaEst,
  AbaAux,
  AbaKey,
  AbaCoin,
  AbaUnknown,
  Acs,
  AcsUnknown,
} RbcMessageType;

typedef enum RbcErrorCode {
  RbcSuccess,
  RbcInvalidThreshold,
  RbcUnknownMsgType,
  RbcSendFailed,
  RbcInternal,
  RbcNetworkSendError,
  RbcNetworkTimeout,
  RbcNetworkPartyNotFound,
  RbcNetworkClientNotFound,
  RbcSerializationError,
  RbcShardError,
  RbcSessionNotFound,
  RbcSendError,
} RbcErrorCode;

typedef enum ShareErrorCode {
  ShareSuccess,
  InsufficientShares,
  DegreeMismatch,
  IdMismatch,
  InvalidInput,
  TypeMismatch,
  NoSuitableDomain,
  PolynomialOperationError,
  DecodingError,
} ShareErrorCode;

/**
 * Finite field GF(2^8) with AES modulus x^8 + x^4 + x^3 + x + 1 (0x11B)
 */
typedef struct Gf2568 Gf2568;

typedef struct U256 {
  uint64_t data[4];
} U256;

typedef struct U256Slice {
  struct U256 *pointer;
  uintptr_t len;
} U256Slice;

typedef struct ByteSlice {
  uint8_t *pointer;
  uintptr_t len;
} ByteSlice;

/**
 * C-compatible view of a 128-bit `SessionId` (C has no `u128`). `lo` holds the low 64 bits,
 * `hi` the high 64 bits. Matches `SessionIdBits` in `honey_badger_bindings.h`.
 */
typedef struct SessionIdBits {
  uint64_t lo;
  uint64_t hi;
} SessionIdBits;

typedef struct HoneyBadgerMPCClientOpaque {

} HoneyBadgerMPCClientOpaque;

typedef struct NetworkOpaque {

} NetworkOpaque;

typedef struct UsizeSlice {
  uintptr_t *pointer;
  uintptr_t len;
} UsizeSlice;

typedef struct FakeNetworkReceiversOpaque {

} FakeNetworkReceiversOpaque;

typedef struct QuicNetworkOpaque {

} QuicNetworkOpaque;

typedef struct QuicPeerConnectionsOpaque {

} QuicPeerConnectionsOpaque;

typedef struct RbcMsg {
  uintptr_t sender_id;
  struct SessionIdBits session_id;
  uintptr_t round_id;
  struct ByteSlice payload;
  struct ByteSlice metadata;
  enum RbcMessageType msg_type;
} RbcMsg;

typedef struct BrachaOpaque {

} BrachaOpaque;

typedef uintptr_t FfiCtx;

typedef struct RbcWrapCtx {
  FfiCtx ctx;
  enum RbcErrorCode (*call)(void *ctx,
                            const uint8_t *msg_ptr,
                            uintptr_t msg_len,
                            uint8_t **out_ptr,
                            uintptr_t *out_len);
} RbcWrapCtx;

typedef struct AvidOpaque {

} AvidOpaque;

typedef struct AbaOpaque {

} AbaOpaque;

typedef struct FieldOpaque {

} FieldOpaque;

typedef struct ShamirShare {
  struct FieldOpaque *share;
  uintptr_t id;
  uintptr_t degree;
} ShamirShare;

typedef struct RobustShare {
  struct FieldOpaque *share;
  uintptr_t id;
  uintptr_t degree;
} RobustShare;

typedef struct NonRobustShare {
  struct FieldOpaque *share;
  uintptr_t id;
  uintptr_t degree;
} NonRobustShare;

typedef struct ShamirShareSlice {
  struct ShamirShare *pointer;
  uintptr_t len;
} ShamirShareSlice;

typedef struct RobustShareSlice {
  struct RobustShare *pointer;
  uintptr_t len;
} RobustShareSlice;

typedef struct NonRobustShareSlice {
  struct NonRobustShare *pointer;
  uintptr_t len;
} NonRobustShareSlice;



#ifdef __cplusplus
extern "C" {
#endif // __cplusplus

void free_u256_slice(struct U256Slice slice);

void free_bytes_slice(struct ByteSlice slice);

void free_c_string(char *ptr);

struct U256 be_bytes_to_u256(struct ByteSlice bytes);

struct U256 le_bytes_to_u256(struct ByteSlice bytes);

struct ByteSlice u256_to_be_bytes(struct U256 num);

struct ByteSlice u256_to_le_bytes(struct U256 num);

struct SessionIdBits new_session_id(ProtocolType caller,
                                    uint64_t exec_id,
                                    uint8_t sub_id,
                                    uint8_t round_id,
                                    uint32_t instance_id);

ProtocolType calling_protocol(struct SessionIdBits session_id);

uint64_t exec_id(struct SessionIdBits session_id);

uint8_t sub_id(struct SessionIdBits session_id);

uint8_t round_id(struct SessionIdBits session_id);

uint32_t instance_id(struct SessionIdBits session_id);

struct HoneyBadgerMPCClientOpaque *new_honey_badger_mpc_client(uintptr_t id,
                                                               uintptr_t n,
                                                               uintptr_t t,
                                                               uint32_t instance_id,
                                                               struct U256Slice inputs,
                                                               uintptr_t input_len,
                                                               enum FieldKind field_kind);

enum HoneyBadgerErrorCode hb_client_process(struct HoneyBadgerMPCClientOpaque *client_ptr,
                                            struct NetworkOpaque *net_ptr,
                                            uintptr_t sender_id,
                                            struct ByteSlice raw_msg);

enum HoneyBadgerErrorCode hb_client_get_output(struct HoneyBadgerMPCClientOpaque *client_ptr,
                                               struct U256 *returned_output,
                                               enum FieldKind field_kind);

void free_honey_badger_mpc_client(struct HoneyBadgerMPCClientOpaque *client_ptr);

void free_network(struct NetworkOpaque *network);

struct NetworkOpaque *clone_network(struct NetworkOpaque *network);

enum NetworkErrorCode network_send(struct NetworkOpaque *net_ptr,
                                   uintptr_t recipient_id,
                                   struct ByteSlice message,
                                   uintptr_t *sent_size);

struct NetworkOpaque *new_fake_network(uintptr_t n_nodes,
                                       const struct UsizeSlice *n_clients,
                                       uintptr_t channel_buff_size,
                                       struct FakeNetworkReceiversOpaque **returned_receivers);

struct ByteSlice node_receiver_recv_sync(struct FakeNetworkReceiversOpaque *receivers,
                                         uintptr_t to_node,
                                         uintptr_t from_node);

void free_fake_network_receivers(struct FakeNetworkReceiversOpaque *receivers);

/**
 * Select crypto provider for rustls
 * Must be called before using quic network
 */
void init_tls(void);

/**
 * Creates a new QUIC network instance
 *
 * This initializes a network manager with no active endpoints or configurations.
 * Before using the manager, you must call either `connect()` or `listen()`
 * to set up the appropriate endpoint.
 * It also initializes a peer connection map.
 */
struct QuicNetworkOpaque *new_quic_network(struct QuicPeerConnectionsOpaque **returned_connections);

/**
 * Establishes a connection to a new peer
 *
 * This method initiates an outgoing connection to a peer at the specified address.
 * It handles the connection establishment process, including any necessary
 * handshaking, encryption setup, and protocol negotiation.
 *
 * # Arguments
 * * `address` - The network address of the peer to connect to
 */
enum NetworkErrorCode quic_connect(struct QuicNetworkOpaque *quic_network_ptr,
                                   struct QuicPeerConnectionsOpaque *peer_connections,
                                   const char *addr);

/**
 * Accepts an incoming connection
 *
 * This method accepts a pending incoming connection from a peer.
 * It should be called after `listen()` has been called to set up
 * the listening endpoint.
 *
 * This method will block until a connection is available or an error occurs.
 */
enum NetworkErrorCode quic_accept(struct QuicNetworkOpaque *quic_network_ptr,
                                  struct QuicPeerConnectionsOpaque *peer_connections,
                                  char **connected_addr);

/**
 * Listens for incoming connections
 *
 * This method sets up a network endpoint to listen for incoming connections
 * at the specified address. After calling this method, `accept()` can be
 * called to accept incoming connections.
 *
 * # Arguments
 * * `bind_address` - The local address to bind to for listening
 */
enum NetworkErrorCode quic_listen(struct QuicNetworkOpaque *quic_network_ptr,
                                  const char *bind_address);

/**
 * Cast a QUIC network into HoneyBadgerMPC network.
 * This method will comsume the original pointer and set it to Null.
 * Make sure to finish QUIC setup before this function.
 */
struct NetworkOpaque *quic_into_hb_network(struct QuicNetworkOpaque **quic_network_ptr);

enum NetworkErrorCode quic_receive_from_sync(struct QuicPeerConnectionsOpaque *peer_connections,
                                             const char *addr,
                                             struct ByteSlice *msg);

enum NetworkErrorCode quic_send(struct QuicPeerConnectionsOpaque *peer_connections,
                                const char *recp,
                                struct ByteSlice msg);

void free_quic_addr(char *addr);

void free_quic_network(struct QuicNetworkOpaque *quic_network_ptr);

void free_quic_peer_connections(struct QuicPeerConnectionsOpaque *peer_connections);

void free_rbc_msg(struct RbcMsg msg);

enum RbcErrorCode deserialize_rbc_msg(struct ByteSlice msg, struct RbcMsg *output_rbc_msg);

uint8_t *rbc_alloc(uintptr_t len);

/**
 * Creates a new Bracha instance with the given parameters.
 *
 * # Arguments
 * * `id` - the ID of the initiator
 * * `n` - total number of parties in the network
 * * `t` - number of allowed malicious parties
 */
enum RbcErrorCode bracha_new(uintptr_t id,
                             uintptr_t n,
                             uintptr_t t,
                             struct BrachaOpaque **bracha_pointer,
                             struct RbcWrapCtx wrapper);

void free_bracha(struct BrachaOpaque *bracha_pointer);

uintptr_t get_bracha_id(struct BrachaOpaque *bracha_pointer);

uintptr_t get_bracha_n(struct BrachaOpaque *bracha_pointer);

uintptr_t get_bracha_t(struct BrachaOpaque *bracha_pointer);

void sync_bracha_clear_store(struct BrachaOpaque *bracha_pointer);

enum RbcErrorCode has_bracha_session_ended(struct BrachaOpaque *bracha_pointer,
                                           struct SessionIdBits session_id,
                                           bool *output);

enum RbcErrorCode get_bracha_output(struct BrachaOpaque *bracha_pointer,
                                    struct SessionIdBits session_id,
                                    struct ByteSlice *output);

enum RbcErrorCode sync_bracha_init(struct BrachaOpaque *bracha_pointer,
                                   struct ByteSlice payload,
                                   struct SessionIdBits session_id,
                                   struct NetworkOpaque *net_ptr);

enum RbcErrorCode sync_bracha_process(struct BrachaOpaque *bracha_pointer,
                                      struct RbcMsg msg,
                                      struct NetworkOpaque *net_ptr);

enum RbcErrorCode sync_bracha_broadcast(struct BrachaOpaque *bracha_pointer,
                                        struct RbcMsg msg,
                                        struct NetworkOpaque *net_ptr);

enum RbcErrorCode sync_bracha_send(struct BrachaOpaque *bracha_pointer,
                                   struct RbcMsg msg,
                                   struct NetworkOpaque *net_ptr,
                                   uintptr_t recv);

/**
 * Creates a new Avid instance with the given parameters.
 */
enum RbcErrorCode avid_new(uintptr_t id,
                           uintptr_t n,
                           uintptr_t t,
                           uintptr_t k,
                           struct AvidOpaque **avid_pointer,
                           struct RbcWrapCtx wrapper);

void free_avid(struct AvidOpaque *avid_pointer);

uintptr_t get_avid_id(struct AvidOpaque *avid_pointer);

uintptr_t get_avid_n(struct AvidOpaque *avid_pointer);

uintptr_t get_avid_t(struct AvidOpaque *avid_pointer);

void sync_avid_clear_store(struct AvidOpaque *avid_pointer);

enum RbcErrorCode has_avid_session_ended(struct AvidOpaque *avid_pointer,
                                         struct SessionIdBits session_id,
                                         bool *output);

enum RbcErrorCode get_avid_output(struct AvidOpaque *avid_pointer,
                                  struct SessionIdBits session_id,
                                  struct ByteSlice *output);

enum RbcErrorCode sync_avid_init(struct AvidOpaque *avid_pointer,
                                 struct ByteSlice payload,
                                 struct SessionIdBits session_id,
                                 struct NetworkOpaque *net_ptr);

enum RbcErrorCode sync_avid_process(struct AvidOpaque *avid_pointer,
                                    struct RbcMsg msg,
                                    struct NetworkOpaque *net_ptr);

enum RbcErrorCode sync_avid_broadcast(struct AvidOpaque *avid_pointer,
                                      struct RbcMsg msg,
                                      struct NetworkOpaque *net_ptr);

enum RbcErrorCode sync_avid_send(struct AvidOpaque *avid_pointer,
                                 struct RbcMsg msg,
                                 struct NetworkOpaque *net_ptr,
                                 uintptr_t recv);

enum RbcErrorCode aba_new(uintptr_t id,
                          uintptr_t n,
                          uintptr_t t,
                          uintptr_t k,
                          struct AbaOpaque **aba_pointer,
                          struct RbcWrapCtx wrapper);

void free_aba(struct AbaOpaque *aba_pointer);

uintptr_t get_aba_id(struct AbaOpaque *aba_pointer);

uintptr_t get_aba_n(struct AbaOpaque *aba_pointer);

uintptr_t get_aba_t(struct AbaOpaque *aba_pointer);

void sync_aba_clear_store(struct AbaOpaque *aba_pointer);

enum RbcErrorCode has_aba_session_ended(struct AbaOpaque *aba_pointer,
                                        struct SessionIdBits session_id,
                                        bool *output);

enum RbcErrorCode get_aba_output(struct AbaOpaque *aba_pointer,
                                 struct SessionIdBits session_id,
                                 bool *output);

enum RbcErrorCode sync_aba_init(struct AbaOpaque *aba_pointer,
                                struct ByteSlice payload,
                                struct SessionIdBits session_id,
                                struct NetworkOpaque *net_ptr);

enum RbcErrorCode sync_aba_process(struct AbaOpaque *aba_pointer,
                                   struct RbcMsg msg,
                                   struct NetworkOpaque *net_ptr);

enum RbcErrorCode sync_aba_broadcast(struct AbaOpaque *aba_pointer,
                                     struct RbcMsg msg,
                                     struct NetworkOpaque *net_ptr);

enum RbcErrorCode sync_aba_send(struct AbaOpaque *aba_pointer,
                                struct RbcMsg msg,
                                struct NetworkOpaque *net_ptr,
                                uintptr_t recv);

struct ByteSlice field_ptr_to_bytes(struct FieldOpaque *field, bool be);

void free_shamir_share(struct ShamirShare share);

void free_robust_share(struct RobustShare share);

void free_non_robust_share(struct NonRobustShare share);

void free_shamir_share_slice(struct ShamirShareSlice slice);

void free_robust_share_slice(struct RobustShareSlice slice);

void free_non_robust_share_slice(struct NonRobustShareSlice slice);

struct ShamirShare shamir_share_new(struct U256 secret,
                                    uintptr_t id,
                                    uintptr_t degree,
                                    enum FieldKind field_kind);

enum ShareErrorCode shamir_share_compute_shares(struct U256 secret,
                                                uintptr_t degree,
                                                const struct UsizeSlice *ids,
                                                enum FieldKind field_kind,
                                                struct ShamirShareSlice *output_shares);

enum ShareErrorCode shamir_share_recover_secret(struct ShamirShareSlice shares,
                                                struct U256 *output_secret,
                                                struct U256Slice *output_coeffs,
                                                enum FieldKind field_kind);

struct RobustShare robust_share_new(struct U256 secret,
                                    uintptr_t id,
                                    uintptr_t degree,
                                    enum FieldKind field_kind);

/**
 * Generates `n` secret shares for a `value` using a degree `t` polynomial,
 * such that `f(0) = value`. Any `t + 1` shares can reconstruct the secret.
 *
 * Shares are evaluations of `f(x)` on an FFT domain.
 *
 * # Errors
 * - `InvalidInput` if `n` is not greater than `t`.
 * - `NoSuitableDomain` if a suitable FFT evaluation domain of size `n` isn't found.
 */
enum ShareErrorCode robust_share_compute_shares(struct U256 secret,
                                                uintptr_t degree,
                                                uintptr_t n,
                                                struct RobustShareSlice *output_shares,
                                                enum FieldKind field_kind);

/**
 * Full robust interpolation combining optimistic decoding and error correction
 *
 * # Arguments
 * * `n` - total number of shares
 * * `shares` - pointer to the RobustShareSlice, unordered
 */
enum ShareErrorCode robust_share_recover_secret(struct RobustShareSlice shares,
                                                uintptr_t n,
                                                uintptr_t t,
                                                struct U256 *output_secret,
                                                struct U256Slice *output_coeffs,
                                                enum FieldKind field_kind);

struct NonRobustShare non_robust_share_new(struct U256 secret,
                                           uintptr_t id,
                                           uintptr_t degree,
                                           enum FieldKind field_kind);

enum ShareErrorCode non_robust_share_compute_shares(struct U256 secret,
                                                    uintptr_t degree,
                                                    uintptr_t n,
                                                    struct NonRobustShareSlice *output_shares,
                                                    enum FieldKind field_kind);

enum ShareErrorCode non_robust_share_recover_secret(struct NonRobustShareSlice shares,
                                                    uintptr_t n,
                                                    struct U256 *output_secret,
                                                    struct U256Slice *output_coeffs,
                                                    enum FieldKind field_kind);

#ifdef __cplusplus
}  // extern "C"
#endif  // __cplusplus