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

package/lib/esm/common/io.js

@@ -57,31 +57,47 @@ export class IOReadable {
         }
         this.arweave = arweave;
     }
-    async getEpoch(epoch) {
+    async getInfo() {
+        return this.process.read({
+            tags: [{ name: 'Action', value: 'Info' }],
+        });
+    }
+    async getEpochSettings(params) {
         const allTags = [
-            { name: 'Action', value: 'Epoch' },
+            { name: 'Action', value: 'Epoch-Settings' },
             {
-                // TODO: default this to the current network time
                 name: 'Timestamp',
-                value: epoch.timestamp?.toString() ?? '',
+                value: params?.timestamp?.toString() ??
+                    (await this.arweave.blocks.getCurrent().catch(() => {
+                        return { timestamp: Date.now() }; // fallback to current time
+                    })).timestamp.toString(),
+            },
+            {
+                name: 'Epoch-Index',
+                value: params?.epochIndex?.toString(),
             },
+        ];
+        const prunedTags = allTags.filter((tag) => tag.value !== undefined);
+        return this.process.read({
+            tags: prunedTags,
+        });
+    }
+    async getEpoch(epoch) {
+        const allTags = [
+            { name: 'Action', value: 'Epoch' },
             {
-                name: 'BlockHeight',
-                value: epoch?.blockHeight?.toString(),
+                name: 'Timestamp',
+                value: epoch?.timestamp?.toString() ??
+                    (await this.arweave.blocks.getCurrent().catch(() => {
+                        return { timestamp: Date.now() }; // fallback to current time
+                    })).timestamp.toString(),
             },
             {
-                name: 'EpochIndex',
+                name: 'Epoch-Index',
                 value: epoch?.epochIndex?.toString(),
             },
         ];
         const prunedTags = allTags.filter((tag) => tag.value !== undefined);
-        // if it only contains the action, add default timestamp
-        if (prunedTags.length === 1) {
-            prunedTags.push({
-                name: 'Timestamp',
-                value: (await this.arweave.blocks.getCurrent()).timestamp.toString(),
-            });
-        }
         return this.process.read({
             tags: prunedTags,
         });
@@ -101,13 +117,13 @@ export class IOReadable {
     }
     async getArNSReservedNames() {
         return this.process.read({
-            tags: [{ name: 'Action', value: 'ReservedNames' }],
+            tags: [{ name: 'Action', value: 'Reserved-Names' }],
         });
     }
     async getArNSReservedName({ name, }) {
         return this.process.read({
             tags: [
-                { name: 'Action', value: 'ReservedName' },
+                { name: 'Action', value: 'Reserved-Name' },
                 { name: 'Name', value: name },
             ],
         });
@@ -142,118 +158,126 @@ export class IOReadable {
         return this.process.read({
             tags: [
                 { name: 'Action', value: 'Epoch' },
-                { name: 'Timestamp', value: `${Date.now()}` },
+                {
+                    name: 'Timestamp',
+                    value: (await this.arweave.blocks.getCurrent().catch(() => {
+                        return { timestamp: Date.now() }; // fallback to current time
+                    })).timestamp.toString(),
+                },
             ],
         });
     }
     async getPrescribedObservers(epoch) {
         const allTags = [
-            { name: 'Action', value: 'EpochPrescribedObservers' },
+            { name: 'Action', value: 'Epoch-Prescribed-Observers' },
             {
                 name: 'Timestamp',
-                value: epoch.timestamp?.toString(),
+                value: epoch?.timestamp?.toString() ??
+                    (await this.arweave.blocks.getCurrent().catch(() => {
+                        return { timestamp: Date.now() }; // fallback to current time
+                    })).timestamp.toString(),
             },
             {
-                name: 'BlockHeight',
-                value: epoch?.blockHeight?.toString(),
-            },
-            {
-                name: 'EpochIndex',
+                name: 'Epoch-Index',
                 value: epoch?.epochIndex?.toString(),
             },
         ];
         const prunedTags = allTags.filter((tag) => tag.value !== undefined);
-        // if it only contains the action, add default timestamp
-        if (prunedTags.length === 1) {
-            prunedTags.push({
-                name: 'Timestamp',
-                value: `${Date.now()}`,
-            });
-        }
         return this.process.read({
             tags: prunedTags,
         });
     }
     async getPrescribedNames(epoch) {
         const allTags = [
-            { name: 'Action', value: 'EpochPrescribedNames' },
+            { name: 'Action', value: 'Epoch-Prescribed-Names' },
             {
                 name: 'Timestamp',
-                value: epoch.timestamp?.toString(),
+                value: epoch?.timestamp?.toString() ??
+                    (await this.arweave.blocks.getCurrent().catch(() => {
+                        return { timestamp: Date.now() }; // fallback to current time
+                    })).timestamp.toString(),
             },
             {
-                name: 'BlockHeight',
-                value: epoch?.blockHeight?.toString(),
-            },
-            {
-                name: 'EpochIndex',
+                name: 'Epoch-Index',
                 value: epoch?.epochIndex?.toString(),
             },
         ];
         const prunedTags = allTags.filter((tag) => tag.value !== undefined);
-        // if it only contains the action, add default timestamp
-        if (prunedTags.length === 1) {
-            prunedTags.push({
-                name: 'Timestamp',
-                value: `${Date.now()}`, // TODO; replace with fetch the current network time
-            });
-        }
         return this.process.read({
             tags: prunedTags,
         });
     }
     async getObservations(epoch) {
         const allTags = [
-            { name: 'Action', value: 'EpochObservations' },
+            { name: 'Action', value: 'Epoch-Observations' },
             {
                 name: 'Timestamp',
-                value: epoch.timestamp?.toString(),
-            },
-            {
-                name: 'BlockHeight',
-                value: epoch?.blockHeight?.toString(),
+                value: epoch?.timestamp?.toString() ??
+                    (await this.arweave.blocks.getCurrent().catch(() => {
+                        return { timestamp: `${Date.now()}` }; // fallback to current time
+                    })).timestamp.toString(),
             },
             {
-                name: 'EpochIndex',
+                name: 'Epoch-Index',
                 value: epoch?.epochIndex?.toString(),
             },
         ];
         const prunedTags = allTags.filter((tag) => tag.value !== undefined);
-        // if it only contains the action, add default timestamp
-        if (prunedTags.length === 1) {
-            prunedTags.push({
-                name: 'Timestamp',
-                value: (await this.arweave.blocks.getCurrent()).timestamp.toString(),
-            });
-        }
         return this.process.read({
             tags: prunedTags,
         });
     }
     async getDistributions(epoch) {
         const allTags = [
-            { name: 'Action', value: 'EpochDistributions' },
+            { name: 'Action', value: 'Epoch-Distributions' },
             {
                 name: 'Timestamp',
-                value: epoch.timestamp?.toString() ?? '',
+                value: epoch?.timestamp?.toString() ??
+                    (await this.arweave.blocks.getCurrent().catch(() => {
+                        return { timestamp: Date.now() }; // fallback to current time
+                    })).timestamp.toString(),
             },
             {
-                name: 'BlockHeight',
-                value: epoch?.blockHeight?.toString(),
-            },
-            {
-                name: 'EpochIndex',
+                name: 'Epoch-Index',
                 value: epoch?.epochIndex?.toString(),
             },
         ];
         const prunedTags = allTags.filter((tag) => tag.value !== undefined);
-        // if it only contains the action, add default timestamp
-        if (prunedTags.length === 1) {
-            prunedTags.push({
+        return this.process.read({
+            tags: prunedTags,
+        });
+    }
+    async getTokenCost({ intent, purchaseType, years, name, quantity, }) {
+        const allTags = [
+            { name: 'Action', value: 'Token-Cost' },
+            {
+                name: 'Intent',
+                value: intent,
+            },
+            {
+                name: 'Name',
+                value: name,
+            },
+            {
+                name: 'Years',
+                value: years?.toString(),
+            },
+            {
+                name: 'Quantity',
+                value: quantity?.toString(),
+            },
+            {
+                name: 'Purchase-Type',
+                value: purchaseType,
+            },
+            {
                 name: 'Timestamp',
-                value: (await this.arweave.blocks.getCurrent()).timestamp.toString(),
-            });
-        }
+                value: (await this.arweave.blocks.getCurrent().catch(() => {
+                    return { timestamp: Date.now() }; // fallback to current time
+                })).timestamp.toString(),
+            },
+        ];
+        const prunedTags = allTags.filter((tag) => tag.value !== undefined);
         return this.process.read({
             tags: prunedTags,
         });
@@ -308,17 +332,17 @@ export class IOWriteable extends IOReadable {
         const { tags = [] } = options || {};
         const allTags = [
             ...tags,
-            { name: 'Action', value: 'JoinNetwork' },
+            { name: 'Action', value: 'Join-Network' },
             {
-                name: 'OperatorStake',
+                name: 'Operator-Stake',
                 value: operatorStake.valueOf().toString(),
             },
             {
-                name: 'AllowDelegatedStaking',
+                name: 'Allow-Delegated-Staking',
                 value: allowDelegatedStaking.toString(),
             },
             {
-                name: 'DelegateRewardShareRatio',
+                name: 'Delegate-Reward-Share-Ratio',
                 value: delegateRewardShareRatio.toString(),
             },
             {
@@ -330,7 +354,7 @@ export class IOWriteable extends IOReadable {
                 value: label,
             },
             {
-                name: 'MinDelegatedStake',
+                name: 'Min-Delegated-Stake',
                 value: minDelegatedStake.valueOf().toString(),
             },
             {
@@ -350,11 +374,11 @@ export class IOWriteable extends IOReadable {
                 value: protocol,
             },
             {
-                name: 'AutoStake',
+                name: 'Auto-Stake',
                 value: autoStake.toString(),
             },
             {
-                name: 'ObserverAddress',
+                name: 'Observer-Address',
                 value: observerAddress,
             },
         ];
@@ -368,27 +392,27 @@ export class IOWriteable extends IOReadable {
         const { tags = [] } = options || {};
         const allTags = [
             ...tags,
-            { name: 'Action', value: 'UpdateGatewaySettings' },
+            { name: 'Action', value: 'Update-Gateway-Settings' },
             { name: 'Label', value: label },
             { name: 'Note', value: note },
             { name: 'FQDN', value: fqdn },
             { name: 'Port', value: port?.toString() },
             { name: 'Properties', value: properties },
             { name: 'Protocol', value: protocol },
-            { name: 'ObserverAddress', value: observerAddress },
+            { name: 'Observer-Address', value: observerAddress },
             {
-                name: 'AllowDelegatedStaking',
+                name: 'Allow-Delegated-Staking',
                 value: allowDelegatedStaking?.toString(),
             },
             {
-                name: 'DelegateRewardShareRatio',
+                name: 'Delegate-Reward-Share-Ratio',
                 value: delegateRewardShareRatio?.toString(),
             },
             {
-                name: 'MinDelegatedStake',
+                name: 'Min-Delegated-Stake',
                 value: minDelegatedStake?.valueOf().toString(),
             },
-            { name: 'AutoStake', value: autoStake?.toString() },
+            { name: 'Auto-Stake', value: autoStake?.toString() },
         ];
         const prunedTags = allTags.filter((tag) => tag.value !== undefined);
         return this.process.send({
@@ -402,7 +426,7 @@ export class IOWriteable extends IOReadable {
             signer: this.signer,
             tags: [
                 ...tags,
-                { name: 'Action', value: 'DelegateStake' },
+                { name: 'Action', value: 'Delegate-Stake' },
                 { name: 'Target', value: params.target },
                 { name: 'Quantity', value: params.stakeQty.valueOf().toString() },
             ],
@@ -414,7 +438,7 @@ export class IOWriteable extends IOReadable {
             signer: this.signer,
             tags: [
                 ...tags,
-                { name: 'Action', value: 'DecreaseDelegateStake' },
+                { name: 'Action', value: 'Decrease-Delegate-Stake' },
                 { name: 'Target', value: params.target },
                 { name: 'Quantity', value: params.decreaseQty.valueOf().toString() },
             ],
@@ -426,7 +450,7 @@ export class IOWriteable extends IOReadable {
             signer: this.signer,
             tags: [
                 ...tags,
-                { name: 'Action', value: 'IncreaseOperatorStake' },
+                { name: 'Action', value: 'Increase-Operator-Stake' },
                 { name: 'Quantity', value: params.increaseQty.valueOf().toString() },
             ],
         });
@@ -437,7 +461,7 @@ export class IOWriteable extends IOReadable {
             signer: this.signer,
             tags: [
                 ...tags,
-                { name: 'Action', value: 'DecreaseOperatorStake' },
+                { name: 'Action', value: 'Decrease-Operator-Stake' },
                 { name: 'Quantity', value: params.decreaseQty.valueOf().toString() },
             ],
         });
@@ -448,13 +472,13 @@ export class IOWriteable extends IOReadable {
             signer: this.signer,
             tags: [
                 ...tags,
-                { name: 'Action', value: 'SaveObservations' },
+                { name: 'Action', value: 'Save-Observations' },
                 {
-                    name: 'ReportTxId',
+                    name: 'Report-Tx-Id',
                     value: params.reportTxId,
                 },
                 {
-                    name: 'FailedGateways',
+                    name: 'Failed-Gateways',
                     value: params.failedGateways.join(','),
                 },
             ],
@@ -468,11 +492,11 @@ export class IOWriteable extends IOReadable {
         const { tags = [] } = options || {};
         const allTags = [
             ...tags,
-            { name: 'Action', value: 'BuyRecord' },
+            { name: 'Action', value: 'Buy-Record' },
             { name: 'Name', value: params.name },
             { name: 'Years', value: params.years?.toString() ?? '1' },
-            { name: 'ProcessId', value: params.processId },
-            { name: 'PurchaseType', value: params.type || 'lease' },
+            { name: 'Process-Id', value: params.processId },
+            { name: 'Purchase-Type', value: params.type || 'lease' },
         ];
         const prunedTags = allTags.filter((tag) => tag.value !== undefined);
         return this.process.send({
@@ -486,7 +510,7 @@ export class IOWriteable extends IOReadable {
             signer: this.signer,
             tags: [
                 ...tags,
-                { name: 'Action', value: 'ExtendLease' },
+                { name: 'Action', value: 'Extend-Lease' },
                 { name: 'Name', value: params.name },
                 { name: 'Years', value: params.years.toString() },
             ],
@@ -498,7 +522,7 @@ export class IOWriteable extends IOReadable {
             signer: this.signer,
             tags: [
                 ...tags,
-                { name: 'Action', value: 'IncreaseUndernameLimit' },
+                { name: 'Action', value: 'Increase-Undername-Limit' },
                 { name: 'Name', value: params.name },
                 { name: 'Quantity', value: params.increaseCount.toString() },
             ],

package/lib/esm/constants.js

@@ -21,8 +21,11 @@ export const FQDN_REGEX = new RegExp('^(?:(?!-)[A-Za-z0-9-]{1,63}(?<!-)\\.)+[A-Z
 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 ioDevnetProcessId = 'GaQrvEMKBpkjofgnBi_B3IgIDmY_XYelVLB6GcRGrHc';
+export const IO_DEVNET_PROCESS_ID = 'GaQrvEMKBpkjofgnBi_B3IgIDmY_XYelVLB6GcRGrHc';
+// backwards compatibility - TODO: remove in v2.0.0
+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 = '9afQ1PLf2mrshqCTZEzzJTR2gWaC9zNPnYgYEqg1Pt4';
-export const ANT_LUA_ID = 'obPBMsBWmG5q2qODj3y-zdKiuhZaJC_nuBaQRvORKkU';
+export const AOS_MODULE_ID = 'cbn0KKrBZH7hdNkNokuXLtGryrWM--PjSTBqIzw9Kkk';
+export const ANT_LUA_ID = '3OlGzE5mrsN2GsxCYM0Tae1KzWepGOr5a94deOWmApM';
 export const DEFAULT_SCHEDULER_ID = '_GQ33BkPtZrqxA84vM8Zk-N2aO0toNNu_C-l-rawrBA';

package/lib/esm/utils/ao.js

@@ -18,7 +18,7 @@ import { connect } from '@permaweb/aoconnect';
 import { defaultArweave } from '../common/arweave.js';
 import { AOProcess } from '../common/index.js';
 import { ANT_LUA_ID, AOS_MODULE_ID, DEFAULT_SCHEDULER_ID, } from '../constants.js';
-export async function spawnANT({ module = AOS_MODULE_ID, luaCodeTxId = ANT_LUA_ID, scheduler = DEFAULT_SCHEDULER_ID, ao = connect(), signer, state, stateContractTxId, }) {
+export async function spawnANT({ signer, module = AOS_MODULE_ID, luaCodeTxId = ANT_LUA_ID, ao = connect(), scheduler = DEFAULT_SCHEDULER_ID, state, stateContractTxId, }) {
     //TODO: cache locally and only fetch if not cached
     const luaString = (await defaultArweave.transactions.getData(luaCodeTxId, {
         decode: true,

package/lib/esm/utils/graphql/processes.js

@@ -14,15 +14,15 @@
  * 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/>.
  */
+import { EventEmitter } from 'eventemitter3';
 import { pLimit } from 'plimit-lit';
 import { ANT } from '../../common/ant.js';
 import { IO } from '../../common/io.js';
 import { ioDevnetProcessId } from '../../constants.js';
-// throttle the requests to avoid rate limiting
-const throttle = pLimit(50);
 export const getANTProcessesOwnedByWallet = async ({ address, contract = IO.init({
     processId: ioDevnetProcessId,
 }), }) => {
+    const throttle = pLimit(50);
     // get the record names of the registry - TODO: this may need to be paginated
     const uniqueContractProcessIds = await contract
         .getArNSRecords()
@@ -30,14 +30,93 @@ export const getANTProcessesOwnedByWallet = async ({ address, contract = IO.init
         .filter((record) => record.processId !== undefined)
         .map((record) => record.processId));
     // check the contract owner and controllers
-    const ownedOrControlledByWallet = await Promise.all(uniqueContractProcessIds.filter(async (processId) => throttle(async () => {
+    const ownedOrControlledByWallet = await Promise.all(uniqueContractProcessIds.map(async (processId) => throttle(async () => {
         const ant = ANT.init({
             processId,
         });
-        const owner = await ant.getOwner();
-        const controllers = await ant.getControllers();
-        return owner === address || controllers.includes(address);
+        const { Owner, Controllers } = await ant.getState();
+        if (Owner === address || Controllers.includes(address)) {
+            return processId;
+        }
+        return;
     })));
+    if (ownedOrControlledByWallet.length === 0) {
+        return [];
+    }
     // TODO: insert gql query to find ANT processes owned by wallet given wallet not currently in the registry
     return [...new Set(ownedOrControlledByWallet)];
 };
+function timeout(ms, promise) {
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => {
+            reject(new Error('Timeout'));
+        }, ms);
+        promise
+            .then((value) => {
+            clearTimeout(timer);
+            resolve(value);
+        })
+            .catch((err) => {
+            clearTimeout(timer);
+            reject(err);
+        });
+    });
+}
+export class ArNSEventEmitter extends EventEmitter {
+    contract;
+    timeoutMs; // timeout for each request to 3 seconds
+    throttle;
+    constructor({ contract = IO.init({
+        processId: ioDevnetProcessId,
+    }), timeoutMs = 60_000, concurrency = 30, }) {
+        super();
+        this.contract = contract;
+        this.timeoutMs = timeoutMs;
+        this.throttle = pLimit(concurrency);
+    }
+    async fetchProcessesOwnedByWallet({ address }) {
+        const uniqueContractProcessIds = {};
+        await timeout(this.timeoutMs, this.contract.getArNSRecords().catch((e) => {
+            this.emit('error', `Error getting ArNS records: ${e}`);
+            return {};
+        })).then((records) => {
+            if (!records)
+                return;
+            Object.entries(records).forEach(([name, record]) => {
+                if (record.processId === undefined) {
+                    return;
+                }
+                if (uniqueContractProcessIds[record.processId] === undefined) {
+                    uniqueContractProcessIds[record.processId] = {
+                        state: undefined,
+                        names: {},
+                    };
+                }
+                uniqueContractProcessIds[record.processId].names[name] = record;
+            });
+        });
+        const idCount = Object.keys(uniqueContractProcessIds).length;
+        // check the contract owner and controllers
+        this.emit('progress', 0, idCount);
+        await Promise.all(Object.keys(uniqueContractProcessIds).map(async (processId, i) => this.throttle(async () => {
+            if (uniqueContractProcessIds[processId].state !== undefined) {
+                this.emit('progress', i + 1, idCount);
+                return;
+            }
+            const ant = ANT.init({
+                processId,
+            });
+            const state = (await timeout(this.timeoutMs, ant.getState()).catch((e) => {
+                this.emit('error', `Error getting state for process ${processId}: ${e}`);
+                return undefined;
+            }));
+            if (state?.Owner === address ||
+                state?.Controllers.includes(address)) {
+                uniqueContractProcessIds[processId].state = state;
+                this.emit('process', processId, uniqueContractProcessIds[processId]);
+            }
+            this.emit('progress', i + 1, idCount);
+        })));
+        this.emit('end', uniqueContractProcessIds);
+    }
+}

package/lib/esm/utils/index.js

@@ -19,3 +19,4 @@ export * from './http-client.js';
 export * from './smartweave.js';
 export * from './graphql/index.js';
 export * from './ao.js';
+export * from './json.js';

package/lib/esm/utils/json.js

@@ -0,0 +1,24 @@
+/**
+ * Copyright (C) 2022-2024 Permanent Data Solutions, Inc. All Rights Reserved.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * 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 function safeDecode(data) {
+    try {
+        return JSON.parse(data);
+    }
+    catch (e) {
+        return data;
+    }
+}

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

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

@@ -15,12 +15,13 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 import { ANTRecord } from '../contract-state.js';
-import { AoANTRead, AoANTWrite, ProcessConfiguration } from '../io.js';
+import { AoANTRead, AoANTState, AoANTWrite, ProcessConfiguration } from '../io.js';
 import { AoMessageResult, WalletAddress, WithSigner } from '../types.js';
 import { AOProcess } from './contracts/ao-process.js';
 export declare class AoANTReadable implements AoANTRead {
     protected process: AOProcess;
     constructor(config: Required<ProcessConfiguration>);
+    getState(): Promise<AoANTState>;
     getInfo(): Promise<{
         Name: string;
         Ticker: string;

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

@@ -16,7 +16,7 @@
  */
 import Arweave from 'arweave';
 import { ArNSReservedNameData, EpochDistributionData, EpochObservations, WeightedObserver } from '../contract-state.js';
-import { AoArNSNameData, AoEpochData, AoGateway, AoIORead, AoIOWrite, EpochInput } from '../io.js';
+import { AoArNSNameData, AoEpochData, AoEpochSettings, AoGateway, AoIORead, AoIOWrite, EpochInput } from '../io.js';
 import { mIOToken } from '../token.js';
 import { AoMessageResult, ContractSigner, JoinNetworkParams, ProcessConfiguration, TransactionId, UpdateGatewaySettingsParams, WalletAddress, WithSigner, WriteOptions } from '../types.js';
 import { AOProcess } from './contracts/ao-process.js';
@@ -43,6 +43,13 @@ export declare class IOReadable implements AoIORead {
     protected process: AOProcess;
     private arweave;
     constructor(config?: ProcessConfiguration, arweave?: Arweave);
+    getInfo(): Promise<{
+        Name: string;
+        Ticker: string;
+        Logo: string;
+        Denomination: number;
+    }>;
+    getEpochSettings(params?: EpochInput): Promise<AoEpochSettings>;
     getEpoch(epoch?: EpochInput): Promise<AoEpochData>;
     getArNSRecord({ name, }: {
         name: string;
@@ -65,6 +72,22 @@ export declare class IOReadable implements AoIORead {
     getPrescribedNames(epoch?: EpochInput): Promise<string[]>;
     getObservations(epoch?: EpochInput): Promise<EpochObservations>;
     getDistributions(epoch?: EpochInput): Promise<EpochDistributionData>;
+    getTokenCost(params: {
+        intent: 'Buy-Record';
+        purchaseType: 'permabuy' | 'lease';
+        years: number;
+        name: string;
+    }): Promise<number>;
+    getTokenCost(params: {
+        intent: 'Extend-Lease';
+        years: number;
+        name: string;
+    }): Promise<number>;
+    getTokenCost(params: {
+        intent: 'Increase-Undername-Limit';
+        quantity: number;
+        name: string;
+    }): Promise<number>;
 }
 export declare class IOWriteable extends IOReadable implements AoIOWrite {
     protected process: AOProcess;