feat: add core Neo smart contract deployment framework #1351

Jim8y · 2025-07-09T09:16:59Z

Summary

This PR establishes the foundational deployment infrastructure for Neo smart contracts, providing a clean, extensible API for deployment operations.

Key Features

✅ DeploymentToolkit class with basic deployment API structure
✅ Network configuration support (mainnet, testnet, local, custom RPC)
✅ WIF key support for transaction signing with validation
✅ Comprehensive project structure with interfaces and models
✅ Configuration management with JSON files and environment variables
✅ 16 unit tests covering all basic functionality
✅ Documentation updates with usage examples

Implementation Highlights

Interface-based design for excellent testability and modularity
Follows established .NET patterns and conventions
Comprehensive error handling and validation
Clean separation of concerns between models, services, and interfaces

Files Added

src/Neo.SmartContract.Deploy/ - Complete project structure
tests/Neo.SmartContract.Deploy.UnitTests/ - Comprehensive test suite
Updated solution file and README documentation

Dependencies

This PR has no dependencies and establishes the foundation for future deployment features.

Testing

✅ All 16 unit tests pass
✅ Solution builds successfully
✅ No breaking changes to existing functionality

This PR creates a solid foundation that will be extended with full implementation in subsequent PRs.

* SafeAttribute supports in properties * Update Nep11Token.cs * Safe setters are not allowed

- Add DeploymentToolkit class with basic deployment API - Implement network configuration support (mainnet, testnet, local, custom RPC) - Add WIF key support for transaction signing - Create comprehensive project structure with interfaces and models - Add configuration management with JSON and environment variable support - Include 16 unit tests covering all basic functionality - Update README.md with deployment documentation and usage examples This establishes the foundation for Neo smart contract deployment capabilities without implementation details, providing a clean base for future enhancements.

…rence - Fix whitespace formatting issues in deployment toolkit files - Add missing final newlines to all source files - Remove duplicate Microsoft.NET.Test.Sdk package reference in test project - All 16 unit tests continue to pass - Code formatting now passes GitHub Actions checks

neo-devpack-dotnet.sln

shargon · 2025-07-09T11:19:22Z

src/Neo.SmartContract.Deploy/Models/NetworkConfiguration.cs

+    /// <summary>
+    /// Network magic number for transaction signing
+    /// </summary>
+    public uint NetworkMagic { get; set; } = 894710606; // Default to testnet


Can this be retrieved from the rpc?

shargon · 2025-07-09T11:19:50Z

src/Neo.SmartContract.Deploy/Models/NetworkConfiguration.cs

+    /// <summary>
+    /// Network name (private, testnet, mainnet)
+    /// </summary>
+    public string Network { get; set; } = string.Empty;


It depend to the RpcUrl, isn't it?

shargon · 2025-07-09T11:20:19Z

src/Neo.SmartContract.Deploy/Neo.SmartContract.Deploy.csproj

+  <ItemGroup>
+    <Compile Update="**/*.cs">
+      <Pack>true</Pack>
+      <PackagePath>src</PackagePath>
+    </Compile>
+  </ItemGroup>


That's required?

- Remove Network property from NetworkConfiguration as it depends on RpcUrl - Change NetworkMagic to nullable and retrieve from RPC when not configured - Add logic to fetch NetworkMagic from RPC using GetVersionAsync() - Remove unnecessary Compile Update section from csproj file - Update unit tests to match new behavior

- Add tests to verify network magic can be retrieved from RPC - Add tests for network configuration priority (specific > global > RPC) - Add tests for SetNetwork with various inputs and edge cases - Add tests to ensure proper RPC URL configuration for known networks - Document expected network magic values for mainnet and testnet

- Change testnet RPC URL from testnet1.neo.coz.io to testnet.rpc.ngd.network - Update all test assertions to use the new NGD testnet URL - Add integration tests to verify RPC connectivity (skipped by default) - Ensure network magic retrieval works with NGD testnet endpoint

- Change from testnet.rpc.ngd.network to testnet.ngd.network - Update all test assertions to use the correct URL

- Change testnet RPC URL to http://seed2t5.neo.org:20332 - Update all test assertions to use the Neo seed node URL - Update integration test names to reflect Neo testnet

vncoelho

Hi @Jim8y

My suggestion is that if this is able to Deploy and test, so, the examples we have here should be deployed during tests and we could verify states.
That would be a good test that has a real flow behind.

On the other hand, I see some separation between this repo and the framework being pushed here.

Jim8y · 2025-07-09T15:55:35Z

Hi @Jim8y

My suggestion is that if this is able to Deploy and test, so, the examples we have here should be deployed during tests and we could verify states. That would be a good test that has a real flow behind.

On the other hand, I see some separation between this repo and the framework being pushed here.

