Skip to content
GitLab
Explore
Sign in
Primary navigation
Search or go to…
Project
client
Manage
Activity
Members
Labels
Plan
Issues
Issue boards
Milestones
Wiki
Code
Merge requests
Repository
Branches
Commits
Tags
Repository graph
Compare revisions
Snippets
Deploy
Releases
Package registry
Container Registry
Model registry
Operate
Terraform modules
Analyze
Contributor analytics
Model experiments
Help
Help
Support
GitLab documentation
Compare GitLab plans
Community forum
Contribute to GitLab
Provide feedback
Keyboard shortcuts
?
Snippets
Groups
Projects
Show more breadcrumbs
elixxir
client
Commits
8ae6e7f4
Commit
8ae6e7f4
authored
2 years ago
by
Josh Brooks
Browse files
Options
Downloads
Patches
Plain Diff
Update UD documentation
parent
46e93488
No related branches found
No related tags found
2 merge requests
!510
Release
,
!333
Frond End Assistance And Iterative Clean Up
Changes
1
Hide whitespace changes
Inline
Side-by-side
Showing
1 changed file
bindings/ud.go
+40
-19
40 additions, 19 deletions
bindings/ud.go
with
40 additions
and
19 deletions
bindings/ud.go
+
40
−
19
View file @
8ae6e7f4
...
@@ -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.
...
...
This diff is collapsed.
Click to expand it.
Preview
0%
Loading
Try again
or
attach a new file
.
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Save comment
Cancel
Please
register
or
sign in
to comment