add getLibraries method to TonCenter client

Author: neodix42

smartcontract/src/test/java/org/ton/ton4j/smartcontract/integrationtests/TestLibraryDeployer.java

@@ -2,6 +2,8 @@
 
 import java.math.BigInteger;
 import java.util.Collections;
+import java.util.Map;
+
 import lombok.extern.slf4j.Slf4j;
 import org.junit.Test;
 import org.junit.runner.RunWith;
@@ -16,10 +18,15 @@
 import org.ton.ton4j.tl.liteserver.responses.LibraryEntry;
 import org.ton.ton4j.tl.liteserver.responses.LibraryResult;
 import org.ton.ton4j.toncenter.TonCenter;
+import org.ton.ton4j.toncenter.TonResponse;
+import org.ton.ton4j.toncenter.model.GetLibrariesResponse;
 import org.ton.ton4j.tonlib.types.SmcLibraryEntry;
 import org.ton.ton4j.tonlib.types.SmcLibraryResult;
 import org.ton.ton4j.utils.Utils;
 
+import static org.junit.Assert.assertNotNull;
+import static org.junit.Assert.assertTrue;
+
 @Slf4j
 @RunWith(JUnit4.class)
 public class TestLibraryDeployer extends CommonTest {
@@ -52,6 +59,8 @@ public void testDeployLibraryDeployer() throws InterruptedException {
         10,
         "Deployment of LibraryDeployer will never happen. Lite-server will return an error, but the library will be deployed");
 
+    log.info("walletV5Code library hash(b64) in testnet {}", Utils.bytesToBase64(walletV5Code.getHash()));
+
     SmcLibraryResult smcLibraryResult =
         tonlib.getLibraries(
             Collections.singletonList(
@@ -70,6 +79,8 @@ public void testDeployLibraryDeployer() throws InterruptedException {
   @Test
   public void testIfLibraryHasBeenDeployed() {
     Cell walletV5Code = CellBuilder.beginCell().fromBoc(WalletCodes.V5R1.getValue()).endCell();
+    log.info("walletV5Code library hash(hex) in testnet {}", Utils.bytesToHex(walletV5Code.getHash()));
+    log.info("walletV5Code library hash(b64) in testnet {}", Utils.bytesToBase64(walletV5Code.getHash()));
     SmcLibraryResult smcLibraryResult =
         tonlib.getLibraries(Collections.singletonList(Utils.bytesToBase64(walletV5Code.getHash())));
     //                "IINLe3KxEhR+Gy+0V7hOdNGjDwT3N9T2KmaOlVLSty8="));
@@ -157,10 +168,22 @@ public void testDeployLibraryDeployerTonCenterClient() throws Exception {
         10,
         "Deployment of LibraryDeployer will never happen. Lite-server will return an error, but the library will be deployed");
 
-    // Note: TonCenter API doesn't provide a direct getLibraries method like AdnlLiteClient
-    // To verify library deployment, you would need to use other methods or check through
-    // a block explorer or other means
-    log.info("Library should be deployed at this point. Verify through other means if needed.");
+    TonResponse<GetLibrariesResponse> smcLibraryResult =
+            tonCenter.getLibraries(
+                    Collections.singletonList(
+                            Utils.bytesToHex(walletV5Code.getHash())
+                    ));
+    log.info("response {}", smcLibraryResult.getResult());
+
+    // The response should be successful even if libraries don't exist
+    assertTrue("Get libraries should be successful", smcLibraryResult.isSuccess());
+    assertNotNull("Libraries response should not be null", smcLibraryResult.getResult());
+
+    for (Map.Entry<String, String> entry : smcLibraryResult.getResult().getLibraries().entrySet()) {
+
+      Cell libCell = Cell.fromBoc(entry.getValue());
+      log.info("cell lib {}", libCell.toHex());
+    }
   }
 
   @Test
@@ -181,19 +204,4 @@ public void testIfLibraryHasBeenDeployedAdnlLiteClient() throws Exception {
       log.info("cell lib {}", libCell.toHex());
     }
   }
-  
-  @Test
-  public void testIfLibraryHasBeenDeployedTonCenterClient() throws Exception {
-    TonCenter tonCenter =
-        TonCenter.builder()
-            .apiKey(TESTNET_API_KEY)
-            .testnet()
-            .build();
-    Cell walletV5Code = CellBuilder.beginCell().fromBoc(WalletCodes.V5R1.getValue()).endCell();
-
-    // Note: TonCenter API doesn't provide a direct getLibraries method like AdnlLiteClient
-    // This test is a placeholder to maintain consistency with the AdnlLiteClient version
-    log.info("Library hash: {}", Utils.bytesToBase64(walletV5Code.getHash()));
-    log.info("To check if the library has been deployed, use other methods or external tools");
-  }
 }

toncenter/openapi-v2.json

@@ -570,6 +570,18 @@ public TonResponse<ConfigAllResponse> getConfigAll(Long seqno) {
     return executeGet("/getConfigAll", params, responseType);
   }
 
+  /** Get libraries codes */
+  public TonResponse<GetLibrariesResponse> getLibraries(List<String> libraries) {
+    Map<String, String> params = new HashMap<>();
+    if (nonNull(libraries) && !libraries.isEmpty()) {
+      // Join libraries with comma as the API expects array parameter
+      params.put("libraries", String.join(",", libraries));
+    }
+
+    Type responseType = new TypeToken<TonResponse<GetLibrariesResponse>>() {}.getType();
+    return executeGet("/getLibraries", params, responseType);
+  }
+
   // ========== TRANSACTION METHODS ==========
 
   /** Locate outcoming transaction of destination address by incoming message */

toncenter/src/main/java/org/ton/ton4j/toncenter/TonCenter.java

@@ -0,0 +1,12 @@
+package org.ton.ton4j.toncenter.model;
+
+import com.google.gson.annotations.SerializedName;
+import lombok.Data;
+import java.util.Map;
+
+/** Response for getLibraries endpoint */
+@Data
+public class GetLibrariesResponse {
+    @SerializedName("libraries")
+    private Map<String, String> libraries;
+}

toncenter/src/main/java/org/ton/ton4j/toncenter/model/GetLibrariesResponse.java

@@ -4,6 +4,8 @@
 import org.junit.Test;
 import org.junit.runner.RunWith;
 import org.junit.runners.Parameterized;
+import org.ton.ton4j.cell.Cell;
+import org.ton.ton4j.cell.CellBuilder;
 import org.ton.ton4j.toncenter.model.*;
 import static org.ton.ton4j.toncenter.model.CommonResponses.*;
 
@@ -560,6 +562,38 @@ public void testGetConfigAll() {
     }
   }
 
+  @Test
+  public void testGetLibraries() {
+    if (network == Network.MAINNET) {
+      log.info("Not yet implemented in MAINNET");
+      return;
+    }
+    enforceRateLimit();
+    TonCenter client = TonCenter.builder().apiKey(apiKey).network(network).build();
+
+    try {
+
+      // Test with some example library hashes (these may not exist, but tests the endpoint structure)
+      List<String> libraryHashes = Arrays.asList(
+          "IINLe3KxEhR+Gy+0V7hOdNGjDwT3N9T2KmaOlVLSty8=" // in testnet only
+//          "20834b7b72b112147e1b2fb457b84e74d1a30f04f737d4f62a668e9552d2b72f" // in testnet only
+      );
+      
+      TonResponse<GetLibrariesResponse> response = client.getLibraries(libraryHashes);
+      log.info("response {}", response.getResult());
+      
+      // The response should be successful even if libraries don't exist
+      assertTrue("Get libraries should be successful", response.isSuccess());
+      assertNotNull("Libraries response should not be null", response.getResult());
+      log.info("Libraries retrieved successfully");
+    } catch (TonCenterApiException e) {
+      // This is expected if the library hashes don't exist
+      log.info("Libraries not found (expected): {}", e.getMessage());
+    } finally {
+      client.close();
+    }
+  }
+
   // ========== TRANSACTION METHODS TESTS (3 endpoints) ==========
 
   @Test
@@ -826,7 +860,7 @@ public void testApiKeyValidation() {
   @Test
   public void testAllEndpointsCount() {
     enforceRateLimit();
-    // This test verifies that all 27 endpoints are implemented
+    // This test verifies that all 28 endpoints are implemented
 
     TonCenter client = TonCenter.builder().build();
 
@@ -859,9 +893,10 @@ public void testAllEndpointsCount() {
     assertNotNull("getBlockHeader should exist", getMethod(client, "getBlockHeader"));
     assertNotNull("getOutMsgQueueSizes should exist", getMethod(client, "getOutMsgQueueSizes"));
 
-    // Config methods (2)
+    // Config methods (3)
     assertNotNull("getConfigParam should exist", getMethod(client, "getConfigParam"));
     assertNotNull("getConfigAll should exist", getMethod(client, "getConfigAll"));
+    assertNotNull("getLibraries should exist", getMethod(client, "getLibraries"));
 
     // Transaction methods (3)
     assertNotNull("tryLocateTx should exist", getMethod(client, "tryLocateTx"));
@@ -877,7 +912,7 @@ public void testAllEndpointsCount() {
     assertNotNull("sendQuery should exist", getMethod(client, "sendQuery"));
     assertNotNull("estimateFee should exist", getMethod(client, "estimateFee"));
 
-    log.info("✅ All 27 TonCenter API endpoints are implemented!");
+    log.info("✅ All 28 TonCenter API endpoints are implemented!");
     client.close();
   }