@ar.io/sdk 3.24.0 → 4.0.0-solana.10

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

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

package/lib/esm/common/io.js

@@ -15,6 +15,8 @@
  */
 import { connect } from '@permaweb/aoconnect';
 import { ANT_REGISTRY_ID, ARIO_MAINNET_PROCESS_ID, ARIO_TESTNET_PROCESS_ID, } from '../constants.js';
+import { SolanaARIOReadable } from '../solana/io-readable.js';
+import { SolanaARIOWriteable } from '../solana/io-writeable.js';
 import { isProcessConfiguration, isProcessIdConfiguration, } from '../types/index.js';
 import { createAoSigner } from '../utils/ao.js';
 import { getEpochDataFromGqlWithCUFallback, paginationParamsToTags, pruneTags, removeEligibleRewardsFromEpochData, sortAndPaginateEpochDataIntoEligibleDistributions, } from '../utils/arweave.js';
@@ -27,9 +29,39 @@ import { createFaucet } from './faucet.js';
 import { HB } from './hyperbeam/hb.js';
 import { Logger } from './logger.js';
 import { TurboArNSPaymentFactory, TurboArNSPaymentProviderAuthenticated, isTurboArNSSigner, } from './turbo.js';
+export const DEFAULT_SOLANA_RPC_URL = 'https://api.mainnet-beta.solana.com';
 export class ARIO {
     // Implementation
     static init(config) {
+        // Solana backend (explicit opt-in via `backend: 'solana'`)
+        if (config !== undefined &&
+            'backend' in config &&
+            config.backend === 'solana') {
+            if (config.signer) {
+                if (!config.rpcSubscriptions) {
+                    throw new Error('ARIO.init({ backend: "solana", signer }) requires rpcSubscriptions for transaction confirmation.');
+                }
+                return new SolanaARIOWriteable({
+                    rpc: config.rpc,
+                    rpcSubscriptions: config.rpcSubscriptions,
+                    commitment: config.commitment,
+                    signer: config.signer,
+                    coreProgramId: config.coreProgramId,
+                    garProgramId: config.garProgramId,
+                    arnsProgramId: config.arnsProgramId,
+                    antProgramId: config.antProgramId,
+                });
+            }
+            return new SolanaARIOReadable({
+                rpc: config.rpc,
+                commitment: config.commitment,
+                coreProgramId: config.coreProgramId,
+                garProgramId: config.garProgramId,
+                arnsProgramId: config.arnsProgramId,
+                antProgramId: config.antProgramId,
+            });
+        }
+        // AO backend (default — preserves legacy behavior).
         if (config !== undefined && 'signer' in config) {
             return new ARIOWriteable(config);
         }
@@ -1414,4 +1446,13 @@ export class ARIOWriteable extends ARIOReadable {
             tags: pruneTags(allTags),
         });
     }
+    /**
+     * AO backend stub — `syncAttributes` is a Solana-only on-chain reconciliation
+     * for the ANT NFT's Attributes plugin. AO ANTs have no NFT trait surface, so
+     * there is nothing to sync.
+     */
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    async syncAttributes(_params, _options) {
+        throw new Error('syncAttributes is only supported on the Solana backend (use ARIO.init({ backend: "solana", ... })).');
+    }
 }

package/lib/esm/common/marketplace.js

@@ -30,7 +30,6 @@ 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, } = {}) {
@@ -45,8 +44,6 @@ 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) {
@@ -55,7 +52,6 @@ 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) {
@@ -91,10 +87,7 @@ 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-Orders-Notice'),
-        });
+        return this.process.read({ tags: filteredTags });
     }
     /**
      * Get a single order by ID
@@ -107,7 +100,6 @@ 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) {
@@ -130,8 +122,6 @@ 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'),
         });
     }
     /**
@@ -143,7 +133,6 @@ 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, }) {
@@ -243,7 +232,6 @@ 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, }) {
@@ -261,7 +249,6 @@ 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) {
@@ -271,8 +258,6 @@ 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) {
@@ -286,14 +271,11 @@ 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)}`);
@@ -353,26 +335,10 @@ 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) {
-                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) {
+                intent = await this.getIntentByANTId(antId).catch((getIntentError) => {
+                    this.logger.error(`Failed to get intent: ${getIntentError.message}`);
                     const intentError = new Error('An intent already exists for this ANT ID but failed to get intent:\n\n' +
-                        (lastIntentError?.message ?? 'Unknown error'));
+                        getIntentError.message);
                     onProgress({
                         step: 'error',
                         name,
@@ -381,8 +347,7 @@ 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.
@@ -420,32 +385,12 @@ export class ArNSMarketplaceWrite extends ArNSMarketplaceRead {
                 step: 'transferring-ant',
                 ...transferAntEventData,
             });
-            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;
+            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 }],
+            });
             this.logger.info(`ANT transferred: ${JSON.stringify(antTransferResult)}`);
             onProgress({
                 step: 'ant-transferred',
@@ -474,20 +419,24 @@ 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;
-        for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        let tries = 0;
+        while (order === null && tries < 5) {
             try {
                 order = await this.getOrderByANTId(antId).catch((error) => {
-                    this.logger.warn(`Failed to get order: ${error.message}`);
+                    console.log(new Error('Failed to get order: ' + error.message));
                     return null;
                 });
-                if (order !== null) {
-                    break;
-                }
-                if (attempt < maxRetries) {
+                if (order === null) {
+                    await new Promise((resolve) => setTimeout(resolve, 1000));
                     this.logger.info(`Waiting for order to be created...`);
-                    const backoffMs = statusPollIntervalMs * Math.pow(2, attempt);
-                    await new Promise((resolve) => setTimeout(resolve, backoffMs));
+                    if (tries === 5) {
+                        this.logger.error(`Failed to get order after ${tries} attempts`);
+                        throw new Error(`Failed to get order after ${tries} attempts`);
+                    }
+                    tries++;
                 }
+                // if the order is found, break the loop
+                break;
             }
             catch (error) {
                 this.logger.error(`Failed to get order: ${error.message}`);
@@ -544,7 +493,6 @@ 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, }) {
@@ -564,7 +512,6 @@ 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) {
@@ -637,8 +584,6 @@ 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

@@ -14,6 +14,19 @@
  * limitations under the License.
  */
 export const ARWEAVE_TX_REGEX = new RegExp('^[a-zA-Z0-9_-]{43}$');
+/** ar:// protocol prefix for location-independent Arweave references */
+export const AR_IO_PROTOCOL = 'ar://';
+/** Default AR.IO logo Arweave TX ID (32x32 PNG) */
+export const ARIO_LOGO_TX_ID = 'WMLnh8pQL-UIXZMpdU2NUIriHfcFB5Bc49V8jTHjsZc';
+/**
+ * Construct an ar:// URI from an Arweave TX ID or ArNS name.
+ *
+ * - ar://{txId} — raw 43-char TX ID, resolved by wallets via arweave.net gateway
+ * - ar://{arnsName} — ArNS name, resolved by AR.IO gateways and Wayfinder SDK
+ */
+export function arweaveUri(txIdOrName) {
+    return `${AR_IO_PROTOCOL}${txIdOrName}`;
+}
 /** FQDN regex that matches the one used in the ArNS contract. */
 export const FQDN_REGEX = new RegExp('^(?:(?!-)[A-Za-z0-9-]{1,63}(?<!-)\\.)+[A-Za-z]{1,63}$');
 export const ARIO_DEVNET_PROCESS_ID = 'GaQrvEMKBpkjofgnBi_B3IgIDmY_XYelVLB6GcRGrHc';
@@ -35,4 +48,3 @@ 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';