feat(mainnet): use mainnet process ID by default

BREAKING CHANGE: SDK and CLI will not longer go to AR.IO Testnet by default

README.md

@@ -2299,7 +2299,7 @@ _Note: Requires `signer` to be provided on `ANT.init` to sign the transaction._
 ```typescript
 const { id: txId } = await ant.releaseName({
   name: 'permalink',
-  arioProcessId: ARIO_TESTNET_PROCESS_ID, // releases the name owned by the ANT and sends it to recently returned names on the ARIO contract
+  arioProcessId: ARIO_MAINNET_PROCESS_ID, // releases the name owned by the ANT and sends it to recently returned names on the ARIO contract
 });
 ```
 
@@ -2312,7 +2312,7 @@ _Note: Requires `signer` to be provided on `ANT.init` to sign the transaction._
 ```typescript
 const { id: txId } = await ant.reassignName({
   name: 'ardrive',
-  arioProcessId: ARIO_TESTNET_PROCESS_ID,
+  arioProcessId: ARIO_MAINNET_PROCESS_ID,
   antProcessId: NEW_ANT_PROCESS_ID, // the new ANT process id that will take over ownership of the name
 });
 ```
@@ -2327,7 +2327,7 @@ _Note: Requires `signer` to be provided on `ANT.init` to sign the transaction._
 const { id: txId } = await ant.approvePrimaryNameRequest({
   name: 'arns',
   address: 't4Xr0_J4Iurt7caNST02cMotaz2FIbWQ4Kbj616RHl3', // must match the request initiator address
-  arioProcessId: ARIO_TESTNET_PROCESS_ID, // the ARIO process id to use for the request
+  arioProcessId: ARIO_MAINNET_PROCESS_ID, // the ARIO process id to use for the request
 });
 ```
 
@@ -2340,7 +2340,7 @@ _Note: Requires `signer` to be provided on `ANT.init` to sign the transaction._
 ```typescript
 const { id: txId } = await ant.removePrimaryNames({
   names: ['arns', 'test_arns'], // any primary names associated with a base name controlled by this ANT will be removed
-  arioProcessId: ARIO_TESTNET_PROCESS_ID,
+  arioProcessId: ARIO_MAINNET_PROCESS_ID,
   notifyOwners: true, // if true, the owners of the removed names will be send AO messages to notify them of the removal
 });
 ```

examples/cjs/index.cjs

@@ -1,4 +1,4 @@
-const { ARIO, Logger, ARIO_TESTNET_PROCESS_ID } = require('@ar.io/sdk');
+const { ARIO, Logger, ARIO_MAINNET_PROCESS_ID } = require('@ar.io/sdk');
 
 (async () => {
   // set the log level for the SDK
@@ -8,7 +8,7 @@ const { ARIO, Logger, ARIO_TESTNET_PROCESS_ID } = require('@ar.io/sdk');
   // testnet gateways
   const testnetGateways = await arIO.getGateways();
   const protocolBalance = await arIO.getBalance({
-    address: ARIO_TESTNET_PROCESS_ID,
+    address: ARIO_MAINNET_PROCESS_ID,
   });
   const ardriveRecord = await arIO.getArNSRecord({ name: 'ardrive' });
   const partialRecords = await arIO.getArNSRecords({

examples/esm/index.mjs

@@ -1,15 +1,15 @@
 import {
   ANT,
   ARIO,
-  ARIO_TESTNET_PROCESS_ID,
+  ARIO_MAINNET_PROCESS_ID,
   getANTProcessesOwnedByWallet,
 } from '@ar.io/sdk';
 
 (async () => {
   const arIO = ARIO.init();
   const testnetGateways = await arIO.getGateways();
   const protocolBalance = await arIO.getBalance({
-    address: ARIO_TESTNET_PROCESS_ID,
+    address: ARIO_MAINNET_PROCESS_ID,
   });
   const contractInfo = await arIO.getInfo();
   const ardriveRecord = await arIO.getArNSRecord({ name: 'ardrive' });

src/cli/options.ts

@@ -27,8 +27,13 @@ export const optionMap = {
     alias: '--private-key <key>',
     description: 'Stringified private key to use with the action',
   },
-  dev: {
-    alias: '--dev',
+  testnet: {
+    alias: '--testnet',
+    description: 'Run against the AR.IO testnet process',
+    type: 'boolean',
+  },
+  devnet: {
+    alias: '--dev, --devnet',
     description: 'Run against the AR.IO devnet process',
     type: 'boolean',
   },
@@ -271,7 +276,8 @@ export const walletOptions = [
 
 export const globalOptions = [
   ...walletOptions,
-  optionMap.dev,
+  optionMap.devnet,
+  optionMap.testnet,
   optionMap.debug,
   optionMap.arioProcessId,
   optionMap.cuUrl,

src/cli/types.ts

@@ -29,7 +29,8 @@ export type WalletCLIOptions = {
 };
 
 export type GlobalCLIOptions = WalletCLIOptions & {
-  dev: boolean;
+  devnet: boolean;
+  testnet: boolean;
   debug: boolean;
   arioProcessId?: string;
   cuUrl?: string;

src/cli/utils.ts

@@ -25,6 +25,7 @@ import {
   ARIO,
   ARIOToken,
   ARIO_DEVNET_PROCESS_ID,
+  ARIO_MAINNET_PROCESS_ID,
   ARIO_TESTNET_PROCESS_ID,
   AoANTRead,
   AoANTWrite,
@@ -149,13 +150,16 @@ export function makeCommand<O extends OptionValues = GlobalCLIOptions>({
 
 export function arioProcessIdFromOptions({
   arioProcessId,
-  dev,
+  testnet,
+  devnet,
 }: GlobalCLIOptions): string {
   return arioProcessId !== undefined
     ? arioProcessId
-    : dev
-      ? ARIO_DEVNET_PROCESS_ID
-      : ARIO_TESTNET_PROCESS_ID;
+    : testnet
+      ? ARIO_TESTNET_PROCESS_ID
+      : devnet
+        ? ARIO_DEVNET_PROCESS_ID
+        : ARIO_MAINNET_PROCESS_ID;
 }
 
 function jwkFromOptions({

src/common/ant.ts

@@ -642,7 +642,7 @@ export class AoANTWriteable extends AoANTReadable implements AoANTWrite {
    * @returns {Promise<AoMessageResult>} The result of the interaction.
    * @example
    * ```ts
