feat: view wallet rewards (#129)

* feat: view wallet rewards

* test: get rewards

* feat: list

Author: williamrusdyputra

src/client/client.ts

@@ -285,6 +285,18 @@ export abstract class BaseTNClient<T extends EnvironmentType> {
     return bridgeResult.data.tx_hash;
   }
 
+  /**
+   * Lists wallet rewards for a specific wallet address on a blockchain network
+   * @param chain The chain identifier (e.g., "sepolia", "mainnet", "polygon", etc.)
+   * @param wallet The wallet address to list rewards for
+   * @param withPending Whether to include pending rewards
+   * @returns Promise that resolves to an array of rewards data
+   */
+  async listWalletRewards(chain: string, wallet: string, withPending: boolean): Promise<any[]> {
+    const action = this.loadAction();
+    return action.listWalletRewards(chain, wallet, withPending);
+  }
+
   /**
    * Gets taxonomies for specific streams in batch.
    * High-level wrapper for ComposedAction.getTaxonomiesForStreams()

src/contracts-api/action.ts

@@ -1030,4 +1030,35 @@ export class Action {
       $amount: amount
     }]);
   }
+
+  /**
+   * Lists wallet rewards on a blockchain network
+   * @param chain The chain identifier (e.g., "sepolia", "mainnet", "polygon", etc.)
+   * @param wallet The wallet address to list rewards for
+   * @param withPending Whether to include pending rewards
+   * @returns Promise that resolves to the rewards data
+   */
+  public async listWalletRewards(
+    chain: string,
+    wallet: string,
+    withPending: boolean
+  ): Promise<any[]> {
+    const result = await this.kwilClient.call(
+      {
+        namespace: `${chain}_bridge`,
+        name: "list_wallet_rewards",
+        inputs: {
+          $param_1: wallet,
+          $param_2: withPending,
+        },
+      },
+      this.kwilSigner,
+    );
+
+    if (result.status !== 200) {
+      throw new Error(`Failed to list wallet rewards: ${result.status}`);
+    }
+
+    return result.data?.result || [];
+  }
 }

tests/integration/erc20Bridge.test.ts

@@ -58,4 +58,25 @@ describe('ERC20 Bridge Tests', () => {
       throw error;
     }
   }, 60000);
+
+  test('get wallet rewards', async () => {
+    try {
+      const rewards = await authorizedClient.listWalletRewards(
+        "sepolia",
+        "0x041AEfDc96655d3Dbf7788767dcEEB635eCD315C",
+        true
+      );
+
+      expect(Array.isArray(rewards)).toBe(true);
+
+      } catch (error: any) {
+        // Skip test if backend is unavailable in test environment
+        if (error.message?.includes("no available backend")) {
+          console.info("Skipping test: blockchain backend unavailable in test environment");
+          return;
+        }
+        throw error;
+      }
+    }, 60000);
+
 });