Adds message signing to wallet by adrian-fjellberg · Pull Request #4286 · neo-project/neo

adrian-fjellberg · 2025-11-07T12:14:58Z

Adds the ability to sign arbitrary messages using wallet accounts. The user can specify the elliptic curve to use for signing (secp256r1 or secp256k1). It generates a payload using salt and the provided message, then signs the payload with each available wallet account, displaying the address, public key, salt and signature.

Description

This PR introduces a new sign_message command to the Neo CLI, enabling message signing outside of transactions.
Previously, the CLI only supported signing serialized transaction data, which made it impossible to produce verifiable message signatures for use in external applications, authentication workflows, or dApp integrations.

With this change, users can now easily sign and verify arbitrary messages directly from their local wallet.

Change Log

Added the "sign_message" command to the Neo CLI.
Changed Neo.CLI.MainService to implement the "sign_message" command.
Added optional curve parameter (supports secp256r1 and secp256k1)
Implemented payload creation using salt + message for improved uniqueness

Fixes #4285

Type of change

Optimization (the change is only an optimization)
Style (the change is only a code style for better maintenance or standard purpose)
Bug fix (non-breaking change which fixes an issue)
New feature (non-breaking change which adds functionality)
Breaking change (fix or feature that would cause existing functionality to not work as expected)
This change requires a documentation update

How Has This Been Tested?

Unit Testing
Run Application: manually tested sign_message on local CLI with both curves
Local Computer Tests
No Testing

Checklist:

My code follows the style guidelines of this project
I have performed a self-review of my code
I have commented my code, particularly in hard-to-understand areas
I have made corresponding changes to the documentation
My changes generate no new warnings
I have added tests that prove my fix is effective or that my feature works
New and existing unit tests pass locally with my changes
Any dependent changes have been merged and published in downstream modules

Adds the ability to sign arbitrary messages using wallet accounts. The user can specify the elliptic curve to use for signing (secp256r1 or secp256k1). It generates a payload using salt and the provided message, then signs the payload with each available wallet account, displaying the address, public key, salt and signature.

src/Neo.CLI/CLI/MainService.Wallet.cs

Jim8y · 2025-11-08T01:00:55Z

src/Neo.CLI/CLI/MainService.Wallet.cs

+                var signature = Crypto.Sign(payload, key.PrivateKey, selectedCurve);
+
+                ConsoleHelper.Info("Address: ", account.Address);
+                ConsoleHelper.Info("  PublicKey: ", key.PublicKey.EncodePoint(true).ToHexString());


we dont really support secp256k1, the key you get is still p-256 pubkey.

Ok. I think I saw in the code for Crypto.Sign that both were supported so that is why I added it.

Do you want me tor remove the option to select curve and only use secp256r1?

We need a structured format that specifies the address, public key, and algorithm for signing. This also facilitates verification.

Some questions:

Should we require the user specifiy either the public key or address for signing?

If yes to question 1: If there is only one address in the open wallet, could we default to using this one? I think this will make signing more user friendly.

For specifing the algorithim, do you mean the curve or padding, salt, etc.? Or both?

Can we provide defaults for each option so that the command become user friendly?

I mean we need to define an output format including address, public key, and algorithm of the signature.

Latest commit includes the algorithm and curve used + some helpful text and link to documentation on how to verify the generated signatures.

@erikzhang, is this what you wanted?

Or did you want a stuctured format in terms of JSON or YAML?

Or did you want us to define a standard for the padding and salting?

I want a standard with json format please.

@erikzhang I made a draft: neo-project/proposals#210

Jim8y · 2025-11-08T01:27:46Z

src/Neo.CLI/CLI/MainService.Wallet.cs

+                w.Write((byte)0x01);
+                w.Write((byte)0x00);
+                w.Write((byte)0x01);
+                w.Write((byte)0xF0);
+                w.WriteVarBytes(paramBytes);
+                w.Write((ushort)0);
+                w.Flush();


what is the meaning of this script, some standard?

Yes, could you clarify it @adrian-fjellberg

