mapping

package

v0.0.0-...-3348f2e Latest Latest Go to latest Published: Jun 7, 2022 License: BSD-3-Clause Imports: 5 Imported by: 0

Details

Valid go.mod file

The Go module system was introduced in Go 1.11 and is the official dependency management solution for Go.
Redistributable license

Redistributable licenses place minimal restrictions on how software can be used, modified, and redistributed.
Tagged version

Modules with tagged versions give importers more predictable builds.
Stable version

When a project reaches major version v1 it is considered stable.
Learn more about best practices

Repository

github.com/armfazh/h2c-go-ref

Links

Open Source Insights

Documentation ¶

Overview ¶

Package mapping contains a set of functions to construct functions that take a field element and return a point on an elliptic curve. Certain mappings restrict the form of the curve or its parameters.

Choosing a mapping function ¶

If the target elliptic curve is:

a supersingular curve, then use either the Boneh-Franklin method (NewBF) or the Elligator 2 method for A == 0 (newWA0Ell2);
a Montgomery or twisted Edwards curve, then use the Elligator 2 (NewElligator2);
a Weierstrass curve, then use either the Simplified SWU (NewSSWU), even if either A or B is zero;
if none of the above applies, then use the Shallue-van de Woestijne method (NewSVDW).

Note: the mappings must not be used standalone, since its correct and secure usage is determined by each hash to curve suite.

Index ¶

type ID
type MapDescriptor
- func (d MapDescriptor) Get(e C.EllCurve) MapToCurve
type MapToCurve

Constants ¶

This section is empty.

Variables ¶

This section is empty.

Functions ¶

This section is empty.

Types ¶

type ID ¶

type ID uint

ID is an identifier of a mapping.

const (
	// BF is the Boneh-Franklin method
	BF ID = iota
	// SSWU is the Simplified SWU method.
	SSWU
	// ELL2 is Elligator2 method.
	ELL2
	// SVDW is Shallue-van de Woestijne method.
	SVDW
)

type MapDescriptor ¶

type MapDescriptor struct {
	ID  ID
	Z   interface{}
	Iso func() C.Isogeny
}

MapDescriptor describes parameters of a mapping to curve.

func (MapDescriptor) Get ¶

func (d MapDescriptor) Get(e C.EllCurve) MapToCurve

Get returns a MapToCurve implementation based on ID provided. Some arguments can be set to nil if there are not required by the mapping.

type MapToCurve ¶

type MapToCurve interface {
	Map(GF.Elt) C.Point
}

MapToCurve maps a field element into a elliptic curve point.

func NewBF ¶

func NewBF(e C.EllCurve) MapToCurve

NewBF implements the Boneh-Franklin method.

func NewElligator2 ¶

func NewElligator2(e C.EllCurve) MapToCurve

NewElligator2 implements the Elligator2 method.

func NewSSWU ¶

func NewSSWU(e C.EllCurve, z GF.Elt, iso func() C.Isogeny) MapToCurve

NewSSWU implements the Simplified SWU method. If a non-nil isogeny (e0 -> e) is provided, it first maps points to e0 and then applies the isogeny to get a point on e.

func NewSVDW ¶

func NewSVDW(e C.EllCurve) MapToCurve

NewSVDW implements the Shallue-van de Woestijne method.

Source Files ¶

View all Source files

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL