14: Adding JavaDoc

2026-06-26 14:09:16 +02:00
parent f7e08b46b7
commit 10fc0ff41c
1 changed files with 16 additions and 0 deletions
@@ -144,6 +144,22 @@ public interface SolanaBlockChain {
            SolanaSPLTokenProgram splProgram
    ) throws IOException, InterruptedException;

+    /**
+     * Fetches accounts owned by a Solana program using server-side account data filters.
+     *
+     * <p>This method uses Solana's {@code getProgramAccounts} RPC call. The supplied filters
+     * are sent to the RPC node, so matching is performed server-side instead of fetching all
+     * accounts owned by the program and filtering them locally.</p>
+     *
+     * <p>The initial supported filter type is {@link SolanaProgramAccountMemcmpFilter}, which
+     * matches bytes at a specific offset in the account data.</p>
+     *
+     * @param programId the Solana program id that owns the accounts to search
+     * @param filters the memcmp filters to apply when searching program accounts
+     * @return the matching program accounts
+     * @throws IOException if the program accounts could not be fetched or parsed
+     * @throws InterruptedException if the calling thread is interrupted while fetching program accounts
+     */
    Set<SolanaAccountInfo> getProgramAccounts(
            ΩSolanaProgramIdΩ programId,
            Set<SolanaProgramAccountMemcmpFilter> filters