@ar.io/sdk 3.3.0-alpha.8 → 3.3.0

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',
@@ -671,6 +677,7 @@ const utils_js_1 = require("./utils.js");
     action: async (options) => {
         const process = new index_js_1.AOProcess({
             processId: (0, utils_js_1.requiredProcessIdFromOptions)(options),
+            logger: (0, utils_js_1.getLoggerFromOptions)(options),
         });
         return process.send({
             tags: (0, utils_js_1.writeActionTagsFromOptions)(options).tags ?? [],

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/cli/utils.js

@@ -198,7 +198,7 @@ function paginationParamsFromOptions(options) {
     return {
         cursor,
         limit: numberLimit,
-        sortBy,
+        sortBy: sortBy,
         sortOrder,
     };
 }

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

@@ -18,6 +18,7 @@ exports.AOProcess = void 0;
  */
 const aoconnect_1 = require("@permaweb/aoconnect");
 const base64_js_1 = require("../../utils/base64.js");
+const index_js_1 = require("../../utils/index.js");
 const json_js_1 = require("../../utils/json.js");
 const version_js_1 = require("../../version.js");
 const error_js_1 = require("../error.js");
@@ -59,7 +60,7 @@ class AOProcess {
                     result,
                     processId: this.processId,
                 });
-                const error = errorMessageFromOutput(result);
+                const error = (0, index_js_1.errorMessageFromOutput)(result);
                 if (error !== undefined) {
                     throw new Error(error);
                 }
@@ -131,7 +132,7 @@ class AOProcess {
                     messageId,
                     processId: this.processId,
                 });
-                const error = errorMessageFromOutput(output);
+                const error = (0, index_js_1.errorMessageFromOutput)(output);
                 if (error !== undefined) {
                     throw new error_js_1.WriteInteractionError(error);
                 }
@@ -181,18 +182,3 @@ class AOProcess {
     }
 }
 exports.AOProcess = AOProcess;
