@ar.io/sdk 3.23.1 → 3.24.0-solana.1

package/lib/cjs/cli/cli.js

@@ -813,8 +813,10 @@ const utils_js_1 = require("./utils.js");
         });
     },
 });
-if (process.argv[1].includes('bin/ar.io') || // Running from global .bin
-    process.argv[1].includes('cli/cli') // Running from source
+// Normalize separators so includes() works on Windows (argv uses backslashes).
+const argvScript = process.argv[1].replace(/\\/g, '/');
+if (argvScript.includes('bin/ar.io') || // Running from global .bin
+    argvScript.includes('cli/cli') // Running from source
 ) {
     commander_1.program.parse(process.argv);
 }

package/lib/cjs/cli/utils.js

@@ -198,8 +198,7 @@ function readARIOFromOptions(options) {
     return index_js_1.ARIO.init({
         hyperbeamUrl: options.hyperbeamUrl,
         process: aoProcessFromOptions({
-            cuUrl: 'http://localhost:6363', // default to ardrive cu for ARIO process
-            //cuUrl: 'https://cu.ardrive.io', // default to ardrive cu for ARIO process
+            cuUrl: index_js_1.DEFAULT_CU_URL,
             ...options,
         }),
         paymentUrl: options.paymentUrl,

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

@@ -35,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, } = {}) {
@@ -49,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) {
@@ -57,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) {
@@ -92,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
@@ -105,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) {
@@ -127,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'),
         });
     }
     /**
@@ -138,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, }) {
@@ -238,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, }) {
@@ -255,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) {
@@ -264,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) {
@@ -277,11 +292,14 @@ 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) => {
         this.logger.info(`List name for sale progress: ${event.step}`);
-    }, }) {
+    }, }, timeoutOptions) {
+        const maxRetries = timeoutOptions?.maxRetries ?? 15;
+        const statusPollIntervalMs = timeoutOptions?.statusPollIntervalMs ?? 3000;
         // Get arns record for the current ant id associated with it
         const record = await this.ario.getArNSRecord({ name: name });
         this.logger.info(`Record ${name} found: ${JSON.stringify(record)}`);
@@ -341,10 +359,26 @@ class ArNSMarketplaceWrite extends ArNSMarketplaceRead {
             // check error for existing intent. Will be a contract error message.
             const isExistingIntentError = error.message.includes('An intent already exists for this ANT ID');
             if (isExistingIntentError) {
-                intent = await this.getIntentByANTId(antId).catch((getIntentError) => {
-                    this.logger.error(`Failed to get intent: ${getIntentError.message}`);
+                let fetchedIntent;
+                let lastIntentError = null;
+                for (let attempt = 0; attempt <= maxRetries; attempt++) {
+                    try {
+                        fetchedIntent = await this.getIntentByANTId(antId);
+                        lastIntentError = null;
+                        break;
+                    }
+                    catch (getIntentError) {
+                        lastIntentError = getIntentError;
+                        this.logger.error(`Failed to get intent (attempt ${attempt + 1}/${maxRetries + 1}): ${getIntentError.message}`);
+                        if (attempt < maxRetries) {
+                            const backoffMs = statusPollIntervalMs * Math.pow(2, attempt);
+                            await new Promise((resolve) => setTimeout(resolve, backoffMs));
+                        }
+                    }
+                }
+                if (lastIntentError !== null || fetchedIntent === undefined) {
                     const intentError = new Error('An intent already exists for this ANT ID but failed to get intent:\n\n' +
-                        getIntentError.message);
+                        (lastIntentError?.message ?? 'Unknown error'));
                     onProgress({
                         step: 'error',
                         name,
@@ -353,7 +387,8 @@ class ArNSMarketplaceWrite extends ArNSMarketplaceRead {
                         failedStep: 'creating-intent',
                     });
                     throw intentError;
-                });
+                }
+                intent = fetchedIntent;
             }
             else {
                 // Possible to get other errors, eg insufficient deposited ario balance. Rethrow them here.
@@ -391,12 +426,32 @@ class ArNSMarketplaceWrite extends ArNSMarketplaceRead {
                 step: 'transferring-ant',
                 ...transferAntEventData,
             });
-            antTransferResult = await ant.transfer({
-                target: this.process.processId,
-                removeControllers: false, // important: do not remove the controllers of the ANT to prevent loss of control
-            }, {
-                tags: [{ name: 'X-Intent-Id', value: intent.intentId }],
-            });
+            let transferResult;
+            let lastTransferError = null;
+            for (let attempt = 0; attempt <= maxRetries; attempt++) {
+                try {
+                    transferResult = await ant.transfer({
+                        target: this.process.processId,
+                        removeControllers: false, // important: do not remove the controllers of the ANT to prevent loss of control
+                    }, {
+                        tags: [{ name: 'X-Intent-Id', value: intent.intentId }],
+                    });
+                    lastTransferError = null;
+                    break;
+                }
+                catch (error) {
+                    lastTransferError = error;
+                    this.logger.error(`Failed to transfer ANT (attempt ${attempt + 1}/${maxRetries + 1}): ${error.message}`);
+                    if (attempt < maxRetries) {
+                        const backoffMs = statusPollIntervalMs * Math.pow(2, attempt);
+                        await new Promise((resolve) => setTimeout(resolve, backoffMs));
+                    }
+                }
+            }
+            if (lastTransferError !== null || transferResult === undefined) {
+                throw lastTransferError ?? new Error('Failed to transfer ANT');
+            }
+            antTransferResult = transferResult;
             this.logger.info(`ANT transferred: ${JSON.stringify(antTransferResult)}`);
             onProgress({
                 step: 'ant-transferred',
@@ -425,24 +480,20 @@ class ArNSMarketplaceWrite extends ArNSMarketplaceRead {
         // This is to ensure the order is created before returning the result for ux purposes.
         // This may still fail, in which case we return the intent and ant transfer result and handle the error in the client.
         let order = null;
-        let tries = 0;
-        while (order === null && tries < 5) {
+        for (let attempt = 0; attempt <= maxRetries; attempt++) {
             try {
                 order = await this.getOrderByANTId(antId).catch((error) => {
-                    console.log(new Error('Failed to get order: ' + error.message));
+                    this.logger.warn(`Failed to get order: ${error.message}`);
                     return null;
                 });
-                if (order === null) {
-                    await new Promise((resolve) => setTimeout(resolve, 1000));
+                if (order !== null) {
+                    break;
+                }
+                if (attempt < maxRetries) {
                     this.logger.info(`Waiting for order to be created...`);
-                    if (tries === 5) {
-                        this.logger.error(`Failed to get order after ${tries} attempts`);
-                        throw new Error(`Failed to get order after ${tries} attempts`);
-                    }
-                    tries++;
+                    const backoffMs = statusPollIntervalMs * Math.pow(2, attempt);
+                    await new Promise((resolve) => setTimeout(resolve, backoffMs));
                 }
-                // if the order is found, break the loop
-                break;
             }
             catch (error) {
                 this.logger.error(`Failed to get order: ${error.message}`);
@@ -499,6 +550,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, }) {
@@ -518,6 +570,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) {
@@ -590,6 +643,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'),
         });
     }
     /**

package/lib/cjs/constants.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_SCHEDULER_ID = exports.AO_AUTHORITY = exports.ANT_LUA_ID = exports.AOS_MODULE_ID = exports.MARIO_PER_ARIO = exports.MARKETPLACE_CONTRACT_ID = exports.ANT_REGISTRY_ID = exports.ANT_REGISTRY_TESTNET_ID = exports.ARIO_MAINNET_PROCESS_ID = exports.ARIO_TESTNET_PROCESS_ID = exports.arioDevnetProcessId = exports.ARIO_DEVNET_PROCESS_ID = exports.FQDN_REGEX = exports.ARWEAVE_TX_REGEX = void 0;
+exports.DEFAULT_CU_URL = exports.DEFAULT_SCHEDULER_ID = exports.AO_AUTHORITY = exports.ANT_LUA_ID = exports.AOS_MODULE_ID = exports.MARIO_PER_ARIO = exports.MARKETPLACE_CONTRACT_ID = exports.ANT_REGISTRY_ID = exports.ANT_REGISTRY_TESTNET_ID = exports.ARIO_MAINNET_PROCESS_ID = exports.ARIO_TESTNET_PROCESS_ID = exports.arioDevnetProcessId = exports.ARIO_DEVNET_PROCESS_ID = exports.FQDN_REGEX = exports.ARWEAVE_TX_REGEX = void 0;
 /**
  * Copyright (C) 2022-2024 Permanent Data Solutions, Inc.
  *
@@ -38,3 +38,4 @@ exports.AOS_MODULE_ID = 'nEjlSFA_8narJlVHApbczDPkMc9znSqYtqtf1iOdoxM';
 exports.ANT_LUA_ID = 'sOW9Sdm1yoPRrzerC5iu1nsupp4e6I-HnJyYVHzvzQo';
 exports.AO_AUTHORITY = 'fcoN_xJeisVsPXA-trzVAuIiqO3ydLQxM-L4XbrQKzY';
 exports.DEFAULT_SCHEDULER_ID = '_GQ33BkPtZrqxA84vM8Zk-N2aO0toNNu_C-l-rawrBA';
+exports.DEFAULT_CU_URL = 'https://cu.ardrive.io';

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.1';
+exports.version = '3.24.0-solana.1';

package/lib/esm/cli/cli.js

@@ -811,8 +811,10 @@ makeCommand({
         });
     },
 });
-if (process.argv[1].includes('bin/ar.io') || // Running from global .bin
-    process.argv[1].includes('cli/cli') // Running from source
+// Normalize separators so includes() works on Windows (argv uses backslashes).
+const argvScript = process.argv[1].replace(/\\/g, '/');
+if (argvScript.includes('bin/ar.io') || // Running from global .bin
+    argvScript.includes('cli/cli') // Running from source
 ) {
     program.parse(process.argv);
 }

package/lib/esm/cli/utils.js

@@ -33,7 +33,7 @@ import { EthereumSigner } from '@dha-team/arbundles';
 import { connect } from '@permaweb/aoconnect';
 import { program } from 'commander';
 import prompts from 'prompts';
-import { ANT, ANTRegistry, ANT_REGISTRY_ID, ANT_REGISTRY_TESTNET_ID, AOProcess, ARIO, ARIOToken, ARIO_DEVNET_PROCESS_ID, ARIO_MAINNET_PROCESS_ID, ARIO_TESTNET_PROCESS_ID, ArweaveSigner, Logger, createAoSigner, fromB64Url, fundFromOptions, initANTStateForAddress, isValidFundFrom, isValidIntent, mARIOToken, sha256B64Url, validIntents, } from '../node/index.js';
+import { ANT, ANTRegistry, ANT_REGISTRY_ID, ANT_REGISTRY_TESTNET_ID, AOProcess, ARIO, ARIOToken, ARIO_DEVNET_PROCESS_ID, ARIO_MAINNET_PROCESS_ID, ARIO_TESTNET_PROCESS_ID, ArweaveSigner, DEFAULT_CU_URL, Logger, createAoSigner, fromB64Url, fundFromOptions, initANTStateForAddress, isValidFundFrom, isValidIntent, mARIOToken, sha256B64Url, validIntents, } from '../node/index.js';
 import { globalOptions } from './options.js';
 export const defaultTtlSecondsCLI = 3600;
 export function stringifyJsonForCLIDisplay(json) {
@@ -144,8 +144,7 @@ export function readARIOFromOptions(options) {
     return ARIO.init({
         hyperbeamUrl: options.hyperbeamUrl,
         process: aoProcessFromOptions({
-            cuUrl: 'http://localhost:6363', // default to ardrive cu for ARIO process
-            //cuUrl: 'https://cu.ardrive.io', // default to ardrive cu for ARIO process
+            cuUrl: DEFAULT_CU_URL,
             ...options,
         }),
         paymentUrl: options.paymentUrl,

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

@@ -30,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, } = {}) {
@@ -44,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) {
@@ -52,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) {
@@ -87,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
@@ -100,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) {
@@ -122,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'),
         });
     }
     /**
@@ -133,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, }) {
@@ -232,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, }) {
@@ -249,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) {
@@ -258,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) {
@@ -271,11 +286,14 @@ 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) => {
         this.logger.info(`List name for sale progress: ${event.step}`);
-    }, }) {
+    }, }, timeoutOptions) {
+        const maxRetries = timeoutOptions?.maxRetries ?? 15;
+        const statusPollIntervalMs = timeoutOptions?.statusPollIntervalMs ?? 3000;
         // Get arns record for the current ant id associated with it
         const record = await this.ario.getArNSRecord({ name: name });
         this.logger.info(`Record ${name} found: ${JSON.stringify(record)}`);
@@ -335,10 +353,26 @@ export class ArNSMarketplaceWrite extends ArNSMarketplaceRead {
             // check error for existing intent. Will be a contract error message.
             const isExistingIntentError = error.message.includes('An intent already exists for this ANT ID');
             if (isExistingIntentError) {
-                intent = await this.getIntentByANTId(antId).catch((getIntentError) => {
-                    this.logger.error(`Failed to get intent: ${getIntentError.message}`);
+                let fetchedIntent;
+                let lastIntentError = null;
+                for (let attempt = 0; attempt <= maxRetries; attempt++) {
+                    try {
+                        fetchedIntent = await this.getIntentByANTId(antId);
+                        lastIntentError = null;
+                        break;
+                    }
+                    catch (getIntentError) {
+                        lastIntentError = getIntentError;
+                        this.logger.error(`Failed to get intent (attempt ${attempt + 1}/${maxRetries + 1}): ${getIntentError.message}`);
+                        if (attempt < maxRetries) {
+                            const backoffMs = statusPollIntervalMs * Math.pow(2, attempt);
+                            await new Promise((resolve) => setTimeout(resolve, backoffMs));
+                        }
+                    }
+                }
+                if (lastIntentError !== null || fetchedIntent === undefined) {
                     const intentError = new Error('An intent already exists for this ANT ID but failed to get intent:\n\n' +
-                        getIntentError.message);
+                        (lastIntentError?.message ?? 'Unknown error'));
                     onProgress({
                         step: 'error',
                         name,
@@ -347,7 +381,8 @@ export class ArNSMarketplaceWrite extends ArNSMarketplaceRead {
                         failedStep: 'creating-intent',
                     });
                     throw intentError;
-                });
+                }
+                intent = fetchedIntent;
             }
             else {
                 // Possible to get other errors, eg insufficient deposited ario balance. Rethrow them here.
@@ -385,12 +420,32 @@ export class ArNSMarketplaceWrite extends ArNSMarketplaceRead {
                 step: 'transferring-ant',
                 ...transferAntEventData,
             });
-            antTransferResult = await ant.transfer({
-                target: this.process.processId,
-                removeControllers: false, // important: do not remove the controllers of the ANT to prevent loss of control
-            }, {
-                tags: [{ name: 'X-Intent-Id', value: intent.intentId }],
-            });
+            let transferResult;
+            let lastTransferError = null;
+            for (let attempt = 0; attempt <= maxRetries; attempt++) {
+                try {
+                    transferResult = await ant.transfer({
+                        target: this.process.processId,
+                        removeControllers: false, // important: do not remove the controllers of the ANT to prevent loss of control
+                    }, {
+                        tags: [{ name: 'X-Intent-Id', value: intent.intentId }],
+                    });
+                    lastTransferError = null;
+                    break;
+                }
+                catch (error) {
+                    lastTransferError = error;
+                    this.logger.error(`Failed to transfer ANT (attempt ${attempt + 1}/${maxRetries + 1}): ${error.message}`);
+                    if (attempt < maxRetries) {
+                        const backoffMs = statusPollIntervalMs * Math.pow(2, attempt);
+                        await new Promise((resolve) => setTimeout(resolve, backoffMs));
+                    }
+                }
+            }
+            if (lastTransferError !== null || transferResult === undefined) {
+                throw lastTransferError ?? new Error('Failed to transfer ANT');
+            }
+            antTransferResult = transferResult;
             this.logger.info(`ANT transferred: ${JSON.stringify(antTransferResult)}`);
             onProgress({
                 step: 'ant-transferred',
@@ -419,24 +474,20 @@ export class ArNSMarketplaceWrite extends ArNSMarketplaceRead {
         // This is to ensure the order is created before returning the result for ux purposes.
         // This may still fail, in which case we return the intent and ant transfer result and handle the error in the client.
         let order = null;
-        let tries = 0;
-        while (order === null && tries < 5) {
+        for (let attempt = 0; attempt <= maxRetries; attempt++) {
             try {
                 order = await this.getOrderByANTId(antId).catch((error) => {
-                    console.log(new Error('Failed to get order: ' + error.message));
+                    this.logger.warn(`Failed to get order: ${error.message}`);
                     return null;
                 });
-                if (order === null) {
-                    await new Promise((resolve) => setTimeout(resolve, 1000));
+                if (order !== null) {
+                    break;
+                }
+                if (attempt < maxRetries) {
                     this.logger.info(`Waiting for order to be created...`);
-                    if (tries === 5) {
-                        this.logger.error(`Failed to get order after ${tries} attempts`);
-                        throw new Error(`Failed to get order after ${tries} attempts`);
-                    }
-                    tries++;
+                    const backoffMs = statusPollIntervalMs * Math.pow(2, attempt);
+                    await new Promise((resolve) => setTimeout(resolve, backoffMs));
                 }
-                // if the order is found, break the loop
-                break;
             }
             catch (error) {
                 this.logger.error(`Failed to get order: ${error.message}`);
@@ -493,6 +544,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, }) {
@@ -512,6 +564,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) {
@@ -584,6 +637,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'),
         });
     }
     /**

package/lib/esm/constants.js

@@ -35,3 +35,4 @@ export const AOS_MODULE_ID = 'nEjlSFA_8narJlVHApbczDPkMc9znSqYtqtf1iOdoxM';
 export const ANT_LUA_ID = 'sOW9Sdm1yoPRrzerC5iu1nsupp4e6I-HnJyYVHzvzQo';
 export const AO_AUTHORITY = 'fcoN_xJeisVsPXA-trzVAuIiqO3ydLQxM-L4XbrQKzY';
 export const DEFAULT_SCHEDULER_ID = '_GQ33BkPtZrqxA84vM8Zk-N2aO0toNNu_C-l-rawrBA';
+export const DEFAULT_CU_URL = 'https://cu.ardrive.io';

package/lib/esm/version.js

@@ -14,4 +14,4 @@
  * limitations under the License.
  */
 // AUTOMATICALLY GENERATED FILE - DO NOT TOUCH
