@ar.io/sdk 3.3.0-alpha.12 → 3.3.0-alpha.14

package/lib/cjs/cli/cli.js

@@ -258,6 +258,12 @@ const utils_js_1 = require("./utils.js");
     options: options_js_1.paginationAddressOptions,
     action: readCommands_js_1.getGatewayVaults,
 });
+(0, utils_js_1.makeCommand)({
+    name: 'list-all-gateway-vaults',
+    description: 'List vaults from all gateways',
+    options: options_js_1.paginationAddressOptions,
+    action: readCommands_js_1.getAllGatewayVaults,
+});
 (0, utils_js_1.makeCommand)({
     name: 'transfer',
     description: 'Transfer ARIO to another address',

package/lib/cjs/cli/commands/readCommands.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getVault = exports.getGatewayVaults = exports.getPrimaryName = exports.getCostDetails = exports.getTokenCost = exports.getPrescribedNames = exports.getPrescribedObservers = exports.getEpoch = exports.listArNSReturnedNames = exports.getArNSReturnedName = exports.listArNSReservedNames = exports.getArNSReservedName = exports.listArNSRecords = exports.getArNSRecord = exports.getAllowedDelegates = exports.getDelegations = exports.getGatewayDelegates = exports.listAllDelegatesCLICommand = exports.listGateways = exports.getGateway = void 0;
+exports.getVault = exports.getAllGatewayVaults = exports.getGatewayVaults = exports.getPrimaryName = exports.getCostDetails = exports.getTokenCost = exports.getPrescribedNames = exports.getPrescribedObservers = exports.getEpoch = exports.listArNSReturnedNames = exports.getArNSReturnedName = exports.listArNSReservedNames = exports.getArNSReservedName = exports.listArNSRecords = exports.getArNSRecord = exports.getAllowedDelegates = exports.getDelegations = exports.getGatewayDelegates = exports.listAllDelegatesCLICommand = exports.listGateways = exports.getGateway = void 0;
 const token_js_1 = require("../../types/token.js");
 const utils_js_1 = require("../utils.js");
 async function getGateway(o) {
@@ -173,6 +173,15 @@ async function getGatewayVaults(o) {
         };
 }
 exports.getGatewayVaults = getGatewayVaults;
+async function getAllGatewayVaults(o) {
+    const result = await (0, utils_js_1.readARIOFromOptions)(o).getAllGatewayVaults((0, utils_js_1.paginationParamsFromOptions)(o));
+    return result.items?.length
+        ? result
+        : {
+            message: `No vaults found`,
+        };
+}
+exports.getAllGatewayVaults = getAllGatewayVaults;
 async function getVault(o) {
     return (0, utils_js_1.readARIOFromOptions)(o)
         .getVault({

package/lib/cjs/common/io.js

@@ -449,6 +449,14 @@ class ARIOReadable {
             ],
         });
     }
+    async getAllGatewayVaults(params) {
+        return this.process.read({
+            tags: [
+                { name: 'Action', value: 'All-Gateway-Vaults' },
+                ...(0, arweave_js_1.paginationParamsToTags)(params),
+            ],
+        });
+    }
 }
 exports.ARIOReadable = ARIOReadable;
 class ARIOWriteable extends ARIOReadable {

package/lib/cjs/utils/arweave.js

@@ -35,22 +35,40 @@ exports.paginationParamsToTags = paginationParamsToTags;
  * @param arweave - The Arweave instance
  * @returns The epoch with distribution data
  */
-const getEpochDataFromGql = async ({ arweave, epochIndex, processId = constants_js_1.ARIO_TESTNET_PROCESS_ID, }) => {
+const getEpochDataFromGql = async ({ arweave, epochIndex, processId = constants_js_1.ARIO_TESTNET_PROCESS_ID, retries = 3, }) => {
     // fetch from gql
     const query = (0, exports.epochDistributionNoticeGqlQuery)({ epochIndex, processId });
-    const response = await arweave.api.post('graphql', query);
-    // parse the nodes to get the id
-    if (response.data.data.transactions?.edges?.length === 0) {
-        return undefined;
+    // add three retries with exponential backoff
+    for (let i = 0; i < retries; i++) {
+        try {
+            const response = await arweave.api.post('graphql', query);
+            // parse the nodes to get the id
+            if (response.data?.data?.transactions?.edges?.length === 0) {
+                return undefined;
+            }
+            const id = response.data.data.transactions.edges[0].node.id;
+            // fetch the transaction from arweave
+            const transaction = await arweave.api.get(id);
+            // assert it is the correct type
+            return (0, ao_js_1.parseAoEpochData)(transaction.data);
+        }
+        catch (error) {
+            if (i === retries - 1)
+                throw error; // Re-throw on final attempt
+            // exponential backoff
+            await new Promise((resolve) => setTimeout(resolve, Math.pow(2, i) * 1000));
+        }
     }
-    const id = response.data.data.transactions.edges[0].node.id;
-    // fetch the transaction from arweave
-    const transaction = await arweave.api.get(id);
-    const data = transaction.data;
-    // assert it is the correct type
-    return (0, ao_js_1.parseAoEpochData)(data);
+    return undefined;
 };
 exports.getEpochDataFromGql = getEpochDataFromGql;
+/**
+ * Get the epoch with distribution data for the current epoch
+ * @param arweave - The Arweave instance
+ * @param epochIndex - The index of the epoch
+ * @param processId - The process ID (optional, defaults to ARIO_TESTNET_PROCESS_ID)
+ * @returns string - The stringified GQL query
+ */
 const epochDistributionNoticeGqlQuery = ({ epochIndex, processId = constants_js_1.ARIO_TESTNET_PROCESS_ID, }) => {
     // write the query
     const gqlQuery = JSON.stringify({

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.3.0-alpha.12';
+exports.version = '3.3.0-alpha.14';

package/lib/esm/cli/cli.js

@@ -21,7 +21,7 @@ import { mARIOToken } from '../types/token.js';
 import { version } from '../version.js';
 import { buyRecordCLICommand, extendLeaseCLICommand, increaseUndernameLimitCLICommand, requestPrimaryNameCLICommand, upgradeRecordCLICommand, } from './commands/arnsPurchaseCommands.js';
 import { cancelWithdrawal, decreaseDelegateStake, decreaseOperatorStake, delegateStake, increaseOperatorStake, instantWithdrawal, joinNetwork, leaveNetwork, redelegateStake, saveObservations, updateGatewaySettings, } from './commands/gatewayWriteCommands.js';
-import { getAllowedDelegates, getArNSRecord, getArNSReservedName, getArNSReturnedName, getCostDetails, getDelegations, getEpoch, getGateway, getGatewayDelegates, getGatewayVaults, getPrescribedNames, getPrescribedObservers, getPrimaryName, getTokenCost, getVault, listAllDelegatesCLICommand, listArNSRecords, listArNSReservedNames, listArNSReturnedNames, listGateways, } from './commands/readCommands.js';
+import { getAllGatewayVaults, getAllowedDelegates, getArNSRecord, getArNSReservedName, getArNSReturnedName, getCostDetails, getDelegations, getEpoch, getGateway, getGatewayDelegates, getGatewayVaults, getPrescribedNames, getPrescribedObservers, getPrimaryName, getTokenCost, getVault, listAllDelegatesCLICommand, listArNSRecords, listArNSReservedNames, listArNSReturnedNames, listGateways, } from './commands/readCommands.js';
 import { transfer } from './commands/transfer.js';
 import { addressAndVaultIdOptions, antStateOptions, arnsPurchaseOptions, buyRecordOptions, decreaseDelegateStakeOptions, delegateStakeOptions, epochOptions, getVaultOptions, globalOptions, joinNetworkOptions, operatorStakeOptions, optionMap, paginationAddressOptions, paginationOptions, redelegateStakeOptions, tokenCostOptions, transferOptions, updateGatewaySettingsOptions, writeActionOptions, } from './options.js';
 import { applyOptions, arioProcessIdFromOptions, assertConfirmationPrompt, epochInputFromOptions, formatARIOWithCommas, getANTStateFromOptions, getLoggerFromOptions, makeCommand, paginationParamsFromOptions, readANTFromOptions, readARIOFromOptions, requiredAddressFromOptions, requiredAoSignerFromOptions, requiredProcessIdFromOptions, requiredStringArrayFromOptions, requiredStringFromOptions, writeANTFromOptions, writeActionTagsFromOptions, } from './utils.js';
@@ -256,6 +256,12 @@ makeCommand({
     options: paginationAddressOptions,
     action: getGatewayVaults,
 });
+makeCommand({
+    name: 'list-all-gateway-vaults',
+    description: 'List vaults from all gateways',
+    options: paginationAddressOptions,
+    action: getAllGatewayVaults,
+});
 makeCommand({
     name: 'transfer',
     description: 'Transfer ARIO to another address',

package/lib/esm/cli/commands/readCommands.js

@@ -151,6 +151,14 @@ export async function getGatewayVaults(o) {
             message: `No vaults found for gateway ${address}`,
         };
 }
+export async function getAllGatewayVaults(o) {
+    const result = await readARIOFromOptions(o).getAllGatewayVaults(paginationParamsFromOptions(o));
+    return result.items?.length
+        ? result
+        : {
+            message: `No vaults found`,
+        };
+}
 export async function getVault(o) {
     return readARIOFromOptions(o)
         .getVault({

package/lib/esm/common/io.js

@@ -445,6 +445,14 @@ export class ARIOReadable {
             ],
         });
     }
+    async getAllGatewayVaults(params) {
+        return this.process.read({
+            tags: [
+                { name: 'Action', value: 'All-Gateway-Vaults' },
+                ...paginationParamsToTags(params),
+            ],
+        });
+    }
 }
 export class ARIOWriteable extends ARIOReadable {
     signer;

package/lib/esm/utils/arweave.js

@@ -28,21 +28,39 @@ export const paginationParamsToTags = (params) => {
  * @param arweave - The Arweave instance
  * @returns The epoch with distribution data
  */
-export const getEpochDataFromGql = async ({ arweave, epochIndex, processId = ARIO_TESTNET_PROCESS_ID, }) => {
+export const getEpochDataFromGql = async ({ arweave, epochIndex, processId = ARIO_TESTNET_PROCESS_ID, retries = 3, }) => {
     // fetch from gql
     const query = epochDistributionNoticeGqlQuery({ epochIndex, processId });
-    const response = await arweave.api.post('graphql', query);
-    // parse the nodes to get the id
-    if (response.data.data.transactions?.edges?.length === 0) {
-        return undefined;
+    // add three retries with exponential backoff
+    for (let i = 0; i < retries; i++) {
+        try {
+            const response = await arweave.api.post('graphql', query);
+            // parse the nodes to get the id
+            if (response.data?.data?.transactions?.edges?.length === 0) {
+                return undefined;
+            }
+            const id = response.data.data.transactions.edges[0].node.id;
+            // fetch the transaction from arweave
+            const transaction = await arweave.api.get(id);
+            // assert it is the correct type
+            return parseAoEpochData(transaction.data);
+        }
+        catch (error) {
+            if (i === retries - 1)
+                throw error; // Re-throw on final attempt
+            // exponential backoff
+            await new Promise((resolve) => setTimeout(resolve, Math.pow(2, i) * 1000));
+        }
     }
-    const id = response.data.data.transactions.edges[0].node.id;
-    // fetch the transaction from arweave
-    const transaction = await arweave.api.get(id);
-    const data = transaction.data;
-    // assert it is the correct type
-    return parseAoEpochData(data);
+    return undefined;
 };
+/**
+ * Get the epoch with distribution data for the current epoch
+ * @param arweave - The Arweave instance
+ * @param epochIndex - The index of the epoch
+ * @param processId - The process ID (optional, defaults to ARIO_TESTNET_PROCESS_ID)
+ * @returns string - The stringified GQL query
+ */
 export const epochDistributionNoticeGqlQuery = ({ epochIndex, processId = ARIO_TESTNET_PROCESS_ID, }) => {
     // write the query
     const gqlQuery = JSON.stringify({

package/lib/esm/version.js

@@ -14,4 +14,4 @@
  * limitations under the License.
  */
 // AUTOMATICALLY GENERATED FILE - DO NOT TOUCH
-export const version = '3.3.0-alpha.12';
+export const version = '3.3.0-alpha.14';

package/lib/types/cli/commands/readCommands.d.ts

@@ -79,6 +79,9 @@ export declare function getPrimaryName(o: AddressAndNameCLIOptions): Promise<imp
 export declare function getGatewayVaults(o: PaginationAddressCLIOptions): Promise<import("../../types/io.js").PaginationResult<AoGatewayVault> | {
     message: string;
 }>;
+export declare function getAllGatewayVaults(o: PaginationCLIOptions): Promise<import("../../types/io.js").PaginationResult<import("../../types/io.js").AoAllGatewayVaults> | {
+    message: string;
+}>;
 export declare function getVault(o: AddressAndVaultIdCLIOptions): Promise<import("../../types/io.js").AoVaultData | {
     message: string;
 }>;

package/lib/types/common/io.d.ts

@@ -15,7 +15,7 @@
  */
 import Arweave from 'arweave';
 import { AoArNSNameDataWithName, AoArNSReservedNameData, AoBalanceWithAddress, AoEpochDistributionData, AoEpochObservationData, AoGatewayWithAddress, AoJoinNetworkParams, AoMessageResult, AoPrimaryName, AoPrimaryNameRequest, AoRedelegationFeeInfo, AoReturnedName, AoTokenSupplyData, AoUpdateGatewaySettingsParams, AoWeightedObserver, OptionalArweave, PaginationParams, PaginationResult, ProcessConfiguration, TransactionId, WalletAddress, WithSigner, WriteOptions } from '../types/index.js';
-import { AoARIORead, AoARIOWrite, AoAllDelegates, AoArNSNameData, AoArNSPurchaseParams, AoArNSReservedNameDataWithName, AoBuyRecordParams, AoDelegation, AoEpochData, AoEpochSettings, AoExtendLeaseParams, AoGateway, AoGatewayDelegateWithAddress, AoGatewayRegistrySettings, AoGatewayVault, AoGetCostDetailsParams, AoIncreaseUndernameLimitParams, AoPaginatedAddressParams, AoRegistrationFees, AoVaultData, AoWalletVault, CostDetailsResult, DemandFactorSettings, EpochInput } from '../types/io.js';
+import { AoARIORead, AoARIOWrite, AoAllDelegates, AoAllGatewayVaults, AoArNSNameData, AoArNSPurchaseParams, AoArNSReservedNameDataWithName, AoBuyRecordParams, AoDelegation, AoEpochData, AoEpochSettings, AoExtendLeaseParams, AoGateway, AoGatewayDelegateWithAddress, AoGatewayRegistrySettings, AoGatewayVault, AoGetCostDetailsParams, AoIncreaseUndernameLimitParams, AoPaginatedAddressParams, AoRegistrationFees, AoVaultData, AoWalletVault, CostDetailsResult, DemandFactorSettings, EpochInput } from '../types/io.js';
 import { mARIOToken } from '../types/token.js';
 import { AOProcess } from './contracts/ao-process.js';
 type ARIOConfigNoSigner = OptionalArweave<ProcessConfiguration>;
@@ -137,6 +137,7 @@ export declare class ARIOReadable implements AoARIORead {
     }): Promise<AoRedelegationFeeInfo>;
     getGatewayRegistrySettings(): Promise<AoGatewayRegistrySettings>;
     getAllDelegates(params?: PaginationParams<AoAllDelegates>): Promise<PaginationResult<AoAllDelegates>>;
+    getAllGatewayVaults(params?: PaginationParams<AoAllGatewayVaults>): Promise<PaginationResult<AoAllGatewayVaults>>;
 }
 export declare class ARIOWriteable extends ARIOReadable implements AoARIOWrite {
     protected process: AOProcess;

package/lib/types/types/io.d.ts

@@ -197,6 +197,11 @@ export type AoGatewayDelegate = {
 export type AoGatewayDelegateWithAddress = AoGatewayDelegate & {
     address: WalletAddress;
 };
+export type AoAllDelegates = AoGatewayDelegateWithAddress & {
+    gatewayAddress: WalletAddress;
+    vaultedStake: number;
+    cursorId: string;
+};
 export type AoGatewaySettings = {
     allowDelegatedStaking: boolean | 'allowlist';
     delegateRewardShareRatio: number;
@@ -236,6 +241,7 @@ export type AoStakeDelegation = AoDelegationBase & {
     balance: number;
 };
 export type AoDelegation = AoStakeDelegation | AoVaultDelegation;
+/** Operator stake being withdrawn from a given gateway */
 export type AoGatewayVault = {
     cursorId: string;
     vaultId: TransactionId;
@@ -243,6 +249,10 @@ export type AoGatewayVault = {
     endTimestamp: Timestamp;
     startTimestamp: Timestamp;
 };
+/** Operator stake being withdrawn from all gateway gateways */
+export type AoAllGatewayVaults = AoGatewayVault & {
+    gatewayAddress: WalletAddress;
+};
 export type AoJoinNetworkParams = Pick<AoGateway, 'operatorStake'> & Partial<AoGatewaySettings> & {
     observerAddress?: WalletAddress;
 };
@@ -422,15 +432,8 @@ export interface AoARIORead {
     }): Promise<AoRedelegationFeeInfo>;
     getGatewayRegistrySettings(): Promise<AoGatewayRegistrySettings>;
     getAllDelegates(params?: PaginationParams<AoAllDelegates>): Promise<PaginationResult<AoAllDelegates>>;
+    getAllGatewayVaults(params?: PaginationParams<AoAllGatewayVaults>): Promise<PaginationResult<AoAllGatewayVaults>>;
 }
-export type AoAllDelegates = {
-    address: WalletAddress;
-    gatewayAddress: WalletAddress;
-    delegatedStake: number;
-    startTimestamp: Timestamp;
-    vaultedStake: number;
-    cursorId: string;
-};
 export interface AoARIOWrite extends AoARIORead {
     transfer({ target, qty, }: {
         target: WalletAddress;

package/lib/types/utils/arweave.d.ts

@@ -39,11 +39,19 @@ export declare const paginationParamsToTags: <T>(params?: PaginationParams<T>) =
  * @param arweave - The Arweave instance
  * @returns The epoch with distribution data
  */
-export declare const getEpochDataFromGql: ({ arweave, epochIndex, processId, }: {
+export declare const getEpochDataFromGql: ({ arweave, epochIndex, processId, retries, }: {
     arweave: Arweave;
     epochIndex: number;
     processId?: string;
+    retries?: number;
 }) => Promise<AoEpochData | undefined>;
+/**
+ * Get the epoch with distribution data for the current epoch
+ * @param arweave - The Arweave instance
+ * @param epochIndex - The index of the epoch
+ * @param processId - The process ID (optional, defaults to ARIO_TESTNET_PROCESS_ID)
+ * @returns string - The stringified GQL query
+ */
 export declare const epochDistributionNoticeGqlQuery: ({ epochIndex, processId, }: {
     epochIndex: number;
     processId?: string;

package/lib/types/version.d.ts

@@ -13,4 +13,4 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-export declare const version = "3.3.0-alpha.11";
+export declare const version = "3.3.0-alpha.13";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ar.io/sdk",
-  "version": "3.3.0-alpha.12",
+  "version": "3.3.0-alpha.14",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/ar-io/ar-io-sdk.git"