crypto

package

v0.4.0 Latest Latest Go to latest Published: Jun 14, 2025 License: Apache-2.0 Imports: 6 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/0xPellNetwork/pelldvs

Links

Open Source Insights

README ¶

crypto

crypto is the cryptographic package adapted for PellDVS's uses

Importing it

To get the interfaces, import "github.com/0xPellNetwork/pelldvs/crypto"

For any specific algorithm, use its specific module e.g. import "github.com/0xPellNetwork/pelldvs/crypto/ed25519"

Binary encoding

For Binary encoding, please refer to the PellDVS encoding specification.

JSON Encoding

JSON encoding is done using PellDVS's internal json encoder. For more information on JSON encoding, please refer to PellDVS JSON encoding

Example JSON encodings:

ed25519.PrivKey     - {"type":"tendermint/PrivKeyEd25519","value":"EVkqJO/jIXp3rkASXfh9YnyToYXRXhBr6g9cQVxPFnQBP/5povV4HTjvsy530kybxKHwEi85iU8YL0qQhSYVoQ=="}
ed25519.PubKey      - {"type":"tendermint/PubKeyEd25519","value":"AT/+aaL1eB0477Mud9JMm8Sh8BIvOYlPGC9KkIUmFaE="}
sr25519.PrivKeySr25519   - {"type":"tendermint/PrivKeySr25519","value":"xtYVH8UCIqfrY8FIFc0QEpAEBShSG4NT0zlEOVSZ2w4="}
sr25519.PubKeySr25519    - {"type":"tendermint/PubKeySr25519","value":"8sKBLKQ/OoXMcAJVxBqz1U7TyxRFQ5cmliuHy4MrF0s="}
crypto.PrivKeySecp256k1   - {"type":"tendermint/PrivKeySecp256k1","value":"zx4Pnh67N+g2V+5vZbQzEyRerX9c4ccNZOVzM9RvJ0Y="}
crypto.PubKeySecp256k1    - {"type":"tendermint/PubKeySecp256k1","value":"A8lPKJXcNl5VHt1FK8a244K9EJuS4WX1hFBnwisi0IJx"}

Documentation ¶

Examples ¶

Sha256

Constants ¶

View Source

const (
	// AddressSize is the size of a pubkey address.
	AddressSize = tmhash.TruncatedSize
)

View Source

const Version = "0.9.0-dev"

Variables ¶

This section is empty.

Functions ¶

func CRandBytes ¶

func CRandBytes(numBytes int) []byte

This only uses the OS's randomness

func CRandHex ¶

func CRandHex(numDigits int) string

CRandHex returns a hex encoded string that's floor(numDigits/2) * 2 long.

Note: CRandHex(24) gives 96 bits of randomness that are usually strong enough for most purposes.

func CReader ¶

func CReader() io.Reader

Returns a crand.Reader.

func Sha256 ¶

func Sha256(bytes []byte) []byte

Example ¶

package main

import (
	"fmt"

	"github.com/0xPellNetwork/pelldvs/crypto"
)

func main() {
	sum := crypto.Sha256([]byte("This is PellDVS"))
	fmt.Printf("%x\n", sum)
}

Output:

8df447f279c3714896cd6c1ae70cbbbb46b3530bde51db86e92c0850c6daa463

Types ¶

type Address ¶

type Address = bytes.HexBytes

An address is a []byte, but hex-encoded even in JSON. []byte leaves us the option to change the address length. Use an alias so Unmarshal methods (with ptr receivers) are available too.

func AddressHash ¶

func AddressHash(bz []byte) Address

type BatchVerifier ¶

type BatchVerifier interface {
	// Add appends an entry into the BatchVerifier.
	Add(key PubKey, message, signature []byte) error
	// Verify verifies all the entries in the BatchVerifier, and returns
	// if every signature in the batch is valid, and a vector of bools
	// indicating the verification status of each signature (in the order
	// that signatures were added to the batch).
	Verify() (bool, []bool)
}

If a new key type implements batch verification, the key type must be registered in github.com/0xPellNetwork/pelldvs/crypto/batch

type PrivKey ¶

type PrivKey interface {
	Bytes() []byte
	Sign(msg []byte) ([]byte, error)
	PubKey() PubKey
	Equals(PrivKey) bool
	Type() string
}

type PubKey ¶

type PubKey interface {
	Address() Address
	Bytes() []byte
	VerifySignature(msg []byte, sig []byte) bool
	Equals(PubKey) bool
	Type() string
}

type Symmetric ¶

type Symmetric interface {
	Keygen() []byte
	Encrypt(plaintext []byte, secret []byte) (ciphertext []byte)
	Decrypt(ciphertext []byte, secret []byte) (plaintext []byte, err error)
}

Source Files ¶

View all Source files

Directories ¶

Path	Synopsis
armor
batch
bls
bn254
ecdsa
ed25519
encoding
internal
benchmarking
merkle Package merkle computes a deterministic minimal height Merkle tree hash.	Package merkle computes a deterministic minimal height Merkle tree hash.
secp256k1
sr25519
tmhash
xchacha20poly1305 Package xchacha20poly1305 creates an AEAD using hchacha, chacha, and poly1305 This allows for randomized nonces to be used in conjunction with chacha.	Package xchacha20poly1305 creates an AEAD using hchacha, chacha, and poly1305 This allows for randomized nonces to be used in conjunction with chacha.
xsalsa20symmetric

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