@ar.io/sdk 3.18.2-alpha.1 → 3.19.0-alpha.1

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

@@ -71,7 +71,9 @@ class AoANTRegistryReadable {
             return this.checkHyperBeamPromise;
         }
         this.logger.debug('Checking HyperBeam compatibility');
-        this.checkHyperBeamPromise = fetch(`${this.hyperbeamUrl.toString()}${this.process.processId}~process@1.0/now/cache/acl`, {
+        this.checkHyperBeamPromise = fetch(
+        // use /now to force a refresh of the cache state, then compute when calling it for keys
+        `${this.hyperbeamUrl.toString()}${this.process.processId}~process@1.0/now/cache/acl`, {
             method: 'HEAD',
             signal: AbortSignal.timeout(5000), // 5 second timeout
         })
@@ -98,7 +100,7 @@ class AoANTRegistryReadable {
             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`);
+                    const res = await fetch(`${this.hyperbeamUrl?.toString()}${this.process.processId}~process@1.0/compute/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'}`);

package/lib/cjs/common/ant.js

@@ -37,7 +37,12 @@ class ANT {
      * Spawn a new ANT.
      */
     static spawn = ao_js_1.spawnANT;
-    // implementation
+    /**
+     * Fork an ANT to a new process.
+     *
+     * @param config
+     */
+    static fork = ao_js_1.forkANT;
     static init(config) {
         if (config !== undefined && 'signer' in config) {
             return new AoANTWriteable(config);
@@ -89,7 +94,9 @@ class AoANTReadable {
         if (this.checkHyperBeamPromise !== undefined) {
             return this.checkHyperBeamPromise;
         }
-        this.checkHyperBeamPromise = fetch(`${this.hyperbeamUrl.toString()}${this.processId}~process@1.0/now/cache`, {
+        this.checkHyperBeamPromise = fetch(
+        // use /now to force a refresh of the cache state, then compute when calling it for keys
+        `${this.hyperbeamUrl.toString()}${this.processId}~process@1.0/now/cache`, {
             method: 'HEAD',
             signal: AbortSignal.timeout(5000), // 5 second timeout
         })

package/lib/cjs/constants.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-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_MAINNET_PROCESS_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_MAINNET_PROCESS_ID = exports.ARIO_TESTNET_PROCESS_ID = exports.arioDevnetProcessId = exports.ARIO_DEVNET_PROCESS_ID = exports.FQDN_REGEX = exports.ARWEAVE_TX_REGEX = void 0;
 /**
  * Copyright (C) 2022-2024 Permanent Data Solutions, Inc.
  *
@@ -19,10 +19,6 @@ exports.DEFAULT_SCHEDULER_ID = exports.AO_AUTHORITY = exports.ANT_LUA_ID = expor
 exports.ARWEAVE_TX_REGEX = new RegExp('^[a-zA-Z0-9_-]{43}$');
 /** FQDN regex that matches the one used in the ArNS contract. */
 exports.FQDN_REGEX = new RegExp('^(?:(?!-)[A-Za-z0-9-]{1,63}(?<!-)\\.)+[A-Za-z]{1,63}$');
-// sortkey: padded blockheight to 12, JS timestamp, hash of transactionID + block hash. Timestamp only applicable to L2 and normally is all zeros.
-exports.SORT_KEY_REGEX = new RegExp('^[0-9]{12},[0-9]{13},[a-fA-F0-9]{64}$');
-exports.ARNS_TESTNET_REGISTRY_TX = process.env.ARNS_REGISTRY_TX ?? 'bLAgYxAdX2Ry-nt6aH2ixgvJXbpsEYm28NgJgyqfs-U';
-exports.ARNS_DEVNET_REGISTRY_TX = '_NctcA2sRy1-J4OmIQZbYFPM17piNcbdBPH2ncX2RL8';
 exports.ARIO_DEVNET_PROCESS_ID = 'GaQrvEMKBpkjofgnBi_B3IgIDmY_XYelVLB6GcRGrHc';
 // backwards compatibility - TODO: remove in v2.0.0
 exports.arioDevnetProcessId = exports.ARIO_DEVNET_PROCESS_ID;

package/lib/cjs/utils/ao.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.defaultANTLogoId = exports.defaultTargetManifestId = void 0;
 exports.spawnANT = spawnANT;
+exports.forkANT = forkANT;
 exports.evolveANT = evolveANT;
 exports.isAoSigner = isAoSigner;
 exports.createAoSigner = createAoSigner;
@@ -222,7 +223,40 @@ async function spawnANT({ signer, module, ao = (0, aoconnect_1.connect)({
     }
     return processId;
 }
-// TODO: add a utility for forking an ANT to the latest module that leverages getState and spawnANT
+async function forkANT({ signer, antProcessId, logger = index_js_1.Logger.default, ao, antRegistryId = constants_js_1.ANT_REGISTRY_ID, onSigningProgress = (name, payload) => {
+    logger.debug('Forking ANT', { name, payload });
+}, }) {
+    // get the state of the current ANT and use it to spawn a new ANT
+    const ant = index_js_1.ANT.init({
+        process: new index_js_1.AOProcess({
+            processId: antProcessId,
+            ao,
+            logger,
+        }),
+    });
+    const state = await ant.getState();
+    if (state === undefined) {
+        throw new Error(`ANT state (${antProcessId}) is undefined and cannot be upgraded`);
+    }
+    const forkedProcessId = await spawnANT({
+        signer,
+        antRegistryId,
+        logger,
+        onSigningProgress,
+        state: {
+            owner: state.Owner,
+            name: state.Name,
+            ticker: state.Ticker,
+            description: state.Description,
+            keywords: state.Keywords,
+            controllers: state.Controllers,
+            records: state.Records,
+            balances: state.Balances,
+            logo: state.Logo,
+        },
+    });
+    return forkedProcessId;
+}
 /**
  * @deprecated
  * Direct Evals are not encouraged when dealing with ANTs.

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.18.2-alpha.1';
+exports.version = '3.19.0-alpha.1';

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

@@ -67,7 +67,9 @@ export class AoANTRegistryReadable {
             return this.checkHyperBeamPromise;
         }
         this.logger.debug('Checking HyperBeam compatibility');
-        this.checkHyperBeamPromise = fetch(`${this.hyperbeamUrl.toString()}${this.process.processId}~process@1.0/now/cache/acl`, {
+        this.checkHyperBeamPromise = fetch(
+        // use /now to force a refresh of the cache state, then compute when calling it for keys
+        `${this.hyperbeamUrl.toString()}${this.process.processId}~process@1.0/now/cache/acl`, {
             method: 'HEAD',
             signal: AbortSignal.timeout(5000), // 5 second timeout
         })
@@ -94,7 +96,7 @@ export class AoANTRegistryReadable {
             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`);
+                    const res = await fetch(`${this.hyperbeamUrl?.toString()}${this.process.processId}~process@1.0/compute/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'}`);

package/lib/esm/common/ant.js

@@ -17,7 +17,7 @@ import { z } from 'zod';
 import { AntBalancesSchema, AntControllersSchema, AntInfoSchema, AntRecordSchema, AntRecordsSchema, AntStateSchema, } from '../types/ant.js';
 import { isProcessConfiguration, isProcessIdConfiguration, } from '../types/index.js';
 import { convertHyperBeamStateToAoANTState, isHyperBeamANTState, sortANTRecords, } from '../utils/ant.js';
-import { createAoSigner, spawnANT } from '../utils/ao.js';
+import { createAoSigner, forkANT, spawnANT } from '../utils/ao.js';
 import { parseSchemaResult } from '../utils/schema.js';
 import { ANTVersions } from './ant-versions.js';
 import { AOProcess, InvalidContractConfigurationError, Logger, } from './index.js';
@@ -34,7 +34,12 @@ export class ANT {
      * Spawn a new ANT.
      */
     static spawn = spawnANT;
-    // implementation
+    /**
+     * Fork an ANT to a new process.
+     *
+     * @param config
+     */
+    static fork = forkANT;
     static init(config) {
         if (config !== undefined && 'signer' in config) {
             return new AoANTWriteable(config);
@@ -85,7 +90,9 @@ export class AoANTReadable {
         if (this.checkHyperBeamPromise !== undefined) {
             return this.checkHyperBeamPromise;
         }
-        this.checkHyperBeamPromise = fetch(`${this.hyperbeamUrl.toString()}${this.processId}~process@1.0/now/cache`, {
+        this.checkHyperBeamPromise = fetch(
+        // use /now to force a refresh of the cache state, then compute when calling it for keys
+        `${this.hyperbeamUrl.toString()}${this.processId}~process@1.0/now/cache`, {
             method: 'HEAD',
             signal: AbortSignal.timeout(5000), // 5 second timeout
         })

package/lib/esm/constants.js

@@ -16,10 +16,6 @@
 export const ARWEAVE_TX_REGEX = new RegExp('^[a-zA-Z0-9_-]{43}$');
 /** FQDN regex that matches the one used in the ArNS contract. */
 export const FQDN_REGEX = new RegExp('^(?:(?!-)[A-Za-z0-9-]{1,63}(?<!-)\\.)+[A-Za-z]{1,63}$');
-// sortkey: padded blockheight to 12, JS timestamp, hash of transactionID + block hash. Timestamp only applicable to L2 and normally is all zeros.
-export const SORT_KEY_REGEX = new RegExp('^[0-9]{12},[0-9]{13},[a-fA-F0-9]{64}$');
-export const ARNS_TESTNET_REGISTRY_TX = process.env.ARNS_REGISTRY_TX ?? 'bLAgYxAdX2Ry-nt6aH2ixgvJXbpsEYm28NgJgyqfs-U';
-export const ARNS_DEVNET_REGISTRY_TX = '_NctcA2sRy1-J4OmIQZbYFPM17piNcbdBPH2ncX2RL8';
 export const ARIO_DEVNET_PROCESS_ID = 'GaQrvEMKBpkjofgnBi_B3IgIDmY_XYelVLB6GcRGrHc';
 // backwards compatibility - TODO: remove in v2.0.0
 export const arioDevnetProcessId = ARIO_DEVNET_PROCESS_ID;

package/lib/esm/utils/ao.js

@@ -19,7 +19,7 @@ import { z } from 'zod';
 import { ANTRegistry } from '../common/ant-registry.js';
 import { ANTVersions } from '../common/ant-versions.js';
 import { defaultArweave } from '../common/arweave.js';
-import { AOProcess, Logger } from '../common/index.js';
+import { ANT, AOProcess, Logger } from '../common/index.js';
 import { ANT_LUA_ID, ANT_REGISTRY_ID, AO_AUTHORITY, DEFAULT_SCHEDULER_ID, } from '../constants.js';
 import { SpawnANTStateSchema } from '../types/ant.js';
 import { parseSchemaResult } from './schema.js';
@@ -211,7 +211,40 @@ export async function spawnANT({ signer, module, ao = connect({
     }
     return processId;
 }
-// TODO: add a utility for forking an ANT to the latest module that leverages getState and spawnANT
+export async function forkANT({ signer, antProcessId, logger = Logger.default, ao, antRegistryId = ANT_REGISTRY_ID, onSigningProgress = (name, payload) => {
+    logger.debug('Forking ANT', { name, payload });
+}, }) {
+    // get the state of the current ANT and use it to spawn a new ANT
+    const ant = ANT.init({
+        process: new AOProcess({
+            processId: antProcessId,
+            ao,
+            logger,
+        }),
+    });
+    const state = await ant.getState();
+    if (state === undefined) {
+        throw new Error(`ANT state (${antProcessId}) is undefined and cannot be upgraded`);
+    }
+    const forkedProcessId = await spawnANT({
+        signer,
+        antRegistryId,
+        logger,
+        onSigningProgress,
+        state: {
+            owner: state.Owner,
+            name: state.Name,
+            ticker: state.Ticker,
+            description: state.Description,
+            keywords: state.Keywords,
+            controllers: state.Controllers,
+            records: state.Records,
+            balances: state.Balances,
+            logo: state.Logo,
+        },
+    });
+    return forkedProcessId;
+}
 /**
  * @deprecated
  * Direct Evals are not encouraged when dealing with ANTs.

package/lib/esm/version.js

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

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

@@ -1,6 +1,6 @@
 import { AntReadOptions, AoANTHandler, AoANTInfo, AoANTRead, AoANTRecord, AoANTSetBaseNameRecordParams, AoANTSetUndernameRecordParams, AoANTState, AoANTWrite, SortedANTRecords } from '../types/ant.js';
 import { AoMessageResult, ProcessConfiguration, WalletAddress, WithSigner, WriteOptions } from '../types/index.js';
-import { spawnANT } from '../utils/ao.js';
+import { forkANT, spawnANT } from '../utils/ao.js';
 import { AOProcess } from './index.js';
 type ANTConfigOptionalStrict = Required<ProcessConfiguration> & {
     strict?: boolean;
@@ -19,6 +19,17 @@ export declare class ANT {
      * Spawn a new ANT.
      */
     static spawn: typeof spawnANT;
+    /**
+     * Fork an ANT to a new process.
+     *
+     * @param config
+     */
+    static fork: typeof forkANT;
+    /**
+     * Initialize overloads.
+     *
+     * @param config
+     */
     static init(config: ANTConfigNoSigner): AoANTRead;
     static init(config: ANTConfigWithSigner): AoANTWrite;
 }

package/lib/types/constants.d.ts

@@ -16,9 +16,6 @@
 export declare const ARWEAVE_TX_REGEX: RegExp;
 /** FQDN regex that matches the one used in the ArNS contract. */
 export declare const FQDN_REGEX: RegExp;
-export declare const SORT_KEY_REGEX: RegExp;
-export declare const ARNS_TESTNET_REGISTRY_TX: string;
-export declare const ARNS_DEVNET_REGISTRY_TX = "_NctcA2sRy1-J4OmIQZbYFPM17piNcbdBPH2ncX2RL8";
 export declare const ARIO_DEVNET_PROCESS_ID = "GaQrvEMKBpkjofgnBi_B3IgIDmY_XYelVLB6GcRGrHc";
 export declare const arioDevnetProcessId = "GaQrvEMKBpkjofgnBi_B3IgIDmY_XYelVLB6GcRGrHc";
 export declare const ARIO_TESTNET_PROCESS_ID = "agYcCFJtrMG6cqMuZfskIkFTGvUPddICmtQSBIoPdiA";

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

@@ -30,6 +30,14 @@ export type SpawnANTParams = {
     onSigningProgress?: (name: keyof SpawnAntProgressEvent, payload: SpawnAntProgressEvent[keyof SpawnAntProgressEvent]) => void;
 };
 export declare function spawnANT({ signer, module, ao, scheduler, state, tags, antRegistryId, logger, authority, onSigningProgress, }: SpawnANTParams): Promise<ProcessId>;
+export declare function forkANT({ signer, antProcessId, logger, ao, antRegistryId, onSigningProgress, }: {
+    signer: AoSigner;
+    antProcessId: string;
+    logger?: Logger;
+    ao?: AoClient;
+    antRegistryId?: string;
+    onSigningProgress?: (name: keyof SpawnAntProgressEvent, payload: SpawnAntProgressEvent[keyof SpawnAntProgressEvent]) => void;
+}): Promise<string>;
 /**
  * @deprecated
  * Direct Evals are not encouraged when dealing with ANTs.

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.18.1";
+export declare const version = "3.18.2";

package/package.json

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