@ar.io/sdk 2.4.0-alpha.9 → 2.5.0-alpha.1

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

@@ -16,17 +16,17 @@
 import { AOProcess } from '../common/index.js';
 import { AoMessageResult, AtLeastOne, BlockHeight, ProcessId, Timestamp, TransactionId, WalletAddress, WriteOptions } from './index.js';
 import { mIOToken } from './token.js';
-export type PaginationParams = {
+export type PaginationParams<T = Record<string, never>> = {
     cursor?: string;
     limit?: number;
-    sortBy?: string;
+    sortBy?: keyof T extends never ? string : keyof T;
     sortOrder?: 'asc' | 'desc';
 };
 export type PaginationResult<T> = {
     items: T[];
     nextCursor: string | undefined;
     totalItems: number;
-    sortBy: keyof T;
+    sortBy?: keyof T;
     sortOrder: 'asc' | 'desc';
     hasMore: boolean;
 };
@@ -65,7 +65,7 @@ export type AoEpochObservationData = {
 };
 export type AoVaultData = {
     balance: number;
-    locked: number;
+    startTimestamp: Timestamp;
     endTimestamp: Timestamp;
 };
 export type AoEpochDistributionRewards = {
@@ -142,10 +142,16 @@ export type AoGatewayService = {
 export type AoGatewayServices = {
     bundlers: AoGatewayService[];
 } | undefined;
+export type AoGatewayDelegates = Record<WalletAddress, AoGatewayDelegate>;
+export type AoGatewayDelegateAllowList = WalletAddress[];
+export type AoWalletVault = AoVaultData & {
+    address: WalletAddress;
+    vaultId: string;
+};
 export type AoGateway = {
     settings: AoGatewaySettings;
+    delegates: AoGatewayDelegates;
     stats: AoGatewayStats;
-    delegates: Record<WalletAddress, AoGatewayDelegate>;
     totalDelegatedStake: number;
     vaults: Record<WalletAddress, AoVaultData>;
     startTimestamp: Timestamp;
@@ -187,9 +193,13 @@ export type AoGatewayDelegate = {
     startTimestamp: Timestamp;
     vaults: Record<WalletAddress, AoVaultData>;
 };
+export type AoGatewayDelegateWithAddress = AoGatewayDelegate & {
+    address: WalletAddress;
+};
 export type AoGatewaySettings = {
-    allowDelegatedStaking: boolean;
+    allowDelegatedStaking: boolean | 'allowlist';
     delegateRewardShareRatio: number;
+    allowedDelegates: WalletAddress[];
     minDelegatedStake: number;
     autoStake: boolean;
     label: string;
@@ -224,6 +234,19 @@ export type AoAuctionPriceData = {
     prices: Record<string, number>;
     currentPrice: number;
 };
+export type AoDelegationBase = {
+    type: 'stake' | 'vault';
+    gatewayAddress: WalletAddress;
+    delegationId: string;
+};
+export type AoVaultDelegation = AoDelegationBase & AoVaultData & {
+    type: 'vault';
+    vaultId: TransactionId;
+};
+export type AoStakeDelegation = Omit<AoVaultDelegation, 'endTimestamp' | 'vaultId'> & {
+    type: 'stake';
+};
+export type AoDelegation = AoStakeDelegation | AoVaultDelegation;
 export type AoJoinNetworkParams = Pick<AoGateway, 'operatorStake' | 'observerAddress'> & Partial<AoGatewaySettings>;
 export type AoUpdateGatewaySettingsParams = AtLeastOne<AoJoinNetworkParams>;
 export interface AoIORead {
@@ -240,20 +263,24 @@ export interface AoIORead {
     getGateway({ address, }: {
         address: WalletAddress;
     }): Promise<AoGateway | undefined>;
-    getGateways(params?: PaginationParams): Promise<PaginationResult<AoGatewayWithAddress>>;
+    getGatewayDelegates({ address, ...pageParams }: {
+        address: WalletAddress;
+    } & PaginationParams<AoGatewayDelegateWithAddress>): Promise<PaginationResult<AoGatewayDelegateWithAddress>>;
+    getGatewayDelegateAllowList(params?: PaginationParams<WalletAddress>): Promise<PaginationResult<WalletAddress>>;
+    getGateways(params?: PaginationParams<AoGatewayWithAddress>): Promise<PaginationResult<AoGatewayWithAddress>>;
     getBalance(params: {
         address: WalletAddress;
     }): Promise<number>;
-    getBalances(params?: PaginationParams): Promise<PaginationResult<AoBalanceWithAddress>>;
+    getBalances(params?: PaginationParams<AoBalanceWithAddress>): Promise<PaginationResult<AoBalanceWithAddress>>;
     getArNSRecord({ name, }: {
         name: string;
     }): Promise<AoArNSNameData | undefined>;
-    getArNSRecords(params?: PaginationParams): Promise<PaginationResult<AoArNSNameDataWithName>>;
+    getArNSRecords(params?: PaginationParams<AoArNSNameDataWithName>): Promise<PaginationResult<AoArNSNameDataWithName>>;
     getArNSReservedNames(): Promise<Record<string, AoArNSReservedNameData> | Record<string, never>>;
     getArNSReservedName({ name, }: {
         name: string;
     }): Promise<AoArNSReservedNameData | undefined>;
-    getArNSAuctions(params?: PaginationParams): Promise<PaginationResult<AoAuction>>;
+    getArNSAuctions(params?: PaginationParams<AoAuction>): Promise<PaginationResult<AoAuction>>;
     getArNSAuction({ name }: {
         name: string;
     }): Promise<AoAuction | undefined>;
@@ -279,15 +306,20 @@ export interface AoIORead {
     }): Promise<number>;
     getRegistrationFees(): Promise<AoRegistrationFees>;
     getDemandFactor(): Promise<number>;
+    getVaults(params?: PaginationParams<AoWalletVault>): Promise<PaginationResult<AoWalletVault>>;
+    getVault({ address, vaultId, }: {
+        address: WalletAddress;
+        vaultId: string;
+    }): Promise<AoVaultData>;
 }
 export interface AoIOWrite extends AoIORead {
     transfer({ target, qty, }: {
         target: WalletAddress;
         qty: number;
     }, options?: WriteOptions): Promise<AoMessageResult>;
-    joinNetwork({ operatorStake, allowDelegatedStaking, delegateRewardShareRatio, fqdn, label, minDelegatedStake, note, port, properties, protocol, autoStake, observerAddress, }: AoJoinNetworkParams, options?: WriteOptions): Promise<AoMessageResult>;
+    joinNetwork(params: AoJoinNetworkParams, options?: WriteOptions): Promise<AoMessageResult>;
     leaveNetwork(options?: WriteOptions): Promise<AoMessageResult>;
-    updateGatewaySettings({ allowDelegatedStaking, delegateRewardShareRatio, fqdn, label, minDelegatedStake, note, port, properties, protocol, autoStake, observerAddress, }: AoUpdateGatewaySettingsParams, options?: WriteOptions): Promise<AoMessageResult>;
+    updateGatewaySettings(params: AoUpdateGatewaySettingsParams, options?: WriteOptions): Promise<AoMessageResult>;
     increaseOperatorStake(params: {
         increaseQty: number | mIOToken;
     }, options?: WriteOptions): Promise<AoMessageResult>;

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

@@ -1,3 +1,27 @@
-import { BlockHeight } from '../types/common.js';
+/**
+ * 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.
+ */
+import Arweave from 'arweave';
+import { BlockHeight, Timestamp } from '../types/common.js';
 export declare const validateArweaveId: (id: string) => boolean;
 export declare function isBlockHeight(height: string | number): height is BlockHeight;
+export declare const pruneTags: (tags: {
+    name: string;
+    value: string | undefined;
+}[]) => {
+    name: string;
+    value: string;
+}[];
+export declare const getCurrentBlockUnixTimestampMs: (arweave: Arweave) => Promise<Timestamp>;

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

@@ -13,9 +13,9 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-export * from './arweave.js';
-export * from './http-client.js';
 export * from './ao.js';
+export * from './arweave.js';
+export * from './base64.js';
 export * from './json.js';
 export * from './processes.js';
 export * from './schema.js';

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

@@ -29,11 +29,13 @@ export declare class ArNSEventEmitter extends EventEmitter {
     private timeoutMs;
     private throttle;
     private logger;
-    constructor({ contract, timeoutMs, concurrency, logger, }?: {
+    private strict;
+    constructor({ contract, timeoutMs, concurrency, logger, strict, }?: {
         contract?: AoIORead;
         timeoutMs?: number;
         concurrency?: number;
         logger?: ILogger;
+        strict?: boolean;
     });
     fetchProcessesOwnedByWallet({ address, pageSize, antRegistry, }: {
         address: WalletAddress;

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 = "2.4.0-alpha.8";
+export declare const version = "2.4.0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ar.io/sdk",
-  "version": "2.4.0-alpha.9",
+  "version": "2.5.0-alpha.1",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/ar-io/ar-io-sdk.git"
@@ -109,6 +109,7 @@
     "husky": "^8.0.3",
     "lint-staged": "^15.2.2",
     "markdown-toc-gen": "^1.0.1",
+    "nock": "^13.5.5",
     "prettier": "^3.0.2",
     "rimraf": "^5.0.1",
     "semantic-release": "^21.0.7",