sm2p256v1

Documentation

Index

• func GenerateKey(curve SM2Curve, rand io.Reader) (priv []byte, x, y *big.Int, err error)
• func Marshal(curve SM2Curve, x, y *big.Int) []byte
• func Unmarshal(curve SM2Curve, data []byte) (x, y *big.Int)
• type SM2Curve
  • func SM2() SM2Curve
  • func SM2stand() SM2Curve
• type SM2CurveParams

Functions

func GenerateKey

func GenerateKey(curve SM2Curve, rand io.Reader) (priv []byte, x, y *big.Int, err error)

GenerateKey returns a public/private key pair. The private key is generated using the given reader, which must return random data.

func Marshal

func Marshal(curve SM2Curve, x, y *big.Int) []byte

Marshal converts a point into the form specified in section 4.3.6 of ANSI X9.62.

func Unmarshal

func Unmarshal(curve SM2Curve, data []byte) (x, y *big.Int)

Unmarshal converts a point, serialized by Marshal, into an x, y pair. It is an error if the point is not on the curve. On error, x = nil.

Types

type SM2Curve

type SM2Curve interface {
	// Params returns the parameters for the curve.
	Params() *elliptic.CurveParams

	SM2Params() *SM2CurveParams
	// IsOnCurve reports whether the given (x,y) lies on the curve.
	IsOnCurve(x, y *big.Int) bool
	// Add returns the sum of (x1,y1) and (x2,y2)
	Add(x1, y1, x2, y2 *big.Int) (x, y *big.Int)
	// Double returns 2*(x,y)
	Double(x1, y1 *big.Int) (x, y *big.Int)
	// ScalarMult returns k*(Bx,By) where k is a number in big-endian form.
	ScalarMult(x1, y1 *big.Int, k []byte) (x, y *big.Int)
	// ScalarBaseMult returns k*G, where G is the base point of the group
	// and k is an integer in big-endian form.
	ScalarBaseMult(k []byte) (x, y *big.Int)
}

func SM2

func SM2() SM2Curve

func SM2stand

func SM2stand() SM2Curve

type SM2CurveParams

type SM2CurveParams struct {
	P       *big.Int // the order of the underlying field
	N       *big.Int // the order of the base point
	A       *big.Int // the A constant of the curve equation
	B       *big.Int // the B constant of the curve equation
	Gx, Gy  *big.Int // (x,y) of the base point
	BitSize int      // the size of the underlying field
	Name    string   // the canonical name of the curve
}

A Curve represents a sm2 curve which a should be a big prime SM2 Standards: http://www.oscca.gov.cn/News/201012/News_1197.htm