-   * ant.releaseName({ name: "ardrive", arioProcessId: AR_TESTNET_PROCESS_ID });
+   * ant.releaseName({ name: "ardrive", arioProcessId: AR_MAINNET_PROCESS_ID });
    * ```
    */
   async releaseName(
@@ -670,7 +670,7 @@ export class AoANTWriteable extends AoANTReadable implements AoANTWrite {
    * @returns {Promise<AoMessageResult>} The result of the interaction.
    * @example
    * ```ts
-   * ant.reassignName({ name: "ardrive", arioProcessId: ARIO_TESTNET_PROCESS_ID, antProcessId: NEW_ANT_PROCESS_ID });
+   * ant.reassignName({ name: "ardrive", arioProcessId: ARIO_MAINNET_PROCESS_ID, antProcessId: NEW_ANT_PROCESS_ID });
    * ```
    */
   async reassignName(
@@ -703,7 +703,7 @@ export class AoANTWriteable extends AoANTReadable implements AoANTWrite {
    * @returns {Promise<AoMessageResult>} The result of the interaction.
    * @example
    * ```ts
-   * ant.approvePrimaryNameRequest({ name: "ardrive", address: "U7RXcpaVShG4u9nIcPVmm2FJSM5Gru9gQCIiRaIPV7f", arioProcessId: ARIO_TESTNET_PROCESS_ID }); // approves the request for ardrive.ar.io to be registered by the address
+   * ant.approvePrimaryNameRequest({ name: "ardrive", address: "U7RXcpaVShG4u9nIcPVmm2FJSM5Gru9gQCIiRaIPV7f", arioProcessId: ARIO_MAINNET_PROCESS_ID }); // approves the request for ardrive.ar.io to be registered by the address
    * ```
    */
   async approvePrimaryNameRequest(
@@ -736,7 +736,7 @@ export class AoANTWriteable extends AoANTReadable implements AoANTWrite {
    * @returns {Promise<AoMessageResult>} The result of the interaction.
    * @example
    * ```ts
