feat: support new rpc endpoint ticket_balance

re #2270

packages/taquito-contracts-library/src/rpc-wrapper.ts

@@ -44,6 +44,7 @@ import {
   UnparsingMode,
   VotesListingsResponse,
   VotingPeriodBlockResult,
+  ticketTokenParams,
 } from '@taquito/rpc';
 import { ContractsLibrary } from './taquito-contracts-library';
 
@@ -306,4 +307,11 @@ export class RpcWrapperContractsLibrary implements RpcClientInterface {
   ): Promise<string> {
     return this.rpc.getStoragePaidSpace(contract, { block });
   }
+  async getTicketBalance(
+    contract: string,
+    ticket: ticketTokenParams,
+    { block }: RPCOptions = defaultRPCOptions
+  ): Promise<string> {
+    return this.rpc.getTicketBalance(contract, ticket, { block });
+  }
 }

packages/taquito-rpc/src/rpc-client-interface.ts

@@ -44,6 +44,7 @@ import {
   VotesListingsResponse,
   VotingInfoResponse,
   VotingPeriodBlockResult,
+  ticketTokenParams,
 } from './types';
 
 export interface RPCOptions {
@@ -119,6 +120,11 @@ export interface RpcClientInterface {
   ): Promise<TxRollupInboxResponse | null>;
   getStorageUsedSpace(contract: string, options?: RPCOptions): Promise<string>;
   getStoragePaidSpace(contract: string, options?: RPCOptions): Promise<string>;
+  getTicketBalance(
+    contract: string,
+    ticket: ticketTokenParams,
+    options?: RPCOptions
+  ): Promise<string>;
 }
 
 export enum RPCMethodName {
@@ -159,4 +165,5 @@ export enum RPCMethodName {
   PACK_DATA = 'packData',
   GET_STORAGE_USED_SPACE = 'getStorageUsedSpace',
   GET_STORAGE_PAID_SPACE = 'getStoragePaidSpace',
+  GET_TICKET_BALANCE = 'getTicketBalance',
 }

packages/taquito-rpc/src/rpc-client-modules/rpc-cache.ts

@@ -46,6 +46,7 @@ import {
   UnparsingMode,
   VotesListingsResponse,
   VotingPeriodBlockResult,
+  ticketTokenParams,
 } from '../types';
 
 import {
@@ -1165,4 +1166,22 @@ export class RpcClientCache implements RpcClientInterface {
       return response;
     }
   }
+
+  async getTicketBalance(
+    contract: string,
+    ticket: ticketTokenParams,
+    { block }: { block: string } = defaultRPCOptions
+  ): Promise<string> {
+    const key = this.formatCacheKey(this.rpcClient.getRpcUrl(), RPCMethodName.GET_TICKET_BALANCE, [
+      block,
+      contract,
+    ]);
+    if (this.has(key)) {
+      return this.get(key);
+    } else {
+      const response = this.rpcClient.getTicketBalance(contract, ticket, { block });
+      this.put(key, response);
+      return response;
+    }
+  }
 }

packages/taquito-rpc/src/taquito-rpc.ts

@@ -57,6 +57,7 @@ import {
   VotingPeriodBlockResult,
   TxRollupStateResponse,
   TxRollupInboxResponse,
+  ticketTokenParams,
 } from './types';
 import { castToBigNumber } from './utils/utils';
 import {
@@ -1126,4 +1127,29 @@ export class RpcClient implements RpcClientInterface {
       method: 'GET',
     });
   }
+
+  /**
+   *
+   * @param contract address of the contract we want to retrieve ticket balance of
+   * @param options contains generic configuration for rpc calls
+   *
+   * @description Access the contract's balance of ticket with specified ticketer, content type, and content.
+   *
+   * @see https://tezos.gitlab.io/protocols/016_mumbai.html#rpc-changes
+   */
+  async getTicketBalance(
+    contract: string,
+    ticket: ticketTokenParams,
+    { block }: { block: string } = defaultRPCOptions
+  ): Promise<string> {
+    return this.httpBackend.createRequest<string>(
+      {
+        url: this.createURL(
+          `/chains/${this.chain}/blocks/${block}/context/contracts/${contract}/ticket_balance`
+        ),
+        method: 'POST',
+      },
+      ticket
+    );
+  }
 }

packages/taquito-rpc/src/types.ts

@@ -1089,6 +1089,12 @@ export interface PackDataParams {
   gas?: BigNumber;
 }
 
+export interface ticketTokenParams {
+  ticketer: 'string';
+  content_type: MichelsonV1Expression;
+  content: MichelsonV1Expression;
+}
+
 export type HexString = string;
 
 export interface PackDataResponse {