> This page is for Taurus PROTECT, version v3.42.
> For other versions, use one of these documentation indexes:
> - v3.58 (default): https://taurushq.ferndocs.com/protect-capital/v3.58/llms.txt
> - v3.56: https://taurushq.ferndocs.com/protect-capital/v3.56/llms.txt
> - v3.54: https://taurushq.ferndocs.com/protect-capital/v3.54/llms.txt
> - v3.52: https://taurushq.ferndocs.com/protect-capital/v3.52/llms.txt
> - v3.50: https://taurushq.ferndocs.com/protect-capital/v3.50/llms.txt
> - v3.48: https://taurushq.ferndocs.com/protect-capital/v3.48/llms.txt
> - v3.46: https://taurushq.ferndocs.com/protect-capital/v3.46/llms.txt
> - v3.44: https://taurushq.ferndocs.com/protect-capital/v3.44/llms.txt
> - v3.42: https://taurushq.ferndocs.com/protect-capital/v3.42/llms.txt
> - v3.40: https://taurushq.ferndocs.com/protect-capital/v3.40/llms.txt
> - v3.38: https://taurushq.ferndocs.com/protect-capital/v3.38/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://taurushq.ferndocs.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://taurushq.ferndocs.com/_mcp/server.

# SDK github repo

# Taurus-PROTECT Java SDK

This repository provides example Java code to consume some of the APIs of Taurus-PROTECT, covering:

* Wallet and deposit address lifecycle management
* Transactions creation and approval
* Querying blockchain assets and transaction history
* Compliance and governance operations

Repository: [https://github.com/taurushq-io/taurus-protect-sdk-java](https://github.com/taurushq-io/taurus-protect-sdk-java)

---

## Modules

This repository contains two Java modules:

* **openapi**: Auto-generated from Taurus OpenAPI specifications. This module should **not be modified**.
* **client**: Higher-level Java code based on the openapi module. This is the recommended interface to interact with Taurus-PROTECT APIs.

---

## Build

The SDK requires Java 8 (tested with Amazon Corretto 8) and Maven.

To compile the SDK, run:

```bash
mvn clean compile
```

To install the SDK locally, run:

```bash
mvn clean install
```

## Usage

To start interacting with Taurus-PROTECT APIs, create a `ProtectClient `instance with your host and credentials:

```java

String host = "http://localhost:6000"; // Replace with your Taurus-PROTECT instance
String apiKey = "your-api-key";
String apiSecret = "your-api-secret";

ProtectClient client = new ProtectClient(host, apiKey, apiSecret);
```

### Example: Create an Address

```java

try {
    Address a = client.getAddressService().createAddress(
        1,              // Wallet ID
        "My Address",   // Address name
        "Optional comment",
        ""              // Empty string to generate address
    );
    System.out.println("Created address: " + a);
} catch (ApiException e) {
    System.out.println("API error: " + e.getMessage());
    System.out.println("Details: " + e.getError());
    throw new RuntimeException(e);
}

```

More examples are available in the client/src/test/java directory.

## Notes

* Use the `client `module for all API interactions.
* The `openapi `module is auto-generated and should not be manually modified.

## License

This SDK is provided under the Apache 2.0 License.