BinderWrapperImpl

@ExperimentalCoroutinesApi()

@Singleton()

class BinderWrapperImpl @Inject() constructor(context: Context, broadcastReceiver: ScatterbrainBroadcastReceiver, binderProvider: BinderProvider) : BinderWrapper

Functions

authorizeIdentity

open suspend override fun authorizeIdentity(identity: Identity, packageName: String)

Adds an ACL to an identity authorizing an app to use it.

deauthorizeIdentity

open suspend override fun deauthorizeIdentity(identity: Identity, packageName: String)

Removes an ACL authorizing an app to use an identity.

generateIdentity

open suspend override fun generateIdentity(name: String): Identity

generates and returns a scatterbrain identity with ACLs matching the calling application only If additional applications need access to this identity they can be assigned via the Scatterbrain app.

getIdentities

open suspend override fun getIdentities(): List<Identity>

Gets a list of all known identities.

getIdentity

open suspend override fun getIdentity(fingerprint: UUID): Identity?

Gets a single identity by fingerprint.

getPackages

open suspend override fun getPackages(): List<NamePackage>

Gets a list of packages declaring a Scatterbrain compatible BroadcastReceiver.

getPermissions

open suspend override fun getPermissions(identity: Identity): List<NamePackage>

Gets a list of ACLs associated with a given identity object.

getScatterMessages

open suspend override fun getScatterMessages(application: String): List<ScatterMessage>

returns a list of all stored message objects for a given application requires net.ballmerlabs.scatterroutingservice.permission.

open suspend override fun getScatterMessages(application: String, since: Date): List<ScatterMessage>

returns a list of all stored messages for a given application after a given date.

open suspend override fun getScatterMessages(application: String, start: Date, end: Date): List<ScatterMessage>

returns a list of all stored messages for a given application between two dates.

isConnected

open suspend override fun isConnected(): Boolean

Checks if this SDK is connected to a running Scatterbrain router

observeIdentities

@ExperimentalCoroutinesApi()

open suspend override fun observeIdentities(): Flow<List<Identity>>

returns an asynchronous flow of identities received after this function is called in real time.

observeMessages

@ExperimentalCoroutinesApi()

open suspend override fun observeMessages(application: String): Flow<List<ScatterMessage>>

returns an asynchronous flow of all messages received after this functions is called filtered by a given application identifier.

open override fun register()

Unregisters the internal BroadcastReceiver for Scatterbrain events.

removeIdentity

open suspend override fun removeIdentity(identity: Identity): Boolean

Deletes an identity.

rescanPeers

open suspend override fun rescanPeers()

Attempts to reconnect to known local peers

sendMessage

open suspend override fun sendMessage(messages: List<ScatterMessage>)

Enqueues multiple Scatterbrain messages to the datastore.

open suspend override fun sendMessage(message: ScatterMessage)

Enqueues a Scatterbrain message to the datastore.

open suspend override fun sendMessage(messages: List<ScatterMessage>, identity: UUID)

Enqueues a list of messages to the datastore and signs it with a given identity.

open suspend override fun sendMessage(messages: List<ScatterMessage>, identity: Identity)

Enqueues a list of messages to the datastore and signs it with a given identity.

open suspend override fun sendMessage(message: ScatterMessage, identity: UUID)

Enqueues a message to the datastore and signs it with a given identity.

open suspend override fun sendMessage(message: ScatterMessage, identity: Identity)

Enqueues a message to the datastore and signs it with a given identity.

sign

open suspend override fun sign(identity: Identity, data: ByteArray): ByteArray

Cryptographically signs data using a stored identity.

startDiscover

open suspend override fun startDiscover()

Starts active discovery using default transport modules This function requires net.ballmerlabs.scatterroutingservice.permission.

startPassive

open suspend override fun startPassive()

Starts passive discovery using the default radio module.

startService

open suspend override fun startService()

Starts the scatterbrain router if stopped.

stopDiscover

open suspend override fun stopDiscover()

Stops active discovery This function requires net.ballmerlabs.scatterroutingservice.permission.

stopPassive

open suspend override fun stopPassive()

Stops passive discovery This function requires net.ballmerlabs.scatterroutingservice.permission.

stopService

open suspend override fun stopService()

Stops the scatterbrain router if started.

unbindService

open suspend override fun unbindService()

disconnects from the binder interface

unregister

open override fun unregister()

Unregisters Scatterbrain broadcast receivers

verify

open suspend override fun verify(identity: Identity, data: ByteArray, sig: ByteArray): Boolean

Cryptographically verifies a detached signature using a stored identity This function requires net.ballmerlabs.scatterroutingservice.permission.

Properties

context

val context: Context