@ar.io/sdk 3.10.0 → 3.11.0-alpha.2

package/lib/cjs/cli/options.js

@@ -52,6 +52,10 @@ exports.optionMap = {
         alias: '--cu-url <cuUrl>',
         description: 'The URL for a custom compute unit',
     },
+    paymentUrl: {
+        alias: '--payment-url <paymentUrl>',
+        description: 'The URL for a custom turbo payment service',
+    },
     processId: {
         alias: '--process-id <processId>',
         description: 'The process ID to interact with',
@@ -272,9 +276,15 @@ exports.optionMap = {
         alias: '--logo <logo>',
         description: 'The ANT logo',
     },
+    token: {
+        alias: '-t, --token <type>',
+        description: 'Crypto token type for wallet or action',
+        default: 'arweave',
+    },
 };
 exports.walletOptions = [
     exports.optionMap.walletFile,
+    exports.optionMap.token,
     // optionMap.mnemonic,
     exports.optionMap.privateKey,
 ];
@@ -292,6 +302,7 @@ exports.arnsPurchaseOptions = [
     ...exports.writeActionOptions,
     exports.optionMap.name,
     exports.optionMap.fundFrom,
+    exports.optionMap.paymentUrl,
 ];
 exports.epochOptions = [exports.optionMap.epochIndex, exports.optionMap.timestamp];
 exports.addressAndVaultIdOptions = [exports.optionMap.address, exports.optionMap.vaultId];
@@ -315,6 +326,7 @@ exports.tokenCostOptions = [
     exports.optionMap.quantity,
     exports.optionMap.address,
     exports.optionMap.fundFrom,
+    exports.optionMap.paymentUrl,
 ];
 exports.transferOptions = [
     ...exports.writeActionOptions,

package/lib/cjs/cli/utils.js

@@ -13,6 +13,7 @@ exports.requiredJwkFromOptions = requiredJwkFromOptions;
 exports.jwkToAddress = jwkToAddress;
 exports.getLoggerFromOptions = getLoggerFromOptions;
 exports.readARIOFromOptions = readARIOFromOptions;
+exports.contractSignerFromOptions = contractSignerFromOptions;
 exports.requiredContractSignerFromOptions = requiredContractSignerFromOptions;
 exports.requiredAoSignerFromOptions = requiredAoSignerFromOptions;
 exports.writeARIOFromOptions = writeARIOFromOptions;
@@ -60,6 +61,7 @@ exports.assertLockLengthInRange = assertLockLengthInRange;
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+const arbundles_1 = require("@dha-team/arbundles");
 const aoconnect_1 = require("@permaweb/aoconnect");
 const commander_1 = require("commander");
 const fs_1 = require("fs");
@@ -124,7 +126,7 @@ function arioProcessIdFromOptions({ arioProcessId, devnet, testnet, }) {
     }
     return index_js_1.ARIO_MAINNET_PROCESS_ID;
 }
