Feature/token tap

.gitignore

@@ -242,4 +242,6 @@ java/src/main/java/co/meshtrade/api/**/*ServiceClient.java
 java/src/main/java/co/meshtrade/api/**/*ServiceInterface.java
 # Note: All meshjava generated files contain "Generated by protoc-gen-meshjava. DO NOT EDIT." header.serena/
 
-/thoughts/
+/thoughts/
+
+.vscode

docs/docs/api-reference/ledger/tap/v1/index.mdx

@@ -0,0 +1,43 @@
+---
+sidebar_position: 1
+---
+
+# Ledger Tap v1 Service
+
+#### Skip The Details?
+- 👉 Jump to **[Package Types](/docs/api-reference/ledger/tap/v1/type)**
+- 👉 Jump to **[Service Methods](/docs/api-reference/ledger/tap/v1/service)**
+
+{/*
+Generated by protoc-gen-meshdoc the first time.
+-> This file can be edited manually to add information about the Ledger Tap Service.
+
+THIS COMMENT AND EVERYTHING ABOVE IT IS AUTOGENERATED
+*/}
+
+:::warning[SDK and Documentation Under Construction 🚧]
+This warning will be removed once complete and ready for use.
+:::
+
+## Overview
+
+
+
+Add your custom documentation for the Ledger Tap v1 service here.
+This file is generated once and can be manually edited to provide
+service-specific information, examples, and usage guidance.
+
+## Quick Start
+
+1. **Configure your client** with the appropriate credentials
+2. **Choose your operations** from the available service methods
+3. **Review the types** to understand request/response structures
+
+## Common Workflows
+
+Add common workflow documentation here specific to this service.
+
+## Authentication & Authorization
+
+This service requires appropriate role-based permissions. 
+See the individual method documentation for specific role requirements.

docs/docs/api-reference/ledger/tap/v1/service/initialise-token-taps/example.go

@@ -0,0 +1,35 @@
+package main
+
+import (
+	"context"
+	"log"
+
+	tapv1 "github.com/meshtrade/api/go/ledger/tap/v1"
+)
+
+func main() {
+	ctx := context.Background()
+
+	// Default configuration is used and credentials come from MESH_API_CREDENTIALS
+	// environment variable or default discovery methods. Zero config required
+	// unless you want custom configuration.
+	service, err := tapv1.NewTokenTapService()
+	if err != nil {
+		log.Fatalf("Failed to create service: %v", err)
+	}
+	defer service.Close()
+
+	// Create request with service-specific parameters
+	request := &tapv1.InitialiseTokenTapsRequest{
+		// FIXME: Populate service-specific request fields
+	}
+
+	// Call the InitialiseTokenTaps method
+	response, err := service.InitialiseTokenTaps(ctx, request)
+	if err != nil {
+		log.Fatalf("InitialiseTokenTaps failed: %v", err)
+	}
+
+	// FIXME: Add relevant response object usage
+	log.Printf("InitialiseTokenTaps successful: %+v", response)
+}

docs/docs/api-reference/ledger/tap/v1/service/initialise-token-taps/example.java

@@ -0,0 +1,28 @@
+import co.meshtrade.api.ledger.tap.v1.TapService;
+import co.meshtrade.api.ledger.tap.v1.Service.InitialiseTokenTapsRequest;
+import co.meshtrade.api.ledger.tap.v1.Service.InitialiseTokenTapsResponse;
+
+import java.util.Optional;
+
+public class InitialiseTokenTapsExample {
+    public static void main(String[] args) {
+        // Default configuration is used and credentials come from MESH_API_CREDENTIALS
+        // environment variable or default discovery methods. Zero config required
+        // unless you want custom configuration.
+        try (TapService service = new TapService()) {
+            // Create request with service-specific parameters
+            InitialiseTokenTapsRequest request = InitialiseTokenTapsRequest.newBuilder()
+                // FIXME: Populate service-specific request fields
+                .build();
+
+            // Call the InitialiseTokenTaps method
+            InitialiseTokenTapsResponse response = service.initialiseTokenTaps(request, Optional.empty());
+
+            // FIXME: Add relevant response object usage
+            System.out.println("InitialiseTokenTaps successful: " + response);
+        } catch (Exception e) {
+            System.err.println("InitialiseTokenTaps failed: " + e.getMessage());
+            e.printStackTrace();
+        }
+    }
+}

docs/docs/api-reference/ledger/tap/v1/service/initialise-token-taps/example.py

@@ -0,0 +1,27 @@
+from meshtrade.ledger.tap.v1 import (
+    InitialiseTokenTapsRequest,
+    TapService,
+)
+
+
+def main():
+    # Default configuration is used and credentials come from MESH_API_CREDENTIALS
+    # environment variable or default discovery methods. Zero config required
+    # unless you want custom configuration.
+    service = TapService()
+
+    with service:
+        # Create request with service-specific parameters
+        request = InitialiseTokenTapsRequest(
+            # FIXME: Populate service-specific request fields
+        )
+
+        # Call the InitialiseTokenTaps method
+        response = service.initialise_token_taps(request)
+
+        # FIXME: Add relevant response object usage
+        print("InitialiseTokenTaps successful:", response)
+
+
+if __name__ == "__main__":
+    main()

docs/docs/api-reference/ledger/tap/v1/service/list-token-taps/example.go

@@ -0,0 +1,35 @@
+package main
+
+import (
+	"context"
+	"log"
+
+	tapv1 "github.com/meshtrade/api/go/ledger/tap/v1"
+)
+
+func main() {
+	ctx := context.Background()
+
+	// Default configuration is used and credentials come from MESH_API_CREDENTIALS
+	// environment variable or default discovery methods. Zero config required
+	// unless you want custom configuration.
+	service, err := tapv1.NewTokenTapService()
+	if err != nil {
+		log.Fatalf("Failed to create service: %v", err)
+	}
+	defer service.Close()
+
+	// Create request with service-specific parameters
+	request := &tapv1.ListTokenTapsRequest{
+		// FIXME: Populate service-specific request fields
+	}
+
+	// Call the ListTokenTaps method
+	response, err := service.ListTokenTaps(ctx, request)
+	if err != nil {
+		log.Fatalf("ListTokenTaps failed: %v", err)
+	}
+
+	// FIXME: Add relevant response object usage
+	log.Printf("ListTokenTaps successful: %+v", response)
+}

docs/docs/api-reference/ledger/tap/v1/service/list-token-taps/example.java

@@ -0,0 +1,28 @@
+import co.meshtrade.api.ledger.tap.v1.TapService;
+import co.meshtrade.api.ledger.tap.v1.Service.ListTokenTapsRequest;
+import co.meshtrade.api.ledger.tap.v1.Service.ListTokenTapsResponse;
+
+import java.util.Optional;
+
+public class ListTokenTapsExample {
+    public static void main(String[] args) {
+        // Default configuration is used and credentials come from MESH_API_CREDENTIALS
+        // environment variable or default discovery methods. Zero config required
+        // unless you want custom configuration.
+        try (TapService service = new TapService()) {
+            // Create request with service-specific parameters
+            ListTokenTapsRequest request = ListTokenTapsRequest.newBuilder()
+                // FIXME: Populate service-specific request fields
+                .build();
+
+            // Call the ListTokenTaps method
+            ListTokenTapsResponse response = service.listTokenTaps(request, Optional.empty());
+
+            // FIXME: Add relevant response object usage
+            System.out.println("ListTokenTaps successful: " + response);
+        } catch (Exception e) {
+            System.err.println("ListTokenTaps failed: " + e.getMessage());
+            e.printStackTrace();
+        }
+    }
+}

docs/docs/api-reference/ledger/tap/v1/service/list-token-taps/example.py

@@ -0,0 +1,27 @@
+from meshtrade.ledger.tap.v1 import (
+    ListTokenTapsRequest,
+    TapService,
+)
+
+
+def main():
+    # Default configuration is used and credentials come from MESH_API_CREDENTIALS
+    # environment variable or default discovery methods. Zero config required
+    # unless you want custom configuration.
+    service = TapService()
+
+    with service:
+        # Create request with service-specific parameters
+        request = ListTokenTapsRequest(
+            # FIXME: Populate service-specific request fields
+        )
+
+        # Call the ListTokenTaps method
+        response = service.list_token_taps(request)
+
+        # FIXME: Add relevant response object usage
+        print("ListTokenTaps successful:", response)
+
+
+if __name__ == "__main__":
+    main()

