gmsm/slhdsa/xmss.go
2025-05-22 15:47:56 +08:00

76 lines
2.7 KiB
Go

// Copyright 2025 Sun Yimin. All rights reserved.
// Use of this source code is governed by a MIT-style
// license that can be found in the LICENSE file.
//go:build go1.24
package slhdsa
// xmssNode computes the root of a Merkle subtree of WOTS public keys.
//
// See FIPS 205 Algorithm 9 xmss_node
func (sk *PrivateKey) xmssNode(out, tmpBuf []byte, i, z uint32, adrs adrsOperations) {
if z == 0 { // height 0
// if the subtree is the root of a subtree, then it simply returns the value of the node's WORTS+ public key
adrs.setTypeAndClear(AddressTypeWOTSHash)
adrs.setKeyPairAddress(i)
sk.wotsPkGen(out, tmpBuf, adrs)
} else {
// otherwise, it computes the root of the subtree by hashing the two child nodes
var lnode, rnode [MAX_N]byte
sk.xmssNode(lnode[:], tmpBuf, 2*i, z-1, adrs)
sk.xmssNode(rnode[:], tmpBuf, 2*i+1, z-1, adrs)
adrs.setTypeAndClear(AddressTypeTree)
adrs.setTreeHeight(z)
adrs.setTreeIndex(i)
sk.h.h(&sk.PublicKey, adrs, lnode[:], rnode[:], out)
}
}
// xmssSign generates an XMSS signature on an n-byte message by
// creating an authentication path and signing message with the appropriate WORTS+ key.
//
// See FIPS 205 Algorithm 10 xmss_sign
func (sk *PrivateKey) xmssSign(msg, tmpBuf []byte, leafIdx uint32, adrs adrsOperations, signature []byte) {
// build auth path, the auth path consists of the sibling nodes of each node that is on the path from the WOTS+ key used to the root
authStart := sk.params.n * sk.params.len
authPath := signature[authStart:]
leafIdxCopy := leafIdx
for j := range sk.params.hm {
sk.xmssNode(authPath, tmpBuf, leafIdx^1, j, adrs)
authPath = authPath[sk.params.n:]
leafIdx >>= 1
}
// compute WOTS+ signature
adrs.setTypeAndClear(AddressTypeWOTSHash)
adrs.setKeyPairAddress(leafIdxCopy)
sk.wotsSign(msg, adrs, signature)
}
// xmssPkFromSig computes an XMSS public key from an XMSS signature.
//
// See FIPS 205 Algorithm 11 xmss_pkFromSig
func (pk *PublicKey) xmssPkFromSig(leafIdx uint32, signature, msg, tmpBuf []byte, adrs adrsOperations, out []byte) {
// compute WOTS pk from WOTS signature
adrs.setTypeAndClear(AddressTypeWOTSHash)
adrs.setKeyPairAddress(leafIdx)
pk.wotsPkFromSig(signature, msg, tmpBuf, adrs, out)
// compute root from WOTS pk and AUTH path
adrs.setTypeAndClear(AddressTypeTree)
signature = signature[pk.params.len*pk.params.n:] // auth path
for k := range pk.params.hm {
adrs.setTreeHeight(k + 1)
if leafIdx&1 == 0 { // even
leafIdx >>= 1
adrs.setTreeIndex(leafIdx)
pk.h.h(pk, adrs, out, signature, out)
} else { // odd
leafIdx = (leafIdx - 1) >> 1
adrs.setTreeIndex(leafIdx)
pk.h.h(pk, adrs, signature, out, out)
}
signature = signature[pk.params.n:]
}
}