@ar.io/sdk 2.5.0-alpha.12 → 2.5.0-alpha.13

package/lib/cjs/common/io.js

@@ -438,6 +438,21 @@ class IOReadable {
             ],
         });
     }
+    /**
+     * Get current redelegation fee percentage for address
+     *
+     * @param {Object} params - The parameters for fetching redelegation fee
+     * @param {string} params.address - The address to fetch the fee for
+     * @returns {Promise<AoMessageResult>} The redelegation fee result
+     */
+    async getRedelegationFee(params) {
+        return this.process.read({
+            tags: [
+                { name: 'Action', value: 'Redelegation-Fee' },
+                { name: 'Address', value: params.address },
+            ],
+        });
+    }
 }
 exports.IOReadable = IOReadable;
 class IOWriteable extends IOReadable {
@@ -790,5 +805,31 @@ class IOWriteable extends IOReadable {
             ],
         });
     }
+    /**
+     * Redelegate stake from one gateway to another gateway.
+     *
+     * @param {Object} params - The parameters for redelegating stake
+     * @param {string} params.target - The target gateway address
+     * @param {string} params.source - The source gateway address
+     * @param {number} params.stakeQty - The quantity of stake to redelegate
+     * @param {string} params.vaultId - An optional vault ID to redelegate from
+     * @param {Object} [options] - The options for the redelegation
+     * @returns {Promise<AoMessageResult>} The result of the redelegation
+     */
+    async redelegateStake(params, options) {
+        const { tags = [] } = options || {};
+        const allTags = [
+            ...tags,
+            { name: 'Action', value: 'Redelegate-Stake' },
+            { name: 'Target', value: params.target },
+            { name: 'Source', value: params.source },
+            { name: 'Quantity', value: params.stakeQty.valueOf().toString() },
+            { name: 'Vault-Id', value: params.vaultId },
+        ];
+        return this.process.send({
+            signer: this.signer,
+            tags: (0, arweave_js_1.pruneTags)(allTags),
+        });
+    }
 }
 exports.IOWriteable = IOWriteable;

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 = '2.5.0-alpha.12';
+exports.version = '2.5.0-alpha.13';

package/lib/esm/common/io.js

@@ -434,6 +434,21 @@ export class IOReadable {
             ],
         });
     }
+    /**
+     * Get current redelegation fee percentage for address
+     *
+     * @param {Object} params - The parameters for fetching redelegation fee
+     * @param {string} params.address - The address to fetch the fee for
+     * @returns {Promise<AoMessageResult>} The redelegation fee result
+     */
+    async getRedelegationFee(params) {
+        return this.process.read({
+            tags: [
+                { name: 'Action', value: 'Redelegation-Fee' },
+                { name: 'Address', value: params.address },
+            ],
+        });
+    }
 }
 export class IOWriteable extends IOReadable {
     signer;
@@ -785,4 +800,30 @@ export class IOWriteable extends IOReadable {
             ],
         });
     }
+    /**
+     * Redelegate stake from one gateway to another gateway.
+     *
+     * @param {Object} params - The parameters for redelegating stake
+     * @param {string} params.target - The target gateway address
+     * @param {string} params.source - The source gateway address
+     * @param {number} params.stakeQty - The quantity of stake to redelegate
+     * @param {string} params.vaultId - An optional vault ID to redelegate from
+     * @param {Object} [options] - The options for the redelegation
+     * @returns {Promise<AoMessageResult>} The result of the redelegation
+     */
+    async redelegateStake(params, options) {
+        const { tags = [] } = options || {};
+        const allTags = [
+            ...tags,
+            { name: 'Action', value: 'Redelegate-Stake' },
+            { name: 'Target', value: params.target },
+            { name: 'Source', value: params.source },
+            { name: 'Quantity', value: params.stakeQty.valueOf().toString() },
+            { name: 'Vault-Id', value: params.vaultId },
+        ];
+        return this.process.send({
+            signer: this.signer,
+            tags: pruneTags(allTags),
+        });
+    }
 }

package/lib/esm/version.js

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

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

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 import Arweave from 'arweave';
-import { AoArNSNameDataWithName, AoArNSReservedNameData, AoAuction, AoBalanceWithAddress, AoEpochDistributionData, AoEpochObservationData, AoGatewayWithAddress, AoJoinNetworkParams, AoMessageResult, AoPrimaryName, AoPrimaryNameRequest, AoTokenSupplyData, AoUpdateGatewaySettingsParams, AoWeightedObserver, ContractSigner, PaginationParams, PaginationResult, ProcessConfiguration, TransactionId, WalletAddress, WithSigner, WriteOptions } from '../types/index.js';
+import { AoArNSNameDataWithName, AoArNSReservedNameData, AoAuction, AoBalanceWithAddress, AoEpochDistributionData, AoEpochObservationData, AoGatewayWithAddress, AoJoinNetworkParams, AoMessageResult, AoPrimaryName, AoPrimaryNameRequest, AoRedelegationFeeInfo, AoTokenSupplyData, AoUpdateGatewaySettingsParams, AoWeightedObserver, ContractSigner, PaginationParams, PaginationResult, ProcessConfiguration, TransactionId, WalletAddress, WithSigner, WriteOptions } from '../types/index.js';
 import { AoArNSNameData, AoArNSReservedNameDataWithName, AoAuctionPriceData, AoDelegation, AoEpochData, AoEpochSettings, AoGateway, AoGatewayDelegateWithAddress, AoGatewayVault, AoIORead, AoIOWrite, AoRegistrationFees, AoVaultData, AoWalletVault, EpochInput } from '../types/io.js';
 import { mIOToken } from '../types/token.js';
 import { AOProcess } from './contracts/ao-process.js';