docs/docs/api-reference/ledger/tap/v1/service/mint-token/example.go

@@ -0,0 +1,35 @@
+package main
+
+import (
+	"context"
+	"log"
+
+	tapv1 "github.com/meshtrade/api/go/ledger/tap/v1"
+)
+
+func main() {
+	ctx := context.Background()
+
+	// Default configuration is used and credentials come from MESH_API_CREDENTIALS
+	// environment variable or default discovery methods. Zero config required
+	// unless you want custom configuration.
+	service, err := tapv1.NewTokenTapService()
+	if err != nil {
+		log.Fatalf("Failed to create service: %v", err)
+	}
+	defer service.Close()
+
+	// Create request with service-specific parameters
+	request := &tapv1.MintTokenRequest{
+		// FIXME: Populate service-specific request fields
+	}
+
+	// Call the MintToken method
+	response, err := service.MintToken(ctx, request)
+	if err != nil {
+		log.Fatalf("MintToken failed: %v", err)
+	}
+
+	// FIXME: Add relevant response object usage
+	log.Printf("MintToken successful: %+v", response)
+}

docs/docs/api-reference/ledger/tap/v1/service/mint-token/example.java

@@ -0,0 +1,28 @@
+import co.meshtrade.api.ledger.tap.v1.TapService;
+import co.meshtrade.api.ledger.tap.v1.Service.MintTokenRequest;
+import co.meshtrade.api.ledger.tap.v1.Service.MintTokenResponse;
+
+import java.util.Optional;
+
+public class MintTokenExample {
+    public static void main(String[] args) {
+        // Default configuration is used and credentials come from MESH_API_CREDENTIALS
+        // environment variable or default discovery methods. Zero config required
+        // unless you want custom configuration.
+        try (TapService service = new TapService()) {
+            // Create request with service-specific parameters
+            MintTokenRequest request = MintTokenRequest.newBuilder()
+                // FIXME: Populate service-specific request fields
+                .build();
+
+            // Call the MintToken method
+            MintTokenResponse response = service.mintToken(request, Optional.empty());
+
+            // FIXME: Add relevant response object usage
+            System.out.println("MintToken successful: " + response);
+        } catch (Exception e) {
+            System.err.println("MintToken failed: " + e.getMessage());
+            e.printStackTrace();
+        }
+    }
+}

docs/docs/api-reference/ledger/tap/v1/service/mint-token/example.py

@@ -0,0 +1,27 @@
+from meshtrade.ledger.tap.v1 import (
+    MintTokenRequest,
+    TapService,
+)
+
+
+def main():
+    # Default configuration is used and credentials come from MESH_API_CREDENTIALS
+    # environment variable or default discovery methods. Zero config required
+    # unless you want custom configuration.
+    service = TapService()
+
+    with service:
+        # Create request with service-specific parameters
+        request = MintTokenRequest(
+            # FIXME: Populate service-specific request fields
+        )
+
+        # Call the MintToken method
+        response = service.mint_token(request)
+
+        # FIXME: Add relevant response object usage
+        print("MintToken successful:", response)
+
+
+if __name__ == "__main__":
+    main()

docs/docs/api-reference/wallet/account/v1/service/create-account/example.java

@@ -1,4 +1,3 @@
-import co.meshtrade.api.type.v1.Ledger;
 import co.meshtrade.api.wallet.account.v1.AccountService;
 import co.meshtrade.api.wallet.account.v1.Service.CreateAccountRequest;
 import co.meshtrade.api.wallet.account.v1.Account.Account;
@@ -23,7 +22,6 @@ public static void main(String[] args) {
             // Call the CreateAccount method
             Account account = service.createAccount(request, Optional.empty());
 
-            // The account is created but not yet open on-chain
             System.out.println("Account created successfully:");
             System.out.println("  Name: " + account.getName());
             System.out.println("  Number: " + account.getNumber());