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

package/lib/cjs/common/marketplace.js

@@ -297,7 +297,9 @@ class ArNSMarketplaceWrite extends ArNSMarketplaceRead {
     }
     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)}`);
@@ -357,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,
@@ -369,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.
@@ -407,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',
@@ -441,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}`);

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.6';
+exports.version = '3.23.0-alpha.7';

package/lib/esm/common/marketplace.js

@@ -291,7 +291,9 @@ export class ArNSMarketplaceWrite extends ArNSMarketplaceRead {
     }
     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)}`);
@@ -351,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,
@@ -363,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.
@@ -401,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',
@@ -435,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}`);

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.6';
+export const version = '3.23.0-alpha.7';

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/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.5";
+export declare const version = "3.23.0-alpha.6";

package/package.json

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