Upgrade zod to v4 and OIS to v3 (#2042)

* Bump zod to v4 and OIS to v3

* Fix airnode-validator tests

* Replace hardcoded cloud providers with option map

* Add retry to getBalance calls to fix problematic airnode-admin e2e test

* Add custom error message for messy timestamp zod regex

Author: dcroote

.changeset/blue-jeans-switch.md

@@ -0,0 +1,9 @@
+---
+"@api3/airnode-validator": minor
+"@api3/airnode-deployer": minor
+"@api3/airnode-examples": minor
+"@api3/airnode-adapter": minor
+"@api3/airnode-node": minor
+---
+
+Bump zod to v4 and OIS to v3

packages/airnode-adapter/package.json

@@ -19,7 +19,7 @@
     "test:watch": "yarn test:ts --watch"
   },
   "dependencies": {
-    "@api3/ois": "2.3.2",
+    "@api3/ois": "3.0.0",
     "@api3/promise-utils": "^0.4.0",
     "axios": "^1.12.2",
     "bignumber.js": "^9.1.2",

packages/airnode-adapter/test/fixtures/ois.ts

@@ -2,7 +2,7 @@ import { OIS } from '@api3/ois';
 
 export function buildOIS(overrides?: Partial<OIS>): OIS {
   return {
-    oisFormat: '2.3.2',
+    oisFormat: '3.0.0',
     version: '1.2.3',
     title: 'Currency Converter API',
     apiSpecifications: {

packages/airnode-admin/package.json

@@ -16,7 +16,7 @@
     "cli": "ts-node bin/admin.ts",
     "compile": "tsc --build tsconfig.json",
     "pack": "yarn pack",
-    "test:e2e": "jest --selectProjects e2e",
+    "test:e2e": "jest --selectProjects e2e --runInBand",
     "test:e2e:update-snapshot": "yarn test:e2e --updateSnapshot",
     "test:e2e:watch": "yarn test:e2e --watch",
     "test": "SILENCE_LOGGER=true jest --selectProjects unit",

packages/airnode-admin/test/e2e/cli.feature.ts

@@ -25,7 +25,7 @@ it('has disabled DEBUG_COMMANDS flag', () => {
 });
 
 describe('CLI', () => {
-  jest.setTimeout(45_000);
+  jest.setTimeout(300_000);
 
   let provider: ethers.providers.StaticJsonRpcProvider;
   let deployer: ethers.providers.JsonRpcSigner;
@@ -333,7 +333,19 @@ Template data:
   describe('withdrawal', () => {
     let sponsor: ethers.Wallet;
     let sponsorWallet: ethers.Wallet;
-    const sponsorBalance = () => sponsor.getBalance();
+
+    // Helper to retry async operations that may fail due to transient connection issues in CI
+    const withRetry = async <T>(fn: () => Promise<T>, maxRetries = 3, delayMs = 1000): Promise<T> => {
+      for (let attempt = 1; attempt <= maxRetries; attempt++) {
+        try {
+          return await fn();
+        } catch (error) {
+          if (attempt === maxRetries) throw error;
+          await new Promise((resolve) => setTimeout(resolve, delayMs * attempt));
+        }
+      }
+      throw new Error('Unreachable');
+    };
 
     beforeEach(async () => {
       // Prepare for derivation of designated wallet - see test for designated wallet derivation for details
@@ -371,13 +383,23 @@ Template data:
 
       expect(checkWithdrawalStatus()).toBe('Withdrawal request is not fulfilled yet');
 
-      const balanceBefore = await sponsorBalance();
+      // Use retry for balance fetches to handle transient ECONNRESET errors in CI
+      const balanceBefore = await withRetry(() => sponsor.getBalance());
       airnodeRrp = airnodeRrp.connect(sponsorWallet);
-      await admin.fulfillWithdrawal(airnodeRrp, withdrawalRequestId, airnodeWallet.address, sponsor.address, '0.8');
-      expect(checkWithdrawalStatus()).toBe('Withdrawn amount: 800000000000000000');
-      expect((await sponsorBalance()).toString()).toBe(
-        balanceBefore.add(ethers.BigNumber.from('800000000000000000')).toString()
+
+      const fulfillResult = await admin.fulfillWithdrawal(
+        airnodeRrp,
+        withdrawalRequestId,
+        airnodeWallet.address,
+        sponsor.address,
+        '0.8'
       );
+      expect(fulfillResult).not.toBeNull();
+
+      expect(checkWithdrawalStatus()).toBe('Withdrawn amount: 800000000000000000');
+
+      const balanceAfter = await withRetry(() => sponsor.getBalance());
+      expect(balanceAfter.toString()).toBe(balanceBefore.add(ethers.BigNumber.from('800000000000000000')).toString());
     });
   });
 

packages/airnode-deployer/config/config.example.json

@@ -94,7 +94,7 @@
   "templates": [],
   "ois": [
     {
-      "oisFormat": "2.3.2",
+      "oisFormat": "3.0.0",
       "title": "CoinGecko basic request",
       "version": "1.0.0",
       "apiSpecifications": {

packages/airnode-deployer/package.json

@@ -43,7 +43,7 @@
     "lodash": "^4.17.21",
     "ora": "^5.4.1",
     "yargs": "^17.7.2",
-    "zod": "^3.22.4"
+    "zod": "^4.2.1"
   },
   "devDependencies": {
     "@aws-sdk/util-stream-node": "^3.374.0",

packages/airnode-deployer/test/fixtures/config.aws.valid.json

@@ -94,7 +94,7 @@
   "templates": [],
   "ois": [
     {
-      "oisFormat": "2.3.2",
+      "oisFormat": "3.0.0",
       "title": "CoinGecko basic request",
       "version": "1.0.0",
       "apiSpecifications": {

packages/airnode-deployer/test/fixtures/config.gcp.valid.json

@@ -95,7 +95,7 @@
   "templates": [],
   "ois": [
     {
-      "oisFormat": "2.3.2",
+      "oisFormat": "3.0.0",
       "title": "CoinGecko basic request",
       "version": "1.0.0",
       "apiSpecifications": {

packages/airnode-examples/integrations/authenticated-coinmarketcap/config.example.json

@@ -83,7 +83,7 @@
   "templates": [],
   "ois": [
     {
-      "oisFormat": "2.3.2",
+      "oisFormat": "3.0.0",
       "title": "CoinMarketCap Basic Authenticated Request",
       "version": "1.0.0",
       "apiSpecifications": {