Module Details Views

backend/Application/Aggregates/Contract/Entities/Contract.cs

@@ -109,7 +109,7 @@ public IQueryable<Contract> GetContracts(
     }
 
     /// <summary>
-    /// Adds additional field to the returned GraphQL type <see cref="Contract"/>
+    /// Adds additional field to the GraphQL type <see cref="Contract"/>
     /// </summary>
     [ExtendObjectType(typeof(Contract))]
     public sealed class ContractExtensions

backend/Application/Aggregates/Contract/Entities/ModuleReferenceContractLinkEvent.cs

@@ -1,6 +1,8 @@
 using Application.Aggregates.Contract.Types;
 using Application.Api.GraphQL;
 using Application.Api.GraphQL.Accounts;
+using HotChocolate;
+using HotChocolate.Types;
 
 namespace Application.Aggregates.Contract.Entities;
 
@@ -55,4 +57,14 @@ public enum ModuleReferenceContractLinkAction
         Added,
         Removed
     }
+
+    /// <summary>
+    /// Adds additional fields to the GraphQL type <see cref="ModuleReferenceContractLinkEvent"/>.
+    /// </summary>
+    [ExtendObjectType(typeof(ModuleReferenceContractLinkEvent))]
+    public sealed class ModuleReferenceContractLinkEventExtensions
+    {
+        public ContractAddress GetContractAddress([Parent] ModuleReferenceContractLinkEvent linkEvent) => 
+            new(linkEvent.ContractAddressIndex, linkEvent.ContractAddressSubIndex);
+    }
 }

backend/Application/Aggregates/Contract/Entities/ModuleReferenceEvent.cs

@@ -1,5 +1,12 @@
+using System.Threading.Tasks;
 using Application.Aggregates.Contract.Types;
+using Application.Api.GraphQL;
 using Application.Api.GraphQL.Accounts;
+using Application.Api.GraphQL.EfCore;
+using HotChocolate;
+using HotChocolate.Types;
+using Microsoft.EntityFrameworkCore;
+using Polly;
 
 namespace Application.Aggregates.Contract.Entities;
 
@@ -11,7 +18,21 @@ public sealed class ModuleReferenceEvent : BaseIdentification
     public uint EventIndex { get; init; }
     public string ModuleReference { get; init; } = null!;
     public AccountAddress Sender { get; init; } = null!;
-
+    /// <summary>
+    /// It is important, that when pagination is used together with a <see cref="System.Linq.IQueryable"/> return type
+    /// then aggregation result like <see cref="Contract.ContractExtensions.GetAmount"/> will not be correct.
+    ///
+    /// Hence pagination should only by used in cases where database query has executed like
+    /// <see cref="ModuleReferenceEvent.ModuleReferenceEventQuery.GetModuleReferenceEvent"/>.
+    /// </summary>
+    [UsePaging(IncludeTotalCount = true)]
+    public IList<ModuleReferenceContractLinkEvent> ModuleReferenceContractLinkEvents { get; init; } = null!;
+    /// <summary>
+    /// See pagination comment on above.
+    /// </summary>
+    [UsePaging(IncludeTotalCount = true)]
+    public IList<ModuleReferenceRejectEvent> ModuleReferenceRejectEvents { get; init; } = null!;
+
     /// <summary>
     /// Needed for EF Core
     /// </summary>
@@ -33,4 +54,60 @@ public ModuleReferenceEvent(
         ModuleReference = moduleReference;
         Sender = sender;
     }
