@typeberry/native 0.3.0-5dae93e → 0.4.0-942910c

package/index.d.ts

@@ -181,6 +181,24 @@ declare function verifySeal(signerKey: Uint8Array, sealData: Uint8Array, payload
 declare function generateSeal(secretSeed: Uint8Array, input: Uint8Array, auxData: Uint8Array): Uint8Array;
 declare function vrfOutputHash(secretSeed: Uint8Array, input: Uint8Array): Uint8Array;
 declare function batchGenerateRingVrf(ringKeys: Uint8Array, proverKeyIndex: number, secretSeed: Uint8Array, inputsData: Uint8Array, vrfInputDataLen: number): Uint8Array;
+/**
+ * Batch-verify ring VRF tickets against a single ring commitment.
+ *
+ * Verification is all-or-nothing: every ticket is aggregated into one batched
+ * pairing check, so the result reports a single pass/fail for the whole batch
+ * (an individual failing ticket cannot be identified).
+ *
+ * `ticketsData` is the concatenation of `signature (784 bytes) || vrfInput
+ * (vrfInputDataLen bytes)` per ticket. The returned buffer is:
+ *
+ * - On success: `[0x00, entropyHash_0 (32B), entropyHash_1 (32B), ...]` — the
+ *   status byte followed by one VRF output hash per ticket, in input order.
+ * - On failure: `[0x01, 0x00 * (numTickets * 32)]` — the status byte followed
+ *   by a zero-filled region of the same length; the hashes must be ignored.
+ *
+ * `numTickets` equals `ticketsData.length / (vrfInputDataLen + 784)`, so the
+ * response length is identical for success and failure.
+ */
 declare function batchVerifyTickets(ringSize: number, commitment: Uint8Array, ticketsData: Uint8Array, vrfInputDataLen: number): Uint8Array;
 //#endregion
 //#region native/index.d.ts