LocatorUnum

From Erights

See [1].

The LocatorUnum provides the authority to convert bits (a VatID and SwissNumber) into a capability (a CapTP live ref). Each Introducer has one presence of the LocatorUnum.

Protocol

getRcvr/4

Signature: getRcvr(searchPath :SearchPath, vatID :VatID, swissNum :Swiss, optFarVine :any) :any

XXX In E-on-Java this is Java-defined as throws IOException, IndexOutOfBoundsException. Should this be documented as throwing? If it throws rather than returning broken, is this a being-consistently-eventual failure?

The basic operation underlying 'SturdyRef.getRcvr()'.

This is where a reference to a remote object actually gets the various underlying comm systems connected so that we can send messages.

getRcvr only works when we're onTheAir.

Parameters:

searchPath 

A list of places to try to find the vat

vatID 

The vat from which the object reference should be obtained

swissNum 

The SwissNumber of the desired object

optFarVine 

Optional object for holding onto a Remote reference via whoever we got it from long enough to fetch our own Remote reference via this lookup.