From c6090bc842d5857945af682fcaf0e65232cd0b32 Mon Sep 17 00:00:00 2001
From: jpe7s <jpe7s.salt188@passfwd.com>
Date: Sun, 29 Sep 2024 17:30:45 -0500
Subject: [PATCH] documents api endpoints.

---
 solana/README.md                              | 55 ++++++++++++++++++-
 .../lookup/http/LookupTableWebService.java    |  4 +-
 2 files changed, 54 insertions(+), 5 deletions(-)

diff --git a/solana/README.md b/solana/README.md
index 9327a48..25efd52 100644
--- a/solana/README.md
+++ b/solana/README.md
@@ -1,8 +1,57 @@
 # Address Lookup Table Service
 
-## Configuration
+## Call
 
-### Example Configuration
+### Discover Tables
+
+Attempts to find one or more tables to help minimize the size of a transaction.
+
+#### POST `/v0/alt/discover/tx/raw`
+
+Post a serialized and encoded legacy or version zero transaction.
+
+```shell
+curl -d 'AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABAAcJDPVl6eB0qtYSlYif4b0tHW4ZfMrzSctd89y3PLhgsgb5JSlSZ9949Yv51O5NL2l3MVmpE3aLBgO3xqjQetH9/VRfow6jvD88KWbai2w9/vjTq32lfKAjKlTkoCZP/8PCCVTbvp7JYMmKeik/4hM2lm/hgNFRrkuBeVYfiYVKU/bMt8aVjwPz6dRn5EI8Gsat6wewXzwVooLo4DMVwF9Wd5cdDKvImMwegHYSrqlRr4mPm/gqRPWD+8llAWp4/D4KbwB9xBeu8gamlEHq3LaZuMqqSvkDUq1wkM++qfgfpGsr1lQqaOSFYS9WELcT14N7mJY9eLJbJXlsZ9Z5/AUPNko+70sDyCpxWZ6gehbuS89tzjE1fYRgsqwb1MOphgydAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABAwgIAQAEBQIHBihFoV3KeH5MuQEBAAAA4fUFAAAAAADh9QUAAAAAAAAAAQAAAAAAAAAA' \
+  'http://localhost:4242/v0/alt/tx/raw?accountsOnly=true'; 
+```
+
+* **headers**:
+    * **X-BYTE-ENCODING**: Encoding of the posted transaction.
+        * `hex`
+        * `base64`: default
+* **query**:
+    * **accountsOnly**:
+        * `true`: An array of base58 encoded lookup table public keys will be returned.
+        * `false`: (default) An array of objects including both the table public key and the base64 encoded program
+          account will
+          be
+          returned.
+* **body**: serialized and encoded transaction.
+
+#### POST `/v0/alt/discover/accounts`
+
+If you know the set of accounts commonly used in your transactions this endpoint can be more useful than posting a
+transaction.
+
+Note: do not include invoked program accounts or signers.
+
+```shell
+curl -d '["8UJgxaiQx5nTrdDgph5FiahMmzduuLTLf5WmsPegYA6W","2UZMvVTBQR9yWxrEdzEQzXWE61bUjqQ5VpJAGqVb3B19","25Eax9W8SA3wpCQFhJEGyHhQ2NDHEshZEDzyMNtthR8D","7QAtMC3AaAc91W4XuwYXM1Mtffq9h9Z8dTxcJrKRHu1z"]' \
+  'http://localhost:4242/v0/alt/accounts?accountsOnly=true';
+```
+
+* **query**:
+    * **accountsOnly**:
+        * `true`: An array of base58 encoded lookup table public keys will be returned.
+        * `false`: (default) An array of objects including both the table public key and the base64 encoded program
+          account will
+          be
+          returned.
+* **body**: JSON array of base58 encoded accounts.
+
+## Service Configuration
+
+### Example
 
 Reference the documentation below for anything that is not implicitly clear and needs context.
 
@@ -127,7 +176,7 @@ RPC nodes.
     * **capacity**: Overrides `defaultCapacity`.
     * **backoff**: Overrides `defaultBackoff`.
 
-## Run Service
+## Run Table Service
 
 ### Docker
 
diff --git a/solana/src/main/java/software/sava/services/solana/accounts/lookup/http/LookupTableWebService.java b/solana/src/main/java/software/sava/services/solana/accounts/lookup/http/LookupTableWebService.java
index 34284c2..38f4a45 100644
--- a/solana/src/main/java/software/sava/services/solana/accounts/lookup/http/LookupTableWebService.java
+++ b/solana/src/main/java/software/sava/services/solana/accounts/lookup/http/LookupTableWebService.java
@@ -39,8 +39,8 @@ public static void main(final String[] args) throws IOException, InterruptedExce
             serviceConfig.rpcClients(),
             CachedAddressLookupTable.FACTORY
         );
-        httpServer.createContext("/v0/alt/tx/raw", new FromRawTxHandler(tableService, tableCache));
-        httpServer.createContext("/v0/alt/accounts", new FromAccountsHandler(tableService, tableCache));
+        httpServer.createContext("/v0/alt/discover/tx/raw", new FromRawTxHandler(tableService, tableCache));
+        httpServer.createContext("/v0/alt/discover/accounts", new FromAccountsHandler(tableService, tableCache));
 
         tableService.initializedFuture().join();
         httpServer.start();