@d20dao/vrf-sdk 0.3.3 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (21) hide show
  1. package/AGENTS.md +31 -15
  2. package/API.md +2190 -0
  3. package/BUILD-MANIFEST.json +18 -16
  4. package/CHANGELOG.md +44 -0
  5. package/PROTOCOL-PROVENANCE.json +9 -8
  6. package/README.md +157 -97
  7. package/abi/EpochEntropy.json +372 -26
  8. package/dist/abi.d.ts +292 -24
  9. package/dist/abi.js +1 -1
  10. package/dist/epoch.d.ts +42 -78
  11. package/dist/epoch.js +121 -27
  12. package/dist/index.d.ts +4 -2
  13. package/dist/index.js +2 -1
  14. package/dist/sources.js +2 -0
  15. package/dist/templates.d.ts +22 -0
  16. package/dist/templates.js +220 -0
  17. package/examples/DiceConsumer.sol +37 -29
  18. package/examples/LootDropConsumer.sol +60 -0
  19. package/examples/RaffleConsumer.sol +71 -0
  20. package/package.json +6 -2
  21. package/contracts/examples/MiningRandomnessConsumer.sol +0 -59
package/abi/EpochEntropy.json CHANGED
@@ -103,11 +103,21 @@
103
103
  "name": "InvalidInitialization",
104
104
  "type": "error"
105
105
  },
106
+ {
107
+ "inputs": [],
108
+ "name": "InvalidRecipe",
109
+ "type": "error"
110
+ },
106
111
  {
107
112
  "inputs": [],
108
113
  "name": "InvalidSigner",
109
114
  "type": "error"
110
115
  },
116
+ {
117
+ "inputs": [],
118
+ "name": "InvalidTemplate",
119
+ "type": "error"
120
+ },
111
121
  {
112
122
  "inputs": [],
113
123
  "name": "InvalidTime",
@@ -176,6 +186,25 @@
176
186
  "name": "UUPSUnsupportedProxiableUUID",
177
187
  "type": "error"
178
188
  },
189
+ {
190
+ "anonymous": false,
191
+ "inputs": [
192
+ {
193
+ "indexed": true,
194
+ "internalType": "address",
195
+ "name": "account",
196
+ "type": "address"
197
+ },
198
+ {
199
+ "indexed": false,
200
+ "internalType": "bool",
201
+ "name": "allowed",
202
+ "type": "bool"
203
+ }
204
+ ],
205
+ "name": "BackupCommitterSet",
206
+ "type": "event"
207
+ },
179
208
  {
180
209
  "anonymous": false,
181
210
  "inputs": [
@@ -193,9 +222,15 @@
193
222
  },
194
223
  {
195
224
  "indexed": false,
196
- "internalType": "address[4]",
225
+ "internalType": "uint8[]",
226
+ "name": "recipes",
227
+ "type": "uint8[]"
228
+ },
229
+ {
230
+ "indexed": false,
231
+ "internalType": "address[]",
197
232
  "name": "signers",
198
- "type": "address[4]"
233
+ "type": "address[]"
199
234
  }
200
235
  ],
201
236
  "name": "CatalogScheduled",
@@ -296,6 +331,43 @@
296
331
  "name": "OwnershipTransferred",
297
332
  "type": "event"
298
333
  },
