@ar.io/sdk 3.17.1 → 3.18.0-alpha.1

package/lib/cjs/cli/cli.js

@@ -438,6 +438,12 @@ const utils_js_1 = require("./utils.js");
     options: options_js_1.arnsPurchaseOptions,
     action: arnsPurchaseCommands_js_1.requestPrimaryNameCLICommand,
 });
+(0, utils_js_1.makeCommand)({
+    name: 'set-primary-name',
+    description: 'Set an ArNS name you own as your primary name',
+    options: options_js_1.arnsPurchaseOptions,
+    action: arnsPurchaseCommands_js_1.setPrimaryNameCLICommand,
+});
 // # ANT Registry
 (0, utils_js_1.makeCommand)({
     name: 'get-ants-for-address',

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

@@ -5,6 +5,7 @@ exports.upgradeRecordCLICommand = upgradeRecordCLICommand;
 exports.extendLeaseCLICommand = extendLeaseCLICommand;
 exports.increaseUndernameLimitCLICommand = increaseUndernameLimitCLICommand;
 exports.requestPrimaryNameCLICommand = requestPrimaryNameCLICommand;
+exports.setPrimaryNameCLICommand = setPrimaryNameCLICommand;
 /**
  * Copyright (C) 2022-2024 Permanent Data Solutions, Inc.
  *
@@ -176,8 +177,6 @@ async function requestPrimaryNameCLICommand(o) {
     const referrer = (0, utils_js_1.referrerFromOptions)(o);
     const name = (0, utils_js_1.requiredStringFromOptions)(o, 'name');
     if (!o.skipConfirmation) {
-        // TODO: Assert name requested is not already owned?
-        // TODO: More assertions?
         await (0, utils_js_1.assertEnoughBalanceForArNSPurchase)({
             ario,
             address: signerAddress,
@@ -190,10 +189,24 @@ async function requestPrimaryNameCLICommand(o) {
         });
         await (0, utils_js_1.assertConfirmationPrompt)(`Are you sure you want to request the primary name ${name}?`, o);
     }
-    return ario.requestPrimaryName({
+    const { result } = await ario.requestPrimaryName({
         name,
         fundFrom,
         paidBy: (0, utils_js_1.stringArrayFromOptions)(o, 'paidBy'),
         referrer,
     }, (0, utils_js_1.customTagsFromOptions)(o));
+    if (result?.request === undefined) {
+        throw new Error('Failed to request primary name for name ' + name);
+    }
+    return result.request;
+}
+async function setPrimaryNameCLICommand(o) {
+    const { ario, signerAddress } = (0, utils_js_1.writeARIOFromOptions)(o);
+    const name = (0, utils_js_1.requiredStringFromOptions)(o, 'name');
+    const fundFrom = (0, utils_js_1.fundFromFromOptions)(o);
+    const referrer = (0, utils_js_1.referrerFromOptions)(o);
+    if (!o.skipConfirmation) {
+        await (0, utils_js_1.assertConfirmationPrompt)(`Are you sure you want to set the primary name ${name} for address ${signerAddress}?`, o);
+    }
+    return ario.setPrimaryName({ name, fundFrom, referrer });
 }

package/lib/cjs/common/io.js

@@ -101,10 +101,12 @@ class ARIOReadable {
     process;
     epochSettings;
     arweave;
+    hyperbeamUrl;
     paymentProvider; // TODO: this could be an array/map of payment providers
     logger = logger_js_1.Logger.default;
     constructor(config) {
         this.arweave = config?.arweave ?? arweave_js_2.defaultArweave;
+        this.hyperbeamUrl = config?.hyperbeamUrl;
         if (config === undefined || Object.keys(config).length === 0) {
             this.process = new ao_process_js_1.AOProcess({
                 processId: constants_js_1.ARIO_MAINNET_PROCESS_ID,
@@ -684,6 +686,7 @@ class ARIOReadable {
     async getArNSRecordsForAddress(params) {
         const { antRegistryId = constants_js_1.ANT_REGISTRY_ID, address } = params;
         const antRegistry = ant_registry_js_1.ANTRegistry.init({
+            hyperbeamUrl: this.hyperbeamUrl,
             process: new ao_process_js_1.AOProcess({
                 ao: this.process.ao,
                 processId: antRegistryId,
@@ -1194,6 +1197,84 @@ class ARIOWriteable extends ARIOReadable {
             tags: (0, arweave_js_1.pruneTags)(allTags),
         });
     }
+    async setPrimaryName(params, options) {
+        options?.onSigningProgress?.('requesting-primary-name', {
+            name: params.name,
+            fundFrom: params.fundFrom,
+            referrer: params.referrer,
+        });
+        // create the primary name request, if it already exists, get the request and base name owner
+        const requestResult = await this.requestPrimaryName(params, options).catch(async (error) => {
+            // check for the error message, it may be due to the request already being made
+            if (error.message.includes('already exists')) {
+                // parse out the initiator from the error message `		"Primary name request by '" .. initiator .. "' for '" .. name .. "' already exists"
+                const initiator = error.message.match(/by '([^']+)'/)?.[1];
+                if (initiator === undefined) {
+                    throw error;
+                }
+                options?.onSigningProgress?.('request-already-exists', {
+                    name: params.name,
+                    initiator,
+                });
+                // get the primary name request
+                const primaryNameRequest = await this.getPrimaryNameRequest({
+                    initiator,
+                });
+                // check the name exists
+                const arnsRecord = await this.getArNSRecord({ name: params.name });
+                if (arnsRecord === undefined) {
+                    throw new Error(`ARNS name '${params.name}' does not exist`);
+                }
+                if (primaryNameRequest.initiator !== initiator) {
+                    throw new Error(`Primary name request for name '${params.name}' was not approved`);
+                }
+                return {
+                    id: 'stub-id', // stub-id to indicate that the request already exists
+                    result: {
+                        // this is a partial stub of the AoCreatePrimaryNameRequest result
+                        // we only need the request and base name owner for the approval
+                        request: primaryNameRequest,
+                        baseNameOwner: arnsRecord.processId,
+                        fundingPlan: {
+                            address: initiator,
+                        },
+                    },
+                };
+            }
+            // throw any other errors from the contract
+            throw error;
+        });
+        // the result is either a new primary name request or an existing one
+        // for new primary name requests the result includes the request, funding plan, and base name owner
+        // for existing primary name requests the result includes just the request and base name owner (see above)
+        const primaryNameRequest = requestResult.result;
+        const antProcessId = primaryNameRequest?.baseNameOwner;
+        const initiator = primaryNameRequest?.fundingPlan?.address;
+        if (primaryNameRequest === undefined ||
+            initiator === undefined ||
+            antProcessId === undefined) {
+            throw new Error(`Failed to request primary name ${params.name} for ${initiator} owned by ${antProcessId} process`);
+        }
+        options?.onSigningProgress?.('approving-request', {
+            name: params.name,
+            processId: antProcessId,
+            request: primaryNameRequest.request,
+        });
+        const antClient = ant_js_1.ANT.init({
+            process: new ao_process_js_1.AOProcess({
+                processId: antProcessId,
+                ao: this.process.ao,
+            }),
+            signer: this.signer,
+        });
+        // approve the primary name request with the ant
+        const approveResult = await antClient.approvePrimaryNameRequest({
+            name: params.name,
+            address: initiator,
+            arioProcessId: this.process.processId,
+        }, options);
+        return approveResult;
+    }
     /**
      * Redelegate stake from one gateway to another gateway.
      *

package/lib/cjs/utils/ao.js

@@ -362,9 +362,11 @@ function errorMessageFromOutput(output) {
     const error = errorData ??
         output.Messages?.[0]?.Tags?.find((tag) => tag.name === 'Error')?.value;
     if (error !== undefined) {
+        const errorStackTrace = output.Messages?.[0]?.Data;
+        const errorMessage = errorStackTrace ?? error;
         // 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*(.*)/);
+        const match = errorMessage?.match(/\[string "(.+)"\]:(\d+):\s*(.*)/);
         if (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;

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

package/lib/esm/cli/cli.js

@@ -20,7 +20,7 @@ import { AOProcess, spawnANT } from '../node/index.js';
 import { mARIOToken } from '../types/token.js';
 import { version } from '../version.js';
 import { setAntBaseNameCLICommand, setAntRecordCLICommand, } from './commands/antCommands.js';
-import { buyRecordCLICommand, extendLeaseCLICommand, increaseUndernameLimitCLICommand, requestPrimaryNameCLICommand, upgradeRecordCLICommand, } from './commands/arnsPurchaseCommands.js';
+import { buyRecordCLICommand, extendLeaseCLICommand, increaseUndernameLimitCLICommand, requestPrimaryNameCLICommand, setPrimaryNameCLICommand, 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, listAntsForAddress, listArNSRecords, listArNSRecordsForAddress, listArNSReservedNames, listArNSReturnedNames, listGateways, resolveArNSName, } from './commands/readCommands.js';
 import { createVaultCLICommand, extendVaultCLICommand, increaseVaultCLICommand, revokeVaultCLICommand, transferCLICommand, vaultedTransferCLICommand, } from './commands/transfer.js';
@@ -436,6 +436,12 @@ makeCommand({
     options: arnsPurchaseOptions,
     action: requestPrimaryNameCLICommand,
 });
+makeCommand({
+    name: 'set-primary-name',
+    description: 'Set an ArNS name you own as your primary name',
+    options: arnsPurchaseOptions,
+    action: setPrimaryNameCLICommand,
+});
 // # ANT Registry
 makeCommand({
     name: 'get-ants-for-address',

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

@@ -169,8 +169,6 @@ export async function requestPrimaryNameCLICommand(o) {
     const referrer = referrerFromOptions(o);
     const name = requiredStringFromOptions(o, 'name');
     if (!o.skipConfirmation) {
-        // TODO: Assert name requested is not already owned?
-        // TODO: More assertions?
         await assertEnoughBalanceForArNSPurchase({
             ario,
             address: signerAddress,
@@ -183,10 +181,24 @@ export async function requestPrimaryNameCLICommand(o) {
         });
         await assertConfirmationPrompt(`Are you sure you want to request the primary name ${name}?`, o);
     }
-    return ario.requestPrimaryName({
+    const { result } = await ario.requestPrimaryName({
         name,
         fundFrom,
         paidBy: stringArrayFromOptions(o, 'paidBy'),
         referrer,
     }, customTagsFromOptions(o));
+    if (result?.request === undefined) {
+        throw new Error('Failed to request primary name for name ' + name);
+    }
+    return result.request;
+}
+export async function setPrimaryNameCLICommand(o) {
+    const { ario, signerAddress } = writeARIOFromOptions(o);
+    const name = requiredStringFromOptions(o, 'name');
+    const fundFrom = fundFromFromOptions(o);
+    const referrer = referrerFromOptions(o);
+    if (!o.skipConfirmation) {
+        await assertConfirmationPrompt(`Are you sure you want to set the primary name ${name} for address ${signerAddress}?`, o);
+    }
+    return ario.setPrimaryName({ name, fundFrom, referrer });
 }

package/lib/esm/common/io.js

@@ -97,10 +97,12 @@ export class ARIOReadable {
     process;
     epochSettings;
     arweave;
+    hyperbeamUrl;
     paymentProvider; // TODO: this could be an array/map of payment providers
     logger = Logger.default;
     constructor(config) {
         this.arweave = config?.arweave ?? defaultArweave;
+        this.hyperbeamUrl = config?.hyperbeamUrl;
         if (config === undefined || Object.keys(config).length === 0) {
             this.process = new AOProcess({
                 processId: ARIO_MAINNET_PROCESS_ID,
@@ -680,6 +682,7 @@ export class ARIOReadable {
     async getArNSRecordsForAddress(params) {
         const { antRegistryId = ANT_REGISTRY_ID, address } = params;
         const antRegistry = ANTRegistry.init({
+            hyperbeamUrl: this.hyperbeamUrl,
             process: new AOProcess({
                 ao: this.process.ao,
                 processId: antRegistryId,
@@ -1189,6 +1192,84 @@ export class ARIOWriteable extends ARIOReadable {
             tags: pruneTags(allTags),
         });
     }
+    async setPrimaryName(params, options) {
+        options?.onSigningProgress?.('requesting-primary-name', {
+            name: params.name,
+            fundFrom: params.fundFrom,
+            referrer: params.referrer,
+        });
+        // create the primary name request, if it already exists, get the request and base name owner
+        const requestResult = await this.requestPrimaryName(params, options).catch(async (error) => {
+            // check for the error message, it may be due to the request already being made
+            if (error.message.includes('already exists')) {
+                // parse out the initiator from the error message `		"Primary name request by '" .. initiator .. "' for '" .. name .. "' already exists"
+                const initiator = error.message.match(/by '([^']+)'/)?.[1];
+                if (initiator === undefined) {
+                    throw error;
+                }
+                options?.onSigningProgress?.('request-already-exists', {
+                    name: params.name,
+                    initiator,
+                });
+                // get the primary name request
+                const primaryNameRequest = await this.getPrimaryNameRequest({
+                    initiator,
+                });
+                // check the name exists
+                const arnsRecord = await this.getArNSRecord({ name: params.name });
+                if (arnsRecord === undefined) {
+                    throw new Error(`ARNS name '${params.name}' does not exist`);
+                }
+                if (primaryNameRequest.initiator !== initiator) {
+                    throw new Error(`Primary name request for name '${params.name}' was not approved`);
+                }
+                return {
+                    id: 'stub-id', // stub-id to indicate that the request already exists
+                    result: {
+                        // this is a partial stub of the AoCreatePrimaryNameRequest result
+                        // we only need the request and base name owner for the approval
+                        request: primaryNameRequest,
+                        baseNameOwner: arnsRecord.processId,
+                        fundingPlan: {
+                            address: initiator,
+                        },
+                    },
+                };
+            }
+            // throw any other errors from the contract
+            throw error;
+        });
+        // the result is either a new primary name request or an existing one
+        // for new primary name requests the result includes the request, funding plan, and base name owner
+        // for existing primary name requests the result includes just the request and base name owner (see above)
+        const primaryNameRequest = requestResult.result;
+        const antProcessId = primaryNameRequest?.baseNameOwner;
+        const initiator = primaryNameRequest?.fundingPlan?.address;
+        if (primaryNameRequest === undefined ||
+            initiator === undefined ||
+            antProcessId === undefined) {
+            throw new Error(`Failed to request primary name ${params.name} for ${initiator} owned by ${antProcessId} process`);
+        }
+        options?.onSigningProgress?.('approving-request', {
+            name: params.name,
+            processId: antProcessId,
+            request: primaryNameRequest.request,
+        });
+        const antClient = ANT.init({
+            process: new AOProcess({
+                processId: antProcessId,
+                ao: this.process.ao,
+            }),
+            signer: this.signer,
+        });
+        // approve the primary name request with the ant
+        const approveResult = await antClient.approvePrimaryNameRequest({
+            name: params.name,
+            address: initiator,
+            arioProcessId: this.process.processId,
+        }, options);
+        return approveResult;
+    }
     /**
      * Redelegate stake from one gateway to another gateway.
      *

package/lib/esm/utils/ao.js

@@ -351,9 +351,11 @@ export function errorMessageFromOutput(output) {
     const error = errorData ??
         output.Messages?.[0]?.Tags?.find((tag) => tag.name === 'Error')?.value;
     if (error !== undefined) {
+        const errorStackTrace = output.Messages?.[0]?.Data;
+        const errorMessage = errorStackTrace ?? error;
         // 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*(.*)/);
+        const match = errorMessage?.match(/\[string "(.+)"\]:(\d+):\s*(.*)/);
         if (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;

package/lib/esm/version.js

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

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

@@ -4,4 +4,7 @@ export declare function buyRecordCLICommand(o: CLIWriteOptionsFromAoParams<AoBuy
 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<Record<string, string | number | boolean | null>>>;
+export declare function requestPrimaryNameCLICommand(o: CLIWriteOptionsFromAoParams<AoArNSPurchaseParams>): Promise<Omit<import("../../types/common.js").AoPrimaryNameRequest, "initiator"> & {
+    initiator: import("../../types/common.js").WalletAddress;
+}>;
+export declare function setPrimaryNameCLICommand(o: CLIWriteOptionsFromAoParams<AoArNSPurchaseParams>): Promise<import("../../types/common.js").AoMessageResult<Record<string, string | number | boolean | null>>>;

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

@@ -1,10 +1,14 @@
 import Arweave from 'arweave';
-import { ARIOWithFaucet, AoARIORead, AoARIOWrite, AoAllDelegates, AoAllGatewayVaults, AoArNSNameData, AoArNSNameDataWithName, AoArNSPurchaseParams, AoArNSReservedNameData, AoArNSReservedNameDataWithName, AoBalanceWithAddress, AoBuyRecordParams, AoCreateVaultParams, AoDelegation, AoEligibleDistribution, AoEpochData, AoEpochDistributed, AoEpochDistributionData, AoEpochDistributionTotalsData, AoEpochObservationData, AoEpochSettings, AoExtendLeaseParams, AoExtendVaultParams, AoGateway, AoGatewayDelegateWithAddress, AoGatewayRegistrySettings, AoGatewayVault, AoGatewayWithAddress, AoGetCostDetailsParams, AoIncreaseUndernameLimitParams, AoIncreaseVaultParams, AoJoinNetworkParams, AoMessageResult, AoPaginatedAddressParams, AoPrimaryName, AoPrimaryNameRequest, AoRedelegationFeeInfo, AoRegistrationFees, AoReturnedName, AoRevokeVaultParams, AoTokenSupplyData, AoUpdateGatewaySettingsParams, AoVaultData, AoVaultedTransferParams, AoWalletVault, AoWeightedObserver, ArNSNameResolutionData, ArNSNameResolver, BuyArNSNameProgressEvents, CostDetailsResult, DemandFactorSettings, EpochInput, OptionalArweave, OptionalPaymentUrl, PaginationParams, PaginationResult, ProcessConfiguration, TransactionId, WalletAddress, WithSigner, WriteOptions, mARIOToken } from '../types/index.js';
+import { ARIOWithFaucet, AoARIORead, AoARIOWrite, AoAllDelegates, AoAllGatewayVaults, AoArNSNameData, AoArNSNameDataWithName, AoArNSPurchaseParams, AoArNSReservedNameData, AoArNSReservedNameDataWithName, AoBalanceWithAddress, AoBuyRecordParams, AoCreatePrimaryNameRequest, AoCreateVaultParams, AoDelegation, AoEligibleDistribution, AoEpochData, AoEpochDistributed, AoEpochDistributionData, AoEpochDistributionTotalsData, AoEpochObservationData, AoEpochSettings, AoExtendLeaseParams, AoExtendVaultParams, AoGateway, AoGatewayDelegateWithAddress, AoGatewayRegistrySettings, AoGatewayVault, AoGatewayWithAddress, AoGetCostDetailsParams, AoIncreaseUndernameLimitParams, AoIncreaseVaultParams, AoJoinNetworkParams, AoMessageResult, AoPaginatedAddressParams, AoPrimaryName, AoPrimaryNameRequest, AoRedelegationFeeInfo, AoRegistrationFees, AoReturnedName, AoRevokeVaultParams, AoTokenSupplyData, AoUpdateGatewaySettingsParams, AoVaultData, AoVaultedTransferParams, AoWalletVault, AoWeightedObserver, ArNSNameResolutionData, ArNSNameResolver, BuyArNSNameProgressEvents, CostDetailsResult, DemandFactorSettings, EpochInput, OptionalArweave, OptionalPaymentUrl, PaginationParams, PaginationResult, ProcessConfiguration, SetPrimaryNameProgressEvents, TransactionId, WalletAddress, WithSigner, WriteOptions, mARIOToken } from '../types/index.js';
 import { AOProcess } from './contracts/ao-process.js';
 import { Logger } from './logger.js';
 import { TurboArNSPaymentProviderAuthenticated, TurboArNSPaymentProviderUnauthenticated } from './turbo.js';
-type ARIOConfigNoSigner = OptionalPaymentUrl<OptionalArweave<ProcessConfiguration>>;
-type ARIOConfigWithSigner = WithSigner<OptionalPaymentUrl<OptionalArweave<ProcessConfiguration>>>;
+type ARIOConfigNoSigner = OptionalPaymentUrl<OptionalArweave<ProcessConfiguration & {
+    hyperbeamUrl?: string;
+}>>;
+type ARIOConfigWithSigner = WithSigner<OptionalPaymentUrl<OptionalArweave<ProcessConfiguration & {
+    hyperbeamUrl?: string;
+}>>>;
 export declare class ARIO {
     static init(): AoARIORead;
     static init(config: ARIOConfigWithSigner): AoARIOWrite;
@@ -24,6 +28,7 @@ export declare class ARIOReadable implements AoARIORead, ArNSNameResolver {
     readonly process: AOProcess;
     protected epochSettings: AoEpochSettings | undefined;
     protected arweave: Arweave;
+    protected hyperbeamUrl: string | undefined;
     protected paymentProvider: TurboArNSPaymentProviderUnauthenticated;
     protected logger: Logger;
     constructor(config?: ARIOConfigNoSigner);
@@ -236,7 +241,8 @@ export declare class ARIOWriteable extends ARIOReadable implements AoARIOWrite {
         gatewayAddress?: WalletAddress;
         vaultId: string;
     }, options?: WriteOptions | undefined): Promise<AoMessageResult>;
-    requestPrimaryName(params: AoArNSPurchaseParams, options?: WriteOptions): Promise<AoMessageResult>;
+    requestPrimaryName(params: AoArNSPurchaseParams, options?: WriteOptions): Promise<AoMessageResult<AoCreatePrimaryNameRequest>>;
+    setPrimaryName(params: AoArNSPurchaseParams, options?: WriteOptions<keyof SetPrimaryNameProgressEvents, SetPrimaryNameProgressEvents[keyof SetPrimaryNameProgressEvents]>): Promise<AoMessageResult>;
     /**
      * Redelegate stake from one gateway to another gateway.
      *

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

@@ -17,7 +17,7 @@ import { ArconnectSigner, ArweaveSigner, EthereumSigner, InjectedEthereumSigner,
 import { dryrun, message, monitor, result, results, spawn, unmonitor } from '@permaweb/aoconnect';
 import Arweave from 'arweave';
 import { SpawnANTState } from './ant.js';
-import { AoBuyRecordParams } from './io.js';
+import { AoArNSPurchaseParams, AoBuyRecordParams } from './io.js';
 import { AoSigner } from './token.js';
 export type BlockHeight = number;
 export type SortKey = string;
@@ -61,6 +61,16 @@ export type AoPrimaryNameRequest = {
     startTimestamp: Timestamp;
     endTimestamp: Timestamp;
 };
+export type AoCreatePrimaryNameRequest = {
+    request: Omit<AoPrimaryNameRequest, 'initiator'> & {
+        initiator: WalletAddress;
+    };
+    newPrimaryName: AoPrimaryName;
+    baseNameOwner: WalletAddress;
+    fundingPlan: Record<string, unknown>;
+    fundingResult: Record<string, unknown>;
+    demandFactor: Record<string, unknown>;
+};
 export type AoPrimaryName = {
     owner: WalletAddress;
     processId: ProcessId;
@@ -119,6 +129,18 @@ export type SpawnAntProgressEvent = {
 export type BuyArNSNameProgressEvents = SpawnAntProgressEvent & {
     'buying-name': AoBuyRecordParams;
 };
+export type SetPrimaryNameProgressEvents = {
+    'requesting-primary-name': AoArNSPurchaseParams;
+    'request-already-exists': {
+        name: string;
+        initiator: WalletAddress;
+    };
+    'approving-request': {
+        request: AoPrimaryNameRequest;
+        name: string;
+        processId: ProcessId;
+    };
+};
 export interface AOContract {
     read<K>({ tags, retries, }: {
         tags?: {

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

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 import { AOProcess } from '../common/index.js';
-import { AoMessageResult, AoPrimaryName, AoPrimaryNameRequest, AoRedelegationFeeInfo, AoWriteAction, AtLeastOne, BlockHeight, ProcessId, Timestamp, TransactionId, WalletAddress, WriteOptions } from './index.js';
+import { AoCreatePrimaryNameRequest, AoMessageResult, AoPrimaryName, AoPrimaryNameRequest, AoRedelegationFeeInfo, AoWriteAction, AtLeastOne, BlockHeight, ProcessId, Timestamp, TransactionId, WalletAddress, WriteOptions } from './index.js';
 import { mARIOToken } from './token.js';
 type NestedKeys<T> = T extends object ? T extends readonly unknown[] ? never : {
     [K in keyof T & string]: T[K] extends object ? `${K}.${NestedKeys<T[K]>}` : K;
@@ -555,7 +555,8 @@ export interface AoARIOWrite extends AoARIORead {
         gatewayAddress?: WalletAddress;
         vaultId: string;
     }>;
-    requestPrimaryName: AoWriteAction<AoArNSPurchaseParams>;
+    requestPrimaryName(params: AoArNSPurchaseParams, options?: WriteOptions): Promise<AoMessageResult<AoCreatePrimaryNameRequest>>;
+    setPrimaryName: AoWriteAction<AoArNSPurchaseParams>;
     redelegateStake: AoWriteAction<AoRedelegateStakeParams>;
 }
 export declare function isProcessConfiguration(config: object | undefined): config is Required<ProcessConfiguration> & Record<string, never>;

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

@@ -59,6 +59,7 @@ export declare function errorMessageFromOutput(output: {
             name: string;
             value: string;
         }[];
+        Data?: string;
     }[];
 }): string | undefined;
 export declare function removeUnicodeFromError(error: string): string;

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

package/package.json

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