api3dao · dcroote · Jan 2, 2026 · Dec 27, 2025 · Dec 27, 2025 · Dec 27, 2025
diff --git a/.changeset/blue-jeans-switch.md b/.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
diff --git a/packages/airnode-adapter/package.json b/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",

diff --git a/packages/airnode-adapter/test/fixtures/ois.ts b/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: {

diff --git a/packages/airnode-admin/package.json b/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",

diff --git a/packages/airnode-admin/test/e2e/cli.feature.ts b/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());
     });
   });
 

diff --git a/packages/airnode-deployer/config/config.example.json b/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": {

diff --git a/packages/airnode-deployer/package.json b/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",

diff --git a/packages/airnode-deployer/test/fixtures/config.aws.valid.json b/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": {

diff --git a/packages/airnode-deployer/test/fixtures/config.gcp.valid.json b/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": {

diff --git a/packages/airnode-examples/integrations/authenticated-coinmarketcap/config.example.json b/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": {

diff --git a/packages/airnode-examples/integrations/authenticated-coinmarketcap/create-config.ts b/packages/airnode-examples/integrations/authenticated-coinmarketcap/create-config.ts
@@ -90,7 +90,7 @@ const createConfig = async (generateExampleFile: boolean): Promise<Config> => ({
   templates: [],
   ois: [
     {
-      oisFormat: '2.3.2',
+      oisFormat: '3.0.0',
       title: 'CoinMarketCap Basic Authenticated Request',
       version: '1.0.0',
       apiSpecifications: {

diff --git a/packages/airnode-examples/integrations/coingecko-cross-chain-authorizer/config.example.json b/packages/airnode-examples/integrations/coingecko-cross-chain-authorizer/config.example.json
@@ -111,7 +111,7 @@
   "templates": [],
   "ois": [
     {
-      "oisFormat": "2.3.2",
+      "oisFormat": "3.0.0",
       "title": "CoinGecko basic request",
       "version": "1.0.0",
       "apiSpecifications": {

diff --git a/packages/airnode-examples/integrations/coingecko-cross-chain-authorizer/create-config.ts b/packages/airnode-examples/integrations/coingecko-cross-chain-authorizer/create-config.ts
@@ -119,7 +119,7 @@ const createConfig = async (generateExampleFile: boolean): Promise<Config> => ({
   templates: [],
   ois: [
     {
-      oisFormat: '2.3.2',
+      oisFormat: '3.0.0',
       title: 'CoinGecko basic request',
       version: '1.0.0',
       apiSpecifications: {

diff --git a/packages/airnode-examples/integrations/coingecko-http-gateways/config.example.json b/packages/airnode-examples/integrations/coingecko-http-gateways/config.example.json
@@ -99,7 +99,7 @@
   "templates": [],
   "ois": [
     {
-      "oisFormat": "2.3.2",
+      "oisFormat": "3.0.0",
       "title": "CoinGecko basic request",
       "version": "1.0.0",
       "apiSpecifications": {

diff --git a/packages/airnode-examples/integrations/coingecko-http-gateways/create-config.ts b/packages/airnode-examples/integrations/coingecko-http-gateways/create-config.ts
@@ -106,7 +106,7 @@ const createConfig = async (generateExampleFile: boolean): Promise<Config> => ({
   templates: [],
   ois: [
     {
-      oisFormat: '2.3.2',
+      oisFormat: '3.0.0',
       title: 'CoinGecko basic request',
       version: '1.0.0',
       apiSpecifications: {

diff --git a/packages/airnode-examples/integrations/coingecko-post-processing/config.example.json b/packages/airnode-examples/integrations/coingecko-post-processing/config.example.json
@@ -83,7 +83,7 @@
   "templates": [],
   "ois": [
     {
-      "oisFormat": "2.3.2",
+      "oisFormat": "3.0.0",
       "title": "CoinGecko coins markets request",
       "version": "1.0.0",
       "apiSpecifications": {

diff --git a/packages/airnode-examples/integrations/coingecko-post-processing/create-config.ts b/packages/airnode-examples/integrations/coingecko-post-processing/create-config.ts
@@ -90,7 +90,7 @@ const createConfig = async (generateExampleFile: boolean): Promise<Config> => ({
   templates: [],
   ois: [
     {
-      oisFormat: '2.3.2',
+      oisFormat: '3.0.0',
       title: 'CoinGecko coins markets request',
       version: '1.0.0',
       apiSpecifications: {

diff --git a/packages/airnode-examples/integrations/coingecko-pre-processing/config.example.json b/packages/airnode-examples/integrations/coingecko-pre-processing/config.example.json
@@ -83,7 +83,7 @@
   "templates": [],
   "ois": [
     {
-      "oisFormat": "2.3.2",
+      "oisFormat": "3.0.0",
       "title": "CoinGecko history data request",
       "version": "1.0.0",
       "apiSpecifications": {

diff --git a/packages/airnode-examples/integrations/coingecko-pre-processing/create-config.ts b/packages/airnode-examples/integrations/coingecko-pre-processing/create-config.ts
@@ -90,7 +90,7 @@ const createConfig = async (generateExampleFile: boolean): Promise<Config> => ({
   templates: [],
   ois: [
     {
-      oisFormat: '2.3.2',
+      oisFormat: '3.0.0',
       title: 'CoinGecko history data request',
       version: '1.0.0',
       apiSpecifications: {

diff --git a/packages/airnode-examples/integrations/coingecko-template/config.example.json b/packages/airnode-examples/integrations/coingecko-template/config.example.json
@@ -89,7 +89,7 @@
   ],
   "ois": [
     {
-      "oisFormat": "2.3.2",
+      "oisFormat": "3.0.0",
       "title": "CoinGecko basic request",
       "version": "1.0.0",
       "apiSpecifications": {

diff --git a/packages/airnode-examples/integrations/coingecko-template/create-config.ts b/packages/airnode-examples/integrations/coingecko-template/create-config.ts
@@ -98,7 +98,7 @@ const createConfig = async (generateExampleFile: boolean): Promise<Config> => ({
   ],
   ois: [
     {
-      oisFormat: '2.3.2',
+      oisFormat: '3.0.0',
       title: 'CoinGecko basic request',
       version: '1.0.0',
       apiSpecifications: {

diff --git a/packages/airnode-examples/integrations/coingecko/config.example.json b/packages/airnode-examples/integrations/coingecko/config.example.json
@@ -83,7 +83,7 @@
   "templates": [],
   "ois": [
     {
-      "oisFormat": "2.3.2",
+      "oisFormat": "3.0.0",
       "title": "CoinGecko basic request",
       "version": "1.0.0",
       "apiSpecifications": {

diff --git a/packages/airnode-examples/integrations/coingecko/create-config.ts b/packages/airnode-examples/integrations/coingecko/create-config.ts
@@ -90,7 +90,7 @@ const createConfig = async (generateExampleFile: boolean): Promise<Config> => ({
   templates: [],
   ois: [
     {
-      oisFormat: '2.3.2',
+      oisFormat: '3.0.0',
       title: 'CoinGecko basic request',
       version: '1.0.0',
       apiSpecifications: {

diff --git a/packages/airnode-examples/integrations/failing-example/config.example.json b/packages/airnode-examples/integrations/failing-example/config.example.json
@@ -83,7 +83,7 @@
   "templates": [],
   "ois": [
     {
-      "oisFormat": "2.3.2",
+      "oisFormat": "3.0.0",
       "title": "Failure Example",
       "version": "1.0.0",
       "apiSpecifications": {

diff --git a/packages/airnode-examples/integrations/failing-example/create-config.ts b/packages/airnode-examples/integrations/failing-example/create-config.ts
@@ -90,7 +90,7 @@ const createConfig = async (generateExampleFile: boolean): Promise<Config> => ({
   templates: [],
   ois: [
     {
-      oisFormat: '2.3.2',
+      oisFormat: '3.0.0',
       title: 'Failure Example',
       version: '1.0.0',
       apiSpecifications: {

diff --git a/packages/airnode-examples/integrations/relay-security-schemes/config.example.json b/packages/airnode-examples/integrations/relay-security-schemes/config.example.json
@@ -83,7 +83,7 @@
   "templates": [],
   "ois": [
     {
-      "oisFormat": "2.3.2",
+      "oisFormat": "3.0.0",
       "title": "Relay Security Schemes via httpbin",
       "version": "1.0.0",
       "apiSpecifications": {

diff --git a/packages/airnode-examples/integrations/relay-security-schemes/create-config.ts b/packages/airnode-examples/integrations/relay-security-schemes/create-config.ts
@@ -90,7 +90,7 @@ const createConfig = async (generateExampleFile: boolean): Promise<Config> => ({
   templates: [],
   ois: [
     {
-      oisFormat: '2.3.2',
+      oisFormat: '3.0.0',
       title: 'Relay Security Schemes via httpbin',
       version: '1.0.0',
       apiSpecifications: {

diff --git a/packages/airnode-examples/integrations/weather-multi-value/config.example.json b/packages/airnode-examples/integrations/weather-multi-value/config.example.json
@@ -83,7 +83,7 @@
   "templates": [],
   "ois": [
     {
-      "oisFormat": "2.3.2",
+      "oisFormat": "3.0.0",
       "title": "OpenWeather Multiple Encoded Values",
       "version": "1.0.0",
       "apiSpecifications": {

diff --git a/packages/airnode-examples/integrations/weather-multi-value/create-config.ts b/packages/airnode-examples/integrations/weather-multi-value/create-config.ts
@@ -90,7 +90,7 @@ const createConfig = async (generateExampleFile: boolean): Promise<Config> => ({
   templates: [],
   ois: [
     {
-      oisFormat: '2.3.2',
+      oisFormat: '3.0.0',
       title: 'OpenWeather Multiple Encoded Values',
       version: '1.0.0',
       apiSpecifications: {

diff --git a/packages/airnode-node/config/config.example.json b/packages/airnode-node/config/config.example.json
@@ -113,7 +113,7 @@
   "templates": [],
   "ois": [
     {
-      "oisFormat": "2.3.2",
+      "oisFormat": "3.0.0",
       "version": "1.2.3",
       "title": "Currency Converter API",
       "apiSpecifications": {

diff --git a/packages/airnode-node/package.json b/packages/airnode-node/package.json
@@ -31,7 +31,7 @@
     "@api3/airnode-validator": "^0.15.0",
     "@api3/chains": "^8.1.1",
     "@api3/commons": "^0.9.0",
-    "@api3/ois": "2.3.2",
+    "@api3/ois": "3.0.0",
     "@api3/promise-utils": "^0.4.0",
     "@aws-sdk/client-lambda": "^3.525.0",
     "date-fns": "^3.6.0",
@@ -41,7 +41,7 @@
     "google-auth-library": "^9.6.3",
     "lodash": "^4.17.21",
     "yargs": "^17.7.2",
-    "zod": "^3.22.4"
+    "zod": "^4.2.1"
   },
   "devDependencies": {
     "@api3/airnode-operation": "^0.15.0",

diff --git a/packages/airnode-node/src/config/index.ts b/packages/airnode-node/src/config/index.ts
@@ -26,7 +26,7 @@ const readConfig = (configPath: string): unknown => {
 };
 
 export function addDefaultContractAddresses(config: configTypes.Config): configTypes.Config {
-  const ctx = { addIssue: () => {}, path: [] }; // Unused, but required by validator functions
+  const ctx = { addIssue: () => {}, path: [], value: null, issues: [] }; // Unused, but required by validator functions
   const chains = config.chains.map((chain) => {
     const { contracts } = configTypes.ensureConfigValidAirnodeRrp(chain, ctx);
 

diff --git a/packages/airnode-node/src/workers/local-gateways/validation.ts b/packages/airnode-node/src/workers/local-gateways/validation.ts
@@ -38,7 +38,7 @@ function verifyEndpointId(
   config: Config,
   endpointId: unknown,
   gateway: 'http' | 'httpSignedData'
-): VerificationResult<z.SafeParseSuccess<string>> {
+): VerificationResult<z.ZodSafeParseSuccess<string>> {
   const parsedEndpointId = endpointIdSchema.safeParse(endpointId);
   if (!parsedEndpointId.success) {
     return {

diff --git a/packages/airnode-node/test/fixtures/config/config.valid.json b/packages/airnode-node/test/fixtures/config/config.valid.json
@@ -84,7 +84,7 @@
   "templates": [],
   "ois": [
     {
-      "oisFormat": "2.3.2",
+      "oisFormat": "3.0.0",
       "title": "CoinGecko basic request",
       "version": "1.0.0",
       "apiSpecifications": {

diff --git a/packages/airnode-node/test/fixtures/config/ois.ts b/packages/airnode-node/test/fixtures/config/ois.ts
@@ -2,7 +2,7 @@ import { OIS } from '@api3/ois';
 
 export function buildOIS(ois?: Partial<OIS>): OIS {
   return {
-    oisFormat: '2.3.2',
+    oisFormat: '3.0.0',
     version: '1.2.3',
     title: 'Currency Converter API',
     apiSpecifications: {

diff --git a/packages/airnode-validator/package.json b/packages/airnode-validator/package.json
@@ -23,14 +23,14 @@
   "dependencies": {
     "@api3/airnode-protocol": "^0.15.0",
     "@api3/commons": "^0.9.0",
-    "@api3/ois": "2.3.2",
+    "@api3/ois": "3.0.0",
     "@api3/promise-utils": "^0.4.0",
     "dotenv": "^16.4.7",
     "ethers": "^5.7.2",
     "lodash": "^4.17.21",
     "ora": "^5.4.1",
     "yargs": "^17.7.2",
-    "zod": "^3.22.4"
+    "zod": "^4.2.1"
   },
   "devDependencies": {
     "@types/yargs": "^17.0.32",