feat: view wallet rewards

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: {
+          $wallet: wallet,
+          $with_pending: withPending,
+        },
+      },
+      this.kwilSigner,
+    );
+
+    if (result.status !== 200) {
+      throw new Error(`Failed to list wallet rewards: ${result.status}`);
+    }
+
+    return result.data?.result || [];
+  }
 }