@lidofinance/lsv-cli 1.8.0 → 1.10.0-alpha.1

package/dist/utils/consolidation/pubkeys.js.map

@@ -1 +1 @@
-{"version":3,"file":"pubkeys.js","sourceRoot":"","sources":["../../../utils/consolidation/pubkeys.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAO,UAAU,EAAE,MAAM,MAAM,CAAC;AAInD,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,yBAAoD,EACnC,EAAE;IACnB,MAAM,aAAa,GAAG,CAAC,GAAG,yBAAyB,CAAC,IAAI,EAAE,CAAC,CAAC;IAC5D,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QAClC,MAAM,SAAS,GAAG,yBAAyB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACxD,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,oBAAoB,MAAM,mBAAmB,CAAC,CAAC;QACjE,CAAC;QAED,MAAM,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC;aAClD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;aAChC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEZ,OAAO,KAAK,MAAM,EAAE,CAAC;IACvB,CAAC,CAAoB,CAAC;AACxB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,wCAAwC,GAAG,CACtD,WAAgB,EAC0B,EAAE;IAC5C,MAAM,gBAAgB,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;IACjD,MAAM,YAAY,GAAG,UAAU,CAC7B,gBAAgB,CAAC,KAAK,CAAC,CAAC,EAAE,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAC,CACvD,CAAC;IACF,MAAM,YAAY,GAAG,UAAU,CAC7B,gBAAgB,CAAC,KAAK,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAC,CACpD,CAAC;IAEF,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,CAAC;AACxC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAC9C,yBAAoD,EACpD,YAAoB,EACpB,EAAE;IACF,yBAAyB,CAAC,GAAG,CAC3B,oGAAoG,EACpG;QACE,IAAI,EAAE;YACJ,MAAM,EAAE,gBAAgB;YACxB,OAAO,EAAE,YAAY;YACrB,KAAK,EAAE,GAAG;YACV,gBAAgB,EAAE,YAAY;SAC/B;QACD,gBAAgB,EAAE,IAAI,GAAG,CAAC;YACxB;gBACE,oGAAoG;gBACpG;oBACE,MAAM,EAAE,gBAAgB;oBACxB,OAAO,EAAE,YAAY;oBACrB,KAAK,EAAE,GAAG;oBACV,gBAAgB,EAAE,YAAY;iBAC/B;aACF;SACF,CAAC;KACH,CACF,CAAC;AACJ,CAAC,CAAC"}
+{"version":3,"file":"pubkeys.js","sourceRoot":"","sources":["../../../utils/consolidation/pubkeys.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAO,UAAU,EAAE,MAAM,MAAM,CAAC;AAInD,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,yBAAoD,EACnC,EAAE;IACnB,MAAM,aAAa,GAAG,CAAC,GAAG,yBAAyB,CAAC,IAAI,EAAE,CAAC,CAAC;IAC5D,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QAClC,MAAM,SAAS,GAAG,yBAAyB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACxD,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,oBAAoB,MAAM,mBAAmB,CAAC,CAAC;QACjE,CAAC;QAED,MAAM,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC;aAClD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;aAChC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEZ,OAAO,KAAK,MAAM,EAAE,CAAC;IACvB,CAAC,CAAoB,CAAC;AACxB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,wCAAwC,GAAG,CACtD,WAAgB,EAC0B,EAAE;IAC5C,MAAM,gBAAgB,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;IACjD,MAAM,YAAY,GAAG,UAAU,CAC7B,gBAAgB,CAAC,KAAK,CAAC,CAAC,EAAE,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAC,CACvD,CAAC;IACF,MAAM,YAAY,GAAG,UAAU,CAC7B,gBAAgB,CAAC,KAAK,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAC,CACpD,CAAC;IAEF,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,CAAC;AACxC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAC9C,yBAAoD,EACpD,YAAoB,EACpB,EAAE;IACF,yBAAyB,CAAC,GAAG,CAC3B,oGAAoG,EACpG;QACE,IAAI,EAAE;YACJ,MAAM,EAAE,gBAAgB;YACxB,OAAO,EAAE,YAAY;YACrB,KAAK,EAAE,GAAG;YACV,gBAAgB,EAAE,YAAY;YAC9B,OAAO,EAAE,KAAK;SACf;QACD,gBAAgB,EAAE,IAAI,GAAG,CAAC;YACxB;gBACE,oGAAoG;gBACpG;oBACE,MAAM,EAAE,gBAAgB;oBACxB,OAAO,EAAE,YAAY;oBACrB,KAAK,EAAE,GAAG;oBACV,gBAAgB,EAAE,YAAY;oBAC9B,OAAO,EAAE,KAAK;iBACf;aACF;SACF,CAAC;KACH,CACF,CAAC;AACJ,CAAC,CAAC"}

package/dist/utils/consolidation/types.d.ts

@@ -4,6 +4,7 @@ export type ValidatorInfo = {
     balance: bigint;
     index: string;
     effectiveBalance: bigint;
+    slashed: boolean;
 };
 export type PubkeyMap = Record<Hex, Hex[]>;
 export type TargetAndSourceValidators = Map<Hex, {

package/dist/utils/consolidation/validator-info.d.ts

@@ -1,4 +1,5 @@
 import { Hex } from 'viem';
 import { ValidatorsInfo } from '../fetch-cl.js';
-import { TargetAndSourceValidators } from './types.js';
+import { TargetAndSourceValidators, ValidatorInfo } from './types.js';
+export declare const consolidatedBalance: (info: ValidatorInfo) => bigint;
 export declare const getTargetAndSourceValidatorsInfo: (targetPubkeys: Hex[], targetValidatorsInfo: ValidatorsInfo, sourcePubkeys: Hex[][], sourceValidatorsInfo: ValidatorsInfo) => TargetAndSourceValidators;

package/dist/utils/consolidation/validator-info.js

@@ -1,4 +1,8 @@
 import { parseGwei } from 'viem';
+import { bigIntMin } from '../big-int.js';
+// what process_pending_consolidations moves to the target:
+// min(balance, effective_balance), and nothing at all for a slashed source
+export const consolidatedBalance = (info) => info.slashed ? 0n : bigIntMin(info.balance, info.effectiveBalance);
 export const getTargetAndSourceValidatorsInfo = (targetPubkeys, targetValidatorsInfo, sourcePubkeys, sourceValidatorsInfo) => {
     const targetAndSourceValidatorsInfo = new Map();
     for (const [i, targetPubkey] of targetPubkeys.entries()) {
@@ -12,6 +16,7 @@ export const getTargetAndSourceValidatorsInfo = (targetPubkeys, targetValidators
                 balance: parseGwei(targetValidatorInfo.balance),
                 index: targetValidatorInfo.index,
                 effectiveBalance: parseGwei(targetValidatorInfo.validator.effective_balance),
+                slashed: targetValidatorInfo.validator.slashed,
             },
             sourceValidators: new Map(),
         });
@@ -28,6 +33,7 @@ export const getTargetAndSourceValidatorsInfo = (targetPubkeys, targetValidators
                 balance: parseGwei(sourceValidatorInfo.balance),
                 index: sourceValidatorInfo.index,
                 effectiveBalance: parseGwei(sourceValidatorInfo.validator.effective_balance),
+                slashed: sourceValidatorInfo.validator.slashed,
             });
         }
     }

