@ar.io/sdk 2.0.2 → 2.1.0-alpha.1

package/lib/cjs/constants.js

@@ -30,5 +30,5 @@ exports.ioDevnetProcessId = exports.IO_DEVNET_PROCESS_ID;
 exports.IO_TESTNET_PROCESS_ID = 'agYcCFJtrMG6cqMuZfskIkFTGvUPddICmtQSBIoPdiA';
 exports.MIO_PER_IO = 1_000_000;
 exports.AOS_MODULE_ID = 'cbn0KKrBZH7hdNkNokuXLtGryrWM--PjSTBqIzw9Kkk';
-exports.ANT_LUA_ID = '3OlGzE5mrsN2GsxCYM0Tae1KzWepGOr5a94deOWmApM';
+exports.ANT_LUA_ID = 'Flwio4Lr08g6s6uim6lEJNnVGD9ylvz0_aafvpiL8FI';
 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.spawnANT = void 0;
+exports.evolveANT = exports.spawnANT = void 0;
 /**
  * Copyright (C) 2022-2024 Permanent Data Solutions, Inc. All Rights Reserved.
  *
@@ -60,3 +60,25 @@ async function spawnANT({ signer, module = constants_js_1.AOS_MODULE_ID, luaCode
     return processId;
 }
 exports.spawnANT = spawnANT;
+async function evolveANT({ signer, processId, luaCodeTxId = constants_js_1.ANT_LUA_ID, ao = (0, aoconnect_1.connect)(), }) {
+    const aosClient = new index_js_1.AOProcess({
+        processId,
+        ao,
+    });
+    //TODO: cache locally and only fetch if not cached
+    const luaString = (await arweave_js_1.defaultArweave.transactions.getData(luaCodeTxId, {
+        decode: true,
+        string: true,
+    }));
+    const { id } = await aosClient.send({
+        tags: [
+            { name: 'Action', value: 'Eval' },
+            { name: 'App-Name', value: 'ArNS-ANT' },
+            { name: 'Source-Code-TX-ID', value: luaCodeTxId },
+        ],
+        data: luaString,
+        signer,
+    });
+    return id;
+}
+exports.evolveANT = evolveANT;

package/lib/cjs/utils/processes.js

@@ -21,6 +21,7 @@ const eventemitter3_1 = require("eventemitter3");
 const plimit_lit_1 = require("plimit-lit");
 const ant_js_1 = require("../common/ant.js");
 const io_js_1 = require("../common/io.js");
+const logger_js_1 = require("../common/logger.js");
 const constants_js_1 = require("../constants.js");
 const getANTProcessesOwnedByWallet = async ({ address, contract = io_js_1.IO.init({
     processId: constants_js_1.IO_TESTNET_PROCESS_ID,
@@ -71,19 +72,25 @@ class ArNSEventEmitter extends eventemitter3_1.EventEmitter {
     contract;
     timeoutMs; // timeout for each request to 3 seconds
     throttle;
+    logger;
     constructor({ contract = io_js_1.IO.init({
         processId: constants_js_1.IO_TESTNET_PROCESS_ID,
-    }), timeoutMs = 60_000, concurrency = 30, }) {
+    }), timeoutMs = 60_000, concurrency = 30, logger = logger_js_1.Logger.default, } = {}) {
         super();
         this.contract = contract;
         this.timeoutMs = timeoutMs;
         this.throttle = (0, plimit_lit_1.pLimit)(concurrency);
+        this.logger = logger;
     }
     async fetchProcessesOwnedByWallet({ address }) {
         const uniqueContractProcessIds = {};
-        await timeout(this.timeoutMs, (0, exports.fetchAllArNSRecords)({ contract: this.contract }))
+        await timeout(this.timeoutMs, (0, exports.fetchAllArNSRecords)({ contract: this.contract, emitter: this }))
             .catch((e) => {
             this.emit('error', `Error getting ArNS records: ${e}`);
+            this.logger.error(`Error getting ArNS records`, {
+                message: e?.message,
+                stack: e?.stack,
+            });
             return {};
         })
             .then((records) => {
@@ -103,8 +110,8 @@ class ArNSEventEmitter extends eventemitter3_1.EventEmitter {
             });
         });
         const idCount = Object.keys(uniqueContractProcessIds).length;
-        // check the contract owner and controllers
         this.emit('progress', 0, idCount);
+        // check the contract owner and controllers
         await Promise.all(Object.keys(uniqueContractProcessIds).map(async (processId, i) => this.throttle(async () => {
             if (uniqueContractProcessIds[processId].state !== undefined) {
                 this.emit('progress', i + 1, idCount);
@@ -130,8 +137,9 @@ class ArNSEventEmitter extends eventemitter3_1.EventEmitter {
 exports.ArNSEventEmitter = ArNSEventEmitter;
 const fetchAllArNSRecords = async ({ contract = io_js_1.IO.init({
     processId: constants_js_1.IO_TESTNET_PROCESS_ID,
-}), logger, }) => {
+}), emitter, logger = logger_js_1.Logger.default, }) => {
     let cursor;
+    const startTimestamp = Date.now();
     const records = {};
     do {
         const pageResult = await contract
@@ -141,6 +149,7 @@ const fetchAllArNSRecords = async ({ contract = io_js_1.IO.init({
                 message: e?.message,
                 stack: e?.stack,
             });
+            emitter?.emit('arns:error', `Error getting ArNS records: ${e}`);
             return undefined;
         });
         if (!pageResult) {
@@ -150,8 +159,24 @@ const fetchAllArNSRecords = async ({ contract = io_js_1.IO.init({
             const { name, ...recordDetails } = record;
             records[name] = recordDetails;
         });
+        logger.debug('Fetched page of ArNS records', {
+            totalRecordCount: pageResult.totalItems,
+            fetchedRecordCount: Object.keys(records).length,
+            cursor: pageResult.nextCursor,
+        });
+        emitter?.emit('arns:pageLoaded', {
+            totalRecordCount: pageResult.totalItems,
+            fetchedRecordCount: Object.keys(records).length,
+            records: pageResult.items,
+            cursor: pageResult.nextCursor,
+        });
         cursor = pageResult.nextCursor;
     } while (cursor !== undefined);
+    emitter?.emit('arns:end', records);
+    logger.debug('Fetched all ArNS records', {
+        totalRecordCount: Object.keys(records).length,
+        durationMs: Date.now() - startTimestamp,
+    });
     return records;
 };
 exports.fetchAllArNSRecords = fetchAllArNSRecords;

package/lib/cjs/version.js

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

package/lib/esm/constants.js

@@ -27,5 +27,5 @@ export const ioDevnetProcessId = IO_DEVNET_PROCESS_ID;
 export const IO_TESTNET_PROCESS_ID = 'agYcCFJtrMG6cqMuZfskIkFTGvUPddICmtQSBIoPdiA';
 export const MIO_PER_IO = 1_000_000;
 export const AOS_MODULE_ID = 'cbn0KKrBZH7hdNkNokuXLtGryrWM--PjSTBqIzw9Kkk';
-export const ANT_LUA_ID = '3OlGzE5mrsN2GsxCYM0Tae1KzWepGOr5a94deOWmApM';
+export const ANT_LUA_ID = 'Flwio4Lr08g6s6uim6lEJNnVGD9ylvz0_aafvpiL8FI';
 export const DEFAULT_SCHEDULER_ID = '_GQ33BkPtZrqxA84vM8Zk-N2aO0toNNu_C-l-rawrBA';

package/lib/esm/utils/ao.js

@@ -56,3 +56,24 @@ export async function spawnANT({ signer, module = AOS_MODULE_ID, luaCodeTxId = A
     }
     return processId;
 }
+export async function evolveANT({ signer, processId, luaCodeTxId = ANT_LUA_ID, ao = connect(), }) {
+    const aosClient = new AOProcess({
+        processId,
+        ao,
+    });
+    //TODO: cache locally and only fetch if not cached
+    const luaString = (await defaultArweave.transactions.getData(luaCodeTxId, {
+        decode: true,
+        string: true,
+    }));
+    const { id } = await aosClient.send({
+        tags: [
+            { name: 'Action', value: 'Eval' },
+            { name: 'App-Name', value: 'ArNS-ANT' },
+            { name: 'Source-Code-TX-ID', value: luaCodeTxId },
+        ],
+        data: luaString,
+        signer,
+    });
+    return id;
+}

package/lib/esm/utils/processes.js

@@ -18,6 +18,7 @@ import { EventEmitter } from 'eventemitter3';
 import { pLimit } from 'plimit-lit';
 import { ANT } from '../common/ant.js';
 import { IO } from '../common/io.js';
+import { Logger } from '../common/logger.js';
 import { IO_TESTNET_PROCESS_ID } from '../constants.js';
 export const getANTProcessesOwnedByWallet = async ({ address, contract = IO.init({
     processId: IO_TESTNET_PROCESS_ID,
@@ -67,19 +68,25 @@ export class ArNSEventEmitter extends EventEmitter {
     contract;
     timeoutMs; // timeout for each request to 3 seconds
     throttle;
+    logger;
     constructor({ contract = IO.init({
         processId: IO_TESTNET_PROCESS_ID,
-    }), timeoutMs = 60_000, concurrency = 30, }) {
+    }), timeoutMs = 60_000, concurrency = 30, logger = Logger.default, } = {}) {
         super();
         this.contract = contract;
         this.timeoutMs = timeoutMs;
         this.throttle = pLimit(concurrency);
+        this.logger = logger;
     }
     async fetchProcessesOwnedByWallet({ address }) {
         const uniqueContractProcessIds = {};
-        await timeout(this.timeoutMs, fetchAllArNSRecords({ contract: this.contract }))
+        await timeout(this.timeoutMs, fetchAllArNSRecords({ contract: this.contract, emitter: this }))
             .catch((e) => {
             this.emit('error', `Error getting ArNS records: ${e}`);
+            this.logger.error(`Error getting ArNS records`, {
+                message: e?.message,
+                stack: e?.stack,
+            });
             return {};
         })
             .then((records) => {
@@ -99,8 +106,8 @@ export class ArNSEventEmitter extends EventEmitter {
             });
         });
         const idCount = Object.keys(uniqueContractProcessIds).length;
-        // check the contract owner and controllers
         this.emit('progress', 0, idCount);
+        // check the contract owner and controllers
         await Promise.all(Object.keys(uniqueContractProcessIds).map(async (processId, i) => this.throttle(async () => {
             if (uniqueContractProcessIds[processId].state !== undefined) {
                 this.emit('progress', i + 1, idCount);
@@ -125,8 +132,9 @@ export class ArNSEventEmitter extends EventEmitter {
 }
 export const fetchAllArNSRecords = async ({ contract = IO.init({
     processId: IO_TESTNET_PROCESS_ID,
-}), logger, }) => {
+}), emitter, logger = Logger.default, }) => {
     let cursor;
+    const startTimestamp = Date.now();
     const records = {};
     do {
         const pageResult = await contract
@@ -136,6 +144,7 @@ export const fetchAllArNSRecords = async ({ contract = IO.init({
                 message: e?.message,
                 stack: e?.stack,
             });
+            emitter?.emit('arns:error', `Error getting ArNS records: ${e}`);
             return undefined;
         });
         if (!pageResult) {
@@ -145,7 +154,23 @@ export const fetchAllArNSRecords = async ({ contract = IO.init({
             const { name, ...recordDetails } = record;
             records[name] = recordDetails;
         });
+        logger.debug('Fetched page of ArNS records', {
+            totalRecordCount: pageResult.totalItems,
+            fetchedRecordCount: Object.keys(records).length,
+            cursor: pageResult.nextCursor,
+        });
+        emitter?.emit('arns:pageLoaded', {
+            totalRecordCount: pageResult.totalItems,
+            fetchedRecordCount: Object.keys(records).length,
+            records: pageResult.items,
+            cursor: pageResult.nextCursor,
+        });
         cursor = pageResult.nextCursor;
     } while (cursor !== undefined);
+    emitter?.emit('arns:end', records);
+    logger.debug('Fetched all ArNS records', {
+        totalRecordCount: Object.keys(records).length,
+        durationMs: Date.now() - startTimestamp,
+    });
     return records;
 };

package/lib/esm/version.js

@@ -15,4 +15,4 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 // AUTOMATICALLY GENERATED FILE - DO NOT TOUCH
-export const version = '2.0.2';
+export const version = '2.1.0-alpha.1';

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

@@ -31,6 +31,7 @@ export declare class AoANTReadable implements AoANTRead {
         Ticker: string;
         Denomination: number;
         Owner: string;
+        ['Source-Code-TX-ID']?: string;
     }>;
     /**
      * @param undername @type {string} The domain name.

package/lib/types/constants.d.ts

@@ -25,5 +25,5 @@ export declare const ioDevnetProcessId = "GaQrvEMKBpkjofgnBi_B3IgIDmY_XYelVLB6Gc
 export declare const IO_TESTNET_PROCESS_ID = "agYcCFJtrMG6cqMuZfskIkFTGvUPddICmtQSBIoPdiA";
 export declare const MIO_PER_IO = 1000000;
 export declare const AOS_MODULE_ID = "cbn0KKrBZH7hdNkNokuXLtGryrWM--PjSTBqIzw9Kkk";
-export declare const ANT_LUA_ID = "3OlGzE5mrsN2GsxCYM0Tae1KzWepGOr5a94deOWmApM";
+export declare const ANT_LUA_ID = "Flwio4Lr08g6s6uim6lEJNnVGD9ylvz0_aafvpiL8FI";
 export declare const DEFAULT_SCHEDULER_ID = "_GQ33BkPtZrqxA84vM8Zk-N2aO0toNNu_C-l-rawrBA";

package/lib/types/io.d.ts

@@ -158,6 +158,7 @@ export interface AoANTRead {
         Ticker: string;
         Denomination: number;
         Owner: string;
+        ['Source-Code-TX-ID']?: string;
     }>;
     getRecord({ undername }: {
         undername: any;

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

@@ -9,3 +9,9 @@ export declare function spawnANT({ signer, module, luaCodeTxId, ao, scheduler, s
     state?: ANTState;
     stateContractTxId?: string;
 }): Promise<string>;
+export declare function evolveANT({ signer, processId, luaCodeTxId, ao, }: {
+    signer: ContractSigner;
+    processId: string;
+    luaCodeTxId?: string;
+    ao?: AoClient;
+}): Promise<string>;

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

@@ -25,16 +25,19 @@ export declare class ArNSEventEmitter extends EventEmitter {
     protected contract: AoIORead;
     private timeoutMs;
     private throttle;
-    constructor({ contract, timeoutMs, concurrency, }: {
+    private logger;
+    constructor({ contract, timeoutMs, concurrency, logger, }?: {
         contract?: AoIORead;
         timeoutMs?: number;
         concurrency?: number;
+        logger?: ILogger;
     });
     fetchProcessesOwnedByWallet({ address }: {
         address: WalletAddress;
     }): Promise<void>;
 }
-export declare const fetchAllArNSRecords: ({ contract, logger, }: {
+export declare const fetchAllArNSRecords: ({ contract, emitter, logger, }: {
     contract?: AoIORead;
+    emitter?: EventEmitter;
     logger?: ILogger;
 }) => Promise<Record<string, AoArNSNameData>>;

package/lib/types/version.d.ts

@@ -14,4 +14,4 @@
  * You should have received a copy of the GNU Affero General Public License
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
-export declare const version = "2.0.1";
+export declare const version = "2.0.3-alpha.1";

package/package.json

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