-function jwkFromOptions({ privateKey, walletFile, }) {
+function walletFromOptions({ privateKey, walletFile, }) {
     if (privateKey !== undefined) {
         return JSON.parse(privateKey);
     }
@@ -134,7 +136,7 @@ function jwkFromOptions({ privateKey, walletFile, }) {
     return undefined;
 }
 function requiredJwkFromOptions(options) {
-    const jwk = jwkFromOptions(options);
+    const jwk = walletFromOptions(options);
     if (jwk === undefined) {
         throw new Error('No JWK provided for signing!\nPlease provide a stringified JWK with `--private-key` or the file path of a jwk.json file with `--wallet-file`');
     }
@@ -164,13 +166,30 @@ function readARIOFromOptions(options) {
     setLoggerIfDebug(options);
     return index_js_1.ARIO.init({
         process: aoProcessFromOptions(options),
+        paymentUrl: options.paymentUrl,
     });
 }
-function requiredContractSignerFromOptions(options) {
+function contractSignerFromOptions(options) {
+    const wallet = walletFromOptions(options);
+    if (wallet === undefined) {
+        return undefined;
+    }
+    const token = options.token ?? 'arweave';
+    if (token === 'ethereum') {
+        const signer = new arbundles_1.EthereumSigner(wallet);
+        // For EthereumSigner, we need to convert the JWK to a string
+        return { signer, signerAddress: signer.publicKey.toString('hex') };
+    }
     // TODO: Support other wallet types
-    const jwk = requiredJwkFromOptions(options);
-    const signer = new index_js_1.ArweaveSigner(jwk);
-    return { signer, signerAddress: jwkToAddress(jwk) };
+    const signer = new index_js_1.ArweaveSigner(wallet);
+    return { signer, signerAddress: jwkToAddress(wallet) };
+}
+function requiredContractSignerFromOptions(options) {
+    const contractSigner = contractSignerFromOptions(options);
+    if (contractSigner === undefined) {
+        throw new Error('No signer provided for signing!\nPlease provide a stringified JWK or Ethereum private key with `--private-key` or the file path of an arweave.jwk.json or eth.private.key.txt file with `--wallet-file`');
+    }
+    return contractSigner;
 }
 function requiredAoSignerFromOptions(options) {
     return (0, index_js_1.createAoSigner)(requiredContractSignerFromOptions(options).signer);
@@ -182,6 +201,7 @@ function writeARIOFromOptions(options) {
         ario: index_js_1.ARIO.init({
             process: aoProcessFromOptions(options),
             signer,
+            paymentUrl: options.paymentUrl,
         }),
         signerAddress,
     };
@@ -202,10 +222,9 @@ function addressFromOptions(options) {
     if (options.address !== undefined) {
         return options.address;
     }
-    // TODO: Support other wallet types
-    const jwk = jwkFromOptions(options);
-    if (jwk !== undefined) {
-        return jwkToAddress(jwk);
+    const signer = contractSignerFromOptions(options);
+    if (signer !== undefined) {
+        return signer.signerAddress;
     }
     return undefined;
 }
@@ -328,6 +347,9 @@ function requiredMARIOFromOptions(options, key) {
     return new index_js_1.ARIOToken(+options[key]).toMARIO();
 }
 async function assertEnoughBalanceForArNSPurchase({ ario, address, costDetailsParams, }) {
+    if (costDetailsParams.fundFrom === 'turbo') {
+        return;
+    }
     const costDetails = await ario.getCostDetails(costDetailsParams);
     if (costDetails.fundingPlan) {
         if (costDetails.fundingPlan.shortfall > 0) {

package/lib/cjs/cli/wayfinder.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Copyright (C) 2022-2024 Permanent Data Solutions, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+const commander_1 = require("commander");
+const version_js_1 = require("../version.js");
+const options_js_1 = require("./options.js");
+const utils_js_1 = require("./utils.js");
+(0, utils_js_1.applyOptions)(commander_1.program
+    .name('ar.io')
+    .version(version_js_1.version)
+    .description('AR.IO Network CLI')
+    .helpCommand(true), options_js_1.globalOptions);
+(0, utils_js_1.makeCommand)({
+    name: '',
+    description: 'Get network info',
+    action: () => {
+        console.log('wayfinder');
+        return Promise.resolve({});
+    },
+});

package/lib/cjs/common/ant-versions.js

@@ -75,14 +75,14 @@ class ANTVersionsWritable extends ANTVersionsReadable {
         super(config);
         this.signer = (0, ao_js_1.createAoSigner)(signer);
     }
-    async addVersion(params, { tags }) {
+    async addVersion({ version, moduleId, luaSourceId, notes, }, { tags }) {
         return this.process.send({
             tags: (0, arweave_js_1.pruneTags)([
                 { name: 'Action', value: 'Add-Version' },
-                { name: 'Version', value: params.version },
-                { name: 'Module-Id', value: params.moduleId },
-                { name: 'Lua-Source-Id', value: params.luaSourceId },
-                { name: 'Notes', value: params.notes },
+                { name: 'Version', value: version },
+                { name: 'Module-Id', value: moduleId },
+                { name: 'Lua-Source-Id', value: luaSourceId },
+                { name: 'Notes', value: notes },
                 ...(tags ?? []),
             ]),
             signer: this.signer,

package/lib/cjs/common/index.js

@@ -38,3 +38,5 @@ __exportStar(require("./faucet.js"), exports);
 // ao
 __exportStar(require("./io.js"), exports);
 __exportStar(require("./contracts/ao-process.js"), exports);
+// wayfinder
+__exportStar(require("./wayfinder/index.js"), exports);

package/lib/cjs/common/io.js

@@ -25,6 +25,7 @@ const arweave_js_2 = require("./arweave.js");
 const ao_process_js_1 = require("./contracts/ao-process.js");
 const error_js_1 = require("./error.js");
 const faucet_js_1 = require("./faucet.js");
+const turbo_js_1 = require("./turbo.js");
 class ARIO {
     // Implementation
     static init(config) {
@@ -89,6 +90,7 @@ class ARIOReadable {
     process;
     epochSettings;
     arweave;
+    paymentProvider; // TODO: this could be an array/map of payment providers
     constructor(config) {
         this.arweave = config?.arweave ?? arweave_js_2.defaultArweave;
         if (config === undefined || Object.keys(config).length === 0) {
@@ -107,6 +109,9 @@ class ARIOReadable {
         else {
             throw new error_js_1.InvalidContractConfigurationError();
         }
+        this.paymentProvider = turbo_js_1.TurboArNSPaymentFactory.init({
+            paymentUrl: config?.paymentUrl,
+        });
     }
     async getInfo() {
         return this.process.read({
@@ -438,6 +443,20 @@ class ARIOReadable {
     // TODO: Can overload this function to refine different types of cost details params
     async getCostDetails({ intent, type, years, name, quantity, fromAddress, fundFrom, }) {
         const replacedBuyRecordWithBuyName = intent === 'Buy-Record' ? 'Buy-Name' : intent;
+        if (fundFrom === 'turbo') {
+            const { mARIO, winc } = await this.paymentProvider.getArNSPriceDetails({
+                intent: replacedBuyRecordWithBuyName,
+                name,
+                quantity,
+                type,
+                years,
+            });
+            return {
+                tokenCost: +mARIO,
+                wincQty: winc,
+                discounts: [],
+            };
+        }
         const allTags = [
             { name: 'Action', value: 'Cost-Details' },
             {
@@ -605,7 +624,8 @@ class ARIOReadable {
 exports.ARIOReadable = ARIOReadable;
 class ARIOWriteable extends ARIOReadable {
     signer;
-    constructor({ signer, ...config }) {
+    paymentProvider;
+    constructor({ signer, paymentUrl, ...config }) {
         if (config === undefined) {
             super({
                 process: new ao_process_js_1.AOProcess({
@@ -617,6 +637,10 @@ class ARIOWriteable extends ARIOReadable {
             super(config);
         }
         this.signer = (0, ao_js_1.createAoSigner)(signer);
+        this.paymentProvider = turbo_js_1.TurboArNSPaymentFactory.init({
+            signer: (0, turbo_js_1.isTurboArNSSigner)(signer) ? signer : undefined,
+            paymentUrl,
+        });
     }
     async transfer({ target, qty, }, options) {
         const { tags = [] } = options || {};
@@ -891,6 +915,15 @@ class ARIOWriteable extends ARIOReadable {
         });
     }
     async buyRecord(params, options) {
+        if (params.fundFrom === 'turbo') {
+            if (!(this.paymentProvider instanceof turbo_js_1.TurboArNSPaymentProviderAuthenticated)) {
+                throw new Error('Turbo funding is not supported for this payment provider');
+            }
+            return this.paymentProvider.initiateArNSPurchase({
+                intent: 'Buy-Name',
+                ...params,
+            });
+        }
         const { tags = [] } = options || {};
         const allTags = [
             ...tags,
@@ -915,6 +948,15 @@ class ARIOWriteable extends ARIOReadable {
      * @returns {Promise<AoMessageResult>} The result of the upgrade
      */
     async upgradeRecord(params, options) {
+        if (params.fundFrom === 'turbo') {
+            if (!(this.paymentProvider instanceof turbo_js_1.TurboArNSPaymentProviderAuthenticated)) {
+                throw new Error('Turbo funding is not supported for this payment provider');
+            }
+            return this.paymentProvider.initiateArNSPurchase({
+                intent: 'Upgrade-Name',
+                name: params.name,
+            });
+        }
         const { tags = [] } = options || {};
         const allTags = [
             ...tags,
@@ -937,6 +979,15 @@ class ARIOWriteable extends ARIOReadable {
      * @returns {Promise<AoMessageResult>} The result of the extension
      */
     async extendLease(params, options) {
+        if (params.fundFrom === 'turbo') {
+            if (!(this.paymentProvider instanceof turbo_js_1.TurboArNSPaymentProviderAuthenticated)) {
+                throw new Error('Turbo funding is not supported for this payment provider');
+            }
+            return this.paymentProvider.initiateArNSPurchase({
+                intent: 'Extend-Lease',
+                ...params,
+            });
+        }
         const { tags = [] } = options || {};
         const allTags = [
             ...tags,
@@ -951,6 +1002,15 @@ class ARIOWriteable extends ARIOReadable {
         });
     }
     async increaseUndernameLimit(params, options) {
+        if (params.fundFrom === 'turbo') {
+            if (!(this.paymentProvider instanceof turbo_js_1.TurboArNSPaymentProviderAuthenticated)) {
+                throw new Error('Turbo funding is not supported for this payment provider');
+            }
+            return this.paymentProvider.initiateArNSPurchase({
+                intent: 'Increase-Undername-Limit',
+                ...params,
+            });
+        }
         const { tags = [] } = options || {};
         const allTags = [
             ...tags,
@@ -987,6 +1047,9 @@ class ARIOWriteable extends ARIOReadable {
         });
     }
     async requestPrimaryName(params, options) {
+        if (params.fundFrom === 'turbo') {
+            throw new Error('Turbo funding is not yet supported for primary name requests');
+        }
         const { tags = [] } = options || {};
         const allTags = [
             ...tags,

package/lib/cjs/common/turbo.js

@@ -0,0 +1,208 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TurboArNSPaymentProviderAuthenticated = exports.TurboArNSPaymentProviderUnauthenticated = exports.TurboArNSPaymentFactory = void 0;
+exports.signedRequestHeadersFromSigner = signedRequestHeadersFromSigner;
+exports.isTurboArNSSigner = isTurboArNSSigner;
+/**
+ * Copyright (C) 2022-2024 Permanent Data Solutions, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+const arbundles_1 = require("@dha-team/arbundles");
+const uuid_1 = require("uuid");
+const token_js_1 = require("../types/token.js");
+const base64_js_1 = require("../utils/base64.js");
+const http_client_js_1 = require("../utils/http-client.js");
+const url_js_1 = require("../utils/url.js");
+const logger_js_1 = require("./logger.js");
+async function signedRequestHeadersFromSigner({ signer, nonce = (0, uuid_1.v4)(), }) {
+    let signature = undefined;
+    let publicKey = undefined;
+    const signatureType = isWanderArweaveBrowserSigner(signer)
+        ? arbundles_1.SignatureConfig.ARWEAVE
+        : signer.signatureType;
+    // equivalent to window.arweaveWallet
+    if (isWanderArweaveBrowserSigner(signer)) {
+        signature = (0, base64_js_1.toB64Url)(Buffer.from(await signer.signMessage(Uint8Array.from(Buffer.from(nonce)))));
+    }
+    else if (signer instanceof arbundles_1.ArconnectSigner) {
+        signature = (0, base64_js_1.toB64Url)(Buffer.from(await signer['signer'].signMessage(Uint8Array.from(Buffer.from(nonce)))));
+    }
+    else if (signer instanceof arbundles_1.ArweaveSigner ||
+        signer instanceof arbundles_1.EthereumSigner ||
+        signer instanceof arbundles_1.InjectedEthereumSigner) {
+        if ('setPublicKey' in signer && signer['publicKey'] === undefined) {
+            await signer.setPublicKey();
+        }
+        signature = (0, base64_js_1.toB64Url)(Buffer.from(await signer.sign(Uint8Array.from(Buffer.from(nonce)))));
+    }
+    switch (signatureType) {
+        case arbundles_1.SignatureConfig.ARWEAVE:
+            if (isWanderArweaveBrowserSigner(signer)) {
+                publicKey = await signer.getActivePublicKey();
+            }
+            else if ('setPublicKey' in signer) {
+                await signer.setPublicKey();
+                publicKey = (0, base64_js_1.toB64Url)(signer.publicKey);
+            }
+            break;
+        case arbundles_1.SignatureConfig.ETHEREUM:
+            if ('publicKey' in signer) {
+                publicKey = '0x' + signer.publicKey.toString('hex');
+            }
+            else {
+                throw new Error('Public key not found');
+            }
+            break;
+        // TODO: solana sig support
+        // case SignatureConfig.SOLANA:
+        // case SignatureConfig.ED25519:
+        default:
+            throw new Error(`Unsupported signer type for signing requests: ${signatureType}`);
+    }
+    if (publicKey === undefined || signature === undefined) {
+        throw new Error('Public key or signature not found');
+    }
+    return {
+        'x-public-key': publicKey,
+        'x-nonce': nonce,
+        'x-signature': signature,
+        'x-signature-type': signatureType,
+    };
+}
+class TurboArNSPaymentFactory {
+    static init(config) {
+        const { signer, paymentUrl, axios, logger } = config ?? {};
+        if (signer !== undefined) {
+            return new TurboArNSPaymentProviderAuthenticated({
+                signer,
+                paymentUrl,
+                axios,
+                logger,
+            });
+        }
+        return new TurboArNSPaymentProviderUnauthenticated({
+            paymentUrl,
+            axios,
+            logger,
+        });
+    }
+}
+exports.TurboArNSPaymentFactory = TurboArNSPaymentFactory;
+// Base class for unauthenticated operations
+class TurboArNSPaymentProviderUnauthenticated {
+    paymentUrl;
+    axios;
+    logger;
+    constructor({ paymentUrl = 'https://payment.ardrive.io', axios = (0, http_client_js_1.createAxiosInstance)(), logger = logger_js_1.Logger.default, }) {
+        this.paymentUrl = paymentUrl;
+        this.axios = axios;
+        this.logger = logger;
+    }
+    async getArNSPriceDetails({ intent, name, quantity, type, years, }) {
+        const url = (0, url_js_1.urlWithSearchParams)({
+            baseUrl: `${this.paymentUrl}/v1/arns/price/${intent}/${name}`,
+            params: {
+                increaseQty: quantity,
+                type,
+                years,
+            },
+        });
+        const { data, status } = await this.axios.get(url);
+        this.logger.debug('getArNSPriceDetails', {
+            intent,
+            name,
+            quantity,
+            type,
+            years,
+            data,
+            status,
+        });
+        if (status !== 200) {
+            throw new Error('Failed to get ArNS purchase price ' + JSON.stringify(data));
+        }
+        if (!data.winc || !data.mARIO) {
+            throw new Error('Invalid response from Turbo ' + JSON.stringify(data));
+        }
+        return {
+            winc: data.winc,
+            mARIO: new token_js_1.mARIOToken(+data.mARIO),
+        };
+    }
+    async getPrice(params) {
+        const { winc } = await this.getArNSPriceDetails(params);
+        return +winc;
+    }
+}
+exports.TurboArNSPaymentProviderUnauthenticated = TurboArNSPaymentProviderUnauthenticated;
+// Class for authenticated operations, extending the base class
+class TurboArNSPaymentProviderAuthenticated extends TurboArNSPaymentProviderUnauthenticated {
+    signer;
+    constructor({ signer, ...restConfig }) {
+        super(restConfig); // Pass unauthenticated config to base class+
+        if (!isTurboArNSSigner(signer)) {
+            throw new Error('Signer must be a TurboArNSSigner');
+        }
+        this.signer = signer;
+    }
+    async initiateArNSPurchase({ intent, name, quantity, type, processId, years, }) {
+        // Signer check is implicitly handled by requiring it in the constructor
+        const url = (0, url_js_1.urlWithSearchParams)({
+            baseUrl: `${this.paymentUrl}/v1/arns/purchase/${intent}/${name}`,
+            params: {
+                increaseQty: quantity,
+                processId,
+                type,
+                years,
+            },
+        });
+        const headers = await signedRequestHeadersFromSigner({
+            signer: this.signer,
+        });
+        const { data, status } = await this.axios.post(url, null, {
+            headers,
+        });
+        this.logger.debug('Initiated ArNS purchase', {
+            intent,
+            name,
+            quantity,
+            processId,
+            type,
+            years,
+            data,
+            status,
+        });
+        if (status !== 200) {
+            throw new Error('Failed to initiate ArNS purchase ' + JSON.stringify(data));
+        }
+        return {
+            id: data.arioWriteResult.id,
+            result: data.purchaseReceipt,
+        };
+    }
+}
+exports.TurboArNSPaymentProviderAuthenticated = TurboArNSPaymentProviderAuthenticated;
+function isWanderArweaveBrowserSigner(signer) {
+    return (typeof signer === 'object' &&
+        signer !== null &&
+        'signMessage' in signer &&
+        'getActivePublicKey' in signer);
+}
+function isTurboArNSSigner(signer) {
+    const isWanderWallet = isWanderArweaveBrowserSigner(signer);
+    const isSigner = signer instanceof arbundles_1.EthereumSigner ||
+        signer instanceof arbundles_1.InjectedEthereumSigner ||
+        signer instanceof arbundles_1.ArweaveSigner ||
+        signer instanceof arbundles_1.ArconnectSigner;
+    return isWanderWallet || isSigner;
+}

package/lib/cjs/common/wayfinder/gateways.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SimpleCacheGatewaysProvider = exports.StaticGatewaysProvider = exports.ARIOGatewaysProvider = void 0;
+class ARIOGatewaysProvider {
+    ario;
+    constructor({ ario }) {
+        this.ario = ario;
+    }
+    async getGateways() {
+        let cursor;
+        let attempts = 0;
+        const gateways = [];
+        do {
+            try {
+                const { items: newGateways, nextCursor } = await this.ario.getGateways({
+                    limit: 1000,
+                    cursor,
+                });
+                gateways.push(...newGateways);
+                cursor = nextCursor;
+                attempts = 0; // reset attempts if we get a new cursor
+            }
+            catch (error) {
+                console.error('Error fetching gateways', {
+                    cursor,
+                    attempts,
+                    error,
+                });
+                attempts++;
+            }
+        } while (cursor !== undefined && attempts < 3);
+        // filter out any gateways that are not joined
+        return gateways.filter((g) => g.status === 'joined');
+    }
+}
+exports.ARIOGatewaysProvider = ARIOGatewaysProvider;
+class StaticGatewaysProvider {
+    gateways;
+    constructor({ gateways }) {
+        this.gateways = gateways;
+    }
+    async getGateways() {
+        return this.gateways;
+    }
+}
+exports.StaticGatewaysProvider = StaticGatewaysProvider;
+class SimpleCacheGatewaysProvider {
+    gatewaysProvider;
+    ttlSeconds;
+    lastUpdated;
+    gatewaysCache;
+    constructor({ gatewaysProvider, ttlSeconds = 5 * 60, // 5 minutes
+     }) {
+        this.gatewaysCache = [];
+        this.gatewaysProvider = gatewaysProvider;
+        this.ttlSeconds = ttlSeconds;
+    }
+    async getGateways() {
+        const now = Date.now();
+        if (this.gatewaysCache.length === 0 ||
+            now - this.lastUpdated > this.ttlSeconds * 1000) {
+            try {
+                // preserve the cache if the fetch fails
+                const allGateways = await this.gatewaysProvider.getGateways();
+                this.gatewaysCache = allGateways.filter((g) => g.status === 'joined');
+                this.lastUpdated = now;
+            }
+            catch (error) {
+                console.error('Error fetching gateways', error);
+            }
+        }
+        return this.gatewaysCache;
+    }
+}
+exports.SimpleCacheGatewaysProvider = SimpleCacheGatewaysProvider;

package/lib/cjs/common/wayfinder/index.js

@@ -0,0 +1,38 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Copyright (C) 2022-2024 Permanent Data Solutions, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+__exportStar(require("./wayfinder.js"), exports);
+// routers
+__exportStar(require("./routers/random.js"), exports);
+__exportStar(require("./routers/priority.js"), exports);
+__exportStar(require("./routers/fixed.js"), exports);
+// gateways providers
+__exportStar(require("./gateways.js"), exports);

package/lib/cjs/common/wayfinder/routers/fixed.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FixedGatewayRouter = void 0;
+class FixedGatewayRouter {
+    name = 'fixed';
+    gateway;
+    constructor({ gateway }) {
+        this.gateway = gateway;
+    }
+    async getTargetGateway() {
+        return this.gateway;
+    }
+}
+exports.FixedGatewayRouter = FixedGatewayRouter;