io.storj

Class Uplink

java.lang.Object

io.storj.Uplink

public class Uplink
extends java.lang.Object

Represents the main entrypoint to the Storj network.

Constructor Summary

Constructors

Constructor and Description
Uplink(UplinkOption... options)

Method Summary

Modifier and Type	Method and Description
Project	openProject(Access access) Returns a Project handle for the given Access.
Access	requestAccessWithPassphrase(java.lang.String satelliteAddress, java.lang.String apiKey, java.lang.String passphrase) Generates a new access grant using a passhprase.

Methods inherited from class java.lang.Object

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

Constructor Detail

Uplink

public Uplink(UplinkOption... options)

Method Detail

openProject

public Project openProject(Access access)
                    throws StorjException

Returns a Project handle for the given Access.

Parameters:

access - an access grant, see Access

Returns:

a Project handle

Throws:

StorjException - in case of error

requestAccessWithPassphrase

public Access requestAccessWithPassphrase(java.lang.String satelliteAddress,
                                          java.lang.String apiKey,
                                          java.lang.String passphrase)
                                   throws StorjException

Generates a new access grant using a passhprase. It must talk to the Satellite provided to get a project-based salt for deterministic key derivation.

Note: this is a CPU-heavy function that uses a password-based key derivation function (Argon2). This should be a setup-only step. Most common interactions with the library should be using a serialized access grant through ParseAccess directly.

Parameters:

satelliteAddress - the satellite address

apiKey - the api key

passphrase - the passphrase

Returns:

the access grant

Throws:

StorjException - in case of error