feat(1716): mirror node pending and outstanding airdrops response validation (#1744)

Signed-off-by: rozekmichal <michal.rozek@blockydevs.com>

Author: rozekmichal

src/core/services/mirrornode/hedera-mirrornode-service.ts

@@ -38,6 +38,7 @@ import { handleMirrorNodeErrorResponse } from '@/core/utils/handle-mirror-node-e
 import {
   AccountAPIResponseSchema,
   GetAccountsAPIResponseSchema,
+  TokenAirdropsResponseSchema,
   TokenBalancesResponseSchema,
   TokenInfoSchema,
   TopicInfoSchema,
@@ -493,7 +494,11 @@ export class HederaMirrornodeServiceDefaultImpl implements HederaMirrornodeServi
         );
       }
 
-      return (await response.json()) as TokenAirdropsResponse;
+      return parseWithSchema(
+        TokenAirdropsResponseSchema,
+        await response.json(),
+        `Mirror Node GET /accounts/${accountId}/airdrops/pending`,
+      );
     } catch (error) {
       if (error instanceof CliError) throw error;
       throw new NetworkError(
@@ -519,7 +524,11 @@ export class HederaMirrornodeServiceDefaultImpl implements HederaMirrornodeServi
         );
       }
 
-      return (await response.json()) as TokenAirdropsResponse;
+      return parseWithSchema(
+        TokenAirdropsResponseSchema,
+        await response.json(),
+        `Mirror Node GET /accounts/${accountId}/airdrops/outstanding`,
+      );
     } catch (error) {
       if (error instanceof CliError) throw error;
       throw new NetworkError(

src/core/services/mirrornode/schemas.ts

@@ -6,6 +6,8 @@ import type {
   AccountListItemBalance,
   AccountListItemTokenBalance,
   GetAccountsAPIResponse,
+  TokenAirdropItem,
+  TokenAirdropsResponse,
   TokenBalanceInfo,
   TokenBalancesResponse,
   TokenInfo,
@@ -158,6 +160,18 @@ export const TokenBalancesResponseSchema: z.ZodType<TokenBalancesResponse> =
       .optional(),
   });
 
+const TokenAirdropItemSchema: z.ZodType<TokenAirdropItem> = z.object({
+  account_id: z.string(),
+  amount: z.number(),
+  token_id: z.string(),
+  timestamp: z.string(),
+});
+
+export const TokenAirdropsResponseSchema: z.ZodType<TokenAirdropsResponse> =
+  z.object({
+    airdrops: z.array(TokenAirdropItemSchema),
+  });
+
 export const TopicInfoSchema: z.ZodType<TopicInfo> = z.object({
   topic_id: z.string(),
   admin_key: optionalKeyRef,

src/core/services/mirrornode/types.ts

@@ -216,13 +216,15 @@ export interface ContractInfo {
 }
 
 // Token Airdrops
+export interface TokenAirdropItem {
+  account_id: string;
+  amount: number;
+  token_id: string;
+  timestamp: string;
+}
+
 export interface TokenAirdropsResponse {
-  airdrops: Array<{
-    account_id: string;
-    amount: number;
-    token_id: string;
-    timestamp: string;
-  }>;
+  airdrops: TokenAirdropItem[];
 }
 
 // Exchange Rate