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

package/README.md

@@ -15,21 +15,22 @@ 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 Process](#ario-process)
+- [IO Process](#io-process)
 
-  - [APIs](#apis)
+  - [IO APIs](#apis)
     - [`init({ signer })`](#init-signer-)
-    - [`getBalance({ address, evaluationOptions })`](#getbalance-address-evaluationoptions-)
-    - [`getBalances({ evaluationOptions })`](#getbalances-evaluationoptions-)
-    - [`getGateway({ address, evaluationOptions })`](#getgateway-address-evaluationoptions-)
-    - [`getGateways({ evaluationOptions })`](#getgateways-evaluationoptions-)
-    - [`getArNSRecord({ domain, evaluationOptions })`](#getarnsrecord-domain-evaluationoptions-)
-    - [`getArNSRecords({ evaluationOptions })`](#getarnsrecords-evaluationoptions-)
-    - [`getObservations({ evaluationOptions })`](#getobservations-evaluationoptions-)
-    - [`getDistributions({ evaluationOptions })`](#getdistributions-evaluationoptions-)
-    - [`getEpoch({ evaluationOptions })`](#getepoch-evaluationoptions-)
-    - [`getCurrentEpoch({ evaluationOptions })`](#getcurrentepoch-evaluationoptions-)
-    - [`getPrescribedObservers({ evaluationOptions })`](#getprescribedobservers-evaluationoptions-)
+    - [`getInfo()`](#getinfo)
+    - [`getBalance({ address })`](#getbalance-address-)
+    - [`getBalances()`](#getbalances)
+    - [`getGateway({ address })`](#getgateway-address-)
+    - [`getGateways()`](#getgateways)
+    - [`getArNSRecord({ name })`](#getarnsrecord-name-)
+    - [`getArNSRecords()`](#getarnsrecords)
+    - [`getObservations({ epochIndex })`](#getobservations-epochindex-)
+    - [`getDistributions({ epochIndex })`](#getdistributions-epochindex-)
+    - [`getEpoch({ epochIndex })`](#getepoch-epochindex-)
+    - [`getCurrentEpoch()`](#getcurrentepoch)
+    - [`getPrescribedObservers({ epochIndex })`](#getprescribedobservers-epochindex-)
     - [`joinNetwork(params)`](#joinnetworkparams)
     - [`updateGatewaySettings(gatewaySettings)`](#updategatewaysettingsgatewaysettings)
     - [`increaseDelegateStake({ target, qty })`](#increasedelegatestake-target-qty-)
@@ -38,19 +39,20 @@ 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 Processes](#custom-processes)
+  - [Configuration](#custom-configuration)
 
 - [Arweave Name Tokens (ANT's)](#arweave-name-tokens-ants)
-  - [APIs](#apis-1)
-    - [`init({ signer })`](#init-signer-)
-    - [`getOwner({ evaluationOptions })`](#getowner-evaluationoptions-)
-    - [`getControllers({ evaluationOptions })`](#getcontrollers-evaluationoptions-)
-    - [`getRecords({ evaluationOptions })`](#getrecords-evaluationoptions-)
+  - [ANT APIs](#ant-apis)
+    - [`init({ signer})`](#init-signer-)
+    - [`getInfo()`](#getinfo)
+    - [`getOwner()`](#getowner)
+    - [`getControllers()`](#getcontrollers)
+    - [`getRecords()`](#getrecords)
     - [`transfer({ target })`](#transfer-target-)
     - [`setController({ controller })`](#setcontroller-controller-)
     - [`removeController({ controller })`](#removecontroller-controller-)
-    - [`setRecord({ subDomain, transactionId, ttlSeconds })`](#setrecord-subdomain-transactionid-ttlseconds-)
-    - [`removeRecord({ subDomain })`](#removerecord-subdomain-)
+    - [`setRecord({ undername, transactionId, ttlSeconds })`](#setrecord-undername-transactionid-ttlseconds-)
+    - [`removeRecord({ undername })`](#removerecord-undername-)
     - [`setName({ name })`](#setname-name-)
     - [`setTicker({ ticker })`](#setticker-ticker-)
   - [Configuration](#configuration)
@@ -83,8 +85,8 @@ yarn add @ar.io/sdk
 ```typescript
 import { IO } from '@ar.io/sdk';
 
-const arIO = IO.init();
-const gateways = await arIO.getGateways();
+const io = IO.init();
+const gateways = await io.getGateways();
 ```
 
 <details>
@@ -137,12 +139,12 @@ The SDK is provided in both CommonJS and ESM formats and is compatible with bund
 #### Bundlers (Webpack, Rollup, ESbuild, etc.)
 
 ```javascript
-import { IO } from '@ar.io/sdk';
+import { IO } from '@ar.io/sdk/web';
 
 // set up client
-const arIO = IO.init();
+const io = IO.init();
 // fetch gateways
-const gateways = await arIO.getGateways();
+const gateways = await io.getGateways();
 ```
 
 > _**Note**: polyfills are only provided when using the named `@ar.io/sdk/web` export (which requires `moduleResolution: nodenext` in `tsconfig.json`). If you are using the default export within a Typescript project (e.g. `moduleResolution: node`), you will need to provide your own polyfills - specifically `crypto`, `fs` and `buffer`. Refer to [examples/webpack] and [examples/vite] for references in how to properly provide those polyfills. For other project configurations, refer to your bundler's documentation for more information on how to provide the necessary polyfills._
@@ -154,9 +156,9 @@ const gateways = await arIO.getGateways();
   import { IO } from 'https://unpkg.com/@ar.io/sdk';
 
   // set up client
-  const arIO = IO.init();
+  const io = IO.init();
   // fetch gateways
-  const gateways = await arIO.getGateways();
+  const gateways = await io.getGateways();
 </script>
 ```
 
@@ -168,9 +170,9 @@ const gateways = await arIO.getGateways();
 import { IO } from '@ar.io/sdk/node';
 
 // set up client
-const arIO = IO.init();
+const io = IO.init();
 // fetch gateways
-const gateways = await arIO.getGateways();
+const gateways = await io.getGateways();
 ```
 
 #### CJS
@@ -179,9 +181,9 @@ const gateways = await arIO.getGateways();
 import { IO } from '@ar.io/sdk';
 
 // set up client
-const arIO = IO.init();
+const io = IO.init();
 // fetch gateways
-const gateways = await arIO.getGateways();
+const gateways = await io.getGateways();
 ```
 
 ### Typescript
@@ -190,7 +192,7 @@ The SDK provides TypeScript types. When you import the SDK in a TypeScript proje
 
 ## IOToken & mIOToken
 
-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.
+The IO 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 process interactions expect values in mIO. If numbers are provided as inputs, they are assumed to be in raw mIO values.**
 
@@ -208,7 +210,7 @@ const ioValue = new mIOToken(mIOValue).toIO();
 console.log(ioValue); // 1 (IO)
 ```
 
-## ArIO Process
+## IO Process
 
 ### APIs
 
@@ -217,32 +219,48 @@ console.log(ioValue); // 1 (IO)
 Factory function to that creates a read-only or writeable client. By providing a `signer` additional write APIs that require signing, like `joinNetwork` and `delegateStake` are available. By default, a read-only client is returned and no write APIs are available.
 
 ```typescript
-// read-only client that has access to all read APIs
-const arIOReadable = IO.init()
+// read-only client
+const io = IO.init()
+
+// read-write client for browser environments
+const io = IO.init({ signer: new ArConnectSigner(window.arweaveWallet, Arweave.init({}))});
+
+// read-write client for node environments
+const io = IO.init({ signer: new ArweaveSigner(JWK) });
+
+```
 
-const arweave = Arweave.init({
-  host: 'ar-io.dev',
-  port: 443,
-  protocol: 'https'
-})
-// for browser environments
-const browserSigner = new ArConnectSigner(window.arweaveWallet, arweave);
-const arIOWriteable = IO.init({ signer: browserSigner});
+#### `getInfo()`
 
-// for node environments
-const nodeSigner = new ArweaveSigner(JWK);
-const arIOWriteable = IO.init({ signer: nodeSigner});
+Retrieves the information of the IO process.
 
+```typescript
+const io = IO.init();
+const info = await io.getInfo();
 ```
 
-#### `getBalance({ address, evaluationOptions })`
+<details>
+  <summary>Output</summary>
+
+```json
+{
+  "name": "Testnet IO",
+  "ticker": "tIO",
+  "owner": "QGWqtJdLLgm2ehFWiiPzMaoFLD50CnGuzZIPEdoDRGQ",
+  "denomination": "IO"
+}
+```
+
+</details>
+
+#### `getBalance({ address })`
 
 Retrieves the balance of the specified wallet address.
 
 ```typescript
-const arIO = IO.init();
+const io = IO.init();
 // the balance will be returned in mIO as a value
-const balance = await arIO
+const balance = await io
   .getBalance({
     address: 'INSERT_WALLET_ADDRESS',
   })
@@ -261,19 +279,19 @@ console.log(balance.valueOf());
 
 </details>
 
-#### `getBalances({ evaluationOptions })`
+#### `getBalances()`
 
-Retrieves the balances of the ArIO process in `mIO`
+Retrieves the balances of the IO process in `mIO`
 
 <!--
 // ALM - A part of me wonders whether streaming JSON might be beneficial in the future
 // and if providing streaming versions of these APIs will scale nicely longer term, e.g.
-// arIO.streamBalances({ sortingCriteria: BALANCE_DESC });
+// io.streamBalances({ sortingCriteria: BALANCE_DESC });
  -->
 
 ```typescript
-const arIO = IO.init();
-const balances = await arIO.getBalances();
+const io = IO.init();
+const balances = await io.getBalances();
 ```
 
 <details>
@@ -289,13 +307,13 @@ const balances = await arIO.getBalances();
 
 </details>
 
-#### `getGateway({ address, evaluationOptions })`
+#### `getGateway({ address })`
 
 Retrieves a gateway's info by its staking wallet address.
 
 ```typescript
-const arIO = IO.init();
-const gateway = await arIO.getGateway({
+const io = IO.init();
+const gateway = await io.getGateway({
   address: 'INSERT_GATEWAY_ADDRESS',
 });
 ```
@@ -325,27 +343,19 @@ const gateway = await arIO.getGateway({
     "totalEpochsPrescribedCount": 31
   },
   "status": "joined",
-  "vaults": {},
-  "weights": {
-    "stakeWeight": 25,
-    "tenureWeight": 0.9031327160493827,
-    "gatewayRewardRatioWeight": 0.96875,
-    "observerRewardRatioWeight": 0.96875,
-    "compositeWeight": 21.189222170982834,
-    "normalizedCompositeWeight": 0.27485583057217183
-  }
+  "vaults": {}
 }
 ```
 
 </details>
 
-#### `getGateways({ evaluationOptions })`
+#### `getGateways()`
 
-Retrieves the registered gateways of the ArIO process.
+Retrieves the registered gateways of the IO process.
 
 ```typescript
-const arIO = IO.init();
-const gateways = await arIO.getGateways();
+const io = IO.init();
+const gateways = await io.getGateways();
 ```
 
 <details>
@@ -374,28 +384,20 @@ const gateways = await arIO.getGateways();
       "totalEpochsPrescribedCount": 31
     },
     "status": "joined",
-    "vaults": {},
-    "weights": {
-      "stakeWeight": 25,
-      "tenureWeight": 0.9031327160493827,
-      "gatewayRewardRatioWeight": 0.96875,
-      "observerRewardRatioWeight": 0.96875,
-      "compositeWeight": 21.189222170982834,
-      "normalizedCompositeWeight": 0.27485583057217183
-    }
+    "vaults": {}
   }
 }
 ```
 
 </details>
 
-#### `getArNSRecord({ domain, evaluationOptions })`
+#### `getArNSRecord({ name })`
 
 Retrieves the record info of the specified ArNS name.
 
 ```typescript
-const arIO = IO.init();
-const record = await arIO.getArNSRecord({ domain: 'ardrive' });
+const io = IO.init();
+const record = await io.getArNSRecord({ name: 'ardrive' });
 ```
 
 <details>
@@ -413,13 +415,13 @@ const record = await arIO.getArNSRecord({ domain: 'ardrive' });
 
 </details>
 
-#### `getArNSRecords({ evaluationOptions })`
+#### `getArNSRecords()`
 
-Retrieves all registered ArNS records of the ArIO process.
+Retrieves all registered ArNS records of the IO process.
 
 ```typescript
-const arIO = IO.init();
-const records = await arIO.getArNSRecords();
+const io = IO.init();
+const records = await io.getArNSRecords();
 ```
 
 <details>
@@ -446,13 +448,13 @@ const records = await arIO.getArNSRecords();
 
 </details>
 
-#### `getObservations({ evaluationOptions })`
+#### `getObservations({ epochIndex })`
 
 Returns the epoch-indexed observation list.
 
 ```typescript
-const arIO = IO.init();
-const observations = await arIO.getObservations();
+const io = IO.init();
+const observations = await io.getObservations();
 ```
 
 <details>
@@ -460,7 +462,7 @@ const observations = await arIO.getObservations();
 
 ```json
 {
-  "1350700": {
+  "0": {
     "failureSummaries": {
       "-Tk2DDk8k4zkwtppp_XFKKI5oUgh6IEHygAoN7mD-w8": [
         "Ie2wEEUDKoU26c7IuckHNn3vMFdNQnMvfPBrFzAb3NA",
@@ -479,13 +481,13 @@ const observations = await arIO.getObservations();
 
 </details>
 
-#### `getDistributions({ evaluationOptions })`
+#### `getDistributions({ epochIndex })`
 
-Returns the current rewards distribution information. The resulting object is pruned, to get older distributions use the `evaluationOptions` to `evalTo` a previous state.
+Returns the current rewards distribution information.
 
 ```typescript
-const arIO = IO.init();
-const distributions = await arIO.getDistributions();
+const io = IO.init();
+const distributions = await io.getDistributions();
 ```
 
 <details>
@@ -503,13 +505,13 @@ const distributions = await arIO.getDistributions();
 
 </details>
 
-#### `getEpoch({ evaluationOptions })`
+#### `getEpoch({ epochIndex })`
 
 Returns the epoch data for the specified block height.
 
 ```typescript
-const arIO = IO.init();
-const epoch = await arIO.getEpoch({ blockHeight: 1382230 });
+const io = IO.init();
+const epoch = await io.getEpoch({ epochIndex: 0 });
 ```
 
 <details>
@@ -517,24 +519,55 @@ const epoch = await arIO.getEpoch({ blockHeight: 1382230 });
 
 ```json
 {
-  "epochStartHeight": 1381660,
-  "epochEndHeight": 1382379,
-  "epochZeroStartHeight": 1350700,
-  "epochDistributionHeight": 1382394,
-  "epochPeriod": 43,
-  "epochBlockLength": 720
+  "epochIndex": 0,
+  "startTimestamp": 1694101828,
+  "endTimestamp": 1711122739,
+  "startHeight": 1350700,
+  "distributionTimestamp": 1711122739,
+  "observations": {
+    "failureSummaries": {
+      "-Tk2DDk8k4zkwtppp_XFKKI5oUgh6IEHygAoN7mD-w8": [
+        "Ie2wEEUDKoU26c7IuckHNn3vMFdNQnMvfPBrFzAb3NA"
+      ]
+    },
+    "reports": {
+      "IPdwa3Mb_9pDD8c2IaJx6aad51Ss-_TfStVwBuhtXMs": "B6UUjKWjjEWDBvDSMXWNmymfwvgR9EN27z5FTkEVlX4"
+    }
+  },
+  "prescribedNames": ["ardrive", "ar-io", "arweave", "fwd", "ao"],
+  "prescribedObservers": [
+    {
+      "gatewayAddress": "2Fk8lCmDegPg6jjprl57-UCpKmNgYiKwyhkU4vMNDnE",
+      "observerAddress": "2Fk8lCmDegPg6jjprl57-UCpKmNgYiKwyhkU4vMNDnE",
+      "stake": 10000000000, // value in mIO
+      "start": 1292450,
+      "stakeWeight": 1,
+      "tenureWeight": 0.4494598765432099,
+      "gatewayRewardRatioWeight": 1,
+      "observerRewardRatioWeight": 1,
+      "compositeWeight": 0.4494598765432099,
+      "normalizedCompositeWeight": 0.002057032496835938
+    }
+  ],
+  "distributions": {
+    "distributedTimestamp": 1711122739,
+    "totalEligibleRewards": 100000000,
+    "rewards": {
+      "IPdwa3Mb_9pDD8c2IaJx6aad51Ss-_TfStVwBuhtXMs": 100000000
+    }
+  }
 }
 ```
 
 </details>
 
-#### `getCurrentEpoch({ evaluationOptions })`
+#### `getCurrentEpoch()`
 
 Returns the current epoch data.
 
 ```typescript
-const arIO = IO.init();
-const epoch = await arIO.getCurrentEpoch();
+const io = IO.init();
+const epoch = await io.getCurrentEpoch();
 ```
 
 <details>
@@ -542,23 +575,55 @@ const epoch = await arIO.getCurrentEpoch();
 
 ```json
 {
-  "epochEndHeight": 1382379,
-  "epochPeriod": 43,
-  "epochStartHeight": 1381660,
-  "epochZeroStartHeight": 1350700,
-  "nextDistributionHeight": 1382394
+  "epochIndex": 0,
+  "startTimestamp": 1694101828,
+  "endTimestamp": 1711122739,
+  "startHeight": 1350700,
+  "distributionTimestamp": 1711122739,
+  "observations": {
+    "failureSummaries": {
+      "-Tk2DDk8k4zkwtppp_XFKKI5oUgh6IEHygAoN7mD-w8": [
+        "Ie2wEEUDKoU26c7IuckHNn3vMFdNQnMvfPBrFzAb3NA"
+      ]
+    },
+    "reports": {
+      "IPdwa3Mb_9pDD8c2IaJx6aad51Ss-_TfStVwBuhtXMs": "B6UUjKWjjEWDBvDSMXWNmymfwvgR9EN27z5FTkEVlX4"
+    }
+  },
+  "prescribedNames": ["ardrive", "ar-io", "arweave", "fwd", "ao"],
+  "prescribedObservers": [
+    {
+      "gatewayAddress": "2Fk8lCmDegPg6jjprl57-UCpKmNgYiKwyhkU4vMNDnE",
+      "observerAddress": "2Fk8lCmDegPg6jjprl57-UCpKmNgYiKwyhkU4vMNDnE",
+      "stake": 10000000000, // value in mIO
+      "start": 1292450,
+      "stakeWeight": 1,
+      "tenureWeight": 0.4494598765432099,
+      "gatewayRewardRatioWeight": 1,
+      "observerRewardRatioWeight": 1,
+      "compositeWeight": 0.4494598765432099,
+      "normalizedCompositeWeight": 0.002057032496835938
+    }
+  ],
+  "distributions": {
+    "distributedTimestamp": 1711122739,
+    "totalEligibleRewards": 100000000,
+    "rewards": {
+      "IPdwa3Mb_9pDD8c2IaJx6aad51Ss-_TfStVwBuhtXMs": 100000000
+    }
+  }
 }
 ```
 
 </details>
 
-#### `getPrescribedObservers({ evaluationOptions })`
+#### `getPrescribedObservers({ epochIndex })`
 
-Retrieves the prescribed observers of the ArIO process. To fetch prescribed observers for a previous epoch set the `evaluationOptions` to the desired epoch.
+Retrieves the prescribed observers of the IO process. To fetch prescribed observers for a previous epoch set the `epochIndex` to the desired epoch index.
 
 ```typescript
-const arIO = IO.init();
-const observers = await arIO.getPrescribedObservers();
+const io = IO.init();
+const observers = await io.getPrescribedObservers({ epochIndex: 0 });
 ```
 
 <details>
@@ -583,48 +648,16 @@ const observers = await arIO.getPrescribedObservers();
 
 </details>
 
-Fetch the prescribed observers for a previous epoch by setting the `evaluationOptions` to the desired epoch.
+#### `getTokenCost({ intent, ...args })`
 
-```typescript
-// observers from a previous epoch
-const previousEpochObservers = await arIO.getPrescribedObservers({
-  evaluationOptions: {
-    evalTo: { blockHeight: 1296975 }, // some block height from a previous epoch
-  },
-});
-```
-
-<details>
-  <summary>Output</summary>
-
-```json
-[
-  {
-    "gatewayAddress": "2Ic0ZIpt85tjiVRaD_qoTSo9jgT7w0rbf4puSTRidcU",
-    "observerAddress": "2Ic0ZIpt85tjiVRaD_qoTSo9jgT7w0rbf4puSTRidcU",
-    "stake": 10000000000, // vault in mIO
-    "start": 1292450,
-    "stakeWeight": 1,
-    "tenureWeight": 0.4494598765432099,
-    "gatewayRewardRatioWeight": 1,
-    "observerRewardRatioWeight": 1,
-    "compositeWeight": 0.4494598765432099,
-    "normalizedCompositeWeight": 0.002057032496835938
-  }
-]
-```
-
-</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.
+Calculates the price in mIO to perform the interaction in question, eg a 'Buy-record' interaction, where args are the specific params for that interaction.
 
 ```typescript
-const price = await arIO
-  .getPriceForInteraction({
-    interactionName: 'buyRecord',
-    payload: { name: 'ardrive', years: 1, type: 'lease' },
+const price = await io
+  .getTokenCost({
+    intent: 'Buy-Record',
+    name: 'ar-io',
+    type: 'permabuy',
   })
   .then((p) => new mIOToken(p).toIO());
 // Price is returned as mio, convert to IO and log it out
@@ -642,28 +675,27 @@ 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 `IO.init` to sign the transaction.
+Joins a gateway to the ar.io network via its associated wallet.
+
+_Note: Requires `signer` to be provided on `IO.init` to sign the transaction._
 
 ```typescript
-const joinNetworkParams = {
-  qty: new IOToken(10_000).toMIO(), // minimum operator stake allowed
-  autoStake: true, // auto-stake operator rewards to the gateway
-  allowDelegatedStaking: true, // allows delegated staking
-  minDelegatedStake: new IOToken(100).toMIO(), // minimum delegated stake allowed
-  delegateRewardShareRatio: 10, // percentage of rewards to share with delegates (e.g. 10%)
-  label: 'john smith', // min 1, max 64 characters
-  note: 'The example gateway', // max 256 characters
-  properties: 'FH1aVetOoulPGqgYukj0VE0wIhDy90WiQoV3U2PeY44', // Arweave transaction ID containing additional properties of the Gateway
-  observerWallet: '0VE0wIhDy90WiQoV3U2PeY44FH1aVetOoulPGqgYukj', // wallet address of the observer, must match OBSERVER_WALLET on the observer
-  fqdn: 'example.com', // fully qualified domain name - note: you must own the domain and set the OBSERVER_WALLET on your gateway to match `observerWallet`
-  port: 443, // port number
-  protocol: 'https', // only 'https' is supported
-};
-const signer = new ArweaveSigner(jwk);
-// signer required for write interactions APIs
-const authenticatedArIO = IO.init({ signer });
-const { id: txId } = await authenticatedArIO.joinNetwork(
-  joinNetworkParams,
+const io = IO.init({ signer: new ArweaveSigner(jwk) });
+const { id: txId } = await io.joinNetwork(
+  {
+    qty: new IOToken(10_000).toMIO(), // minimum operator stake allowed
+    autoStake: true, // auto-stake operator rewards to the gateway
+    allowDelegatedStaking: true, // allows delegated staking
+    minDelegatedStake: new IOToken(100).toMIO(), // minimum delegated stake allowed
+    delegateRewardShareRatio: 10, // percentage of rewards to share with delegates (e.g. 10%)
+    label: 'john smith', // min 1, max 64 characters
+    note: 'The example gateway', // max 256 characters
+    properties: 'FH1aVetOoulPGqgYukj0VE0wIhDy90WiQoV3U2PeY44', // Arweave transaction ID containing additional properties of the Gateway
+    observerWallet: '0VE0wIhDy90WiQoV3U2PeY44FH1aVetOoulPGqgYukj', // wallet address of the observer, must match OBSERVER_WALLET on the observer
+    fqdn: 'example.com', // fully qualified domain name - note: you must own the domain and set the OBSERVER_WALLET on your gateway to match `observerWallet`
+    port: 443, // port number
+    protocol: 'https', // only 'https' is supported
+  },
   // optional additional tags
   { tags: [{ name: 'App-Name', value: 'My-Awesome-App' }] },
 );
@@ -671,18 +703,17 @@ const { id: txId } = await authenticatedArIO.joinNetwork(
 
 #### `updateGatewaySettings(gatewaySettings)`
 
-Writes new gateway settings to the callers gateway configuration. Requires `signer` to be provided on `IO.init` to sign the transaction.
+Writes new gateway settings to the callers gateway configuration.
+
+_Note: Requires `signer` to be provided on `IO.init` to sign the transaction._
 
 ```typescript
-const updateGatewaySettingsParams = {
-  minDelegatedStake: new IOToken(100).toMIO(),
-};
-
-const signer = new ArweaveSigner(jwk);
-// signer required for write interactions APIs
-const authenticatedArIO = IO.init({ signer });
-const { id: txId } = await authenticatedArIO.updateGatewaySettings(
-  updateGatewaySettingsParams,
+const io = IO.init({ signer: new ArweaveSigner(jwk) });
+const { id: txId } = await io.updateGatewaySettings(
+  {
+    // any other settings you want to update
+    minDelegatedStake: new IOToken(100).toMIO(),
+  },
   // optional additional tags
   { tags: [{ name: 'App-Name', value: 'My-Awesome-App' }] },
 );
@@ -690,19 +721,17 @@ const { id: txId } = await authenticatedArIO.updateGatewaySettings(
 
 #### `increaseDelegateStake({ target, qty })`
 
-Increases the callers stake on the target gateway. Requires `signer` to be provided on `IO.init` to sign the transaction.
+Increases the callers stake on the target gateway.
+
+_Note: Requires `signer` to be provided on `IO.init` to sign the transaction._
 
 ```typescript
-const params = {
-  target: 't4Xr0_J4Iurt7caNST02cMotaz2FIbWQ4Kbj616RHl3',
-  qty: new IOToken(100).toMIO(),
-};
-
-const signer = new ArweaveSigner(jwk);
-// signer required for write interactions APIs
-const authenticatedArIO = IO.init({ signer });
-const { id: txId } = await authenticatedArIO.increaseDelegateStake(
-  params,
+const io = IO.init({ signer: new ArweaveSigner(jwk) });
+const { id: txId } = await io.increaseDelegateStake(
+  {
+    target: 't4Xr0_J4Iurt7caNST02cMotaz2FIbWQ4Kbj616RHl3',
+    qty: new IOToken(100).toMIO(),
+  },
   // optional additional tags
   { tags: [{ name: 'App-Name', value: 'My-Awesome-App' }] },
 );
@@ -710,82 +739,87 @@ const { id: txId } = await authenticatedArIO.increaseDelegateStake(
 
 #### `decreaseDelegateStake({ target, qty })`
 
-Decreases the callers stake on the target gateway. Requires `signer` to be provided on `IO.init` to sign the transaction.
+Decreases the callers stake on the target gateway.
+
+_Note: Requires `signer` to be provided on `IO.init` to sign the transaction._
 
 ```typescript
-const params = {
-  target: 't4Xr0_J4Iurt7caNST02cMotaz2FIbWQ4Kbj616RHl3',
-  qty: new IOToken(100).toMIO(),
-};
-
-const signer = new ArweaveSigner(jwk);
-// signer required for write interactions APIs
-const authenticatedArIO = IO.init({ signer });
-const { id: txId } = await authenticatedArIO.decreaseDelegateStake(params, {
-  tags: [{ name: 'App-Name', value: 'My-Awesome-App' }],
-});
+const io = IO.init({ signer: new ArweaveSigner(jwk) });
+const { id: txId } = await io.decreaseDelegateStake(
+  {
+    target: 't4Xr0_J4Iurt7caNST02cMotaz2FIbWQ4Kbj616RHl3',
+    qty: new IOToken(100).toMIO(),
+  },
+  {
+    tags: [{ name: 'App-Name', value: 'My-Awesome-App' }],
+  },
+);
 ```
 
 #### `increaseOperatorStake({ qty })`
 
-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.
+Increases the callers operator stake. Must be executed with a wallet registered as a gateway operator.
+
+_Note: Requires `signer` to be provided on `IO.init` to sign the transaction._
 
 ```typescript
-const params = {
-  qty: new IOToken(100).toMIO(),
-};
-
-const signer = new ArweaveSigner(jwk);
-// signer required for write interactions APIs
-const authenticatedArIO = IO.init({ signer });
-const { id: txId } = await authenticatedArIO.increaseOperatorStake(params, {
-  tags: [{ name: 'App-Name', value: 'My-Awesome-App' }],
-});
+const io = IO.init({ signer: new ArweaveSigner(jwk) });
+const { id: txId } = await io.increaseOperatorStake(
+  {
+    qty: new IOToken(100).toMIO(),
+  },
+  {
+    tags: [{ name: 'App-Name', value: 'My-Awesome-App' }],
+  },
+);
 ```
 
 #### `decreaseOperatorStake({ qty })`
 
 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.
 
+_Note: Requires `signer` to be provided on `IO.init` to sign the transaction._
+
 ```typescript
-const params = {
-  qty: new IOToken(100).toMIO(),
-};
-
-const signer = new ArweaveSigner(jwk);
-// signer required for write interactions APIs
-const authenticatedArIO = IO.init({ signer });
-const { id: txId } = await authenticatedArIO.decreaseOperatorStake(params, {
-  tags: [{ name: 'App-Name', value: 'My-Awesome-App' }],
-});
+const io = IO.init({ signer: new ArweaveSigner(jwk) });
+const { id: txId } = await io.decreaseOperatorStake(
+  {
+    qty: new IOToken(100).toMIO(),
+  },
+  {
+    tags: [{ name: 'App-Name', value: 'My-Awesome-App' }],
+  },
+);
 ```
 
 #### `saveObservations({ reportTxId, failedGateways })`
 
 Saves the observations of the current epoch. Requires `signer` to be provided on `IO.init` to sign the transaction.
 
+_Note: Requires `signer` to be provided on `IO.init` to sign the transaction._
+
 ```typescript
-const params = {
-  reportTxId: 'fDrr0_J4Iurt7caNST02cMotaz2FIbWQ4Kcj616RHl3',
-  failedGateways: ['t4Xr0_J4Iurt7caNST02cMotaz2FIbWQ4Kbj616RHl3'],
-};
-
-const signer = new ArweaveSigner(jwk);
-// signer required for write interactions APIs
-const authenticatedArIO = IO.init({ signer });
-const { id: txId } = await authenticatedArIO.saveObservations(params, {
-  tags: [{ name: 'App-Name', value: 'My-Awesome-App' }],
-});
+const io = IO.init({ signer: new ArweaveSigner(jwk) });
+const { id: txId } = await io.saveObservations(
+  {
+    reportTxId: 'fDrr0_J4Iurt7caNST02cMotaz2FIbWQ4Kcj616RHl3',
+    failedGateways: ['t4Xr0_J4Iurt7caNST02cMotaz2FIbWQ4Kbj616RHl3'],
+  },
+  {
+    tags: [{ name: 'App-Name', value: 'My-Awesome-App' }],
+  },
+);
 ```
 
 #### `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 `IO.init` to sign the transaction.
 
+_Note: Requires `signer` to be provided on `IO.init` to sign the transaction._
+
 ```typescript
-// signer required for write interactions APIs
-const authenticatedArIO = IO.init({ signer });
-const { id: txId } = await authenticatedArIO.transfer(
+const io = IO.init({ signer: new ArweaveSigner(jwk) });
+const { id: txId } = await io.transfer(
   {
     target: '-5dV7nk7waR8v4STuwPnTck1zFVkQqJh5K9q9Zik4Y5',
     qty: new IOToken(1000).toMIO(),
@@ -796,15 +830,17 @@ const { id: txId } = await authenticatedArIO.transfer(
 );
 ```
 
-#### `increaseUndernameLimit({ domain, qty })`
+#### `increaseUndernameLimit({ name, qty })`
 
 Increases the undername support of a domain up to a maximum of 10k. Domains, by default, support up to 10 undernames.
 
+_Note: Requires `signer` to be provided on `IO.init` to sign the transaction._
+
 ```typescript
-const authenticatedArIO = IO.init({ signer });
-const { id: txId } = await authenticatedArIO.increaseUndernameLimit(
+const io = IO.init({ signer: new ArweaveSigner(jwk) });
+const { id: txId } = await io.increaseUndernameLimit(
   {
-    domain: 'ar-io',
+    name: 'ar-io',
     qty: 420,
   },
   // optional additional tags
@@ -812,15 +848,15 @@ const { id: txId } = await authenticatedArIO.increaseUndernameLimit(
 );
 ```
 
-#### `extendLease({ domain, years })`
+#### `extendLease({ name, years })`
 
 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 = IO.init({ signer });
-const { id: txId } = await authenticatedArIO.extendLease(
+const io = IO.init({ signer: new ArweaveSigner(jwk) });
+const { id: txId } = await io.extendLease(
   {
-    domain: 'ar-io',
+    name: 'ar-io',
     years: 1,
   },
   // optional additional tags
@@ -828,14 +864,22 @@ const { id: txId } = await authenticatedArIO.extendLease(
 );
 ```
 
-### Custom Processes
+### Configuration
 
-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.
+The IO client class exposes APIs relevant to the ar.io process. It can be configured to use any AO Process ID that adheres to the [IO Network Spec]. By default, it will use the current [IO testnet process]. Refer to [AO Connect] for more information on how to configure an IO process to use specific AO infrastructure.
 
 ```typescript
-// provide a custom processId to the client and default to remote evaluation
-const remoteCustomArIO = IO.init({
-  processId: 'TESTNET_PROCESS_ID',
+// provide a custom ao infrastructure and process id
+const io = IO.init({
+  process: new AoProcess({
+    processId: 'IO_PROCESS_ID'
+    ao: connect({
+      MU_URL: 'https://mu-testnet.xyz',
+      CU_URL: 'https://cu-testnet.xyz',
+      GRAPHQL_URL: 'https://arweave.net/graphql',
+      GATEWAY_URL: 'https://arweave.net',
+    })
+  })
 });
 ```
 
@@ -843,41 +887,53 @@ const remoteCustomArIO = IO.init({
 
 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
+### ANT APIs
 
-#### `init({ signer })`
+#### `init({ signer )`
 
 Factory function to that creates a read-only or writeable client. By providing a `signer` additional write APIs that require signing, like `setRecord` and `transfer` are available. By default, a read-only client is returned and no write APIs are available.
 
 ```typescript
-const arweave = Arweave.init({
-  host: 'ar-io.dev',
-  port: 443,
-  protocol: 'https'
-})
 // in a browser environment with ArConnect
-const browserSigner = new ArConnectSigner(window.arweaveWallet, arweave);
 const ant = ANT.init({
-  signer: browserSigner,
+  signer: new ArConnectSigner(window.arweaveWallet, Arweave.init({})),
   processId: 'bh9l1cy0aksiL_x9M359faGzM_yjralacHIUo8_nQXM'
 });
 
 // in a node environment
-const nodeSigner = new ArweaveSigner(JWK);
 const ant = ANT.init({
-  signer: nodeSigner,
+  signer: new ArweaveSigner(JWK),
   processId: 'bh9l1cy0aksiL_x9M359faGzM_yjralacHIUo8_nQXM'
 });
 
 ```
 
-#### `getOwner({ evaluationOptions })`
+#### `getInfo()`
+
+Retrieves the information of the ANT process.
+
+```typescript
+const info = await ant.getInfo();
+```
+
+<details>
+  <summary>Output</summary>
+
+```json
+{
+  "name": "Ardrive",
+  "ticker": "ANT-ARDRIVE",
+  "owner": "QGWqtJdLLgm2ehFWiiPzMaoFLD50CnGuzZIPEdoDRGQ"
+}
+```
+
+</details>
+
+#### `getOwner()`
 
 Returns the owner of the configured ANT process.
 
 ```typescript
-const processId = 'bh9l1cy0aksiL_x9M359faGzM_yjralacHIUo8_nQXM';
-const ant = ANT.init({ processId });
 const owner = await ant.getOwner();
 ```
 
@@ -890,13 +946,11 @@ const owner = await ant.getOwner();
 
 </details>
 
-#### `getControllers({ evaluationOptions })`
+#### `getControllers()`
 
 Returns the controllers of the configured ANT process.
 
 ```typescript
-const processId = 'bh9l1cy0aksiL_x9M359faGzM_yjralacHIUo8_nQXM';
-const ant = ANT.init({ processId });
 const controllers = await ant.getControllers();
 ```
 
@@ -909,13 +963,11 @@ const controllers = await ant.getControllers();
 
 </details>
 
-#### `getRecords({ evaluationOptions })`
+#### `getRecords()`
 
 Returns all records on the configured ANT process, including the required `@` record that resolve connected ArNS names.
 
 ```typescript
-const processId = 'bh9l1cy0aksiL_x9M359faGzM_yjralacHIUo8_nQXM';
-const ant = ANT.init({ processId });
 const records = await ant.getRecords();
 ```
 
@@ -961,12 +1013,11 @@ const records = await ant.getRecords();
 
 Transfers ownership of the ANT to a new target address. Target MUST be an Arweave address.
 
+_Note: Requires `signer` to be provided on `ANT.init` to sign the transaction._
+
 ```typescript
-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 },
+  { target: 'aGzM_yjralacHIUo8_nQXMbh9l1cy0aksiL_x9M359f' },
   // optional additional tags
   { tags: [{ name: 'App-Name', value: 'My-Awesome-App' }] },
 );
@@ -976,12 +1027,11 @@ const { id: txId } = await ant.transfer(
 
 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.
 
+_Note: Requires `signer` to be provided on `ANT.init` to sign the transaction._
+
 ```typescript
-const processId = 'bh9l1cy0aksiL_x9M359faGzM_yjralacHIUo8_nQXM';
-const ant = ANT.init({ processId });
-const controller = 'aGzM_yjralacHIUo8_nQXMbh9l1cy0aksiL_x9M359f';
 const { id: txId } = await ant.setController(
-  { controller },
+  { controller: 'aGzM_yjralacHIUo8_nQXMbh9l1cy0aksiL_x9M359f' },
   // optional additional tags
   { tags: [{ name: 'App-Name', value: 'My-Awesome-App' }] },
 );
@@ -991,50 +1041,45 @@ const { id: txId } = await ant.setController(
 
 Removes a controller from the list of approved controllers on the ANT.
 
+_Note: Requires `signer` to be provided on `ANT.init` to sign the transaction._
+
 ```typescript
-const processId = 'bh9l1cy0aksiL_x9M359faGzM_yjralacHIUo8_nQXM';
-const ant = ANT.init({ processId });
-const controller = 'aGzM_yjralacHIUo8_nQXMbh9l1cy0aksiL_x9M359f';
 const { id: txId } = await ant.removeController(
-  { controller },
+  { controller: 'aGzM_yjralacHIUo8_nQXMbh9l1cy0aksiL_x9M359f' },
   // optional additional tags
   { tags: [{ name: 'App-Name', value: 'My-Awesome-App' }] },
 );
 ```
 
-#### `setRecord({ subDomain, transactionId, ttlSeconds })`
+#### `setRecord({ undername, transactionId, ttlSeconds })`
 
 Updates or creates a record in the ANT process.
 
+_Note: Requires `signer` to be provided on `ANT.init` to sign the transaction._
+
 > 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 processId = 'bh9l1cy0aksiL_x9M359faGzM_yjralacHIUo8_nQXM';
-const ant = ANT.init({ processId });
-const subDomain = 'test-domain';
-const transactionId = '432l1cy0aksiL_x9M359faGzM_yjralacHIUo8_nQXM';
-const ttlSeconds = 900;
 const { id: txId } = await ant.setRecord(
   {
-    subDomain,
-    transactionId,
-    ttlSeconds,
+    undername: '@',
+    transactionId: '432l1cy0aksiL_x9M359faGzM_yjralacHIUo8_nQXM'
+    ttlSeconds: 3600
   },
   // optional additional tags
   { tags: [{ name: 'App-Name', value: 'My-Awesome-App' }] },
 );
 ```
 
-#### `removeRecord({ subDomain })`
+#### `removeRecord({ undername })`
 
 Removes a record from the ANT process.
 
+_Note: Requires `signer` to be provided on `ANT.init` to sign the transaction._
+
 ```typescript
-const processId = 'bh9l1cy0aksiL_x9M359faGzM_yjralacHIUo8_nQXM';
-const ant = ANT.init({ processId });
-const subDomain = 'test-domain';
 const { id: txId } = await ant.removeRecord(
-  { subDomain },
+  { undername: 'remove-domemain' },
   // optional additional tags
   { tags: [{ name: 'App-Name', value: 'My-Awesome-App' }] },
 );
@@ -1044,12 +1089,11 @@ const { id: txId } = await ant.removeRecord(
 
 Sets the name of the ANT process.
 
+_Note: Requires `signer` to be provided on `ANT.init` to sign the transaction._
+
 ```typescript
-const processId = 'bh9l1cy0aksiL_x9M359faGzM_yjralacHIUo8_nQXM';
-const ant = ANT.init({ processId });
-const name = 'chumbawumba';
 const { id: txId } = await ant.setName(
-  { name },
+  { name: 'My ANT' },
   // optional additional tags
   { tags: [{ name: 'App-Name', value: 'My-Awesome-App' }] },
 );
@@ -1059,24 +1103,32 @@ const { id: txId } = await ant.setName(
 
 Sets the ticker of the ANT process.
 
+_Note: Requires `signer` to be provided on `ANT.init` to sign the transaction._
+
 ```typescript
-const processId = 'bh9l1cy0aksiL_x9M359faGzM_yjralacHIUo8_nQXM';
-const ant = ANT.init({ processId });
-const ticker = 'ANT-WUMBA';
 const { id: txId } = await ant.setTicker(
-  { ticker },
+  { ticker: 'ANT-NEW-TICKER' },
+  // optional tags
   { tags: [{ name: 'App-Name', value: 'My-Awesome-App' }] },
 );
 ```
 
 ### Configuration
 
-ANT clients can be configured to use custom process evaluator. By default they will use the AO Testnet located at ao-testnet.xyz
+ANT clients can be configured to use custom AO process. Refer to [AO Connect] for more information on how to configure the AO process to use specific AO infrastructure.
 
 ```typescript
-// provide a processId to the client and default to remote evaluation
-const remoteANT = ANT.init({
-  processId: 'ANT_PROCESS_ID',
+
+const ant = ANT.init({
+  process: new AoProcess({
+    processId: 'ANT_PROCESS_ID'
+    ao: connect({
+      MU_URL: 'https://mu-testnet.xyz',
+      CU_URL: 'https://cu-testnet.xyz',
+      GRAPHQL_URL: 'https://arweave.net/graphql',
+      GATEWAY_URL: 'https://arweave.net',
+    })
+  })
 });
 ```
 
@@ -1125,3 +1177,6 @@ For more information on how to contribute, please see [CONTRIBUTING.md].
 [examples/webpack]: ./examples/webpack
 [examples/vite]: ./examples/vite
 [CONTRIBUTING.md]: ./CONTRIBUTING.md
+[AO Connect]: https://github.com/permaweb/ao/tree/main/connect
+[IO testnet process]: https://www.ao.link/#/entity/agYcCFJtrMG6cqMuZfskIkFTGvUPddICmtQSBIoPdiA
+[IO Network spec]: https://github.com/ar-io/ar-io-network-process?tab=readme-ov-file#contract-spec