@polygonlabs/staker-pool-allocations-schemas 0.1.0

package/src/unclaimed-proofs.ts

@@ -0,0 +1,27 @@
+import { DistributionIdSchema, Hex32Schema, WeiSchema } from './common.ts';
+import { z } from './zod.ts';
+
+// One unclaimed-distribution entry in the batched-claims payload. The
+// shape matches a Solidity verifier's expected arguments for the
+// claimer contract's batched-claim method: pass the array straight
+// through. Per spec §7.2, this is the **primary UI endpoint** — the
+// frontend hands the whole array to the claimer in one transaction.
+export const UnclaimedProofBatchSchema = z
+  .object({
+    distributionId: DistributionIdSchema,
+    merkleRoot: Hex32Schema,
+    amount: WeiSchema,
+    leafIndex: z.number().int().nonnegative(),
+    proof: z.array(Hex32Schema)
+  })
+  .openapi('UnclaimedProofBatch');
+
+export type UnclaimedProofBatch = z.infer<typeof UnclaimedProofBatchSchema>;
+
+export const UnclaimedProofsResponseSchema = z
+  .object({
+    items: z.array(UnclaimedProofBatchSchema)
+  })
+  .openapi('UnclaimedProofsResponse');
+
+export type UnclaimedProofsResponse = z.infer<typeof UnclaimedProofsResponseSchema>;

package/src/zod.ts

@@ -0,0 +1,9 @@
+import { extendZodWithOpenApi } from '@asteasolutions/zod-to-openapi';
+import { z } from 'zod';
+
+// Side-effect-only import-time augmentation: adds `.openapi(...)` to
+// every Zod schema. Imported once at the seam where schemas are first
+// declared so it has run before any `registerPath` call.
+extendZodWithOpenApi(z);
+
+export { z };