-function errorMessageFromOutput(output) {
-    const errorData = output.Error;
-    // Attempt to extract error details from Messages.Tags if Error is undefined
-    const error = errorData ??
-        output.Messages?.[0]?.Tags?.find((tag) => tag.name === 'Error')?.value;
-    if (error !== undefined) {
-        // Consolidated regex to match and extract line number and AO error message or Error Tags
-        const match = error.match(/\[string "aos"]:(\d+):\s*(.+)/);
-        if (match) {
-            const [, lineNumber, errorMessage] = match;
-            return `${errorMessage.trim()} (line ${lineNumber.trim()})`.trim();
-        }
-    }
-    return undefined;
-}

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/constants.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_SCHEDULER_ID = exports.ANT_LUA_ID = exports.AOS_MODULE_ID = exports.MARIO_PER_ARIO = exports.ANT_REGISTRY_ID = exports.ARIO_TESTNET_PROCESS_ID = exports.arioDevnetProcessId = exports.ARIO_DEVNET_PROCESS_ID = exports.ARNS_DEVNET_REGISTRY_TX = exports.ARNS_TESTNET_REGISTRY_TX = exports.SORT_KEY_REGEX = exports.FQDN_REGEX = exports.ARWEAVE_TX_REGEX = void 0;
+exports.DEFAULT_SCHEDULER_ID = exports.AO_AUTHORITY = exports.ANT_LUA_ID = exports.AOS_MODULE_ID = exports.MARIO_PER_ARIO = exports.ANT_REGISTRY_ID = exports.ARIO_TESTNET_PROCESS_ID = exports.arioDevnetProcessId = exports.ARIO_DEVNET_PROCESS_ID = exports.ARNS_DEVNET_REGISTRY_TX = exports.ARNS_TESTNET_REGISTRY_TX = exports.SORT_KEY_REGEX = exports.FQDN_REGEX = exports.ARWEAVE_TX_REGEX = void 0;
 /**
  * Copyright (C) 2022-2024 Permanent Data Solutions, Inc.
  *
@@ -31,4 +31,5 @@ exports.ANT_REGISTRY_ID = 'i_le_yKKPVstLTDSmkHRqf-wYphMnwB9OhleiTgMkWc';
 exports.MARIO_PER_ARIO = 1_000_000;
 exports.AOS_MODULE_ID = 'BRyNPIJWZaQ4IudfNnsfvMrZBO2YDPjgKqg_wCYT2U8';
 exports.ANT_LUA_ID = 'k9tQkbnFYZOGp6ist1yFuaqk_wOkzM5KUSNDtWzCLtg';
+exports.AO_AUTHORITY = 'fcoN_xJeisVsPXA-trzVAuIiqO3ydLQxM-L4XbrQKzY';
 exports.DEFAULT_SCHEDULER_ID = '_GQ33BkPtZrqxA84vM8Zk-N2aO0toNNu_C-l-rawrBA';

package/lib/cjs/utils/ao.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseAoEpochData = exports.initANTStateForAddress = exports.defaultTargetManifestId = exports.createAoSigner = exports.isAoSigner = exports.evolveANT = exports.spawnANT = void 0;
+exports.removeUnicodeFromError = exports.errorMessageFromOutput = exports.parseAoEpochData = exports.initANTStateForAddress = exports.defaultTargetManifestId = exports.createAoSigner = exports.isAoSigner = exports.evolveANT = exports.spawnANT = void 0;
 /**
  * Copyright (C) 2022-2024 Permanent Data Solutions, Inc.
  *
@@ -22,13 +22,18 @@ const zod_1 = require("zod");
 const arweave_js_1 = require("../common/arweave.js");
 const index_js_1 = require("../common/index.js");
 const constants_js_1 = require("../constants.js");
-async function spawnANT({ signer, module = constants_js_1.AOS_MODULE_ID, ao = (0, aoconnect_1.connect)(), scheduler = constants_js_1.DEFAULT_SCHEDULER_ID, state, stateContractTxId, antRegistryId = constants_js_1.ANT_REGISTRY_ID, logger = index_js_1.Logger.default, }) {
+async function spawnANT({ signer, module = constants_js_1.AOS_MODULE_ID, ao = (0, aoconnect_1.connect)(), scheduler = constants_js_1.DEFAULT_SCHEDULER_ID, state, stateContractTxId, antRegistryId = constants_js_1.ANT_REGISTRY_ID, logger = index_js_1.Logger.default, authority = constants_js_1.AO_AUTHORITY, }) {
     // TODO: use On-Boot data handler for bootstrapping state instead of initialize-state
     const processId = await ao.spawn({
         module,
         scheduler,
         signer,
         tags: [
+            // Required for AOS to initialize the authorities table
+            {
+                name: 'Authority',
+                value: authority,
+            },
             {
                 name: 'ANT-Registry-Id',
                 value: antRegistryId,
@@ -153,6 +158,20 @@ function createAoSigner(signer) {
             typeof signer.setPublicKey === 'function') {
             await signer.setPublicKey();
         }
+        if (signer instanceof arbundles_1.ArconnectSigner) {
+            // Sign using Arconnect signDataItem API
+            const signedDataItem = await signer['signer'].signDataItem({
+                data,
+                tags,
+                target,
+                anchor,
+            });
+            const dataItem = new arbundles_1.DataItem(Buffer.from(signedDataItem));
+            return {
+                id: await dataItem.id,
+                raw: await dataItem.getRaw(),
+            };
+        }
         const dataItem = (0, arbundles_1.createData)(data, signer, { tags, target, anchor });
         const signedData = dataItem.sign(signer).then(async () => ({
             id: await dataItem.id,
@@ -200,3 +219,30 @@ function parseAoEpochData(value) {
     return epochDataSchema.parse(value);
 }
 exports.parseAoEpochData = parseAoEpochData;
+function errorMessageFromOutput(output) {
+    const errorData = output.Error;
+    // Attempt to extract error details from Messages.Tags if Error is undefined
+    const error = errorData ??
+        output.Messages?.[0]?.Tags?.find((tag) => tag.name === 'Error')?.value;
+    if (error !== undefined) {
+        // Consolidated regex to match and extract line number and AO error message or Error Tags
+        const match = error.match(/\[string "aos"]:(\d+):\s*(.+)/);
+        if (match) {
+            const [, lineNumber, errorMessage] = match;
+            const cleanError = removeUnicodeFromError(errorMessage);
+            return `${cleanError.trim()} (line ${lineNumber.trim()})`.trim();
+        }
+        // With no match, just remove unicode
+        return removeUnicodeFromError(error);
+    }
+    return undefined;
+}
+exports.errorMessageFromOutput = errorMessageFromOutput;
+function removeUnicodeFromError(error) {
+    //The regular expression /[\u001b][[()#;?]*(?:[0-9]{1,4}(?:;[0-9]{0,4})*)?[0-9A-ORZcf-nqry=><]/g is designed to match ANSI escape codes used for terminal formatting. These are sequences that begin with \u001b (ESC character) and are often followed by [ and control codes.
+    const ESC = String.fromCharCode(27); // Represents '\u001b' or '\x1b'
+    return error
+        .replace(new RegExp(`${ESC}[\\[\\]()#;?]*(?:[0-9]{1,4}(?:;[0-9]{0,4})*)?[0-9A-ORZcf-nqry=><]`, 'g'), '')
+        .trim();
+}
+exports.removeUnicodeFromError = removeUnicodeFromError;

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/utils/processes.js

@@ -16,10 +16,12 @@ exports.fetchAllArNSRecords = exports.ArNSEventEmitter = exports.getANTProcesses
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+const aoconnect_1 = require("@permaweb/aoconnect");
 const eventemitter3_1 = require("eventemitter3");
 const plimit_lit_1 = require("plimit-lit");
 const ant_registry_js_1 = require("../common/ant-registry.js");
 const ant_js_1 = require("../common/ant.js");
+const index_js_1 = require("../common/index.js");
 const io_js_1 = require("../common/io.js");
 const logger_js_1 = require("../common/logger.js");
 const constants_js_1 = require("../constants.js");
@@ -53,15 +55,17 @@ class ArNSEventEmitter extends eventemitter3_1.EventEmitter {
     throttle;
     logger;
     strict;
+    antAoClient;
     constructor({ contract = io_js_1.ARIO.init({
         processId: constants_js_1.ARIO_TESTNET_PROCESS_ID,
-    }), timeoutMs = 60_000, concurrency = 30, logger = logger_js_1.Logger.default, strict = false, } = {}) {
+    }), timeoutMs = 60_000, concurrency = 30, logger = logger_js_1.Logger.default, strict = false, antAoClient = (0, aoconnect_1.connect)(), } = {}) {
         super();
         this.contract = contract;
         this.timeoutMs = timeoutMs;
         this.throttle = (0, plimit_lit_1.pLimit)(concurrency);
         this.logger = logger;
         this.strict = strict;
+        this.antAoClient = antAoClient;
     }
     async fetchProcessesOwnedByWallet({ address, pageSize, antRegistry = ant_registry_js_1.ANTRegistry.init(), }) {
         const uniqueContractProcessIds = {};
@@ -99,7 +103,10 @@ class ArNSEventEmitter extends eventemitter3_1.EventEmitter {
                 return;
             }
             const ant = ant_js_1.ANT.init({
-                processId,
+                process: new index_js_1.AOProcess({
+                    processId,
+                    ao: this.antAoClient,
+                }),
                 strict: this.strict,
             });
             const state = (await timeout(this.timeoutMs, ant.getState()).catch((e) => {

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.8';
+exports.version = '3.3.0';

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',
@@ -669,6 +675,7 @@ makeCommand({
     action: async (options) => {
         const process = new AOProcess({
             processId: requiredProcessIdFromOptions(options),
+            logger: getLoggerFromOptions(options),
         });
         return process.send({
             tags: writeActionTagsFromOptions(options).tags ?? [],

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/cli/utils.js

@@ -176,7 +176,7 @@ export function paginationParamsFromOptions(options) {
     return {
         cursor,
         limit: numberLimit,
-        sortBy,
+        sortBy: sortBy,
         sortOrder,
     };
 }

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

@@ -15,6 +15,7 @@
  */
 import { connect } from '@permaweb/aoconnect';
 import { getRandomText } from '../../utils/base64.js';
