@ar.io/sdk 3.1.0-alpha.1 → 3.1.0-alpha.11

package/lib/esm/common/io.js

@@ -1,8 +1,22 @@
+/**
+ * Copyright (C) 2022-2024 Permanent Data Solutions, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
 import { ARIO_TESTNET_PROCESS_ID } from '../constants.js';
 import { isProcessConfiguration, isProcessIdConfiguration, } from '../types/io.js';
 import { createAoSigner } from '../utils/ao.js';
-import { getCurrentBlockUnixTimestampMs, paginationParamsToTags, pruneTags, } from '../utils/arweave.js';
-import { defaultArweave } from './arweave.js';
+import { paginationParamsToTags, pruneTags } from '../utils/arweave.js';
 import { AOProcess } from './contracts/ao-process.js';
 import { InvalidContractConfigurationError } from './error.js';
 export class ARIO {
@@ -19,8 +33,8 @@ export class ARIO {
 }
 export class ARIOReadable {
     process;
-    arweave;
-    constructor(config, arweave = defaultArweave) {
+    epochSettings;
+    constructor(config) {
         if (!config) {
             this.process = new AOProcess({
                 processId: ARIO_TESTNET_PROCESS_ID,
@@ -37,7 +51,6 @@ export class ARIOReadable {
         else {
             throw new InvalidContractConfigurationError();
         }
-        this.arweave = arweave;
     }
     async getInfo() {
         return this.process.read({
@@ -49,35 +62,32 @@ export class ARIOReadable {
             tags: [{ name: 'Action', value: 'Total-Token-Supply' }],
         });
     }
-    async getEpochSettings(params) {
-        const allTags = [
-            { name: 'Action', value: 'Epoch-Settings' },
-            {
-                name: 'Timestamp',
-                value: params?.timestamp?.toString() ??
-                    (await getCurrentBlockUnixTimestampMs(this.arweave)).toString(),
-            },
-            {
-                name: 'Epoch-Index',
-                value: params?.epochIndex?.toString(),
-            },
-        ];
-        return this.process.read({
-            tags: pruneTags(allTags),
-        });
+    async computeEpochIndexForTimestamp(timestamp) {
+        const epochSettings = await this.getEpochSettings();
+        const epochZeroStartTimestamp = epochSettings.epochZeroStartTimestamp;
+        const epochLengthMs = epochSettings.durationMs;
+        return Math.floor((timestamp - epochZeroStartTimestamp) / epochLengthMs);
+    }
+    async computeEpochIndex(params) {
+        const epochIndex = params?.epochIndex;
+        if (epochIndex !== undefined) {
+            return epochIndex.toString();
+        }
+        const timestamp = params?.timestamp;
+        if (timestamp !== undefined) {
+            return (await this.computeEpochIndexForTimestamp(timestamp)).toString();
+        }
+        return undefined;
+    }
+    async getEpochSettings() {
+        return (this.epochSettings ??= await this.process.read({
+            tags: [{ name: 'Action', value: 'Epoch-Settings' }],
+        }));
     }
     async getEpoch(epoch) {
         const allTags = [
             { name: 'Action', value: 'Epoch' },
-            {
-                name: 'Timestamp',
-                value: epoch?.timestamp?.toString() ??
-                    (await getCurrentBlockUnixTimestampMs(this.arweave)).toString(),
-            },
-            {
-                name: 'Epoch-Index',
-                value: epoch?.epochIndex?.toString(),
-            },
+            { name: 'Epoch-Index', value: await this.computeEpochIndex(epoch) },
         ];
         return this.process.read({
             tags: pruneTags(allTags),
@@ -184,27 +194,13 @@ export class ARIOReadable {
     }
     async getCurrentEpoch() {
         return this.process.read({
-            tags: [
-                { name: 'Action', value: 'Epoch' },
-                {
-                    name: 'Timestamp',
-                    value: (await getCurrentBlockUnixTimestampMs(this.arweave)).toString(),
-                },
-            ],
+            tags: [{ name: 'Action', value: 'Epoch' }],
         });
     }
     async getPrescribedObservers(epoch) {
         const allTags = [
             { name: 'Action', value: 'Epoch-Prescribed-Observers' },
-            {
-                name: 'Timestamp',
-                value: epoch?.timestamp?.toString() ??
-                    (await getCurrentBlockUnixTimestampMs(this.arweave)).toString(),
-            },
-            {
-                name: 'Epoch-Index',
-                value: epoch?.epochIndex?.toString(),
-            },
+            { name: 'Epoch-Index', value: await this.computeEpochIndex(epoch) },
         ];
         return this.process.read({
             tags: pruneTags(allTags),
@@ -213,15 +209,7 @@ export class ARIOReadable {
     async getPrescribedNames(epoch) {
         const allTags = [
             { name: 'Action', value: 'Epoch-Prescribed-Names' },
-            {
-                name: 'Timestamp',
-                value: epoch?.timestamp?.toString() ??
-                    (await getCurrentBlockUnixTimestampMs(this.arweave)).toString(),
-            },
-            {
-                name: 'Epoch-Index',
-                value: epoch?.epochIndex?.toString(),
-            },
+            { name: 'Epoch-Index', value: await this.computeEpochIndex(epoch) },
         ];
         return this.process.read({
             tags: pruneTags(allTags),
@@ -230,15 +218,7 @@ export class ARIOReadable {
     async getObservations(epoch) {
         const allTags = [
             { name: 'Action', value: 'Epoch-Observations' },
-            {
-                name: 'Timestamp',
-                value: epoch?.timestamp?.toString() ??
-                    (await getCurrentBlockUnixTimestampMs(this.arweave)).toString(),
-            },
-            {
-                name: 'Epoch-Index',
-                value: epoch?.epochIndex?.toString(),
-            },
+            { name: 'Epoch-Index', value: await this.computeEpochIndex(epoch) },
         ];
         return this.process.read({
             tags: pruneTags(allTags),
@@ -247,15 +227,7 @@ export class ARIOReadable {
     async getDistributions(epoch) {
         const allTags = [
             { name: 'Action', value: 'Epoch-Distributions' },
-            {
-                name: 'Timestamp',
-                value: epoch?.timestamp?.toString() ??
-                    (await getCurrentBlockUnixTimestampMs(this.arweave)).toString(),
-            },
-            {
-                name: 'Epoch-Index',
-                value: epoch?.epochIndex?.toString(),
-            },
+            { name: 'Epoch-Index', value: await this.computeEpochIndex(epoch) },
         ];
         return this.process.read({
             tags: pruneTags(allTags),
@@ -284,17 +256,6 @@ export class ARIOReadable {
                 name: 'Purchase-Type',
                 value: type,
             },
-            {
-                name: 'Timestamp',
-                value: (await this.arweave.blocks
-                    .getCurrent()
-                    .then((block) => {
-                    return { timestamp: block.timestamp * 1000 };
-                })
-                    .catch(() => {
-                    return { timestamp: Date.now() }; // fallback to current time
-                })).timestamp.toString(),
-            },
         ];
         return this.process.read({
             tags: pruneTags(allTags),
@@ -329,17 +290,6 @@ export class ARIOReadable {
                 name: 'Fund-From',
                 value: fundFrom,
             },
-            {
-                name: 'Timestamp',
-                value: (await this.arweave.blocks
-                    .getCurrent()
-                    .then((block) => {
-                    return { timestamp: block.timestamp * 1000 };
-                })
-                    .catch(() => {
-                    return { timestamp: Date.now() }; // fallback to current time
-                })).timestamp.toString(),
-            },
         ];
         return this.process.read({
             tags: pruneTags(allTags),
@@ -708,6 +658,7 @@ export class ARIOWriteable extends ARIOReadable {
             { name: 'Years', value: params.years?.toString() ?? '1' },
             { name: 'Process-Id', value: params.processId },
             { name: 'Purchase-Type', value: params.type || 'lease' },
+            { name: 'Fund-From', value: params.fundFrom },
         ];
         return this.process.send({
             signer: this.signer,
@@ -724,13 +675,15 @@ export class ARIOWriteable extends ARIOReadable {
      */
     async upgradeRecord(params, options) {
         const { tags = [] } = options || {};
+        const allTags = [
+            ...tags,
+            { name: 'Action', value: 'Upgrade-Name' }, // TODO: align on Update-Record vs. Upgrade-Name (contract currently uses Upgrade-Name)
+            { name: 'Name', value: params.name },
+            { name: 'Fund-From', value: params.fundFrom },
+        ];
         return this.process.send({
             signer: this.signer,
-            tags: [
-                ...tags,
-                { name: 'Action', value: 'Upgrade-Name' }, // TODO: align on Update-Record vs. Upgrade-Name (contract currently uses Upgrade-Name)
-                { name: 'Name', value: params.name },
-            ],
+            tags: pruneTags(allTags),
         });
     }
     /**
@@ -744,26 +697,30 @@ export class ARIOWriteable extends ARIOReadable {
      */
     async extendLease(params, options) {
         const { tags = [] } = options || {};
+        const allTags = [
+            ...tags,
+            { name: 'Action', value: 'Extend-Lease' },
+            { name: 'Name', value: params.name },
+            { name: 'Years', value: params.years.toString() },
+            { name: 'Fund-From', value: params.fundFrom },
+        ];
         return this.process.send({
             signer: this.signer,
-            tags: [
-                ...tags,
-                { name: 'Action', value: 'Extend-Lease' },
-                { name: 'Name', value: params.name },
-                { name: 'Years', value: params.years.toString() },
-            ],
+            tags: pruneTags(allTags),
         });
     }
     async increaseUndernameLimit(params, options) {
         const { tags = [] } = options || {};
+        const allTags = [
+            ...tags,
+            { name: 'Action', value: 'Increase-Undername-Limit' },
+            { name: 'Name', value: params.name },
+            { name: 'Quantity', value: params.increaseCount.toString() },
+            { name: 'Fund-From', value: params.fundFrom },
+        ];
         return this.process.send({
             signer: this.signer,
-            tags: [
-                ...tags,
-                { name: 'Action', value: 'Increase-Undername-Limit' },
-                { name: 'Name', value: params.name },
-                { name: 'Quantity', value: params.increaseCount.toString() },
-            ],
+            tags: pruneTags(allTags),
         });
     }
     /**
@@ -788,13 +745,16 @@ export class ARIOWriteable extends ARIOReadable {
             tags: pruneTags(allTags),
         });
     }
-    async requestPrimaryName(params) {
+    async requestPrimaryName(params, options) {
+        const { tags = [] } = options || {};
+        const allTags = [
+            ...tags,
+            { name: 'Action', value: 'Request-Primary-Name' },
+            { name: 'Name', value: params.name },
+        ];
         return this.process.send({
             signer: this.signer,
-            tags: [
-                { name: 'Action', value: 'Request-Primary-Name' },
-                { name: 'Name', value: params.name },
-            ],
+            tags: pruneTags(allTags),
         });
     }
     /**

package/lib/esm/utils/arweave.js

@@ -1,3 +1,18 @@
+/**
+ * Copyright (C) 2022-2024 Permanent Data Solutions, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
 import { ARWEAVE_TX_REGEX } from '../constants.js';
 export const validateArweaveId = (id) => {
     return ARWEAVE_TX_REGEX.test(id);
@@ -5,18 +20,13 @@ export const validateArweaveId = (id) => {
 export function isBlockHeight(height) {
     return height !== undefined && !isNaN(parseInt(height.toString()));
 }
+/**
+ * Prune tags that are undefined or empty.
+ * @param tags - The tags to prune.
+ * @returns The pruned tags.
+ */
 export const pruneTags = (tags) => {
-    return tags.filter((tag) => tag.value !== undefined);
-};
-export const getCurrentBlockUnixTimestampMs = async (arweave) => {
-    return await arweave.blocks
-        .getCurrent()
-        .then((block) => {
-        return block.timestamp * 1000;
-    })
-        .catch(() => {
-        return Date.now(); // fallback to current time
-    });
+    return tags.filter((tag) => tag.value !== undefined && tag.value !== '');
 };
 export const paginationParamsToTags = (params) => {
     const tags = [

package/lib/esm/version.js

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

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

@@ -0,0 +1,22 @@
+/**
+ * Copyright (C) 2022-2024 Permanent Data Solutions, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { AoArNSPurchaseParams, AoBuyRecordParams, AoExtendLeaseParams, AoIncreaseUndernameLimitParams } from '../../types/io.js';
+import { CLIWriteOptionsFromAoParams } from '../types.js';
+export declare function buyRecordCLICommand(o: CLIWriteOptionsFromAoParams<AoBuyRecordParams>): Promise<import("../../types/common.js").AoMessageResult>;
+export declare function upgradeRecordCLICommand(o: CLIWriteOptionsFromAoParams<AoArNSPurchaseParams>): Promise<import("../../types/common.js").AoMessageResult>;
+export declare function extendLeaseCLICommand(o: CLIWriteOptionsFromAoParams<AoExtendLeaseParams>): Promise<import("../../types/common.js").AoMessageResult>;
+export declare function increaseUndernameLimitCLICommand(o: CLIWriteOptionsFromAoParams<AoIncreaseUndernameLimitParams>): Promise<import("../../types/common.js").AoMessageResult>;
+export declare function requestPrimaryNameCLICommand(o: CLIWriteOptionsFromAoParams<AoArNSPurchaseParams>): Promise<import("../../types/common.js").AoMessageResult>;

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

@@ -248,15 +248,7 @@ export declare const writeActionOptions: {
     description: string;
     type: string;
 }[];
-export declare const addressOptions: {
-    alias: string;
-    description: string;
-}[];
-export declare const nameOptions: {
-    alias: string;
-    description: string;
-}[];
-export declare const initiatorOptions: {
+export declare const arnsPurchaseOptions: {
     alias: string;
     description: string;
 }[];

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

@@ -13,7 +13,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { AoAddressParams, AoArNSNameParams, AoBuyRecordParams, AoExtendLeaseParams, AoGetVaultParams, AoIncreaseUndernameLimitParams, AoJoinNetworkParams, AoTokenCostParams, PaginationParams } from '../types/io.js';
+import { AoAddressParams, AoArNSNameParams, AoGetVaultParams, AoJoinNetworkParams, AoTokenCostParams, PaginationParams } from '../types/io.js';
 export type WalletCLIOptions = {
     walletFile?: string;
     privateKey?: string;
@@ -47,6 +47,8 @@ export type ProcessIdWriteActionCLIOptions = WriteActionCLIOptions & {
 export type CLIOptionsFromAoParams<T> = {
     [K in keyof T]?: T[K] extends number | undefined ? string | undefined : T[K] extends string | boolean | symbol ? string : T[K] extends ReadonlyArray<infer U> ? ReadonlyArray<U> : T[K] extends object ? CLIOptionsFromAoParams<T[K]> : T[K];
 };
+export type CLIReadOptionsFromAoParams<T> = CLIOptionsFromAoParams<T> & GlobalCLIOptions;
+export type CLIWriteOptionsFromAoParams<T> = WriteActionCLIOptions & CLIOptionsFromAoParams<T>;
 export type PaginationCLIOptions = GlobalCLIOptions & CLIOptionsFromAoParams<PaginationParams>;
 export type AddressCLIOptions = GlobalCLIOptions & CLIOptionsFromAoParams<AoAddressParams>;
 export type ProcessIdCLIOptions = GlobalCLIOptions & {
@@ -86,10 +88,6 @@ export type OperatorStakeCLIOptions = WriteActionCLIOptions & {
 export type DecreaseDelegateStakeCLIOptions = DelegateStakeCLIOptions & {
     instant: boolean;
 };
-export type BuyRecordCLIOptions = WriteActionCLIOptions & CLIOptionsFromAoParams<AoBuyRecordParams>;
-export type UpgradeRecordCLIOptions = NameWriteCLIOptions;
-export type ExtendLeaseCLIOptions = WriteActionCLIOptions & CLIOptionsFromAoParams<AoExtendLeaseParams>;
-export type IncreaseUndernameLimitCLIOptions = WriteActionCLIOptions & CLIOptionsFromAoParams<AoIncreaseUndernameLimitParams>;
 export type ANTStateCLIOptions = WriteActionCLIOptions & {
     target?: string;
     keywords?: 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, AoRedelegateStakeParams, AoSigner, AoUpdateGatewaySettingsParams, ContractSigner, EpochInput, Logger, PaginationParams, SpawnANTState, WriteOptions, mARIOToken } from '../node/index.js';
+import { ARIOToken, AoANTRead, 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 function stringifyJsonForCLIDisplay(json: JsonSerializable | unknown): string;
 export declare function runCommand<O extends OptionValues>(command: Command, action: (options: O) => Promise<JsonSerializable>): Promise<void>;
@@ -31,6 +31,7 @@ export declare function writeARIOFromOptions(options: GlobalCLIOptions): {
     signerAddress: string;
 };
 export declare function formatARIOWithCommas(value: ARIOToken): string;
+export declare function formatMARIOToARIOWithCommas(value: mARIOToken): string;
 /** helper to get address from --address option first, then check wallet options  */
 export declare function addressFromOptions<O extends AddressCLIOptions>(options: O): string | undefined;
 export declare function requiredAddressFromOptions<O extends AddressCLIOptions>(options: O): string;
@@ -51,8 +52,17 @@ export declare function redelegateParamsFromOptions(options: RedelegateStakeCLIO
 export declare function recordTypeFromOptions<O extends {
     type?: string;
 }>(options: O): 'lease' | 'permabuy';
-export declare function requiredMIOFromOptions<O extends GlobalCLIOptions>(options: O, key: string): mARIOToken;
-export declare function assertEnoughBalance(ario: AoARIORead, address: string, arioQuantity: ARIOToken): Promise<void>;
+export declare function requiredMARIOFromOptions<O extends GlobalCLIOptions>(options: O, key: string): mARIOToken;
+export declare function assertEnoughBalanceForArNSPurchase({ ario, address, costDetailsParams, }: {
+    ario: AoARIORead;
+    address: string;
+    costDetailsParams: AoGetCostDetailsParams;
+}): Promise<void>;
+export declare function assertEnoughMARIOBalance({ address, ario, mARIOQuantity, }: {
+    ario: AoARIORead;
+    address: string;
+    mARIOQuantity: mARIOToken | number;
+}): Promise<void>;
 export declare function confirmationPrompt(message: string): Promise<boolean>;
 export declare function assertConfirmationPrompt<O extends {
     skipConfirmation?: boolean;
@@ -73,3 +83,6 @@ export declare function getTokenCostParamsFromOptions(o: GetTokenCostCLIOptions)
     name: string;
     fromAddress: string | undefined;
 };
+export declare function fundFromFromOptions<O extends {
+    fundFrom?: string;
+}>(o: O): FundFrom;

package/lib/types/common/contracts/ao-process.d.ts

@@ -9,6 +9,7 @@ export declare class AOProcess implements AOContract {
         ao?: AoClient;
         logger?: ILogger;
     });
+    private isMessageDataEmpty;
     read<K>({ tags, retries, fromAddress, }: {
         tags?: Array<{
             name: string;

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

@@ -1,21 +1,5 @@
-/**
- * Copyright (C) 2022-2024 Permanent Data Solutions, Inc.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-import Arweave from 'arweave';
 import { AoArNSNameDataWithName, AoArNSReservedNameData, AoBalanceWithAddress, AoEpochDistributionData, AoEpochObservationData, AoGatewayWithAddress, AoJoinNetworkParams, AoMessageResult, AoPrimaryName, AoPrimaryNameRequest, AoRedelegationFeeInfo, AoReturnedName, AoTokenSupplyData, AoUpdateGatewaySettingsParams, AoWeightedObserver, ContractSigner, PaginationParams, PaginationResult, ProcessConfiguration, TransactionId, WalletAddress, WithSigner, WriteOptions } from '../types/index.js';
-import { AoARIORead, AoARIOWrite, AoArNSNameData, AoArNSReservedNameDataWithName, AoDelegation, AoEpochData, AoEpochSettings, AoGateway, AoGatewayDelegateWithAddress, AoGatewayRegistrySettings, AoGatewayVault, AoGetCostDetailsParams, AoPaginatedAddressParams, AoRegistrationFees, AoVaultData, AoWalletVault, CostDetailsResult, DemandFactorSettings, EpochInput } from '../types/io.js';
+import { AoARIORead, AoARIOWrite, AoArNSNameData, AoArNSPurchaseParams, AoArNSReservedNameDataWithName, AoBuyRecordParams, AoDelegation, AoEpochData, AoEpochSettings, AoExtendLeaseParams, AoGateway, AoGatewayDelegateWithAddress, AoGatewayRegistrySettings, AoGatewayVault, AoGetCostDetailsParams, AoIncreaseUndernameLimitParams, AoPaginatedAddressParams, AoRegistrationFees, AoVaultData, AoWalletVault, CostDetailsResult, DemandFactorSettings, EpochInput } from '../types/io.js';
 import { mARIOToken } from '../types/token.js';
 import { AOProcess } from './contracts/ao-process.js';
 export declare class ARIO {
@@ -27,7 +11,7 @@ export declare class ARIO {
         process: AOProcess;
     }>): AoARIOWrite;
     static init({ processId, signer, }: WithSigner<{
-        processId: string;
+        processId?: string;
     }>): AoARIOWrite;
     static init({ processId, signer, }: {
         signer?: ContractSigner | undefined;
@@ -39,8 +23,8 @@ export declare class ARIO {
 }
 export declare class ARIOReadable implements AoARIORead {
     protected process: AOProcess;
-    private arweave;
-    constructor(config?: ProcessConfiguration, arweave?: Arweave);
+    protected epochSettings: AoEpochSettings | undefined;
+    constructor(config?: ProcessConfiguration);
     getInfo(): Promise<{
         Name: string;
         Ticker: string;
@@ -50,7 +34,9 @@ export declare class ARIOReadable implements AoARIORead {
         LastTickedEpochIndex: number;
     }>;
     getTokenSupply(): Promise<AoTokenSupplyData>;
-    getEpochSettings(params?: EpochInput): Promise<AoEpochSettings>;
+    private computeEpochIndexForTimestamp;
+    private computeEpochIndex;
+    getEpochSettings(): Promise<AoEpochSettings>;
     getEpoch(epoch?: EpochInput): Promise<AoEpochData>;
     getArNSRecord({ name, }: {
         name: string;
@@ -67,7 +53,7 @@ export declare class ARIOReadable implements AoARIORead {
     getVault({ address, vaultId, }: {
         address: WalletAddress;
         vaultId: string;
-    }): Promise<AoVaultData>;
+    }): Promise<AoVaultData | undefined>;
     getVaults(params?: PaginationParams<AoWalletVault>): Promise<PaginationResult<AoWalletVault>>;
     getGateway({ address, }: {
         address: WalletAddress;
@@ -125,7 +111,7 @@ export declare class ARIOReadable implements AoARIORead {
     getPrimaryNameRequest(params: {
         initiator: WalletAddress;
     }): Promise<AoPrimaryNameRequest>;
-    getPrimaryNameRequests(params: PaginationParams<AoPrimaryNameRequest>): Promise<PaginationResult<AoPrimaryNameRequest>>;
+    getPrimaryNameRequests(params?: PaginationParams<AoPrimaryNameRequest>): Promise<PaginationResult<AoPrimaryNameRequest>>;
     getPrimaryName(params: {
         address: WalletAddress;
     } | {
@@ -191,12 +177,7 @@ export declare class ARIOWriteable extends ARIOReadable implements AoARIOWrite {
         reportTxId: TransactionId;
         failedGateways: WalletAddress[];
     }, options?: WriteOptions): Promise<AoMessageResult>;
-    buyRecord(params: {
-        name: string;
-        years?: number;
-        type: 'lease' | 'permabuy';
-        processId: string;
-    }, options?: WriteOptions): Promise<AoMessageResult>;
+    buyRecord(params: AoBuyRecordParams, options?: WriteOptions): Promise<AoMessageResult>;
     /**
      * Upgrades an existing leased record to a permabuy.
      *
@@ -205,9 +186,7 @@ export declare class ARIOWriteable extends ARIOReadable implements AoARIOWrite {
      * @param {Object} [options] - The options for the upgrade
      * @returns {Promise<AoMessageResult>} The result of the upgrade
      */
-    upgradeRecord(params: {
-        name: string;
-    }, options?: WriteOptions): Promise<AoMessageResult>;
+    upgradeRecord(params: AoArNSPurchaseParams, options?: WriteOptions): Promise<AoMessageResult>;
     /**
      * Extends the lease of an existing leased record.
      *
@@ -217,14 +196,8 @@ export declare class ARIOWriteable extends ARIOReadable implements AoARIOWrite {
      * @param {Object} [options] - The options for the extension
      * @returns {Promise<AoMessageResult>} The result of the extension
      */
-    extendLease(params: {
-        name: string;
-        years: number;
-    }, options?: WriteOptions): Promise<AoMessageResult>;
-    increaseUndernameLimit(params: {
-        name: string;
-        increaseCount: number;
-    }, options?: WriteOptions): Promise<AoMessageResult>;
+    extendLease(params: AoExtendLeaseParams, options?: WriteOptions): Promise<AoMessageResult>;
+    increaseUndernameLimit(params: AoIncreaseUndernameLimitParams, options?: WriteOptions): Promise<AoMessageResult>;
     /**
      * Cancel a withdrawal from a gateway.
      *
@@ -238,9 +211,7 @@ export declare class ARIOWriteable extends ARIOReadable implements AoARIOWrite {
         gatewayAddress?: WalletAddress;
         vaultId: string;
     }, options?: WriteOptions | undefined): Promise<AoMessageResult>;
-    requestPrimaryName(params: {
-        name: string;
-    }): Promise<AoMessageResult>;
+    requestPrimaryName(params: AoArNSPurchaseParams, options?: WriteOptions): Promise<AoMessageResult>;
     /**
      * Redelegate stake from one gateway to another gateway.
      *

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

@@ -52,6 +52,7 @@ export type AoPrimaryNameRequest = {
 };
 export type AoPrimaryName = {
     owner: WalletAddress;
+    processId: ProcessId;
     name: string;
     startTimestamp: Timestamp;
 };