@ar.io/sdk 3.7.1 → 3.8.1

package/README.md

@@ -13,6 +13,7 @@ This is the home of [ar.io] SDK. This SDK provides functionality for interacting
 - [Installation](#installation)
 - [Quick Start](#quick-start)
 - [Usage](#usage)
+  - [Mainnet and Testnet Process IDs](#mainnet-and-testnet-process-ids)
   - [Web](#web)
     - [Bundlers (Webpack, Rollup, ESbuild, etc.)](#bundlers-webpack-rollup-esbuild-etc)
     - [Browser](#browser)
@@ -150,9 +151,9 @@ yarn add @ar.io/sdk --ignore-engines
 ## Quick Start
 
 ```typescript
-import { ARIO } from '@ar.io/sdk';
+import { ARIO, ARIO_MAINNET_PROCESS_ID } from '@ar.io/sdk';
 
-const ario = ARIO.init();
+const ario = ARIO.init({ processId: ARIO_MAINNET_PROCESS_ID });
 const gateways = await ario.getGateways();
 ```
 
@@ -208,15 +209,36 @@ const gateways = await ario.getGateways();
 
 The SDK is provided in both CommonJS and ESM formats and is compatible with bundlers such as Webpack, Rollup, and ESbuild. Utilize the appropriately named exports provided by this SDK's [package.json] based on your project's configuration. Refer to the [examples] directory to see how to use the SDK in various environments.
 
+### Mainnet and Testnet Process IDs
+
+The SDK provides the following process IDs for the mainnet and testnet environments:
+
+- `ARIO_MAINNET_PROCESS_ID` - Mainnet ARIO process ID
+- `ARIO_TESTNET_PROCESS_ID` - Testnet ARIO process ID
+
+```typescript
+import {
+  ARIO,
+  ARIO_MAINNET_PROCESS_ID,
+  ARIO_TESTNET_PROCESS_ID,
+} from '@ar.io/sdk';
+```
+
+By default, the SDK will use the mainnet process ID. To use the testnet process ID, provide the `ARIO_TESTNET_PROCESS_ID` when initializing the client.
+
+```typescript
+const ario = ARIO.init({ processId: ARIO_TESTNET_PROCESS_ID });
+```
+
 ### Web
 
 #### Bundlers (Webpack, Rollup, ESbuild, etc.)
 
 ```javascript
-import { ARIO } from '@ar.io/sdk/web';
+import { ARIO, ARIO_MAINNET_PROCESS_ID } from '@ar.io/sdk/web';
 
 // set up client
-const ario = ARIO.init();
+const ario = ARIO.init({ processId: ARIO_MAINNET_PROCESS_ID });
 // fetch gateways
 const gateways = await ario.getGateways();
 ```
@@ -228,10 +250,10 @@ const gateways = await ario.getGateways();
 
 ```html
 <script type="module">
-  import { ARIO } from 'https://unpkg.com/@ar.io/sdk';
+  import { ARIO, ARIO_MAINNET_PROCESS_ID } from 'https://unpkg.com/@ar.io/sdk';
 
   // set up client
-  const ario = ARIO.init();
+  const ario = ARIO.init({ processId: ARIO_MAINNET_PROCESS_ID });
   // fetch gateways
   const gateways = await ario.getGateways();
 </script>
@@ -242,10 +264,10 @@ const gateways = await ario.getGateways();
 #### ESM (NodeNext)
 
 ```javascript
-import { ARIO } from '@ar.io/sdk/node';
+import { ARIO, ARIO_MAINNET_PROCESS_ID } from '@ar.io/sdk/node';
 
 // set up client
-const ario = ARIO.init();
+const ario = ARIO.init({ processId: ARIO_MAINNET_PROCESS_ID });
 // fetch gateways
 const gateways = await ario.getGateways();
 ```
@@ -253,10 +275,10 @@ const gateways = await ario.getGateways();
 #### CJS
 
 ```javascript
-import { ARIO } from '@ar.io/sdk';
+import { ARIO, ARIO_MAINNET_PROCESS_ID } from '@ar.io/sdk';
 
 // set up client
-const ario = ARIO.init();
+const ario = ARIO.init({ processId: ARIO_MAINNET_PROCESS_ID });
 // fetch gateways
 const gateways = await ario.getGateways();
 ```
@@ -296,13 +318,13 @@ Factory function to that creates a read-only or writeable client. By providing a
 
 ```typescript
 // read-only client
-const ario = ARIO.init()
+const ario = ARIO.init({ processId: ARIO_MAINNET_PROCESS_ID });
 
 // read-write client for browser environments
-const ario = ARIO.init({ signer: new ArConnectSigner(window.arweaveWallet, Arweave.init({}))});
+const ario = ARIO.init({ processId: ARIO_MAINNET_PROCESS_ID, signer: new ArConnectSigner(window.arweaveWallet, Arweave.init({}))});
 
 // read-write client for node environments
-const ario = ARIO.init({ signer: new ArweaveSigner(JWK) });
+const ario = ARIO.init({ processId: ARIO_MAINNET_PROCESS_ID, signer: new ArweaveSigner(JWK) });
 
 ```
 
@@ -311,7 +333,7 @@ const ario = ARIO.init({ signer: new ArweaveSigner(JWK) });
 Retrieves the information of the ARIO process.
 
 ```typescript
-const ario = ARIO.init();
+const ario = ARIO.init({ processId: ARIO_MAINNET_PROCESS_ID });
 const info = await ario.getInfo();
 ```
 
@@ -345,7 +367,7 @@ Retrieves the total supply of tokens, returned in mARIO. The total supply includ
 - `protocolBalance` - tokens that are held in the protocol's treasury. This is included in the circulating supply.
 
 ```typescript
-const ario = ARIO.init();
+const ario = ARIO.init({ processId: ARIO_MAINNET_PROCESS_ID });
 const supply = await ario.getTokenSupply();
 ```
 
@@ -371,7 +393,7 @@ const supply = await ario.getTokenSupply();
 Retrieves the balance of the specified wallet address.
 
 ```typescript
-const ario = ARIO.init();
+const ario = ARIO.init({ processId: ARIO_MAINNET_PROCESS_ID });
 // the balance will be returned in mARIO as a value
 const balance = await ario
   .getBalance({
@@ -394,7 +416,7 @@ const balance = await ario
 Retrieves the balances of the ARIO process in `mARIO`, paginated and sorted by the specified criteria. The `cursor` used for pagination is the last wallet address from the previous request.
 
 ```typescript
-const ario = ARIO.init();
+const ario = ARIO.init({ processId: ARIO_MAINNET_PROCESS_ID });
 const balances = await ario.getBalances({
   cursor: '-4xgjroXENKYhTWqrBo57HQwvDL51mMdfsdsxJy6Y2Z_sA',
   limit: 100,
@@ -436,7 +458,10 @@ Transfers `mARIO` to the designated `target` recipient address. Requires `signer
 _Note: Requires `signer` to be provided on `ARIO.init` to sign the transaction._
 
 ```typescript
-const ario = ARIO.init({ signer: new ArweaveSigner(jwk) });
+const ario = ARIO.init({
+  processId: ARIO_MAINNET_PROCESS_ID,
+  signer: new ArweaveSigner(jwk),
+});
 const { id: txId } = await ario.transfer(
   {
     target: '-5dV7nk7waR8v4STuwPnTck1zFVkQqJh5K9q9Zik4Y5',
@@ -454,7 +479,7 @@ const { id: txId } = await ario.transfer(
 Retrieves the locked-balance user vault of the ARIO process by the specified wallet address and vault ID.
 
 ```typescript
-const ario = ARIO.init();
+const ario = ARIO.init({ processId: ARIO_MAINNET_PROCESS_ID });
 const vault = await ario.getVault({
   address: 'QGWqtJdLLgm2ehFWiiPzMaoFLD50CnGuzZIPEdoDRGQ',
   vaultId: 'vaultIdOne',
@@ -479,7 +504,7 @@ const vault = await ario.getVault({
 Retrieves all locked-balance user vaults of the ARIO process, paginated and sorted by the specified criteria. The `cursor` used for pagination is the last wallet address from the previous request.
 
 ```typescript
-const ario = ARIO.init();
+const ario = ARIO.init({ processId: ARIO_MAINNET_PROCESS_ID });
 const vaults = await ario.getVaults({
   cursor: '0',
   limit: 100,
@@ -547,7 +572,10 @@ Revokes a vaulted transfer by the recipient address and vault ID. Only the sende
 _Note: Requires `signer` to be provided on `ARIO.init` to sign the transaction._
 
 ```typescript
-const ario = ARIO.init({ signer: new ArweaveSigner(jwk) });
+const ario = ARIO.init({
+  processId: ARIO_MAINNET_PROCESS_ID,
+  signer: new ArweaveSigner(jwk),
+});
 const { id: txId } = await ario.revokeVault({
   recipient: '-5dV7nk7waR8v4STuwPnTck1zFVkQqJh5K9q9Zik4Y5',
   vaultId: 'IPdwa3Mb_9pDD8c2IaJx6aad51Ss-_TfStVwBuhtXMs',
@@ -559,7 +587,10 @@ const { id: txId } = await ario.revokeVault({
 Creates a vault for the specified `quantity` of mARIO from the signer's balance and locks it for the specified `lockLengthMs` milliseconds.
 
 ```typescript
-const ario = ARIO.init({ signer: new ArweaveSigner(jwk) });
+const ario = ARIO.init({
+  processId: ARIO_MAINNET_PROCESS_ID,
+  signer: new ArweaveSigner(jwk),
+});
 
 const { id: txId } = await ario.createVault({
   lockLengthMs: 1000 * 60 * 60 * 24 * 365, // 1 year
@@ -572,7 +603,10 @@ const { id: txId } = await ario.createVault({
 Extends the lock length of a signer's vault by the specified `extendLengthMs` milliseconds.
 
 ```typescript
-const ario = ARIO.init({ signer: new ArweaveSigner(jwk) });
+const ario = ARIO.init({
+  processId: ARIO_MAINNET_PROCESS_ID,
+  signer: new ArweaveSigner(jwk),
+});
 
 const { id: txId } = await ario.extendVault({
   vaultId: 'vaultIdOne',
@@ -585,7 +619,10 @@ const { id: txId } = await ario.extendVault({
 Increases the balance of a signer's vault by the specified `quantity` of mARIO.
 
 ```typescript
-const ario = ARIO.init({ signer: new ArweaveSigner(jwk) });
+const ario = ARIO.init({
+  processId: ARIO_MAINNET_PROCESS_ID,
+  signer: new ArweaveSigner(jwk),
+});
 
 const { id: txId } = await ario.increaseVault({
   vaultId: 'vaultIdOne',
@@ -600,7 +637,7 @@ const { id: txId } = await ario.increaseVault({
 Retrieves a gateway's info by its staking wallet address.
 
 ```typescript
-const ario = ARIO.init();
+const ario = ARIO.init({ processId: ARIO_MAINNET_PROCESS_ID });
 const gateway = await ario.getGateway({
   address: '-7vXsQZQDk8TMDlpiSLy3CnLi5PDPlAaN2DaynORpck',
 });
@@ -649,7 +686,7 @@ const gateway = await ario.getGateway({
 Retrieves registered gateways of the ARIO process, using pagination and sorting by the specified criteria. The `cursor` used for pagination is the last gateway address from the previous request.
 
 ```typescript
-const ario = ARIO.init();
+const ario = ARIO.init({ processId: ARIO_MAINNET_PROCESS_ID });
 const gateways = await ario.getGateways({
   limit: 100,
   sortOrder: 'desc',
@@ -712,7 +749,7 @@ Available `sortBy` options are any of the keys on the gateway object, e.g. `oper
 Retrieves all delegates for a specific gateway, paginated and sorted by the specified criteria. The `cursor` used for pagination is the last delegate address from the previous request.
 
 ```typescript
-const ario = ARIO.init();
+const ario = ARIO.init({ processId: ARIO_MAINNET_PROCESS_ID });
 const delegates = await ario.getGatewayDelegates({
   address: 'QGWqtJdLLgm2ehFWiiPzMaoFLD50CnGuzZIPEdoDRGQ',
   limit: 3,
@@ -761,7 +798,10 @@ Joins a gateway to the ar.io network via its associated wallet.
 _Note: Requires `signer` to be provided on `ARIO.init` to sign the transaction._
 
 ```typescript
-const ario = ARIO.init({ signer: new ArweaveSigner(jwk) });
+const ario = ARIO.init({
+  processId: ARIO_MAINNET_PROCESS_ID,
+  signer: new ArweaveSigner(jwk),
+});
 const { id: txId } = await ario.joinNetwork(
   {
     qty: new ARIOToken(10_000).toMARIO(), // minimum operator stake allowed
@@ -789,7 +829,10 @@ Sets the gateway as `leaving` on the ar.io network. Requires `signer` to be prov
 _Note: Requires `signer` to be provided on `ARIO.init` to sign the transaction._
 
 ```typescript
-const ario = ARIO.init({ signer: new ArweaveSigner(jwk) });
+const ario = ARIO.init({
+  processId: ARIO_MAINNET_PROCESS_ID,
+  signer: new ArweaveSigner(jwk),
+});
 
 const { id: txId } = await ario.leaveNetwork(
   // optional additional tags
@@ -804,7 +847,10 @@ Writes new gateway settings to the callers gateway configuration.
 _Note: Requires `signer` to be provided on `ARIO.init` to sign the transaction._
 
 ```typescript
-const ario = ARIO.init({ signer: new ArweaveSigner(jwk) });
+const ario = ARIO.init({
+  processId: ARIO_MAINNET_PROCESS_ID,
+  signer: new ArweaveSigner(jwk),
+});
 const { id: txId } = await ario.updateGatewaySettings(
   {
     // any other settings you want to update
@@ -822,7 +868,10 @@ Increases the callers stake on the target gateway.
 _Note: Requires `signer` to be provided on `ARIO.init` to sign the transaction._
 
 ```typescript
-const ario = ARIO.init({ signer: new ArweaveSigner(jwk) });
+const ario = ARIO.init({
+  processId: ARIO_MAINNET_PROCESS_ID,
+  signer: new ArweaveSigner(jwk),
+});
 const { id: txId } = await ario.increaseDelegateStake(
   {
     target: 't4Xr0_J4Iurt7caNST02cMotaz2FIbWQ4Kbj616RHl3',
@@ -840,7 +889,10 @@ Decreases the callers stake on the target gateway. Can instantly decrease stake
 _Note: Requires `signer` to be provided on `ARIO.init` to sign the transaction._
 
 ```typescript
-const ario = ARIO.init({ signer: new ArweaveSigner(jwk) });
+const ario = ARIO.init({
+  processId: ARIO_MAINNET_PROCESS_ID,
+  signer: new ArweaveSigner(jwk),
+});
 const { id: txId } = await ario.decreaseDelegateStake(
   {
     target: 't4Xr0_J4Iurt7caNST02cMotaz2FIbWQ4Kbj616RHl3',
@@ -855,7 +907,10 @@ const { id: txId } = await ario.decreaseDelegateStake(
 Pay the early withdrawal fee and withdraw instantly.
 
 ```typescript
-const ario = ARIO.init({ signer: new ArweaveSigner(jwk) });
+const ario = ARIO.init({
+  processId: ARIO_MAINNET_PROCESS_ID,
+  signer: new ArweaveSigner(jwk),
+});
 const { id: txId } = await ario.decreaseDelegateStake({
   target: 't4Xr0_J4Iurt7caNST02cMotaz2FIbWQ4Kbj616RHl3',
   qty: new ARIOToken(100).toMARIO(),
@@ -868,7 +923,7 @@ const { id: txId } = await ario.decreaseDelegateStake({
 Retrieves all active and vaulted stakes across all gateways for a specific address, paginated and sorted by the specified criteria. The `cursor` used for pagination is the last delegationId (concatenated gateway and startTimestamp of the delgation) from the previous request.
 
 ```typescript
-const ario = ARIO.init();
+const ario = ARIO.init({ processId: ARIO_MAINNET_PROCESS_ID });
 const vaults = await ario.getDelegations({
   address: 't4Xr0_J4Iurt7caNST02cMotaz2FIbWQ4Kbj616RHl3',
   cursor: 'QGWqtJdLLgm2ehFWiiPzMaoFLD50CnGuzZIPEdoDRGQ_123456789',
@@ -919,7 +974,7 @@ Instantly withdraws an existing vault on a gateway. If no `gatewayAddress` is pr
 _Note: Requires `signer` to be provided on `ARIO.init` to sign the transaction._
 
 ```typescript
-const ario = ARIO.init({ signer: new ArweaveSigner(jwk) });
+const ario = ARIO.init({ processId: ARIO_MAINNET_PROCESS_ID, signer: new ArweaveSigner(jwk) });
 // removes a delegated vault from a gateway
 const { id: txId } = await ario.instantWithdrawal(
   {
@@ -948,7 +1003,7 @@ Cancels an existing vault on a gateway. The vaulted stake will be returned to th
 _Note: Requires `signer` to be provided on `ARIO.init` to sign the transaction._
 
 ```typescript
-const ario = ARIO.init({ signer: new ArweaveSigner(jwk) });
+const ario = ARIO.init({ processId: ARIO_MAINNET_PROCESS_ID, signer: new ArweaveSigner(jwk) });
 // cancels a delegated vault from a gateway
 const { id: txId } = await ario.cancelWithdrawal(
   {
@@ -974,7 +1029,7 @@ const { id: txId } = await ario.cancelWithdrawal(
 Retrieves all allowed delegates for a specific address. The `cursor` used for pagination is the last address from the previous request.
 
 ```typescript
-const ario = ARIO.init();
+const ario = ARIO.init({ processId: ARIO_MAINNET_PROCESS_ID });
 const allowedDelegates = await ario.getAllowedDelegates({
   address: 'QGWqtJdLLgm2ehFWiiPzMaoFLD50CnGuzZIPEdoDRGQ',
 });
@@ -1005,7 +1060,7 @@ const allowedDelegates = await ario.getAllowedDelegates({
 Retrieves all vaults across all gateways for a specific address, paginated and sorted by the specified criteria. The `cursor` used for pagination is the last vaultId from the previous request.
 
 ```typescript
-const ario = ARIO.init();
+const ario = ARIO.init({ processId: ARIO_MAINNET_PROCESS_ID });
 const vaults = await ario.getGatewayVaults({
   address: '"PZ5vIhHf8VY969TxBPQN-rYY9CNFP9ggNsMBqlWUzWM',
 });
@@ -1040,7 +1095,7 @@ const vaults = await ario.getGatewayVaults({
 Retrieves all vaults across all gateways, paginated and sorted by the specified criteria. The `cursor` used for pagination is the last vaultId from the previous request.
 
 ```typescript
-const ario = ARIO.init();
+const ario = ARIO.init({ processId: ARIO_MAINNET_PROCESS_ID });
 const vaults = await ario.getAllGatewayVaults({
   limit: 1,
   sortBy: 'endTimestamp',
@@ -1081,7 +1136,10 @@ Increases the callers operator stake. Must be executed with a wallet registered
 _Note: Requires `signer` to be provided on `ARIO.init` to sign the transaction._
 
 ```typescript
-const ario = ARIO.init({ signer: new ArweaveSigner(jwk) });
+const ario = ARIO.init({
+  processId: ARIO_MAINNET_PROCESS_ID,
+  signer: new ArweaveSigner(jwk),
+});
 const { id: txId } = await ario.increaseOperatorStake(
   {
     qty: new ARIOToken(100).toMARIO(),
@@ -1099,7 +1157,10 @@ Decreases the callers operator stake. Must be executed with a wallet registered
 _Note: Requires `signer` to be provided on `ARIO.init` to sign the transaction._
 
 ```typescript
-const ario = ARIO.init({ signer: new ArweaveSigner(jwk) });
+const ario = ARIO.init({
+  processId: ARIO_MAINNET_PROCESS_ID,
+  signer: new ArweaveSigner(jwk),
+});
 const { id: txId } = await ario.decreaseOperatorStake(
   {
     qty: new ARIOToken(100).toMARIO(),
@@ -1117,7 +1178,10 @@ Redelegates the stake of a specific address to a new gateway. Vault ID may be op
 e.g: If 1000 mARIO is redelegated and the fee rate is 10%, the fee will be 100 mARIO. Resulting in 900 mARIO being redelegated to the new gateway and 100 mARIO being deducted back to the protocol balance.
 
 ```typescript
-const ario = ARIO.init({ signer: new ArweaveSigner(jwk) });
+const ario = ARIO.init({
+  processId: ARIO_MAINNET_PROCESS_ID,
+  signer: new ArweaveSigner(jwk),
+});
 
 const { id: txId } = await ario.redelegateStake({
   target: 't4Xr0_J4Iurt7caNST02cMotaz2FIbWQ4Kbj616RHl3',
@@ -1132,7 +1196,7 @@ const { id: txId } = await ario.redelegateStake({
 Retrieves the fee rate as percentage required to redelegate the stake of a specific address. Fee rate ranges from 0% to 60% based on the number of redelegations since the last fee reset.
 
 ```typescript
-const ario = ARIO.init();
+const ario = ARIO.init({ processId: ARIO_MAINNET_PROCESS_ID });
 
 const fee = await ario.getRedelegationFee({
   address: 't4Xr0_J4Iurt7caNST02cMotaz2FIbWQ4Kbj616RHl3',
@@ -1156,7 +1220,7 @@ const fee = await ario.getRedelegationFee({
 Retrieves all delegates across all gateways, paginated and sorted by the specified criteria. The `cursor` used for pagination is a `cursorId` derived from delegate address and the gatewayAddress from the previous request. e.g `address_gatewayAddress`.
 
 ```typescript
-const ario = ARIO.init();
+const ario = ARIO.init({ processId: ARIO_MAINNET_PROCESS_ID });
 const delegates = await ario.getAllDelegates({
   limit: 2,
   sortBy: 'startTimestamp',
@@ -1222,7 +1286,7 @@ const record = await ario.buyRecord(
 Retrieves the record info of the specified ArNS name.
 
 ```typescript
-const ario = ARIO.init();
+const ario = ARIO.init({ processId: ARIO_MAINNET_PROCESS_ID });
 const record = await ario.getArNSRecord({ name: 'ardrive' });
 ```
 
@@ -1246,7 +1310,7 @@ const record = await ario.getArNSRecord({ name: 'ardrive' });
 Retrieves all registered ArNS records of the ARIO process, paginated and sorted by the specified criteria. The `cursor` used for pagination is the last ArNS name from the previous request.
 
 ```typescript
-const ario = ARIO.init();
+const ario = ARIO.init({ processId: ARIO_MAINNET_PROCESS_ID });
 // get the newest 100 names
 const records = await ario.getArNSRecords({
   limit: 100,
@@ -1327,7 +1391,10 @@ Increases the undername support of a domain up to a maximum of 10k. Domains, by
 _Note: Requires `signer` to be provided on `ARIO.init` to sign the transaction._
 
 ```typescript
-const ario = ARIO.init({ signer: new ArweaveSigner(jwk) });
+const ario = ARIO.init({
+  processId: ARIO_MAINNET_PROCESS_ID,
+  signer: new ArweaveSigner(jwk),
+});
 const { id: txId } = await ario.increaseUndernameLimit(
   {
     name: 'ar-io',
@@ -1343,7 +1410,10 @@ const { id: txId } = await ario.increaseUndernameLimit(
 Extends the lease of a registered ArNS domain, with an extension of 1-5 years depending on grace period status. Permanently registered domains cannot be extended.
 
 ```typescript
-const ario = ARIO.init({ signer: new ArweaveSigner(jwk) });
+const ario = ARIO.init({
+  processId: ARIO_MAINNET_PROCESS_ID,
+  signer: new ArweaveSigner(jwk),
+});
 const { id: txId } = await ario.extendLease(
   {
     name: 'ar-io',
@@ -1437,7 +1507,7 @@ const demandFactor = await ario.getDemandFactor();
 Retrieves all active returned names of the ARIO process, paginated and sorted by the specified criteria. The `cursor` used for pagination is the last returned name from the previous request.
 
 ```typescript
-const ario = ARIO.init();
+const ario = ARIO.init({ processId: ARIO_MAINNET_PROCESS_ID });
 const returnedNames = await ario.getArNSReturnedNames({
   limit: 100,
   sortBy: 'endTimestamp',
@@ -1480,7 +1550,7 @@ const returnedNames = await ario.getArNSReturnedNames({
 Retrieves the returned name data for the specified returned name.
 
 ```typescript
-const ario = ARIO.init();
+const ario = ARIO.init({ processId: ARIO_MAINNET_PROCESS_ID });
 const returnedName = await ario.getArNSReturnedName({ name: 'permalink' });
 ```
 
@@ -1513,7 +1583,7 @@ const returnedName = await ario.getArNSReturnedName({ name: 'permalink' });
 Returns the current epoch data.
 
 ```typescript
-const ario = ARIO.init();
+const ario = ARIO.init({ processId: ARIO_MAINNET_PROCESS_ID });
 const epoch = await ario.getCurrentEpoch();
 ```
 
@@ -1569,7 +1639,7 @@ const epoch = await ario.getCurrentEpoch();
 Returns the epoch data for the specified block height. If no epoch index is provided, the current epoch is used.
 
 ```typescript
-const ario = ARIO.init();
+const ario = ARIO.init({ processId: ARIO_MAINNET_PROCESS_ID });
 const epoch = await ario.getEpoch({ epochIndex: 0 });
 ```
 
@@ -1631,7 +1701,7 @@ const epoch = await ario.getEpoch({ epochIndex: 0 });
 Returns the eligible epoch rewards for the specified block height. If no epoch index is provided, the current epoch is used.
 
 ```typescript
-const ario = ARIO.init();
+const ario = ARIO.init({ processId: ARIO_MAINNET_PROCESS_ID });
 const rewards = await ario.getEligibleEpochRewards({ epochIndex: 0 });
 ```
 
@@ -1664,7 +1734,7 @@ const rewards = await ario.getEligibleEpochRewards({ epochIndex: 0 });
 Returns the epoch-indexed observation list. If no epoch index is provided, the current epoch is used.
 
 ```typescript
-const ario = ARIO.init();
+const ario = ARIO.init({ processId: ARIO_MAINNET_PROCESS_ID });
 const observations = await ario.getObservations();
 ```
 
@@ -1697,7 +1767,7 @@ const observations = await ario.getObservations();
 Returns the current rewards distribution information. If no epoch index is provided, the current epoch is used.
 
 ```typescript
-const ario = ARIO.init();
+const ario = ARIO.init({ processId: ARIO_MAINNET_PROCESS_ID });
 const distributions = await ario.getDistributions({ epochIndex: 0 });
 ```
 
@@ -1752,7 +1822,7 @@ const { id: txId } = await ario.saveObservations(
 Retrieves the prescribed observers of the ARIO process. To fetch prescribed observers for a previous epoch set the `epochIndex` to the desired epoch index.
 
 ```typescript
-const ario = ARIO.init();
+const ario = ARIO.init({ processId: ARIO_MAINNET_PROCESS_ID });
 const observers = await ario.getPrescribedObservers({ epochIndex: 0 });
 ```
 
@@ -1785,7 +1855,7 @@ const observers = await ario.getPrescribedObservers({ epochIndex: 0 });
 Retrieves all primary names paginated and sorted by the specified criteria. The `cursor` used for pagination is the last name from the previous request.
 
 ```typescript
-const ario = ARIO.init();
+const ario = ARIO.init({ processId: ARIO_MAINNET_PROCESS_ID });
 const names = await ario.getPrimaryNames({
   cursor: 'ao', // this is the last name from the previous request
   limit: 1,
@@ -1822,7 +1892,7 @@ const names = await ario.getPrimaryNames({
 Retrieves the primary name for a given name or address.
 
 ```typescript
-const ario = ARIO.init();
+const ario = ARIO.init({ processId: ARIO_MAINNET_PROCESS_ID });
 const name = await ario.getPrimaryName({
   name: 'arns',
 });
@@ -1863,7 +1933,7 @@ const { id: txId } = await ario.requestPrimaryName({
 Retrieves the primary name request for a a wallet address.
 
 ```typescript
-const ario = ARIO.init();
+const ario = ARIO.init({ processId: ARIO_MAINNET_PROCESS_ID });
 const request = await ario.getPrimaryNameRequest({
   initiator: 't4Xr0_J4Iurt7caNST02cMotaz2FIbWQ4Kbj616RHl3',
 });
@@ -2327,7 +2397,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
 });
 ```
 
@@ -2340,7 +2410,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
 });
 ```
@@ -2355,7 +2425,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
 });
 ```
 
@@ -2368,7 +2438,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
 });
 ```