334
+ {
335
+ "anonymous": false,
336
+ "inputs": [
337
+ {
338
+ "indexed": true,
339
+ "internalType": "uint8",
340
+ "name": "recipe",
341
+ "type": "uint8"
342
+ },
343
+ {
344
+ "indexed": true,
345
+ "internalType": "bytes32",
346
+ "name": "queryHash",
347
+ "type": "bytes32"
348
+ },
349
+ {
350
+ "indexed": false,
351
+ "internalType": "string",
352
+ "name": "canonicalRequest",
353
+ "type": "string"
354
+ },
355
+ {
356
+ "indexed": false,
357
+ "internalType": "bytes",
358
+ "name": "template",
359
+ "type": "bytes"
360
+ },
361
+ {
362
+ "indexed": false,
363
+ "internalType": "string",
364
+ "name": "body",
365
+ "type": "string"
366
+ }
367
+ ],
368
+ "name": "RecipeRegistered",
369
+ "type": "event"
370
+ },
299
371
  {
300
372
  "anonymous": false,
301
373
  "inputs": [
@@ -363,12 +435,38 @@
363
435
  },
364
436
  {
365
437
  "inputs": [],
366
- "name": "MAX_FALLBACK_ATTEMPT",
438
+ "name": "MAX_BACKUP_COMMITTERS",
367
439
  "outputs": [
368
440
  {
369
- "internalType": "uint8",
441
+ "internalType": "uint256",
370
442
  "name": "",
371
- "type": "uint8"
443
+ "type": "uint256"
444
+ }
445
+ ],
446
+ "stateMutability": "view",
447
+ "type": "function"
448
+ },
449
+ {
450
+ "inputs": [],
451
+ "name": "MAX_BODY_BYTES",
452
+ "outputs": [
453
+ {
454
+ "internalType": "uint256",
455
+ "name": "",
456
+ "type": "uint256"
457
+ }
458
+ ],
459
+ "stateMutability": "view",
460
+ "type": "function"
461
+ },
462
+ {
463
+ "inputs": [],
464
+ "name": "MAX_DATA_BYTES",
465
+ "outputs": [
466
+ {
467
+ "internalType": "uint256",
468
+ "name": "",
469
+ "type": "uint256"
372
470
  }
373
471
  ],
374
472
  "stateMutability": "view",
@@ -387,6 +485,58 @@
387
485
  "stateMutability": "view",
388
486
  "type": "function"
389
487
  },
488
+ {
489
+ "inputs": [],
490
+ "name": "MAX_RECIPES",
491
+ "outputs": [
492
+ {
493
+ "internalType": "uint256",
494
+ "name": "",
495
+ "type": "uint256"
496
+ }
497
+ ],
498
+ "stateMutability": "view",
499
+ "type": "function"
500
+ },
501
+ {
502
+ "inputs": [],
503
+ "name": "MAX_REQUEST_BYTES",
504
+ "outputs": [
505
+ {
506
+ "internalType": "uint256",
507
+ "name": "",
508
+ "type": "uint256"
509
+ }
510
+ ],
511
+ "stateMutability": "view",
512
+ "type": "function"
513
+ },
514
+ {
515
+ "inputs": [],
516
+ "name": "MAX_SOURCES",
517
+ "outputs": [
518
+ {
519
+ "internalType": "uint256",
520
+ "name": "",
521
+ "type": "uint256"
522
+ }
523
+ ],
524
+ "stateMutability": "view",
525
+ "type": "function"
526
+ },
527
+ {
528
+ "inputs": [],
529
+ "name": "MAX_TEMPLATE_BYTES",
530
+ "outputs": [
531
+ {
532
+ "internalType": "uint256",
533
+ "name": "",
534
+ "type": "uint256"
535
+ }
536
+ ],
537
+ "stateMutability": "view",
538
+ "type": "function"
539
+ },
390
540
  {
391
541
  "inputs": [],
392
542
  "name": "RECIPE_DOMAIN",
@@ -435,12 +585,12 @@
435
585
  },
436
586
  {
437
587
  "inputs": [],
438
- "name": "anuSigner",
588
+ "name": "backupCommitterCount",
439
589
  "outputs": [
440
590
  {
441
- "internalType": "address",
591
+ "internalType": "uint256",
442
592
  "name": "",
443
- "type": "address"
593
+ "type": "uint256"
444
594
  }
445
595
  ],
446
596
  "stateMutability": "view",
@@ -460,31 +610,41 @@
460
610
  "type": "function"
461
611
  },
462
612
  {
463
- "inputs": [],
464
- "name": "catalogHash",
613
+ "inputs": [
614
+ {
615
+ "internalType": "uint64",
616
+ "name": "epochId",
617
+ "type": "uint64"
618
+ }
619
+ ],
620
+ "name": "catalogAt",
465
621
  "outputs": [
466
622
  {
467
623
  "internalType": "bytes32",
468
- "name": "",
624
+ "name": "hash",
469
625
  "type": "bytes32"
626
+ },
627
+ {
628
+ "internalType": "uint8[]",
629
+ "name": "recipes",
630
+ "type": "uint8[]"
631
+ },
632
+ {
633
+ "internalType": "address[]",
634
+ "name": "signers",
635
+ "type": "address[]"
470
636
  }
471
637
  ],
472
638
  "stateMutability": "view",
473
639
  "type": "function"
474
640
  },
475
641
  {
476
- "inputs": [
477
- {
478
- "internalType": "uint64",
479
- "name": "epochId",
480
- "type": "uint64"
481
- }
482
- ],
483
- "name": "catalogHashAt",
642
+ "inputs": [],
643
+ "name": "catalogHash",
484
644
  "outputs": [
485
645
  {
486
646
  "internalType": "bytes32",
487
- "name": "hash",
647
+ "name": "",
488
648
  "type": "bytes32"
489
649
  }
490
650
  ],
@@ -668,6 +828,19 @@
668
828
  "stateMutability": "view",
669
829
  "type": "function"
670
830
  },
831
+ {
832
+ "inputs": [],
833
+ "name": "ethereumBlockSigner",
834
+ "outputs": [
835
+ {
836
+ "internalType": "address",
837
+ "name": "",
838
+ "type": "address"
839
+ }
840
+ ],
841
+ "stateMutability": "view",
842
+ "type": "function"
843
+ },
671
844
  {
672
845
  "inputs": [
673
846
  {
@@ -793,6 +966,11 @@
793
966
  "name": "source",
794
967
  "type": "uint8"
795
968
  },
969
+ {
970
+ "internalType": "uint8",
971
+ "name": "recipe",
972
+ "type": "uint8"
973
+ },
796
974
  {
797
975
  "internalType": "address",
798
976
  "name": "airnode",
@@ -839,6 +1017,11 @@
839
1017
  "name": "source",
840
1018
  "type": "uint8"
841
1019
  },
1020
+ {
1021
+ "internalType": "uint8",
1022
+ "name": "recipe",
1023
+ "type": "uint8"
1024
+ },
842
1025
  {
843
1026
  "internalType": "address",
844
1027
  "name": "airnode",
@@ -868,6 +1051,40 @@
868
1051
  "stateMutability": "view",
869
1052
  "type": "function"
870
1053
  },
1054
+ {
1055
+ "inputs": [
1056
+ {
1057
+ "internalType": "uint8",
1058
+ "name": "recipe",
1059
+ "type": "uint8"
1060
+ }
1061
+ ],
1062
+ "name": "getRecipe",
1063
+ "outputs": [
1064
+ {
1065
+ "internalType": "bytes32",
1066
+ "name": "queryHash",
1067
+ "type": "bytes32"
1068
+ },
1069
+ {
1070
+ "internalType": "string",
1071
+ "name": "canonicalRequest",
1072
+ "type": "string"
1073
+ },
1074
+ {
1075
+ "internalType": "bytes",
1076
+ "name": "template",
1077
+ "type": "bytes"
1078
+ },
1079
+ {
1080
+ "internalType": "string",
1081
+ "name": "body",
1082
+ "type": "string"
1083
+ }
1084
+ ],
1085
+ "stateMutability": "view",
1086
+ "type": "function"
1087
+ },
871
1088
  {
872
1089
  "inputs": [],
873
1090
  "name": "hyperliquidSigner",
@@ -904,6 +1121,51 @@
904
1121
  "stateMutability": "nonpayable",
905
1122
  "type": "function"
906
1123
  },
1124
+ {
1125
+ "inputs": [],
1126
+ "name": "initializeRecipeRegistry",
1127
+ "outputs": [],
1128
+ "stateMutability": "nonpayable",
1129
+ "type": "function"
1130
+ },
1131
+ {
1132
+ "inputs": [
1133
+ {
1134
+ "internalType": "address",
1135
+ "name": "account",
1136
+ "type": "address"
1137
+ }
1138
+ ],
1139
+ "name": "isAuthorizedCommitter",
1140
+ "outputs": [
1141
+ {
1142
+ "internalType": "bool",
1143
+ "name": "",
1144
+ "type": "bool"
1145
+ }
1146
+ ],
1147
+ "stateMutability": "view",
1148
+ "type": "function"
1149
+ },
1150
+ {
1151
+ "inputs": [
1152
+ {
1153
+ "internalType": "address",
1154
+ "name": "account",
1155
+ "type": "address"
1156
+ }
1157
+ ],
1158
+ "name": "isBackupCommitter",
1159
+ "outputs": [
1160
+ {
1161
+ "internalType": "bool",
1162
+ "name": "",
1163
+ "type": "bool"
1164
+ }
1165
+ ],
1166
+ "stateMutability": "view",
1167
+ "type": "function"
1168
+ },
907
1169
  {
908
1170
  "inputs": [
909
1171
  {
@@ -962,6 +1224,67 @@
962
1224
  "stateMutability": "view",
963
1225
  "type": "function"
964
1226
  },
1227
+ {
1228
+ "inputs": [],
1229
+ "name": "recipeCount",
1230
+ "outputs": [
1231
+ {
1232
+ "internalType": "uint256",
1233
+ "name": "",
1234
+ "type": "uint256"
1235
+ }
1236
+ ],
1237
+ "stateMutability": "view",
1238
+ "type": "function"
1239
+ },
1240
+ {
1241
+ "inputs": [
1242
+ {
1243
+ "internalType": "uint8",
1244
+ "name": "recipe",
1245
+ "type": "uint8"
1246
+ }
1247
+ ],
1248
+ "name": "recipeRequest",
1249
+ "outputs": [
1250
+ {
1251
+ "internalType": "string",
1252
+ "name": "",
1253
+ "type": "string"
1254
+ }
1255
+ ],
1256
+ "stateMutability": "view",
1257
+ "type": "function"
1258
+ },
1259
+ {
1260
+ "inputs": [
1261
+ {
1262
+ "internalType": "string",
1263
+ "name": "canonicalRequest",
1264
+ "type": "string"
1265
+ },
1266
+ {
1267
+ "internalType": "bytes",
1268
+ "name": "template",
1269
+ "type": "bytes"
1270
+ },
1271
+ {
1272
+ "internalType": "string",
1273
+ "name": "body",
1274
+ "type": "string"
1275
+ }
1276
+ ],
1277
+ "name": "registerRecipe",
1278
+ "outputs": [
1279
+ {
1280
+ "internalType": "uint8",
1281
+ "name": "recipe",
1282
+ "type": "uint8"
1283
+ }
1284
+ ],
1285
+ "stateMutability": "nonpayable",
1286
+ "type": "function"
1287
+ },
965
1288
  {
966
1289
  "inputs": [],
967
1290
  "name": "renounceOwnership",
@@ -972,9 +1295,14 @@
972
1295
  {
973
1296
  "inputs": [
974
1297
  {
975
- "internalType": "address[4]",
1298
+ "internalType": "uint8[]",
1299
+ "name": "recipes",
1300
+ "type": "uint8[]"
1301
+ },
1302
+ {
1303
+ "internalType": "address[]",
976
1304
  "name": "signers",
977
- "type": "address[4]"
1305
+ "type": "address[]"
978
1306
  },
979
1307
  {
980
1308
  "internalType": "uint64",
@@ -987,6 +1315,24 @@
987
1315
  "stateMutability": "nonpayable",
988
1316
  "type": "function"
989
1317
  },
1318
+ {
1319
+ "inputs": [
1320
+ {
1321
+ "internalType": "address",
1322
+ "name": "account",
1323
+ "type": "address"
1324
+ },
1325
+ {
1326
+ "internalType": "bool",
1327
+ "name": "allowed",
1328
+ "type": "bool"
1329
+ }
1330
+ ],
1331
+ "name": "setBackupCommitter",
1332
+ "outputs": [],
1333
+ "stateMutability": "nonpayable",
1334
+ "type": "function"
1335
+ },
990
1336
  {
991
1337
  "inputs": [
992
1338
  {
@@ -1008,12 +1354,12 @@
1008
1354
  "type": "uint64"
1009
1355
  }
1010
1356
  ],
1011
- "name": "signersAt",
1357
+ "name": "sourceCountAt",
1012
1358
  "outputs": [
1013
1359
  {
1014
- "internalType": "address[4]",
1015
- "name": "signers",
1016
- "type": "address[4]"
1360
+ "internalType": "uint256",
1361
+ "name": "",
1362
+ "type": "uint256"
1017
1363
  }
1018
1364
  ],
1019
1365
  "stateMutability": "view",