services

type AccessManagementService interface {
	Service

	// AddRoleAssignment Deprecated: This method is experimental
	// Adds a role assignment to an account
	AddRoleAssignment(userContext context.Context, request *provider.AddRoleAssignmentRequest) (*provider.AddRoleAssignmentResponse, error)
	// RemoveRoleAssignment Deprecated: This method is experimental
	// Removes a role assignment from the account
	RemoveRoleAssignment(userContext context.Context, request *provider.RemoveRoleAssignmentRequest) (*provider.RemoveRoleAssignmentResponse, error)
	// ListRoleAssignments Deprecated: This method is experimental
	// List the role assignments for the given account
	ListRoleAssignments(userContext context.Context, request *provider.ListRoleAssignmentsRequest) (*provider.ListRoleAssignmentsResponse, error)
}

type ConnectService interface {
	Service

	// CreateSession  Create an IDVSession
	CreateSession(userContext context.Context, request *connect.CreateSessionRequest) (*connect.CreateSessionResponse, error)
	// CancelSession  Cancel an IDVSession
	CancelSession(userContext context.Context, request *connect.CancelSessionRequest) (*connect.CancelSessionResponse, error)
	// GetSession  Get an IDVSession
	GetSession(userContext context.Context, request *connect.GetSessionRequest) (*connect.GetSessionResponse, error)
	// ListSessions  List IDVSessions created by the calling wallet
	ListSessions(userContext context.Context, request *connect.ListSessionsRequest) (*connect.ListSessionsResponse, error)
	// HasValidCredential  Checks if the identity provided in the request has a wallet containing a valid reusable credential
	HasValidCredential(userContext context.Context, request *connect.HasValidCredentialRequest) (*connect.HasValidCredentialResponse, error)
}

type CredentialService interface {
	Service

	// IssueFromTemplate  Sign and issue a verifiable credential from a pre-defined template.
	// This process will also add schema validation and
	// revocation registry values to the credential.
	IssueFromTemplate(userContext context.Context, request *credential.IssueFromTemplateRequest) (*credential.IssueFromTemplateResponse, error)
	// CheckStatus  Check credential status in the revocation registry
	CheckStatus(userContext context.Context, request *credential.CheckStatusRequest) (*credential.CheckStatusResponse, error)
	// UpdateStatus  Update credential status by setting the revocation value
	UpdateStatus(userContext context.Context, request *credential.UpdateStatusRequest) (*credential.UpdateStatusResponse, error)
	// CreateProof  Create a proof from a signed document that is a valid
	// verifiable credential and contains a signature from which a proof can be derived.
	CreateProof(userContext context.Context, request *credential.CreateProofRequest) (*credential.CreateProofResponse, error)
	// VerifyProof  Verifies a proof by checking the signature value, and if possible schema validation,
	// revocation status, and issuer status against a trust registry
	VerifyProof(userContext context.Context, request *credential.VerifyProofRequest) (*credential.VerifyProofResponse, error)
	// Send  Sends a document directly to a user's email within the given ecosystem
	Send(userContext context.Context, request *credential.SendRequest) (*credential.SendResponse, error)
	// CreateCredentialOffer  Create credential offer
	CreateCredentialOffer(userContext context.Context, request *credential.CreateCredentialOfferRequest) (*credential.CreateCredentialOfferResponse, error)
	// AcceptCredential  Accept an offer to exchange a credential
	AcceptCredential(userContext context.Context, request *credential.AcceptCredentialRequest) (*credential.AcceptCredentialResponse, error)
	// RejectCredential  Reject an offer to exchange a credential
	RejectCredential(userContext context.Context, request *credential.RejectCredentialRequest) (*credential.RejectCredentialResponse, error)
}

type FileManagementService interface {
	Service

	// UploadFile Deprecated: This method is experimental
	// Upload a file to Trinsic's CDN
	UploadFile(userContext context.Context, request *filemanagement.UploadFileRequest) (*filemanagement.UploadFileResponse, error)
	// GetFile Deprecated: This method is experimental
	// Fetch information about a file by its ID
	GetFile(userContext context.Context, request *filemanagement.GetFileRequest) (*filemanagement.GetFileResponse, error)
	// DeleteFile Deprecated: This method is experimental
	// Delete a file by its ID
	DeleteFile(userContext context.Context, request *filemanagement.DeleteFileRequest) (*filemanagement.DeleteFileResponse, error)
	// ListFiles Deprecated: This method is experimental
	// List files the calling account has uploaded
	ListFiles(userContext context.Context, request *filemanagement.ListFilesRequest) (*filemanagement.ListFilesResponse, error)
	// GetStorageStats Deprecated: This method is experimental
	// Get statistics about files uploaded by the calling account
	GetStorageStats(userContext context.Context) (*filemanagement.GetStorageStatsResponse, error)
}

type Option func(*Options) error

type Options struct {
	TrinsicOptions  *options.TrinsicOptions
	GrpcDialOptions []grpc.DialOption
}

type ProviderService interface {
	Service
	// CreateEcosystem creates a new ecosystem
	CreateEcosystem(ctx context.Context, request *provider.CreateEcosystemRequest) (*provider.CreateEcosystemResponse, error)

	// GetOberonKey  Returns the public key being used to create/verify oberon tokens
	GetOberonKey(userContext context.Context) (*provider.GetOberonKeyResponse, error)
	// UpgradeDID  Upgrade a wallet's DID from `did:key` to another method
	UpgradeDID(userContext context.Context, request *provider.UpgradeDidRequest) (*provider.UpgradeDidResponse, error)
	// SearchWalletConfigurations  Search for issuers/providers/verifiers in the current ecosystem
	SearchWalletConfigurations(userContext context.Context, request *provider.SearchWalletConfigurationsRequest) (*provider.SearchWalletConfigurationResponse, error)
}

type Service interface {
	// GetMetadataContext returns a context with the required grpc metadata embedded in it
	GetMetadataContext(userContext context.Context, message proto.Message) (context.Context, error)
	// BuildMetadata builds the required grpc metadata
	BuildMetadata(message proto.Message) (metadata.MD, error)
	// SetAuthToken assigns the given auth token to the service. This token will be used for
	// make all api calls
	SetAuthToken(token string)
	// GetAuthToken returns the auth token currently assigned to this service or an empty string
	// if none is set
	GetAuthToken() string
	// GetServiceOptions returns the set of TrinsicOptions the service is using
	GetServiceOptions() *options.TrinsicOptions
	// GetChannel returns the grpc client connect
	GetChannel() *grpc.ClientConn
}

type TemplateService interface {
	Service

	// Create  Create a credential template in the current ecosystem
	Create(userContext context.Context, request *template.CreateCredentialTemplateRequest) (*template.CreateCredentialTemplateResponse, error)
	// Get  Fetch a credential template by ID
	Get(userContext context.Context, request *template.GetCredentialTemplateRequest) (*template.GetCredentialTemplateResponse, error)
	// Update  Update metadata of a template
	Update(userContext context.Context, request *template.UpdateCredentialTemplateRequest) (*template.UpdateCredentialTemplateResponse, error)
	// List  Search credential templates using SQL, returning strongly-typed template data
	List(userContext context.Context, request *template.ListCredentialTemplatesRequest) (*template.ListCredentialTemplatesResponse, error)
	// Search  Search credential templates using SQL, returning raw JSON data
	Search(userContext context.Context, request *template.SearchCredentialTemplatesRequest) (*template.SearchCredentialTemplatesResponse, error)
	// Delete  Delete a credential template from the current ecosystem by ID
	Delete(userContext context.Context, request *template.DeleteCredentialTemplateRequest) (*template.DeleteCredentialTemplateResponse, error)
	// CreateVerificationTemplate Deprecated: This method is experimental
	// Create/update verification templates
	CreateVerificationTemplate(userContext context.Context, request *template.CreateVerificationTemplateRequest) (*template.CreateVerificationTemplateResponse, error)
	// ListVerificationTemplates Deprecated: This method is experimental
	ListVerificationTemplates(userContext context.Context, request *template.ListVerificationTemplatesRequest) (*template.ListVerificationTemplatesResponse, error)
	// GetVerificationTemplate Deprecated: This method is experimental
	GetVerificationTemplate(userContext context.Context, request *template.GetVerificationTemplateRequest) (*template.GetVerificationTemplateResponse, error)
	// UpdateVerificationTemplate Deprecated: This method is experimental
	UpdateVerificationTemplate(userContext context.Context, request *template.UpdateVerificationTemplateRequest) (*template.UpdateVerificationTemplateResponse, error)
	// DeleteVerificationTemplate Deprecated: This method is experimental
	DeleteVerificationTemplate(userContext context.Context, request *template.DeleteVerificationTemplateRequest) (*template.DeleteVerificationTemplateResponse, error)
}

type Trinsic struct {
	Service
	// contains filtered or unexported fields
}

type TrustRegistryService interface {
	Service

	// RegisterMember  Register an authoritative issuer for a credential schema
	RegisterMember(userContext context.Context, request *trustregistry.RegisterMemberRequest) (*trustregistry.RegisterMemberResponse, error)
	// UnregisterMember  Removes an authoritative issuer for a credential schema from the trust registry
	UnregisterMember(userContext context.Context, request *trustregistry.UnregisterMemberRequest) (*trustregistry.UnregisterMemberResponse, error)
	// GetMemberAuthorizationStatus  Fetch the status of a member for a given credential schema in a trust registry
	GetMemberAuthorizationStatus(userContext context.Context, request *trustregistry.GetMemberAuthorizationStatusRequest) (*trustregistry.GetMemberAuthorizationStatusResponse, error)
	// ListAuthorizedMembers  Fetch the ecosystem's authorized issuers and the respective templates against which it can issue
	ListAuthorizedMembers(userContext context.Context, request *trustregistry.ListAuthorizedMembersRequest) (*trustregistry.ListAuthorizedMembersResponse, error)
	// GetMember  Get member for a given did in a trust registry
	GetMember(userContext context.Context, request *trustregistry.GetMemberRequest) (*trustregistry.GetMemberResponse, error)
}

type WalletService interface {
	Service

	// Search searches the wallet using a SQL-like syntax
	SearchWallet(userContext context.Context, request *wallet.SearchRequest) (*wallet.SearchResponse, error)

	// GetItem  Retrieve an item from the wallet with a given item identifier
	GetItem(userContext context.Context, request *wallet.GetItemRequest) (*wallet.GetItemResponse, error)
	// Search  Search the wallet using a SQL syntax
	Search(userContext context.Context, request *wallet.SearchRequest) (*wallet.SearchResponse, error)
	// InsertItem  Insert an item into the wallet
	InsertItem(userContext context.Context, request *wallet.InsertItemRequest) (*wallet.InsertItemResponse, error)
	// UpdateItem  Update an item in the wallet
	UpdateItem(userContext context.Context, request *wallet.UpdateItemRequest) (*wallet.UpdateItemResponse, error)
	// DeleteItem  Delete an item from the wallet permanently
	DeleteItem(userContext context.Context, request *wallet.DeleteItemRequest) (*wallet.DeleteItemResponse, error)
	// DeleteWallet  Delete a wallet and its credentials
	DeleteWallet(userContext context.Context, request *wallet.DeleteWalletRequest) (*wallet.DeleteWalletResponse, error)
	// CreateWallet  Create a new wallet and generate an auth token for access
	CreateWallet(userContext context.Context, request *wallet.CreateWalletRequest) (*wallet.CreateWalletResponse, error)
	// GetWalletInfo  Retrieve wallet details and configuration
	GetWalletInfo(userContext context.Context, request *wallet.GetWalletInfoRequest) (*wallet.GetWalletInfoResponse, error)
	// GetMyInfo  Retrieve wallet details and configuration about the currently authenticated wallet
	GetMyInfo(userContext context.Context) (*wallet.GetMyInfoResponse, error)
	// GetWalletFromExternalIdentity  Retrieve information from an ecosystem wallet by searching for its external identity (email or phone)
	GetWalletFromExternalIdentity(userContext context.Context, request *wallet.GetWalletFromExternalIdentityRequest) (*wallet.GetWalletFromExternalIdentityResponse, error)
	// GenerateAuthToken  Generate new token for a given wallet and add it to the collection of known auth tokens.
	// This endpoint requires authentication and will return a new token ID and auth token.
	// Use this endpoint if you want to authorize another device, without having to share your
	// existing auth token.
	GenerateAuthToken(userContext context.Context, request *wallet.GenerateAuthTokenRequest) (*wallet.GenerateAuthTokenResponse, error)
	// RevokeAuthToken  Revokes a previously issued auth token and updates the collection of known auth tokens.
	// This endpoint requires authentication.
	RevokeAuthToken(userContext context.Context, request *wallet.RevokeAuthTokenRequest) (*wallet.RevokeAuthTokenResponse, error)
	// AddExternalIdentityInit  Add new external identity to the current wallet, such as email, sms, ethereum address, etc.
	// This identity ownership must be confirmed using `AddIdentityConfirm` via OTP, signature, etc.
	AddExternalIdentityInit(userContext context.Context, request *wallet.AddExternalIdentityInitRequest) (*wallet.AddExternalIdentityInitResponse, error)
	// AddExternalIdentityConfirm  Confirm identity added to the current wallet using `AddExternalIdentityInit`
	AddExternalIdentityConfirm(userContext context.Context, request *wallet.AddExternalIdentityConfirmRequest) (*wallet.AddExternalIdentityConfirmResponse, error)
	// RemoveExternalIdentity  Remove an external identity from the current wallet
	RemoveExternalIdentity(userContext context.Context, request *wallet.RemoveExternalIdentityRequest) (*wallet.RemoveExternalIdentityResponse, error)
	// AuthenticateInit  Sign-in to an already existing wallet, using an identity added that was previously registered
	// This endpoint does not require authentication, and will return a challenge to be signed or verified
	AuthenticateInit(userContext context.Context, request *wallet.AuthenticateInitRequest) (*wallet.AuthenticateInitResponse, error)
	// AuthenticateConfirm  Confirm sign-in to an already existing wallet and return authentication token
	AuthenticateConfirm(userContext context.Context, request *wallet.AuthenticateConfirmRequest) (*wallet.AuthenticateConfirmResponse, error)
	// AuthenticateResendCode  Resend previous authentication code
	AuthenticateResendCode(userContext context.Context, request *wallet.AuthenticateResendCodeRequest) (*wallet.AuthenticateResendCodeResponse, error)
	// ListWallets  List all wallets in the ecosystem
	ListWallets(userContext context.Context, request *wallet.ListWalletsRequest) (*wallet.ListWalletsResponse, error)
	// ListByVerificationTemplate  List credentials which match a given verification template
	ListByVerificationTemplate(userContext context.Context, request *wallet.ListByVerificationTemplateRequest) (*wallet.ListByVerificationTemplateResponse, error)
}