@ar.io/sdk 3.23.0-alpha.4 → 3.23.0-alpha.6

package/lib/cjs/common/contracts/ao-process.js

@@ -40,7 +40,7 @@ class AOProcess {
             messageData === '' ||
             messageData === null);
     }
-    async read({ tags, retries = 3, fromAddress, }) {
+    async read({ tags, retries = 3, fromAddress, select, }) {
         this.logger.debug(`Evaluating read interaction on process`, {
             tags,
             processId: this.processId,
@@ -105,7 +105,9 @@ class AOProcess {
             throw new Error(result.message ||
                 `Process ${this.processId} did not return a valid response. Response: ${JSON.stringify(result)}`);
         }
-        const messageData = result.Messages?.[0]?.Data;
+        const messageData = select
+            ? result.Messages.find(select)?.Data
+            : result.Messages?.[0]?.Data;
         // return undefined if no data is returned
         if (this.isMessageDataEmpty(messageData)) {
             return undefined;
@@ -113,7 +115,7 @@ class AOProcess {
         const response = (0, json_js_1.safeDecode)(messageData);
         return response;
     }
-    async send({ tags, data, signer, retries = 3, }) {
+    async send({ tags, data, signer, retries = 3, select, }) {
         let messageId;
         const anchor = (0, base64_js_1.getRandomText)(32); // anchor is a random text produce non-deterministic messages IDs when deterministic signers are provided (ETH)
         try {
@@ -210,7 +212,7 @@ class AOProcess {
         if (this.isMessageDataEmpty(result.Messages[0].Data)) {
             return { id: messageId };
         }
-        const resultData = (0, json_js_1.safeDecode)(result.Messages[0].Data);
+        const resultData = (0, json_js_1.safeDecode)(select ? result.Messages.find(select)?.Data : result.Messages[0].Data);
         this.logger.debug('Message result data', {
             resultData,
             messageId,

package/lib/cjs/common/marketplace.js

@@ -19,6 +19,10 @@ exports.calculateSaleTax = calculateSaleTax;
  * limitations under the License.
  */
 const index_js_1 = require("../node/index.js");
+/**
+ * Read-only client for the ArNS marketplace
+ * @experimental
+ */
 class ArNSMarketplaceRead {
     process;
     logger;
@@ -31,6 +35,7 @@ class ArNSMarketplaceRead {
     async getInfo() {
         return this.process.read({
             tags: [{ name: 'Action', value: 'Info' }],
+            select: (message) => message.Tags.some((tag) => tag.name === 'Action' && tag.value === 'Info-Notice'),
         });
     }
     async getPaginatedIntents({ cursor, limit, sortBy, sortOrder, filters, } = {}) {
@@ -45,6 +50,8 @@ class ArNSMarketplaceRead {
         const filteredTags = tags.filter((tag) => tag.value !== undefined);
         return this.process.read({
             tags: filteredTags,
+            select: (message) => message.Tags.some((tag) => tag.name === 'Action' &&
+                tag.value === 'Get-Paginated-Intents-Notice'),
         });
     }
     async getIntent(intentId) {
@@ -53,6 +60,7 @@ class ArNSMarketplaceRead {
                 { name: 'Action', value: 'Get-Intent-By-Id' },
                 { name: 'Intent-Id', value: intentId },
             ],
+            select: (message) => message.Tags.some((tag) => tag.name === 'Action' && tag.value === 'Get-Intent-By-Id-Notice'),
         });
     }
     async getIntentByANTId(antId) {
@@ -88,7 +96,10 @@ class ArNSMarketplaceRead {
             },
         ];
         const filteredTags = tags.filter((tag) => tag.value !== undefined);
-        return this.process.read({ tags: filteredTags });
+        return this.process.read({
+            tags: filteredTags,
+            select: (message) => message.Tags.some((tag) => tag.name === 'Action' && tag.value === 'Get-Orders-Notice'),
+        });
     }
     /**
      * Get a single order by ID
@@ -101,6 +112,7 @@ class ArNSMarketplaceRead {
                 { name: 'Action', value: 'Get-Order' },
                 { name: 'Order-Id', value: orderId },
             ],
+            select: (message) => message.Tags.some((tag) => tag.name === 'Action' && tag.value === 'Get-Order-Notice'),
         });
     }
     async getOrderByANTId(antId) {
@@ -123,6 +135,8 @@ class ArNSMarketplaceRead {
                 { name: 'Action', value: 'Get-Paginated-Balances' },
                 ...(0, index_js_1.paginationParamsToTags)(params),
             ],
+            select: (message) => message.Tags.some((tag) => tag.name === 'Action' &&
+                tag.value === 'Get-Paginated-Balances-Notice'),
         });
     }
     /**
@@ -134,6 +148,7 @@ class ArNSMarketplaceRead {
                 { name: 'Action', value: 'Get-Balance' },
                 { name: 'Address', value: address },
             ],
+            select: (message) => message.Tags.some((tag) => tag.name === 'Action' && tag.value === 'Get-Balance-Notice'),
         });
     }
     async getUserAssets({ address, arioProcessId, }) {
@@ -194,6 +209,10 @@ class ArNSMarketplaceRead {
     }
 }
 exports.ArNSMarketplaceRead = ArNSMarketplaceRead;
+/**
+ * Write client for the ArNS marketplace
+ * @experimental
+ */
 class ArNSMarketplaceWrite extends ArNSMarketplaceRead {
     process;
     signer;
@@ -230,6 +249,7 @@ class ArNSMarketplaceWrite extends ArNSMarketplaceRead {
                 { name: 'Quantity', value: params.amount },
             ],
             signer: this.signer,
+            select: (message) => message.Tags.some((tag) => tag.name === 'Action' && tag.value === 'Withdraw-Ario-Notice'),
         });
     }
     async createIntent({ antId, orderType, quantity, price, expirationTime, minimumPrice, decreaseInterval, }) {
@@ -247,6 +267,7 @@ class ArNSMarketplaceWrite extends ArNSMarketplaceRead {
         return this.process.send({
             tags: filteredTags,
             signer: this.signer,
+            select: (message) => message.Tags.some((tag) => tag.name === 'Action' && tag.value === 'Create-Intent-Notice'),
         });
     }
     async pushANTIntentResolution(intentId) {
@@ -256,6 +277,8 @@ class ArNSMarketplaceWrite extends ArNSMarketplaceRead {
                 { name: 'X-Intent-Id', value: intentId },
             ],
             signer: this.signer,
+            select: (message) => message.Tags.some((tag) => tag.name === 'Action' &&
+                tag.value === 'Push-ANT-Intent-Resolution-Notice'),
         });
     }
     async settleAuction(params) {
@@ -269,6 +292,7 @@ class ArNSMarketplaceWrite extends ArNSMarketplaceRead {
         return this.process.send({
             tags: filteredTags,
             signer: this.signer,
+            select: (message) => message.Tags.some((tag) => tag.name === 'Action' && tag.value === 'Settle-Auction-Notice'),
         });
     }
     async listNameForSale({ name, expirationTime, price, type, walletAddress, minimumPrice, decreaseInterval, onProgress = (event) => {
@@ -491,6 +515,7 @@ class ArNSMarketplaceWrite extends ArNSMarketplaceRead {
         return this.process.send({
             tags,
             signer: this.signer,
+            select: (message) => message.Tags.some((tag) => tag.name === 'Action' && tag.value === 'Cancel-Order-Notice'),
         });
     }
     async createOrder({ swapToken, quantity, orderType, price, expirationTime, minimumPrice, decreaseInterval, transferDenomination, }) {
@@ -510,6 +535,7 @@ class ArNSMarketplaceWrite extends ArNSMarketplaceRead {
         return this.process.send({
             tags: filteredTags,
             signer: this.signer,
+            select: (message) => message.Tags.some((tag) => tag.name === 'Action' && tag.value === 'Create-Order-Notice'),
         });
     }
     async buyFixedPriceANT(params) {
@@ -582,6 +608,8 @@ class ArNSMarketplaceWrite extends ArNSMarketplaceRead {
                 { name: 'Bid-Amount', value: params.bidAmount },
             ],
             signer: this.signer,
+            select: (message) => message.Tags.some((tag) => tag.name === 'Action' &&
+                tag.value === 'Bid-On-English-Auction-Notice'),
         });
     }
     /**
@@ -614,6 +642,7 @@ exports.ArNSMarketplaceWrite = ArNSMarketplaceWrite;
  * Calculates the listing fee for an order based on the end timestamp.
  * The fee is calculated by rounding up the hours until the end timestamp to the nearest hour.
  *
+ * @experimental
  * @param params - Parameters for calculating the listing fee
  * @param params.listingFeePerHour - The listing fee per hour in mARIO (as a string)
  * @param params.endTimestamp - Unix timestamp when the order expires
@@ -643,6 +672,7 @@ function calculateListingFee({ listingFeePerHour, endTimestamp, }) {
 /**
  * Calculates the sale tax for an order based on the sale amount.
  *
+ * @experimental
  * @param params - Parameters for calculating the sale tax
  * @param params.saleAmount - The sale amount in mARIO (as a string or number)
  * @param params.saleTaxNumerator - The numerator for sale tax calculation

package/lib/cjs/version.js

@@ -17,4 +17,4 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.version = void 0;
 // AUTOMATICALLY GENERATED FILE - DO NOT TOUCH
-exports.version = '3.23.0-alpha.4';
+exports.version = '3.23.0-alpha.6';

package/lib/esm/common/contracts/ao-process.js

@@ -37,7 +37,7 @@ export class AOProcess {
             messageData === '' ||
             messageData === null);
     }
-    async read({ tags, retries = 3, fromAddress, }) {
+    async read({ tags, retries = 3, fromAddress, select, }) {
         this.logger.debug(`Evaluating read interaction on process`, {
             tags,
             processId: this.processId,
@@ -102,7 +102,9 @@ export class AOProcess {
             throw new Error(result.message ||
                 `Process ${this.processId} did not return a valid response. Response: ${JSON.stringify(result)}`);
         }
-        const messageData = result.Messages?.[0]?.Data;
+        const messageData = select
+            ? result.Messages.find(select)?.Data
+            : result.Messages?.[0]?.Data;
         // return undefined if no data is returned
         if (this.isMessageDataEmpty(messageData)) {
             return undefined;
@@ -110,7 +112,7 @@ export class AOProcess {
         const response = safeDecode(messageData);
         return response;
     }
-    async send({ tags, data, signer, retries = 3, }) {
+    async send({ tags, data, signer, retries = 3, select, }) {
         let messageId;
         const anchor = getRandomText(32); // anchor is a random text produce non-deterministic messages IDs when deterministic signers are provided (ETH)
         try {
@@ -207,7 +209,7 @@ export class AOProcess {
         if (this.isMessageDataEmpty(result.Messages[0].Data)) {
             return { id: messageId };
         }
-        const resultData = safeDecode(result.Messages[0].Data);
+        const resultData = safeDecode(select ? result.Messages.find(select)?.Data : result.Messages[0].Data);
         this.logger.debug('Message result data', {
             resultData,
             messageId,

package/lib/esm/common/marketplace.js

@@ -14,6 +14,10 @@
  * limitations under the License.
  */
 import { ANT, AOProcess, Logger, MARKETPLACE_CONTRACT_ID, paginationParamsToTags, } from '../node/index.js';
+/**
+ * Read-only client for the ArNS marketplace
+ * @experimental
+ */
 export class ArNSMarketplaceRead {
     process;
     logger;
@@ -26,6 +30,7 @@ export class ArNSMarketplaceRead {
     async getInfo() {
         return this.process.read({
             tags: [{ name: 'Action', value: 'Info' }],
+            select: (message) => message.Tags.some((tag) => tag.name === 'Action' && tag.value === 'Info-Notice'),
         });
     }
     async getPaginatedIntents({ cursor, limit, sortBy, sortOrder, filters, } = {}) {
@@ -40,6 +45,8 @@ export class ArNSMarketplaceRead {
         const filteredTags = tags.filter((tag) => tag.value !== undefined);
         return this.process.read({
             tags: filteredTags,
+            select: (message) => message.Tags.some((tag) => tag.name === 'Action' &&
+                tag.value === 'Get-Paginated-Intents-Notice'),
         });
     }
     async getIntent(intentId) {
@@ -48,6 +55,7 @@ export class ArNSMarketplaceRead {
                 { name: 'Action', value: 'Get-Intent-By-Id' },
                 { name: 'Intent-Id', value: intentId },
             ],
+            select: (message) => message.Tags.some((tag) => tag.name === 'Action' && tag.value === 'Get-Intent-By-Id-Notice'),
         });
     }
     async getIntentByANTId(antId) {
@@ -83,7 +91,10 @@ export class ArNSMarketplaceRead {
             },
         ];
         const filteredTags = tags.filter((tag) => tag.value !== undefined);
-        return this.process.read({ tags: filteredTags });
+        return this.process.read({
+            tags: filteredTags,
+            select: (message) => message.Tags.some((tag) => tag.name === 'Action' && tag.value === 'Get-Orders-Notice'),
+        });
     }
     /**
      * Get a single order by ID
@@ -96,6 +107,7 @@ export class ArNSMarketplaceRead {
                 { name: 'Action', value: 'Get-Order' },
                 { name: 'Order-Id', value: orderId },
             ],
+            select: (message) => message.Tags.some((tag) => tag.name === 'Action' && tag.value === 'Get-Order-Notice'),
         });
     }
     async getOrderByANTId(antId) {
@@ -118,6 +130,8 @@ export class ArNSMarketplaceRead {
                 { name: 'Action', value: 'Get-Paginated-Balances' },
                 ...paginationParamsToTags(params),
             ],
+            select: (message) => message.Tags.some((tag) => tag.name === 'Action' &&
+                tag.value === 'Get-Paginated-Balances-Notice'),
         });
     }
     /**
@@ -129,6 +143,7 @@ export class ArNSMarketplaceRead {
                 { name: 'Action', value: 'Get-Balance' },
                 { name: 'Address', value: address },
             ],
+            select: (message) => message.Tags.some((tag) => tag.name === 'Action' && tag.value === 'Get-Balance-Notice'),
         });
     }
     async getUserAssets({ address, arioProcessId, }) {
@@ -188,6 +203,10 @@ export class ArNSMarketplaceRead {
         return { intents, orders, balances, antIds: antIdsArray };
     }
 }
+/**
+ * Write client for the ArNS marketplace
+ * @experimental
+ */
 export class ArNSMarketplaceWrite extends ArNSMarketplaceRead {
     process;
     signer;
@@ -224,6 +243,7 @@ export class ArNSMarketplaceWrite extends ArNSMarketplaceRead {
                 { name: 'Quantity', value: params.amount },
             ],
             signer: this.signer,
+            select: (message) => message.Tags.some((tag) => tag.name === 'Action' && tag.value === 'Withdraw-Ario-Notice'),
         });
     }
     async createIntent({ antId, orderType, quantity, price, expirationTime, minimumPrice, decreaseInterval, }) {
@@ -241,6 +261,7 @@ export class ArNSMarketplaceWrite extends ArNSMarketplaceRead {
         return this.process.send({
             tags: filteredTags,
             signer: this.signer,
+            select: (message) => message.Tags.some((tag) => tag.name === 'Action' && tag.value === 'Create-Intent-Notice'),
         });
     }
     async pushANTIntentResolution(intentId) {
@@ -250,6 +271,8 @@ export class ArNSMarketplaceWrite extends ArNSMarketplaceRead {
                 { name: 'X-Intent-Id', value: intentId },
             ],
             signer: this.signer,
+            select: (message) => message.Tags.some((tag) => tag.name === 'Action' &&
+                tag.value === 'Push-ANT-Intent-Resolution-Notice'),
         });
     }
     async settleAuction(params) {
@@ -263,6 +286,7 @@ export class ArNSMarketplaceWrite extends ArNSMarketplaceRead {
         return this.process.send({
             tags: filteredTags,
             signer: this.signer,
+            select: (message) => message.Tags.some((tag) => tag.name === 'Action' && tag.value === 'Settle-Auction-Notice'),
         });
     }
     async listNameForSale({ name, expirationTime, price, type, walletAddress, minimumPrice, decreaseInterval, onProgress = (event) => {
@@ -485,6 +509,7 @@ export class ArNSMarketplaceWrite extends ArNSMarketplaceRead {
         return this.process.send({
             tags,
             signer: this.signer,
+            select: (message) => message.Tags.some((tag) => tag.name === 'Action' && tag.value === 'Cancel-Order-Notice'),
         });
     }
     async createOrder({ swapToken, quantity, orderType, price, expirationTime, minimumPrice, decreaseInterval, transferDenomination, }) {
@@ -504,6 +529,7 @@ export class ArNSMarketplaceWrite extends ArNSMarketplaceRead {
         return this.process.send({
             tags: filteredTags,
             signer: this.signer,
+            select: (message) => message.Tags.some((tag) => tag.name === 'Action' && tag.value === 'Create-Order-Notice'),
         });
     }
     async buyFixedPriceANT(params) {
@@ -576,6 +602,8 @@ export class ArNSMarketplaceWrite extends ArNSMarketplaceRead {
                 { name: 'Bid-Amount', value: params.bidAmount },
             ],
             signer: this.signer,
+            select: (message) => message.Tags.some((tag) => tag.name === 'Action' &&
+                tag.value === 'Bid-On-English-Auction-Notice'),
         });
     }
     /**
@@ -607,6 +635,7 @@ export class ArNSMarketplaceWrite extends ArNSMarketplaceRead {
  * Calculates the listing fee for an order based on the end timestamp.
  * The fee is calculated by rounding up the hours until the end timestamp to the nearest hour.
  *
+ * @experimental
  * @param params - Parameters for calculating the listing fee
  * @param params.listingFeePerHour - The listing fee per hour in mARIO (as a string)
  * @param params.endTimestamp - Unix timestamp when the order expires
@@ -636,6 +665,7 @@ export function calculateListingFee({ listingFeePerHour, endTimestamp, }) {
 /**
  * Calculates the sale tax for an order based on the sale amount.
  *
+ * @experimental
  * @param params - Parameters for calculating the sale tax
  * @param params.saleAmount - The sale amount in mARIO (as a string or number)
  * @param params.saleTaxNumerator - The numerator for sale tax calculation

package/lib/esm/version.js

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

package/lib/types/common/contracts/ao-process.d.ts

@@ -10,15 +10,22 @@ export declare class AOProcess implements AOContract {
         logger?: ILogger;
     });
     private isMessageDataEmpty;
-    read<K>({ tags, retries, fromAddress, }: {
+    read<K>({ tags, retries, fromAddress, select, }: {
         tags?: Array<{
             name: string;
             value: string;
         }>;
         retries?: number;
         fromAddress?: string;
+        select?: (message: {
+            Data: string;
+            Tags: Array<{
+                name: string;
+                value: string;
+            }>;
+        }) => boolean;
     }): Promise<K>;
-    send<K>({ tags, data, signer, retries, }: {
+    send<K>({ tags, data, signer, retries, select, }: {
         tags: Array<{
             name: string;
             value: string;
@@ -26,6 +33,13 @@ export declare class AOProcess implements AOContract {
         data?: string | undefined;
         signer: AoSigner;
         retries?: number;
+        select?: (message: {
+            Data: string;
+            Tags: Array<{
+                name: string;
+                value: string;
+            }>;
+        }) => boolean;
     }): Promise<{
         id: string;
         result?: K;

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

@@ -19,6 +19,7 @@ import { AoARIOWrite, PaginationParams, PaginationResult } from '../types/io.js'
 /**
  * User-provided order parameters for intent-based order creation
  * These are the user-configurable fields when creating an order via the intent workflow
+ * @experimental
  */
 export interface MarketplaceOrderIntentParams {
     orderType?: 'fixed' | 'dutch' | 'english';
@@ -30,6 +31,7 @@ export interface MarketplaceOrderIntentParams {
 }
 /**
  * Intent structure - matches Lua Intent type
+ * @experimental
  */
 export interface MarketplaceIntent {
     intentId: string;
@@ -46,6 +48,7 @@ export interface MarketplaceIntent {
 }
 /**
  * Fee information structure for calculating order costs
+ * @experimental
  */
 export interface MarketplaceFeeInfo {
     listingFeePerHour: string;
@@ -54,6 +57,7 @@ export interface MarketplaceFeeInfo {
 }
 /**
  * Intent statistics structure
+ * @experimental
  */
 export interface MarketplaceIntentStats {
     total: number;
@@ -63,6 +67,7 @@ export interface MarketplaceIntentStats {
 }
 /**
  * Activity information structure
+ * @experimental
  */
 export interface MarketplaceActivityInfo {
     totalOrders: number;
@@ -74,7 +79,8 @@ export interface MarketplaceActivityInfo {
     listedOrders: number;
 }
 /**
- * marketplace information structure
+ * Marketplace information structure
+ * @experimental
  */
 export interface MarketplaceInfo {
     totalPairs: number;
@@ -83,6 +89,7 @@ export interface MarketplaceInfo {
 }
 /**
  * Info response structure from the marketplace
+ * @experimental
  */
 export interface InfoResponse {
     name: string;
@@ -95,6 +102,7 @@ export interface InfoResponse {
 }
 /**
  * Parameters for creating an intent (Create-Order action is assumed)
+ * @experimental
  */
 export interface CreateIntentParams {
     antId: string;
@@ -107,6 +115,7 @@ export interface CreateIntentParams {
 }
 /**
  * Parameters for paginated intent queries
+ * @experimental
  */
 export interface GetPaginatedIntentsParams {
     cursor?: string;
@@ -117,6 +126,7 @@ export interface GetPaginatedIntentsParams {
 }
 /**
  * Parameters for creating an order using internal ARIO balance
+ * @experimental
  */
 export interface CreateOrderParams {
     swapToken: string;
@@ -130,6 +140,7 @@ export interface CreateOrderParams {
 }
 /**
  * Parameters for getting orders with flexible selectors
+ * @experimental
  */
 export interface GetOrdersParams extends GetPaginatedIntentsParams {
     status?: 'all' | 'listed' | 'completed' | 'active' | 'ready-for-settlement' | 'executed' | 'cancelled' | 'expired';
@@ -139,6 +150,7 @@ export interface GetOrdersParams extends GetPaginatedIntentsParams {
 }
 /**
  * Individual order structure returned from Get-Orders and Get-Order handlers
+ * @experimental
  */
 export interface Order {
     id: string;
@@ -161,6 +173,10 @@ export interface Order {
     endedAt?: number;
     bids?: Record<string, boolean>;
 }
+/**
+ * Marketplace balance information for a wallet address
+ * @experimental
+ */
 export interface MarketplaceBalance {
     address: WalletAddress;
     balance: string;
@@ -168,6 +184,10 @@ export interface MarketplaceBalance {
     totalBalance: string;
     orders: Record<string, string>;
 }
+/**
+ * Read-only interface for the ArNS marketplace
+ * @experimental
+ */
 export interface AoArNSMarketplaceRead {
     getInfo(): Promise<InfoResponse>;
     getPaginatedIntents(params: GetPaginatedIntentsParams): Promise<PaginationResult<MarketplaceIntent>>;
@@ -197,6 +217,7 @@ export interface AoArNSMarketplaceRead {
 }
 /**
  * Common fields for create-intent progress events
+ * @experimental
  */
 export interface CreateIntentEventData {
     name: string;
@@ -207,12 +228,14 @@ export interface CreateIntentEventData {
 }
 /**
  * Progress event emitted while creating the marketplace intent
+ * @experimental
  */
 export interface CreatingIntentProgressEvent extends CreateIntentEventData {
     step: 'creating-intent';
 }
 /**
  * Progress event emitted after successfully creating the marketplace intent
+ * @experimental
  */
 export interface IntentCreatedProgressEvent extends CreateIntentEventData {
     step: 'intent-created';
@@ -220,6 +243,7 @@ export interface IntentCreatedProgressEvent extends CreateIntentEventData {
 }
 /**
  * Common fields for transfer-ant progress events
+ * @experimental
  */
 export interface TransferAntEventData {
     name: string;
@@ -229,12 +253,14 @@ export interface TransferAntEventData {
 }
 /**
  * Progress event emitted while transferring the ANT to the marketplace
+ * @experimental
  */
 export interface TransferringAntProgressEvent extends TransferAntEventData {
     step: 'transferring-ant';
 }
 /**
  * Progress event emitted after successfully transferring the ANT to the marketplace
+ * @experimental
  */
 export interface AntTransferredProgressEvent extends TransferAntEventData {
     step: 'ant-transferred';
@@ -242,6 +268,7 @@ export interface AntTransferredProgressEvent extends TransferAntEventData {
 }
 /**
  * Progress event emitted when an error occurs during the workflow
+ * @experimental
  */
 export interface ListNameForSaleErrorEvent {
     step: 'error';
@@ -259,6 +286,7 @@ export interface ListNameForSaleErrorEvent {
 }
 /**
  * Progress event emitted when the workflow completes successfully
+ * @experimental
  */
 export interface ListNameForSaleCompleteEvent {
     step: 'complete';
@@ -270,8 +298,13 @@ export interface ListNameForSaleCompleteEvent {
 }
 /**
  * Progress events emitted during listNameForSale workflow
+ * @experimental
  */
 export type ListNameForSaleProgressEvent = CreatingIntentProgressEvent | IntentCreatedProgressEvent | TransferringAntProgressEvent | AntTransferredProgressEvent | ListNameForSaleErrorEvent | ListNameForSaleCompleteEvent;
+/**
+ * Write interface for the ArNS marketplace
+ * @experimental
+ */
 export interface AoArNSMarketplaceWrite {
     createIntent(params: CreateIntentParams): Promise<AoMessageResult<MarketplaceIntent>>;
     cancelOrder(orderId: string): Promise<AoMessageResult>;
@@ -352,6 +385,10 @@ export interface AoArNSMarketplaceWrite {
         antId: string;
     }): Promise<AoMessageResult>;
 }
+/**
+ * Read-only client for the ArNS marketplace
+ * @experimental
+ */
 export declare class ArNSMarketplaceRead implements AoArNSMarketplaceRead {
     protected process: AOProcess;
     protected logger: Logger;
@@ -393,6 +430,10 @@ export declare class ArNSMarketplaceRead implements AoArNSMarketplaceRead {
         antIds: string[];
     }>;
 }
+/**
+ * Write client for the ArNS marketplace
+ * @experimental
+ */
 export declare class ArNSMarketplaceWrite extends ArNSMarketplaceRead implements AoArNSMarketplaceWrite {
     protected process: AOProcess;
     protected signer: AoSigner;
@@ -467,6 +508,7 @@ export declare class ArNSMarketplaceWrite extends ArNSMarketplaceRead implements
  * Calculates the listing fee for an order based on the end timestamp.
  * The fee is calculated by rounding up the hours until the end timestamp to the nearest hour.
  *
+ * @experimental
  * @param params - Parameters for calculating the listing fee
  * @param params.listingFeePerHour - The listing fee per hour in mARIO (as a string)
  * @param params.endTimestamp - Unix timestamp when the order expires
@@ -489,6 +531,7 @@ export declare function calculateListingFee({ listingFeePerHour, endTimestamp, }
 /**
  * Calculates the sale tax for an order based on the sale amount.
  *
+ * @experimental
  * @param params - Parameters for calculating the sale tax
  * @param params.saleAmount - The sale amount in mARIO (as a string or number)
  * @param params.saleTaxNumerator - The numerator for sale tax calculation

package/lib/types/version.d.ts

@@ -13,4 +13,4 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-export declare const version = "3.23.0-alpha.3";
+export declare const version = "3.23.0-alpha.5";

package/package.json

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