+import { errorMessageFromOutput } from '../../utils/index.js';
 import { safeDecode } from '../../utils/json.js';
 import { version } from '../../version.js';
 import { WriteInteractionError } from '../error.js';
@@ -177,18 +178,3 @@ export class AOProcess {
         throw lastError;
     }
 }
-function errorMessageFromOutput(output) {
-    const errorData = output.Error;
-    // Attempt to extract error details from Messages.Tags if Error is undefined
-    const error = errorData ??
-        output.Messages?.[0]?.Tags?.find((tag) => tag.name === 'Error')?.value;
-    if (error !== undefined) {
-        // Consolidated regex to match and extract line number and AO error message or Error Tags
-        const match = error.match(/\[string "aos"]:(\d+):\s*(.+)/);
-        if (match) {
-            const [, lineNumber, errorMessage] = match;
-            return `${errorMessage.trim()} (line ${lineNumber.trim()})`.trim();
-        }
-    }
-    return undefined;
-}

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/constants.js

@@ -28,4 +28,5 @@ export const ANT_REGISTRY_ID = 'i_le_yKKPVstLTDSmkHRqf-wYphMnwB9OhleiTgMkWc';
 export const MARIO_PER_ARIO = 1_000_000;
 export const AOS_MODULE_ID = 'BRyNPIJWZaQ4IudfNnsfvMrZBO2YDPjgKqg_wCYT2U8';
 export const ANT_LUA_ID = 'k9tQkbnFYZOGp6ist1yFuaqk_wOkzM5KUSNDtWzCLtg';
