@ar.io/sdk 3.9.0-alpha.4 → 3.9.0-alpha.6

package/lib/cjs/common/contracts/ao-process.js

@@ -68,13 +68,14 @@ class AOProcess {
                     processId: this.processId,
                 });
                 if (attempts >= retries) {
-                    this.logger.error(`Maximum read attempts exceeded`, {
+                    this.logger.debug(`Maximum read attempts exceeded`, {
                         error: error?.message,
                         stack: error?.stack,
                         tags,
                         processId: this.processId,
+                        ao: JSON.stringify(this.ao),
                     });
-                    throw new Error(`Maximum read attempts exceeded for process ${this.processId}`);
+                    throw new Error(`Failed to evaluate a dry-run on process ${this.processId}.`);
                 }
                 // exponential backoff
                 await new Promise((resolve) => setTimeout(resolve, 2 ** attempts * 1000));
@@ -92,7 +93,7 @@ class AOProcess {
             throw new Error(error);
         }
         if (result.Messages === undefined || result.Messages.length === 0) {
-            this.logger.debug(`Process ${this.processId} does not support provided action.`, {
+            this.logger.debug(`Empty result - process ${this.processId} does not support provided action.`, {
                 result,
                 tags,
                 processId: this.processId,
@@ -108,32 +109,50 @@ class AOProcess {
         return response;
     }
     async send({ tags, data, signer, retries = 3, }) {
-        // main purpose of retries is to handle network errors/new process delays
-        let attempts = 0;
         let messageId;
+        const anchor = (0, base64_js_1.getRandomText)(32); // anchor is a random text produce non-deterministic messages IDs when deterministic signers are provided (ETH)
+        try {
+            this.logger.debug(`Evaluating send interaction on contract`, {
+                tags,
+                data,
+                processId: this.processId,
+            });
+            /**
+             * DO NOT retry messaging if a message was already sent.
+             * This could result in a double entry-like condition when sending tokens for example.
+             * If the message fails to send we will throw an error and the caller can retry.
+             */
+            messageId = await this.ao.message({
+                process: this.processId,
+                tags: [...tags, { name: 'AR-IO-SDK', value: version_js_1.version }],
+                data,
+                signer,
+                anchor,
+            });
+            this.logger.debug(`Sent message to process`, {
+                messageId,
+                processId: this.processId,
+                anchor,
+            });
+        }
+        catch (error) {
+            this.logger.debug('Error sending message to process', {
+                error: error?.message,
+                stack: error?.stack,
+                processId: this.processId,
+                tags,
+            });
+            // throw the error so it can be handled by the caller
+            throw error;
+        }
+        if (messageId === undefined) {
+            throw new Error('Failed to send message to process.');
+        }
+        // get the result of the message before returning, using retries to handle network errors/new process delays
         let result = undefined;
-        // anchor is a random text produce non-deterministic messages IDs when deterministic signers are provided (ETH)
-        const anchor = (0, base64_js_1.getRandomText)(32);
+        let attempts = 0;
         while (attempts < retries) {
             try {
-                this.logger.debug(`Evaluating send interaction on contract`, {
-                    tags,
-                    data,
-                    processId: this.processId,
-                });
-                // MUST NOT retry messaging if a message was already sent. This could result in a double entry-like condition when sending tokens for example.
-                messageId ??= await this.ao.message({
-                    process: this.processId,
-                    tags: [...tags, { name: 'AR-IO-SDK', value: version_js_1.version }],
-                    data,
-                    signer,
-                    anchor,
-                });
-                this.logger.debug(`Sent message to process`, {
-                    messageId,
-                    processId: this.processId,
-                    anchor,
-                });
                 result = await this.ao.result({
                     message: messageId,
                     process: this.processId,
@@ -146,12 +165,6 @@ class AOProcess {
                 break;
             }
             catch (error) {
-                this.logger.error('Error sending message to process', {
-                    error: error?.message,
-                    stack: error?.stack,
-                    processId: this.processId,
-                    tags,
-                });
                 attempts++;
                 this.logger.debug('Retrying send interaction', {
                     attempts,
@@ -160,20 +173,26 @@ class AOProcess {
                     processId: this.processId,
                 });
                 if (attempts >= retries) {
-                    this.logger.error(`Maximum read result attempts exceeded`, {
+                    this.logger.debug(`Message was sent to process ${this.processId} with id ${messageId} but result was not returned. Review transactions for more details.`, {
                         error: error?.message,
                         stack: error?.stack,
                         tags,
                         processId: this.processId,
+                        messageId,
                     });
-                    throw new Error(`Maximum read result attempts exceeded for process ${this.processId}.`);
+                    return { id: messageId };
                 }
                 // exponential backoff
                 await new Promise((resolve) => setTimeout(resolve, 2 ** attempts * 2000));
             }
         }
-        if (result === undefined || messageId === undefined) {
-            throw new Error('Unexpected error when evaluating write interaction');
+        if (result === undefined) {
+            this.logger.debug(`Message was sent to process ${this.processId} with id ${messageId} but the result was not returned. Review transactions for more details.`, {
+                tags,
+                processId: this.processId,
+                messageId,
+            });
+            return { id: messageId };
         }
         const error = (0, index_js_1.errorMessageFromOutput)(result);
         if (error !== undefined) {
@@ -183,9 +202,6 @@ class AOProcess {
         if (result.Messages?.length === 0 || result.Messages === undefined) {
             return { id: messageId };
         }
-        if (result.Messages.length === 0) {
-            throw new Error(`Process ${this.processId} does not support provided action.`);
-        }
         if (this.isMessageDataEmpty(result.Messages[0].Data)) {
             return { id: messageId };
         }

package/lib/cjs/common/io.js

@@ -84,10 +84,11 @@ class ARIOReadable {
         const epochIndex = await this.computeEpochIndex(epoch);
         const currentIndex = await this.computeCurrentEpochIndex();
         if (epochIndex !== undefined && epochIndex < currentIndex) {
-            const epochData = await (0, arweave_js_1.getEpochDataFromGql)({
+            const epochData = await (0, arweave_js_1.getEpochDataFromGqlWithCUFallback)({
                 arweave: this.arweave,
                 epochIndex: epochIndex,
                 processId: this.process.processId,
+                ao: this.process.ao,
             });
             return (0, arweave_js_1.removeEligibleRewardsFromEpochData)(epochData);
         }
@@ -211,7 +212,8 @@ class ARIOReadable {
         const epochIndex = await this.computeEpochIndex(epoch);
         const currentIndex = await this.computeCurrentEpochIndex();
         if (epochIndex !== undefined && epochIndex < currentIndex) {
-            const epochData = await (0, arweave_js_1.getEpochDataFromGql)({
+            const epochData = await (0, arweave_js_1.getEpochDataFromGqlWithCUFallback)({
+                ao: this.process.ao,
                 arweave: this.arweave,
                 epochIndex: epochIndex,
                 processId: this.process.processId,
@@ -233,10 +235,11 @@ class ARIOReadable {
         const epochIndex = await this.computeEpochIndex(epoch);
         const currentIndex = await this.computeCurrentEpochIndex();
         if (epochIndex !== undefined && epochIndex < currentIndex) {
-            const epochData = await (0, arweave_js_1.getEpochDataFromGql)({
+            const epochData = await (0, arweave_js_1.getEpochDataFromGqlWithCUFallback)({
                 arweave: this.arweave,
                 epochIndex: epochIndex,
                 processId: this.process.processId,
+                ao: this.process.ao,
             });
             return epochData?.prescribedNames;
         }
@@ -256,10 +259,11 @@ class ARIOReadable {
         const epochIndex = await this.computeEpochIndex(epoch);
         const currentIndex = await this.computeCurrentEpochIndex();
         if (epochIndex !== undefined && epochIndex < currentIndex) {
-            const epochData = await (0, arweave_js_1.getEpochDataFromGql)({
+            const epochData = await (0, arweave_js_1.getEpochDataFromGqlWithCUFallback)({
                 arweave: this.arweave,
                 epochIndex: epochIndex,
                 processId: this.process.processId,
+                ao: this.process.ao,
             });
             return epochData?.observations;
         }
@@ -279,10 +283,11 @@ class ARIOReadable {
         const epochIndex = await this.computeEpochIndex(epoch);
         const currentIndex = await this.computeCurrentEpochIndex();
         if (epochIndex !== undefined && epochIndex < currentIndex) {
-            const epochData = await (0, arweave_js_1.getEpochDataFromGql)({
+            const epochData = await (0, arweave_js_1.getEpochDataFromGqlWithCUFallback)({
                 arweave: this.arweave,
                 epochIndex: epochIndex,
                 processId: this.process.processId,
+                ao: this.process.ao,
             });
             return epochData?.distributions;
         }
@@ -302,10 +307,11 @@ class ARIOReadable {
         const epochIndex = await this.computeEpochIndex(epoch);
         const currentIndex = await this.computeCurrentEpochIndex();
         if (epochIndex !== undefined && epochIndex < currentIndex) {
-            const epochData = await (0, arweave_js_1.getEpochDataFromGql)({
+            const epochData = await (0, arweave_js_1.getEpochDataFromGqlWithCUFallback)({
                 arweave: this.arweave,
                 epochIndex: epochIndex,
                 processId: this.process.processId,
+                ao: this.process.ao,
             });
             return (0, arweave_js_1.sortAndPaginateEpochDataIntoEligibleDistributions)(epochData, params);
         }

package/lib/cjs/utils/arweave.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.removeEligibleRewardsFromEpochData = exports.sortAndPaginateEpochDataIntoEligibleDistributions = exports.epochDistributionNoticeGqlQuery = exports.getEpochDataFromGql = exports.paginationParamsToTags = exports.pruneTags = exports.isBlockHeight = exports.validateArweaveId = void 0;
+exports.removeEligibleRewardsFromEpochData = exports.sortAndPaginateEpochDataIntoEligibleDistributions = exports.epochDistributionNoticeGqlQueryFallback = exports.epochDistributionNoticeGqlQuery = exports.getEpochDataFromGqlFallback = exports.getEpochDataFromGqlWithCUFallback = exports.getEpochDataFromGql = exports.paginationParamsToTags = exports.pruneTags = exports.isBlockHeight = exports.validateArweaveId = void 0;
 const constants_js_1 = require("../constants.js");
 const io_js_1 = require("../types/io.js");
 const ao_js_1 = require("./ao.js");
@@ -69,6 +69,66 @@ const getEpochDataFromGql = async ({ arweave, epochIndex, processId = constants_
     return undefined;
 };
 exports.getEpochDataFromGql = getEpochDataFromGql;
+const getEpochDataFromGqlWithCUFallback = async ({ arweave, ao, epochIndex, processId = constants_js_1.ARIO_MAINNET_PROCESS_ID, }) => {
+    const gqlResult = await (0, exports.getEpochDataFromGql)({
+        arweave,
+        epochIndex,
+        processId,
+    });
+    if (gqlResult) {
+        return gqlResult;
+    }
+    const gqlFallbackResult = await (0, exports.getEpochDataFromGqlFallback)({
+        ao,
+        epochIndex,
+        processId,
+    });
+    if (gqlFallbackResult) {
+        return gqlFallbackResult;
+    }
+    return undefined;
+};
+exports.getEpochDataFromGqlWithCUFallback = getEpochDataFromGqlWithCUFallback;
+const getEpochDataFromGqlFallback = async ({ ao, epochIndex, processId = constants_js_1.ARIO_MAINNET_PROCESS_ID, gqlUrl = 'https://arweave-search.goldsky.com/graphql', }) => {
+    const query = (0, exports.epochDistributionNoticeGqlQueryFallback)({
+        epochIndex,
+        processId,
+    });
+    const response = await fetch(gqlUrl, {
+        method: 'POST',
+        body: query,
+        headers: {
+            'Content-Type': 'application/json',
+        },
+    });
+    const responseJson = (await response.json());
+    if (responseJson.data.transactions.edges.length === 0) {
+        return undefined;
+    }
+    for (const edge of responseJson.data.transactions.edges) {
+        const id = edge.node.id;
+        const messageResult = await ao
+            .result({
+            message: id,
+            process: processId,
+        })
+            .catch(() => undefined);
+        if (!messageResult) {
+            continue;
+        }
+        for (const message of messageResult.Messages) {
+            const data = JSON.parse(message.Data);
+            const tags = message.Tags;
+            // check if the message results include epoch-distribution-notice for the requested epoch index
+            if (tags.some((tag) => tag.name === 'Action' && tag.value === 'Epoch-Distribution-Notice') &&
+                tags.some((tag) => tag.name === 'Epoch-Index' && tag.value === epochIndex.toString())) {
+                return (0, ao_js_1.parseAoEpochData)(data);
+            }
+        }
+    }
+    return undefined;
+};
+exports.getEpochDataFromGqlFallback = getEpochDataFromGqlFallback;
 /**
  * Get the epoch with distribution data for the current epoch
  * @param arweave - The Arweave instance
@@ -104,6 +164,32 @@ const epochDistributionNoticeGqlQuery = ({ epochIndex, processId = constants_js_
     return gqlQuery;
 };
 exports.epochDistributionNoticeGqlQuery = epochDistributionNoticeGqlQuery;
+// fallback query if the distribution notice does not get cranked
+const epochDistributionNoticeGqlQueryFallback = ({ processId = constants_js_1.ARIO_MAINNET_PROCESS_ID, owners = ['OAb-n-ZugyN598kZNpfOy0ACelGVmwCQ0kYbgNGDUK8'], // ar.io team wallet ticks once a day
+ }) => {
+    return JSON.stringify({
+        query: `
+      query {
+        transactions(
+          tags: [
+            { name: "Action", values: ["Tick"] }
+          ],
+          first: 100,
+          owners: [${owners.map((a) => `"${a}"`).join(',')}],
+          recipients: ["${processId}"],
+          sort: HEIGHT_DESC
+        ) {
+          edges {
+            node {
+              id  
+            }
+          }
+        }
+      }
+    `,
+    });
+};
+exports.epochDistributionNoticeGqlQueryFallback = epochDistributionNoticeGqlQueryFallback;
 function sortAndPaginateEpochDataIntoEligibleDistributions(epochData, params) {
     const rewards = [];
     const sortBy = params?.sortBy ?? 'eligibleReward';

package/lib/cjs/version.js

@@ -17,4 +17,4 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.version = void 0;
 // AUTOMATICALLY GENERATED FILE - DO NOT TOUCH
-exports.version = '3.9.0-alpha.4';
+exports.version = '3.9.0-alpha.6';

package/lib/esm/common/contracts/ao-process.js

@@ -65,13 +65,14 @@ export class AOProcess {
                     processId: this.processId,
                 });
                 if (attempts >= retries) {
-                    this.logger.error(`Maximum read attempts exceeded`, {
+                    this.logger.debug(`Maximum read attempts exceeded`, {
                         error: error?.message,
                         stack: error?.stack,
                         tags,
                         processId: this.processId,
+                        ao: JSON.stringify(this.ao),
                     });
-                    throw new Error(`Maximum read attempts exceeded for process ${this.processId}`);
+                    throw new Error(`Failed to evaluate a dry-run on process ${this.processId}.`);
                 }
                 // exponential backoff
                 await new Promise((resolve) => setTimeout(resolve, 2 ** attempts * 1000));
@@ -89,7 +90,7 @@ export class AOProcess {
             throw new Error(error);
         }
         if (result.Messages === undefined || result.Messages.length === 0) {
-            this.logger.debug(`Process ${this.processId} does not support provided action.`, {
+            this.logger.debug(`Empty result - process ${this.processId} does not support provided action.`, {
                 result,
                 tags,
                 processId: this.processId,
@@ -105,32 +106,50 @@ export class AOProcess {
         return response;
     }
     async send({ tags, data, signer, retries = 3, }) {
-        // main purpose of retries is to handle network errors/new process delays
-        let attempts = 0;
         let messageId;
+        const anchor = getRandomText(32); // anchor is a random text produce non-deterministic messages IDs when deterministic signers are provided (ETH)
+        try {
+            this.logger.debug(`Evaluating send interaction on contract`, {
+                tags,
+                data,
+                processId: this.processId,
+            });
+            /**
+             * DO NOT retry messaging if a message was already sent.
+             * This could result in a double entry-like condition when sending tokens for example.
+             * If the message fails to send we will throw an error and the caller can retry.
+             */
+            messageId = await this.ao.message({
+                process: this.processId,
+                tags: [...tags, { name: 'AR-IO-SDK', value: version }],
+                data,
+                signer,
+                anchor,
+            });
+            this.logger.debug(`Sent message to process`, {
+                messageId,
+                processId: this.processId,
+                anchor,
+            });
+        }
+        catch (error) {
+            this.logger.debug('Error sending message to process', {
+                error: error?.message,
+                stack: error?.stack,
+                processId: this.processId,
+                tags,
+            });
+            // throw the error so it can be handled by the caller
+            throw error;
+        }
+        if (messageId === undefined) {
+            throw new Error('Failed to send message to process.');
+        }
+        // get the result of the message before returning, using retries to handle network errors/new process delays
         let result = undefined;
-        // anchor is a random text produce non-deterministic messages IDs when deterministic signers are provided (ETH)
-        const anchor = getRandomText(32);
+        let attempts = 0;
         while (attempts < retries) {
             try {
-                this.logger.debug(`Evaluating send interaction on contract`, {
-                    tags,
-                    data,
-                    processId: this.processId,
-                });
-                // MUST NOT retry messaging if a message was already sent. This could result in a double entry-like condition when sending tokens for example.
-                messageId ??= await this.ao.message({
-                    process: this.processId,
-                    tags: [...tags, { name: 'AR-IO-SDK', value: version }],
-                    data,
-                    signer,
-                    anchor,
-                });
-                this.logger.debug(`Sent message to process`, {
-                    messageId,
-                    processId: this.processId,
-                    anchor,
-                });
                 result = await this.ao.result({
                     message: messageId,
                     process: this.processId,
@@ -143,12 +162,6 @@ export class AOProcess {
                 break;
             }
             catch (error) {
-                this.logger.error('Error sending message to process', {
-                    error: error?.message,
-                    stack: error?.stack,
-                    processId: this.processId,
-                    tags,
-                });
                 attempts++;
                 this.logger.debug('Retrying send interaction', {
                     attempts,
@@ -157,20 +170,26 @@ export class AOProcess {
                     processId: this.processId,
                 });
                 if (attempts >= retries) {
-                    this.logger.error(`Maximum read result attempts exceeded`, {
+                    this.logger.debug(`Message was sent to process ${this.processId} with id ${messageId} but result was not returned. Review transactions for more details.`, {
                         error: error?.message,
                         stack: error?.stack,
                         tags,
                         processId: this.processId,
+                        messageId,
                     });
-                    throw new Error(`Maximum read result attempts exceeded for process ${this.processId}.`);
+                    return { id: messageId };
                 }
                 // exponential backoff
                 await new Promise((resolve) => setTimeout(resolve, 2 ** attempts * 2000));
             }
         }
-        if (result === undefined || messageId === undefined) {
-            throw new Error('Unexpected error when evaluating write interaction');
+        if (result === undefined) {
+            this.logger.debug(`Message was sent to process ${this.processId} with id ${messageId} but the result was not returned. Review transactions for more details.`, {
+                tags,
+                processId: this.processId,
+                messageId,
+            });
+            return { id: messageId };
         }
         const error = errorMessageFromOutput(result);
         if (error !== undefined) {
@@ -180,9 +199,6 @@ export class AOProcess {
         if (result.Messages?.length === 0 || result.Messages === undefined) {
             return { id: messageId };
         }
-        if (result.Messages.length === 0) {
-            throw new Error(`Process ${this.processId} does not support provided action.`);
-        }
         if (this.isMessageDataEmpty(result.Messages[0].Data)) {
             return { id: messageId };
         }

package/lib/esm/common/io.js

@@ -1,7 +1,7 @@
 import { ARIO_MAINNET_PROCESS_ID } from '../constants.js';
 import { isProcessConfiguration, isProcessIdConfiguration, } from '../types/io.js';
 import { createAoSigner } from '../utils/ao.js';
-import { getEpochDataFromGql, paginationParamsToTags, pruneTags, removeEligibleRewardsFromEpochData, sortAndPaginateEpochDataIntoEligibleDistributions, } from '../utils/arweave.js';
+import { getEpochDataFromGqlWithCUFallback, paginationParamsToTags, pruneTags, removeEligibleRewardsFromEpochData, sortAndPaginateEpochDataIntoEligibleDistributions, } from '../utils/arweave.js';
 import { defaultArweave } from './arweave.js';
 import { AOProcess } from './contracts/ao-process.js';
 import { InvalidContractConfigurationError } from './error.js';
@@ -80,10 +80,11 @@ export class ARIOReadable {
         const epochIndex = await this.computeEpochIndex(epoch);
         const currentIndex = await this.computeCurrentEpochIndex();
         if (epochIndex !== undefined && epochIndex < currentIndex) {
-            const epochData = await getEpochDataFromGql({
+            const epochData = await getEpochDataFromGqlWithCUFallback({
                 arweave: this.arweave,
                 epochIndex: epochIndex,
                 processId: this.process.processId,
+                ao: this.process.ao,
             });
             return removeEligibleRewardsFromEpochData(epochData);
         }
@@ -207,7 +208,8 @@ export class ARIOReadable {
         const epochIndex = await this.computeEpochIndex(epoch);
         const currentIndex = await this.computeCurrentEpochIndex();
         if (epochIndex !== undefined && epochIndex < currentIndex) {
-            const epochData = await getEpochDataFromGql({
+            const epochData = await getEpochDataFromGqlWithCUFallback({
+                ao: this.process.ao,
                 arweave: this.arweave,
                 epochIndex: epochIndex,
                 processId: this.process.processId,
@@ -229,10 +231,11 @@ export class ARIOReadable {
         const epochIndex = await this.computeEpochIndex(epoch);
         const currentIndex = await this.computeCurrentEpochIndex();
         if (epochIndex !== undefined && epochIndex < currentIndex) {
-            const epochData = await getEpochDataFromGql({
+            const epochData = await getEpochDataFromGqlWithCUFallback({
                 arweave: this.arweave,
                 epochIndex: epochIndex,
                 processId: this.process.processId,
+                ao: this.process.ao,
             });
             return epochData?.prescribedNames;
         }
@@ -252,10 +255,11 @@ export class ARIOReadable {
         const epochIndex = await this.computeEpochIndex(epoch);
         const currentIndex = await this.computeCurrentEpochIndex();
         if (epochIndex !== undefined && epochIndex < currentIndex) {
-            const epochData = await getEpochDataFromGql({
+            const epochData = await getEpochDataFromGqlWithCUFallback({
                 arweave: this.arweave,
                 epochIndex: epochIndex,
                 processId: this.process.processId,
+                ao: this.process.ao,
             });
             return epochData?.observations;
         }
@@ -275,10 +279,11 @@ export class ARIOReadable {
         const epochIndex = await this.computeEpochIndex(epoch);
         const currentIndex = await this.computeCurrentEpochIndex();
         if (epochIndex !== undefined && epochIndex < currentIndex) {
-            const epochData = await getEpochDataFromGql({
+            const epochData = await getEpochDataFromGqlWithCUFallback({
                 arweave: this.arweave,
                 epochIndex: epochIndex,
                 processId: this.process.processId,
+                ao: this.process.ao,
             });
             return epochData?.distributions;
         }
@@ -298,10 +303,11 @@ export class ARIOReadable {
         const epochIndex = await this.computeEpochIndex(epoch);
         const currentIndex = await this.computeCurrentEpochIndex();
         if (epochIndex !== undefined && epochIndex < currentIndex) {
-            const epochData = await getEpochDataFromGql({
+            const epochData = await getEpochDataFromGqlWithCUFallback({
                 arweave: this.arweave,
                 epochIndex: epochIndex,
                 processId: this.process.processId,
+                ao: this.process.ao,
             });
             return sortAndPaginateEpochDataIntoEligibleDistributions(epochData, params);
         }

package/lib/esm/utils/arweave.js

@@ -61,6 +61,64 @@ export const getEpochDataFromGql = async ({ arweave, epochIndex, processId = ARI
     }
     return undefined;
 };
+export const getEpochDataFromGqlWithCUFallback = async ({ arweave, ao, epochIndex, processId = ARIO_MAINNET_PROCESS_ID, }) => {
+    const gqlResult = await getEpochDataFromGql({
+        arweave,
+        epochIndex,
+        processId,
+    });
+    if (gqlResult) {
+        return gqlResult;
+    }
+    const gqlFallbackResult = await getEpochDataFromGqlFallback({
+        ao,
+        epochIndex,
+        processId,
+    });
+    if (gqlFallbackResult) {
+        return gqlFallbackResult;
+    }
+    return undefined;
+};
+export const getEpochDataFromGqlFallback = async ({ ao, epochIndex, processId = ARIO_MAINNET_PROCESS_ID, gqlUrl = 'https://arweave-search.goldsky.com/graphql', }) => {
+    const query = epochDistributionNoticeGqlQueryFallback({
+        epochIndex,
+        processId,
+    });
+    const response = await fetch(gqlUrl, {
+        method: 'POST',
+        body: query,
+        headers: {
+            'Content-Type': 'application/json',
+        },
+    });
+    const responseJson = (await response.json());
+    if (responseJson.data.transactions.edges.length === 0) {
+        return undefined;
+    }
+    for (const edge of responseJson.data.transactions.edges) {
+        const id = edge.node.id;
+        const messageResult = await ao
+            .result({
+            message: id,
+            process: processId,
+        })
+            .catch(() => undefined);
+        if (!messageResult) {
+            continue;
+        }
+        for (const message of messageResult.Messages) {
+            const data = JSON.parse(message.Data);
+            const tags = message.Tags;
+            // check if the message results include epoch-distribution-notice for the requested epoch index
+            if (tags.some((tag) => tag.name === 'Action' && tag.value === 'Epoch-Distribution-Notice') &&
+                tags.some((tag) => tag.name === 'Epoch-Index' && tag.value === epochIndex.toString())) {
+                return parseAoEpochData(data);
+            }
+        }
+    }
+    return undefined;
+};
 /**
  * Get the epoch with distribution data for the current epoch
  * @param arweave - The Arweave instance
@@ -95,6 +153,31 @@ export const epochDistributionNoticeGqlQuery = ({ epochIndex, processId = ARIO_M
     });
     return gqlQuery;
 };
+// fallback query if the distribution notice does not get cranked
+export const epochDistributionNoticeGqlQueryFallback = ({ processId = ARIO_MAINNET_PROCESS_ID, owners = ['OAb-n-ZugyN598kZNpfOy0ACelGVmwCQ0kYbgNGDUK8'], // ar.io team wallet ticks once a day
+ }) => {
+    return JSON.stringify({
+        query: `
+      query {
+        transactions(
+          tags: [
+            { name: "Action", values: ["Tick"] }
+          ],
+          first: 100,
+          owners: [${owners.map((a) => `"${a}"`).join(',')}],
+          recipients: ["${processId}"],
+          sort: HEIGHT_DESC
+        ) {
+          edges {
+            node {
+              id  
+            }
+          }
+        }
+      }
+    `,
+    });
+};
 export function sortAndPaginateEpochDataIntoEligibleDistributions(epochData, params) {
     const rewards = [];
     const sortBy = params?.sortBy ?? 'eligibleReward';