feat(sto): add name to the Sto entity

src/api/entities/Sto/__tests__/index.ts

@@ -393,4 +393,21 @@ describe('Sto class', () => {
       expect(queue).toBe(expectedQueue);
     });
   });
+
+  describe('method: name', () => {
+    test("should return the offering's name", async () => {
+      const name = 'someName';
+      const ticker = 'SOMETICKER';
+      const id = new BigNumber(1);
+      const sto = new Sto({ id, ticker }, context);
+
+      dsMockUtils.createQueryStub('sto', 'fundraiserNames', {
+        returnValue: dsMockUtils.createMockFundraiserName(name),
+      });
+
+      const result = await sto.name();
+
+      expect(result).toBe(name);
+    });
+  });
 });

src/api/entities/Sto/index.ts

@@ -18,7 +18,12 @@ import { Query } from '~/middleware/types';
 import { Fundraiser } from '~/polkadot/polymesh/types';
 import { Ensured, ErrorCode, ResultSet, SubCallback, UnsubCallback } from '~/types';
 import { ProcedureMethod } from '~/types/internal';
-import { fundraiserToStoDetails, numberToU64, stringToTicker } from '~/utils/conversion';
+import {
+  fundraiserToStoDetails,
+  numberToU64,
+  stringToTicker,
+  textToString,
+} from '~/utils/conversion';
 import { calculateNextKey, createProcedureMethod } from '~/utils/internal';
 
 import { Investment, StoDetails } from './types';
@@ -236,4 +241,18 @@ export class Sto extends Entity<UniqueIdentifiers> {
       count,
     };
   }
+
+  /**
+   * Retrieve the Offering's name
+   */
+  public async name(): Promise<string> {
+    const { context, id, ticker } = this;
+
+    const name = await context.polymeshApi.query.sto.fundraiserNames(
+      stringToTicker(ticker, context),
+      numberToU64(id, context)
+    );
+
+    return textToString(name);
+  }
 }

src/testUtils/mocks/dataSources.ts

@@ -74,6 +74,7 @@ import {
   DocumentUri,
   FundingRoundName,
   Fundraiser,
+  FundraiserName,
   FundraiserStatus,
   FundraiserTier,
   IdentityClaim,
@@ -1675,6 +1676,13 @@ export const createMockPalletName = (name?: string): PalletName =>
 export const createMockDispatchableName = (name?: string): DispatchableName =>
   createMockStringCodec(name) as DispatchableName;
 
+/**
+ * @hidden
+ * NOTE: `isEmpty` will be set to true if no value is passed
+ */
+export const createMockFundraiserName = (name?: string): FundraiserName =>
+  createMockStringCodec(name) as FundraiserName;
+
 /**
  * @hidden
  * NOTE: `isEmpty` will be set to true if no value is passed