package/dist/utils/consolidation/validator-info.js.map

@@ -1 +1 @@
-{"version":3,"file":"validator-info.js","sourceRoot":"","sources":["../../../utils/consolidation/validator-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,SAAS,EAAE,MAAM,MAAM,CAAC;AAMtC,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAC9C,aAAoB,EACpB,oBAAoC,EACpC,aAAsB,EACtB,oBAAoC,EACT,EAAE;IAC7B,MAAM,6BAA6B,GAA8B,IAAI,GAAG,EAAE,CAAC;IAC3E,KAAK,MAAM,CAAC,CAAC,EAAE,YAAY,CAAC,IAAI,aAAa,CAAC,OAAO,EAAE,EAAE,CAAC;QACxD,MAAM,mBAAmB,GAAG,oBAAoB,CAAC,IAAI,CAAC,IAAI,CACxD,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,KAAK,YAAY,CAC3D,CAAC;QACF,IAAI,CAAC,mBAAmB,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,gCAAgC,YAAY,YAAY,CAAC,CAAC;QAC5E,CAAC;QACD,6BAA6B,CAAC,GAAG,CAAC,YAAY,EAAE;YAC9C,IAAI,EAAE;gBACJ,MAAM,EAAE,mBAAmB,CAAC,MAAM;gBAClC,OAAO,EAAE,SAAS,CAAC,mBAAmB,CAAC,OAAO,CAAC;gBAC/C,KAAK,EAAE,mBAAmB,CAAC,KAAK;gBAChC,gBAAgB,EAAE,SAAS,CACzB,mBAAmB,CAAC,SAAS,CAAC,iBAAiB,CAChD;aACF;YACD,gBAAgB,EAAE,IAAI,GAAG,EAAE;SAC5B,CAAC,CAAC;QACH,MAAM,kBAAkB,GAAG,aAAa,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAClD,KAAK,MAAM,YAAY,IAAI,kBAAkB,EAAE,CAAC;YAC9C,MAAM,mBAAmB,GAAG,oBAAoB,CAAC,IAAI,CAAC,IAAI,CACxD,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,KAAK,YAAY,CAC3D,CAAC;YACF,IAAI,CAAC,mBAAmB,EAAE,CAAC;gBACzB,MAAM,IAAI,KAAK,CACb,gCAAgC,YAAY,YAAY,CACzD,CAAC;YACJ,CAAC;YACD,6BAA6B;iBAC1B,GAAG,CAAC,YAAY,CAAC;gBAClB,EAAE,gBAAgB,CAAC,GAAG,CAAC,YAAY,EAAE;gBACnC,MAAM,EAAE,mBAAmB,CAAC,MAAM;gBAClC,OAAO,EAAE,SAAS,CAAC,mBAAmB,CAAC,OAAO,CAAC;gBAC/C,KAAK,EAAE,mBAAmB,CAAC,KAAK;gBAChC,gBAAgB,EAAE,SAAS,CACzB,mBAAmB,CAAC,SAAS,CAAC,iBAAiB,CAChD;aACF,CAAC,CAAC;QACP,CAAC;IACH,CAAC;IACD,OAAO,6BAA6B,CAAC;AACvC,CAAC,CAAC"}
+{"version":3,"file":"validator-info.js","sourceRoot":"","sources":["../../../utils/consolidation/validator-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,SAAS,EAAE,MAAM,MAAM,CAAC;AAGtC,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAI1C,2DAA2D;AAC3D,2EAA2E;AAC3E,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,IAAmB,EAAU,EAAE,CACjE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,gBAAgB,CAAC,CAAC;AAErE,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAC9C,aAAoB,EACpB,oBAAoC,EACpC,aAAsB,EACtB,oBAAoC,EACT,EAAE;IAC7B,MAAM,6BAA6B,GAA8B,IAAI,GAAG,EAAE,CAAC;IAC3E,KAAK,MAAM,CAAC,CAAC,EAAE,YAAY,CAAC,IAAI,aAAa,CAAC,OAAO,EAAE,EAAE,CAAC;QACxD,MAAM,mBAAmB,GAAG,oBAAoB,CAAC,IAAI,CAAC,IAAI,CACxD,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,KAAK,YAAY,CAC3D,CAAC;QACF,IAAI,CAAC,mBAAmB,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,gCAAgC,YAAY,YAAY,CAAC,CAAC;QAC5E,CAAC;QACD,6BAA6B,CAAC,GAAG,CAAC,YAAY,EAAE;YAC9C,IAAI,EAAE;gBACJ,MAAM,EAAE,mBAAmB,CAAC,MAAM;gBAClC,OAAO,EAAE,SAAS,CAAC,mBAAmB,CAAC,OAAO,CAAC;gBAC/C,KAAK,EAAE,mBAAmB,CAAC,KAAK;gBAChC,gBAAgB,EAAE,SAAS,CACzB,mBAAmB,CAAC,SAAS,CAAC,iBAAiB,CAChD;gBACD,OAAO,EAAE,mBAAmB,CAAC,SAAS,CAAC,OAAO;aAC/C;YACD,gBAAgB,EAAE,IAAI,GAAG,EAAE;SAC5B,CAAC,CAAC;QACH,MAAM,kBAAkB,GAAG,aAAa,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAClD,KAAK,MAAM,YAAY,IAAI,kBAAkB,EAAE,CAAC;YAC9C,MAAM,mBAAmB,GAAG,oBAAoB,CAAC,IAAI,CAAC,IAAI,CACxD,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,KAAK,YAAY,CAC3D,CAAC;YACF,IAAI,CAAC,mBAAmB,EAAE,CAAC;gBACzB,MAAM,IAAI,KAAK,CACb,gCAAgC,YAAY,YAAY,CACzD,CAAC;YACJ,CAAC;YACD,6BAA6B;iBAC1B,GAAG,CAAC,YAAY,CAAC;gBAClB,EAAE,gBAAgB,CAAC,GAAG,CAAC,YAAY,EAAE;gBACnC,MAAM,EAAE,mBAAmB,CAAC,MAAM;gBAClC,OAAO,EAAE,SAAS,CAAC,mBAAmB,CAAC,OAAO,CAAC;gBAC/C,KAAK,EAAE,mBAAmB,CAAC,KAAK;gBAChC,gBAAgB,EAAE,SAAS,CACzB,mBAAmB,CAAC,SAAS,CAAC,iBAAiB,CAChD;gBACD,OAAO,EAAE,mBAAmB,CAAC,SAAS,CAAC,OAAO;aAC/C,CAAC,CAAC;QACP,CAAC;IACH,CAAC;IACD,OAAO,6BAA6B,CAAC;AACvC,CAAC,CAAC"}

package/dist/utils/env.d.ts

@@ -0,0 +1 @@
+export declare const parseEnvInt: (raw: string | undefined, fallback: number) => number;

package/dist/utils/env.js

@@ -0,0 +1,8 @@
+// Parse an integer from an env var, falling back when unset or invalid.
+export const parseEnvInt = (raw, fallback) => {
+    if (!raw)
+        return fallback;
+    const n = Number(raw);
+    return Number.isFinite(n) ? n : fallback;
+};
+//# sourceMappingURL=env.js.map

package/dist/utils/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../utils/env.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,MAAM,CAAC,MAAM,WAAW,GAAG,CACzB,GAAuB,EACvB,QAAgB,EACR,EAAE;IACV,IAAI,CAAC,GAAG;QAAE,OAAO,QAAQ,CAAC;IAC1B,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IACtB,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;AAC3C,CAAC,CAAC"}

package/dist/utils/ipfs.d.ts

@@ -1,20 +1,27 @@
 import { CID, Version } from 'multiformats/cid';
-export declare const IPFS_GATEWAY = "https://ipfs.io/ipfs";
+export declare const IPFS_GATEWAYS: {
+    readonly ipfsIo: "https://ipfs.io/ipfs";
+    readonly filebase: "https://ipfs.filebase.io/ipfs";
+    readonly pinata: "https://gateway.pinata.cloud/ipfs";
+};
+export declare const IPFS_GATEWAY: string;
+export declare const DEFAULT_IPFS_MAX_CONTENT_BYTES: number;
 export type BigNumberType = 'bigint' | 'string';
 export type ReportFetchArgs = {
     cid: string;
     gateway?: string;
     bigNumberType?: BigNumberType;
+    maxBytes?: number;
 };
 export declare const fetchIPFS: <T>(args: ReportFetchArgs, cache?: boolean) => Promise<T>;
 export declare const fetchIPFSDirect: <T>(args: ReportFetchArgs) => Promise<T>;
 export declare const fetchIPFSBuffer: (args: ReportFetchArgs) => Promise<Uint8Array>;
 export declare const calculateIPFSAddCID: (fileContent: Uint8Array, version?: Version) => Promise<CID>;
-export declare const fetchIPFSDirectAndVerify: <T>(cid: string, gateway?: string) => Promise<{
+export declare const fetchIPFSDirectAndVerify: <T>(cid: string, gateway?: string, maxBytes?: number) => Promise<{
     json: T;
     fileContent: Uint8Array;
 }>;
-export declare const fetchIPFSWithCacheAndVerify: <T>(cid: string, gateway?: string) => Promise<T>;
+export declare const fetchIPFSWithCacheAndVerify: <T>(cid: string, gateway?: string, maxBytes?: number) => Promise<T>;
 type PinToIPFSArgs = {
     uploadUrl: string;
     uploadAuthorization?: string;

package/dist/utils/ipfs.js

@@ -6,26 +6,114 @@ import fs from 'node:fs/promises';
 import path from 'node:path';
 import { logInfo, logTable } from './logging/console.js';
 import { assertSafeUrl } from './data-validators.js';
-export const IPFS_GATEWAY = 'https://ipfs.io/ipfs';
+import { parseEnvInt } from './env.js';
+export const IPFS_GATEWAYS = {
+    ipfsIo: 'https://ipfs.io/ipfs',
+    filebase: 'https://ipfs.filebase.io/ipfs',
+    pinata: 'https://gateway.pinata.cloud/ipfs',
+};
+export const IPFS_GATEWAY = IPFS_GATEWAYS.ipfsIo;
+// Max IPFS content size — guards against OOM from an oversized CID.
+// Override: maxBytes arg > IPFS_MAX_CONTENT_BYTES env > this default.
+export const DEFAULT_IPFS_MAX_CONTENT_BYTES = 20 * 1024 * 1024;
 const IPFS_CACHE_DIR = path.resolve('ipfs-cache');
+// arg > env > default
+const resolveMaxBytes = (override) => {
+    if (typeof override === 'number' &&
+        Number.isFinite(override) &&
+        override > 0) {
+        return override;
+    }
+    return Math.max(1, parseEnvInt(process.env.IPFS_MAX_CONTENT_BYTES, DEFAULT_IPFS_MAX_CONTENT_BYTES));
+};
+// Cheap pre-check. Header may be absent or lie — streaming is the real limit.
+const assertContentLengthWithinLimit = (response, maxBytes) => {
+    const declared = Number(response.headers?.get('content-length'));
+    if (Number.isFinite(declared) && declared > maxBytes) {
+        throw new Error(`IPFS content too large: ${declared} bytes exceeds limit of ${maxBytes} bytes`);
+    }
+};
+// Join collected byte chunks into a single buffer.
+const concatChunks = (chunks, total) => {
+    const out = new Uint8Array(total);
+    let offset = 0;
+    for (const chunk of chunks) {
+        out.set(chunk, offset);
+        offset += chunk.byteLength;
+    }
+    return out;
+};
+// Read in chunks, abort once total exceeds maxBytes (before full buffering).
+const streamBodyWithLimit = async (body, maxBytes) => {
+    const reader = body.getReader();
+    const chunks = [];
+    let total = 0;
+    try {
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            if (!value)
+                continue;
+            total += value.byteLength;
+            if (total > maxBytes) {
+                await reader.cancel();
+                throw new Error(`IPFS content exceeds size limit of ${maxBytes} bytes`);
+            }
+            chunks.push(value);
+        }
+    }
+    finally {
+        reader.releaseLock?.();
+    }
+    return concatChunks(chunks, total);
+};
+// Streaming is the real limit; Content-Length is just an early reject.
+// Fail closed if there's no body — a real fetch always has one for content.
+const readBodyWithLimit = async (response, maxBytes) => {
+    assertContentLengthWithinLimit(response, maxBytes);
+    if (!response.body) {
+        throw new Error('IPFS response has no readable body');
+    }
+    return streamBodyWithLimit(response.body, maxBytes);
+};
+const fetchFromIPFSGateways = async (cid, gateway) => {
+    const gateways = [
+        ...new Set([gateway, ...Object.values(IPFS_GATEWAYS)].filter(Boolean)),
+    ];
+    for (const currentGateway of gateways) {
+        assertSafeUrl(currentGateway, 'IPFS gateway');
+    }
+    const errors = [];
+    for (const currentGateway of gateways) {
+        const ipfsUrl = `${currentGateway}/${cid}`;
+        logInfo('Fetching content from', ipfsUrl);
+        try {
+            const response = await fetch(ipfsUrl);
+            if (response.ok)
+                return response;
+            errors.push(`${ipfsUrl}: ${response.status} ${response.statusText}`);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            errors.push(`${ipfsUrl}: ${message}`);
+        }
+    }
+    throw new Error(`Failed to fetch IPFS content from all gateways: ${errors.join('; ')}`);
+};
 export const fetchIPFS = async (args, cache = true) => {
-    const { cid, gateway = IPFS_GATEWAY } = args;
+    const { cid, gateway = IPFS_GATEWAY, maxBytes } = args;
     if (cache)
-        return fetchIPFSWithCacheAndVerify(cid, gateway);
-    const { json } = await fetchIPFSDirectAndVerify(cid, gateway);
+        return fetchIPFSWithCacheAndVerify(cid, gateway, maxBytes);
+    const { json } = await fetchIPFSDirectAndVerify(cid, gateway, maxBytes);
     return json;
 };
 // Fetching content by CID through IPFS gateway
 export const fetchIPFSDirect = async (args) => {
-    const { cid, gateway = IPFS_GATEWAY, bigNumberType = 'string' } = args;
-    assertSafeUrl(gateway, 'IPFS gateway');
-    const ipfsUrl = `${gateway}/${cid}`;
-    logInfo('Fetching content from', ipfsUrl);
-    const response = await fetch(ipfsUrl);
-    if (!response.ok) {
-        throw new Error(`Failed to fetch IPFS content: ${response.statusText}`);
-    }
-    const raw = await response.text();
+    const { cid, gateway, bigNumberType = 'string' } = args;
+    const maxBytes = resolveMaxBytes(args.maxBytes);
+    const response = await fetchFromIPFSGateways(cid, gateway);
+    const raw = new TextDecoder().decode(await readBodyWithLimit(response, maxBytes));
     const params = bigNumberType === 'bigint'
         ? { useNativeBigInt: true }
         : { storeAsString: true };
@@ -34,16 +122,10 @@ export const fetchIPFSDirect = async (args) => {
 };
 // Fetching buffer content by CID through IPFS gateway
 export const fetchIPFSBuffer = async (args) => {
-    const { cid, gateway = IPFS_GATEWAY } = args;
-    assertSafeUrl(gateway, 'IPFS gateway');
-    const ipfsUrl = `${gateway}/${cid}`;
-    logInfo('Fetching content from', ipfsUrl);
-    const response = await fetch(ipfsUrl);
-    if (!response.ok) {
-        throw new Error(`Failed to fetch IPFS content: ${response.statusText}`);
-    }
-    const buffer = await response.arrayBuffer();
-    return new Uint8Array(buffer);
+    const { cid, gateway } = args;
+    const maxBytes = resolveMaxBytes(args.maxBytes);
+    const response = await fetchFromIPFSGateways(cid, gateway);
+    return readBodyWithLimit(response, maxBytes);
 };
 // Recalculate CID using full UnixFS logic (like `ipfs add`)
 export const calculateIPFSAddCID = async (fileContent, version = 0) => {
@@ -63,7 +145,7 @@ export const calculateIPFSAddCID = async (fileContent, version = 0) => {
     return lastCid;
 };
 // Downloading file from IPFS and checking its integrity
-export const fetchIPFSDirectAndVerify = async (cid, gateway = IPFS_GATEWAY) => {
+export const fetchIPFSDirectAndVerify = async (cid, gateway = IPFS_GATEWAY, maxBytes) => {
     let originalCID;
     try {
         originalCID = CID.parse(cid);
@@ -71,7 +153,7 @@ export const fetchIPFSDirectAndVerify = async (cid, gateway = IPFS_GATEWAY) => {
     catch {
         throw new Error(`Invalid IPFS CID: ${cid}`);
     }
-    const fileContent = await fetchIPFSBuffer({ cid, gateway });
+    const fileContent = await fetchIPFSBuffer({ cid, gateway, maxBytes });
     const calculatedCID = await calculateIPFSAddCID(fileContent, originalCID.version);
     if (!calculatedCID.equals(originalCID)) {
         throw new Error(`❌ File hash mismatch! Expected ${originalCID}, but got ${calculatedCID}`);
@@ -92,7 +174,7 @@ export const fetchIPFSDirectAndVerify = async (cid, gateway = IPFS_GATEWAY) => {
         json,
     };
 };
-export const fetchIPFSWithCacheAndVerify = async (cid, gateway = IPFS_GATEWAY) => {
+export const fetchIPFSWithCacheAndVerify = async (cid, gateway = IPFS_GATEWAY, maxBytes) => {
     assertSafeUrl(gateway, 'IPFS gateway');
     try {
         CID.parse(cid);
@@ -109,7 +191,7 @@ export const fetchIPFSWithCacheAndVerify = async (cid, gateway = IPFS_GATEWAY) =
     }
     catch {
         // Not in cache, fetch from IPFS
-        const { json } = await fetchIPFSDirectAndVerify(cid, gateway);
+        const { json } = await fetchIPFSDirectAndVerify(cid, gateway, maxBytes);
         await fs.writeFile(cacheFile, JSON.stringify(json), 'utf8');
         return json;
     }

package/dist/utils/ipfs.js.map

@@ -1 +1 @@
-{"version":3,"file":"ipfs.js","sourceRoot":"","sources":["../../utils/ipfs.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ipfs.js","sourceRoot":"","sources":["../../utils/ipfs.ts"],"names":[],"mappings":"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"}

package/dist/utils/parse-abi-arguments.d.ts

@@ -0,0 +1,24 @@
+import type { AbiFunction } from 'viem';
+/**
+ * Parses an array of raw string arguments into typed values
+ * according to the given ABI function definition.
+ *
+ * @param methodAbi - The viem `AbiFunction` describing the target method.
+ * @param args      - Raw string arguments in the same order as `methodAbi.inputs`.
+ * @returns         Typed argument array ready to pass to viem's `encodeFunctionData`.
+ * @throws          If the argument count doesn't match or any value fails to parse.
+ *
+ * @example
+ * ```ts
+ * import { parseAbi } from "viem";
+ * import { parseAbiArguments } from "./parseAbiArguments";
+ *
+ * const [method] = parseAbi(["function transfer(address to, uint256 amount)"]);
+ * const args = parseAbiArguments(method, [
+ *   "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
+ *   "1000000000000000000",
+ * ]);
+ * // => ["0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045", 1000000000000000000n]
+ * ```
+ */
+export declare const parseAbiArguments: (methodAbi: AbiFunction, args: string[]) => unknown[];

package/dist/utils/parse-abi-arguments.js

@@ -0,0 +1,159 @@
+import { isAddress, isHex, size as hexSize } from 'viem';
+/**
+ * Parses a single string value into a typed value based on its Solidity ABI type.
+ * Uses viem's `isAddress` and `isHex` for validation.
+ * Throws a descriptive error if parsing fails.
+ */
+const toArgString = (v) => typeof v === 'string' ? v : JSON.stringify(v);
+const parseAbiArgument = (param, value) => {
+    const { type } = param;
+    try {
+        // --- address ---
+        if (type === 'address') {
+            if (!isAddress(value)) {
+                throw new Error(`Invalid address: "${value}"`);
+            }
+            return value;
+        }
+        // --- bool ---
+        if (type === 'bool') {
+            if (value === 'true')
+                return true;
+            if (value === 'false')
+                return false;
+            throw new Error(`Invalid bool value: "${value}". Expected "true" or "false"`);
+        }
+        // --- uint / int ---
+        if (/^(uint|int)\d*$/.test(type)) {
+            const n = BigInt(value);
+            if (type.startsWith('uint') && n < 0n) {
+                throw new Error(`Unsigned integer cannot be negative: "${value}"`);
+            }
+            return n;
+        }
+        // --- bytes1 … bytes32 (fixed-size) ---
+        const fixedBytesMatch = type.match(/^bytes(\d+)$/);
+        if (fixedBytesMatch) {
+            const expectedSize = Number.parseInt(fixedBytesMatch[1], 10);
+            if (!isHex(value)) {
+                throw new Error(`Invalid hex for ${type}: "${value}"`);
+            }
+            const actualSize = hexSize(value);
+            if (actualSize !== expectedSize) {
+                throw new Error(`Expected ${expectedSize} bytes for ${type}, got ${actualSize}`);
+            }
+            return value;
+        }
+        // --- bytes (dynamic) ---
+        if (type === 'bytes') {
+            if (!isHex(value)) {
+                throw new Error(`Invalid hex for bytes: "${value}"`);
+            }
+            return value;
+        }
+        // --- string ---
+        if (type === 'string') {
+            return value;
+        }
+        // --- fixed-size array, e.g. uint256[3] ---
+        const fixedArrayMatch = type.match(/^(.+)\[(\d+)\]$/);
+        if (fixedArrayMatch) {
+            const innerType = fixedArrayMatch[1];
+            const expectedLength = Number.parseInt(fixedArrayMatch[2], 10);
+            const parsed = JSON.parse(value);
+            if (!Array.isArray(parsed)) {
+                throw new TypeError(`Expected a JSON array for ${type}, got: "${value}"`);
+            }
+            if (parsed.length !== expectedLength) {
+                throw new Error(`Expected array of length ${expectedLength} for ${type}, got length ${parsed.length}`);
+            }
+            return parsed.map((item, i) => parseAbiArgument({ ...param, type: innerType, name: `${param.name}[${i}]` }, toArgString(item)));
+        }
+        // --- dynamic array, e.g. uint256[] ---
+        const dynamicArrayMatch = type.match(/^(.+)\[\]$/);
+        if (dynamicArrayMatch) {
+            const innerType = dynamicArrayMatch[1];
+            const parsed = JSON.parse(value);
+            if (!Array.isArray(parsed)) {
+                throw new TypeError(`Expected a JSON array for ${type}, got: "${value}"`);
+            }
+            return parsed.map((item, i) => parseAbiArgument({ ...param, type: innerType, name: `${param.name}[${i}]` }, toArgString(item)));
+        }
+        // --- tuple (struct) ---
+        if (type === 'tuple') {
+            const tupleParam = param;
+            if (!tupleParam.components || tupleParam.components.length === 0) {
+                throw new Error(`Tuple parameter "${param.name}" has no components defined in ABI`);
+            }
+            let parsed;
+            try {
+                parsed = JSON.parse(value);
+            }
+            catch {
+                throw new Error(`Invalid JSON for tuple "${param.name}": "${value}"`);
+            }
+            // Accept array representation
+            if (Array.isArray(parsed)) {
+                if (parsed.length !== tupleParam.components.length) {
+                    throw new Error(`Tuple "${param.name}" expects ${tupleParam.components.length} fields, got ${parsed.length}`);
+                }
+                return tupleParam.components.reduce((acc, comp, i) => {
+                    acc[comp.name ?? i] = parseAbiArgument(comp, toArgString(parsed[i]));
+                    return acc;
+                }, {});
+            }
+            // Accept object representation
+            if (typeof parsed === 'object' && parsed !== null) {
+                return tupleParam.components.reduce((acc, comp) => {
+                    const key = comp.name;
+                    if (!key) {
+                        throw new Error(`Tuple component has no name`);
+                    }
+                    if (!(key in parsed)) {
+                        throw new Error(`Missing field "${key}" in tuple "${param.name}"`);
+                    }
+                    acc[key] = parseAbiArgument(comp, toArgString(parsed[key]));
+                    return acc;
+                }, {});
+            }
+            throw new Error(`Invalid value for tuple "${param.name}": expected JSON object or array`);
+        }
+        throw new Error(`Unsupported ABI type: "${type}"`);
+    }
+    catch (err) {
+        if (err instanceof Error && !err.message.startsWith(`[param:`)) {
+            throw new Error(`[param: "${param.name ?? '<unnamed>'}", type: "${type}"] ${err.message}`);
+        }
+        throw err;
+    }
+};
+/**
+ * Parses an array of raw string arguments into typed values
+ * according to the given ABI function definition.
+ *
+ * @param methodAbi - The viem `AbiFunction` describing the target method.
+ * @param args      - Raw string arguments in the same order as `methodAbi.inputs`.
+ * @returns         Typed argument array ready to pass to viem's `encodeFunctionData`.
+ * @throws          If the argument count doesn't match or any value fails to parse.
+ *
+ * @example
+ * ```ts
+ * import { parseAbi } from "viem";
+ * import { parseAbiArguments } from "./parseAbiArguments";
+ *
+ * const [method] = parseAbi(["function transfer(address to, uint256 amount)"]);
+ * const args = parseAbiArguments(method, [
+ *   "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
+ *   "1000000000000000000",
+ * ]);
+ * // => ["0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045", 1000000000000000000n]
+ * ```
+ */
+export const parseAbiArguments = (methodAbi, args) => {
+    const { inputs } = methodAbi;
+    if (args.length !== inputs.length) {
+        throw new Error(`Argument count mismatch for "${methodAbi.name}": expected ${inputs.length}, got ${args.length}`);
+    }
+    return inputs.map((input, i) => parseAbiArgument(input, args[i]));
+};
+//# sourceMappingURL=parse-abi-arguments.js.map

package/dist/utils/parse-abi-arguments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-abi-arguments.js","sourceRoot":"","sources":["../../utils/parse-abi-arguments.ts"],"names":[],"mappings":"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"}

package/dist/utils/proof/constants.d.ts

@@ -3,4 +3,5 @@ export declare const SupportedFork: {
     deneb: string;
     electra: string;
     fulu: string;
+    gloas: string;
 };

package/dist/utils/proof/constants.js

@@ -3,5 +3,6 @@ export const SupportedFork = {
     deneb: 'deneb',
     electra: 'electra',
     fulu: 'fulu',
+    gloas: 'gloas',
 };
 //# sourceMappingURL=constants.js.map

package/dist/utils/proof/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../utils/proof/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,OAAO,EAAE,SAAS;IAClB,KAAK,EAAE,OAAO;IACd,OAAO,EAAE,SAAS;IAClB,IAAI,EAAE,MAAM;CACb,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../utils/proof/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,OAAO,EAAE,SAAS;IAClB,KAAK,EAAE,OAAO;IACd,OAAO,EAAE,SAAS;IAClB,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,OAAO;CACf,CAAC"}

package/dist/utils/proof/first-validator-gindex.js

@@ -1,25 +1,39 @@
 import { ssz } from '@lodestar/types';
+import { ListCompositeType, ProgressiveListCompositeType, } from '@chainsafe/ssz';
 import { logResult } from '../index.js';
+// Verifier constructor arg each gindex feeds, see CLProofVerifier.sol
+const PRE_GLOAS_PARAM = 'gIFirstValidatorPreGloas';
+const GLOAS_PARAM = 'gIValidators';
 export const getFirstValidatorGIndex = (forks) => {
-    const gIndexes = {};
-    for (const fork of forks) {
+    const rows = forks.map((fork) => {
         const Fork = ssz[fork];
-        const Validators = Fork.BeaconState.getPathInfo(['validators']).type;
-        const gI = pack(Fork.BeaconState.getPathInfo(['validators', 0]).gindex, 
-        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
-        // @ts-ignore
-        Validators.limit);
-        gIndexes[fork] = toBytes32String(gI);
-    }
+        if (!Fork)
+            throw new Error(`Fork name [${fork}] is not supported`);
+        const validators = Fork.BeaconState.getPathInfo(['validators']);
+        // Gloas: the list is progressive, so it has no fixed depth to pack. The
+        // verifier takes the validators field itself and derives each node.
+        if (validators.type instanceof ProgressiveListCompositeType) {
+            return [fork, toBytes32String(pack(validators.gindex, 0n)), GLOAS_PARAM];
+        }
+        if (!(validators.type instanceof ListCompositeType)) {
+            throw new TypeError(`Unexpected validators type for fork [${fork}]`);
+        }
+        const gI = Fork.BeaconState.getPathInfo(['validators', 0]).gindex;
+        return [
+            fork,
+            toBytes32String(pack(gI, widthOf(validators.type.limit))),
+            PRE_GLOAS_PARAM,
+        ];
+    });
     logResult({
-        data: Object.entries(gIndexes).map(([fork, gIndex]) => [fork, gIndex]),
+        data: rows,
         params: {
-            head: ['Fork', 'GIndex'],
+            head: ['Fork', 'GIndex', 'Deploy param'],
         },
     });
 };
-const pack = (gI, limit) => {
-    const width = limit ? BigInt(Math.log2(limit)) : 0n;
+const widthOf = (limit) => (limit ? BigInt(Math.log2(limit)) : 0n);
+const pack = (gI, width) => {
     return (gI << 8n) | width;
 };
 const toBytes32String = (gI) => {

package/dist/utils/proof/first-validator-gindex.js.map

@@ -1 +1 @@
-{"version":3,"file":"first-validator-gindex.js","sourceRoot":"","sources":["../../../utils/proof/first-validator-gindex.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAEtC,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIlC,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,KAAe,EAAE,EAAE;IACzD,MAAM,QAAQ,GAA2B,EAAE,CAAC;IAC5C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,GAAG,CAAC,IAAkC,CAAC,CAAC;QACrD,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC;QAErE,MAAM,EAAE,GAAG,IAAI,CACb,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM;QACtD,6DAA6D;QAC7D,aAAa;QACb,UAAU,CAAC,KAAK,CACjB,CAAC;QACF,QAAQ,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,EAAE,CAAC,CAAC;IACvC,CAAC;IACD,SAAS,CAAC;QACR,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACtE,MAAM,EAAE;YACN,IAAI,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC;SACzB;KACF,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,IAAI,GAAG,CAAC,EAAU,EAAE,KAAa,EAAE,EAAE;IACzC,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACpD,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,KAAK,CAAC;AAC5B,CAAC,CAAC;AAEF,MAAM,eAAe,GAAG,CAAC,EAAU,EAAE,EAAE;IACrC,OAAO,KAAK,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,CAAC;AAClD,CAAC,CAAC"}
+{"version":3,"file":"first-validator-gindex.js","sourceRoot":"","sources":["../../../utils/proof/first-validator-gindex.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AACtC,OAAO,EACL,iBAAiB,EACjB,4BAA4B,GAC7B,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIlC,sEAAsE;AACtE,MAAM,eAAe,GAAG,0BAA0B,CAAC;AACnD,MAAM,WAAW,GAAG,cAAc,CAAC;AAEnC,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,KAAe,EAAE,EAAE;IACzD,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QAC9B,MAAM,IAAI,GAAG,GAAG,CAAC,IAAkC,CAAC,CAAC;QACrD,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,cAAc,IAAI,oBAAoB,CAAC,CAAC;QAEnE,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC;QAEhE,wEAAwE;QACxE,oEAAoE;QACpE,IAAI,UAAU,CAAC,IAAI,YAAY,4BAA4B,EAAE,CAAC;YAC5D,OAAO,CAAC,IAAI,EAAE,eAAe,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;QAC3E,CAAC;QAED,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,YAAY,iBAAiB,CAAC,EAAE,CAAC;YACpD,MAAM,IAAI,SAAS,CAAC,wCAAwC,IAAI,GAAG,CAAC,CAAC;QACvE,CAAC;QAED,MAAM,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QAClE,OAAO;YACL,IAAI;YACJ,eAAe,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;YACzD,eAAe;SAChB,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC;QACR,IAAI,EAAE,IAAI;QACV,MAAM,EAAE;YACN,IAAI,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,cAAc,CAAC;SACzC;KACF,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,OAAO,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAE3E,MAAM,IAAI,GAAG,CAAC,EAAU,EAAE,KAAa,EAAE,EAAE;IACzC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,KAAK,CAAC;AAC5B,CAAC,CAAC;AAEF,MAAM,eAAe,GAAG,CAAC,EAAU,EAAE,EAAE;IACrC,OAAO,KAAK,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,CAAC;AAClD,CAAC,CAAC"}

package/dist/utils/proof/proofs.d.ts

@@ -6,7 +6,7 @@ import { SupportedFork } from './constants.js';
 export type SupportedStateView = {
     [K in keyof typeof SupportedFork]: ContainerTreeViewType<(typeof ssz)[K]['BeaconState']['fields']>;
 }[keyof typeof SupportedFork];
-type Validator = ReturnType<SupportedStateView['validators']['getReadonly']>;
+type Validator = ReturnType<SupportedStateView['validators']['get']>;
 export type BeaconHeaderResponse = {
     slot: number;
     proposer_index: number;