stellar-sdk - npm Package Versions

v9.0.0-beta.0

This beta release adds support for Automated Market Makers. For details, you can refer to CAP-38 for XDR changes and this document for detailed changes to the Horizon API.

Add

• Introduced a LiquidityPoolCallBuilder to make calls to a new endpoint:

  • /liquidity_pools[?reserves=...] - a collection of liquidity pools, optionally filtered by one or more assets (#682)
  • /liquidity_pools/:id - a specific liquidity pool (#687)

• Expanded the TransactionCallBuilder, OperationCallBuilder, and EffectsCallBuilders to apply to specific liquidity pools (#689). This corresponds to the following new endpoints:

  • /liquidity_pools/:id/transactions
  • /liquidity_pools/:id/operations
  • /liquidity_pools/:id/effects

• Expanded the TradesCallBuilder to support fetching liquidity pool trades and accepts a new trade_type filter (#685):

  • /trades?trade_type={orderbook,liquidity_pools,all}. By default, the filter is all, including both liquidity pool and orderbook records.
  • A liquidity pool trade contains the following fields:
    • liquidity_pool_fee_bp: LP fee expressed in basis points, and either
    • base_liquidity_pool_id or counter_liquidity_pool_id

• Added new effects related to liquidity pools (#690):

  • DepositLiquidityEffect
  • WithdrawLiquidityEffect
  • LiquidityPoolTradeEffect
  • LiquidityPoolCreatedEffect
  • LiquidityPoolRemovedEffect
  • LiquidityPoolRevokedEffect

• Added new responses related to liquidity pool operations (#692):

  • DepositLiquidityOperationResponse
  • WithdrawLiquidityOperationResponse

Updates

• Updated the underlying stellar-base library to v6.0.1 to include CAP-38 changes (#681).

• Updated various developer dependencies to secure versions (#671).

• Updated AccountResponse to include liquidity pool shares in its balances field (#688).

• Updated AccountCallBuilder to allow filtering based on participation in a certain liquidity pool (#688), corresponding to the following new filter:

  • /accounts?reserves=[...list of assets...]

• Updated RevokeSponsorshipOperationResponse to contain an optional attribute trustline_liquidity_pool_id, for when a liquidity pool trustline is revoked (#690).

Breaking changes

• A TradeRecord can now correspond to two different types of trades and has changed (#685):

  • Orderbook (the existing structure)
    • counter_offer_id and base_offer_id only show up in these records
    • the redundant offer_id field was removed; it matches base_offer_id
  • LiquidityPool (new)
    • base_account xor counter_account will appear in these records
  • price fields changed from numbers to strings
  • The links to base and counter can now point to either an account or a liquidity pool

• An account's balances array can now include a new type (#688):

  • asset_type can now be liquidity_pool_shares
  • The following fields are not included in pool share balances:
    • buying_liabilities
    • selling_liabilities
    • asset_code
    • asset_issue

• The ChangeTrustOperationResponse has changed (#688, #692):

  • asset_type can now be liquidity_pool_shares
  • asset_code, asset_issuer, and trustee are now optional
  • liquidity_pool_id is a new optional field

• The trustline effects (TrustlineCreated, TrustlineUpdated, TrustlineRevoked) have changed (#690):

  • the asset type can now be liquidity_pool_shares
  • they can optionally include a liquidity_pool_id

• Trustline sponsorship effects (TrustlineSponsorshipCreated, TrustlineSponsorshipUpdated, TrustlineSponsorshipRemoved) have been updated (#690):

  • the asset field is now optional, and is replaced by
  • the liquidity_pool_id field for liquidity pools

v9.0.1

This stable release adds support for Protocol 18. For details, you can refer to CAP-38 for XDR changes and this document for changes to the Horizon API.

Refer to the release notes for the betas (e.g. v9.0.0-beta.0) for a comprehensive list of changes to this library.

Fix

• Corrects the reserves field on LiquidityPoolRecords to be an array (#715).
• Bumps the stellar-base dependency to v6.0.4 (#715).

v8.2.5

Update

• The js-stellar-base library has been updated to v5.3.2, which fixes a muxed account bug and updates vulnerable dependencies (#670).

v8.2.4

Fix

• Utils.readTransactionTx now checks timebounds with a 5-minute grace period to account for clock drift.

v8.2.3

Fix

• Fix server signature verification in Utils.readChallengeTx. The function was not verifying the server account had signed the challenge transaction.

v8.2.2

Fix

• Fixes a breaking bug introduced in v8.2.0 in which AccountResponse no longer conformed to the StellarBase.Account interface, which was updated in stellar-base@v5.2.0 (#655).

v8.2.1

Fix

• A defunct query paramater (?c=[...]) has been removed now that Horizon properly sends Cache-Control headers (#652).

v8.2.0

Add

• Added support for querying the relevant transactions and operations for a claimable balance (#628):

  • TransactionCallBuilder.forClaimableBalance(): builds a query to /claimable_balances/:id/transactions/
  • OperationCallBuilder.forClaimableBalance(): builds a query to /claimable_balances/:id/operations/

• Added support for new stat fields on the /assets endpoint (#628):

  • accounts - a breakdown of accounts using this asset by authorization type
  • balances - a breakdown of balances by account authorization type
  • num_claimable_balances - the number of pending claimable balances
  • claimable_balances_amount - the total balance of pending claimable balances

• Added types for all Effects supported as an enum, and moved Trade, Asset, Offer, and Account types to separate files (#635).

Update

• Upgraded js-stellar-base package to version ^5.2.1 from ^5.1.0, refer to its release notes for more (#639):

  • opt-in support for muxed accounts (SEP-23)
  • exposing the AuthClawbackEnabled flag to Typescript to complete Protocol 17 support
  • fixing a public key parsing regression

• Exposed more Protocol 17 (CAP-35) operations (#633):

  • The /accounts endpoint now resolves the flags.auth_clawback_enabled field.
  • The operation responses for clawback, clawbackClaimableBalance, and setTrustLineFlags are now defined.
  • The operation response for setOptions has been updated to show auth_clawback_enabled.

v8.1.1

Fix

• Upgraded js-stellar-base package to version ^5.1.0 from ^5.0.0 to expose the Typescript hints for CAP-35 operations (#629).