@ar.io/sdk 1.2.0-alpha.2 → 1.2.0-alpha.20

package/README.md

@@ -2,7 +2,7 @@
 
 [![codecov](https://codecov.io/gh/ar-io/ar-io-sdk/graph/badge.svg?token=7dXKcT7dJy)](https://codecov.io/gh/ar-io/ar-io-sdk)
 
-This is the home of [ar.io] SDK. This SDK provides functionality for interacting with the ar.io ecosystem of services (e.g. gateways and observers) and protocols (e.g. ArNS). It is available for both NodeJS and Web environments.
+This is the home of [ar.io] SDK. This SDK provides functionality for interacting with the ar.io ecosystem of services (e.g. gateways and observers) and protocols (e.g. ArNS and AO). It is available for both NodeJS and Web environments.
 
 ## Table of Contents
 
@@ -15,11 +15,10 @@ This is the home of [ar.io] SDK. This SDK provides functionality for interacting
   - [Typescript](#typescript)
 - [IOToken & mIOToken](#iotoken--miotoken)
   - [Converting IO to mIO](#converting-io-to-mio)
-- [ArIO Contract](#ario-contract)
+- [ArIO Process](#ario-process)
 
   - [APIs](#apis)
     - [`init({ signer })`](#init-signer-)
-    - [`getState({ evaluationOptions })`](#getstate-evaluationoptions-)
     - [`getBalance({ address, evaluationOptions })`](#getbalance-address-evaluationoptions-)
     - [`getBalances({ evaluationOptions })`](#getbalances-evaluationoptions-)
     - [`getGateway({ address, evaluationOptions })`](#getgateway-address-evaluationoptions-)
@@ -31,8 +30,6 @@ This is the home of [ar.io] SDK. This SDK provides functionality for interacting
     - [`getEpoch({ evaluationOptions })`](#getepoch-evaluationoptions-)
     - [`getCurrentEpoch({ evaluationOptions })`](#getcurrentepoch-evaluationoptions-)
     - [`getPrescribedObservers({ evaluationOptions })`](#getprescribedobservers-evaluationoptions-)
-    - [`getAuction({ domain, evaluationOptions })`](#getauction-domain-evaluationoptions-)
-    - [`getAuctions({ evauluationOptions })`](#getauctions-evauluationoptions-)
     - [`joinNetwork(params)`](#joinnetworkparams)
     - [`updateGatewaySettings(gatewaySettings)`](#updategatewaysettingsgatewaysettings)
     - [`increaseDelegateStake({ target, qty })`](#increasedelegatestake-target-qty-)
@@ -41,12 +38,11 @@ This is the home of [ar.io] SDK. This SDK provides functionality for interacting
     - [`decreaseOperatorStake({ qty })`](#decreaseoperatorstake-qty-)
     - [`saveObservations({ reportTxId, failedGateways })`](#saveobservations-reporttxid-failedgateways-)
     - [`transfer({ target, qty, denomination })`](#transfer-target-qty-denomination-)
-  - [Custom Contracts](#custom-contracts)
+  - [Custom Processes](#custom-processes)
 
 - [Arweave Name Tokens (ANT's)](#arweave-name-tokens-ants)
   - [APIs](#apis-1)
     - [`init({ signer })`](#init-signer-)
-    - [`getState({ evaluationOptions })`](#getstate-evaluationoptions-)
     - [`getOwner({ evaluationOptions })`](#getowner-evaluationoptions-)
     - [`getControllers({ evaluationOptions })`](#getcontrollers-evaluationoptions-)
     - [`getRecords({ evaluationOptions })`](#getrecords-evaluationoptions-)
@@ -85,9 +81,9 @@ yarn add @ar.io/sdk
 ## Quick Start
 
 ```typescript
-import { ArIO } from '@ar.io/sdk';
+import { IO } from '@ar.io/sdk';
 
-const arIO = ArIO.init();
+const arIO = IO.init();
 const gateways = await arIO.getGateways();
 ```
 
@@ -141,10 +137,10 @@ The SDK is provided in both CommonJS and ESM formats and is compatible with bund
 #### Bundlers (Webpack, Rollup, ESbuild, etc.)
 
 ```javascript
-import { ArIO } from '@ar.io/sdk';
+import { IO } from '@ar.io/sdk';
 
 // set up client
-const arIO = ArIO.init();
+const arIO = IO.init();
 // fetch gateways
 const gateways = await arIO.getGateways();
 ```
@@ -155,10 +151,10 @@ const gateways = await arIO.getGateways();
 
 ```html
 <script type="module">
-  import { ArIO } from 'https://unpkg.com/@ar.io/sdk';
+  import { IO } from 'https://unpkg.com/@ar.io/sdk';
 
   // set up client
-  const arIO = ArIO.init();
+  const arIO = IO.init();
   // fetch gateways
   const gateways = await arIO.getGateways();
 </script>
@@ -169,10 +165,10 @@ const gateways = await arIO.getGateways();
 #### ESM (NodeNext)
 
 ```javascript
-import { ArIO } from '@ar.io/sdk/node';
+import { IO } from '@ar.io/sdk/node';
 
 // set up client
-const arIO = ArIO.init();
+const arIO = IO.init();
 // fetch gateways
 const gateways = await arIO.getGateways();
 ```
@@ -180,10 +176,10 @@ const gateways = await arIO.getGateways();
 #### CJS
 
 ```javascript
-import { ArIO } from '@ar.io/sdk';
+import { IO } from '@ar.io/sdk';
 
 // set up client
-const arIO = ArIO.init();
+const arIO = IO.init();
 // fetch gateways
 const gateways = await arIO.getGateways();
 ```
@@ -194,9 +190,9 @@ The SDK provides TypeScript types. When you import the SDK in a TypeScript proje
 
 ## IOToken & mIOToken
 
-The ArIO contract stores all values as mIO (milli-IO) to avoid floating-point arithmetic issues. The SDK provides an `IOToken` and `mIOToken` classes to handle the conversion between IO and mIO, along with rounding logic for precision.
+The ArIO process stores all values as mIO (milli-IO) to avoid floating-point arithmetic issues. The SDK provides an `IOToken` and `mIOToken` classes to handle the conversion between IO and mIO, along with rounding logic for precision.
 
-**All contract interactions expect values in mIO. If numbers are provided as inputs, they are assumed to be in raw mIO values.**
+**All process interactions expect values in mIO. If numbers are provided as inputs, they are assumed to be in raw mIO values.**
 
 ### Converting IO to mIO
 
@@ -212,7 +208,7 @@ const ioValue = new mIOToken(mIOValue).toIO();
 console.log(ioValue); // 1 (IO)
 ```
 
-## ArIO Contract
+## ArIO Process
 
 ### APIs
 
@@ -222,7 +218,7 @@ Factory function to that creates a read-only or writeable client. By providing a
 
 ```typescript
 // read-only client that has access to all read APIs
-const arIOReadable = ArIO.init()
+const arIOReadable = IO.init()
 
 const arweave = Arweave.init({
   host: 'ar-io.dev',
@@ -231,118 +227,20 @@ const arweave = Arweave.init({
 })
 // for browser environments
 const browserSigner = new ArConnectSigner(window.arweaveWallet, arweave);
-const arIOWriteable = ArIO.init({ signer: browserSigner});
+const arIOWriteable = IO.init({ signer: browserSigner});
 
 // for node environments
 const nodeSigner = new ArweaveSigner(JWK);
-const arIOWriteable = ArIO.init({ signer: nodeSigner});
+const arIOWriteable = IO.init({ signer: nodeSigner});
 
 ```
 
-### `getState({ evaluationOptions })`
-
-Retrieves the current state of the ArIO contract.
-
-```typescript
-const arIO = ArIO.init();
-const state = await arIO.getState();
-```
-
-<details>
-  <summary>Output</summary>
-
-```json
-{
-  "lastTickedHeight": 1415568, // current block height
-  "evolve": "92MCDWn0LihmWXKVnOeMDEQxPbiV4Y3bRjnTet7J3eg",
-  "auctions": {
-    // auctions
-  },
-  "balances": {
-    // balances
-  },
-  "distributions": {
-    // epoch distribution info
-  },
-  "gateways": {
-    // gateways
-  },
-  "observations": {
-    // observations
-  },
-  "prescribedObservers": {
-    // prescribedObservers
-  },
-  "records": {
-    // records
-  },
-  "demandFactoring": {
-    // demandFactoring
-  },
-  "vaults": {
-    // vaults
-  }
-}
-```
-
-</details>
-
-Alternatively, you can get the contract at a specific block height or sort key by providing `evaluationOptions`:
-
-```typescript
-const arIO = ArIO.init();
-const state = await arIO.getState({
-  evaluationOptions: {
-    evalTo: { blockHeight: 1382230 }, // alternatively, use evalTo: { sortKey: 'SORT_KEY' }
-  },
-});
-```
-
-<details>
-  <summary>Output</summary>
-
-```json
-{
-  "lastTickedHeight": 1382230, // evaluated block height
-  "evolve": "92MCDWn0LihmWXKVnOeMDEQxPbiV4Y3bRjnTet7J3eg",
-  "auctions": {
-    // auctions
-  },
-  "balances": {
-    // balances
-  },
-  "distributions": {
-    // epoch distribution info
-  },
-  "gateways": {
-    // gateways
-  },
-  "observations": {
-    // observations
-  },
-  "prescribedObservers": {
-    // prescribedObservers
-  },
-  "records": {
-    // records
-  },
-  "demandFactoring": {
-    // demandFactoring
-  },
-  "vaults": {
-    // vaults
-  }
-}
-```
-
-</details>
-
 #### `getBalance({ address, evaluationOptions })`
 
 Retrieves the balance of the specified wallet address.
 
 ```typescript
-const arIO = ArIO.init();
+const arIO = IO.init();
 // the balance will be returned in mIO as a value
 const balance = await arIO
   .getBalance({
@@ -365,7 +263,7 @@ console.log(balance.valueOf());
 
 #### `getBalances({ evaluationOptions })`
 
-Retrieves the balances of the ArIO contract in `mIO`
+Retrieves the balances of the ArIO process in `mIO`
 
 <!--
 // ALM - A part of me wonders whether streaming JSON might be beneficial in the future
@@ -374,7 +272,7 @@ Retrieves the balances of the ArIO contract in `mIO`
  -->
 
 ```typescript
-const arIO = ArIO.init();
+const arIO = IO.init();
 const balances = await arIO.getBalances();
 ```
 
@@ -396,7 +294,7 @@ const balances = await arIO.getBalances();
 Retrieves a gateway's info by its staking wallet address.
 
 ```typescript
-const arIO = ArIO.init();
+const arIO = IO.init();
 const gateway = await arIO.getGateway({
   address: 'INSERT_GATEWAY_ADDRESS',
 });
@@ -443,10 +341,10 @@ const gateway = await arIO.getGateway({
 
 #### `getGateways({ evaluationOptions })`
 
-Retrieves the registered gateways of the ArIO contract.
+Retrieves the registered gateways of the ArIO process.
 
 ```typescript
-const arIO = ArIO.init();
+const arIO = IO.init();
 const gateways = await arIO.getGateways();
 ```
 
@@ -496,7 +394,7 @@ const gateways = await arIO.getGateways();
 Retrieves the record info of the specified ArNS name.
 
 ```typescript
-const arIO = ArIO.init();
+const arIO = IO.init();
 const record = await arIO.getArNSRecord({ domain: 'ardrive' });
 ```
 
@@ -505,7 +403,7 @@ const record = await arIO.getArNSRecord({ domain: 'ardrive' });
 
 ```json
 {
-  "contractTxId": "bh9l1cy0aksiL_x9M359faGzM_yjralacHIUo8_nQXM",
+  "processId": "bh9l1cy0aksiL_x9M359faGzM_yjralacHIUo8_nQXM",
   "endTimestamp": 1711122739,
   "startTimestamp": 1694101828,
   "type": "lease",
@@ -517,10 +415,10 @@ const record = await arIO.getArNSRecord({ domain: 'ardrive' });
 
 #### `getArNSRecords({ evaluationOptions })`
 
-Retrieves all registered ArNS records of the ArIO contract.
+Retrieves all registered ArNS records of the ArIO process.
 
 ```typescript
-const arIO = ArIO.init();
+const arIO = IO.init();
 const records = await arIO.getArNSRecords();
 ```
 
@@ -530,14 +428,14 @@ const records = await arIO.getArNSRecords();
 ```json
 {
   "ardrive": {
-    "contractTxId": "bh9l1cy0aksiL_x9M359faGzM_yjralacHIUo8_nQXM",
+    "processId": "bh9l1cy0aksiL_x9M359faGzM_yjralacHIUo8_nQXM",
     "endTimestamp": 1711122739,
     "startTimestamp": 1694101828,
     "type": "lease",
     "undernames": 100
   },
   "ar-io": {
-    "contractTxId": "eNey-H9RB9uCdoJUvPULb35qhZVXZcEXv8xds4aHhkQ",
+    "processId": "eNey-H9RB9uCdoJUvPULb35qhZVXZcEXv8xds4aHhkQ",
     "purchasePrice": 75541282285, // value in mIO
     "startTimestamp": 1706747215,
     "type": "permabuy",
@@ -553,7 +451,7 @@ const records = await arIO.getArNSRecords();
 Returns the epoch-indexed observation list.
 
 ```typescript
-const arIO = ArIO.init();
+const arIO = IO.init();
 const observations = await arIO.getObservations();
 ```
 
@@ -586,7 +484,7 @@ const observations = await arIO.getObservations();
 Returns the current rewards distribution information. The resulting object is pruned, to get older distributions use the `evaluationOptions` to `evalTo` a previous state.
 
 ```typescript
-const arIO = ArIO.init();
+const arIO = IO.init();
 const distributions = await arIO.getDistributions();
 ```
 
@@ -610,7 +508,7 @@ const distributions = await arIO.getDistributions();
 Returns the epoch data for the specified block height.
 
 ```typescript
-const arIO = ArIO.init();
+const arIO = IO.init();
 const epoch = await arIO.getEpoch({ blockHeight: 1382230 });
 ```
 
@@ -635,7 +533,7 @@ const epoch = await arIO.getEpoch({ blockHeight: 1382230 });
 Returns the current epoch data.
 
 ```typescript
-const arIO = ArIO.init();
+const arIO = IO.init();
 const epoch = await arIO.getCurrentEpoch();
 ```
 
@@ -656,10 +554,10 @@ const epoch = await arIO.getCurrentEpoch();
 
 #### `getPrescribedObservers({ evaluationOptions })`
 
-Retrieves the prescribed observers of the ArIO contract. To fetch prescribed observers for a previous epoch set the `evaluationOptions` to the desired epoch.
+Retrieves the prescribed observers of the ArIO process. To fetch prescribed observers for a previous epoch set the `evaluationOptions` to the desired epoch.
 
 ```typescript
-const arIO = ArIO.init();
+const arIO = IO.init();
 const observers = await arIO.getPrescribedObservers();
 ```
 
@@ -684,7 +582,7 @@ const observers = await arIO.getPrescribedObservers();
 ```
 
 </details>
- 
+
 Fetch the prescribed observers for a previous epoch by setting the `evaluationOptions` to the desired epoch.
 
 ```typescript
@@ -718,81 +616,6 @@ const previousEpochObservers = await arIO.getPrescribedObservers({
 
 </details>
 
-#### `getAuction({ domain, evaluationOptions })`
-
-Return the auction info for the supplied domain, be it in auction, registered, or available to auction.
-
-```typescript
-const auction = await arIO.getAuction({ domain });
-```
-
-<details>
-  <summary>Output</summary>
-
-```json
-{
-  "name": "ardrive",
-  "initiator": "",
-  "contractTxId": "",
-  "startPrice": 89950,
-  "floorPrice": 1799,
-  "startHeight": 1384196,
-  "endHeight": 1394276,
-  "type": "lease",
-  "years": 1,
-  "isActive": false,
-  "isAvailableForAuction": false,
-  "isRequiredToBeAuctioned": false,
-  "currentPrice": 1799,
-  "prices": {
-    "1384196": 89950,
-    "1384226": 88930,
-    "1384256": 87922,
-    "1394286": 1921,
-    "1394306": 1899,
-    "1394336": 1877
-  }
-}
-```
-
-</details>
-
-#### `getAuctions({ evauluationOptions })`
-
-Retrieves all active auctions.
-
-```typescript
-const auctions = await arIO.getAuctions({ evaluationOptions });
-```
-
-<details>
-  <summary>Output</summary>
-
-```json
-{
-  "cyprien": {
-    "contractTxId": "Fmhdc4f1rWK6Zn1W__7GNvWvo4d1FSze7rLK5AOnO5E",
-    "endHeight": 1386879,
-    "floorPrice": 4758777913,
-    "initiator": "UPJHTNsaKcC6baqLFHMAMI7daWPIG3NDDfFQ2s2h8T0",
-    "startHeight": 1376799,
-    "startPrice": 237938895627,
-    "type": "permabuy"
-  },
-  "saktinaga": {
-    "contractTxId": "nl8heYyDxKowujaDqbsPkjALzULYG8T0z3J91CdWDIM",
-    "endHeight": 1386834,
-    "floorPrice": 2379388956,
-    "initiator": "TE0zVR32RF5qFAO8K50-pEivZpM_s35HK-dex-5d-IU",
-    "startHeight": 1376754,
-    "startPrice": 118969447813,
-    "type": "permabuy"
-  }
-}
-```
-
-</details>
-
 #### `getPriceForInteraction({ interactionName, payload })`
 
 Calculates the price in mIO to perform the interaction in question, eg a 'buyRecord' interaction, where payload is the specific params for that interaction.
@@ -819,7 +642,7 @@ console.log({ price: price.valueOf() });
 
 #### `joinNetwork(params)`
 
-Joins a gateway to the ar.io network via its associated wallet. Requires `signer` to be provided on `ArIO.init` to sign the transaction.
+Joins a gateway to the ar.io network via its associated wallet. Requires `signer` to be provided on `IO.init` to sign the transaction.
 
 ```typescript
 const joinNetworkParams = {
@@ -838,7 +661,7 @@ const joinNetworkParams = {
 };
 const signer = new ArweaveSigner(jwk);
 // signer required for write interactions APIs
-const authenticatedArIO = ArIO.init({ signer });
+const authenticatedArIO = IO.init({ signer });
 const { id: txId } = await authenticatedArIO.joinNetwork(
   joinNetworkParams,
   // optional additional tags
@@ -848,7 +671,7 @@ const { id: txId } = await authenticatedArIO.joinNetwork(
 
 #### `updateGatewaySettings(gatewaySettings)`
 
-Writes new gateway settings to the callers gateway configuration. Requires `signer` to be provided on `ArIO.init` to sign the transaction.
+Writes new gateway settings to the callers gateway configuration. Requires `signer` to be provided on `IO.init` to sign the transaction.
 
 ```typescript
 const updateGatewaySettingsParams = {
@@ -857,7 +680,7 @@ const updateGatewaySettingsParams = {
 
 const signer = new ArweaveSigner(jwk);
 // signer required for write interactions APIs
-const authenticatedArIO = ArIO.init({ signer });
+const authenticatedArIO = IO.init({ signer });
 const { id: txId } = await authenticatedArIO.updateGatewaySettings(
   updateGatewaySettingsParams,
   // optional additional tags
@@ -867,7 +690,7 @@ const { id: txId } = await authenticatedArIO.updateGatewaySettings(
 
 #### `increaseDelegateStake({ target, qty })`
 
-Increases the callers stake on the target gateway. Requires `signer` to be provided on `ArIO.init` to sign the transaction.
+Increases the callers stake on the target gateway. Requires `signer` to be provided on `IO.init` to sign the transaction.
 
 ```typescript
 const params = {
@@ -877,7 +700,7 @@ const params = {
 
 const signer = new ArweaveSigner(jwk);
 // signer required for write interactions APIs
-const authenticatedArIO = ArIO.init({ signer });
+const authenticatedArIO = IO.init({ signer });
 const { id: txId } = await authenticatedArIO.increaseDelegateStake(
   params,
   // optional additional tags
@@ -887,7 +710,7 @@ const { id: txId } = await authenticatedArIO.increaseDelegateStake(
 
 #### `decreaseDelegateStake({ target, qty })`
 
-Decreases the callers stake on the target gateway. Requires `signer` to be provided on `ArIO.init` to sign the transaction.
+Decreases the callers stake on the target gateway. Requires `signer` to be provided on `IO.init` to sign the transaction.
 
 ```typescript
 const params = {
@@ -897,7 +720,7 @@ const params = {
 
 const signer = new ArweaveSigner(jwk);
 // signer required for write interactions APIs
-const authenticatedArIO = ArIO.init({ signer });
+const authenticatedArIO = IO.init({ signer });
 const { id: txId } = await authenticatedArIO.decreaseDelegateStake(params, {
   tags: [{ name: 'App-Name', value: 'My-Awesome-App' }],
 });
@@ -905,7 +728,7 @@ const { id: txId } = await authenticatedArIO.decreaseDelegateStake(params, {
 
 #### `increaseOperatorStake({ qty })`
 
-Increases the callers operator stake. Must be executed with a wallet registered as a gateway operator. Requires `signer` to be provided on `ArIO.init` to sign the transaction.
+Increases the callers operator stake. Must be executed with a wallet registered as a gateway operator. Requires `signer` to be provided on `IO.init` to sign the transaction.
 
 ```typescript
 const params = {
@@ -914,7 +737,7 @@ const params = {
 
 const signer = new ArweaveSigner(jwk);
 // signer required for write interactions APIs
-const authenticatedArIO = ArIO.init({ signer });
+const authenticatedArIO = IO.init({ signer });
 const { id: txId } = await authenticatedArIO.increaseOperatorStake(params, {
   tags: [{ name: 'App-Name', value: 'My-Awesome-App' }],
 });
@@ -922,7 +745,7 @@ const { id: txId } = await authenticatedArIO.increaseOperatorStake(params, {
 
 #### `decreaseOperatorStake({ qty })`
 
-Decreases the callers operator stake. Must be executed with a wallet registered as a gateway operator. Requires `signer` to be provided on `ArIO.init` to sign the transaction.
+Decreases the callers operator stake. Must be executed with a wallet registered as a gateway operator. Requires `signer` to be provided on `IO.init` to sign the transaction.
 
 ```typescript
 const params = {
@@ -931,7 +754,7 @@ const params = {
 
 const signer = new ArweaveSigner(jwk);
 // signer required for write interactions APIs
-const authenticatedArIO = ArIO.init({ signer });
+const authenticatedArIO = IO.init({ signer });
 const { id: txId } = await authenticatedArIO.decreaseOperatorStake(params, {
   tags: [{ name: 'App-Name', value: 'My-Awesome-App' }],
 });
@@ -939,7 +762,7 @@ const { id: txId } = await authenticatedArIO.decreaseOperatorStake(params, {
 
 #### `saveObservations({ reportTxId, failedGateways })`
 
-Saves the observations of the current epoch. Requires `signer` to be provided on `ArIO.init` to sign the transaction.
+Saves the observations of the current epoch. Requires `signer` to be provided on `IO.init` to sign the transaction.
 
 ```typescript
 const params = {
@@ -949,7 +772,7 @@ const params = {
 
 const signer = new ArweaveSigner(jwk);
 // signer required for write interactions APIs
-const authenticatedArIO = ArIO.init({ signer });
+const authenticatedArIO = IO.init({ signer });
 const { id: txId } = await authenticatedArIO.saveObservations(params, {
   tags: [{ name: 'App-Name', value: 'My-Awesome-App' }],
 });
@@ -957,11 +780,11 @@ const { id: txId } = await authenticatedArIO.saveObservations(params, {
 
 #### `transfer({ target, qty, denomination })`
 
-Transfers `IO` or `mIO` depending on the `denomination` selected, defaulting as `IO`, to the designated `target` recipient address. Requires `signer` to be provided on `ArIO.init` to sign the transaction.
+Transfers `IO` or `mIO` depending on the `denomination` selected, defaulting as `IO`, to the designated `target` recipient address. Requires `signer` to be provided on `IO.init` to sign the transaction.
 
 ```typescript
 // signer required for write interactions APIs
-const authenticatedArIO = ArIO.init({ signer });
+const authenticatedArIO = IO.init({ signer });
 const { id: txId } = await authenticatedArIO.transfer(
   {
     target: '-5dV7nk7waR8v4STuwPnTck1zFVkQqJh5K9q9Zik4Y5',
@@ -978,7 +801,7 @@ const { id: txId } = await authenticatedArIO.transfer(
 Increases the undername support of a domain up to a maximum of 10k. Domains, by default, support up to 10 undernames.
 
 ```typescript
-const authenticatedArIO = ArIO.init({ signer });
+const authenticatedArIO = IO.init({ signer });
 const { id: txId } = await authenticatedArIO.increaseUndernameLimit(
   {
     domain: 'ar-io',
@@ -994,7 +817,7 @@ const { id: txId } = await authenticatedArIO.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 authenticatedArIO = ArIO.init({ signer });
+const authenticatedArIO = IO.init({ signer });
 const { id: txId } = await authenticatedArIO.extendLease(
   {
     domain: 'ar-io',
@@ -1005,34 +828,20 @@ const { id: txId } = await authenticatedArIO.extendLease(
 );
 ```
 
-### Custom Contracts
+### Custom Processes
 
-The ArIO contract client class exposes APIs relevant to the ar.io contract. It can be configured to use any contract ID that adheres to the spec of the ar.io contract. In the default case, it will automatically build and utilize a contract data provider interface that is configured to point the the known mainnet contract ID at construction time. You can provide custom contract data provider or, alternatively, a `contractTxId` to the ArIO constructor to use a different, ar.io-spec-compatible contract.
+The ArIO client class exposes APIs relevant to the ar.io process. It can be configured to use any AO Process ID that adheres to the spec of the ar.io process. In the default case, it will automatically build and utilize a process data provider interface that is configured to point the the known ar.io mainnet process ID at construction time. You can provide custom process data provider or, alternatively, a `processId` to the ArIO constructor to use a different, ar.io-spec-compatible process.
 
 ```typescript
-// provide a custom contractTxId to the client and default to remote evaluation
-const remoteCustomArIO = ArIO.init({
-  contractTxId: 'TESTNET_CONTRACT_TX_ID',
-});
-
-// provide a custom contract to the client, and specify local evaluation using warp
-const localCustomArIO = ArIO.init({
-  contract: new WarpContract<ArIOState>({
-    contractTxId: 'TESTNET_CONTRACT_TX_ID',
-  }),
-});
-
-// provide a custom contract to the client, and specify local evaluation using remote cache
-const remoteCacheCustomArIO = ArIO.init({
-  contract: new RemoteContract<ArIOState>({
-    contractTxId: 'TESTNET_CONTRACT_TX_ID',
-  }),
+// provide a custom processId to the client and default to remote evaluation
+const remoteCustomArIO = IO.init({
+  processId: 'TESTNET_PROCESS_ID',
 });
 ```
 
 ## Arweave Name Tokens (ANT's)
 
-The ANT contract client class exposes APIs relevant to compliant Arweave Name Token contracts. It can be configured to use any contract ID that adheres to the ANT contract spec. You must provide either a custom contract data provider or a contractTxId to the ANT class constructor to use.
+The ANT client class exposes APIs relevant to compliant Arweave Name Token processes. It can be configured to use any process ID that adheres to the ANT process spec. You must provide either a custom process data provider or a processId to the ANT class constructor to use.
 
 ### APIs
 
@@ -1050,143 +859,25 @@ const arweave = Arweave.init({
 const browserSigner = new ArConnectSigner(window.arweaveWallet, arweave);
 const ant = ANT.init({
   signer: browserSigner,
-  contractTxId: 'bh9l1cy0aksiL_x9M359faGzM_yjralacHIUo8_nQXM'
+  processId: 'bh9l1cy0aksiL_x9M359faGzM_yjralacHIUo8_nQXM'
 });
 
 // in a node environment
 const nodeSigner = new ArweaveSigner(JWK);
 const ant = ANT.init({
   signer: nodeSigner,
-  contractTxId: 'bh9l1cy0aksiL_x9M359faGzM_yjralacHIUo8_nQXM'
+  processId: 'bh9l1cy0aksiL_x9M359faGzM_yjralacHIUo8_nQXM'
 });
 
 ```
 
-### `getState({ evaluationOptions })`
-
-Retrieves the current state of the ANT contract.
-
-```typescript
-const ant = ANT.init({
-  contractTxId: 'bh9l1cy0aksiL_x9M359faGzM_yjralacHIUo8_nQXM',
-});
-const state = await ant.getState();
-```
-
-<details>
-  <summary>Output</summary>
-
-```json
-{
-  "balances": {
-    "ccp3blG__gKUvG3hsGC2u06aDmqv4CuhuDJGOIg0jw4": 1
-  },
-  "controller": "6Z-ifqgVi1jOwMvSNwKWs6ewUEQ0gU9eo4aHYC3rN1M",
-  "evolve": null,
-  "name": "ArDrive.io",
-  "owner": "ccp3blG__gKUvG3hsGC2u06aDmqv4CuhuDJGOIg0jw4",
-  "records": {
-    "@": {
-      "transactionId": "nOXJjj_vk0Dc1yCgdWD8kti_1iHruGzLQLNNBHVpN0Y",
-      "ttlSeconds": 3600
-    },
-    "cn": {
-      "transactionId": "_HquerT6pfGFXrVxRxQTkJ7PV5RciZCqvMjLtUY0C1k",
-      "ttlSeconds": 3300
-    },
-    "dapp": {
-      "transactionId": "hxlxVgAG0K4o3fVD9T6Q4VBWpPmMZwMWgRh1kcuh3WU",
-      "ttlSeconds": 3600
-    },
-    "logo": {
-      "transactionId": "KKmRbIfrc7wiLcG0zvY1etlO0NBx1926dSCksxCIN3A",
-      "ttlSeconds": 3600
-    },
-    "og": {
-      "transactionId": "YzD_Pm5VAfYpMD3zQCgMUcKKuleGhEH7axlrnrDCKBo",
-      "ttlSeconds": 3600
-    },
-    "og_dapp": {
-      "transactionId": "5iR4wBu4KUV1pUz1YpYE1ARXSRHUT5G2ptMuoN2JDlI",
-      "ttlSeconds": 3600
-    },
-    "og_logo": {
-      "transactionId": "TB2wJyKrPnkAW79DAwlJYwpgdHKpijEJWQfcwX715Co",
-      "ttlSeconds": 3600
-    }
-  }
-}
-```
-
-</details>
-
-Alternatively, you can get the contract at a specific block height or sort key by providing `evaluationOptions`:
-
-```typescript
-const ant = ANT.init({
-  contractTxId: 'bh9l1cy0aksiL_x9M359faGzM_yjralacHIUo8_nQXM',
-});
-const state = await ant.getState({
-  evaluationOptions: {
-    evalTo: { blockHeight: 1382230 },
-  },
-});
-```
-
-<details>
-  <summary>Output</summary>
-
-```json
-{
-  "balances": {
-    "ccp3blG__gKUvG3hsGC2u06aDmqv4CuhuDJGOIg0jw4": 1
-  },
-  "controller": "6Z-ifqgVi1jOwMvSNwKWs6ewUEQ0gU9eo4aHYC3rN1M",
-  "evolve": null,
-  "name": "ArDrive.io",
-  "owner": "ccp3blG__gKUvG3hsGC2u06aDmqv4CuhuDJGOIg0jw4",
-  "records": {
-    "@": {
-      "transactionId": "nOXJjj_vk0Dc1yCgdWD8kti_1iHruGzLQLNNBHVpN0Y",
-      "ttlSeconds": 3600
-    },
-    "cn": {
-      "transactionId": "_HquerT6pfGFXrVxRxQTkJ7PV5RciZCqvMjLtUY0C1k",
-      "ttlSeconds": 3300
-    },
-    "dapp": {
-      "transactionId": "hxlxVgAG0K4o3fVD9T6Q4VBWpPmMZwMWgRh1kcuh3WU",
-      "ttlSeconds": 3600
-    },
-    "logo": {
-      "transactionId": "KKmRbIfrc7wiLcG0zvY1etlO0NBx1926dSCksxCIN3A",
-      "ttlSeconds": 3600
-    },
-    "og": {
-      "transactionId": "YzD_Pm5VAfYpMD3zQCgMUcKKuleGhEH7axlrnrDCKBo",
-      "ttlSeconds": 3600
-    },
-    "og_dapp": {
-      "transactionId": "5iR4wBu4KUV1pUz1YpYE1ARXSRHUT5G2ptMuoN2JDlI",
-      "ttlSeconds": 3600
-    },
-    "og_logo": {
-      "transactionId": "TB2wJyKrPnkAW79DAwlJYwpgdHKpijEJWQfcwX715Co",
-      "ttlSeconds": 3600
-    }
-  }
-}
-```
-
-</details>
-
 #### `getOwner({ evaluationOptions })`
 
-Returns the owner of the configured ANT contract.
+Returns the owner of the configured ANT process.
 
 ```typescript
-const contractTxId = 'bh9l1cy0aksiL_x9M359faGzM_yjralacHIUo8_nQXM';
-const ant = ANT.init({ contractTxId });
+const processId = 'bh9l1cy0aksiL_x9M359faGzM_yjralacHIUo8_nQXM';
+const ant = ANT.init({ processId });
 const owner = await ant.getOwner();
 ```
 
@@ -1201,11 +892,11 @@ const owner = await ant.getOwner();
 
 #### `getControllers({ evaluationOptions })`
 
-Returns the controllers of the configured ANT contract.
+Returns the controllers of the configured ANT process.
 
 ```typescript
-const contractTxId = 'bh9l1cy0aksiL_x9M359faGzM_yjralacHIUo8_nQXM';
-const ant = ANT.init({ contractTxId });
+const processId = 'bh9l1cy0aksiL_x9M359faGzM_yjralacHIUo8_nQXM';
+const ant = ANT.init({ processId });
 const controllers = await ant.getControllers();
 ```
 
@@ -1220,11 +911,11 @@ const controllers = await ant.getControllers();
 
 #### `getRecords({ evaluationOptions })`
 
-Returns all records on the configured ANT contract, including the required `@` record that resolve connected ArNS names.
+Returns all records on the configured ANT process, including the required `@` record that resolve connected ArNS names.
 
 ```typescript
-const contractTxId = 'bh9l1cy0aksiL_x9M359faGzM_yjralacHIUo8_nQXM';
-const ant = ANT.init({ contractTxId });
+const processId = 'bh9l1cy0aksiL_x9M359faGzM_yjralacHIUo8_nQXM';
+const ant = ANT.init({ processId });
 const records = await ant.getRecords();
 ```
 
@@ -1271,8 +962,8 @@ const records = await ant.getRecords();
 Transfers ownership of the ANT to a new target address. Target MUST be an Arweave address.
 
 ```typescript
-const contractTxId = 'bh9l1cy0aksiL_x9M359faGzM_yjralacHIUo8_nQXM';
-const ant = ANT.init({ contractTxId });
+const processId = 'bh9l1cy0aksiL_x9M359faGzM_yjralacHIUo8_nQXM';
+const ant = ANT.init({ processId });
 const recipient = 'aGzM_yjralacHIUo8_nQXMbh9l1cy0aksiL_x9M359f';
 const { id: txId } = await ant.transfer(
   { target: recipient },
@@ -1283,11 +974,11 @@ const { id: txId } = await ant.transfer(
 
 #### `setController({ controller })`
 
-Adds a new controller to the list of approved controllers on the ANT. Controllers can set records and change the ticker and name of the ANT contract.
+Adds a new controller to the list of approved controllers on the ANT. Controllers can set records and change the ticker and name of the ANT process.
 
 ```typescript
-const contractTxId = 'bh9l1cy0aksiL_x9M359faGzM_yjralacHIUo8_nQXM';
-const ant = ANT.init({ contractTxId });
+const processId = 'bh9l1cy0aksiL_x9M359faGzM_yjralacHIUo8_nQXM';
+const ant = ANT.init({ processId });
 const controller = 'aGzM_yjralacHIUo8_nQXMbh9l1cy0aksiL_x9M359f';
 const { id: txId } = await ant.setController(
   { controller },
@@ -1301,8 +992,8 @@ const { id: txId } = await ant.setController(
 Removes a controller from the list of approved controllers on the ANT.
 
 ```typescript
-const contractTxId = 'bh9l1cy0aksiL_x9M359faGzM_yjralacHIUo8_nQXM';
-const ant = ANT.init({ contractTxId });
+const processId = 'bh9l1cy0aksiL_x9M359faGzM_yjralacHIUo8_nQXM';
+const ant = ANT.init({ processId });
 const controller = 'aGzM_yjralacHIUo8_nQXMbh9l1cy0aksiL_x9M359f';
 const { id: txId } = await ant.removeController(
   { controller },
@@ -1313,13 +1004,13 @@ const { id: txId } = await ant.removeController(
 
 #### `setRecord({ subDomain, transactionId, ttlSeconds })`
 
-Updates or creates a record in the ANT contract.
+Updates or creates a record in the ANT process.
 
 > Records, or `undernames` are configured with the `transactionId` - the arweave transaction id the record resolves - and `ttlSeconds`, the Time To Live in the cache of client applications.
 
 ```typescript
-const contractTxId = 'bh9l1cy0aksiL_x9M359faGzM_yjralacHIUo8_nQXM';
-const ant = ANT.init({ contractTxId });
+const processId = 'bh9l1cy0aksiL_x9M359faGzM_yjralacHIUo8_nQXM';
+const ant = ANT.init({ processId });
 const subDomain = 'test-domain';
 const transactionId = '432l1cy0aksiL_x9M359faGzM_yjralacHIUo8_nQXM';
 const ttlSeconds = 900;
@@ -1336,11 +1027,11 @@ const { id: txId } = await ant.setRecord(
 
 #### `removeRecord({ subDomain })`
 
-Removes a record from the ANT contract.
+Removes a record from the ANT process.
 
 ```typescript
-const contractTxId = 'bh9l1cy0aksiL_x9M359faGzM_yjralacHIUo8_nQXM';
-const ant = ANT.init({ contractTxId });
+const processId = 'bh9l1cy0aksiL_x9M359faGzM_yjralacHIUo8_nQXM';
+const ant = ANT.init({ processId });
 const subDomain = 'test-domain';
 const { id: txId } = await ant.removeRecord(
   { subDomain },
@@ -1351,11 +1042,11 @@ const { id: txId } = await ant.removeRecord(
 
 #### `setName({ name })`
 
-Sets the name of the ANT contract.
+Sets the name of the ANT process.
 
 ```typescript
-const contractTxId = 'bh9l1cy0aksiL_x9M359faGzM_yjralacHIUo8_nQXM';
-const ant = ANT.init({ contractTxId });
+const processId = 'bh9l1cy0aksiL_x9M359faGzM_yjralacHIUo8_nQXM';
+const ant = ANT.init({ processId });
 const name = 'chumbawumba';
 const { id: txId } = await ant.setName(
   { name },
@@ -1366,11 +1057,11 @@ const { id: txId } = await ant.setName(
 
 #### `setTicker({ ticker })`
 
-Sets the ticker of the ANT contract.
+Sets the ticker of the ANT process.
 
 ```typescript
-const contractTxId = 'bh9l1cy0aksiL_x9M359faGzM_yjralacHIUo8_nQXM';
-const ant = ANT.init({ contractTxId });
+const processId = 'bh9l1cy0aksiL_x9M359faGzM_yjralacHIUo8_nQXM';
+const ant = ANT.init({ processId });
 const ticker = 'ANT-WUMBA';
 const { id: txId } = await ant.setTicker(
   { ticker },
@@ -1380,29 +1071,12 @@ const { id: txId } = await ant.setTicker(
 
 ### Configuration
 
-ANT clients can be configured to use custom contract evaluator. By default they will use the remote evaluator that leverages the [arns-service].
+ANT clients can be configured to use custom process evaluator. By default they will use the AO Testnet located at ao-testnet.xyz
 
 ```typescript
-// provide a contractTxId to the client and default to remote evaluation
+// provide a processId to the client and default to remote evaluation
 const remoteANT = ANT.init({
-  contractTxId: 'ANT_CONTRACT_TX_ID',
-});
-
-// provide a custom contract to the client, and specify local evaluation using warp
-const warpEvaluatedANT = ANT.init({
-  contract: new WarpContract<ANTState>({
-    contractTxId: 'ANT_CONTRACT_TX_ID',
-  }),
-  signer, // signer is required when created warp-contract instances
-});
-
-// provide a custom contract to the client, and specify local evaluation using remote cache
-const remoteANTContract = ANT.init({
-  contract: new RemoteContract<ANTState>({
-    contractTxId: 'ANT_CONTRACT_TX_ID',
-    // the remote api that returns warp compliant contract evaluation
-    url: 'https://api.arns.app/v1/contract',
-  }),
+  processId: 'ANT_PROCESS_ID',
 });
 ```
 
@@ -1422,7 +1096,7 @@ const remoteANTContract = ANT.init({
 
 ### Testing
 
-- `yarn test:integration` - runs integration tests against a local [arns-service]
+- `yarn test:integration` - runs integration tests against a local AO testnet
 - `yarn example:web` - opens up the example web page
 - `yarn example:cjs` - runs example CJS node script
 - `yarn example:esm` - runs example ESM node script
@@ -1450,5 +1124,4 @@ For more information on how to contribute, please see [CONTRIBUTING.md].
 [examples]: ./examples
 [examples/webpack]: ./examples/webpack
 [examples/vite]: ./examples/vite
-[arns-service]: https://github.com/ar-io/arns-service
 [CONTRIBUTING.md]: ./CONTRIBUTING.md