@@ -146,6 +146,16 @@ export declare class IOReadable implements AoIORead {
         name: string;
     }): Promise<AoPrimaryName>;
     getPrimaryNames(params: PaginationParams<AoPrimaryName>): Promise<PaginationResult<AoPrimaryName>>;
+    /**
+     * Get current redelegation fee percentage for address
+     *
+     * @param {Object} params - The parameters for fetching redelegation fee
+     * @param {string} params.address - The address to fetch the fee for
+     * @returns {Promise<AoMessageResult>} The redelegation fee result
+     */
+    getRedelegationFee(params: {
+        address: WalletAddress;
+    }): Promise<AoRedelegationFeeInfo>;
 }
 export declare class IOWriteable extends IOReadable implements AoIOWrite {
     protected process: AOProcess;
@@ -250,4 +260,21 @@ export declare class IOWriteable extends IOReadable implements AoIOWrite {
     requestPrimaryName(params: {
         name: string;
     }): Promise<AoMessageResult>;
+    /**
+     * Redelegate stake from one gateway to another gateway.
+     *
+     * @param {Object} params - The parameters for redelegating stake
+     * @param {string} params.target - The target gateway address
+     * @param {string} params.source - The source gateway address
+     * @param {number} params.stakeQty - The quantity of stake to redelegate
+     * @param {string} params.vaultId - An optional vault ID to redelegate from
+     * @param {Object} [options] - The options for the redelegation
+     * @returns {Promise<AoMessageResult>} The result of the redelegation
+     */
+    redelegateStake(params: {
+        target: string;
+        source: string;
+        stakeQty: number | mIOToken;
+        vaultId?: string;
+    }, options?: WriteOptions): Promise<AoMessageResult>;
 }

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

@@ -54,6 +54,16 @@ export type AoPrimaryName = {
     name: string;
     startTimestamp: Timestamp;
 };
+/**
+ * Users are allowed one free redelegation every seven epochs. Each additional
+ * redelegation increases the fee by 10%, capping at a 60% redelegation fee
+ */
+export type AoRedelegationFeeInfo = {
+    /** Percentage of redelegated stake that will be returned to the protocol on redelegation */
+    redelegationFeeRate: number;
+    /** Timestamp when the redelegation fee will reset to zero */
+    feeResetTimestamp: number;
+};
 export type AtLeastOne<T, U = {
     [K in keyof T]-?: Record<K, T[K]>;
 }> = Partial<T> & U[keyof U];

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

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 import { AOProcess } from '../common/index.js';
-import { AoMessageResult, AoPrimaryName, AoPrimaryNameRequest, AtLeastOne, BlockHeight, ProcessId, Timestamp, TransactionId, WalletAddress, WriteOptions } from './index.js';
+import { AoMessageResult, AoPrimaryName, AoPrimaryNameRequest, AoRedelegationFeeInfo, AtLeastOne, BlockHeight, ProcessId, Timestamp, TransactionId, WalletAddress, WriteOptions } from './index.js';
 import { mIOToken } from './token.js';
 export type PaginationParams<T = Record<string, never>> = {
     cursor?: string;
@@ -331,6 +331,9 @@ export interface AoIORead {
         name: string;
     }): Promise<AoPrimaryName>;
     getPrimaryNames(params?: PaginationParams<AoPrimaryName>): Promise<PaginationResult<AoPrimaryName>>;
+    getRedelegationFee(params: {
+        address: WalletAddress;
+    }): Promise<AoRedelegationFeeInfo>;
 }
 export interface AoIOWrite extends AoIORead {
     transfer({ target, qty, }: {
@@ -394,6 +397,12 @@ export interface AoIOWrite extends AoIORead {
     requestPrimaryName(params: {
         name: string;
     }): Promise<AoMessageResult>;
+    redelegateStake(params: {
+        target: string;
+        source: string;
+        stakeQty: number | mIOToken;
+        vaultId?: string;
+    }, options?: WriteOptions): Promise<AoMessageResult>;
 }
 export declare function isProcessConfiguration(config: object): config is {
     process: AOProcess;

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.5.0-alpha.11";
+export declare const version = "2.5.0-alpha.12";

package/package.json

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