It is to ensure that the message is not also a valid NEO transaction. I do not think it is a defined standard but it is the way both NEON wallet and NeoLine signs messages.

Do you want me to add comments to the code to clearify?

I see, its just some prefix.

I can add comments to the code.

Comments added in the latest commit.

adrian-fjellberg · 2025-11-08T12:07:23Z

I also started on documenting the command line feature:
https://github.com/adrian-fjellberg/neo-dev-portal/blob/feature/sign-message-cli-docs/docs/n3/node/cli/cli.md#sign_message

Refactors the `sign message` command to: - allow only signing only using the secp256r1 curve. - output the algorithm used to create the payload - output guide on how to verify the signed message Renames the `sign` command to `sign transaction` to avoid ambiguous calls with the new `sign message` command. Refactors the `OnCommand` method on the ConsoleServiceBase class so that parsing of arguments are differed to later in the execution. This is to solve an issue that occurs when ambiguous calls occur, one method might output errors in when parsing of arguments.

…message-sign' into feature/cli-arbitrary-message-sign

Wi1l-B0t · 2025-11-10T12:55:39Z

src/Neo.CLI/CLI/MainService.Wallet.cs

-        /// <param name="jsonObjectToSign">Json object to sign</param>
-        [ConsoleCommand("sign", Category = "Wallet Commands")]
+        /// <param name="jsonObjectToSign">The json string that records the transaction information</param>
+        [ConsoleCommand("sign transaction", Category = "Wallet Commands")]


sign tx is shorter.

Agreed. Fixed 👍

superboyiii · 2025-11-11T02:58:12Z

Is this armed for Neo4 or next release? @adrian-fjellberg

superboyiii · 2025-11-11T03:06:07Z

master is now only for Neo N4, master-n3 is for N3, dev is for N3 dev. So I guess you want to merge it into next release. It's better to change to dev. @adrian-fjellberg

erikzhang · 2025-11-11T03:28:47Z

dev is not used anymore.

adrian-fjellberg · 2025-11-11T10:03:41Z

master is now only for Neo N4, master-n3 is for N3, dev is for N3 dev. So I guess you want to merge it into next release. It's better to change to dev. @adrian-fjellberg

As fast as possilbe beacuse it will be important for nodes to be able to do offline signing in a secure way to claim candidate roles in the new Goevernance platform set to be released soon.

So I should change to master-n3 as per @erikzhang comment then?

shargon · 2025-11-11T10:07:55Z

src/Neo.CLI/CLI/MainService.Wallet.cs

