feat(delegations): add getter for staked and vaulted delegations PE-7093

src/common/io.ts

@@ -42,6 +42,7 @@ import {
 import {
   AoArNSNameData,
   AoAuctionPriceData,
+  AoDelegation,
   AoEpochData,
   AoEpochSettings,
   AoGateway,
@@ -637,6 +638,26 @@ export class IOReadable implements AoIORead {
       tags: prunedPriceTags,
     });
   }
+
+  async getDelegations({
+    address,
+    params,
+  }: {
+    address: WalletAddress;
+    params?: PaginationParams<AoDelegation>;
+  }): Promise<PaginationResult<AoDelegation>> {
+    const allTags = [
+      { name: 'Action', value: 'Paginated-Delegations' },
+      { name: 'Cursor', value: params?.cursor?.toString() },
+      { name: 'Limit', value: params?.limit?.toString() },
+      { name: 'Sort-By', value: params?.sortBy },
+      { name: 'Sort-Order', value: params?.sortOrder },
+      { name: 'Address', value: address },
+    ];
+    return this.process.read<PaginationResult<AoDelegation>>({
+      tags: pruneTags(allTags),
+    });
+  }
 }
 
 export class IOWriteable extends IOReadable implements AoIOWrite {

src/types/io.ts

@@ -296,6 +296,27 @@ export type AoAuctionPriceData = {
   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;
+
 // Input types
 
 // TODO: confirm what is required or if all can be optional and defaults will be provided