59 KiB
		
	
	
	
	
	
	
	
			
		
		
	
	ripple-lib Release History
1.6.0 (2020-01-06)
- Add support for AccountDelete (#1120)
 - Improve error type given on rejected message _send to be DisconnectedError (#1098)
 - Internal
- Add unit test for unhandled promise rejection warning on message _send (#1098)
 
 - Dependencies
- Update @types/node, @typescript-eslint/parser
 
 
1.5.1 (2019-12-28)
- Fix support for CDNs (#1142)
 - Internal
- Clean up connection trace logic (#1114)
 - Clean up the connection config (#1115)
 - Run prettier format (#1116)
 - Update eslint command (#1118)
 
 - Dependencies
- Update webpack-cli, webpack, ts-node, @types/lodash, @types/ws, @types/node, @typescript-eslint/parser, @typescript-eslint/eslint-plugin, https-proxy-agent, mocha, eventemitter2
 
 
1.5.0 (2019-12-14)
- Add support for 
WalletLocator(#1083) - Types: Move and de-dupe 
TransactionJSONtype (#1096)- This resolves an error surfaced by TypeScript 3.7
 
 - Add a heartbeat to detect hung connections (#1101)
 - Dependencies
- Update TypeScript version (#1096)
 - Update ripple-lib-transactionparser to 0.8.1 (#1097)
 - Update ripple-binary-codec to 0.2.5
 - Update webpack (#1112)
 - Require node 8 and yarn (#1107)
 
 - Testing: Refactor and add unit tests
- Fix some errors caught by the improved tests
 
 
1.4.2 (2019-11-14)
- Add support for tick size (#1090) (thanks @RareData)
 - Update email hash default to allow proper clearing (#1089) (thanks @RareData)
 - Fix Unhandled Promise Rejection Warning on message 
_send- Add an immediate catch to the 
_sendpromise passed to_whenReadyin case there is rejection before async handlers are added (#1092) (thanks @nickewansmith) 
 - Add an immediate catch to the 
 - Docs improvements
- Add XRP Toolkit reference (#1088)
 
 - Internal improvements
- Add a prettier config
 - Update Node.js Testing Versions (#1085)
- Testing matrix based on: https://nodejs.org/en/about/releases/
- Node 11 is no longer supported (not LTS)
 - Node 12 added (active LTS)
 - Node 13 added ("current" release)
 
 
 - Testing matrix based on: https://nodejs.org/en/about/releases/
 
 
1.4.1 (2019-11-06)
- Compatibility: Change TypeScript compile target back to 
es6(#1071)- WARNING: This allows for the use of Node v6, which is no longer supported by Node.js, as it was end-of-life'd in April 2019
 - We recommend updating to Node v8/v10 ASAP in order to get security updates and fixes from the Node.js team
 - We are not actively running tests against Node v6 (ref #1076)
 
 - Docs: 
getAccountObjectsdoc fix - Dependencies:
- Update 
bignumber.js - Update 
ripple-keypairs - Update 
ws 
 - Update 
 - Build process: Update 
webpackflow 
1.4.0 (2019-10-28)
- Unref timer so it does not hang the Node.js process
 - Add a 2-second timeout for connect()
 - Improve getTransaction() error when tx has not been validated yet
 - Add support for the new X-address format
 - Fix error in Safari, Chrome 78, Firefox 70
 - Some error messages have changed slightly. For example:
-instance.Account is not of a type(s) string,instance.Account does not conform to the "address" format+instance.Account is not of a type(s) string,instance.Account is not exactly one from <xAddress>,<classicAddress>
 
Internal improvements
- Reduce dependency size
 - Move tests to TypeScript
 - Replace tslint with eslint
 - Update https-proxy-agent
 - Add tests
 
1.3.4 (2019-10-18)
- Update ripple-lib-transactionparser
 - Improve error message when signing fails (e.g. due to trailing zeros)
 - Integrate ripple-hashes (in TypeScript with improved naming and docs)
 - Add multi-signing example to sign() method docs
 - Update TypeScript
 
1.3.3 (2019-09-10)
- Expand node version compatibility to support Node.js 12 (ripple-binary-codec#32)
 
1.3.2 (2019-09-03)
- Export and document 
rippleTimeToISO8601()method - Add type for isValidAddress (fixes error TS7016, #1032)
 - Docs: update recommended Node.js version (#1031)
 
When using this release with rippled, we recommend using rippled version 1.3.1 or later.
1.3.1 (2019-08-26)
- Upgrade to gulp 4 (#1030)
 - Remove http server (unused)
 - Update dependencies
 
There are no changes in the browser version with this release. The npm package for Node.js should be slightly smaller.
When using this release with rippled, we recommend using rippled version 1.3.1.
1.3.0 (2019-08-16)
Bug fixes:
- Breaking change: Fix 
getServerInfo(#1012) 
Before:
{
  // ...
  "load": {
    "jobTypes": {
      "0": {"jobType": "untrustedValidation", "perSecond": 10},
      "1": {"jobType": "ledgerData", "peakTime": 2, "perSecond": 2},
      "2": {"inProgress": 1, "jobType": "clientCommand", "perSecond": 1},
      "3": {"jobType": "transaction", "perSecond": 1},
      // ...
    },
    "threads": 6
  },
  // ...
}
After:
{
  // ...
  "load": {
    "jobTypes": [
      {
        "jobType": "untrustedValidation",
        "perSecond": 8
      },
      {
        "avgTime": 2,
        "jobType": "ledgerData",
        "peakTime": 72,
        "perSecond": 2
      },
      {
        "inProgress": 1,
        "jobType": "clientCommand",
        "perSecond": 1
      },
      {
        "jobType": "transaction",
        "perSecond": 1
      },
      // ...
    ],
    "threads": 6
  },
  // ...
}
- Sign method - verify accurate encoding (#1026)
- In previous versions, the following could be encoded incorrectly:
- Amounts of XRP with more than 6 decimal places
 - Amounts of XRP drops with any decimal places
 
 - In versions 1.2.5 and 1.3.0, amounts that are invalid in this way will throw an error
 
 - In previous versions, the following could be encoded incorrectly:
 - Expand 
APIOptionsby extendingConnectionOptions(#1018, fixes #1017) - Fix docs for destination.address (#1011)
 
New features:
- Support removing a signer list (#1021)
 - Export 
setCanonicalFlagmethod fromsrc/transaction/utils 
Improvements:
- Clean up phrasing in schema descriptions (#1023)
 - Improve docs
 - Update dependencies
 
Since this release fixes a bug that could cause transactions to be serialized incorrectly during the signing process, it has also been simultaneously released as version 1.2.5 (patch release).
When using this release with rippled, we recommend using rippled version 1.3.1.
1.2.4 (2019-06-06)
- Update README.md
 - Clarify docs
 - Update dependencies
 - Fix typos
 
The SHA-256 checksums for the browser version of this release can be found below.
% shasum -a 256 *
4f09c056ccc51bc6cf17b128b559112e9c5adf19cc96ac8f9a06faee185697a7  ripple-1.2.4-debug.js
5da1c75a02d76b0b105d98355ee4561f5d5036e8d5d0237efd5960812dcaa1fd  ripple-1.2.4-min.js
e147f303e880a65db149d2a5b9183b75814bd8145cd00740bcc4679d867192c8  ripple-1.2.4.js
1.2.3 (2019-04-30)
- Fix browser builds
 
The SHA-256 checksums for the browser version of this release can be found below.
% shasum -a 256 *
efb0f29cde94534a015d8a2171abb11b9a4345ba01418bf5b6ab6042a6d51dde  ripple-1.2.3-debug.js
b86145c0e30099b966ed8d3830ba25988d72877f1f87044d9954d6707be098ac  ripple-1.2.3-min.js
e027d91c7321d41ba94bb1bdc77dcff0107a5fd9eb833c6dbd06f1bbedef3900  ripple-1.2.3.js
1.2.2 (2019-04-15)
- Prevent 
prepareTransactionfrom overwritingFeeand/orLastLedgerSequence(#997) - Add 
deliveredAmountas optional field for typeOutcome(#996) - Fix build failure with TS strict checks (#993)
 
Minor changes:
- Use TypeScript project references
 - Travis: Drop node 9 and add node 11 for testing
 - Bump versions of devDependencies
 
Note: There is no browser version of this release.
1.2.1 (2019-03-23)
- Update 
ripple-binary-codecto 0.2.1 to supporttecKILLED 
The SHA-256 checksums for the browser version of this release can be found below.
% shasum -a 256 *
531c2a8f4bf6d6b5bd4afe6a40b6a68a77179a343902cfa4210d7e35b5697af0  ripple-1.2.1-debug.js
201ee99922b16b7e32afb5317ef4bb9facc23b20c272bb5c4ed7010f5d996cab  ripple-1.2.1-min.js
c1b984581299bf00e0e3c8ac4e62eadfc9b190bd78a2458a76e59ceb56046148  ripple-1.2.1.js
1.2.0 (2019-03-19)
This release:
- changes the way you handle errors for the 
prepare*methods. - improves the 
messagefield ofRippledErrors. - allows 
Sequenceto be set in the transaction JSON provided toprepareTransaction. 
For details, continue reading:
[BREAKING CHANGE] prepare* methods reject the Promise on error
The prepare* methods now always reject the Promise when an error occurs, instead of throwing.
Previously, the methods would synchronously throw on validation errors, despite being asynchronous methods that return Promises.
In other words, to handle errors in the past, you would need to use a try/catch block:
// OBSOLETE - no need for try/catch anymore
try {
  api.preparePayment(address, payment, instructions).then(prepared => {
    res.send(prepared.txJSON);
  }).catch(error => {
    // Handle asynchronous error
  });
} catch (error) {
    // Handle synchronous error
}
Now, you can rely on the Promise's catch handler, which is called with the error when the Promise is rejected:
api.preparePayment(address, payment, instructions).then(prepared => {
  res.send(prepared.txJSON);
}).catch(error => {
  // Handle error
});
This applies to:
- preparePayment
 - prepareTrustline
 - prepareOrder
 - prepareOrderCancellation
 - prepareSettings
 - prepareEscrowCreation
 - prepareEscrowExecution
 - prepareCheckCreate
 - prepareCheckCash
 - prepareCheckCancel
 - preparePaymentChannelCreate
 - preparePaymentChannelClaim
 - preparePaymentChannelFund
 
Improved RippledError message
Previously, RippledErrors (errors from rippled) used rippled's error field as the message.
Now, the error_message field is used as the message.
This helps to surface the specific cause of an error.
For example, before:
[RippledError(invalidParams, { error: 'invalidParams',
  error_code: 31,
  error_message: 'Missing field \'account\'.',
  id: 3,
  request: { command: 'account_info', id: 3 },
  status: 'error',
  type: 'response' })]
After:
[RippledError(Missing field 'account'., { error: 'invalidParams',
  error_code: 31,
  error_message: 'Missing field \'account\'.',
  id: 3,
  request: { command: 'account_info', id: 3 },
  status: 'error',
  type: 'response' })]
In this case, you can see at a glance that account is the missing field.
The error field is still available in errorObject.data.error.
When error_message is not set (as with e.g. error 'entryNotFound'), the error field is used as the message.
[BUG FIX] prepareTransaction does not overwrite the Sequence field
The prepareTransaction method now allows Sequence to be set in the Transaction JSON object, instead of overwriting it with the account's expected sequence based on the state of the ledger.
Previously, you had to use the sequence field in the instructions object to manually set a transaction's sequence number.
New in rippled 1.2.1
As this is the first release of ripple-lib following the release of rippled 1.2.1, we would like to highlight the following API improvements:
- 
The
delivered_amountfield has been added to theledgermethod, and to transaction subscriptions.api.getLedger({includeTransactions: true, includeAllData: true, ledgerVersion: 17718771}).then(...)You can also call
ledgerdirectly:request('ledger', {...}).then(...) 
You have access to these improvements when you use a rippled server running version 1.2.1 or later. At the time of writing, we recommend using rippled version 1.2.2 or later.
The SHA-256 checksums for the browser version of this release can be found below.
% shasum -a 256 *
13021fe3efbdd59faf68597b0b18204b39847b285cca82f84c737e3d19922cc2  ripple-1.2.0-debug.js
0070225e731afd8c2c0a0976111ebf326c19a96ee1549368de9f016abdd53d2f  ripple-1.2.0-min.js
d440268397c03ad5137a3294e53a07b959ef93cd23b1990d6f82621c4776ba9f  ripple-1.2.0.js
1.1.2 (2018-12-12)
- Update 
submitresponse (#978)- Includes the full object returned by rippled, while keeping the existing fields for backward compatibility
 
 - Add 
getLedgeroption for ledger hash (#980)- Use the 
ledgerHashoption to get a specific ledger by hash 
 - Use the 
 
Thanks to @alexchiriac for the contributions in this release.
When using ripple-lib with rippled, we recommend using rippled version
1.1.2 or later.
The SHA-256 checksums for the browser version of this release can be found below.
% shasum -a 256 *
e6cc52395d0c3e205263777ba2e528e50f4d1f84bb4b16763a3bf7f5fcc290f5  ripple-1.1.2-debug.js
82df879bc2970e0e4fd161975a99448b4859b0cde751d8ea34e9f51d672090b9  ripple-1.1.2-min.js
12f56330dc71bba8ac3004025cbc9698413a0c619df302dda105b31228a67319  ripple-1.1.2.js
1.1.1 (2018-11-27)
- Fix 
getOrderbookoffer sorting (#970)- BREAKING CHANGE: The ordering of offers returned by 
getOrderbookhas been changed so that offers with the best quality are sorted first 
 - BREAKING CHANGE: The ordering of offers returned by 
 - Add new helper methods for working with the 
rippledAPIs:formatBidsAndAsks: Takes offers and returns a formatted order book object with bids and asksrenameCounterpartyToIssuer: Takes an object and renames thecounterpartyfield toissuer
 - TypeScript: Add return type for 
generateAddress(#968) 
When using ripple-lib with rippled, we recommend using rippled version 1.1.1 or
later.
The SHA-256 checksums for the browser version of this release can be found below.
% shasum -a 256 *
e151900e49bb5482b02bef5b0b1542ea586076363b072ae616f6d4d2f7f5b8a1  ripple-1.1.1-debug.js
6aee3757b29de285f361e20862261090033c07a13fd09f4a3cc4c097b6e84b55  ripple-1.1.1-min.js
bea4a889fb9ee4092324c6667490ea66469bdde869ddc1aaddf5e9d12b0cf091  ripple-1.1.1.js
1.1.0 (2018-10-31)
- Add support for Node.js v10 LTS (#964)
 - Add DepositPreauth (#958)
 - In 
FormattedTransactionType, theOutcome'sbalanceChangesproperty had the wrong type. This is now fixed (#955) - Add/fix docs for: xrpToDrops, dropsToXrp, iso8601ToRippleTime, schemaValidator, isValidAddress, isValidSecret, deriveKeypair, deriveAddress
 
The SHA-256 checksums for the browser version of this release can be found below.
% shasum -a 256 *
e1d742092b3c0fcee97a875e18db4baeab3bbc82f08b96e883ee188c5f0cfb37  ripple-1.1.0-debug.js
f28921f57a133678dcb3cb54c497626bd76b1f953d22d61f3ddca31c8947d552  ripple-1.1.0-min.js
3696871a80c1102635699994adcaf00cdfdfcff5014fc2eba3d8f8d8437c8f91  ripple-1.1.0.js
1.0.2 (2018-10-16)
- Fix #954: Exclude SendMax from all XRP to XRP payments (thanks @jefftrudeau)
 - TypeScript
- book_offers returns offers type OfferLedgerEntry (#951)
 - Use 
object(#936) 
 
The SHA-256 checksums for the browser version of this release can be found below.
% shasum -a 256 * 
2556fe17296e127ed44e7066e90a6175e2b164f00ca3c1aa7b1c554f31c688dd  ripple-1.0.2-debug.js
e0342ea21eac32a1024c62034fba09c6f26dd3e7371b23ea1e153e03135cd590  ripple-1.0.2-min.js
c7286c517497d018d02d09257e81172b61d36c8b9885a077af68e8133c3b3b9b  ripple-1.0.2.js
1.0.1 (2018-09-27)
- Add address/secret/key validation and derivation methods (#932)
isValidAddress(address: string) : boolean: Checks if the specified string contains a valid address.isValidSecret(secret: string): boolean: Checks if the specified string contains a valid secret.deriveKeypair(seed: string): {privateKey: string, publicKey: string}: Derive a public and private key from a seed.deriveAddress(publicKey: string): string: Derive an XRP Ledger address from a public key.
 - To derive an address from a secret:
- Derive the public key from the secret.
 - Derive the address from the public key.
 
- Example: 
const address = api.deriveAddress(api.deriveKeypair(secret).publicKey) 
 - Update server regex to accommodate UDS (#944)
 - Include memos when parsing trustlines (#949)
 - Add remaining LedgerEntry types (#943)
 
The SHA-256 checksums for the browser version of this release can be found below.
% shasum -a 256 *
9b6408641ce83659afcd5765c256c35829a4fcb4c3244dc9ca6bf27c871a45c4  ripple-1.0.1-debug.js
7ab2b69fe59c2d4a74638116e2ba3b387155eb2d23e48a01bbf7beb72911f898  ripple-1.0.1-min.js
8bb4dcad9ce25a27003b1d73d71ddf41b8a5af02ece4ebbfeaff4aeb91f3b8c4  ripple-1.0.1.js
1.0.0 (2018-08-30)
We are pleased to announce the release of ripple-lib version 1.0.0.
This version features a range of changes and improvements that make the library more capable and flexible. It includes new methods for accessing rippled APIs, including subscriptions.
When using this version with rippled for online functionality, we recommend
using rippled version 1.0.1 or later.
Here is a summary of the changes since ripple-lib version 0.22.0, which was
the last non-beta version.
New Features
- Add 
request(),hasNextPage(), andrequestNextPage()for accessingrippledAPIs. - Add 
prepareTransaction()for preparing rawtxJSON. - XRP amounts can be specified in drops. Also, 
xrpToDrops()anddropsToXrp()are available to make conversions. getTransactionresponses can include a newchannelChangesproperty that describes the details of a payment channel.
Data Validation and Errors
- Amounts in drops and XRP are checked for validity.
 - A maximum fee is now
imposed. Exceeding it causes a 
ValidationErrorto be thrown. - Errors are improved and more data validation was added.
 - Bug fix: 
getPathsnow filters paths correctly and works correctly when the destination currency is XRP. 
Breaking Changes
The following changes were introduced in 1.0.0.
getTransaction()andgetTransactions()- The 
specification.destination.amountfield has been removed from the parsed transaction response. - To determine the amount that a transaction delivered, use 
outcome.deliveredAmount. - If you require the provisional requested 
Amountfrom the original transaction:- Use 
getTransaction'sincludeRawTransactionoption, or - Use 
getTransactions'sincludeRawTransactionsoption, or - Use the rippled APIs directly with 
request. For example, call the API methodstx,account_tx, etc. 
 - Use 
 
- The 
 getLedger()response object- The 
rawTransactionsfield has been removed (for consistency withgetTransaction()andgetTransactions()). - Instead, within each 
transaction, use the newrawTransactionJSON string. - The 
metaDatafield has been renamed tometafor consistency with rippled'stxmethod. ledger_indexhas been added to each raw transaction.
- The 
 
The SHA-256 checksums for the browser version of this release can be found below.
% shasum -a 256 *
06e5efcb6846ad45dedfd85cfa2ef4bdeb608b15ccbfb60b872c995d97342426  ripple-1.0.0-debug.js
cdb26b928a89ce228c727d1ff966df266eb46b2f76bd94f81cbeb0a9d75febf0  ripple-1.0.0-min.js
f74ee804e8a945a994e4e3901a0a3eb52292fbdcbff61ed30cefb8ffbcba50c3  ripple-1.0.0.js
1.0.0-beta.5 (2018-08-11)
1.0.0-beta.4 (2018-08-10)
- Add 
prepareTransaction() - Internal improvements and cleanup
 
1.0.0-beta.3 (2018-07-17)
- For payment channel transactions, 
getTransactionincludes a newchannelChangesproperty that describes the details of the payment channel. (#920) 
Bug Fixes
- A bug caused calculated fees to use too many decimal places. This was fixed by rounding fees to 6 decimal places. (#912)
 - When using the Settings transaction to set up a multi-signing list, the threshold and weights fields are required. (#909)
 - Docs: Fix the MIMETYPE in examples with memos. (#914)
 
The SHA-256 checksums for the browser version of this release can be found below.
% shasum -a 256 *
460dbb521e24c44cb53dabc1a74feeca33d031b44d889dd5b51103ca92d51de6  ripple-1.0.0-beta.3-debug.js
cccfd24973c6b7990d9e933a589175dae26249825737fff4f2f73d8558a3f186  ripple-1.0.0-beta.3-min.js
0dc456a58fb078347d9920310621595905085595d73c2b8fe96bea73bcf35450  ripple-1.0.0-beta.3.js
1.0.0-beta.2 (2018-06-08)
Breaking Changes
- During transaction preparation, there is now a maximum fee. Also, when a transaction is signed, its fee is checked and an error is thrown if the fee exceeds the maximum. The default 
maxFeeXRPis'2'(2 XRP). Override this value in the RippleAPI constructor. - Attempting to prepare a transaction with an exact 
feehigher thanmaxFeeXRPcauses aValidationErrorto be thrown. - Attempting to sign a transaction with a fee higher than 
maxFeeXRPcauses aValidationErrorto be thrown. - The value returned by 
getFee()is capped atmaxFeeXRP. 
Other Changes
- In Transaction Instructions, the 
maxFeeparameter is deprecated. Use themaxFeeXRPparameter in the RippleAPI constructor. 
Overview of new fee limit
Most users of ripple-lib do not need to make any code changes to accommodate the new soft limit on fees. The limit is designed to protect against the most severe cases where an unintentionally high fee may be used.
- When having ripple-lib provide the fee with a 
prepare*method, a maximum fee ofmaxFeeXRP(default 2 XRP) applies. You can prepare more economical transactions by setting a lowermaxFeeXRP, or support high-priority transactions by setting a highermaxFeeXRPin the RippleAPI constructor. - When using 
signwith a Fee higher thanmaxFeeXRP, aValidationErroris thrown. 
If you have any questions or concerns, please open an issue on GitHub.
The SHA-256 checksums for the browser version of this release can be found below.
% shasum -a 256 *
ef348a2805098e61395b689b410cbf4bfd35e4d72e38c89f4ab74ec5e19793f5  ripple-1.0.0-beta.2-debug.js
ea33fd53df8c7176d5fbf52dae0b64aade7180860f26449062cdbefaf8bd4d9b  ripple-1.0.0-beta.2-min.js
fe5cc6e97c9b8a1470dacb34f16a64255cd639a25381abe9db1ba79e102456f2  ripple-1.0.0-beta.2.js
1.0.0-beta.1 (2018-05-24)
Breaking Changes
- Amounts in drops and XRP are checked for validity. Some
methods may now throw a 
BigNumber ErrororValidationErrorif the amount is invalid. This may include methods that previously did not throw. - Note that 1 drop is equivalent to 0.000001 XRP and 1 XRP is equivalent to 1,000,000 drops.
 - Using drops is recommended. All rippled APIs require XRP amounts to be expressed in drops.
 
Other Changes
- Allow specifying amounts in drops for consistency with the 
rippledAPIs. - Export 
xrpToDrops()anddropsToXrp()functions. - Potentially breaking change: Improve errors. For example, 
RippledErrornow includes the full response from therippledserver (#687).NotConnectedErrormay be thrown with a different message than before. 
The SHA-256 checksums for the browser version of this release can be found below.
% shasum -a 256 *
a80ebb39e186640246306eadb2879147458c8271fd3c6cb32e6ef78d0b4b01a5  ripple-1.0.0-beta.1-debug.js
81bcc4b5fd6fd52220ed151242eaddd63eb29c4078845edc68f65b769557d126  ripple-1.0.0-beta.1-min.js
738b4d65b58cf4e3542fa396f8d319a24cd7d0b7aff5ff629a900e244f735ff4  ripple-1.0.0-beta.1.js
1.0.0-beta.0 (2018-05-10)
- Add 
request,hasNextPage, andrequestNextPage.- This provides support for all rippled APIs, including subscriptions.
 
 
When using rippled APIs, you must:
- For all XRP amounts, use drops (1 drop = 0.000001 XRP).
 - Instead of 
counterparty, useissuer. 
The SHA-256 checksums for the browser version of this release can be found below.
% shasum -a 256 *
ab2094979a3d6b320c7bc22bc5946c50fa5e29af0976d352e7689b0a4d840c55  ripple-1.0.0-beta.0-debug.js
0e7f7d740606c2866ebf63776b13b41a555848e1a1419e2c8058d2e6c562d7fd  ripple-1.0.0-beta.0-min.js
bd05e8806832ca4192aea7ba2d0362baa9f44605f8e8e6676acd25eb0b94b778  ripple-1.0.0-beta.0.js
0.22.0 (2018-05-10)
getOrderbook- return raw order data. The fullBookOfferdata is now provided underdata.
The SHA-256 checksums for the browser version of this release can be found below.
% shasum -a 256 *
33f71b55c4adec4452826e44fe7809377364df04222b60f0fce01e7de2daff33  ripple-0.22.0-debug.js
63232888a4ea77065e8e8eb8fdaa8ebfe3a785428fe935e2667c1ea54c837f29  ripple-0.22.0-min.js
ab98026fabe296bd938297c48cb58e01dfdbe90f3c66c9617d6a3e1efd4c6b93  ripple-0.22.0.js
0.21.0 (2018-04-11)
The SHA-256 checksums for the browser version of this release can be found below.
% shasum -a 256 *
3ab52209ad4a80393c8c08ef3f4aa9cfb47bc76c0ede2ee9fa7f5ca180ba4d67  ripple-0.21.0-debug.js
3b1efccded347bed5f64757098a1ea6a513bb8932d922d00af47cd24e001dc14  ripple-0.21.0-min.js
db08e5a3eab1f659b4c803543374398004d950ba720adc4b9a7658817cb5c94b  ripple-0.21.0.js
0.20.0 (2018-04-09)
- Add support for using a keypair with sign()
 - Fix a bug caused by jsonschema v1.2.3 by pinning to v1.2.2
 - Improve Payment Channel documentation
 
The SHA-256 checksums for the browser version of this release can be found below.
% shasum -a 256 *
389811a9baa72f77e2a43d0b48045762d29a6f616ed5fd2660ba76fc12a3ecc5  ripple-0.20.0-debug.js
c1746ea0dd55318cb4e1ef3955ef14759d9d70861437c69abafc10169916f068  ripple-0.20.0-min.js
17958b0e46395d2b2a35a003693c0babdfb5382513d3cc58a62f8648ad710b0e  ripple-0.20.0.js
0.19.1 (2018-03-22)
- Fix: Include TypeScript declarations in npm package
 - Fix: Documentation link to checkCash
 - Internal: Clean up types and migrate more APIs to new request method
 - Internal: Fix Payment source and destination types
 
The SHA-256 checksums for the browser version of this release can be found below.
% shasum -a 256 *
3ed5332aa035c07bae6c1abfdfc8ca77cdbb05cc4b88878f544f1ea4cb793f4d  ripple-0.19.1-debug.js
2f5507aa00a40ab6a94de1822af87db5e927edef3885aef5d9b39ccb623ccb54  ripple-0.19.1-min.js
1e439aee1b220242d56ea687a9b55a67b8614212c1ddbd70a4fcf34503fc487a  ripple-0.19.1.js
0.19.0 (2018-03-02)
- Add support for Checks
- CheckCreate adds a check entry to the ledger. The check is a promise from the source of the check that the destination of the check may cash the check and receive up to the SendMax specified on the check. The check may have an (optional) expiration, after which the check may no longer be cashed.
 - CheckCancel removes the check from the ledger without transferring funds. Either the check's source or destination can cancel the check at any time. After a check has expired, any account can cancel the check.
 - CheckCash is a request by the destination of the check to transfer a requested amount of funds, up to the check's SendMax, from the source to the destination. The destination may receive less than the SendMax due to transfer fees.
 
 - Add support for the Deposit Authorization account root flag
 - Generate .ts.d TypeScript declaration files
 - Improve documentation of getTransactions params
 - Add new request interface (private for now)
 
The SHA-256 checksums for the browser version of this release can be found below.
% shasum -a 256 *
0e7ce4594b7e455fbc57ad81f6fddc391d1e1f349a49c96ad783be50f80fdc14  ripple-0.19.0-debug.js
6d716a0357929e51e476f22136880f7a0e5458fd396ac145ce9308f278ff7cc1  ripple-0.19.0-min.js
6715db1af638f99226ab7f8f244103306aa6e04d1b8c1da47a63431053bacb84  ripple-0.19.0.js
0.18.2 (2018-02-13)
- Fix: Publish updated browser builds to npm so that users can easily use CDNs
 - Fix: Browserify fails due to dependency on 
ws - Fix: 
buildscript fails whennode_modulesis in path - Reduce size of published npm package
 - Clean up files from Flow (we migrated to TypeScript)
 - Typos and code cleanup
 
The SHA-256 checksums for the browser version of this release can be found below.
% shasum -a 256 *
f08ab61137255be3639e9d210ded2a182b6e0388f257a70d9b372ce7e7e518a6  ripple-0.18.2-debug.js
0604835b8421391167b4314ce93a76b5994780a08bd7edf36d91eb5e8f2643a2  ripple-0.18.2-min.js
fda56ab5c8256e04355e20064877ef4053f26c87f37cfcf861340f22bf89ee40  ripple-0.18.2.js
0.18.1 (2018-01-27)
Note: The package published to npm for this version did not include updated browser builds. If you are using a CDN that pulls from npm, please use 0.18.2 or later.
- Fix: isSameIssue() should check counterparty. This bug caused 
getOrderbook()to return incorrect values. 
The SHA-256 checksums for the browser version of this release can be found below.
% shasum -a 256 *
6871855a2af1dc591ef557d442c11e8c60e01c5932054e13e8cbb84a182f45e0  ripple-0.18.1-debug.js
331f0baff46af44933a8fa31f128132945ff82a147acfff0a7315adb446e3de0  ripple-0.18.1-min.js
26324bb0725d2d484fe3b6086335d49734f45dc647b07c60746e0d8619f1ed3e  ripple-0.18.1.js
0.18.0 (2018-01-25)
- Convert from Flow to TypeScript
 - Use ES Module syntax (Babel still compiles these to common.js modules for distribution)
 - Docs: Improve escrow creation example/test
 - Fix type errors
 - Fix lint errors
 
0.17.9 (2017-11-14)
- Update ws dependency to 3.3.1
 - Remove unnecessary polyfills
 - Fix lint errors (#786, #808)
 - Update ripple-keypairs dependency to 0.10.1
 
The SHA-256 checksums for the browser version of this release can be found below.
% shasum -a 256 *
b52f251eedac2509d72093eab1e8dba0d0f4a9fe6a28ec1cc90853cfb0fd7110  ripple-0.17.9-debug.js
d577a2bbdbdf7535c5365a1c52a2a31989d1b966e30abcba65c87133a536b9dc  ripple-0.17.9-min.js
ff4c3002842fac72ec2ebbd081e9594b0de6050d4d051a8fd6c06adb9a351488  ripple-0.17.9.js
The SHA-1 checksums for the browser version of this release can be found below.
% shasum *
e1995afc34aef6accd269cfccc55a45619618a41  ripple-0.17.9-debug.js
e6ad9a9c111ab696f5637bfa372d80999e5ae362  ripple-0.17.9-min.js
4866494ec5f9095cc34bea142f1e2b8ac5f7fbf8  ripple-0.17.9.js
0.17.8 (2017-11-06)
- Fix: Freezing in Safari 10.1 (updated bignumber.js) (closes #762)
 - Fix: 
getSettingsshould include signers - Update for Node 6
 - Update lodash dependency
 - Migrate to yarn
 
0.17.7 (2017-05-08)
- Replace AJV with jsonschema
 
0.16.5 (2016-01-21)
0.16.4
0.16.2
- Bump 
ripple-binary-codecdependency version to 0.1.1 to fix issue withcomputeLedgerHashfor transactions withDeliverMin 
0.16.1
0.16.0
BREAKING CHANGES
- Fix types of XRP values in 
getServerInforesponse - Change error event format and fix crash due to error event on websocket
 
OTHER CHANGES
- Fix 
generateAddressdocs and add error event listener to boilerplate - Allow setting 
maxLedgerVersiontonullto specify no maximum - Add support for client certificates
 getFeereturns a string not a float- Fix parsing of quality for 
getTrustlines - Fix 
DeliverMinvalue when specifyingminAmount - http server example
 
0.15.2
0.15.1
0.15.0
BREAKING CHANGES
OTHER CHANGES
- Fix handling memos in 
prepareSettings - Docs: SusPay warnings, offline mode, and other tweaks
 - Fix prepareOrderCancellation documentation
 
0.14.0
BREAKING CHANGES
prepareOrderCancellationnow takes orderCancellation specification- Rename "ledgerClosed" event to "ledger" and change format
 
OTHER CHANGES
- Fix proxy support and add support for proxy authorization
 - Fix trace option
 - Allow memos on all transaction types
 - Add documentation for RippleAPI options
 - Docs: more on basic types, tx types
 - Docs: revised introductory material
 - boost coverage to almost 100%
 
0.13.2
0.13.1
0.13.0
BREAKING CHANGES
- Add new RippleAPI interface and delete old API
 
OTHER CHANGES
- Removed timeout method of Request and added default timeout
 - Add Remote.closeCurrentPathFind function, so current pathfind can be properly closed
 - Implement Balance Sheet API
 - Fix bugs in orderbook subscription
 - Fix crash due to rippled slowDown error
 - Fix: Emit error events and return error on pathfind
 - Deprecate core and remove snake case method copying
 - Fix RangeSet for validated_ledger as single ledger
 - Fix bug where the paths would be set with an empty array
 - Fix reserve calculation
 
0.12.9
0.12.7 and 0.12.8
- Improve performance of orderbook
 - Remove Firefox warning about prototype overwrite
 - Fix compare bug in 
Amountclass 
0.12.6
0.12.15
- Add offer autobridging
 - Prevent crash when listening for "model" events on the OrderBook class
 - Fix empty order edgecase
 - Fix AutobridgeCalculator (RT-3445)
 - Update sjcl and delete custom ripemd160, montgomery, and jacobi
 - Fix transaction summary for transactions that fail with remoteError
 - Fix serializedobject append for excessively large bytes length
 - Switch to sjcl npm module
 - Add babel transpiler
 - Remove unused float.js and wallet.js
 - Remove config singleton to reduce global state
 
0.12.4
0.12.3
- Add getLedgerSequence to Remote
 - Improve randomness when generating ECDSA signatures
 - Improve SerializedObject.append performance
 - Add 
Amount.scale. Multiply an amount’s value by a scale factor 
0.12.2
0.12.1
BREAKING CHANGES
OTHER CHANGES
- Fix taker pays funded calculation
 - Fix order funded amount calculation
 - Fix handling of quality in order book
 - Fix currency parsing of non-alphanumeric and no-currency currencies
 - Add Amount.strict_mode for toggling range validation
 - Add filename and line number to log, use log.warn() for deprecations
 - Add GlobalFreeze and NoFreeze flags
 - Fix handling of falsy parameters in requestLedger
 - Fix Base:decode
 - Fix Amount: clone in ratio_human, product_human
 - Fix Amount.to_human for very small numbers
 - Refactor base conversion
 - Update binary transaction format
 - Add DefaultRipple account flag
 - Remove 
Featuresfield requirement inSetFeetransaction format - Remove 
RegularKeyfield requirement inSetRegularKeytransaction format 
0.12.0
BREAKING CHANGES
- REMOVED Remote storage interface
 - REMOVED Remote 
pingconfiguration - REMOVED Old/deprecated Remote server configuration (websocket_ip, websocket_port)
 - REMOVED browser 
onlinereconnect listener - Remove 
jsbnand usebignumber.jsinstead for big number math - The 
allow_nanflag has been removed. Results for invalid amounts will always beNaN 
OTHER CHANGES
- Add deprecation warnings to request constructors. The first argument to request constructor functions should be an object containing request properties
 - Fix taker_gets_funded exceeding offer.TakerGets
 - Fix unsymmetric memo serializing
 - Fix IOU value passed to 
Amount.from_json() - Update transaction binary parsing to account for XRP delivered amounts
 - Bumped dependencies
 
0.11.0
- Track the funded status of an order based on cumulative account orders and 67d3973
 - Remove blobvault client from ripple-lib, use the 
ripple-vault-clientinstead 9b3d62b7 - Add support for 
ledgeroption in requestBookOffers - Add support for 
limitoption in requestBookOffers - Add 
ledgerSelectrequest constructor inRemote - Default to binary data for commands that accept the binary flag
 - Fix metadata account check
 - Double check 
tescode before emittingsuccess - Decrease redundancy in binary account_tx parsing
 - Abort server connection on unrecoverable TLS error
 - Fix complete ledgers check on subscription that is not initial
 
0.10.0
- Transaction changes
 - Important 
tef*andtel*and errors will no longer be presented as final. Rather than considering these errors final, ripple-lib will wait until theLastLedgerSequencespecified in the transaction is exceeded. This makes failures more definitive, and ensures that no transaction will resubmit indefinitely. - A new, final tej-class error is introduced to account for transactions that
are locally determined to have expired: 
tejMaxLedger. - Allow per transaction fees to be set, 
transaction.setFixedFee() - Improve memo support
- Add 
MemoFormatproperty for memo - Enforce 
MemoFormatandMemoTypeto be valid ASCII - Support 
textandjsonMemoFormat 
 - Add 
 - Update sjcl library
- Improved entropy by taking advantage of platform crypto
 - Use jscl's k256 curve instead of altering the c256 curve with k256 configuration
 - Deprecated: The c256 curve is linked to the k256 curve to provide backwards compatibility, this link will be removed in the future
 
 - Fix empty queue check on reconnect
 
0.9.4
- Normalize offers from book_offers and transaction stream
 - Fix: Amount.to_human() precision rounding
 - Fix: fractional drops in funded taker_pays setter
 
0.9.3
- Change 
presubmitto emit immediately before transaction submit - Add a "core" browser build of ripple-lib which has a subset of features and smaller file size
 - Update binformat with missing fields from rippled
 - Wait for transaction validation before returning 
tecerror - Change default 
max_feeonRemoteto1 XRP - Fix: Request ledger_accept should return the Remote
 
0.9.2
BREAKING CHANGES
OTHER CHANGES
- Add paging behavior for account requests, 
account_linesandaccount_offers - Add max_fee setter to transactions to set max fee the submitter is willing to pay
 - Fix: cap IOU Amounts to their max and min value
 
Example on how to use paging with account_offers:
// A valid `ledger_index` or `ledger_hash` is required to provide a reliable result.
// Results can change between ledger closes, so the provided ledger will be used as base.
var options = {
    account: < rippleAccount >,
    limit: < Number between 10 and 400 >,
    ledger: < valid ledger_index or ledger_hash >
}
// The `marker` comes back in an account request if there are more results than are returned
// in the current response. The amount of results per response are determined by the `limit`.
if (marker) {
    options.marker = < marker >;
}
var request = remote.requestAccountOffers(options);
0.9.1
- Switch account requests to use ledgerSelect rather than ledgerChoose (278df90)
 - Deprecated setting 
identandaccount_indexon account requests (278df90) - Change initial account transaction sequence to 1 (a3c1d06)
 - Fix: instance transaction without remote (d3b6b81)
 - Fix: account root request ledger argument (bc1f9f8)
 - Fix: rsign.js local signing and example (d3b6b81 and f1004c6)
 
0.9.0
BREAKING CHANGES
- Make maxLoops in seed.get_key optional. Example use in tests (23e473b)
 
OTHER CHANGES
- Add routes to the vault client for KYC attestations (ed2da574)
 - Currency: add 
show_interestflag to show or hide interest inCurrency.to_human()andCurrency.to_json()Example use in tests - Configurable maxAttempts for transaction submission (d107092)
 - Binformat: added missing TransactionResult options (6abed8d)
 - Shrinkwrap packages for dependency locking (2dcd5f9)
 - Fix: Amount.to_human() precision bugs (4be209e and 7708c64)
 - Fix: change handling of requestLedger options (57b7030)
 
0.8.2
- Currency: Allow mixed letters and numbers in currencies
 - Deprecate account_tx map/reduce/filterg
 - Fix: correct requestLedger arguments
 - Fix: missing subscription on error events for some server methods
 - Fix: orderbook reset on reconnect
 - Fix: ripple-lib crashing. Add potential missing error handlers
 
0.8.1
- Wallet: Add Wallet class that generates wallets
 - Make npm test runnable in Windows.
 - Fix several stability issues, see merged PR's for details
 - Fix bug in Amount.to_human_full()
 - Fix undefined fee states when connecting to a rippled that is syncing
 
0.8.0
- Orderbook: Added tracking of offer funds for determining when offers are not funded
 - Orderbook: Added tests
 - Orderbook: Update owner funds
 - Transactions: If transaction errs with 
tefALREADY, wait until all possible submissions err with the same before emittingerror. Fixes a client "Transaction malformed" bug. - Transactions: Track submissions, don't bother submitting to unconnected servers
 - Request: 
request.request()now accepts an array of servers as first argument. Servers can be represented with URL, or the server object itself. - Request: 
request.broadcast()now returns the number of servers request was sent to - Server: Acquire host information from server without additional request
 - Amount: Add a constant for the maximum canonical value that can be expressed as a Ripple value
 - Amount: Make Constants static fields on the class, instead of a separate export
 
0.7.39
- Improvements to multi-server support. Fixed an issue where a server's score was not reset and connections would keep dropping after being connected for a significant amount of time.
 - Improvements in order book support. Added support for currency pairs with interest bearing currencies. You can request an order book with hex, ISO code or full name for the currency.
 - Fix value parsing for amount/currency order pairs, e.g. 
Amount.from_human("XAU 12345.6789") - Improved Amount parsing from human readable string given a hex currency, e.g. 
Amount.from_human("10 015841551A748AD2C1F76FF6ECB0CCCD00000000") - Improvements to username normalization in the vault client
 - Add 2-factor authentication support for vault client
 - Removed vestiges of Grunt, switched to Gulp
 
0.7.37
- 
Deprecations
- Removed humanistic amount detection in 
transaction.payment. Passing1XRPas the payment amount no longer works. remote.setServeruses full server URL rather than hostname. Example:remote.setServer('wss://s.ripple.com:443')`- Removed constructors for deprecated transaction types from 
transaction.js. - Removed 
invoiceIDoption fromtransaction.payment. Instead, use thetransaction.invoiceIDmethod. - Removed 
transaction.transactionManagergetter. 
 - Removed humanistic amount detection in 
 - 
Improved multi-server support. Servers are now ranked dynamically, and transactions are broadcasted to all connected servers.
 - 
Automatically ping connected servers. Client configuration now should contain
ping: <seconds>to specify the ping interval. - 
Added
transaction.lastLedgerto specifyLastLedgerSequence. Setting it this way also ensures that the sequence is not bumped on subsequent requests. - 
Added optional
remote.accountTxbinary parsing.{ binary: true, parseBinary: false } - 
Added full currency name support, e.g.
Currency.from_json('XRP').to_human({full_name:'Ripples'})will returnXRP - Ripples - 
Improved interest bearing currency support, e.g.
Currency.from_human('USD - US Dollar (2.5%pa)') - 
Improve test coverage
 - 
Added blob vault client. The vault client facilitates interaction with ripple's namespace and blob vault or 3rd party blob vaults using ripple's blob vault software (https://github.com/ripple/ripple-blobvault). A list of the available functions can be found at docs/VAULTCLIENT.md
 
0.7.35
LastLedgerSequenceis set by default on outgoing transactions. This refers to the last valid ledger index (AKA sequence) for a transaction. By default, this index is set to the current index (at submission time) plus 8. In theory, this allows ripple-lib to deterministically fail a transaction whose submission request timed out, but whose associated server continues to emit ledger_closed events.- Transactions that err with 
telINSUF_FEE_Pwill be automatically resubmitted. This error indicates that theFeesupplied in the transaction submission request was inadequate. Ideally, theFeeis tracked by ripple-lib in real-time, and the resubmitted transaction will most likely succeed. - Added Transaction.iff(function(callback) { }). Callback expects first argument to be an Error or null, second argument is a boolean which indicates whether or not to proceed with the transaction submission. If an 
ifffunction is specified, it will be executed prior to every submission of the transaction (including resubmissions). - Transactions will now emit 
presubmitandpostsubmitevents. They will be emitted before and after a transaction is submitted, respectively. - Added Transaction.summary(). Returns a summary of a transaction in semi-human-readable form. JSON-stringifiable.
 - Remote.requestAccountTx() with 
binary: truewill automatically parse transactions. - Added Remote.requestAccountTx filter, map, and reduce.
 
  remote.requestAccountTx({
    account: 'retc',
    ledger_index_min: -1,
    ledger_index_max: -1,
    limit: 100,
    binary: true,
    filter: function(transaction) {
      return transaction.tx.TransactionType === 'Payment';
    },
    map: function(transaction) {
      return Number(transaction.tx.Amount);
    },
    reduce: function(a, b) {
      return a + b;
    },
    pluck: 'transactions'
  }, console.log)
- Added persistence hooks.
 - General performance improvements, especially for long-running processes.