+            using (var w = new BinaryWriter(ms, Encoding.UTF8, true))
+            {
+                // We add these 4 bytes to prevent the signature from being a valid transaction
+                w.Write((byte)0x01);


I would like to follow something like the https://www.cyfrin.io/blog/understanding-ethereum-signature-standards-eip-191-eip-712, domain separator it's important to avoid signature replays between different chains, like testnet and mainnet

neo/src/Neo/Network/P2P/Helper.cs

Lines 71 to 88 in ac7ebab

public static byte[] GetSignData(this IVerifiable verifiable, uint network)

{

/* Same as:

using MemoryStream ms = new();

using BinaryWriter writer = new(ms);

writer.Write(network);

writer.Write(verifiable.Hash);

writer.Flush();

return ms.ToArray();

*/

var buffer = new byte[SignDataLength];

BinaryPrimitives.WriteUInt32LittleEndian(buffer, network);

verifiable.Hash.Serialize(buffer.AsSpan(sizeof(uint)));

return buffer;

}

@adrian-fjellberg we should call this method, let me add some changes. Also this PR should be moved now to https://github.com/neo-project/neo-node

adrian-fjellberg · 2025-11-11T11:35:23Z

I only need the posibilty for nodes to sign an arbitrary message... We get 100% value from the current implementation. It satisfies all the needs of the reason behind the proposed change.

The value is:

Nodes get to claim their seat in the new Governance platform.
New canidates now have a way to sign messages when they are registering from the CLI rather from a wallet.

Wi1l-B0t · 2025-11-12T11:14:38Z

The Neo.Cli has already been moved to the neo-node.

superboyiii · 2025-11-26T03:09:32Z

@adrian-fjellberg No CLI in Neo master now. This need push to https://github.com/neo-project/neo-node/tree/master-n3

ajara87 · 2025-11-26T06:49:07Z

Porting to neo-node on master-n3 on PR: neo-project/neo-node#924

shargon · 2026-02-10T11:18:11Z

Moved to neo-project/neo-node#924

Wi1l-B0t reviewed Nov 7, 2025

View reviewed changes

src/Neo.CLI/CLI/MainService.Wallet.cs Outdated Show resolved Hide resolved

Jim8y reviewed Nov 8, 2025

View reviewed changes

Adrian Fjellberg and others added 4 commits November 8, 2025 14:57

Add comment about padding for the "sign_message" command

642cc9e

Merge branch 'master' into feature/cli-arbitrary-message-sign

3bca0e3

Merge remote-tracking branch 'adrian-fjellberg/feature/cli-arbitrary-…

7ccfbbf

…message-sign' into feature/cli-arbitrary-message-sign

Wi1l-B0t reviewed Nov 10, 2025

View reviewed changes

Wi1l-B0t and others added 2 commits November 10, 2025 20:57

Merge branch 'master' into feature/cli-arbitrary-message-sign

211b2b1

Renamed CLI command "sign transaction" to "sign tx"

bdc9a28

shargon reviewed Nov 11, 2025

View reviewed changes

adrian-fjellberg mentioned this pull request Nov 11, 2025

NEP: Standard for Offline Message Signing and Verification neo-project/proposals#210

Open

shargon mentioned this pull request Nov 11, 2025

Add GetSignData with only UInt256 type #4299

Merged

18 tasks

ajara87 mentioned this pull request Nov 26, 2025

port message sign to master-n3 neo-project/neo-node#924

Merged

roman-khimov mentioned this pull request Dec 11, 2025

wallet sign-msg nspcc-dev/neo-go#4110

Open

cschuchardt88 added Waiting for Review Downstream Needed for downstream repos labels Jan 11, 2026

ixje mentioned this pull request Jan 26, 2026

Discussion: Moving toward a governance model that can actually execute #4411

Open

shargon closed this Feb 10, 2026

Copilot AI mentioned this pull request Mar 10, 2026

wallet: add sign-msg and verify-msg commands (WalletConnect scheme) nspcc-dev/neo-go#4188

Draft

	public static byte[] GetSignData(this IVerifiable verifiable, uint network)
	{
	/* Same as:
	using MemoryStream ms = new();
	using BinaryWriter writer = new(ms);
	writer.Write(network);
	writer.Write(verifiable.Hash);
	writer.Flush();
	return ms.ToArray();
	*/

	var buffer = new byte[SignDataLength];

	BinaryPrimitives.WriteUInt32LittleEndian(buffer, network);
	verifiable.Hash.Serialize(buffer.AsSpan(sizeof(uint)));

	return buffer;
	}

Conversation

adrian-fjellberg commented Nov 7, 2025

Description

Change Log

Type of change

How Has This Been Tested?

Checklist:

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!

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!

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!

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!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

adrian-fjellberg commented Nov 8, 2025

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

superboyiii commented Nov 11, 2025

Uh oh!

superboyiii commented Nov 11, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

erikzhang commented Nov 11, 2025

Uh oh!

adrian-fjellberg commented Nov 11, 2025

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

shargon Nov 11, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

adrian-fjellberg commented Nov 11, 2025

Uh oh!

Wi1l-B0t commented Nov 12, 2025

Uh oh!

superboyiii commented Nov 26, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

ajara87 commented Nov 26, 2025

Uh oh!

shargon commented Feb 10, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

8 participants

superboyiii commented Nov 11, 2025 •

edited

Loading

shargon Nov 11, 2025 •

edited

Loading

superboyiii commented Nov 26, 2025 •

edited

Loading