-export const version = '3.23.1';
+export const version = '3.24.0-solana.1';

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

@@ -301,6 +301,17 @@ export interface ListNameForSaleCompleteEvent {
  * @experimental
  */
 export type ListNameForSaleProgressEvent = CreatingIntentProgressEvent | IntentCreatedProgressEvent | TransferringAntProgressEvent | AntTransferredProgressEvent | ListNameForSaleErrorEvent | ListNameForSaleCompleteEvent;
+/**
+ * Timeout and retry options for listNameForSale status checks and polling.
+ * Used when checking for intent (e.g. getIntentByANTId), transfer confirmation, and order listing.
+ * @experimental
+ */
+export interface ListNameForSaleTimeoutOptions {
+    /** Max retries when polling for intent, transfer confirmation, or order listing. Default 5. */
+    maxRetries?: number;
+    /** Base interval in ms for exponential backoff between status polls / retries. Wait time is base * 2^attempt. Default 1000. */
+    statusPollIntervalMs?: number;
+}
 /**
  * Write interface for the ArNS marketplace
  * @experimental
@@ -328,6 +339,7 @@ export interface AoArNSMarketplaceWrite {
     /**
      * List a name for sale on the marketplace
      * @param params - Parameters including name, expiration time, price, type, wallet address, and optional auction parameters
+     * @param timeoutOptions - Optional retries and wait times for intent, transfer, and order listing status polling
      * @returns Result containing intent, order, ANT transfer result, and any error
      */
     listNameForSale({ name, expirationTime, price, type, walletAddress, minimumPrice, decreaseInterval, onProgress, }: {
@@ -339,7 +351,7 @@ export interface AoArNSMarketplaceWrite {
         minimumPrice?: string;
         decreaseInterval?: string;
         onProgress?: (event: ListNameForSaleProgressEvent) => void;
-    }): Promise<{
+    }, timeoutOptions?: ListNameForSaleTimeoutOptions): Promise<{
         intent: MarketplaceIntent;
         order: Order | null;
         antTransferResult: AoMessageResult<Record<string, string | number | boolean | null>> | null;
@@ -473,7 +485,7 @@ export declare class ArNSMarketplaceWrite extends ArNSMarketplaceRead implements
         minimumPrice?: string;
         decreaseInterval?: string;
         onProgress?: (event: ListNameForSaleProgressEvent) => void;
-    }): Promise<{
+    }, timeoutOptions?: ListNameForSaleTimeoutOptions): Promise<{
         intent: MarketplaceIntent;
         order: Order | null;
         antTransferResult: AoMessageResult<Record<string, string | number | boolean | null>> | null;

package/lib/types/constants.d.ts

@@ -34,3 +34,4 @@ export declare const AOS_MODULE_ID = "nEjlSFA_8narJlVHApbczDPkMc9znSqYtqtf1iOdox
 export declare const ANT_LUA_ID = "sOW9Sdm1yoPRrzerC5iu1nsupp4e6I-HnJyYVHzvzQo";
 export declare const AO_AUTHORITY = "fcoN_xJeisVsPXA-trzVAuIiqO3ydLQxM-L4XbrQKzY";
 export declare const DEFAULT_SCHEDULER_ID = "_GQ33BkPtZrqxA84vM8Zk-N2aO0toNNu_C-l-rawrBA";
+export declare const DEFAULT_CU_URL = "https://cu.ardrive.io";

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";
+export declare const version = "4.0.0-solana.0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ar.io/sdk",
-  "version": "3.23.1",
+  "version": "3.24.0-solana.1",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/ar-io/ar-io-sdk.git"