X-Git-Url: http://www.git.cypherpunks.ru/?p=gogost.git;a=blobdiff_plain;f=www.texi;h=9607adf38c018b558701a93ae0ff02f445249f47;hp=f532524a776a281be51cfde7d20e90c7744ff9b4;hb=HEAD;hpb=c40d1e5634cf6d540d908a57423f4b504e39f186 diff --git a/www.texi b/www.texi index f532524..deb016d 100644 --- a/www.texi +++ b/www.texi @@ -2,10 +2,8 @@ @documentencoding UTF-8 @settitle GoGOST -@set VERSION 4.2.1 - @copying -Copyright @copyright{} 2015-2020 @email{stargrave@@stargrave.org, Sergey Matveev} +Copyright @copyright{} 2015-2024 @email{stargrave@@stargrave.org, Sergey Matveev} @end copying @node Top @@ -17,7 +15,7 @@ It is @url{https://www.gnu.org/philosophy/pragmatic.html, copylefted} @url{https://www.gnu.org/philosophy/free-sw.html, free software}: licenced under @url{https://www.gnu.org/licenses/gpl-3.0.html, GPLv3}. -You can read about GOST algorithms @url{http://gost.cypherpunks.ru/, more}. +You can read about GOST algorithms @url{http://www.gost.cypherpunks.ru/, more}. Currently supported algorithms are: @@ -51,6 +49,7 @@ Currently supported algorithms are: @item GOST R 34.12-2015 64-bit block cipher Магма (Magma) @item GOST R 34.13-2015 padding methods @item MGM AEAD mode for 64 and 128 bit ciphers + (@url{https://tools.ietf.org/html/rfc9058.html, RFC 9058}) @item TLSTREE keyscheduling function @item ESPTREE/IKETREE (IKE* is the same as ESP*) keyscheduling function @item @code{PRF_IPSEC_PRFPLUS_GOSTR3411_2012_@{256,512@}} and generic @@ -58,13 +57,44 @@ Currently supported algorithms are: @url{https://tools.ietf.org/html/rfc5831.html, RFC 7296}) @end itemize +Probably you could be interested in +@url{//www.gostls13.cypherpunks.ru/, Go's support of GOST TLS 1.3}. + +Example 34.10-2012-256 keypair generation, signing and verifying: + +@verbatim +import ( + "crypto/rand" + "io" + "go.cypherpunks.ru/gogost/v5/gost3410" + "go.cypherpunks.ru/gogost/v5/gost34112012256" +) +func main() { + data := []byte("data to be signed") + hasher := gost34112012256.New() + _, err := hasher.Write(data) + dgst := hasher.Sum(nil) + curve := gost3410.CurveIdtc26gost341012256paramSetB() + prvRaw := make([]byte, 32) + _, err = io.ReadFull(rand.Reader, prvRaw) + prv, err := gost3410.NewPrivateKey(curve, prvRaw) + pub, err := prv.PublicKey() + pubRaw := pub.Raw() + sign, err := prv.Sign(rand.Reader, dgst, nil) + pub, err = gost3410.NewPublicKey(curve, pubRaw) + isValid, err := pub.VerifyDigest(dgst, sign) + if !isValid { panic("signature is invalid") } +} +@end verbatim + Please send questions, bug reports and patches to -@url{https://lists.cypherpunks.ru/mailman/listinfo/gost, gost} +@url{http://lists.cypherpunks.ru/gost.html, gost} mailing list. Announcements also go to this mailing list. @insertcopying +@include faq.texi @include news.texi -@include download.texi +@include install.texi @bye