-   * ant.removePrimaryNames({ names: ["ardrive", "dapp_ardrive"], arioProcessId: ARIO_TESTNET_PROCESS_ID, notifyOwners: true }); // removes the primary names and associated wallet addresses assigned to "ardrive" and "dapp_ardrive"
+   * ant.removePrimaryNames({ names: ["ardrive", "dapp_ardrive"], arioProcessId: ARIO_MAINNET_PROCESS_ID, notifyOwners: true }); // removes the primary names and associated wallet addresses assigned to "ardrive" and "dapp_ardrive"
    * ```
    */
   async removePrimaryNames(

src/common/io.ts

@@ -15,7 +15,7 @@
  */
 import Arweave from 'arweave';
 
-import { ARIO_TESTNET_PROCESS_ID } from '../constants.js';
+import { ARIO_MAINNET_PROCESS_ID } from '../constants.js';
 import {
   AoArNSNameDataWithName,
   AoArNSReservedNameData,
@@ -118,7 +118,7 @@ export class ARIOReadable implements AoARIORead {
     this.arweave = config?.arweave ?? defaultArweave;
     if (config === undefined || Object.keys(config).length === 0) {
       this.process = new AOProcess({
-        processId: ARIO_TESTNET_PROCESS_ID,
+        processId: ARIO_MAINNET_PROCESS_ID,
       });
     } else if (isProcessConfiguration(config)) {
       this.process = config.process;
@@ -759,7 +759,7 @@ export class ARIOWriteable extends ARIOReadable implements AoARIOWrite {
     if (config === undefined) {
       super({
         process: new AOProcess({
-          processId: ARIO_TESTNET_PROCESS_ID,
+          processId: ARIO_MAINNET_PROCESS_ID,
         }),
       });
     } else {

src/constants.ts

@@ -37,6 +37,8 @@ export const arioDevnetProcessId = ARIO_DEVNET_PROCESS_ID;
 export const ARIO_TESTNET_PROCESS_ID =
   'agYcCFJtrMG6cqMuZfskIkFTGvUPddICmtQSBIoPdiA';
 
+export const ARIO_MAINNET_PROCESS_ID = 'placeholder'; // TODO: update when mainnet process ID is available
+
 export const ANT_REGISTRY_ID = 'i_le_yKKPVstLTDSmkHRqf-wYphMnwB9OhleiTgMkWc';
 export const MARIO_PER_ARIO = 1_000_000;
 export const AOS_MODULE_ID = 'acdKHzHAG-RVC06nNVlX3jIXvomfiBnA5NZTEPYOMv8';

src/utils/arweave.ts

@@ -15,7 +15,7 @@
  */
 import Arweave from 'arweave';
 
-import { ARIO_TESTNET_PROCESS_ID, ARWEAVE_TX_REGEX } from '../constants.js';
+import { ARIO_MAINNET_PROCESS_ID, ARWEAVE_TX_REGEX } from '../constants.js';
 import { BlockHeight } from '../types/common.js';
 import { AoEpochData, PaginationParams } from '../types/io.js';
 import { parseAoEpochData } from './ao.js';
@@ -66,7 +66,7 @@ export const paginationParamsToTags = <T>(
 export const getEpochDataFromGql = async ({
   arweave,
   epochIndex,
-  processId = ARIO_TESTNET_PROCESS_ID,
+  processId = ARIO_MAINNET_PROCESS_ID,
   retries = 3,
 }: {
   arweave: Arweave;
@@ -104,12 +104,12 @@ export const getEpochDataFromGql = async ({
  * Get the epoch with distribution data for the current epoch
  * @param arweave - The Arweave instance
  * @param epochIndex - The index of the epoch
- * @param processId - The process ID (optional, defaults to ARIO_TESTNET_PROCESS_ID)
+ * @param processId - The process ID (optional, defaults to ARIO_MAINNET_PROCESS_ID)
  * @returns string - The stringified GQL query
  */
 export const epochDistributionNoticeGqlQuery = ({
   epochIndex,
-  processId = ARIO_TESTNET_PROCESS_ID,
+  processId = ARIO_MAINNET_PROCESS_ID,
 }: {
   epochIndex: number;
   processId?: string;

src/utils/processes.ts

@@ -22,7 +22,7 @@ import { ANT } from '../common/ant.js';
 import { AOProcess } from '../common/index.js';
 import { ARIO } from '../common/io.js';
 import { ILogger, Logger } from '../common/logger.js';
-import { ARIO_TESTNET_PROCESS_ID } from '../constants.js';
+import { ARIO_MAINNET_PROCESS_ID } from '../constants.js';
 import { AoANTRegistryRead } from '../types/ant-registry.js';
 import { AoANTState } from '../types/ant.js';
 import {
@@ -74,7 +74,7 @@ export class ArNSEventEmitter extends EventEmitter {
   private antAoClient: AoClient;
   constructor({
     contract = ARIO.init({
-      processId: ARIO_TESTNET_PROCESS_ID,
+      processId: ARIO_MAINNET_PROCESS_ID,
     }),
     timeoutMs = 60_000,
     concurrency = 30,
@@ -192,7 +192,7 @@ export class ArNSEventEmitter extends EventEmitter {
 
 export const fetchAllArNSRecords = async ({
   contract = ARIO.init({
-    processId: ARIO_TESTNET_PROCESS_ID,
+    processId: ARIO_MAINNET_PROCESS_ID,
   }),
   emitter,
   logger = Logger.default,

tests/e2e/esm/index.test.ts

@@ -10,7 +10,7 @@ import {
   ARIO,
   ARIOReadable,
   ARIOWriteable,
-  ARIO_TESTNET_PROCESS_ID,
+  ARIO_MAINNET_PROCESS_ID,
   AoANTReadable,
   AoANTRegistryWriteable,
   AoANTWriteable,
@@ -50,7 +50,7 @@ const ario = ARIO.init({
 });
 
 // epochs with known distribution data notices
-const epochIndex = processId === ARIO_TESTNET_PROCESS_ID ? 189 : 200;
+const epochIndex = processId === ARIO_MAINNET_PROCESS_ID ? 189 : 200;
 
 describe('e2e esm tests', async () => {
   let compose;