Package net.i2p.crypto

Class Blinding

java.lang.Object

net.i2p.crypto.Blinding

public final class Blinding
extends Object

Utilities for Blinding EdDSA keys. PRELIMINARY - Subject to change - see proposal 123

Since:

0.9.38

Method Summary

Modifier and Type	Method	Description
static SigningPrivateKey	blind(SigningPrivateKey key, SigningPrivateKey alpha)	Only for SigTypes EdDSA_SHA512_Ed25519 and RedDSA_SHA512_Ed25519.
static SigningPublicKey	blind(SigningPublicKey key, SigningPrivateKey alpha)	Only for SigTypes EdDSA_SHA512_Ed25519 and RedDSA_SHA512_Ed25519.
static BlindData	decode(I2PAppContext ctx, byte[] b)	Decode a new-format b32 address.
static BlindData	decode(I2PAppContext ctx, String address)	Decode a new-format b32 address.
static String	encode(SigningPublicKey key)	Encode a public key as a new-format b32 address.
static String	encode(SigningPublicKey key, boolean requireSecret, boolean requireAuth)	Encode a public key as a new-format b32 address.
static SigningPrivateKey	generateAlpha(I2PAppContext ctx, SigningPublicKey destspk, String secret)	Generate alpha for current time.
static SigningPrivateKey	generateAlpha(I2PAppContext ctx, SigningPublicKey destspk, String secret, long now)	Generate alpha for the given time.
static SigType	getDefaultBlindedType(SigType unblindedType)	What's the default blinded type for a given unblinded type?
static void	main(String[] args)
static SigningPrivateKey	unblind(SigningPrivateKey key, SigningPrivateKey alpha)	Only for SigType EdDSA_SHA512_Ed25519.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

blind

public static SigningPublicKey blind(SigningPublicKey key,
                                     SigningPrivateKey alpha)

Only for SigTypes EdDSA_SHA512_Ed25519 and RedDSA_SHA512_Ed25519.

Parameters:

key - must be SigType EdDSA_SHA512_Ed25519 or RedDSA_SHA512_Ed25519

alpha - must be SigType RedDSA_SHA512_Ed25519

Returns:

SigType RedDSA_SHA512_Ed25519

Throws:

IllegalArgumentException - on bad inputs or unsupported SigTypes

blind

public static SigningPrivateKey blind(SigningPrivateKey key,
                                      SigningPrivateKey alpha)

Only for SigTypes EdDSA_SHA512_Ed25519 and RedDSA_SHA512_Ed25519.

Parameters:

key - must be SigType EdDSA_SHA512_Ed25519 or RedDSA_SHA512_Ed25519

alpha - must be SigType RedDSA_SHA512_Ed25519

Returns:

SigType RedDSA_SHA512_Ed25519

Throws:

IllegalArgumentException - on bad inputs or unsupported SigTypes

unblind

public static SigningPrivateKey unblind(SigningPrivateKey key,
                                        SigningPrivateKey alpha)

Only for SigType EdDSA_SHA512_Ed25519.

Parameters:

key - must be SigType RedDSA_SHA512_Ed25519

alpha - must be SigType RedDSA_SHA512_Ed25519

Returns:

SigType EdDSA_SHA512_Ed25519

Throws:

IllegalArgumentException - on bad inputs or unsupported SigTypes

generateAlpha

public static SigningPrivateKey generateAlpha(I2PAppContext ctx,
                                              SigningPublicKey destspk,
                                              String secret)

Generate alpha for current time. Only for SigType EdDSA_SHA512_Ed25519.

Parameters:

destspk - must be SigType EdDSA_SHA512_Ed25519

secret - may be null or zero-length

Returns:

SigType RedDSA_SHA512_Ed25519

Throws:

IllegalArgumentException - on bad inputs or unsupported SigTypes

Since:

0.9.39

generateAlpha

public static SigningPrivateKey generateAlpha(I2PAppContext ctx,
                                              SigningPublicKey destspk,
                                              String secret,
                                              long now)

Generate alpha for the given time. Only for SigType EdDSA_SHA512_Ed25519 or RedDSA_SHA512_Ed25519.

Parameters:

destspk - must be SigType EdDSA_SHA512_Ed25519 or RedDSA_SHA512_Ed25519

secret - may be null or zero-length

now - for what time?

Returns:

SigType RedDSA_SHA512_Ed25519

Throws:

IllegalArgumentException - on bad inputs or unsupported SigTypes

Since:

0.9.39

getDefaultBlindedType

public static SigType getDefaultBlindedType(SigType unblindedType)

What's the default blinded type for a given unblinded type?

Returns:

non-null

Since:

0.9.40

decode

public static BlindData decode(I2PAppContext ctx,
                               String address)
                        throws IllegalArgumentException

Decode a new-format b32 address. See proposal 149.

Parameters:

address - ending with ".b32.i2p"

Returns:

BlindData structure, use getUnblindedPubKey() for the result

Throws:

IllegalArgumentException - on bad inputs or unsupported SigTypes

Since:

0.9.40

decode

public static BlindData decode(I2PAppContext ctx,
                               byte[] b)
                        throws IllegalArgumentException

Decode a new-format b32 address. See proposal 149. NOTE: Not for external use, use decode(String)

Parameters:

b - 35+ bytes

Returns:

BlindData structure, use getUnblindedPubKey() for the result

Throws:

IllegalArgumentException - on bad inputs or unsupported SigTypes

Since:

0.9.40

encode

public static String encode(SigningPublicKey key)
                     throws IllegalArgumentException

Encode a public key as a new-format b32 address. See proposal 149.

Returns:

(56 chars).b32.i2p

Throws:

IllegalArgumentException - on bad inputs or unsupported SigTypes

Since:

0.9.40

encode

public static String encode(SigningPublicKey key,
                            boolean requireSecret,
                            boolean requireAuth)
                     throws IllegalArgumentException

Encode a public key as a new-format b32 address. See proposal 149.

Returns:

(56 chars).b32.i2p

Throws:

IllegalArgumentException - on bad inputs or unsupported SigTypes

Since:

0.9.40

main

public static void main(String[] args)
                 throws Exception

Throws:

Exception