+
+    [ExtendObjectType(typeof(Query))]
+    public class ModuleReferenceEventQuery
+    {
+        public Task<ModuleReferenceEvent?> GetModuleReferenceEvent(GraphQlDbContext context, string moduleReference)
+        {
+            return context.ModuleReferenceEvents
+                .AsSplitQuery()
+                .AsNoTracking()
+                .Where(m => m.ModuleReference == moduleReference)
+                .Include(m => m.ModuleReferenceContractLinkEvents
+                    .OrderByDescending(me => me.BlockHeight)
+                    .ThenByDescending(me => me.TransactionIndex)
+                    .ThenByDescending(me => me.EventIndex))
+                .Include(m => m.ModuleReferenceRejectEvents
+                    .OrderByDescending(me => me.BlockHeight)
+                    .ThenByDescending(me => me.TransactionIndex))
+                .SingleOrDefaultAsync();
+        }
+    }
+
+    /// <summary>
+    /// Adds additional fields to the GraphQL type <see cref="ModuleReferenceEvent"/>.
+    /// </summary>
+    [ExtendObjectType(typeof(ModuleReferenceEvent))]
+    public sealed class ModuleReferenceEventExtensions
+    {
+        [UsePaging(IncludeTotalCount = true)]
+        public IList<LinkedContract> GetLinkedContracts([Parent] ModuleReferenceEvent moduleReferenceEvent)
+        {
+            var map = new Dictionary<(ulong, ulong), DateTimeOffset>();
+            foreach (var moduleReferenceContractLinkEvent in moduleReferenceEvent.ModuleReferenceContractLinkEvents
+                         .OrderBy(me => me.BlockHeight)
+                         .ThenBy(me => me.TransactionIndex)
+                         .ThenBy(me => me.EventIndex))
+            {
+                switch (moduleReferenceContractLinkEvent.LinkAction)
+                {
+                    case ModuleReferenceContractLinkEvent.ModuleReferenceContractLinkAction.Added:
+                        map[(moduleReferenceContractLinkEvent.ContractAddressIndex, moduleReferenceContractLinkEvent.ContractAddressSubIndex)] = moduleReferenceContractLinkEvent.BlockSlotTime;
+                        break;
+                    case ModuleReferenceContractLinkEvent.ModuleReferenceContractLinkAction.Removed:
+                        map.Remove((moduleReferenceContractLinkEvent.ContractAddressIndex,
+                            moduleReferenceContractLinkEvent.ContractAddressSubIndex));
+                        break;
+                }
+            }
+
+            return map
+                .Select(entry => new LinkedContract(new ContractAddress(entry.Key.Item1, entry.Key.Item2), entry.Value))
+                .OrderByDescending(l => l.LinkedDateTime)
+                .ToList();
+        }
+    }
 }
+
+public record LinkedContract(ContractAddress ContractAddress, DateTimeOffset LinkedDateTime);

backend/Application/Aggregates/Contract/Extensions/ContractExtensions.cs

@@ -51,7 +51,10 @@ internal static IRequestExecutorBuilder AddContractGraphQlConfigurations(this IR
     {
         builder
             .AddType<Entities.Contract.ContractQuery>()
-            .AddTypeExtension<Entities.Contract.ContractExtensions>();
+            .AddTypeExtension<Entities.Contract.ContractExtensions>()
+            .AddType<Entities.ModuleReferenceEvent.ModuleReferenceEventQuery>()
+            .AddTypeExtension<Entities.ModuleReferenceEvent.ModuleReferenceEventExtensions>()
+            .AddTypeExtension<Entities.ModuleReferenceContractLinkEvent.ModuleReferenceContractLinkEventExtensions>();
         return builder;
     }
 

backend/Application/Api/GraphQL/Search/SearchResult.cs

@@ -43,6 +43,22 @@ public IQueryable<Contract> GetContracts(GraphQlDbContext context)
             .ThenByDescending(c => c.ContractAddressSubIndex);
     }
 
+    [UsePaging]
+    public IQueryable<ModuleReferenceEvent> GetModules(GraphQlDbContext context)
+    {
+        if (string.IsNullOrEmpty(_queryString) || !HashRegex.IsMatch(_queryString))
+        {
+            return new List<ModuleReferenceEvent>().AsQueryable();
+        }
+
+        var lowerCaseQuery = _queryString.ToLowerInvariant() + "%";
+        return context.ModuleReferenceEvents.AsNoTracking()
+            .Where(module => EF.Functions.Like(module.ModuleReference, lowerCaseQuery))
+            .OrderByDescending(module => module.BlockHeight)
+            .ThenByDescending(module => module.TransactionIndex)
+            .ThenByDescending(module => module.EventIndex); 
+    }
+
     [UseDbContext(typeof(GraphQlDbContext))]
     [UsePaging]
     public IQueryable<Block> GetBlocks([ScopedService] GraphQlDbContext dbContext)

