@ar.io/sdk 3.14.1-alpha.1 → 3.14.1-alpha.2

package/lib/cjs/cli/cli.js

@@ -427,6 +427,17 @@ const utils_js_1 = require("./utils.js");
     options: options_js_1.arnsPurchaseOptions,
     action: arnsPurchaseCommands_js_1.requestPrimaryNameCLICommand,
 });
+// # ANT Registry
+(0, utils_js_1.makeCommand)({
+    name: 'get-ant-registry-acl',
+    description: 'Get the ACL of an ANT registry',
+    options: [
+        options_js_1.optionMap.address,
+        options_js_1.optionMap.antRegistryProcessId,
+        options_js_1.optionMap.hyperbeamUrl,
+    ],
+    action: readCommands_js_1.listAntsForAddress,
+});
 // # ANTS
 // # Getters
 (0, utils_js_1.makeCommand)({

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

@@ -22,6 +22,7 @@ exports.getGatewayVaults = getGatewayVaults;
 exports.getAllGatewayVaults = getAllGatewayVaults;
 exports.getVault = getVault;
 exports.resolveArNSName = resolveArNSName;
+exports.listAntsForAddress = listAntsForAddress;
 const token_js_1 = require("../../types/token.js");
 const utils_js_1 = require("../utils.js");
 async function getGateway(o) {
@@ -194,3 +195,10 @@ async function resolveArNSName(o) {
     const result = await (0, utils_js_1.readARIOFromOptions)(o).resolveArNSName({ name });
     return result ?? { message: `No record found for name ${name}` };
 }
+async function listAntsForAddress(o) {
+    const address = (0, utils_js_1.requiredAddressFromOptions)(o);
+    const result = await (0, utils_js_1.readANTRegistryFromOptions)(o).accessControlList({
+        address,
+    });
+    return result ?? { message: `No ANTs found for address ${address}` };
+}

package/lib/cjs/cli/options.js

@@ -48,6 +48,14 @@ exports.optionMap = {
         alias: '--ario-process-id <arioProcessId>',
         description: 'Run against a custom AR.IO process id',
     },
+    antRegistryProcessId: {
+        alias: '--ant-registry-process-id <antRegistryProcessId>',
+        description: 'Run against a custom ANT registry process id',
+    },
+    hyperbeamUrl: {
+        alias: '--hyperbeam-url <hyperbeamUrl>',
+        description: 'The URL for a custom hyperbeam node',
+    },
     cuUrl: {
         alias: '--cu-url <cuUrl>',
         description: 'The URL for a custom compute unit',

package/lib/cjs/cli/utils.js

@@ -13,6 +13,8 @@ exports.requiredJwkFromOptions = requiredJwkFromOptions;
 exports.jwkToAddress = jwkToAddress;
 exports.getLoggerFromOptions = getLoggerFromOptions;
 exports.readARIOFromOptions = readARIOFromOptions;
+exports.ANTRegistryProcessFromOptions = ANTRegistryProcessFromOptions;
+exports.readANTRegistryFromOptions = readANTRegistryFromOptions;
 exports.contractSignerFromOptions = contractSignerFromOptions;
 exports.requiredContractSignerFromOptions = requiredContractSignerFromOptions;
 exports.requiredAoSignerFromOptions = requiredAoSignerFromOptions;
@@ -175,6 +177,21 @@ function readARIOFromOptions(options) {
         paymentUrl: options.paymentUrl,
     });
 }
+function ANTRegistryProcessFromOptions(options) {
+    return new index_js_1.AOProcess({
+        processId: options.antRegistryProcessId ?? index_js_1.ANT_REGISTRY_ID,
+        ao: (0, aoconnect_1.connect)({
+            MODE: 'legacy',
+            CU_URL: options.cuUrl,
+        }),
+    });
+}
+function readANTRegistryFromOptions(options) {
+    return index_js_1.ANTRegistry.init({
+        process: ANTRegistryProcessFromOptions(options),
+        hyperbeamUrl: options.hyperbeamUrl,
+    });
+}
 function contractSignerFromOptions(options) {
     const wallet = walletFromOptions(options);
     if (wallet === undefined) {

package/lib/cjs/common/ant-registry.js

@@ -20,6 +20,7 @@ const constants_js_1 = require("../constants.js");
 const index_js_1 = require("../types/index.js");
 const ao_js_1 = require("../utils/ao.js");
 const index_js_2 = require("./index.js");
+const logger_js_1 = require("./logger.js");
 class ANTRegistry {
     static init(config) {
         if (config !== undefined && 'signer' in config) {
@@ -31,7 +32,11 @@ class ANTRegistry {
 exports.ANTRegistry = ANTRegistry;
 class AoANTRegistryReadable {
     process;
+    hyperbeamUrl;
+    checkHyperBeamPromise;
+    logger;
     constructor(config) {
+        this.logger = config?.logger ?? logger_js_1.Logger.default;
         if (config === undefined || Object.keys(config).length === 0) {
             this.process = new index_js_2.AOProcess({
                 processId: constants_js_1.ANT_REGISTRY_ID,
@@ -48,9 +53,63 @@ class AoANTRegistryReadable {
         else {
             throw new index_js_2.InvalidContractConfigurationError();
         }
+        if (config?.hyperbeamUrl !== undefined) {
+            this.hyperbeamUrl = new URL(config.hyperbeamUrl).toString();
+            this.checkHyperBeamPromise = this.checkHyperBeamCompatibility();
+        }
+    }
+    /**
+     * Check if the process is HyperBeam compatible. If so, we'll use the HyperBeam node to fetch the state.
+     *
+     * @returns {Promise<boolean>} True if the process is HyperBeam compatible, false otherwise.
+     */
+    async checkHyperBeamCompatibility() {
+        if (this.hyperbeamUrl === undefined) {
+            return Promise.resolve(false);
+        }
+        if (this.checkHyperBeamPromise !== undefined) {
+            return this.checkHyperBeamPromise;
+        }
+        this.logger.debug('Checking HyperBeam compatibility');
+        this.checkHyperBeamPromise = fetch(`${this.hyperbeamUrl.toString()}${this.process.processId}~process@1.0/now/cache/acl`, {
+            method: 'HEAD',
+        }).then((res) => {
+            if (res.ok) {
+                this.logger.debug('HyperBeam compatible');
+                return true;
+            }
+            this.logger.debug('HyperBeam not compatible');
+            return false;
+        });
+        return this.checkHyperBeamPromise;
     }
     // Should we rename this to "getANTsByAddress"? seems more clear, though not same as handler name
     async accessControlList({ address, }) {
+        if (await this.checkHyperBeamCompatibility()) {
+            let retries = 0;
+            while (retries < 3) {
+                try {
+                    this.logger.debug('Fetching ant registry acl for address from hyperbeam', address);
+                    const res = await fetch(`${this.hyperbeamUrl?.toString()}${this.process.processId}~process@1.0/now/cache/acl/${address}/serialize~json@1.0`);
+                    if (res.status !== 200) {
+                        this.logger.debug('Failed to fetch ant registry acl for address from hyperbeam', address, res.status, res.statusText);
+                        throw new Error(`Failed to fetch ant registry acl for address ${address}: ${res?.statusText ?? 'Unknown error'}`);
+                    }
+                    this.logger.debug('Fetched ant registry acl for address from hyperbeam', address);
+                    const json = (await res.json());
+                    return {
+                        Owned: json.Owned,
+                        Controlled: json.Controlled,
+                    };
+                }
+                catch (error) {
+                    retries++;
+                    this.logger.debug('Failed to fetch ant registry acl for address from hyperbeam', address, retries);
+                    await new Promise((resolve) => setTimeout(resolve, 1000 * retries ** 2));
+                }
+            }
+        }
+        this.logger.debug('Fetching ant registry acl for address from process', address);
         return this.process.read({
             tags: [
                 { name: 'Action', value: 'Access-Control-List' },

package/lib/cjs/utils/ao.js

@@ -247,10 +247,12 @@ function errorMessageFromOutput(output) {
     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*(.+)/);
+        // Regex to match AO error messages like: [string ".src.main"]:5111: Primary name data not found
+        // or [string "aos"]:128: some error
+        const match = error.match(/\[string "(.+)"\]:(\d+):\s*(.*)/);
         if (match) {
-            const [, lineNumber, errorMessage] = match;
+            // The first group is the src file, the second is the line number, and the third is the error message
+            const [, , lineNumber, errorMessage] = match;
             const cleanError = removeUnicodeFromError(errorMessage);
             return `${cleanError.trim()} (line ${lineNumber.trim()})`.trim();
         }

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.14.1-alpha.1';
+exports.version = '3.14.1-alpha.2';

package/lib/esm/cli/cli.js

@@ -22,7 +22,7 @@ import { version } from '../version.js';
 import { setAntBaseNameCLICommand, setAntRecordCLICommand, } from './commands/antCommands.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 { getAllGatewayVaults, getAllowedDelegates, getArNSRecord, getArNSReservedName, getArNSReturnedName, getCostDetails, getDelegations, getEpoch, getGateway, getGatewayDelegates, getGatewayVaults, getPrescribedNames, getPrescribedObservers, getPrimaryName, getTokenCost, getVault, listAllDelegatesCLICommand, listArNSRecords, listArNSReservedNames, listArNSReturnedNames, listGateways, resolveArNSName, } from './commands/readCommands.js';
+import { getAllGatewayVaults, getAllowedDelegates, getArNSRecord, getArNSReservedName, getArNSReturnedName, getCostDetails, getDelegations, getEpoch, getGateway, getGatewayDelegates, getGatewayVaults, getPrescribedNames, getPrescribedObservers, getPrimaryName, getTokenCost, getVault, listAllDelegatesCLICommand, listAntsForAddress, listArNSRecords, listArNSReservedNames, listArNSReturnedNames, listGateways, resolveArNSName, } from './commands/readCommands.js';
 import { createVaultCLICommand, extendVaultCLICommand, increaseVaultCLICommand, revokeVaultCLICommand, transferCLICommand, vaultedTransferCLICommand, } from './commands/transfer.js';
 import { addressAndVaultIdOptions, antStateOptions, arnsPurchaseOptions, buyRecordOptions, decreaseDelegateStakeOptions, delegateStakeOptions, epochOptions, getVaultOptions, globalOptions, joinNetworkOptions, operatorStakeOptions, optionMap, paginationAddressOptions, paginationOptions, redelegateStakeOptions, setAntBaseNameOptions, setAntUndernameOptions, tokenCostOptions, transferOptions, updateGatewaySettingsOptions, vaultedTransferOptions, writeActionOptions, } from './options.js';
 import { applyOptions, arioProcessIdFromOptions, assertConfirmationPrompt, customTagsFromOptions, epochInputFromOptions, formatARIOWithCommas, getANTStateFromOptions, getLoggerFromOptions, makeCommand, paginationParamsFromOptions, readANTFromOptions, readARIOFromOptions, requiredAddressFromOptions, requiredAoSignerFromOptions, requiredProcessIdFromOptions, requiredStringArrayFromOptions, requiredStringFromOptions, writeANTFromOptions, } from './utils.js';
@@ -425,6 +425,17 @@ makeCommand({
     options: arnsPurchaseOptions,
     action: requestPrimaryNameCLICommand,
 });
+// # ANT Registry
+makeCommand({
+    name: 'get-ant-registry-acl',
+    description: 'Get the ACL of an ANT registry',
+    options: [
+        optionMap.address,
+        optionMap.antRegistryProcessId,
+        optionMap.hyperbeamUrl,
+    ],
+    action: listAntsForAddress,
+});
 // # ANTS
 // # Getters
 makeCommand({

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

@@ -1,5 +1,5 @@
 import { mARIOToken } from '../../types/token.js';
-import { addressFromOptions, epochInputFromOptions, formatARIOWithCommas, fundFromFromOptions, getTokenCostParamsFromOptions, paginationParamsFromOptions, readARIOFromOptions, requiredAddressFromOptions, requiredStringFromOptions, } from '../utils.js';
+import { addressFromOptions, epochInputFromOptions, formatARIOWithCommas, fundFromFromOptions, getTokenCostParamsFromOptions, paginationParamsFromOptions, readANTRegistryFromOptions, readARIOFromOptions, requiredAddressFromOptions, requiredStringFromOptions, } from '../utils.js';
 export async function getGateway(o) {
     const address = requiredAddressFromOptions(o);
     const gateway = await readARIOFromOptions(o).getGateway({
@@ -170,3 +170,10 @@ export async function resolveArNSName(o) {
     const result = await readARIOFromOptions(o).resolveArNSName({ name });
     return result ?? { message: `No record found for name ${name}` };
 }
+export async function listAntsForAddress(o) {
+    const address = requiredAddressFromOptions(o);
+    const result = await readANTRegistryFromOptions(o).accessControlList({
+        address,
+    });
+    return result ?? { message: `No ANTs found for address ${address}` };
+}

package/lib/esm/cli/options.js

@@ -45,6 +45,14 @@ export const optionMap = {
         alias: '--ario-process-id <arioProcessId>',
         description: 'Run against a custom AR.IO process id',
     },
+    antRegistryProcessId: {
+        alias: '--ant-registry-process-id <antRegistryProcessId>',
+        description: 'Run against a custom ANT registry process id',
+    },
+    hyperbeamUrl: {
+        alias: '--hyperbeam-url <hyperbeamUrl>',
+        description: 'The URL for a custom hyperbeam node',
+    },
     cuUrl: {
         alias: '--cu-url <cuUrl>',
         description: 'The URL for a custom compute unit',

package/lib/esm/cli/utils.js

@@ -18,7 +18,7 @@ import { connect } from '@permaweb/aoconnect';
 import { program } from 'commander';
 import { readFileSync } from 'fs';
 import prompts from 'prompts';
-import { ANT, AOProcess, ARIO, ARIOToken, ARIO_DEVNET_PROCESS_ID, ARIO_MAINNET_PROCESS_ID, ARIO_TESTNET_PROCESS_ID, ArweaveSigner, Logger, createAoSigner, fromB64Url, fundFromOptions, initANTStateForAddress, isValidFundFrom, isValidIntent, mARIOToken, sha256B64Url, validIntents, } from '../node/index.js';
+import { ANT, ANTRegistry, ANT_REGISTRY_ID, AOProcess, ARIO, ARIOToken, ARIO_DEVNET_PROCESS_ID, ARIO_MAINNET_PROCESS_ID, ARIO_TESTNET_PROCESS_ID, ArweaveSigner, Logger, createAoSigner, fromB64Url, fundFromOptions, initANTStateForAddress, isValidFundFrom, isValidIntent, mARIOToken, sha256B64Url, validIntents, } from '../node/index.js';
 import { globalOptions } from './options.js';
 export const defaultTtlSecondsCLI = 3600;
 export function stringifyJsonForCLIDisplay(json) {
@@ -125,6 +125,21 @@ export function readARIOFromOptions(options) {
         paymentUrl: options.paymentUrl,
     });
 }
+export function ANTRegistryProcessFromOptions(options) {
+    return new AOProcess({
+        processId: options.antRegistryProcessId ?? ANT_REGISTRY_ID,
+        ao: connect({
+            MODE: 'legacy',
+            CU_URL: options.cuUrl,
+        }),
+    });
+}
+export function readANTRegistryFromOptions(options) {
+    return ANTRegistry.init({
+        process: ANTRegistryProcessFromOptions(options),
+        hyperbeamUrl: options.hyperbeamUrl,
+    });
+}
 export function contractSignerFromOptions(options) {
     const wallet = walletFromOptions(options);
     if (wallet === undefined) {

package/lib/esm/common/ant-registry.js

@@ -17,6 +17,7 @@ import { ANT_REGISTRY_ID } from '../constants.js';
 import { isProcessConfiguration, isProcessIdConfiguration, } from '../types/index.js';
 import { createAoSigner } from '../utils/ao.js';
 import { AOProcess, InvalidContractConfigurationError } from './index.js';
+import { Logger } from './logger.js';
 export class ANTRegistry {
     static init(config) {
         if (config !== undefined && 'signer' in config) {
@@ -27,7 +28,11 @@ export class ANTRegistry {
 }
 export class AoANTRegistryReadable {
     process;
+    hyperbeamUrl;
+    checkHyperBeamPromise;
+    logger;
     constructor(config) {
+        this.logger = config?.logger ?? Logger.default;
         if (config === undefined || Object.keys(config).length === 0) {
             this.process = new AOProcess({
                 processId: ANT_REGISTRY_ID,
@@ -44,9 +49,63 @@ export class AoANTRegistryReadable {
         else {
             throw new InvalidContractConfigurationError();
         }
+        if (config?.hyperbeamUrl !== undefined) {
+            this.hyperbeamUrl = new URL(config.hyperbeamUrl).toString();
+            this.checkHyperBeamPromise = this.checkHyperBeamCompatibility();
+        }
+    }
+    /**
+     * Check if the process is HyperBeam compatible. If so, we'll use the HyperBeam node to fetch the state.
+     *
+     * @returns {Promise<boolean>} True if the process is HyperBeam compatible, false otherwise.
+     */
+    async checkHyperBeamCompatibility() {
+        if (this.hyperbeamUrl === undefined) {
+            return Promise.resolve(false);
+        }
+        if (this.checkHyperBeamPromise !== undefined) {
+            return this.checkHyperBeamPromise;
+        }
+        this.logger.debug('Checking HyperBeam compatibility');
+        this.checkHyperBeamPromise = fetch(`${this.hyperbeamUrl.toString()}${this.process.processId}~process@1.0/now/cache/acl`, {
+            method: 'HEAD',
+        }).then((res) => {
+            if (res.ok) {
+                this.logger.debug('HyperBeam compatible');
+                return true;
+            }
+            this.logger.debug('HyperBeam not compatible');
+            return false;
+        });
+        return this.checkHyperBeamPromise;
     }
     // Should we rename this to "getANTsByAddress"? seems more clear, though not same as handler name
     async accessControlList({ address, }) {
+        if (await this.checkHyperBeamCompatibility()) {
+            let retries = 0;
+            while (retries < 3) {
+                try {
+                    this.logger.debug('Fetching ant registry acl for address from hyperbeam', address);
+                    const res = await fetch(`${this.hyperbeamUrl?.toString()}${this.process.processId}~process@1.0/now/cache/acl/${address}/serialize~json@1.0`);
+                    if (res.status !== 200) {
+                        this.logger.debug('Failed to fetch ant registry acl for address from hyperbeam', address, res.status, res.statusText);
+                        throw new Error(`Failed to fetch ant registry acl for address ${address}: ${res?.statusText ?? 'Unknown error'}`);
+                    }
+                    this.logger.debug('Fetched ant registry acl for address from hyperbeam', address);
+                    const json = (await res.json());
+                    return {
+                        Owned: json.Owned,
+                        Controlled: json.Controlled,
+                    };
+                }
+                catch (error) {
+                    retries++;
+                    this.logger.debug('Failed to fetch ant registry acl for address from hyperbeam', address, retries);
+                    await new Promise((resolve) => setTimeout(resolve, 1000 * retries ** 2));
+                }
+            }
+        }
+        this.logger.debug('Fetching ant registry acl for address from process', address);
         return this.process.read({
             tags: [
                 { name: 'Action', value: 'Access-Control-List' },

package/lib/esm/utils/ao.js

@@ -236,10 +236,12 @@ export function errorMessageFromOutput(output) {
     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*(.+)/);
+        // Regex to match AO error messages like: [string ".src.main"]:5111: Primary name data not found
+        // or [string "aos"]:128: some error
+        const match = error.match(/\[string "(.+)"\]:(\d+):\s*(.*)/);
         if (match) {
-            const [, lineNumber, errorMessage] = match;
+            // The first group is the src file, the second is the line number, and the third is the error message
+            const [, , lineNumber, errorMessage] = match;
             const cleanError = removeUnicodeFromError(errorMessage);
             return `${cleanError.trim()} (line ${lineNumber.trim()})`.trim();
         }

package/lib/esm/version.js

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

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

@@ -69,3 +69,7 @@ export declare function getAllGatewayVaults(o: PaginationCLIOptions): Promise<im
 }>;
 export declare function getVault(o: AddressAndVaultIdCLIOptions): Promise<import("../../types/io.js").AoVaultData>;
 export declare function resolveArNSName(o: NameCLIOptions): Promise<import("../../types/io.js").ArNSNameResolutionData>;
+export declare function listAntsForAddress(o: AddressCLIOptions): Promise<{
+    Owned: string[];
+    Controlled: string[];
+}>;

package/lib/types/cli/options.d.ts

@@ -41,6 +41,14 @@ export declare const optionMap: {
         alias: string;
         description: string;
     };
+    antRegistryProcessId: {
+        alias: string;
+        description: string;
+    };
+    hyperbeamUrl: {
+        alias: string;
+        description: string;
+    };
     cuUrl: {
         alias: string;
         description: string;

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

@@ -26,6 +26,8 @@ export type GlobalCLIOptions = WalletCLIOptions & {
     mainnet: boolean;
     debug: boolean;
     arioProcessId?: string;
+    antRegistryProcessId?: string;
+    hyperbeamUrl?: string;
     cuUrl?: string;
     paymentUrl?: string;
 };

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

@@ -1,6 +1,6 @@
 import { JWKInterface } from 'arweave/node/lib/wallet.js';
 import { Command, OptionValues } from 'commander';
-import { ARIOToken, AoANTRead, AoANTWrite, AoARIORead, AoARIOWrite, AoGetCostDetailsParams, AoRedelegateStakeParams, AoSigner, AoUpdateGatewaySettingsParams, ContractSigner, EpochInput, FundFrom, Logger, PaginationParams, SpawnANTState, WriteOptions, mARIOToken } from '../node/index.js';
+import { AOProcess, ARIOToken, AoANTRead, AoANTRegistryRead, AoANTWrite, AoARIORead, AoARIOWrite, AoGetCostDetailsParams, AoRedelegateStakeParams, AoSigner, AoUpdateGatewaySettingsParams, ContractSigner, EpochInput, FundFrom, Logger, PaginationParams, SpawnANTState, WriteOptions, mARIOToken } from '../node/index.js';
 import { ANTStateCLIOptions, AddressCLIOptions, EpochCLIOptions, GetTokenCostCLIOptions, GlobalCLIOptions, InitiatorCLIOptions, JsonSerializable, PaginationCLIOptions, ProcessIdCLIOptions, RedelegateStakeCLIOptions, TransferCLIOptions, UpdateGatewaySettingsCLIOptions, WalletCLIOptions, WriteActionCLIOptions } from './types.js';
 export declare const defaultTtlSecondsCLI = 3600;
 export declare function stringifyJsonForCLIDisplay(json: JsonSerializable | unknown): string;
@@ -22,6 +22,8 @@ export declare function requiredJwkFromOptions(options: WalletCLIOptions): JWKIn
 export declare function jwkToAddress(jwk: JWKInterface): string;
 export declare function getLoggerFromOptions(options: GlobalCLIOptions): Logger;
 export declare function readARIOFromOptions(options: GlobalCLIOptions): AoARIORead;
+export declare function ANTRegistryProcessFromOptions(options: ProcessIdCLIOptions): AOProcess;
+export declare function readANTRegistryFromOptions(options: ProcessIdCLIOptions): AoANTRegistryRead;
 export declare function contractSignerFromOptions(options: WalletCLIOptions): {
     signer: ContractSigner;
     signerAddress: string;

package/lib/types/common/ant-registry.d.ts

@@ -1,8 +1,14 @@
 import { AoANTRegistryRead, AoANTRegistryWrite } from '../types/ant-registry.js';
 import { AoMessageResult, ProcessConfiguration, WithSigner } from '../types/index.js';
 import { AOProcess } from './index.js';
-type ANTRegistryNoSigner = ProcessConfiguration;
-type ANTRegistryWithSigner = WithSigner<ProcessConfiguration>;
+import { ILogger } from './logger.js';
+type ANTRegistryProcessConfig = Required<ProcessConfiguration> & {
+    strict?: boolean;
+    hyperbeamUrl?: string;
+    logger?: ILogger;
+};
+type ANTRegistryNoSigner = ANTRegistryProcessConfig;
+type ANTRegistryWithSigner = WithSigner<ANTRegistryProcessConfig>;
 export declare class ANTRegistry {
     static init(): AoANTRegistryRead;
     static init(config: ANTRegistryNoSigner): AoANTRegistryRead;
@@ -10,7 +16,18 @@ export declare class ANTRegistry {
 }
 export declare class AoANTRegistryReadable implements AoANTRegistryRead {
     protected process: AOProcess;
-    constructor(config?: ProcessConfiguration);
+    private hyperbeamUrl;
+    private checkHyperBeamPromise;
+    private logger;
+    constructor(config?: ANTRegistryProcessConfig & {
+        logger?: ILogger;
+    });
+    /**
+     * Check if the process is HyperBeam compatible. If so, we'll use the HyperBeam node to fetch the state.
+     *
+     * @returns {Promise<boolean>} True if the process is HyperBeam compatible, false otherwise.
+     */
+    private checkHyperBeamCompatibility;
     accessControlList({ address, }: {
         address: string;
     }): Promise<{
@@ -20,7 +37,7 @@ export declare class AoANTRegistryReadable implements AoANTRegistryRead {
 }
 export declare class AoANTRegistryWriteable extends AoANTRegistryReadable implements AoANTRegistryWrite {
     private signer;
-    constructor({ signer, ...config }: WithSigner<ProcessConfiguration>);
+    constructor({ signer, ...config }: WithSigner<ANTRegistryProcessConfig>);
     register({ processId, }: {
         processId: string;
     }): Promise<AoMessageResult>;

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.14.0";
+export declare const version = "3.14.1-alpha.1";

package/package.json

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