com.radixdlt.client.core

Class RadixUniverse

java.lang.Object

com.radixdlt.client.core.RadixUniverse

public final class RadixUniverse
extends java.lang.Object

A RadixUniverse represents the interface through which a client can interact with a Radix Universe.

The configuration file of a Radix Universe defines the genesis atoms of the distributed ledger and distinguishes this universe from other universes. (e.g. Public net vs Test net) It is shared amongst all participants of this instance of the Radix getNetwork.

The network interface is available to directly connect with Node Runners in the Radix Network in order to read/write atoms on the distributed ledger.

The ledger interface is a thin wrapper on the network interface which provides an abstraction which doesn't require managing network peers. It can for example be used to cache atoms locally.

Method Summary

Modifier and Type	Method and Description
static RadixUniverse	create(BootstrapConfig bootstrapConfig)
static RadixUniverse	create(RadixUniverseConfig config, java.util.List<RadixNetworkEpic> discoveryEpics, java.util.Set<RadixNode> initialNetwork) Creates a universe with peer discovery through epics
static RadixUniverse	create(RadixUniverseConfig config, io.reactivex.Observable<RadixNode> seeds, java.util.Set<RadixNode> initialNetwork) Creates a universe with peer discovery through seed nodes
RadixAddress	getAddressFrom(ECPublicKey publicKey) Maps a public key to it's corresponding Radix address in this universe.
AtomPuller	getAtomPuller()
AtomStore	getAtomStore()
RadixUniverseConfig	getConfig()
int	getMagic()
RRI	getNativeToken()
RadixNetworkController	getNetworkController()
ECPublicKey	getSystemPublicKey() Returns the system public key, also defined as the creator of this Universe

Methods inherited from class java.lang.Object

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

Method Detail

create

public static RadixUniverse create(RadixUniverseConfig config,
                                   io.reactivex.Observable<RadixNode> seeds,
                                   java.util.Set<RadixNode> initialNetwork)

Creates a universe with peer discovery through seed nodes

Parameters:

seeds - The seed nodes

Returns:

the created universe

create

public static RadixUniverse create(RadixUniverseConfig config,
                                   java.util.List<RadixNetworkEpic> discoveryEpics,
                                   java.util.Set<RadixNode> initialNetwork)

Creates a universe with peer discovery through epics

Parameters:

discoveryEpics - epics which are responsible for peer discovery

Returns:

the created universe

create

public static RadixUniverse create(BootstrapConfig bootstrapConfig)

getNetworkController

public RadixNetworkController getNetworkController()

getNativeToken

public RRI getNativeToken()

getMagic

public int getMagic()

getAtomPuller

public AtomPuller getAtomPuller()

getAtomStore

public AtomStore getAtomStore()

getSystemPublicKey

public ECPublicKey getSystemPublicKey()

Returns the system public key, also defined as the creator of this Universe

Returns:

the system public key

getAddressFrom

public RadixAddress getAddressFrom(ECPublicKey publicKey)

Maps a public key to it's corresponding Radix address in this universe. Within a universe, a public key has a one to one bijective relationship to an address

Parameters:

publicKey - the key to get an address from

Returns:

the corresponding address to the key for this universe

getConfig

public RadixUniverseConfig getConfig()