net.i2p.router.networkdb.kademlia

Class BlindCache

java.lang.Object

net.i2p.router.networkdb.kademlia.BlindCache

class BlindCache
extends Object

Cache of blinding data. See proposal 123.

Since:

0.9.40

Constructor Summary

Constructors

Constructor and Description
BlindCache(RouterContext ctx) Caller MUST call startup() to load persistent cache from disk

Method Summary

Modifier and Type	Method and Description
void	addToCache(net.i2p.data.BlindData bd) Persists immediately if secret or privkey is non-null
net.i2p.data.Hash	getBlindedHash(net.i2p.data.Destination dest) The hash to lookup for a dest.
net.i2p.data.Hash	getBlindedHash(net.i2p.data.SigningPublicKey spk) The hash to lookup for a SPK known to be blinded.
List<net.i2p.data.BlindData>	getData() For console ConfigKeyringHelper
net.i2p.data.BlindData	getData(net.i2p.data.Destination dest) The cached data or null
net.i2p.data.BlindData	getData(net.i2p.data.SigningPublicKey spk) The cached data or null
net.i2p.data.Hash	getHash(net.i2p.data.Destination dest) The hash to lookup for a dest.
net.i2p.data.Hash	getHash(net.i2p.data.Hash h) The hash to lookup for a dest hash.
net.i2p.data.BlindData	getReverseData(net.i2p.data.SigningPublicKey spk) The cached data or null
boolean	removeBlindData(net.i2p.data.SigningPublicKey spk) For console ConfigKeyringHelper.
void	rollover() Refresh all the data at midnight
void	setBlinded(net.i2p.data.Destination dest) Add the destination to the cache entry.
void	setBlinded(net.i2p.data.Destination dest, net.i2p.crypto.SigType blindedType, String secret) Mark a destination as known to be blinded
void	shutdown() May be restarted by calling startup() again.
void	startup()

Methods inherited from class java.lang.Object

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

Constructor Detail

BlindCache

public BlindCache(RouterContext ctx)

Caller MUST call startup() to load persistent cache from disk

Method Detail

shutdown

public void shutdown()

May be restarted by calling startup() again.

startup

public void startup()

getHash

public net.i2p.data.Hash getHash(net.i2p.data.Destination dest)

The hash to lookup for a dest. If known to be blinded, returns the current blinded hash. If not known to be blinded, returns the standard dest hash.

Parameters:

dest - may or may not be blinded

Returns:

the unblinded or blinded hash

getHash

public net.i2p.data.Hash getHash(net.i2p.data.Hash h)

The hash to lookup for a dest hash. If known to be blinded, returns the current blinded hash. If not known to be blinded, returns h.

Parameters:

h - may or may not be blinded

Returns:

the blinded hash or h

getBlindedHash

public net.i2p.data.Hash getBlindedHash(net.i2p.data.Destination dest)

The hash to lookup for a dest. If known to be blinded, returns the current blinded hash. If not known to be blinded, returns null.

Parameters:

dest - may or may not be blinded

Returns:

the blinded hash or null if not blinded

getBlindedHash

public net.i2p.data.Hash getBlindedHash(net.i2p.data.SigningPublicKey spk)

The hash to lookup for a SPK known to be blinded. Default blinded type assumed. Secret assumed null.

Parameters:

spk - known to be blinded

Returns:

the blinded hash

Throws:

IllegalArgumentException - on various errors

setBlinded

public void setBlinded(net.i2p.data.Destination dest,
                       net.i2p.crypto.SigType blindedType,
                       String secret)

Mark a destination as known to be blinded

Parameters:

dest - known to be blinded

blindedType - null for default

secret - may be null

Throws:

IllegalArgumentException - on various errors

setBlinded

public void setBlinded(net.i2p.data.Destination dest)

Add the destination to the cache entry. Must previously be in cache.

Parameters:

dest - known to be blinded

Throws:

IllegalArgumentException - on various errors

addToCache

public void addToCache(net.i2p.data.BlindData bd)

Persists immediately if secret or privkey is non-null

getData

public net.i2p.data.BlindData getData(net.i2p.data.Destination dest)

The cached data or null

getData

public net.i2p.data.BlindData getData(net.i2p.data.SigningPublicKey spk)

The cached data or null

Parameters:

spk - the unblinded public key

getReverseData

public net.i2p.data.BlindData getReverseData(net.i2p.data.SigningPublicKey spk)

The cached data or null

Parameters:

spk - the blinded public key

rollover

public void rollover()

Refresh all the data at midnight

getData

public List<net.i2p.data.BlindData> getData()

For console ConfigKeyringHelper

Returns:

list is copied

Since:

0.9.41

removeBlindData

public boolean removeBlindData(net.i2p.data.SigningPublicKey spk)

For console ConfigKeyringHelper. Persists immediately if removed.

Parameters:

spk - the unblinded public key

Returns:

true if removed

Since:

0.9.41