+export const AO_AUTHORITY = 'fcoN_xJeisVsPXA-trzVAuIiqO3ydLQxM-L4XbrQKzY';
 export const DEFAULT_SCHEDULER_ID = '_GQ33BkPtZrqxA84vM8Zk-N2aO0toNNu_C-l-rawrBA';

package/lib/esm/utils/ao.js

@@ -13,19 +13,24 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { createData } from '@dha-team/arbundles';
+import { ArconnectSigner, DataItem, createData } from '@dha-team/arbundles';
 import { connect, createDataItemSigner } from '@permaweb/aoconnect';
 import { z } from 'zod';
 import { defaultArweave } from '../common/arweave.js';
 import { ANTRegistry, AOProcess, Logger } from '../common/index.js';
-import { ANT_LUA_ID, ANT_REGISTRY_ID, AOS_MODULE_ID, DEFAULT_SCHEDULER_ID, } from '../constants.js';
-export async function spawnANT({ signer, module = AOS_MODULE_ID, ao = connect(), scheduler = DEFAULT_SCHEDULER_ID, state, stateContractTxId, antRegistryId = ANT_REGISTRY_ID, logger = Logger.default, }) {
+import { ANT_LUA_ID, ANT_REGISTRY_ID, AOS_MODULE_ID, AO_AUTHORITY, DEFAULT_SCHEDULER_ID, } from '../constants.js';
+export async function spawnANT({ signer, module = AOS_MODULE_ID, ao = connect(), scheduler = DEFAULT_SCHEDULER_ID, state, stateContractTxId, antRegistryId = ANT_REGISTRY_ID, logger = Logger.default, authority = AO_AUTHORITY, }) {
     // TODO: use On-Boot data handler for bootstrapping state instead of initialize-state
     const processId = await ao.spawn({
         module,
         scheduler,
         signer,
         tags: [
+            // Required for AOS to initialize the authorities table
+            {
+                name: 'Authority',
+                value: authority,
+            },
             {
                 name: 'ANT-Registry-Id',
                 value: antRegistryId,
@@ -147,6 +152,20 @@ export function createAoSigner(signer) {
             typeof signer.setPublicKey === 'function') {
             await signer.setPublicKey();
         }
+        if (signer instanceof ArconnectSigner) {
+            // Sign using Arconnect signDataItem API
+            const signedDataItem = await signer['signer'].signDataItem({
+                data,
+                tags,
+                target,
+                anchor,
+            });
+            const dataItem = new DataItem(Buffer.from(signedDataItem));
+            return {
+                id: await dataItem.id,
+                raw: await dataItem.getRaw(),
+            };
+        }
         const dataItem = createData(data, signer, { tags, target, anchor });
         const signedData = dataItem.sign(signer).then(async () => ({
             id: await dataItem.id,
@@ -191,3 +210,28 @@ export function parseAoEpochData(value) {
     });
     return epochDataSchema.parse(value);
 }
+export function errorMessageFromOutput(output) {
+    const errorData = output.Error;
+    // Attempt to extract error details from Messages.Tags if Error is undefined
+    const error = errorData ??
+        output.Messages?.[0]?.Tags?.find((tag) => tag.name === 'Error')?.value;
+    if (error !== undefined) {
+        // Consolidated regex to match and extract line number and AO error message or Error Tags
+        const match = error.match(/\[string "aos"]:(\d+):\s*(.+)/);
+        if (match) {
+            const [, lineNumber, errorMessage] = match;
+            const cleanError = removeUnicodeFromError(errorMessage);
+            return `${cleanError.trim()} (line ${lineNumber.trim()})`.trim();
+        }
+        // With no match, just remove unicode
+        return removeUnicodeFromError(error);
+    }
+    return undefined;
+}
+export function removeUnicodeFromError(error) {
+    //The regular expression /[\u001b][[()#;?]*(?:[0-9]{1,4}(?:;[0-9]{0,4})*)?[0-9A-ORZcf-nqry=><]/g is designed to match ANSI escape codes used for terminal formatting. These are sequences that begin with \u001b (ESC character) and are often followed by [ and control codes.
+    const ESC = String.fromCharCode(27); // Represents '\u001b' or '\x1b'
+    return error
+        .replace(new RegExp(`${ESC}[\\[\\]()#;?]*(?:[0-9]{1,4}(?:;[0-9]{0,4})*)?[0-9A-ORZcf-nqry=><]`, 'g'), '')
+        .trim();
+}

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/utils/processes.js

@@ -13,10 +13,12 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+import { connect } from '@permaweb/aoconnect';
 import { EventEmitter } from 'eventemitter3';
 import { pLimit } from 'plimit-lit';
 import { ANTRegistry } from '../common/ant-registry.js';
 import { ANT } from '../common/ant.js';
+import { AOProcess } from '../common/index.js';
 import { ARIO } from '../common/io.js';
 import { Logger } from '../common/logger.js';
 import { ARIO_TESTNET_PROCESS_ID } from '../constants.js';
@@ -49,15 +51,17 @@ export class ArNSEventEmitter extends EventEmitter {
     throttle;
     logger;
     strict;
+    antAoClient;
     constructor({ contract = ARIO.init({
         processId: ARIO_TESTNET_PROCESS_ID,
-    }), timeoutMs = 60_000, concurrency = 30, logger = Logger.default, strict = false, } = {}) {
+    }), timeoutMs = 60_000, concurrency = 30, logger = Logger.default, strict = false, antAoClient = connect(), } = {}) {
         super();
         this.contract = contract;
         this.timeoutMs = timeoutMs;
         this.throttle = pLimit(concurrency);
         this.logger = logger;
         this.strict = strict;
+        this.antAoClient = antAoClient;
     }
     async fetchProcessesOwnedByWallet({ address, pageSize, antRegistry = ANTRegistry.init(), }) {
         const uniqueContractProcessIds = {};
@@ -95,7 +99,10 @@ export class ArNSEventEmitter extends EventEmitter {
                 return;
             }
             const ant = ANT.init({
-                processId,
+                process: new AOProcess({
+                    processId,
+                    ao: this.antAoClient,
+                }),
                 strict: this.strict,
             });
             const state = (await timeout(this.timeoutMs, ant.getState()).catch((e) => {

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.8';
+export const version = '3.3.0';

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

@@ -13,7 +13,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { AoGetCostDetailsParams } from '../../types/io.js';
+import { AoDelegation, AoGatewayDelegateWithAddress, AoGatewayVault, AoGetCostDetailsParams } from '../../types/io.js';
 import { AddressAndNameCLIOptions, AddressAndVaultIdCLIOptions, AddressCLIOptions, CLIOptionsFromAoParams, EpochCLIOptions, GetTokenCostCLIOptions, GlobalCLIOptions, NameCLIOptions, PaginationAddressCLIOptions, PaginationCLIOptions } from '../types.js';
 export declare function getGateway(o: AddressCLIOptions): Promise<import("../../types/io.js").AoGateway | {
     message: string;
@@ -24,10 +24,10 @@ export declare function listGateways(o: PaginationCLIOptions): Promise<import(".
 export declare function listAllDelegatesCLICommand(o: PaginationCLIOptions): Promise<import("../../types/io.js").PaginationResult<import("../../types/io.js").AoAllDelegates> | {
     message: string;
 }>;
-export declare function getGatewayDelegates(o: AddressCLIOptions): Promise<import("../../types/io.js").PaginationResult<import("../../types/io.js").AoGatewayDelegateWithAddress> | {
+export declare function getGatewayDelegates(o: AddressCLIOptions): Promise<import("../../types/io.js").PaginationResult<AoGatewayDelegateWithAddress> | {
     message: string;
 }>;
-export declare function getDelegations(o: PaginationAddressCLIOptions): Promise<import("../../types/io.js").PaginationResult<import("../../types/io.js").AoDelegation> | {
+export declare function getDelegations(o: PaginationAddressCLIOptions): Promise<import("../../types/io.js").PaginationResult<AoDelegation> | {
     message: string;
 }>;
 export declare function getAllowedDelegates(o: PaginationAddressCLIOptions): Promise<import("../../types/io.js").PaginationResult<string> | {
@@ -76,7 +76,10 @@ export declare function getCostDetails(o: GlobalCLIOptions & CLIOptionsFromAoPar
 export declare function getPrimaryName(o: AddressAndNameCLIOptions): Promise<import("../../types/common.js").AoPrimaryName | {
     message: string;
 }>;
-export declare function getGatewayVaults(o: PaginationAddressCLIOptions): Promise<import("../../types/io.js").PaginationResult<import("../../types/io.js").AoGatewayVault> | {
+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 | {