Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

sign: Adding SLH-DSA signature #512

Open
wants to merge 3 commits into
base: main
Choose a base branch
from

Conversation

armfazh
Copy link
Contributor

@armfazh armfazh commented Sep 11, 2024

This implementation supports the twelve parameter sets approved at FIPS 205

Test vectors match the ones at ACVP-Server version 1.1.0.35. These test vectors only target the internal functions.

Pure and Prehash-based signatures are supported, but no known test vectors are available.

The last commit adds the twelve instances to the generic signing Scheme interface.

Implementation makes a good effort to avoid heap allocations that usually add a significant overhead.

@armfazh
Copy link
Contributor Author

armfazh commented Sep 11, 2024

there is a timeout happening on the ARM build because tests are running in parallel, but it doesn't seems to be related to a failure in the code.

Copy link

@rozbb rozbb left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This looks great! Almost all my comments are nitpicky bc I didn't have anything else to talk about :)

}

// See FIPS 205 -- Section 5 -- Algorithm 5.
func (s *state) chain(x []byte, index, step uint32, addr address) (out []byte) {
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The name step confused me, bc I thought it'd be the step size of the for loop, but it's not. I'd rename to steps or num_steps.

}

// See FIPS 205 -- Section 5.2 -- Algorithm 7.
func (s *statePriv) wotsSign(sig wotsSignature, msg []byte, addr address) {
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

IMO it'd be more natural to return a wotsSignature instead of taking one in. It's not even immediately clear from the type signature that this is a ref.

func (s *statePriv) wotsSign(sig wotsSignature, msg []byte, addr address) {
curSig := cursor(sig)
wotsLen1 := s.wotsLen1()
csum := wotsLen1 * (wotsW - 1)
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I know this is an internal func, but there should be a sanity check here that msg is the correct length (I believe it's 2*wotsLen1)

s.PRF.address.SetTypeAndClear(addressWotsPrf)
s.PRF.address.SetKeyPairAddress(addr.GetKeyPairAddress())

for i := uint32(0); i < wotsLen1; i++ {
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I found it hard to follow what this function was doing. It isn't structured like Alg. 7 at all, so I didn't have a map. More comments would be useful

// See FIPS 205 -- Section 5.3 -- Algorithm 8.
func (s *state) wotsPkFromSig(
sig wotsSignature, msg []byte, addr address,
) wotsPublicKey {
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same notes on previous func (minus the one about returning a sig) apply here

"github.com/cloudflare/circl/internal/test"
)

func testWotsPlus(t *testing.T, p *params) {
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'd rename testWotsPlusCorrectness, since that's the only property it tests. I agree that's enough tho

}

// See FIPS 205 -- Section 6.1 -- Algorithm 9 -- Iterative version.
func (s *statePriv) xmssNodeIter(
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Similar thing. I had trouble following along with this algorithm, since it differs so much from the paper. Also why is i a parameter at all if it's not a recursive algorithm?


// See FIPS 205 -- Section 6.2 -- Algorithm 10.
func (s *statePriv) xmssSign(
stack stackNode, sig xmssSignature, msg []byte, idx uint32, addr address,
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

As before, I think it'd be clearer to return a sig than take one as input. It's also not clear it's a pointer. I think this applies to a lot of functions in this PR

defer s.Clear()

s.forsSign(sig.forsSig, md, addr)
pkFors := s.forsPkFromSig(md, sig.forsSig, addr)
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Would it be possible to compute pkFors as a side effect of forsSign? Can save a few hashes if so. Similarly might be able to do this in the htSign function

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants