holder

type BuildParams struct {
	// Audience is used to fill the audience field in the proof
	Audience string
	// DIDMethods is a list of DID methods that the verifier supports for presentation/credential validation
	DIDMethods []string
	// Expires is the expiration time of the presentation
	Expires time.Time
	// Format is a map of format designations that the verifier supports for the presentation
	Format map[string]map[string][]string
	// Nonce is used to fill the nonce/challenge field in the proof
	Nonce string
}

type MockOpenIDHandler struct {
	// contains filtered or unexported fields
}

type MockOpenIDHandlerMockRecorder struct {
	// contains filtered or unexported fields
}

type MockWallet struct {
	// contains filtered or unexported fields
}

type MockWalletMockRecorder struct {
	// contains filtered or unexported fields
}

type OpenIDHandler interface {
	// Metadata returns the OAuth2 client metadata for the wallet.
	Metadata() openid4vci.OAuth2ClientMetadata
	// HandleCredentialOffer handles a credential offer from an issuer.
	// It will try to retrieve the offered credential and store it.
	HandleCredentialOffer(ctx context.Context, offer openid4vci.CredentialOffer) error
}

type PresentationOptions struct {
	// AdditionalContexts contains the contexts to be added in addition to https://www.w3.org/2018/credentials/v1 and the context for JSONWebSignature2020
	AdditionalContexts []ssi.URI
	// AdditionalTypes contains the VerifiablePresentation types in addition to VerifiablePresentation
	AdditionalTypes []ssi.URI
	// Holder specifies the holder property.
	Holder *ssi.URI
	// ProofOptions contains the options for a specific proof.
	ProofOptions proof.ProofOptions
	// Format contains the requested format for the VerifiablePresentation. If not set, it defaults to JSON-LD.
	// Valid options are: ldp_vp or jwt_vp
	Format string
}

type Wallet interface {
	core.Diagnosable

	// BuildPresentation builds and signs a Verifiable Presentation using the given Verifiable Credentials.
	// The assertion key used for signing it is taken from signerDID's DID document.
	// If signerDID is not provided, it will be derived from the credentials credentialSubject.id fields. But only if all provided credentials have the same (singular) credentialSubject.id field.
	BuildPresentation(ctx context.Context, credentials []vc.VerifiableCredential, options PresentationOptions, signerDID *did.DID, validateVC bool) (*vc.VerifiablePresentation, error)

	// BuildSubmission builds a Verifiable Presentation based on the given presentation definition.
	// additionalCredentials can be given to have the submission consider extra credentials that are not in the wallet.
	BuildSubmission(ctx context.Context, walletDIDs []did.DID, additionalCredentials map[did.DID][]vc.VerifiableCredential, presentationDefinition pe.PresentationDefinition, params BuildParams) (*vc.VerifiablePresentation, *pe.PresentationSubmission, error)

	// List returns all credentials in the wallet for the given holder.
	// If the wallet does not contain any credentials for the given holder, it returns an empty list.
	List(ctx context.Context, holderDID did.DID) ([]vc.VerifiableCredential, error)

	// SearchCredential returns all credentials in the wallet for the given holder.
	// Unlike List, which filters out expired and revoked credentials, SearchCredential returns all credentials
	// regardless of their validity status (signature, expired/revoked).
	// This can be used to find credentials that can be removed, e.g. because they are expired or revoked.
	SearchCredential(ctx context.Context, holderDID did.DID) ([]vc.VerifiableCredential, error)

	// Remove removes the given credential from the wallet.
	// If the credential is not in the wallet, it returns ErrNotFound.
	Remove(ctx context.Context, holderDID did.DID, credentialID ssi.URI) error

	// Put adds the given credentials to the wallet. It is an all-or-nothing operation:
	// if one of them fails, none of the credentials are added.
	Put(ctx context.Context, credentials ...vc.VerifiableCredential) error

	// IsEmpty returns true if the wallet contains no credentials at all (for all holder DIDs).
	IsEmpty() (bool, error)
}