Add name helpers

CHANGELOG.md

@@ -1,6 +1,8 @@
 ## Unreleased changes
 - Added
   - New GRPC-endpoints: `GetBlocks`, `GetFinalizedBlocks`, `GetBranches`, `GetAncestors`, `GetBlockPendingUpdates`
+  - Added helpers to get new type `ContractIdentifier` on `ReceiveName` and `ContractName`. This new type only holds the contract name part of `ReceiveName` and `ContractName`.
+    Also added helper to get entrypoint on `ReceiveName`.
 
 ## 4.1.0
 - Bugfix

src/Types/ContractIdentifier.cs

@@ -0,0 +1,7 @@
+namespace Concordium.Sdk.Types;
+
+/// <summary>
+/// Contains the identification name of the contract.
+/// </summary>
+/// <param name="ContractName">Name of contract</param>
+public sealed record ContractIdentifier(string ContractName);

src/Types/ContractName.cs

@@ -36,6 +36,12 @@ public static bool TryParse(string name, out (ContractName? ContractName, Valida
         return validate;
     }
 
+    /// <summary>
+    /// Get the contract name part of <see cref="Name"/>.
+    /// </summary>
+    /// <returns>Contract identification name</returns>
+    public ContractIdentifier GetContractName() => new(this.Name[(this.Name.IndexOf('_') + 1)..]);
+
     /// <summary>
     /// Validation error of contract name.
     /// </summary>

src/Types/EntryPoint.cs

@@ -0,0 +1,7 @@
+namespace Concordium.Sdk.Types;
+
+/// <summary>
+/// Entry point on a smart contract.
+/// </summary>
+/// <param name="Name">Entry point name</param>
+public sealed record EntryPoint(string Name);

src/Types/ReceiveName.cs

@@ -34,6 +34,18 @@ public static bool TryParse(string name, out (ReceiveName? ReceiveName, Validati
         return validate;
     }
 
+    /// <summary>
+    /// Get the contract name part of <see cref="Receive"/>.
+    /// </summary>
+    /// <returns>Contract identification name</returns>
+    public ContractIdentifier GetContractName() => new(this.Receive[..this.Receive.IndexOf('.')]);
+
+    /// <summary>
+    /// Get entrypoint part of <see cref="Receive"/> which is the entrypoint called on the contract.
+    /// </summary>
+    /// <returns>Entrypoint</returns>
+    public EntryPoint GetEntrypoint() => new(this.Receive[(this.Receive.IndexOf('.') + 1)..]);
+
     /// <summary>
     /// Validation error of receive name.
     /// </summary>

tests/UnitTests/Types/ContractNameTests.cs

@@ -39,4 +39,19 @@ public void WhenCallingTryParse_ValidatesAndParsesReceiveName(
             initName.Should().BeNull();
         }
     }
+
+    [Fact]
+    public void WhenGetContractNamePart_ThenReturnContractName()
+    {
+        // Arrange
+        const string prefix = "init_";
+        const string expected = "awesome";
+        _ = ContractName.TryParse($"{prefix}{expected}", out var result);
+
+        // Act
+        var actual = result.ContractName!.GetContractName();
+
+        // Assert
+        actual.ContractName.Should().Be(expected);
+    }
 }

tests/UnitTests/Types/ReceiveNameTests.cs

@@ -36,4 +36,36 @@ public void WhenCallingTryParse_ValidatesAndParsesReceiveName(
             receiveName.Should().BeNull();
         }
     }
+
+    [Fact]
+    public void WhenGetContractNamePart_ThenReturnName()
+    {
+        // Arrange
+        const string contractName = "some_contract";
+        const string contractEntrypoint = "some_entrypoint";
+
+        _ = ReceiveName.TryParse($"{contractName}.{contractEntrypoint}", out var result);
+
+        // Act
+        var actual = result.ReceiveName!.GetContractName();
+
+        // Assert
+        actual.ContractName.Should().Be(contractName);
+    }
+
+    [Fact]
+    public void WhenGetEntrypointPart_ThenReturnEntrypoint()
+    {
+        // Arrange
+        const string contractName = "some_contract";
+        const string contractEntrypoint = "some_entrypoint";
+
+        _ = ReceiveName.TryParse($"{contractName}.{contractEntrypoint}", out var result);
+
+        // Act
+        var actual = result.ReceiveName!.GetEntrypoint();
+
+        // Assert
+        actual.Name.Should().Be(contractEntrypoint);
+    }
 }