Skip to content
Snippets Groups Projects
Commit 8ae6e7f4 authored by Josh Brooks's avatar Josh Brooks
Browse files

Update UD documentation

parent 46e93488
No related branches found
No related tags found
2 merge requests!510Release,!333Frond End Assistance And Iterative Clean Up
...@@ -105,28 +105,49 @@ type UdNetworkStatus interface { ...@@ -105,28 +105,49 @@ type UdNetworkStatus interface {
// Manager functions // // Manager functions //
//////////////////////////////////////////////////////////////////////////////// ////////////////////////////////////////////////////////////////////////////////
// NewOrLoadUd loads an existing Manager from storage or creates a // NewOrLoadUd loads an existing UserDiscovery from storage or creates a new
// new one if there is no extant storage information. Parameters need be provided // UserDiscovery if there is no storage data. Regardless of storage state,
// to specify how to connect to the User Discovery service. These parameters may be used // the UserDiscovery object returned will be registered with the
// to contact either the UD server hosted by the xx network team or a custom // User Discovery service. If the user is not already registered, a call
// third-party operated server. For the former, all the information may be pulled from the // to register will occur internally. If the user is already registered,
// NDF using the bindings. // this call will simply load state and return to you a UserDiscovery object.
// Some parameters are required for registering with the service, but are not required
// if the user is already registered. These will be noted in the parameters section as
// "SEMI-REQUIRED".
//
// Certain parameters are required every call to this function. These parameters are listed below
// as "REQUIRED". For example, parameters need be provided to specify how to connect to the
// User Discovery service. These parameters may be used to contact either the UD server hosted
// by the xx network team or a custom third-party operated server. For the former,
// all the information may be fetched from the NDF using the bindings. These fetch
// methods are detailed in the parameters section.
// //
// Params // Params
// - e2eID - e2e object ID in the tracker // - e2eID - REQUIRED. The tracked e2e object ID. This is returned by [E2e.GetID].
// - follower - network follower func wrapped in UdNetworkStatus // - follower - REQUIRED. Network follower function. This will check if the network
// - username - the username the user wants to register with UD. // follower is running.
// If the user is already registered, this field may be blank // - username - SEMI-REQUIRED. The username the user wants to register with UD.
// - networkValidationSig is a signature provided by the network (i.e. the client registrar). // If the user is already registered, this field may be blank. If the user is not
// This may be nil, however UD may return an error in some cases (e.g. in a production level // already registered, these field must be populated with a username that meets the
// environment). // requirements of the UD service. For example, in the xx network's UD service,
// - cert is the TLS certificate for the UD server this call will connect with. // the username must not be registered by another user.
// You may use the UD server run by the xx network team by using E2e.GetUdCertFromNdf. // - networkValidationSig - SEMI-REQUIRED. A signature provided by the xx network
// - contactFile is the data within a marshalled contact.Contact. This represents the // (i.e. the client registrar). If the user is not already registered, this field is required
// in order to register with the xx network. This may be nil if the user is already registered
// or connecting to a third-party UD service unassociated with the xx network.
// - cert - REQUIRED. The TLS certificate for the UD server this call will connect with.
// If this is nil, you may not contact the UD server hosted by the xx network.
// Third-party services may vary.
// You may use the UD server run by the xx network team by using [E2e.GetUdCertFromNdf].
// - contactFile - REQUIRED. The data within a marshalled [contact.Contact]. This represents the
// contact file of the server this call will connect with. // contact file of the server this call will connect with.
// You may use the UD server run by the xx network team by using E2e.GetUdContactFromNdf. // If this is nil, you may not contact the UD server hosted by the xx network.
// - address is the IP address of the UD server this call will connect with. // Third-party services may vary.
// You may use the UD server run by the xx network team by using E2e.GetUdAddressFromNdf. // You may use the UD server run by the xx network team by using [E2e.GetUdContactFromNdf].
// - address - REQUIRED. The IP address of the UD server this call will connect with.
// You may use the UD server run by the xx network team by using [E2e.GetUdAddressFromNdf].
// If this is nil, you may not contact the UD server hosted by the xx network.
// Third-party services may vary.
// //
// Returns // Returns
// - A Manager object which is registered to the specified UD service. // - A Manager object which is registered to the specified UD service.
......
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment