Skip to content

Latest commit

 

History

History
1242 lines (967 loc) · 61.9 KB

HISTORY.md

File metadata and controls

1242 lines (967 loc) · 61.9 KB
Raw

ripple-lib Release History

1.6.4 (2020-02-18)

  • Fix generateXAddress() and generateAddress() with no entropy (#1211, #1209)
  • Internal
    • Improve unit tests
  • Dependencies
    • Update webpack-cli, @types/node, webpack, @typescript-eslint/eslint-plugin, typescript, ripple-keypairs

1.6.3 (2020-02-05)

  • Update ripple-keypairs to 1.0.0
  • Bug fix: Assign event listener to socket close event on open before attempting post-open logic (#1186)
    • Protects against possible unhandled rejection in disconnect
    • Adds the Connection _ws.close event listener post _ws.open before executing any post _ws.open logic, i.e. Connection._subscribeToLedger
    • This prevents a reconnection error loop that occurs if Connection._ws is never cleaned up by the unreachable _ws.close event listener
    • Also ensures that a possible disconnect() promise rejection is not unhandled if any _ws.open logic in Connection.connect() throws
  • Dependencies
    • Update mocha-junit-reporter, @types/node, mocha, @typescript-eslint/eslint-plugin, ripple-address-codec

1.6.2 (2020-01-17)

  • Bug fix: Catch possible error in reconnect() on _heartbeat(), emit reconnect error (#1179)
  • Docs: Fix whitespace
  • Dependencies
    • Update @typescript-eslint/eslint-plugin, ts-node, @types/node, @types/ws, typescript

1.6.1 (2020-01-14)

Update Note: In this release we refactored the internal connection logic of ripple-lib to improve resiliency across dropped messages and reconnects. The external interface remains the same, with zero changes to public methods/properties. However, If you experience any problems around connections, requests, and request retries, please file an issue with the repo (and be sure to test against v1.6.0 to confirm that the problem was introduced in this version).

  • Documentation
    • Document message type 'path_find' (#1121) (thanks @r0bertz)
    • Improve documentation for address generation; functions that can be called offline; generateXAddress() (#1158, #1159, #1169) (thanks @hbergren)
    • Add Security Policy
  • Bug fixes
    • Types: Fix AccountObjectsResponse structure (#1127) (thanks @you21979)
    • In some cases, ripple-lib would fail to wait for the connection to be ready (#1119)
  • Dependencies
    • Update docs dependencies, ejs and doctoc (#1153)
    • Update eslint, ripple-lib-transactionparser, typescript, nyc, ws, @types/node, ripple-binary-codec, mocha, mocha-junit-reporter
  • Internal
    • Add LedgerHistory to Connection (#1119): Moved ledger logic into its own Ledger class

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 TransactionJSON type (#1096)
  • 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 _send promise passed to _whenReady in case there is rejection before async handlers are added (#1092) (thanks @nickewansmith)
  • Docs improvements
    • Add XRP Toolkit reference (#1088)
  • Internal improvements
    • Add a prettier config
    • Update Node.js Testing Versions (#1085)

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: getAccountObjects doc fix
  • Dependencies:
    • Update bignumber.js
    • Update ripple-keypairs
    • Update ws
  • Build process: Update webpack flow

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)

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
  • Expand APIOptions by extending ConnectionOptions (#1018, fixes #1017)
  • Fix docs for destination.address (#1011)

New features:

  • Support removing a signer list (#1021)
  • Export setCanonicalFlag method from src/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 prepareTransaction from overwriting Fee and/or LastLedgerSequence (#997)
  • Add deliveredAmount as optional field for type Outcome (#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-codec to 0.2.1 to support tecKILLED

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 message field of RippledErrors.
  • allows Sequence to be set in the transaction JSON provided to prepareTransaction.

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:

  1. The delivered_amount field has been added to the ledger method, and to transaction subscriptions.

     api.getLedger({includeTransactions: true, includeAllData: true, ledgerVersion: 17718771}).then(...)

    You can also call ledger directly:

     request('ledger', {...}).then(...)

  2. Support for Ed25519 seeds encoded using ripple-lib

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 submit response (#978)
    • Includes the full object returned by rippled, while keeping the existing fields for backward compatibility
  • Add getLedger option for ledger hash (#980)
    • Use the ledgerHash option to get a specific ledger by hash

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 getOrderbook offer sorting (#970)
    • BREAKING CHANGE: The ordering of offers returned by getOrderbook has been changed so that offers with the best quality are sorted first
  • Add new helper methods for working with the rippled APIs:
    • formatBidsAndAsks: Takes offers and returns a formatted order book object with bids and asks
    • renameCounterpartyToIssuer: Takes an object and renames the counterparty field to issuer
  • 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, the Outcome's balanceChanges property 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:
    1. Derive the public key from the secret.
    2. 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

Data Validation and Errors

Breaking Changes

The following changes were introduced in 1.0.0.

  • getTransaction() and getTransactions()
    • The specification.destination.amount field 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 Amount from the original transaction:
      • Use getTransaction's includeRawTransaction option, or
      • Use getTransactions's includeRawTransactions option, or
      • Use the rippled APIs directly with request. For example, call the API methods tx, account_tx, etc.
  • getLedger() response object
    • The rawTransactions field has been removed (for consistency with getTransaction() and getTransactions()).
    • Instead, within each transaction, use the new rawTransaction JSON string.
    • The metaData field has been renamed to meta for consistency with rippled's tx method.
    • ledger_index has been added to each raw transaction.

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)

1.0.0-beta.3 (2018-07-17)

  • For payment channel transactions, getTransaction includes a new channelChanges property 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 maxFeeXRP is '2' (2 XRP). Override this value in the RippleAPI constructor.
  • Attempting to prepare a transaction with an exact fee higher than maxFeeXRP causes a ValidationError to be thrown.
  • Attempting to sign a transaction with a fee higher than maxFeeXRP causes a ValidationError to be thrown.
  • The value returned by getFee() is capped at maxFeeXRP.

Other Changes

  • In Transaction Instructions, the maxFee parameter is deprecated. Use the maxFeeXRP parameter 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 of maxFeeXRP (default 2 XRP) applies. You can prepare more economical transactions by setting a lower maxFeeXRP, or support high-priority transactions by setting a higher maxFeeXRP in the RippleAPI constructor.
  • When using sign with a Fee higher than maxFeeXRP, a ValidationError is 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 Error or ValidationError if 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 rippled APIs.
  • Export xrpToDrops() and dropsToXrp() functions.
  • Potentially breaking change: Improve errors. For example, RippledError now includes the full response from the rippled server (#687). NotConnectedError may 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)

When using rippled APIs, you must:

  • For all XRP amounts, use drops (1 drop = 0.000001 XRP).
  • Instead of counterparty, use issuer.

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)

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)

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)

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)

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)

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.

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)

0.17.9 (2017-11-14)

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)

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-codec dependency version to 0.1.1 to fix issue with computeLedgerHash for transactions with DeliverMin

0.16.1

0.16.0

BREAKING CHANGES

OTHER CHANGES

0.15.2

0.15.1

0.15.0

BREAKING CHANGES

OTHER CHANGES

0.14.0

BREAKING CHANGES

OTHER CHANGES

0.13.2

0.13.1

0.13.0

BREAKING CHANGES

OTHER CHANGES

0.12.9

0.12.7 and 0.12.8

0.12.6

0.12.15

0.12.4

0.12.3

0.12.2

0.12.1

BREAKING CHANGES

OTHER CHANGES

0.12.0

BREAKING CHANGES

OTHER CHANGES

0.11.0

0.10.0

  • Transaction changes
  • Important tef* and tel* and errors will no longer be presented as final. Rather than considering these errors final, ripple-lib will wait until the LastLedgerSequence specified 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 MemoFormat property for memo
    • Enforce MemoFormat and MemoType to be valid ASCII
    • Support text and json MemoFormat
  • 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

0.9.3

0.9.2

BREAKING CHANGES

OTHER CHANGES

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);

Full working example

0.9.1

  • Switch account requests to use ledgerSelect rather than ledgerChoose (278df90)
  • Deprecated setting ident and account_index on 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

OTHER CHANGES

  • Add routes to the vault client for KYC attestations (ed2da574)
  • Currency: add show_interest flag to show or hide interest in Currency.to_human() and Currency.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 emitting error. 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

    1. Removed humanistic amount detection in transaction.payment. Passing 1XRP as the payment amount no longer works.
    2. remote.setServer uses full server URL rather than hostname. Example: remote.setServer('wss://s.ripple.com:443')`
    3. Removed constructors for deprecated transaction types from transaction.js.
    4. Removed invoiceID option from transaction.payment. Instead, use the transaction.invoiceID method.
    5. Removed transaction.transactionManager getter.

  • 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.lastLedger to specify LastLedgerSequence. Setting it this way also ensures that the sequence is not bumped on subsequent requests.

  • Added optional remote.accountTx binary parsing.

      {
    binary: true,
    parseBinary: false
  }

  • Added full currency name support, e.g. Currency.from_json('XRP').to_human({full_name:'Ripples'}) will return XRP - 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

  • LastLedgerSequence is 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_P will be automatically resubmitted. This error indicates that the Fee supplied in the transaction submission request was inadequate. Ideally, the Fee is 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 iff function is specified, it will be executed prior to every submission of the transaction (including resubmissions).
  • Transactions will now emit presubmit and postsubmit events. 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: true will 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.