AffinidiTdk.WalletsClient 1.4.0

Affinidi TDK .NET client for Wallets

Affinidi TDK dotnet client for Affinidi WALLETS

Getting Started

Prerequisites

• .NET 8 SDK (minimum version: 8.0.400)

Check your installed version:

dotnet --version

Installation

These are the steps to get you started with a dotnet project and integration with AffinidiTdk.WalletsClient.

Steps 1 & 2 are optional if you have already created a project.

1. Create a new project directory

*On macOS / Linux / Windows (Powershell) 😗

mkdir MyProject
cd MyProject

2. Initialize a .NET Project (dotnet template: console)

dotnet new console

3. Installing the TDK Client (from nuget.org)

dotnet add package AffinidiTdk.WalletsClient

Usage

The AffinidiTdk.WalletsClient uses authorisation token to authenticate client requests. You can generate a token with the use of the AuthProvider package which is also available in nuget.org.

To generate a token, you first need to create your Personal Access Token (PAT). Please refer to this link.

1. Import the required dependencies

The dependencies required may differ based on the Client API used in your application.

using AffinidiTdk.AuthProvider;
using AffinidiTdk.WalletsClient.Api;
using AffinidiTdk.WalletsClient.Client;
using AffinidiTdk.WalletsClient.Model;

2. Create an AuthProvider

var authProvider = new AuthProvider(new AuthProviderParams
{
    // Please generate your own Personal Access Tokens (PAT). 
    // Refer to https://docs.affinidi.com/dev-tools/affinidi-tdk/get-access-token/#create-a-personal-access-token-pat for the guide on creating your own PAT.    
    TokenId = "YOUR_TOKEN_ID",
    PrivateKey = "YOUR_PRIVATE_KEY",
    ProjectId = "YOUR_PROJECT_ID"
    // Passphrase = "YOUR_PASSPHRASE", // Required only if provided in the PAT
});

3. Fetch the ProjectScopedToken from the AuthProvider

string projectScopedToken = await authProvider.FetchProjectScopedTokenAsync();

4. Create an instance of the Client Configuration

• In this step, you can set the projectScopedToken in the configuration.

Configuration config = new Configuration();

config.AddApiKey("authorization", projectScopedToken);

5. Create an instance of the Client API you intend to use

• In this step, you should pass the config as a constructor argument in the Client API. NOTE: Each Operation requires different input. Please refer to the operation documentation for the details.

RevocationApi api = new RevocationApi(config);

var projectId = "projectId_example";
var walletId = "walletId_example";
var statusId = "statusId_example";

GetRevocationListCredentialResultDto result = api.GetRevocationCredentialStatus(projectId, walletId, statusId);

Console.WriteLine(result.ToJson());

For more examples, please refer to the Documentation.

Token Refresh

When handling tokens, it is important that your project access token is managed properly to prevent failures due to expired tokens.

We have created an example code which handles the automatic refresh of tokens to ensure that the token used in the client APIs are fresh.

Documentation

Client API Documentation

Note: Each Client API operation requires a different authorization token. Please check the operation details for the type of token required to use the operation properly.

Documentation For Models

• AuthcryptMessageInput
• AuthcryptMessageResultDto
• CreateWalletInput
• CreateWalletResponse
• CreateWalletV2Input
• CreateWalletV2Response
• EntityNotFoundError
• GetRevocationCredentialStatusOK
• GetRevocationListCredentialResultDto
• InvalidDidParameterError
• InvalidParameterError
• KeyNotFoundError
• NotFoundError
• OperationForbiddenError
• RevokeCredentialInput
• RevokeCredentialsInput
• ServiceErrorResponse
• ServiceErrorResponseDetailsInner
• SignCredential400Response
• SignCredentialInputDto
• SignCredentialInputDtoUnsignedCredentialParams
• SignCredentialResultDto
• SignCredentialsDm1LdInputDto
• SignCredentialsDm1LdResultDto
• SignCredentialsDm2SdJwtInputDto
• SignCredentialsDm2SdJwtResultDto
• SignCredentialsJwtInputDto
• SignCredentialsJwtResultDto
• SignCredentialsLdpInputDto
• SignCredentialsLdpResultDto
• SignJwtToken
• SignJwtTokenOK
• SignMessageInput
• SignMessageResultDto
• SignPresentationLdpInputDto
• SignPresentationLdpResultDto
• SigningFailedError
• TooManyRequestsError
• UnpackMessageInput
• UnpackMessageResultDto
• UpdateWalletInput
• WalletDto
• WalletDtoKeysInner
• WalletV2Dto
• WalletsListDto

Support & Feedback

If you face any issues or have suggestions, please don't hesitate to contact us using this link.

Reporting technical issues

If you have a technical issue with the Affinidi TDK's codebase, you can also create an issue directly in GitHub.

1. Ensure the bug was not already reported by searching on GitHub under Issues.

2. If you're unable to find an open issue addressing the problem, open a new one. Be sure to include a title and clear description, as much relevant information as possible, and a code sample or an executable test case demonstrating the expected behavior that is not occurring.

Contributing

We enjoy community contributions! Whether it’s bug fixes, feature requests, or improving docs, your input helps shape the Affinidi TDK.

• Head over to our CONTRIBUTING to get started.
• Have an idea? Start a discussion in GitHub Discussions or Discord