its hard to balance, smaller prs for easier to review, but lacks complete functionality, complete tookit too large for reviewing. yet if you wish to review as a whole, you can check the full pr. bellow is the deployed example contracts on testnet.

Latest Deployment (TestNet)

Contract	Address	Transaction Hash	Network
TokenContract	`0x2db2dce76b4a7f8116ecfae0d819e7099cb3a256`	`0x29397173e0e5ad93010f721ff6f786171e32e84f9bc44067072df332853e9554`	TestNet
NFTContract	`0x8699c5d074fc27cdbd7caec486387c1a29300536`	`0xc0b8c4b7dd68525da2adc39455252f32ac884947aeaba387c6ce20fa017952b7`	TestNet
GovernanceContract	`0xa3db58df3764610e43f3fda0c7b8633636c6c147`	`0x43d4a849396ddaf6b9917a3aeb30e49929a15fa32ebf51b1ab4b2d9e46dcf5a8`	TestNet

Deployment Details:

Deployer Address: NTmHjwiadq4g3VHpJ5FQigQcD4fF5m8TyX (0x0c3146e78efc42bfb7d4cc2e06e3efd063c01c56)
Network: NEO TestNet
RPC Endpoint: https://testnet1.neo.coz.io:443
Total GAS Consumed: ~30.00233163 GAS
Deployment Mode: Multi-contract with dependencies

vncoelho · 2025-07-09T15:57:45Z

I see @Jim8y, but why this needed to be here in Devpack?
Isn't this focussed on the C# compiler.

What I see in this pr is like a framework for interacting with the blockchain.

vncoelho · 2025-07-09T15:58:08Z

I see @Jim8y, but why this needed to be here in Devpack? Isn't this focussed on the C# compiler.

What I see in this pr is like a framework for interacting with the blockchain.

Maybe even the Core itself is better than here

Jim8y · 2025-07-09T15:59:57Z

I see @Jim8y, but why this needed to be here in Devpack? Isn't this focussed on the C# compiler.
What I see in this pr is like a framework for interacting with the blockchain.

Maybe even the Core itself is better than here

implementing, testing, deploying is a complete workflow, with this, developer can do everfything easily all together. they dont need to download and install and sync neo-cli, or searching for some unknown deployment methods. All of these is for a better development experience.

Jim8y · 2025-07-11T13:53:14Z

@shargon all your concern and suggestion have being resolved.

shargon · 2025-07-13T10:58:14Z

src/Neo.SmartContract.Deploy/DeploymentToolkit.cs

