Updates for /assets and /claimable_balances/*/(operations|transaction…

…s) endpoints (#628)

* add new endpoints for /claimable_balances

* Add new /asset balances and accounts fields

* Update server_test for new asset fields

* Add tests for new claimable_balances endpoints

* update changelog

CHANGELOG.md

@@ -4,6 +4,9 @@ A breaking change will get clearly marked in this log.
 
 ## Unreleased
 
+- Added TransactionCallBuilder.forClaimableBalance(), and OperationCallBuilder.forClaimableBalance().
+- Added support for new `accounts`, `balances`, `claimable_balances_amount`, and `num_claimable_balances` fields on Assets.
+
 
 ## [v8.1.1](https://github.com/stellar/js-stellar-sdk/compare/v8.1.0...v8.1.1)
 

src/horizon_api.ts

@@ -88,6 +88,17 @@ export namespace Horizon {
     ? BalanceLineAsset<T>
     : BalanceLineNative | BalanceLineAsset;
 
+  export interface AssetAccounts {
+    authorized: number;
+    authorized_to_maintain_liabilities: number;
+    unauthorized: number;
+  }
+  export interface AssetBalances {
+    authorized: string;
+    authorized_to_maintain_liabilities: string;
+    unauthorized: string;
+  }
+
   export interface PriceR {
     numerator: number;
     denominator: number;

src/operation_call_builder.ts

@@ -47,6 +47,17 @@ export class OperationCallBuilder extends CallBuilder<
     return this;
   }
 
+  /**
+   * This endpoint represents all operations that reference a given claimable_balance.
+   * @see [Operations for Claimable Balance](https://www.stellar.org/developers/horizon/reference/endpoints/operations-for-claimable-balance.html)
+   * @param {string} claimableBalanceId Claimable Balance ID
+   * @returns {OperationCallBuilder} this OperationCallBuilder instance
+   */
+  public forClaimableBalance(claimableBalanceId: string): this {
+    this.filter.push(["claimable_balances", claimableBalanceId, "operations"]);
+    return this;
+  }
+
   /**
    * This endpoint returns all operations that occurred in a given ledger.
    *

src/server_api.ts

@@ -393,6 +393,10 @@ export namespace ServerApi {
     asset_code: string;
     asset_issuer: string;
     paging_token: string;
+    accounts: Horizon.AssetAccounts;
+    num_claimable_balances: number;
+    balances: Horizon.AssetBalances;
+    claimable_balances_amount: string;
     amount: string;
     num_accounts: number;
     flags: Horizon.Flags;

src/transaction_call_builder.ts

@@ -46,6 +46,17 @@ export class TransactionCallBuilder extends CallBuilder<
     return this;
   }
 
+  /**
+   * This endpoint represents all transactions that reference a given claimable_balance.
+   * @see [Operations for Claimable Balance](https://www.stellar.org/developers/horizon/reference/endpoints/transactions-for-claimable-balance.html)
+   * @param {string} claimableBalanceId Claimable Balance ID
+   * @returns {TransactionCallBuilder} this TransactionCallBuilder instance
+   */
+  public forClaimableBalance(claimableBalanceId: string): this {
+    this.filter.push(["claimable_balances", claimableBalanceId, "transactions"]);
+    return this;
+  }
+
   /**
    * This endpoint represents all transactions in a given ledger.
    * @see [Transactions for Ledger](https://www.stellar.org/developers/horizon/reference/endpoints/transactions-for-ledger.html)