@ar.io/sdk 3.21.0 → 3.22.0-alpha.1

package/lib/cjs/cli/options.js

@@ -140,6 +140,10 @@ exports.optionMap = {
         description: 'The allowed delegates for the gateway. By default this is empty, meaning all are allowed delegate stake unless delegating is explicitly disallowed by the gateway',
         type: 'array',
     },
+    services: {
+        alias: '--services <services>',
+        description: 'JSON string of gateway services configuration (e.g., \'{"bundlers":[{"fqdn":"bundler.example.com","port":443,"protocol":"https","path":"/bundler"}]}\')',
+    },
     skipConfirmation: {
         alias: '--skip-confirmation',
         description: 'Skip confirmation prompts',
@@ -406,6 +410,7 @@ exports.updateGatewaySettingsOptions = [
     exports.optionMap.fqdn,
     exports.optionMap.port,
     exports.optionMap.protocol,
+    exports.optionMap.services,
 ];
 exports.joinNetworkOptions = [
     ...exports.updateGatewaySettingsOptions,

package/lib/cjs/cli/utils.js

@@ -27,6 +27,7 @@ exports.paginationParamsFromOptions = paginationParamsFromOptions;
 exports.epochInputFromOptions = epochInputFromOptions;
 exports.requiredInitiatorFromOptions = requiredInitiatorFromOptions;
 exports.customTagsFromOptions = customTagsFromOptions;
+exports.servicesFromOptions = servicesFromOptions;
 exports.gatewaySettingsFromOptions = gatewaySettingsFromOptions;
 exports.requiredTargetAndQuantityFromOptions = requiredTargetAndQuantityFromOptions;
 exports.redelegateParamsFromOptions = redelegateParamsFromOptions;
@@ -333,7 +334,44 @@ function customTagsFromOptions(options) {
         tags,
     };
 }
-function gatewaySettingsFromOptions({ allowDelegatedStaking, autoStake, delegateRewardShareRatio, fqdn, label, minDelegatedStake, note, observerAddress, port, properties, allowedDelegates, }) {
+function servicesFromOptions(services) {
+    if (services === undefined || services === null || services === '') {
+        return undefined;
+    }
+    try {
+        const parsed = JSON.parse(services);
+        // Validate structure
+        if (!parsed.bundlers || !Array.isArray(parsed.bundlers)) {
+            throw new Error('Services must have a "bundlers" array');
+        }
+        if (parsed.bundlers.length > 20) {
+            throw new Error('Maximum 20 bundlers allowed');
+        }
+        // Validate each bundler
+        for (const bundler of parsed.bundlers) {
+            if (!bundler.fqdn || typeof bundler.fqdn !== 'string') {
+                throw new Error('Each bundler must have a valid "fqdn" string');
+            }
+            if (typeof bundler.port !== 'number' ||
+                bundler.port < 0 ||
+                bundler.port > 65535) {
+                throw new Error('Each bundler must have a valid "port" (0-65535)');
+            }
+            if (bundler.protocol !== 'https') {
+                throw new Error('Each bundler protocol must be "https"');
+            }
+            if (!bundler.path || typeof bundler.path !== 'string') {
+                throw new Error('Each bundler must have a valid "path" string');
+            }
+        }
+        return parsed;
+    }
+    catch (error) {
+        throw new Error(`Invalid services JSON: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+function gatewaySettingsFromOptions(options) {
+    const { allowDelegatedStaking, autoStake, delegateRewardShareRatio, fqdn, label, minDelegatedStake, note, observerAddress, port, properties, allowedDelegates, services, } = options;
     return {
         observerAddress,
         allowDelegatedStaking,
@@ -348,6 +386,7 @@ function gatewaySettingsFromOptions({ allowDelegatedStaking, autoStake, delegate
         note,
         port: port !== undefined ? +port : undefined,
         properties,
+        services: servicesFromOptions(services),
     };
 }
 function requiredTargetAndQuantityFromOptions(options) {

package/lib/cjs/common/io.js

@@ -821,7 +821,7 @@ class ARIOWriteable extends ARIOReadable {
             signer: this.signer,
         });
     }
-    async joinNetwork({ operatorStake, allowDelegatedStaking, allowedDelegates, delegateRewardShareRatio, fqdn, label, minDelegatedStake, note, port, properties, protocol, autoStake, observerAddress, }, options) {
+    async joinNetwork({ operatorStake, allowDelegatedStaking, allowedDelegates, delegateRewardShareRatio, fqdn, label, minDelegatedStake, note, port, properties, protocol, autoStake, observerAddress, services, }, options) {
         const { tags = [] } = options || {};
         const allTags = [
             ...tags,
@@ -878,6 +878,10 @@ class ARIOWriteable extends ARIOReadable {
                 name: 'Observer-Address',
                 value: observerAddress,
             },
+            {
+                name: 'Services',
+                value: services ? JSON.stringify(services) : undefined,
+            },
         ];
         return this.process.send({
             signer: this.signer,
@@ -891,7 +895,7 @@ class ARIOWriteable extends ARIOReadable {
             tags: [...tags, { name: 'Action', value: 'Leave-Network' }],
         });
     }
-    async updateGatewaySettings({ allowDelegatedStaking, allowedDelegates, delegateRewardShareRatio, fqdn, label, minDelegatedStake, note, port, properties, protocol, autoStake, observerAddress, }, options) {
+    async updateGatewaySettings({ allowDelegatedStaking, allowedDelegates, delegateRewardShareRatio, fqdn, label, minDelegatedStake, note, port, properties, protocol, autoStake, observerAddress, services, }, options) {
         const { tags = [] } = options || {};
         const allTags = [
             ...tags,
@@ -920,6 +924,10 @@ class ARIOWriteable extends ARIOReadable {
                 value: minDelegatedStake?.valueOf().toString(),
             },
             { name: 'Auto-Stake', value: autoStake?.toString() },
+            {
+                name: 'Services',
+                value: services ? JSON.stringify(services) : undefined,
+            },
         ];
         return this.process.send({
             signer: this.signer,

package/lib/cjs/utils/arweave.js

@@ -4,6 +4,7 @@ exports.epochDistributionNoticeGqlQueryFallback = exports.epochDistributionNotic
 exports.isBlockHeight = isBlockHeight;
 exports.sortAndPaginateEpochDataIntoEligibleDistributions = sortAndPaginateEpochDataIntoEligibleDistributions;
 exports.removeEligibleRewardsFromEpochData = removeEligibleRewardsFromEpochData;
+const logger_js_1 = require("../common/logger.js");
 const constants_js_1 = require("../constants.js");
 const io_js_1 = require("../types/io.js");
 const ao_js_1 = require("./ao.js");
@@ -122,12 +123,22 @@ const getEpochDataFromGqlFallback = async ({ ao, epochIndex, processId = constan
             continue;
         }
         for (const message of messageResult?.Messages ?? []) {
-            const data = JSON.parse(message.Data);
-            const tags = message.Tags;
-            // check if the message results include epoch-distribution-notice for the requested epoch index
-            if (tags.some((tag) => tag.name === 'Action' && tag.value === 'Epoch-Distribution-Notice') &&
-                tags.some((tag) => tag.name === 'Epoch-Index' && tag.value === epochIndex.toString())) {
-                return (0, ao_js_1.parseAoEpochData)(data);
+            if (!message.Data) {
+                continue;
+            }
+            try {
+                const tags = message.Tags;
+                // check if the message results include epoch-distribution-notice for the requested epoch index
+                if (tags.some((tag) => tag.name === 'Action' &&
+                    tag.value === 'Epoch-Distribution-Notice') &&
+                    tags.some((tag) => tag.name === 'Epoch-Index' && tag.value === epochIndex.toString())) {
+                    const data = JSON.parse(message.Data);
+                    return (0, ao_js_1.parseAoEpochData)(data);
+                }
+            }
+            catch (error) {
+                // report but continue to next message
+                logger_js_1.Logger.default.error('Failed to parse AO epoch distribution message:', error, '\nMessage:', 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.21.0';
+exports.version = '3.22.0-alpha.1';

package/lib/esm/cli/options.js

@@ -137,6 +137,10 @@ export const optionMap = {
         description: 'The allowed delegates for the gateway. By default this is empty, meaning all are allowed delegate stake unless delegating is explicitly disallowed by the gateway',
         type: 'array',
     },
+    services: {
+        alias: '--services <services>',
+        description: 'JSON string of gateway services configuration (e.g., \'{"bundlers":[{"fqdn":"bundler.example.com","port":443,"protocol":"https","path":"/bundler"}]}\')',
+    },
     skipConfirmation: {
         alias: '--skip-confirmation',
         description: 'Skip confirmation prompts',
@@ -403,6 +407,7 @@ export const updateGatewaySettingsOptions = [
     optionMap.fqdn,
     optionMap.port,
     optionMap.protocol,
+    optionMap.services,
 ];
 export const joinNetworkOptions = [
     ...updateGatewaySettingsOptions,

package/lib/esm/cli/utils.js

@@ -280,7 +280,44 @@ export function customTagsFromOptions(options) {
         tags,
     };
 }
-export function gatewaySettingsFromOptions({ allowDelegatedStaking, autoStake, delegateRewardShareRatio, fqdn, label, minDelegatedStake, note, observerAddress, port, properties, allowedDelegates, }) {
+export function servicesFromOptions(services) {
+    if (services === undefined || services === null || services === '') {
+        return undefined;
+    }
+    try {
+        const parsed = JSON.parse(services);
+        // Validate structure
+        if (!parsed.bundlers || !Array.isArray(parsed.bundlers)) {
+            throw new Error('Services must have a "bundlers" array');
+        }
+        if (parsed.bundlers.length > 20) {
+            throw new Error('Maximum 20 bundlers allowed');
+        }
+        // Validate each bundler
+        for (const bundler of parsed.bundlers) {
+            if (!bundler.fqdn || typeof bundler.fqdn !== 'string') {
+                throw new Error('Each bundler must have a valid "fqdn" string');
+            }
+            if (typeof bundler.port !== 'number' ||
+                bundler.port < 0 ||
+                bundler.port > 65535) {
+                throw new Error('Each bundler must have a valid "port" (0-65535)');
+            }
+            if (bundler.protocol !== 'https') {
+                throw new Error('Each bundler protocol must be "https"');
+            }
+            if (!bundler.path || typeof bundler.path !== 'string') {
+                throw new Error('Each bundler must have a valid "path" string');
+            }
+        }
+        return parsed;
+    }
+    catch (error) {
+        throw new Error(`Invalid services JSON: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+export function gatewaySettingsFromOptions(options) {
+    const { allowDelegatedStaking, autoStake, delegateRewardShareRatio, fqdn, label, minDelegatedStake, note, observerAddress, port, properties, allowedDelegates, services, } = options;
     return {
         observerAddress,
         allowDelegatedStaking,
@@ -295,6 +332,7 @@ export function gatewaySettingsFromOptions({ allowDelegatedStaking, autoStake, d
         note,
         port: port !== undefined ? +port : undefined,
         properties,
+        services: servicesFromOptions(services),
     };
 }
 export function requiredTargetAndQuantityFromOptions(options) {

package/lib/esm/common/io.js

@@ -816,7 +816,7 @@ export class ARIOWriteable extends ARIOReadable {
             signer: this.signer,
         });
     }
-    async joinNetwork({ operatorStake, allowDelegatedStaking, allowedDelegates, delegateRewardShareRatio, fqdn, label, minDelegatedStake, note, port, properties, protocol, autoStake, observerAddress, }, options) {
+    async joinNetwork({ operatorStake, allowDelegatedStaking, allowedDelegates, delegateRewardShareRatio, fqdn, label, minDelegatedStake, note, port, properties, protocol, autoStake, observerAddress, services, }, options) {
         const { tags = [] } = options || {};
         const allTags = [
             ...tags,
@@ -873,6 +873,10 @@ export class ARIOWriteable extends ARIOReadable {
                 name: 'Observer-Address',
                 value: observerAddress,
             },
+            {
+                name: 'Services',
+                value: services ? JSON.stringify(services) : undefined,
+            },
         ];
         return this.process.send({
             signer: this.signer,
@@ -886,7 +890,7 @@ export class ARIOWriteable extends ARIOReadable {
             tags: [...tags, { name: 'Action', value: 'Leave-Network' }],
         });
     }
-    async updateGatewaySettings({ allowDelegatedStaking, allowedDelegates, delegateRewardShareRatio, fqdn, label, minDelegatedStake, note, port, properties, protocol, autoStake, observerAddress, }, options) {
+    async updateGatewaySettings({ allowDelegatedStaking, allowedDelegates, delegateRewardShareRatio, fqdn, label, minDelegatedStake, note, port, properties, protocol, autoStake, observerAddress, services, }, options) {
         const { tags = [] } = options || {};
         const allTags = [
             ...tags,
@@ -915,6 +919,10 @@ export class ARIOWriteable extends ARIOReadable {
                 value: minDelegatedStake?.valueOf().toString(),
             },
             { name: 'Auto-Stake', value: autoStake?.toString() },
+            {
+                name: 'Services',
+                value: services ? JSON.stringify(services) : undefined,
+            },
         ];
         return this.process.send({
             signer: this.signer,

package/lib/esm/utils/arweave.js

@@ -1,3 +1,4 @@
+import { Logger } from '../common/logger.js';
 import { ARIO_MAINNET_PROCESS_ID, ARWEAVE_TX_REGEX } from '../constants.js';
 import { isDistributedEpoch, } from '../types/io.js';
 import { parseAoEpochData } from './ao.js';
@@ -111,12 +112,22 @@ export const getEpochDataFromGqlFallback = async ({ ao, epochIndex, processId =
             continue;
         }
         for (const message of messageResult?.Messages ?? []) {
-            const data = JSON.parse(message.Data);
-            const tags = message.Tags;
-            // check if the message results include epoch-distribution-notice for the requested epoch index
-            if (tags.some((tag) => tag.name === 'Action' && tag.value === 'Epoch-Distribution-Notice') &&
-                tags.some((tag) => tag.name === 'Epoch-Index' && tag.value === epochIndex.toString())) {
-                return parseAoEpochData(data);
+            if (!message.Data) {
+                continue;
+            }
+            try {
+                const tags = message.Tags;
+                // check if the message results include epoch-distribution-notice for the requested epoch index
+                if (tags.some((tag) => tag.name === 'Action' &&
+                    tag.value === 'Epoch-Distribution-Notice') &&
+                    tags.some((tag) => tag.name === 'Epoch-Index' && tag.value === epochIndex.toString())) {
+                    const data = JSON.parse(message.Data);
+                    return parseAoEpochData(data);
+                }
+            }
+            catch (error) {
+                // report but continue to next message
+                Logger.default.error('Failed to parse AO epoch distribution message:', error, '\nMessage:', message);
             }
         }
     }

package/lib/esm/version.js

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

package/lib/types/cli/options.d.ts

@@ -133,6 +133,10 @@ export declare const optionMap: {
         description: string;
         type: string;
     };
+    services: {
+        alias: string;
+        description: string;
+    };
     skipConfirmation: {
         alias: string;
         description: string;

package/lib/types/cli/utils.d.ts

@@ -46,7 +46,8 @@ export declare function paginationParamsFromOptions<O extends PaginationCLIOptio
 export declare function epochInputFromOptions(options: EpochCLIOptions): EpochInput;
 export declare function requiredInitiatorFromOptions(options: InitiatorCLIOptions): string;
 export declare function customTagsFromOptions<O extends WriteActionCLIOptions>(options: O): WriteOptions;
-export declare function gatewaySettingsFromOptions({ allowDelegatedStaking, autoStake, delegateRewardShareRatio, fqdn, label, minDelegatedStake, note, observerAddress, port, properties, allowedDelegates, }: UpdateGatewaySettingsCLIOptions): AoUpdateGatewaySettingsParams;
+export declare function servicesFromOptions(services?: string): any;
+export declare function gatewaySettingsFromOptions(options: UpdateGatewaySettingsCLIOptions): AoUpdateGatewaySettingsParams;
 export declare function requiredTargetAndQuantityFromOptions(options: TransferCLIOptions): {
     target: string;
     arioQuantity: ARIOToken;

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

@@ -172,9 +172,9 @@ export declare class ARIOWriteable extends ARIOReadable implements AoARIOWrite {
     createVault({ lockLengthMs, quantity }: AoCreateVaultParams, options?: WriteOptions): Promise<AoMessageResult>;
     extendVault({ vaultId, extendLengthMs }: AoExtendVaultParams, options?: WriteOptions): Promise<AoMessageResult>;
     increaseVault({ vaultId, quantity }: AoIncreaseVaultParams, options?: WriteOptions): Promise<AoMessageResult>;
-    joinNetwork({ operatorStake, allowDelegatedStaking, allowedDelegates, delegateRewardShareRatio, fqdn, label, minDelegatedStake, note, port, properties, protocol, autoStake, observerAddress, }: AoJoinNetworkParams, options?: WriteOptions): Promise<AoMessageResult>;
+    joinNetwork({ operatorStake, allowDelegatedStaking, allowedDelegates, delegateRewardShareRatio, fqdn, label, minDelegatedStake, note, port, properties, protocol, autoStake, observerAddress, services, }: AoJoinNetworkParams, options?: WriteOptions): Promise<AoMessageResult>;
     leaveNetwork(options?: WriteOptions): Promise<AoMessageResult>;
-    updateGatewaySettings({ allowDelegatedStaking, allowedDelegates, delegateRewardShareRatio, fqdn, label, minDelegatedStake, note, port, properties, protocol, autoStake, observerAddress, }: AoUpdateGatewaySettingsParams, options?: WriteOptions): Promise<AoMessageResult>;
+    updateGatewaySettings({ allowDelegatedStaking, allowedDelegates, delegateRewardShareRatio, fqdn, label, minDelegatedStake, note, port, properties, protocol, autoStake, observerAddress, services, }: AoUpdateGatewaySettingsParams, options?: WriteOptions): Promise<AoMessageResult>;
     delegateStake(params: {
         target: string;
         stakeQty: number | mARIOToken;

package/lib/types/types/io.d.ts

@@ -278,6 +278,7 @@ export type AoAllGatewayVaults = AoGatewayVault & {
 };
 export type AoJoinNetworkParams = Pick<AoGateway, 'operatorStake'> & Partial<AoGatewaySettings> & {
     observerAddress?: WalletAddress;
+    services?: AoGatewayServices;
 };
 export type AoUpdateGatewaySettingsParams = AtLeastOne<Omit<AoJoinNetworkParams, 'operatorStake'>>;
 export type AoArNSNameParams = {

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.21.0-alpha.1";
+export declare const version = "3.21.1-alpha.1";

package/package.json

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