+/// </summary>
+public class DeploymentToolkit : IDisposable
+{
+    private const string GAS_CONTRACT_HASH = "0xd2a4cff31913016155e38e474a2c06d08be276cf";


Take the hash from the NativeContract Instance?

shargon · 2025-07-13T10:58:45Z

src/Neo.SmartContract.Deploy/Models/NetworkConfiguration.cs

+/// <summary>
+/// Wallet configuration settings
+/// </summary>
+public class WalletConfiguration


One class per file please

tests/Neo.SmartContract.Deploy.UnitTests/RpcIntegrationTests.cs

shargon · 2025-07-13T11:01:23Z

tests/Neo.SmartContract.Deploy.UnitTests/DeploymentToolkitTests.cs

+        var tempDir = Path.Combine(Path.GetTempPath(), Guid.NewGuid().ToString());
+        Directory.CreateDirectory(tempDir);
+        var contractPath = Path.Combine(tempDir, "TestContract.cs");
+        File.WriteAllText(contractPath, contractCode);


The UT that create a file, should delete the file after the test

src/Neo.SmartContract.Deploy/Shared/ScriptBuilderHelper.cs

Co-authored-by: Shargon <[email protected]>

…ffolding; add DeploymentArtifactsDemo example; fix RpcStore OnNewSnapshot; docs update

ajara87 · 2025-09-10T18:57:32Z

examples/DeploymentArtifactsDemo/Program.cs

+{
+    if (!doCall)
+    {
+        if (string.IsNullOrEmpty(wif) || string.IsNullOrEmpty(nef) || string.IsNullOrEmpty(manifest))


if (string.IsNullOrWhiteSpace(wif) || string.IsNullOrWhiteSpace(nef) || string.IsNullOrWhiteSpace(manifest))

ajara87 · 2025-09-10T18:59:46Z

examples/DeploymentArtifactsDemo/Program.cs

+    }
+    else
+    {
+        if (string.IsNullOrEmpty(contract) || string.IsNullOrEmpty(method))


if (string.IsNullOrWhiteSpace(contract) || string.IsNullOrWhiteSpace(method))

ajara87 · 2025-09-10T19:00:55Z

examples/DeploymentArtifactsDemo/Program.cs

+        }
+
+        object[] callArgs = Array.Empty<object>();
+        if (!string.IsNullOrEmpty(argsJson))


if (!string.IsNullOrWhiteSpace(argsJson))

shargon · 2025-09-12T09:55:51Z

@Jim8y Could you solve the conflicts?

…mples/Directory.Build.props and RpcStore; apply IsNullOrWhiteSpace in DeploymentArtifactsDemo

…support

erikzhang and others added 2 commits June 16, 2025 21:35

SafeAttribute supports in properties (#1330)

6375fe6

* SafeAttribute supports in properties * Update Nep11Token.cs * Safe setters are not allowed

Jim8y mentioned this pull request Jul 9, 2025

feat: implement full Neo smart contract deployment functionality #1352

Closed

Jim8y force-pushed the pr1-core-deployment-framework branch from 2f05ca7 to ce28e18 Compare July 9, 2025 11:00

chore: update neo submodule to latest commit

ef94799

Jim8y force-pushed the pr1-core-deployment-framework branch from ce28e18 to ef94799 Compare July 9, 2025 11:06

shargon reviewed Jul 9, 2025

View reviewed changes

Jim8y added 8 commits July 9, 2025 21:07

fix: resolve code formatting issues

9e3ef8d

fix: correct NGD testnet RPC URL

7ae2d02

- Change from testnet.rpc.ngd.network to testnet.ngd.network - Update all test assertions to use the correct URL

chore: update testnet RPC URL to Neo seed node

877d6ef

- Change testnet RPC URL to http://seed2t5.neo.org:20332 - Update all test assertions to use the Neo seed node URL - Update integration test names to reflect Neo testnet

docs: add PR #1 test summary

eca436b

fix: resolve code formatting issues in test files

992f18e

vncoelho reviewed Jul 9, 2025

View reviewed changes

shargon reviewed Jul 13, 2025

View reviewed changes

Jim8y and others added 7 commits July 17, 2025 14:11

Update src/Neo.SmartContract.Deploy/Shared/ScriptBuilderHelper.cs

2f2f1ab

Co-authored-by: Shargon <[email protected]>

Update src/Neo.SmartContract.Deploy/Shared/ScriptBuilderHelper.cs

de026c3

Co-authored-by: Shargon <[email protected]>

Update src/Neo.SmartContract.Deploy/Shared/ScriptBuilderHelper.cs

12def91

Co-authored-by: Shargon <[email protected]>

Update src/Neo.SmartContract.Deploy/Shared/ScriptBuilderHelper.cs

630a3a3

Co-authored-by: Shargon <[email protected]>

Update src/Neo.SmartContract.Deploy/Shared/ScriptBuilderHelper.cs

ce8ccdd

Co-authored-by: Shargon <[email protected]>

Update src/Neo.SmartContract.Deploy/Shared/ScriptBuilderHelper.cs

cb776b7

Co-authored-by: Shargon <[email protected]>

Update tests/Neo.SmartContract.Deploy.UnitTests/RpcIntegrationTests.cs

da96daf

Co-authored-by: Shargon <[email protected]>

superboyiii mentioned this pull request Jul 24, 2025

v3.9.0 Checklist neo-project/neo#4091

Open

feat(deploy): implement minimal artifact deployment + calls; trim sca…

92cbba3

…ffolding; add DeploymentArtifactsDemo example; fix RpcStore OnNewSnapshot; docs update

ajara87 requested changes Sep 10, 2025

View reviewed changes

shargon changed the base branch from master to dev September 12, 2025 09:44

Jim8y and others added 4 commits September 22, 2025 20:54

Merge dev: update neo submodule to 8afce406; resolve conflicts in exa…

3e74910

…mples/Directory.Build.props and RpcStore; apply IsNullOrWhiteSpace in DeploymentArtifactsDemo

feat(deploy): add configurable toolkit with compilation and manifest …

18daa75

…support

chore: switch mainnet rpc default to coz endpoint

1dfe05d

Merge branch 'dev' into pr1-core-deployment-framework

8d46f2e

feat: add core Neo smart contract deployment framework #1351

Are you sure you want to change the base?

feat: add core Neo smart contract deployment framework #1351

Uh oh!

Conversation

Jim8y commented Jul 9, 2025

Summary

Key Features

Implementation Highlights

Files Added

Dependencies

Testing

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

vncoelho left a comment

Choose a reason for hiding this comment

Uh oh!

Jim8y commented Jul 9, 2025

Latest Deployment (TestNet)

Uh oh!

vncoelho commented Jul 9, 2025

Uh oh!

vncoelho commented Jul 9, 2025

Uh oh!

Jim8y commented Jul 9, 2025

Uh oh!

Jim8y commented Jul 11, 2025

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

shargon commented Sep 12, 2025

Uh oh!

Uh oh!