backend/CHANGELOG.md

@@ -5,8 +5,9 @@
     - Duration of GraphQL endpoints
 - Added health checks, where application goes into degraded state if some job stops running. These health checks are now making endpoint `rest/health` redundant and it is removed.
 - Added GraphQL endpoints
-    - Contract listing with pagination
-- Extended search functionality to include contracts.
+    - Contract listing with pagination and details page.
+    - Module details page.
+- Extended search functionality to include contracts and modules.
 - Updated
     - `HotChocolate` nuget libraries from major `12` to `13`. Because of this done some migration changes like adding `RegisterDbContext<GraphQlDbContext>(DbContextKind.Pooled)` 
     to GraphQL schema configuration *(migration documentation located at: https://chillicream.com/docs/hotchocolate/v13/migrating/migrate-from-12-to-13)*.

backend/Tests/Aggregates/Contract/Entities/ModuleReferenceEventTests.cs

@@ -0,0 +1,73 @@
+using System.Collections.Generic;
+using Application.Aggregates.Contract.Entities;
+using Application.Api.GraphQL;
+using FluentAssertions;
+using Tests.TestUtilities.Builders;
+
+namespace Tests.Aggregates.Contract.Entities;
+
+public sealed class ModuleReferenceEventTests
+{
+    [Fact]
+    public void WhenGetLinkedContract_ThenReturnThoseWhichHasNotBeenRemoved()
+    {
+        // Arrange
+        var contractFirst = new ContractAddress(1, 0);
+        var contractSecond = new ContractAddress(2, 0);
+        var contractThird = new ContractAddress(3, 0);
+        const string moduleReference = "fooBart";
+        var firstEvent = ModuleReferenceContractLinkEventBuilder.Create()
+            .WithBlockHeight(1)
+            .WithTransactionIndex(0)
+            .WithEventIndex(0)
+            .WithLinkAction(ModuleReferenceContractLinkEvent.ModuleReferenceContractLinkAction.Added)
+            .WithModuleReference(moduleReference)
+            .WithContractAddress(contractFirst)
+            .Build();
+        var secondEvent = ModuleReferenceContractLinkEventBuilder.Create()
+            .WithBlockHeight(1)
+            .WithTransactionIndex(1)
+            .WithEventIndex(0)
+            .WithLinkAction(ModuleReferenceContractLinkEvent.ModuleReferenceContractLinkAction.Added)
+            .WithModuleReference(moduleReference)
+            .WithContractAddress(contractSecond)
+            .Build();
+        var thirdEvent = ModuleReferenceContractLinkEventBuilder.Create()
+            .WithBlockHeight(2)
+            .WithTransactionIndex(0)
+            .WithEventIndex(0)
+            .WithLinkAction(ModuleReferenceContractLinkEvent.ModuleReferenceContractLinkAction.Removed)
+            .WithModuleReference(moduleReference)
+            .WithContractAddress(contractFirst)
+            .Build();
+        var fourthEvent = ModuleReferenceContractLinkEventBuilder.Create()
+            .WithBlockHeight(2)
+            .WithTransactionIndex(0)
+            .WithEventIndex(1)
+            .WithLinkAction(ModuleReferenceContractLinkEvent.ModuleReferenceContractLinkAction.Added)
+            .WithModuleReference(moduleReference)
+            .WithContractAddress(contractThird)
+            .Build();
+        var fifthEvent = ModuleReferenceContractLinkEventBuilder.Create()
+            .WithBlockHeight(2)
+            .WithTransactionIndex(0)
+            .WithEventIndex(2)
+            .WithLinkAction(ModuleReferenceContractLinkEvent.ModuleReferenceContractLinkAction.Removed)
+            .WithModuleReference(moduleReference)
+            .WithContractAddress(contractThird)
+            .Build();
+        var moduleReferenceContractLinkEvents = new List<ModuleReferenceContractLinkEvent>{firstEvent, secondEvent, thirdEvent, fourthEvent, fifthEvent};
+        var moduleReferenceEvent = ModuleReferenceEventBuilder.Create()
+            .WithModuleReferenceContractLinkEvent(moduleReferenceContractLinkEvents)
+            .WithModuleReference(moduleReference)
+            .Build();
+        var moduleReferenceEventExtensions = new ModuleReferenceEvent.ModuleReferenceEventExtensions();
+
+        // Act
+        var linkedContracts = moduleReferenceEventExtensions.GetLinkedContracts(moduleReferenceEvent);
+
+        // Assert
+        linkedContracts.Count.Should().Be(1);
+        linkedContracts[0].ContractAddress.Index.Should().Be(contractSecond.Index);
+    }
+}

backend/Tests/Api/GraphQL/__snapshots__/committed-schema.verified.graphql

@@ -1202,6 +1202,31 @@ type LeverageFactor {
   denominator: UnsignedLong!
 }
 
+type LinkedContract {
+  contractAddress: ContractAddress!
+  linkedDateTime: DateTime!
+}
+
+"A connection to a list of items."
+type LinkedContractsConnection {
+  "Information to aid in pagination."
+  pageInfo: PageInfo!
+  "A list of edges."
+  edges: [LinkedContractsEdge!]
+  "A flattened list of the nodes."
+  nodes: [LinkedContract!]
+  "Identifies the total count of items in the connection."
+  totalCount: Int!
+}
+
+"An edge in a connection."
+type LinkedContractsEdge {
+  "A cursor for use in pagination."
+  cursor: String!
+  "The item at the end of the edge."
+  node: LinkedContract!
+}
+
 type MicroCcdPerEuroChainUpdatePayload {
   exchangeRate: ExchangeRate!
 }
@@ -1266,6 +1291,92 @@ type ModuleReferenceContractLinkEvent {
   source: ImportSource!
   blockSlotTime: DateTime!
   createdAt: DateTime!
+  contractAddress: ContractAddress!
+}
+
+"A connection to a list of items."
+type ModuleReferenceContractLinkEventsConnection {
+  "Information to aid in pagination."
+  pageInfo: PageInfo!
+  "A list of edges."
+  edges: [ModuleReferenceContractLinkEventsEdge!]
+  "A flattened list of the nodes."
+  nodes: [ModuleReferenceContractLinkEvent!]
+  "Identifies the total count of items in the connection."
+  totalCount: Int!
+}
+
+"An edge in a connection."
+type ModuleReferenceContractLinkEventsEdge {
+  "A cursor for use in pagination."
+  cursor: String!
+  "The item at the end of the edge."
+  node: ModuleReferenceContractLinkEvent!
+}
+
+type ModuleReferenceEvent {
+  eventIndex: UnsignedInt!
+  moduleReference: String!
+  sender: AccountAddress!
+  moduleReferenceContractLinkEvents("Returns the first _n_ elements from the list." first: Int "Returns the elements in the list that come after the specified cursor." after: String "Returns the last _n_ elements from the list." last: Int "Returns the elements in the list that come before the specified cursor." before: String): ModuleReferenceContractLinkEventsConnection
+  moduleReferenceRejectEvents("Returns the first _n_ elements from the list." first: Int "Returns the elements in the list that come after the specified cursor." after: String "Returns the last _n_ elements from the list." last: Int "Returns the elements in the list that come before the specified cursor." before: String): ModuleReferenceRejectEventsConnection
+  blockHeight: UnsignedLong!
+  transactionHash: String!
+  transactionIndex: UnsignedLong!
+  source: ImportSource!
+  blockSlotTime: DateTime!
+  createdAt: DateTime!
+  linkedContracts("Returns the first _n_ elements from the list." first: Int "Returns the elements in the list that come after the specified cursor." after: String "Returns the last _n_ elements from the list." last: Int "Returns the elements in the list that come before the specified cursor." before: String): LinkedContractsConnection
+}
+
+type ModuleReferenceRejectEvent {
+  moduleReference: String!
+  sender: AccountAddress!
+  rejectedEvent: TransactionRejectReason!
+  blockHeight: UnsignedLong!
+  transactionHash: String!
+  transactionIndex: UnsignedLong!
+  source: ImportSource!
+  blockSlotTime: DateTime!
+  createdAt: DateTime!
+}
+
+"A connection to a list of items."
+type ModuleReferenceRejectEventsConnection {
+  "Information to aid in pagination."
+  pageInfo: PageInfo!
+  "A list of edges."
+  edges: [ModuleReferenceRejectEventsEdge!]
+  "A flattened list of the nodes."
+  nodes: [ModuleReferenceRejectEvent!]
+  "Identifies the total count of items in the connection."
+  totalCount: Int!
+}
+
+"An edge in a connection."
+type ModuleReferenceRejectEventsEdge {
+  "A cursor for use in pagination."
+  cursor: String!
+  "The item at the end of the edge."
+  node: ModuleReferenceRejectEvent!
+}
+
+"A connection to a list of items."
+type ModulesConnection {
+  "Information to aid in pagination."
+  pageInfo: PageInfo!
+  "A list of edges."
+  edges: [ModulesEdge!]
+  "A flattened list of the nodes."
+  nodes: [ModuleReferenceEvent!]
+}
+
+"An edge in a connection."
+type ModulesEdge {
+  "A cursor for use in pagination."
+  cursor: String!
+  "The item at the end of the edge."
+  node: ModuleReferenceEvent!
 }
 
 type NewEncryptedAmount {
@@ -1631,6 +1742,7 @@ type Query {
   nodeStatus(id: ID!): NodeStatus
   contract(contractAddressIndex: UnsignedLong! contractAddressSubIndex: UnsignedLong!): Contract
   contracts("Returns the first _n_ elements from the list." first: Int "Returns the elements in the list that come after the specified cursor." after: String "Returns the last _n_ elements from the list." last: Int "Returns the elements in the list that come before the specified cursor." before: String): ContractsConnection
+  moduleReferenceEvent(moduleReference: String!): ModuleReferenceEvent
 }
 
 type Ranking {
@@ -1711,6 +1823,7 @@ type ScheduledSelfTransfer {
 
 type SearchResult {
   contracts("Returns the first _n_ elements from the list." first: Int "Returns the elements in the list that come after the specified cursor." after: String "Returns the last _n_ elements from the list." last: Int "Returns the elements in the list that come before the specified cursor." before: String): ContractsConnection
+  modules("Returns the first _n_ elements from the list." first: Int "Returns the elements in the list that come after the specified cursor." after: String "Returns the last _n_ elements from the list." last: Int "Returns the elements in the list that come before the specified cursor." before: String): ModulesConnection
   blocks("Returns the first _n_ elements from the list." first: Int "Returns the elements in the list that come after the specified cursor." after: String "Returns the last _n_ elements from the list." last: Int "Returns the elements in the list that come before the specified cursor." before: String): BlocksConnection
   transactions("Returns the first _n_ elements from the list." first: Int "Returns the elements in the list that come after the specified cursor." after: String "Returns the last _n_ elements from the list." last: Int "Returns the elements in the list that come before the specified cursor." before: String): TransactionsConnection
   accounts("Returns the first _n_ elements from the list." first: Int "Returns the elements in the list that come after the specified cursor." after: String "Returns the last _n_ elements from the list." last: Int "Returns the elements in the list that come before the specified cursor." before: String): AccountsConnection