From 9979d2701afb070db1220713f6eb487936e970a8 Mon Sep 17 00:00:00 2001 From: Alan Cohen Date: Thu, 5 Mar 2015 10:07:51 -0800 Subject: [PATCH 01/27] [DOC] Update REST quickstart docs --- content/ripplerest_api.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/ripplerest_api.md b/content/ripplerest_api.md index 4b95a49988..5bec9d5ad6 100644 --- a/content/ripplerest_api.md +++ b/content/ripplerest_api.md @@ -189,7 +189,7 @@ Following that, use these instructions to get Ripple-REST installed and running: 4. Copy the example config file to `config.json`: `cp config-example.json config.json` 5. Start the server: - `node server.js` + `npm start` 6. Visit [http://localhost:5990](http://localhost:5990) in a browser to view available endpoints and get started From 7836bf28b320ee77f5af94faee08afe43312de7c Mon Sep 17 00:00:00 2001 From: mDuo13 Date: Thu, 5 Mar 2015 12:11:22 -0800 Subject: [PATCH 02/27] [DOC] historicaldb - https --- content/historical_data.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/historical_data.md b/content/historical_data.md index a57752e79a..493ff4d13e 100644 --- a/content/historical_data.md +++ b/content/historical_data.md @@ -5,7 +5,7 @@ The `rippled` Historical Database provides access to raw Ripple transactions tha Ripple Labs provides a live instance of the `rippled` Historical Database API with as complete a transaction record as possible at the following address: -`history.ripple.com` +`https://history.ripple.com` The [rippled Historical Database source code](https://github.com/ripple/rippled-historical-database) is also available under an open-source license, so you can use, install, and contribute back to the project. From 45d56c2dce34f9da490efce8eb99621215debbe2 Mon Sep 17 00:00:00 2001 From: mDuo13 Date: Thu, 5 Mar 2015 17:05:20 -0800 Subject: [PATCH 03/27] [DOC] e2g revisions --- content/exchange_to_gateway.md | 84 ++++++++++++++++++---------------- 1 file changed, 44 insertions(+), 40 deletions(-) diff --git a/content/exchange_to_gateway.md b/content/exchange_to_gateway.md index a54ff4983f..9d9ca6a4e0 100644 --- a/content/exchange_to_gateway.md +++ b/content/exchange_to_gateway.md @@ -19,9 +19,9 @@ You are not on your own. Ripple Labs depends on the success of individual gatewa ## Ripple Gateways Explained ## -A Ripple _*Gateway*_ is an entity that exchanges value in the Ripple Network for value in the outside world, which is like performing deposits and withdrawals from Ripple. There are three major models that gateways can follow, with different purposes and modes of operation. +A Ripple _*Gateway*_ is an entity that exchanges value in the Ripple Network for value outside Ripple, so it connects Ripple to the outside world. There are three major models that gateways can follow, with different purposes and modes of operation. -* An **Issuing Gateway** receives money (or other assets of value) outside of Ripple, and creates _*issuances*_ in the Ripple Network. This provides a way for users to get money in and out of Ripple. This document focuses primarily on how to become an issuing gateway. +* An **Issuing Gateway** receives money (or other assets of value) outside of Ripple, and creates _*issuances*_ in the Ripple Network. This provides a direct way for users to get money in and out of Ripple. This document focuses primarily on how to become an issuing gateway. * A **Private Exchange** lets its users purchase and trade XRP among users of the private exchange. This is similar to being an exchange for any other commodity or cryptocurrency. However, unlike other cryptocurrencies, there is also an exchange built into the Ripple protocol itself. * A **Merchant** accepts payment within Ripple for goods or services outside the network. Unlike an issuing gateway, a merchant business does not create its own currency, but accepts issuances that are created by other gateways. This guide does not describe how to accept Ripple payments as a merchant. @@ -29,7 +29,8 @@ A Ripple _*Gateway*_ is an entity that exchanges value in the Ripple Network for All assets in Ripple, except for the native cryptocurrency XRP, are represented as *issuances*, which are digital assets that reflect traditional assets held by a gateway. Within Ripple, issuances can be sent and traded without the gateway's intervention and very low barriers to entry. Issuances get their value from gateway's agreement to honor the obligation that the issuances represent; there is no computer system that can force a Ripple gateway to honor that obligation. Therefore, Ripple's *trust lines* ensure that users only hold issuances from gateways they trust to pay out when needed. -A "trust line" is link between two accounts in Ripple that represents an explicit statement of willingness to hold gateway debt obligations. When a user sends money into Ripple, a Gateway takes custody of those assets outside of Ripple, and sends issuances within the Ripple network to the user. When a user sends money out of Ripple, she sends the issuances to the gateway, and the gateway then sends the assets to the user in the outside world. To redeem funds, a user simply makes a Ripple payment from her Ripple account to the Gateway's. +A "trust line" is link between two accounts in Ripple that represents an explicit statement of willingness to hold gateway debt obligations. When a user sends money into Ripple, a Gateway takes custody of those assets outside of Ripple, and sends issuances within the Ripple network to the user. When a user sends money out of Ripple, she makes a Ripple payment to the gateway, and the gateway then sends the assets to the user in the outside world. + ### XRP ### @@ -47,7 +48,7 @@ The Ripple network contains a distributed financial exchange, where any user can When adding a new gateway to the Ripple network, it is important to establish liquidity to other popular currencies. Because liquidity is provided by third-party market makers, a gateway can provide currency-exchange services through Ripple without having to keep a large reserve of currencies or shoulder the risk of financial exchange. -[Ripple Trade](https://www.rippletrade.com/) is the official client application, and it is used by a large number of market makers to participate in the global exchange. To make it easier on users to trade in ACME issuances, Ripple Labs can add a shortcut to ACME's gateway in Ripple Trade, so long as ACME meets certain best-practice requirements. +[Ripple Trade](https://www.rippletrade.com/) is the official client application, and it is used by a large number of market makers to participate in the global exchange. To make it easier on users to trade in ACME issuances, Ripple Labs can add a shortcut to ACME's gateway in Ripple Trade, so long as ACME meets [certain best-practice requirements](https://ripple.com/files/GB-2015-02.pdf). Contact [partners@ripple.com](mailto:partners@ripple.com) for help establishing a market between your gateway and others, and about getting your gateway listed in Ripple Trade. @@ -100,13 +101,12 @@ Funds in Ripple tend to flow in a cycle, from the cold wallet to the warm wallet There are several ways in which a gateway can seek to benefit financially from Ripple integration. These can include: -* Indirect revenue from value added. Ripple integration can provide valuable functionality for your customers that distinguishes your business from your competitors. * Withdrawal and Deposit fees. It is typical for a gateway to charge a small fee (such as 1%) for the service of adding or removing money from Ripple. You have the power to determine the rate you credit people when they move money onto and off of Ripple through your gateway. * Transfer fees. You can set a percentage fee to charge automatically when Ripple users send each other issuances created by your account. This amount is debited from the Ripple ledger, decreasing your obligation each time your issuances change hands. See [TransferRate](#transferrate) for details. +* Indirect revenue from value added. Ripple integration can provide valuable functionality for your customers that distinguishes your business from your competitors. * Interest on Ripple-backed funds. You can keep some of your Ripple-backing currency in an external account that earns interest. Just make sure you can always access enough funds to service customer withdrawals. * [Market making](#market-makers). A gateway can also make offers to buy and sell its issuances for other issuances on Ripple, providing liquidity to cross-currency payments and possibly making a profit. (As with any market making opportunity, profits are not guaranteed.) -TODO: Diagram of fee sources ### Choosing Fee Rates ### @@ -120,9 +120,9 @@ Fees imposed by gateways are optional. Obviously, higher fees mean more revenue Our example exchange, ACME, already accepts withdrawals and deposits from users using some existing system, and uses an internal accounting system to track how much balance each user has with the exchange. Such a system can be modeled simply with a balance sheet and tracking how much currency each user has on hand. -In the following diagram, ACME Exchange starts with €5 on hand, including €1 that belongs to Bob, €2 that belongs to Charlie, and an additional €2 of reserves that belong to ACME itself. Alice deposits €4, so ACME adds her to its balance sheet and ends up with €9. +In the following diagram, ACME Exchange starts with €5 on hand, including €1 that belongs to Bob, €2 that belongs to Charlie, and an additional €2 of equity that belongs to ACME itself. Alice deposits €5, so ACME adds her to its balance sheet and ends up with €10. -![Alice sends €4 to ACME. ACME adds her balance to its balance sheet.](img/e2g-01.png) +![Alice sends €5 to ACME. ACME adds her balance to its balance sheet.](img/e2g-01.png) **Assumptions:** To integrate with Ripple, we assume that an exchange such as ACME meets the following assumptions: @@ -133,27 +133,29 @@ In the following diagram, ACME Exchange starts with €5 on hand, including €1 ## Sending from Gateway to Ripple ## -Ripple payments can automatically bridge between currencies, but an issuing gateway normally only sends single-currency payments that go directly to users. This means moving funds from a user's balance to a separate "Ripple-backing" balance, and then sending the equivalent amount of issuances in Ripple to the user's Ripple account. +Ripple payments can automatically bridge between currencies, but an issuing gateway normally only sends single-currency payments that go directly to users. This means debiting a user's current balance, and then sending the equivalent amount of issuances in Ripple to the user's Ripple account. -An example of a deposit flow: +An example flow for a payment into Ripple: -1. Alice asks to deposit €2 of her ACME balance into Ripple. -2. In its internal accounting, ACME debits Alice's balance €3 and credits the Ripple-backed balance by €2. -3. ACME submits a Ripple transaction, sending €2 to Alice's Ripple address. The €2 is marked in Ripple as being "issued" by ACME (2 EUR.ACME). +1. Alice asks to send €3 of her ACME balance into Ripple. +2. Internally, ACME debits Alice's balance €3. +3. ACME submits a Ripple transaction, sending €3 to Alice's Ripple address. The €3 is marked in the Ripple network as being "issued" by ACME (3 EUR.ACME). **Assumptions:** -* Alice already has a Ripple account separate from her ACME account, which she manages using an application such as Ripple Trade. +* Alice already has an account in the Ripple network separate from her ACME account, which she manages using an application such as Ripple Trade. ![ACME issues 3 EUR.ACME to Alice on Ripple](img/e2g-02.png) + + ### Requirements for Sending to Ripple ### There are several prerequisites that ACME must meet in order for this to happen: -- ACME modifies its core accounting system to track money that is backing funds issued on the Ripple Network. This could be as simple as adding a record for Ripple. - - Optionally, a gateway can take additional steps to separate normal user funds from funds backing the gateway's Ripple issuances. For example, the funds allocated to Ripple can be stored in a separate bank account. A cryptocurrency exchange can create a separate wallet to hold the funds allocated to Ripple, as publicly-verifiable proof to customers that the gateway is solvent. -- ACME must have a Ripple account. Our best practices recommend actually having at least two accounts: a "cold wallet" account to issue currency, and one or more "hot wallet" accounts that perform day-to-day transactions. See [Hot and Cold Wallets](#hot-and-cold-wallets) for more information. +- ACME modifies its core accounting system to track money that is backing funds issued on the Ripple Network. ACME can query Ripple to see who holds its Ripple issuances at any time. + - Optionally, a gateway can take additional steps to separate the assets backing the gateway's Ripple issuances. For example, the funds allocated to Ripple can be stored in a separate "Ripple Escrow" bank account. A cryptocurrency exchange can create a separate wallet to hold the funds allocated to Ripple, as publicly-verifiable proof to customers that the gateway is solvent. +- ACME must have an account on the Ripple network. Our best practices recommend actually having at least two accounts: a "cold wallet" account to issue currency, and one or more "hot wallet" accounts that perform day-to-day transactions. See [Hot and Cold Wallets](#hot-and-cold-wallets) for more information. - Alice must create a trustline from her Ripple account to ACME's issuing (cold wallet) account. She can do this from any Ripple client (such as [Ripple Trade](https://www.rippletrade.com/) as long as she knows the address or Ripple Name of ACME's cold wallet. - In order to do this, Alice needs to find the address of ACME's cold wallet. ACME can publicize its cold wallet address on its website, or have its gateway listed in a client such as Ripple Trade. See [Setting Trust Lines in Ripple Trade](#setting-trust-lines-in-ripple-trade). - ACME must create a user interface for Alice to send funds from ACME into Ripple. @@ -162,12 +164,12 @@ There are several prerequisites that ACME must meet in order for this to happen: ## Sending from Ripple to Gateway ## -A withdrawal from Ripple means moving funds from the Ripple-backed balance at a gateway into a user account in response to receiving a Ripple payment. +A payment out of Ripple means the Gateway receives a payment in the Ripple network, and credits a user outside of Ripple. -An example of a withdrawal flow: +An example flow of a payment out of Ripple: 1. Bob sends Ripple transaction of €1 to ACME's cold wallet. -2. In its internal accounting, ACME debits its Ripple-backing balance €1 and credits Bob's balance €1. +2. In its internal accounting, credits Bob's balance €1. Payments going from Ripple to a gateway can be single-currency or cross-currency payments. Users can choose the exchange rates in a Ripple client application such as Ripple Trade, so that the gateway receives issuances created by its cold wallet account. @@ -175,7 +177,7 @@ Payments going from Ripple to a gateway can be single-currency or cross-currency In addition to the [requirements for making deposits possible](#deposit-requirements), there are several prerequisites that ACME must meet in order to process payments coming from Ripple: -- ACME must monitor its Ripple accounts for incoming payments. +- ACME must monitor its cold and hot wallet Ripple accounts for incoming payments. - ACME must know which user to credit internally for the incoming payments. - We recommend that ACME should [bounce any unrecognized incoming payments](#bouncing-payments) back to their sender. - Typically, the preferred method of recognizing incoming payments is through [destination tags](#destination-tags). @@ -185,15 +187,15 @@ In addition to the [requirements for making deposits possible](#deposit-requirem Processing payments to and from Ripple naturally comes with some risks, so a gateway should be sure to take care in implementing these processes. We recommend the following precautions: -- Protect yourself against reversible deposits. Ripple payments are irreversible, but many electronic money systems like credit cards or PayPal are not. Scammers can abuse this to take their fiat money back after receiving Ripple issuances. -- Before processing a payment out of Ripple, make sure you know the customer's identity. This is especially important because the users sending money from Ripple could be different than the ones that initially received the money in Ripple. +- Protect yourself against reversible deposits. Ripple payments are irreversible, but many electronic money systems like credit cards or PayPal are not. Scammers can abuse this to take their fiat money back by canceling a deposit after receiving Ripple issuances. +- Before processing a payment out of Ripple, make sure you know the customer's identity. This makes it harder for anonymous attackers to scam you, and it is also an important element of most anti-money-laundering regulations. This is especially important because the users sending money from Ripple could be different than the ones that initially received the money in Ripple. - Follow the guidelines for [reliable transaction submission](#reliable-transaction-submission) when sending Ripple transactions. -- [Robustly monitor for incoming payments](#robustly-monitor-for-payments), and read the correct amount. Don't be deceived by [Partial Payments](transactions.html#partial-payments). -- Track your obligations and balances within the Ripple network, and compare with your assets off the network. If they do not match up, stop processing withdrawals and deposits until you resolve the discrepancy. (TODO: Link to tallying bulletin when it comes out) +- [Robustly monitor for incoming payments](#robustly-monitor-for-payments), and read the correct amount. Don't mistakenly credit someone the full amount if they only sent a [partial payment](transactions.html#partial-payments). +- Track your obligations and balances within the Ripple network, and compare with your assets off the network. If they do not match up, stop processing withdrawals and deposits until you resolve the discrepancy. - Proactively avoid ambiguous situations. We recommend the following: - - Enable the [`DisallowXRP` flag](#disallowxrp) for the cold wallet account and all hot wallet accounts, so users do not accidentally send you XRP. (Private exchanges should *not* set this flag, since they do trade XRP.) - - Enable the [`RequireDest` flag](#requiredest) for the cold wallet account and all hot wallet accounts, so users do not accidentally forget the destination tag on payments to make withdrawals. - - Enable the [`RequireAuth` flag](#requireauth) on all hot wallet accounts so they cannot create their own issuances. + - Enable the [`DisallowXRP` flag](#disallowxrp) for the cold wallet account and all hot wallet accounts, so users do not accidentally send you XRP. (Private exchanges should *not* set this flag, since they trade XRP normally.) + - Enable the [`RequireDest` flag](#requiredest) for the cold wallet account and all hot wallet accounts, so users do not accidentally send a payment without the destination tag to indicate who should be credited. + - Enable the [`RequireAuth` flag](#requireauth) on all hot wallet accounts so they cannot unintentionally create their own issuances. - Monitor for suspicious or abusive behavior. For example, a user could repeatedly withdraw and deposit funds in Ripple, as a sort of "denial of service" attack that effectively empties the hot wallet. Suspend users whose accounts are involved in suspicious behavior by not processing their Ripple payments. @@ -204,6 +206,7 @@ After the issuances have been created in Ripple, they can be freely transferred - Anyone can buy/sell EUR.ACME on Ripple. If ACME issues multiple currencies on Ripple, a separate trust line is necessary for each. - This includes users who do not have an account with ACME Exchange. In order to withdraw the funds successfully from ACME, users still have to create ACME accounts. - Optionally, use the [Authorized Accounts](#authorized-accounts) feature to limit who can hold EUR.ACME on Ripple. + - If a gateway determines that a user has acted in bad faith, the gateway can [Freeze](#freezes) that user's trust line to the gateway, so that the user can no longer trade in the gateway's issuances. - Ripple users trading and sending EUR.ACME to one another requires no intervention by ACME. - All exchanges and balances on Ripple are publicly viewable in the shared, global ledger. @@ -236,7 +239,7 @@ For more information, see the [Gateway Bulletin on Freezes](https://ripple.com/f Ripple's Authorized Accounts feature enables a gateway to limit who can hold that gateway's issuances, so that unknown Ripple accounts cannot hold the currency your gateway issues. We feel this is *not necessary* in most cases, since gateways have full control over the process of redeeming Ripple balances for value in the outside world. (You can collect customer information and impose limits on withdrawals at that stage without worrying about what happens within the Ripple network.) -To use the Authorized Accounts feature, a gateway first enables the `RequireAuth` flag for its cold wallet account, and then manually approves each user account's trust line before sending issuances in Ripple to that account. +To use the Authorized Accounts feature, a gateway enables the `RequireAuth` flag for its cold wallet account, and then manually approves each user account's trust line before sending issuances in Ripple to that account. You must authorize trust lines using the same cold wallet account that issues the currency, which unfortunately means an increased risk exposure for that account. The process for sending funds into Ripple with RequireAuth enabled looks like the following: @@ -303,9 +306,9 @@ Enable the [RequireDest](#requiredest) flag on your hot and cold wallet accounts ## DisallowXRP ## -The DisallowXRP flag (`disallow_xrp` in Ripple-REST) is designed to discourage users from sending XRP to your account by accident. This reduces the costs and effort of bouncing undesired payments, if you operate a gateway that does not trade XRP. The DisallowXRP flag is not strictly enforced, because doing so could allow accounts to become permanently unusable. Client applications should honor it, but it is intentionally possible to work around. +The DisallowXRP flag (`disallow_xrp` in Ripple-REST) is designed to discourage users from sending XRP to an account by accident. This reduces the costs and effort of bouncing undesired payments, if you operate a gateway that does not trade XRP. The DisallowXRP flag is not strictly enforced, because doing so could allow accounts to become permanently unusable if they run out of XRP. Client applications should honor the DisallowXRP flag, but it is intentionally possible to work around. -An issuing gateway should enable the DisallowXRP flag on all gateway hot and cold wallets that are not expected to trade XRP. A private exchange that trades in XRP should not enable the DisallowXRP flag. +An issuing gateway that does not trade XRP should enable the DisallowXRP flag on all gateway hot and cold wallets. A private exchange that trades in XRP should only enable the DisallowXRP flag on accounts that are not expected to receive XRP. The following is an example of a [Ripple-REST Update Account Settings request](ripple-rest.html#update-account-settings) to enable the DisallowXRP flag: @@ -342,7 +345,7 @@ Response: } ``` -A successful response shows `"state": "validated"` when the change has been accepted into a validated Ripple ledger. +The value `"disallow_xrp": true` indicates that the DisallowXRP flag is enabled. A successful response shows `"state": "validated"` when the change has been accepted into a validated Ripple ledger. ## RequireDest ## @@ -385,7 +388,7 @@ Response: } ``` -A successful response shows `"state": "validated"` when the change has been accepted into a validated Ripple ledger. +The value `"require_destination_tag": true` indicates that the RequireDest flag has been enabled. A successful response shows `"state": "validated"` when the change has been accepted into a validated Ripple ledger. ## RequireAuth ## @@ -483,16 +486,17 @@ A successful response shows `"state": "validated"` when the change has been acce In order to robustly monitor incoming payments, gateways should do the following: -* Keep a record of the most-recently-processed transaction. That way, if you temporarily lose connectivity, you know how far to go back. +* Keep a record of the most-recently-processed transaction and ledger. That way, if you temporarily lose connectivity, you know how far to go back. * Check the result code of every incoming payment. Some payments go into the ledger to charge an anti-spam fee, even though they failed. Only transactions with the result code `tesSUCCESS` can change non-XRP balances. Only transactions from a validated ledger are final. * Look out for Partial Payments. If an incoming transaction has a `destination_balance_changes` field (Ripple-REST) or a `meta.AmountDelivered` field (WebSocket/JSON-RPC), then use that to see how much money *actually* got delivered to the destination account. Payments with the partial-payment flag enabled are considered "successful" if any non-zero amount is delivered, even miniscule amounts. (The flag is called `"partial_payment": true` in REST, and `tfPartialPayment` in WebSocket/JSON-RPC) * Some transactions modify your balances without being payments directly to or from one of your accounts. For example, if ACME sets a nonzero [TransferRate](#transferrate), then ACME's cold wallet's outstanding obligations decrease each time Bob and Charlie exchange ACME issuances. See [TransferRate](#transferrate) for more information. To make things simpler for your users, we recommend monitoring for incoming payments to hot wallets and the cold wallet, and treating the two equivalently. -As an added precaution, we recommend regularly comparing the balances of your Ripple cold wallet account with the Ripple-backing funds in your internal accounting system. The cold wallet's shows all outstanding issuances as negative balances, which should be match the positive assets you hold outside the network, backing Ripple. If the two do not match up, then you should suspend processing payments in and out of Ripple until you have resolved the discrepancy. +As an added precaution, we recommend comparing the balances of your Ripple cold wallet account with the Ripple-backing funds in your internal accounting system each time there is a new Ripple ledger. The cold wallet shows all outstanding issuances as negative balances, which should match the positive assets you have allocated to Ripple outside the network. If the two do not match up, then you should suspend processing payments in and out of Ripple until you have resolved the discrepancy. * Use the [Get Account Balances method](ripple-rest.html#get-account-balances) (Ripple-REST) or the [`account_lines` command](rippled-apis.html#account-lines) (rippled) to check your balances. +* If you have a [TransferRate](#transferrate) set, transferring your issuances from one Ripple account to another decreases the obligation you owe within the Ripple network. ## TransferRate ## @@ -543,13 +547,13 @@ Response: } ``` -A successful response shows `"state": "validated"` when the change has been accepted into a validated Ripple ledger. +The field `transfer_rate` in the `settings` object should have the value you set. A successful response shows `"state": "validated"` when the change has been accepted into a validated Ripple ledger. ### TransferRate with Hot and Warm Wallets ### -All Ripple Accounts, including the hot wallet, are subject to the TransferRate. If you set a nonzero TransferRate, then you must send extra (to pay the TransferRate) when making payments to users from your hot wallet. You can accomplish this by setting the `source_amount` (Ripple-REST) or the `SendMax` (rippled) parameters higher than the destination amount. +All Ripple Accounts, including the hot wallet, are subject to the TransferRate. If you set a nonzero TransferRate, then you must send extra (to pay the TransferRate) when making payments to users from your hot wallet. You can accomplish this by setting the `source_amount` plus `slippage` (Ripple-REST) or the `SendMax` (rippled) parameters higher than the destination amount. -**Note:** The TransferRate does not apply when sending issuances back to the account that created them. The account that created issuances must always accept them at face value on Ripple. This means that users don't have to pay the TransferRate if they send payments to the cold wallet directly, but they do when sending to the hot wallet. (For example, if ACME sets a TransferRate of 1%, a Ripple payment with `source_amount` and `destination_amount` of 5 USD@ACME (and `slippage` of 0) would succeed if sent to ACME's cold wallet, but it would fail if sent to ACME's hot wallet. The hot wallet payment would only succeed if the `source_amount` plus `slippage` was at least 5.05 USD@ACME.) If you accept payments to both accounts, you may want to adjust the amount you credit users in your external system accordingly. +**Note:** The TransferRate does not apply when sending issuances back to the account that created them. The account that created issuances must always accept them at face value on Ripple. This means that users don't have to pay the TransferRate if they send payments to the cold wallet directly, but they do when sending to the hot wallet. (For example, if ACME sets a TransferRate of 1%, a Ripple payment with `source_amount` and `destination_amount` of 5 EUR.ACME (and `slippage` of 0) would succeed if sent to ACME's cold wallet, but it would fail if sent to ACME's hot wallet. The hot wallet payment would only succeed if the `source_amount` plus `slippage` was at least 5.05 EUR.ACME.) If you accept payments to both accounts, you may want to adjust the amount you credit users in your external system accordingly. @@ -559,7 +563,7 @@ When your hot or cold wallet receives a payment whose purpose is unclear, we rec The first requirement to bouncing payments is [robustly monitoring for incoming payments](#robustly-monitoring-for-payments). You do not want to accidentally refund a user for more than they sent you! (This is particularly important if your bounce process is automated.) -Second, you should send bounced payments as Partial Payments. Since other Ripple users can manipulate the cost of pathways between your accounts, Partial Payments allow you to divest yourself of the full amount without being concerned about how much you might have to pay in fees. +Second, you should send bounced payments as Partial Payments. Since other Ripple users can manipulate the cost of pathways between your accounts, Partial Payments allow you to divest yourself of the full amount without being concerned about exchange rates within the Ripple network. You should publicize your bounced payments policy as part of your terms of use. To send a Partial Payment in Ripple-REST, set the `partial_payment` field to true in the object returned by the [Prepare Payment method](ripple-rest.html#prepare-payment) before submitting it. Set the `source_amount` to be equal to the `destination_amount` and the `slippage` to `"0"`. @@ -605,7 +609,7 @@ _(**Reminder:** Don't send your secret to a server you do not control.)_ ## Setting Trust Lines in Ripple Trade ## -Follow these steps to extend a trust line to a Gateway's issuing (cold wallet) account in the Ripple Trade client. +As part of the [Hot and Cold Wallets](#hot-and-cold-wallets) model, each hot or warm wallet must have a trust line to the cold wallet. You can manually set up those trust lines by following these steps in the Ripple Trade client. 1. Log in and go to the **Fund** tab: ![Fund tab](img/connectgateway_01.png) From 1f868ef0d9b4745a00c5c02680308d79e75b9403 Mon Sep 17 00:00:00 2001 From: mDuo13 Date: Thu, 5 Mar 2015 17:28:19 -0800 Subject: [PATCH 04/27] [DOC] e2g - add warning about requiredauth on empty owner dir --- content/exchange_to_gateway.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/content/exchange_to_gateway.md b/content/exchange_to_gateway.md index 9d9ca6a4e0..65e693827d 100644 --- a/content/exchange_to_gateway.md +++ b/content/exchange_to_gateway.md @@ -393,10 +393,12 @@ The value `"require_destination_tag": true` indicates that the RequireDest flag ## RequireAuth ## -The `RequireAuth` flag (`require_authorization` in Ripple-REST) prevents a Ripple account's issuances from being held by other users unless the issuer approves them. +The `RequireAuth` flag (`require_authorization` in Ripple-REST) prevents a Ripple account's issuances from being held by other users unless the issuer approves them. We recommend enabling RequireAuth for all hot wallet (and warm wallet) accounts, as a precaution. Separately, the [Authorized Accounts](#authorized-accounts) feature involves setting the RequireAuth flag on your cold wallet. +You can only enable RequireAuth if the account owns no trust lines and no offers in the Ripple ledger, so you must decide whether or not to use it before you start doing business in the Ripple network. + ### With Hot Wallets ### We recommend enabling `RequireAuth` for all hot wallet accounts, and then never approving any accounts, in order to prevent hot wallets from creating issuances even by accident. This is a purely precuationary measure, and does not impede the ability of those accounts to transfer issuances created by the cold wallet, as they are intended to do. From e9bdbb8ce2d025f875e4d9aeb4d7da2c644724b1 Mon Sep 17 00:00:00 2001 From: mDuo13 Date: Fri, 13 Mar 2015 15:17:57 -0700 Subject: [PATCH 05/27] [DOC] DefaultRipple-related changes --- content/rippled.md | 4 ++-- content/tx_format.md | 5 +++-- 2 files changed, 5 insertions(+), 4 deletions(-) diff --git a/content/rippled.md b/content/rippled.md index bbc77fe1a5..3d0db569f9 100644 --- a/content/rippled.md +++ b/content/rippled.md @@ -496,7 +496,7 @@ Accounts are the core unit of authentication in the Ripple Network. Each account ## account_currencies ## [[Source]
](https://github.com/ripple/rippled/blob/df966a9ac6dd986585ecccb206aff24452e41a30/src/ripple/rpc/handlers/AccountCurrencies.cpp "Source") -The `account_currencies` command retrieves a simple list of currencies that an account can send or receive, based on its trustlines. (This is not a thoroughly confirmed list, but it can be used to populate user interfaces.) +The `account_currencies` command retrieves a simple list of currencies that an account can send or receive, based on its trust lines. (This is not a thoroughly confirmed list, but it can be used to populate user interfaces.) #### Request Format #### An example of the request format: @@ -632,7 +632,7 @@ The response follows the [standard format](#response-formatting), with a success | send\_currencies | Array of Strings | Array of currency codes for currencies that this account can send. Each currency is either a 3-letter [ISO 4217 Currency Code](http://www.xe.com/iso4217.php) or a 160-bit hex value according to the [currency format](https://wiki.ripple.com/Currency_format). | | validated | Boolean | If `true`, this data comes from a validated ledger. | -*Note:* The currencies that an account can send or receive are defined based on a simple check of its trust lines. if an account has a trust line for a currency and enough room to increase its balance, it can receive that currency. If the trustline's balance can go down, the account can send that currency. This method *does not* check whether the trust line is frozen or authorized. +*Note:* The currencies that an account can send or receive are defined based on a simple check of its trust lines. If an account has a trust line for a currency and enough room to increase its balance, it can receive that currency. If the trust line's balance can go down, the account can send that currency. This method *does not* check whether the trust line is frozen or authorized. #### Possible Errors #### diff --git a/content/tx_format.md b/content/tx_format.md index e02eec1666..fe5b88855d 100644 --- a/content/tx_format.md +++ b/content/tx_format.md @@ -465,8 +465,9 @@ The available AccountSet flags are: | asfDisallowXRP | 3 | XRP should not be sent to this account. (Enforced by client applications, not by `rippled`) | lsfDisallowXRP | | asfDisableMaster | 4 | Disallow use of the master key. Can only be enabled if the account has a [RegularKey](#setregularkey) configured. | lsfDisableMaster | | asfAccountTxnID | 5 | Track the ID of this account's most recent transaction. Required for [AccountTxnID](#accounttxnid) | (None) | -| asfNoFreeze | 6 | Permanently give up the ability to freeze individual trust lines. This flag can never be cleared. | lsfNoFreeze | +| asfNoFreeze | 6 | Permanently give up the ability to freeze individual trust lines. This flag can never be disabled after being enabled. | lsfNoFreeze | | asfGlobalFreeze | 7 | Freeze all assets issued by this account. | lsfGlobalFreeze | +| asfDefaultRipple | 8 | Enable [rippling](https://ripple.com/knowledge_center/understanding-the-noripple-flag/) on this account's trust lines by default. _(New in [rippled 0.27.3](https://github.com/ripple/rippled/releases/tag/0.27.3))_ | lsfDefaultRipple | The following [Transaction flags](#flags), specific to the AccountSet transaction type, serve the same purpose, but are discouraged: @@ -698,7 +699,7 @@ There are two cases where you can hold a balance on a trust line that is *greate Since a trust line occupies space in the ledger, [a trust line increases the XRP your account must hold in reserve](https://wiki.ripple.com/Reserves). This applies to the account extending trust, not to the account receiving it. -A trust line with a limit *and* a balance of 0 is equivalent to no trust line. +A trust line with settings in the default state is equivalent to no trust line. ### TrustSet Flags ### From e0891bae5a62d8ea532f2f8fb3b3ef98addda2eb Mon Sep 17 00:00:00 2001 From: mDuo13 Date: Mon, 16 Mar 2015 14:24:58 -0700 Subject: [PATCH 06/27] [CLEANUP] rename e2g -> gateway guide --- content/{exchange_to_gateway.md => gateway_guide.md} | 0 gateway_guide.html | 2 +- tool/pages.json | 2 +- tool/parse_pages.py | 0 4 files changed, 2 insertions(+), 2 deletions(-) rename content/{exchange_to_gateway.md => gateway_guide.md} (100%) mode change 100644 => 100755 tool/parse_pages.py diff --git a/content/exchange_to_gateway.md b/content/gateway_guide.md similarity index 100% rename from content/exchange_to_gateway.md rename to content/gateway_guide.md diff --git a/gateway_guide.html b/gateway_guide.html index b016b67499..f4df5dffd8 100644 --- a/gateway_guide.html +++ b/gateway_guide.html @@ -36,7 +36,7 @@ $(".flatdoc-content").empty(); $(".content-root .menubar .menu").empty(); Flatdoc.run({ - fetcher: Flatdoc.file('content/exchange_to_gateway.md') + fetcher: Flatdoc.file('content/gateway_guide.md') }); $(document).on('flatdoc:ready', function() { $().multicode_tabs(); diff --git a/tool/pages.json b/tool/pages.json index b87a28bca5..edd1b4a6ca 100644 --- a/tool/pages.json +++ b/tool/pages.json @@ -26,7 +26,7 @@ }, { "name": "Gateway Guide", - "md":"exchange_to_gateway.md", + "md":"gateway_guide.md", "html":"gateway_guide.html" }, { diff --git a/tool/parse_pages.py b/tool/parse_pages.py old mode 100644 new mode 100755 From 8dfd5597f953603260535357349d80a5be7a0d74 Mon Sep 17 00:00:00 2001 From: mDuo13 Date: Mon, 16 Mar 2015 14:37:37 -0700 Subject: [PATCH 07/27] [FEATURE] API tools: use real links for commandlist; generate REST commandlist automatically --- css/api-style.css | 28 ++- js/apitool-methods-ripplerest.js | 307 +++++++++++++++++++++++++ js/apitool-rest.js | 371 +++++-------------------------- rest-api-tool.html | 29 +-- ripple-api-tool.html | 42 ++-- 5 files changed, 404 insertions(+), 373 deletions(-) create mode 100644 js/apitool-methods-ripplerest.js diff --git a/css/api-style.css b/css/api-style.css index f09df78686..f16b6bfa04 100644 --- a/css/api-style.css +++ b/css/api-style.css @@ -49,7 +49,7 @@ h2 { margin:0; height:100%; } -#command_list li { +/*#command_list li { padding:4px 12px; display:block; width:200px; @@ -61,13 +61,32 @@ h2 { -moz-user-select:none; color:#0088CC; } -#command_list li:hover { - color:#444; -} #command_list li.selected { color:#444; background:#f0f0f0; + cursor: auto; +}*/ + +#command_list li { + width: 200px; } + +#command_list li.selected a { + cursor: default; + text-decoration: none; + color: #444; + background: #f0f0f0; +} + +#command_list li.separator { + color: #474648; + font-family: "Open Sans",sans-serif; + font-size: 13px; + text-transform: uppercase; + font-weight: bold; + margin-top: 10px; +} + #command_table { height:100%; } @@ -454,3 +473,4 @@ span.cm-atom { #rest_url div input { display: block; } + diff --git a/js/apitool-methods-ripplerest.js b/js/apitool-methods-ripplerest.js new file mode 100644 index 0000000000..855b7f92d0 --- /dev/null +++ b/js/apitool-methods-ripplerest.js @@ -0,0 +1,307 @@ +//---------- List of requests ------------------------// +// Must be loaded after apitool-rest.js // + +var DEFAULT_ADDRESS_1 = "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn"; +var DEFAULT_ADDRESS_2 = "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX"; +var DEFAULT_ADDRESS_3 = "rJnZ4YHCUsHvQu7R6mZohevKJDHFzVD6Zr"; +var DEFAULT_HASH = "9D591B18EDDD34F0B6CF4223A2940AEA2C3CC778925BABF289E0011CD8FA056E"; +var DEFAULT_SECRET = "sn3nxiW7v8KXzPzAqzyHXbSSKNuN9"; + +Request('ACCOUNTS'); + +Request('Generate Wallet', { + method: GET, + path: "/v1/wallet/new", + description: 'Randomly generate keys for a potential new Ripple account.', + link: '#generate-wallet' +}); + +Request('Get Account Balances', { + method: GET, + path: '/v1/accounts/{:address}/balances?{:query_params}', + description: 'Retrieve the current balances for the given Ripple account.', + link: '#get-account-balances', + params: { + "{:address}": DEFAULT_ADDRESS_1, + "{:query_params}": "currency=USD" + } +}); + +Request('Get Account Settings', { + method: GET, + path: '/v1/accounts/{:address}/settings', + description: 'Retrieve the current settings for the given Ripple account.', + link: '#get-account-settings', + params: { + "{:address}": DEFAULT_ADDRESS_1 + } +}); + +Request('Update Account Settings', { + method: POST, + path: '/v1/accounts/{:address}/settings?{:query_params}', + description: 'Change the current settings for the given Ripple account.', + link: '#update-account-settings', + test_only: true, + params: { + "{:address}": DEFAULT_ADDRESS_1, + "{:query_params}": "validated=true" + }, + body: { + secret: DEFAULT_SECRET, + settings: { + require_destination_tag: false, + require_authorization: false, + disallow_xrp: false, + disable_master: false, + email_hash: "98b4375e1d753e5b91627516f6d70977" + } + } +}); + +Request("PAYMENTS"); + +Request('Prepare Payment', { + method: GET, + path: '/v1/accounts/{:source_address}/payments/paths/{:destination_address}/{:amount}?{:query_params}', + description: 'Retrieve possible payment objects for a desired payment.', + link: '#prepare-payment', + params: { + "{:source_address}": DEFAULT_ADDRESS_1, + "{:destination_address}": DEFAULT_ADDRESS_2, + "{:amount}": "1+USD+rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn", + "{:query_params}": "source_currencies=USD" + } +}); + +Request('Submit Payment', { + method: POST, + path: '/v1/accounts/{:source_address}/payments?{:query_params}', + description: 'Send a prepared payment to the network.', + link: '#submit-payment', + test_only: true, + body: { + "secret": DEFAULT_SECRET, + "client_resource_id": "348170b9-16b9-4927-854d-7f9d4a2a692d", + "payment": { + "source_account": DEFAULT_ADDRESS_1, + "source_tag": "", + "source_amount": { + "value": "1", + "currency": "USD", + "issuer": "" + }, + "source_slippage": "0", + "destination_account": DEFAULT_ADDRESS_2, + "destination_tag": "", + "destination_amount": { + "value": "1", + "currency": "USD", + "issuer": DEFAULT_ADDRESS_1 + }, + "invoice_id": "", + "paths": "[]", + "partial_payment": false, + "no_direct_ripple": false + } + }, + params: { + "{:source_address}": DEFAULT_ADDRESS_1, + "{:query_params}": "validated=true" + } +}); + +Request("Confirm Payment", { + method: GET, + path: "/v1/accounts/{:address}/payments/{:id}", + description: "Retrieve details of a payment and its status.", + link: "#confirm-payment", + params: { + "{:address}": DEFAULT_ADDRESS_1, + "{:id}": DEFAULT_HASH + } +}); + +Request("Get Payment History", { + method: GET, + path: "/v1/accounts/{:address}/payments?{:query_params}", + description: "Browse through the history of payments sent and received by an account.", + link: "#get-payment-history", + params: { + "{:address}": DEFAULT_ADDRESS_1, + "{:query_params}": "direction=incoming&exclude_failed=true" + } +}); + +Request("ORDERS"); + +Request("Place Order", { + method: POST, + path: "/v1/accounts/{:address}/orders?{:query_params}", + description: "Place an order on the ripple network.", + link: "#place-order", + test_only: true, + params: { + "{:address}": DEFAULT_ADDRESS_1, + "{:query_params}": "validated=true" + }, + body: { + "secret": DEFAULT_SECRET, + "order": { + "type": "sell", + "taker_pays": { + "currency": "JPY", + "value": "4000", + "counterparty": "rMAz5ZnK73nyNUL4foAvaxdreczCkG3vA6" + }, + "taker_gets": { + "currency": "USD", + "value": ".25", + "counterparty": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B" + }, + "immediate_or_cancel": true + } + } +}); + +Request("Cancel Order", { + method: DELETE, + path: "/v1/accounts/{:address}/orders/{:order}/?{:query_params}", + description: "Cancel an order on the ripple network.", + link: "#cancel-order", + test_only: true, + params: { + "{:address}": DEFAULT_ADDRESS_1, + "{:query_params}": "validated=true", + "{:order}": "23" + }, + body: { + "secret": DEFAULT_SECRET + } +}); + +Request("Get Account Orders", { + method: GET, + path: "/v1/accounts/{:address}/orders?{:query_params}", + description: "Get open currency-exchange orders associated with the Ripple address.", + link: "#get-account-orders", + params: { + "{:address}": DEFAULT_ADDRESS_3, + "{:query_params}": "ledger=10399192&limit=15" + } +}); + +Request("Get Order Transaction", { + method: GET, + path: "/v1/accounts/{:address}/orders/{:hash}", + description: "Get the details of an order transaction.", + link: "#get-order-transaction", + params: { + "{:address}": "rEQWVz1qN4DWw5J17s3DgXQzUuVYDSpK6M", + "{:hash}": "D53A3B99AC0C3CAF35D72178390ACA94CD42479A98CEA438EEAFF338E5FEB76D" + } +}); + +Request("Get Order Book", { + method: GET, + path: "/v1/accounts/{:address}/order_book/{:base}/{:counter}?{:query_params}", + description: "Get the order book for a currency pair", + link: "#get-order-book", + params: { + "{:address}": DEFAULT_ADDRESS_3, + "{:base}": "BTC+rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B", + "{:counter}": "USD+rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B", + "{:query_params}": "limit=10" + } +}); + +Request("TRUST LINES"); + +Request("Get Trustlines", { + method: GET, + path: "/v1/accounts/{:address}/trustlines?{:query_params}", + description: "Check the status of one or more trustlines attached to an account.", + link: "#get-trustlines", + params: { + "{:address}": DEFAULT_ADDRESS_1, + "{:query_params}": "currency=USD&counterparty=ra5nK24KXen9AHvsdFTKHSANinZseWnPcX" + } +}); + +Request("Grant Trustline", { + method: POST, + path: "/v1/accounts/{:address}/trustlines?{:query_params}", + description: "Add or modify a trustline from this account.", + link: "#grant-trustline", + test_only: true, + params: { + "{:address}": DEFAULT_ADDRESS_1, + "{:query_params}": "validated=true" + }, + body: { + "secret": DEFAULT_SECRET, + "trustline": { + "limit": "110", + "currency": "USD", + "counterparty": "rMwjYedjc7qqtKYVLiAccJSmCwih4LnE2q", + "allows_rippling": false + } + } +}); + +Request("NOTIFICATIONS"); + +Request("Check Notifications", { + method: GET, + path: "/v1/accounts/{:address}/notifications/{:id}", + description: "Monitor an account for all kinds of transactions.", + link: "#check-notifications", + params: { + "{:address}": DEFAULT_ADDRESS_1, + "{:id}": DEFAULT_HASH + } +}); + +Request("RIPPLED SERVER STATUS"); + +Request("Check Connection", { + method: GET, + path: "/v1/server/connected", + description: "Check whether the REST server is connected to a rippled server.", + link: "#check-connection" +}); + +Request("Get Server Status", { + method: GET, + path: "/v1/server", + description: "Retrieve information about the current status of the Ripple-REST server and the rippled server it is connected to.", + link: "#get-server-status" +}); + +Request("UTILITIES"); + +Request("Retrieve Ripple Transaction", { + method: GET, + path: "/v1/transactions/{:id}", + description: "Retrieve a raw Ripple transaction", + link: "#retrieve-ripple-transaction", + params: { + "{:id}": DEFAULT_HASH + } +}); + +Request("Retrieve Transaction Fee", { + method: GET, + path: "/v1/transaction-fee", + description: "Retrieve the current transaction fee for the connected rippled server(s).", + link: "#retrieve-transaction-fee", +}); + +Request("Generate UUID", { + method: GET, + path: "/v1/uuid", + description: "Create a universally-unique identifier (UUID) to use as the client resource ID for a payment.", + link: "#create-client-resource-id" +}); + +//---------- End req. List ---------------------------// diff --git a/js/apitool-rest.js b/js/apitool-rest.js index d0d50890b9..708de054f0 100644 --- a/js/apitool-rest.js +++ b/js/apitool-rest.js @@ -1,4 +1,4 @@ -var commands = $("#command_list li"); +var commandlist = $("#command_list"); var request_body = $("#request_body"); var request_button = $("#request_button"); var response_body = $("#response_body"); @@ -39,318 +39,44 @@ function slugify(str) { //Build requests var requests = { }; +var requestlist = []; function Request(name, obj) { + if (obj === undefined) { + requestlist.push({slug: null,name: name});//separator + return null; + } + obj.name = name; - requests[slugify(name)] = obj; + obj.slug = slugify(name); + requests[obj.slug] = obj; + requestlist.push(obj); return obj; }; -$(commands).click(function() { - var cmd = slugify($(this).text().trim()); - - if (!requests[cmd]) return; - - select_request(cmd, true); - window.location.hash = cmd; - - $(this).siblings().removeClass('selected'); - $(this).addClass('selected'); -}); - - -//---------- List of requests ------------------------// - -var DEFAULT_ADDRESS_1 = "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn"; -var DEFAULT_ADDRESS_2 = "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX"; -var DEFAULT_ADDRESS_3 = "rJnZ4YHCUsHvQu7R6mZohevKJDHFzVD6Zr"; -var DEFAULT_HASH = "9D591B18EDDD34F0B6CF4223A2940AEA2C3CC778925BABF289E0011CD8FA056E"; -var DEFAULT_SECRET = "sn3nxiW7v8KXzPzAqzyHXbSSKNuN9"; - -Request('Generate Wallet', { - method: GET, - path: "/v1/wallet/new", - description: 'Randomly generate keys for a potential new Ripple account.', - link: '#generate-wallet' -}); - -Request('Get Account Balances', { - method: GET, - path: '/v1/accounts/{:address}/balances?{:query_params}', - description: 'Retrieve the current balances for the given Ripple account.', - link: '#get-account-balances', - params: { - "{:address}": DEFAULT_ADDRESS_1, - "{:query_params}": "currency=USD" - } -}); - -Request('Get Account Settings', { - method: GET, - path: '/v1/accounts/{:address}/settings', - description: 'Retrieve the current settings for the given Ripple account.', - link: '#get-account-settings', - params: { - "{:address}": DEFAULT_ADDRESS_1 - } -}); - -Request('Update Account Settings', { - method: POST, - path: '/v1/accounts/{:address}/settings?{:query_params}', - description: 'Change the current settings for the given Ripple account.', - link: '#update-account-settings', - test_only: true, - params: { - "{:address}": DEFAULT_ADDRESS_1, - "{:query_params}": "validated=true" - }, - body: { - secret: DEFAULT_SECRET, - settings: { - require_destination_tag: false, - require_authorization: false, - disallow_xrp: false, - disable_master: false, - email_hash: "98b4375e1d753e5b91627516f6d70977" +function generate_table_of_contents() { + $.each(requestlist, function(i, req) { + if (req.slug === null) { + commandlist.append("
  • "+req.name+"
    • "); + } else { + commandlist.append("
  • "+req.name+"
    • "); } - } -}); + }); +} -Request('Prepare Payment', { - method: GET, - path: '/v1/accounts/{:source_address}/payments/paths/{:destination_address}/{:amount}?{:query_params}', - description: 'Retrieve possible payment objects for a desired payment.', - link: '#prepare-payment', - params: { - "{:source_address}": DEFAULT_ADDRESS_1, - "{:destination_address}": DEFAULT_ADDRESS_2, - "{:amount}": "1+USD+rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn", - "{:query_params}": "source_currencies=USD" - } -}); +function make_commands_clickable() { + commandlist.children("li").click(function() { + var cmd = slugify($(this).text().trim()); -Request('Submit Payment', { - method: POST, - path: '/v1/accounts/{:source_address}/payments?{:query_params}', - description: 'Send a prepared payment to the network.', - link: '#submit-payment', - test_only: true, - body: { - "secret": DEFAULT_SECRET, - "client_resource_id": "348170b9-16b9-4927-854d-7f9d4a2a692d", - "payment": { - "source_account": DEFAULT_ADDRESS_1, - "source_tag": "", - "source_amount": { - "value": "1", - "currency": "USD", - "issuer": "" - }, - "source_slippage": "0", - "destination_account": DEFAULT_ADDRESS_2, - "destination_tag": "", - "destination_amount": { - "value": "1", - "currency": "USD", - "issuer": DEFAULT_ADDRESS_1 - }, - "invoice_id": "", - "paths": "[]", - "partial_payment": false, - "no_direct_ripple": false - } - }, - params: { - "{:source_address}": DEFAULT_ADDRESS_1, - "{:query_params}": "validated=true" - } -}); + if (!requests[cmd]) return; -Request("Confirm Payment", { - method: GET, - path: "/v1/accounts/{:address}/payments/{:id}", - description: "Retrieve details of a payment and its status.", - link: "#confirm-payment", - params: { - "{:address}": DEFAULT_ADDRESS_1, - "{:id}": DEFAULT_HASH - } -}); + select_request(cmd, true); + window.location.hash = cmd; -Request("Get Payment History", { - method: GET, - path: "/v1/accounts/{:address}/payments?{:query_params}", - description: "Browse through the history of payments sent and received by an account.", - link: "#get-payment-history", - params: { - "{:address}": DEFAULT_ADDRESS_1, - "{:query_params}": "direction=incoming&exclude_failed=true" - } -}); - -Request("Place Order", { - method: POST, - path: "/v1/accounts/{:address}/orders?{:query_params}", - description: "Place an order on the ripple network.", - link: "#place-order", - test_only: true, - params: { - "{:address}": DEFAULT_ADDRESS_1, - "{:query_params}": "validated=true" - }, - body: { - "secret": DEFAULT_SECRET, - "order": { - "type": "sell", - "taker_pays": { - "currency": "JPY", - "value": "4000", - "counterparty": "rMAz5ZnK73nyNUL4foAvaxdreczCkG3vA6" - }, - "taker_gets": { - "currency": "USD", - "value": ".25", - "counterparty": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B" - }, - "immediate_or_cancel": true - } - } -}); - -Request("Cancel Order", { - method: DELETE, - path: "/v1/accounts/{:address}/orders/{:order}/?{:query_params}", - description: "Cancel an order on the ripple network.", - link: "#cancel-order", - test_only: true, - params: { - "{:address}": DEFAULT_ADDRESS_1, - "{:query_params}": "validated=true", - "{:order}": "23" - }, - body: { - "secret": DEFAULT_SECRET - } -}); - -Request("Get Account Orders", { - method: GET, - path: "/v1/accounts/{:address}/orders?{:query_params}", - description: "Get open currency-exchange orders associated with the Ripple address.", - link: "#get-account-orders", - params: { - "{:address}": DEFAULT_ADDRESS_3, - "{:query_params}": "ledger=10399192&limit=15" - } -}); - -Request("Get Order Transaction", { - method: GET, - path: "/v1/accounts/{:address}/orders/{:hash}", - description: "Get the details of an order transaction.", - link: "#get-order-transaction", - params: { - "{:address}": "rEQWVz1qN4DWw5J17s3DgXQzUuVYDSpK6M", - "{:hash}": "D53A3B99AC0C3CAF35D72178390ACA94CD42479A98CEA438EEAFF338E5FEB76D" - } -}); - -Request("Get Order Book", { - method: GET, - path: "/v1/accounts/{:address}/order_book/{:base}/{:counter}?{:query_params}", - description: "Get the order book for a currency pair", - link: "#get-order-book", - params: { - "{:address}": DEFAULT_ADDRESS_3, - "{:base}": "BTC+rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B", - "{:counter}": "USD+rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B", - "{:query_params}": "limit=10" - } -}); - -Request("Get Trustlines", { - method: GET, - path: "/v1/accounts/{:address}/trustlines?{:query_params}", - description: "Check the status of one or more trustlines attached to an account.", - link: "#get-trustlines", - params: { - "{:address}": DEFAULT_ADDRESS_1, - "{:query_params}": "currency=USD&counterparty=ra5nK24KXen9AHvsdFTKHSANinZseWnPcX" - } -}); - -Request("Grant Trustline", { - method: POST, - path: "/v1/accounts/{:address}/trustlines?{:query_params}", - description: "Add or modify a trustline from this account.", - link: "#grant-trustline", - test_only: true, - params: { - "{:address}": DEFAULT_ADDRESS_1, - "{:query_params}": "validated=true" - }, - body: { - "secret": DEFAULT_SECRET, - "trustline": { - "limit": "110", - "currency": "USD", - "counterparty": "rMwjYedjc7qqtKYVLiAccJSmCwih4LnE2q", - "allows_rippling": false - } - } -}); - -Request("Check Notifications", { - method: GET, - path: "/v1/accounts/{:address}/notifications/{:id}", - description: "Monitor an account for all kinds of transactions.", - link: "#check-notifications", - params: { - "{:address}": DEFAULT_ADDRESS_1, - "{:id}": DEFAULT_HASH - } -}); - -Request("Check Connection", { - method: GET, - path: "/v1/server/connected", - description: "Check whether the REST server is connected to a rippled server.", - link: "#check-connection" -}); - -Request("Get Server Status", { - method: GET, - path: "/v1/server", - description: "Retrieve information about the current status of the Ripple-REST server and the rippled server it is connected to.", - link: "#get-server-status" -}); - -Request("Retrieve Ripple Transaction", { - method: GET, - path: "/v1/transactions/{:id}", - description: "Retrieve a raw Ripple transaction", - link: "#retrieve-ripple-transaction", - params: { - "{:id}": DEFAULT_HASH - } -}); - -Request("Retrieve Transaction Fee", { - method: GET, - path: "/v1/transaction-fee", - description: "Retrieve the current transaction fee for the connected rippled server(s).", - link: "#retrieve-transaction-fee", -}); - -Request("Generate UUID", { - method: GET, - path: "/v1/uuid", - description: "Create a universally-unique identifier (UUID) to use as the client resource ID for a payment.", - link: "#create-client-resource-id" -}); - -//---------- End req. List ---------------------------// + $(this).siblings().removeClass('selected'); + $(this).addClass('selected'); + }); +} var cm_request = CodeMirror(request_body.get(0), { mode: 'javascript', @@ -410,6 +136,19 @@ function change_path(command) { } function select_request(request) { + if (request === undefined) { + var el = commandlist.children("li:not(.separator)").eq(0); + request = slugify(el.text()); + +/* var keys = Object.keys(requests); + var index = keys.indexOf(cmd); + if (index === -1) return;*/ + } else { + var el = commandlist.find("li a[href='#"+request+"']").parent(); + } + $(el).siblings().removeClass('selected'); + $(el).addClass('selected'); + command = requests[request]; if (command.test_only === true) { @@ -422,12 +161,14 @@ function select_request(request) { $(description).html(command.description); if (command.link) { - $(description).append(" Read more"); + $(description).append(" Read more"); } $(description).show(); } else if (command.link) { - $(description).html("Read more"); + $(description).html("Read more"); } else { $(description).hide(); } @@ -436,13 +177,8 @@ function select_request(request) { .attr('href', DOC_BASE+command.link) .text(command.name)); - //rest_url.val(command.path); - //rest_url.text(command.path); change_path(command); - -// rest_method.val(command.method); -// rest_method.change(); request_button.val(command.method); request_button.text(command.method+" request"); update_method(request_button); @@ -451,7 +187,6 @@ function select_request(request) { cm_request.setValue(JSON.stringify(command.body, null, 2)); } else { //No body, so wipe out the current contents. - //This prevents confusion if the user toggles the HTTP method dropdown cm_request.setValue(""); } @@ -531,6 +266,10 @@ function reset_response_area() { } $(document).ready(function() { + //wait for the Requests to be populated by another file + generate_table_of_contents(); + make_commands_clickable(); + request_button.click(send_request); //rest_method.change(update_method); @@ -547,18 +286,8 @@ $(document).ready(function() { if (window.location.hash) { var cmd = window.location.hash.slice(1).toLowerCase(); - var keys = Object.keys(requests); - var index = keys.indexOf(cmd); - - if (index === -1) return; - - var el = commands.eq(index); - select_request(cmd); - - $(el).siblings().removeClass('selected'); - $(el).addClass('selected'); } else { - select_request('generate-wallet'); + select_request(); } }); diff --git a/rest-api-tool.html b/rest-api-tool.html index ba6e0e57d8..885bee2056 100644 --- a/rest-api-tool.html +++ b/rest-api-tool.html @@ -86,33 +86,6 @@
      -
    • Generate Wallet
      • -
    • Get Account Balances
      • -
    • Get Account Settings
      • -
    • Update Account Settings
      • -
      -
    • Prepare Payment
      • -
    • Submit Payment
      • -
    • Confirm Payment
      • -
    • Get Payment History
      • -
      -
    • Place Order
      • -
    • Cancel Order
      • -
    • Get Account Orders
      • -
    • Get Order Transaction
      • -
    • Get Order Book
      • -
      -
    • Get Trustlines
      • -
    • Grant Trustline
      • -
      -
    • Check Notifications
      • -
      -
    • Check Connection
      • -
    • Get Server Status
      • -
      -
    • Retrieve Ripple Transaction
      • -
    • Retrieve Transaction Fee
      • -
    • Generate UUID
    @@ -208,6 +181,8 @@ + + diff --git a/ripple-api-tool.html b/ripple-api-tool.html index df70e94c1b..233a1bc99f 100644 --- a/ripple-api-tool.html +++ b/ripple-api-tool.html @@ -86,33 +86,33 @@
    From db8d35f9de469ae9b6ae1212e58f7ad2e440bae7 Mon Sep 17 00:00:00 2001 From: mDuo13 Date: Mon, 16 Mar 2015 17:23:13 -0700 Subject: [PATCH 08/27] [FEATURE] Historical Database API tool --- gateway_guide.html | 5 +- gateway_services.html | 5 +- gatewayd.html | 5 +- historical_data.html | 5 +- historicaldb-api-tool.html | 188 +++++++++++++++++++++++++++++ index.html | 5 +- js/apitool-methods-historical.js | 56 +++++++++ js/apitool-methods-ripplerest.js | 2 + js/apitool-rest.js | 3 - reliable_tx.html | 5 +- rest-api-tool.html | 6 +- ripple-api-tool.html | 5 +- ripple-rest.html | 5 +- rippled-apis.html | 5 +- tool/pages.json | 10 ++ tool/template-base.html | 7 +- tool/template-rest-api-tool.html | 27 +---- tool/template-ripple-api-tool.html | 42 +++---- transactions.html | 5 +- whitepapers.html | 5 +- 20 files changed, 319 insertions(+), 77 deletions(-) create mode 100644 historicaldb-api-tool.html create mode 100644 js/apitool-methods-historical.js diff --git a/gateway_guide.html b/gateway_guide.html index f4df5dffd8..a8a4f13b05 100644 --- a/gateway_guide.html +++ b/gateway_guide.html @@ -88,8 +88,9 @@
  • API Tools
  • diff --git a/gateway_services.html b/gateway_services.html index 971382bfec..47d7c9bc98 100644 --- a/gateway_services.html +++ b/gateway_services.html @@ -88,8 +88,9 @@
  • API Tools
  • diff --git a/gatewayd.html b/gatewayd.html index 2884593725..7cf814f3ea 100644 --- a/gatewayd.html +++ b/gatewayd.html @@ -88,8 +88,9 @@
  • API Tools
  • diff --git a/historical_data.html b/historical_data.html index b5a01e97ac..bd8f8b5930 100644 --- a/historical_data.html +++ b/historical_data.html @@ -88,8 +88,9 @@
  • API Tools
  • diff --git a/historicaldb-api-tool.html b/historicaldb-api-tool.html new file mode 100644 index 0000000000..09832ebe58 --- /dev/null +++ b/historicaldb-api-tool.html @@ -0,0 +1,188 @@ + + + + + + + + Historical Database API Tool - Ripple Developer Portal + + + + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    +
    +
    +
      +
    +
    +
    +
    +

    REST Request

    + +
    +

    +

    +
    Invalid JSON
    +
    +

    https://api.ripple.com

    +
    +
    +
    +
    Send request
    +
    +
    +
    +

    Response

    +
    + + +
    +
    +
    +
    +
    +
    +
    +
    +
    +
    + + + + + + + + + + + + + diff --git a/index.html b/index.html index 120608da0b..2a1c763090 100644 --- a/index.html +++ b/index.html @@ -74,8 +74,9 @@
  • API Tools
  • diff --git a/js/apitool-methods-historical.js b/js/apitool-methods-historical.js new file mode 100644 index 0000000000..d4158bb970 --- /dev/null +++ b/js/apitool-methods-historical.js @@ -0,0 +1,56 @@ +//---------- List of requests ------------------------// +// Must be loaded after apitool-rest.js // +var DOC_BASE = "historical_data.html"; +var URL_BASE = "https://history.ripple.com:443"; + +var DEFAULT_ADDRESS_1 = "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn"; +var DEFAULT_HASH = "9D591B18EDDD34F0B6CF4223A2940AEA2C3CC778925BABF289E0011CD8FA056E"; +var DEFAULT_LEDGER = "3170DA37CE2B7F045F889594CBC323D88686D2E90E8FFD2BBCD9BAD12E416DB5"; + + +Request('Get Account Transaction History', { + method: GET, + path: "/v1/accounts/{:address}/transactions?{:query_params}", + description: "Retrieve transactions that affected the given account.", + link: "#get-account-transaction-history", + params: { + "{:address}": DEFAULT_ADDRESS_1, + "{:query_params}": "type=Payment&result=tesSUCCESS" + } +}); + +Request('Get Transaction By Account and Sequence', { + method: GET, + path: "/v1/accounts/{:address}/transactions/{:sequence}?{:query_params}", + description: "Retrieve a specific transaction, by the account that sent it and the sequence number it used.", + link: "#get-transaction-by-account-and-sequence", + params: { + "{:address}": DEFAULT_ADDRESS_1, + "{:sequence}": 1, + "{:query_params}": "binary=false" + } +}); + +Request('Get Transaction', { + method: GET, + path: "/v1/transactions/{:hash}?{:query_params}", + description: "Retrieve a transactions by its identifying hash.", + link: "#get-transaction", + params: { + "{:hash}": DEFAULT_HASH, + "{:query_params}": "binary=false" + } +}); + +Request('Get Ledger', { + method: GET, + path: "/v1/ledgers/{:ledger_identifier}?{:query_params}", + description: "Retrieve a ledger by its sequence number or identifying hash.", + link: "#get-ledger", + params: { + "{:ledger_identifier}": DEFAULT_LEDGER, + "{:query_params}": "transactions=true&binary=false&expand=true" + } +}); + +//---------- End req. List ---------------------------// diff --git a/js/apitool-methods-ripplerest.js b/js/apitool-methods-ripplerest.js index 855b7f92d0..e8b4322e4a 100644 --- a/js/apitool-methods-ripplerest.js +++ b/js/apitool-methods-ripplerest.js @@ -1,5 +1,7 @@ //---------- List of requests ------------------------// // Must be loaded after apitool-rest.js // +var URL_BASE = "https://api.ripple.com:443"; +var DOC_BASE = "ripple-rest.html"; var DEFAULT_ADDRESS_1 = "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn"; var DEFAULT_ADDRESS_2 = "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX"; diff --git a/js/apitool-rest.js b/js/apitool-rest.js index 708de054f0..36598b1983 100644 --- a/js/apitool-rest.js +++ b/js/apitool-rest.js @@ -14,9 +14,6 @@ var GET = "GET"; var POST = "POST"; var PUT = "PUT"; var DELETE = "DELETE"; -var URL_BASE = "https://api.ripple.com:443"; - -var DOC_BASE = "ripple-rest.html"; function slugify(str) { diff --git a/reliable_tx.html b/reliable_tx.html index 7fdd660530..992a39ff77 100644 --- a/reliable_tx.html +++ b/reliable_tx.html @@ -88,8 +88,9 @@
  • API Tools
  • diff --git a/rest-api-tool.html b/rest-api-tool.html index 885bee2056..46bc4405a6 100644 --- a/rest-api-tool.html +++ b/rest-api-tool.html @@ -61,8 +61,9 @@
  • API Tools
  • @@ -181,7 +182,6 @@ - diff --git a/ripple-api-tool.html b/ripple-api-tool.html index 233a1bc99f..229a46abb2 100644 --- a/ripple-api-tool.html +++ b/ripple-api-tool.html @@ -61,8 +61,9 @@
  • API Tools
  • diff --git a/ripple-rest.html b/ripple-rest.html index 8bd6b4e01c..3d03d808ad 100644 --- a/ripple-rest.html +++ b/ripple-rest.html @@ -88,8 +88,9 @@
  • API Tools
  • diff --git a/rippled-apis.html b/rippled-apis.html index 4c4b8528b0..f4e57a936b 100644 --- a/rippled-apis.html +++ b/rippled-apis.html @@ -88,8 +88,9 @@
  • API Tools
  • diff --git a/tool/pages.json b/tool/pages.json index edd1b4a6ca..0fa932ec03 100644 --- a/tool/pages.json +++ b/tool/pages.json @@ -52,11 +52,21 @@ { "name": "Ripple-REST API Tool", "template":"template-rest-api-tool.html", + "methods_js": "js/apitool-methods-ripplerest.js", + "is_apitool": true, "html": "rest-api-tool.html" }, + { + "name": "Historical Database API Tool", + "template":"template-rest-api-tool.html", + "methods_js": "js/apitool-methods-historical.js", + "is_apitool": true, + "html": "historicaldb-api-tool.html" + }, { "name": "WebSocket API Tool", "template":"template-ripple-api-tool.html", + "is_apitool": true, "html": "ripple-api-tool.html" } ] diff --git a/tool/template-base.html b/tool/template-base.html index b9db7e83c4..1fdc3a00bf 100644 --- a/tool/template-base.html +++ b/tool/template-base.html @@ -59,8 +59,11 @@
  • API Tools
  • diff --git a/tool/template-rest-api-tool.html b/tool/template-rest-api-tool.html index 8df2011bfe..34c52added 100644 --- a/tool/template-rest-api-tool.html +++ b/tool/template-rest-api-tool.html @@ -5,32 +5,6 @@
      -
    • Generate Wallet
      • -
    • Get Account Balances
      • -
    • Get Account Settings
      • -
    • Update Account Settings
      • -
      -
    • Prepare Payment
      • -
    • Submit Payment
      • -
    • Confirm Payment
      • -
    • Get Payment History
      • -
      -
    • Place Order
      • -
    • Cancel Order
      • -
    • Get Account Orders
      • -
    • Get Order Book
      • -
      -
    • Get Trustlines
      • -
    • Grant Trustline
      • -
      -
    • Check Notifications
      • -
      -
    • Check Connection
      • -
    • Get Server Status
      • -
      -
    • Retrieve Ripple Transaction
      • -
    • Retrieve Transaction Fee
      • -
    • Generate UUID
    @@ -76,6 +50,7 @@ + {% endblock %} diff --git a/tool/template-ripple-api-tool.html b/tool/template-ripple-api-tool.html index 00b66cef9f..c8d4641a96 100644 --- a/tool/template-ripple-api-tool.html +++ b/tool/template-ripple-api-tool.html @@ -5,33 +5,33 @@
    diff --git a/transactions.html b/transactions.html index 7862aecfe3..41baacc3bf 100644 --- a/transactions.html +++ b/transactions.html @@ -88,8 +88,9 @@
  • API Tools
  • diff --git a/whitepapers.html b/whitepapers.html index db1dae091f..824cad585b 100644 --- a/whitepapers.html +++ b/whitepapers.html @@ -88,8 +88,9 @@
  • API Tools
  • From 56e9340a1d340cb5be503eb0ec208ed4b37dd6c0 Mon Sep 17 00:00:00 2001 From: mDuo13 Date: Mon, 16 Mar 2015 18:32:40 -0700 Subject: [PATCH 09/27] [DOC] gateway guide - added DefaultRipple section --- content/gateway_guide.md | 62 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 62 insertions(+) diff --git a/content/gateway_guide.md b/content/gateway_guide.md index 65e693827d..cbc4c9b204 100644 --- a/content/gateway_guide.md +++ b/content/gateway_guide.md @@ -156,6 +156,7 @@ There are several prerequisites that ACME must meet in order for this to happen: - ACME modifies its core accounting system to track money that is backing funds issued on the Ripple Network. ACME can query Ripple to see who holds its Ripple issuances at any time. - Optionally, a gateway can take additional steps to separate the assets backing the gateway's Ripple issuances. For example, the funds allocated to Ripple can be stored in a separate "Ripple Escrow" bank account. A cryptocurrency exchange can create a separate wallet to hold the funds allocated to Ripple, as publicly-verifiable proof to customers that the gateway is solvent. - ACME must have an account on the Ripple network. Our best practices recommend actually having at least two accounts: a "cold wallet" account to issue currency, and one or more "hot wallet" accounts that perform day-to-day transactions. See [Hot and Cold Wallets](#hot-and-cold-wallets) for more information. + - ACME must enable the [DefaultRipple Flag](#defaultripple) on its issuing account in order for users to send and receive its issuances. - Alice must create a trustline from her Ripple account to ACME's issuing (cold wallet) account. She can do this from any Ripple client (such as [Ripple Trade](https://www.rippletrade.com/) as long as she knows the address or Ripple Name of ACME's cold wallet. - In order to do this, Alice needs to find the address of ACME's cold wallet. ACME can publicize its cold wallet address on its website, or have its gateway listed in a client such as Ripple Trade. See [Setting Trust Lines in Ripple Trade](#setting-trust-lines-in-ripple-trade). - ACME must create a user interface for Alice to send funds from ACME into Ripple. @@ -291,6 +292,67 @@ Any time you submit a Ripple transaction, it must be signed using your secret. H The examples in this document show Ripple-REST API methods that include an account secret. This is only safe if you control the Ripple-REST server yourself, *and* you connect to it over a connection that is secure from outside listeners. (For example, you could connect over a loopback (localhost) network, a private subnet, or an encrypted VPN.) Alternatively, you could operate your own `rippled` server; or you can use a client application such as `ripple-lib` to perform local signing before submitting your transactions to a third-party server. +## DefaultRipple ## + +The DefaultRipple flag controls whether the balances held in an account's trust lines are [allowed to ripple](https://ripple.com/knowledge_center/understanding-the-noripple-flag/) by default. Rippling is what allows users to trade issuances, so a gateway must make sure rippling is allowed on all the trust lines connected to its issuing (cold wallet) account. + +Before asking users to trust its issuing account, a gateway should enable the DefaultRipple flag on that account. Otherwise, the gateway must individually disable the NoRipple flag for each trust line that other accounts extend to it. + +*Note:* Ripple-REST (as of version 1.4.0) does not yet support retrieving or setting the DefaultRipple flag. + +The following is an example of using a local [`rippled` JSON-RPC API](ripple-rest.html#update-account-settings) to enable the DefaultRipple flag: + +Request: + +``` +POST http://localhost:8088/ +{ + "method": "submit", + "params": [ + { + "secret": "sn3nxiW7v8KXzPzAqzyHXbSSKNuN9", + "tx_json": { + "Account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn", + "Fee": "15000", + "Flags": 0, + "SetFlag": 8, + "TransactionType": "AccountSet" + } + } + ] +} +``` + +Response: + +``` +{ + "result": { + "engine_result": "tesSUCCESS", + "engine_result_code": 0, + "engine_result_message": "The transaction was applied. Only final in a validated ledger.", + "status": "success", + "tx_blob": "1200032200000000240000003E202100000008684000000000003A98732103AB40A0490F9B7ED8DF29D246BF2D6269820A0EE7742ACDD457BEA7C7D0931EDB74473045022100D8F2DEF27DE313E3F0D1E189BF5AC8879F591045950E2A33787C3051169038C80220728A548F188F882EA40A416CCAF2AC52F3ED679563BBE1BAC014BB9E773A333581144B4E9C06F24296074F7BC48F92A97916C6DC5EA9", + "tx_json": { + "Account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn", + "Fee": "15000", + "Flags": 0, + "Sequence": 62, + "SetFlag": 8, + "SigningPubKey": "03AB40A0490F9B7ED8DF29D246BF2D6269820A0EE7742ACDD457BEA7C7D0931EDB", + "TransactionType": "AccountSet", + "TxnSignature": "3045022100D8F2DEF27DE313E3F0D1E189BF5AC8879F591045950E2A33787C3051169038C80220728A548F188F882EA40A416CCAF2AC52F3ED679563BBE1BAC014BB9E773A3335", + "hash": "665B27B64CE658704FFD326A4FE2F5F5B5E67EACA61DE08258A59D35B883E1D5" + } + } +} +``` + +To confirm that an account has DefaultRipple enabled, look up the account using the [account_info command](rippled-apis.html#account-info), specifying a validated ledger version. Use [the xor operator](https://en.wikipedia.org/wiki/Exclusive_or) to compare the `Flags` field with 0x00800000 (the [ledger flag lsfDefaultRipple](https://wiki.ripple.com/Ledger_Format#AccountRoot)). If the result of the xor operation is nonzero, then the account has DefaultRipple enabled. + +_(**Reminder:** Don't send your secret to a server you do not control.)_ + + ## Generating Souce and Destination Tags ## You need a scheme to create Source and Destination tags for your users and payments. (See [Source and Destination Tags](#source-and-destination-tags) for an explanation of what Source and Destination Tags are.) From bd5303008769582150ead85bcafe6ab74dd2586e Mon Sep 17 00:00:00 2001 From: mDuo13 Date: Mon, 16 Mar 2015 19:41:11 -0700 Subject: [PATCH 10/27] [DOC] gateway guide - updated fund flow graphic --- content/gateway_guide.md | 10 +++++----- img/e2g-funds_flow.png | Bin 0 -> 43717 bytes img/e2g-payment_flow.gif | Bin 92093 -> 0 bytes 3 files changed, 5 insertions(+), 5 deletions(-) create mode 100644 img/e2g-funds_flow.png delete mode 100644 img/e2g-payment_flow.gif diff --git a/content/gateway_guide.md b/content/gateway_guide.md index cbc4c9b204..7f589df941 100644 --- a/content/gateway_guide.md +++ b/content/gateway_guide.md @@ -89,12 +89,12 @@ As with hot wallets, warm wallets must trust the cold wallet, and should not be Funds in Ripple tend to flow in a cycle, from the cold wallet to the warm wallets, then the warm wallets, to customers, and eventually from customers back to the cold wallet. When you put that together with the transactions outside of Ripple, the lifecycle looks something like this: -![Payments flow diagram](img/e2g-payment_flow.gif) +![Funds flow diagram](img/e2g-funds_flow.png) -1. Charlie [sends €2 from ACME to Ripple](#sending-from-gateway-to-ripple). This involves two transactions. Outside of Ripple, ACME moves €2 from Charlie's ACME balance to ACME's Ripple-backing balance. Within Ripple, ACME's hot wallet sends €2 to Charlie's Ripple wallet. -2. ACME refills its hot wallet using €2 from its warm wallet. -3. ACME refills its warm wallet by issuing a new €2 from its cold wallet. -4. Charlie [sends €2 from Ripple to ACME](#sending-from-ripple-to-gateway). This is basically the reverse of the initial step, with two transactions. Within Ripple, Charlie redeems issuances with ACME's cold wallet. Outside of Ripple, ACME debits €2 from its Ripple-backing balance and credits it to Charlie's balance. +1. Alice [initiates a payment from ACME to Ripple](#sending-from-gateway-to-ripple). Outside of Ripple, ACME debits Alice's account. Then ACME sends a Ripple payment of EUR.ACME from ACME's hot wallet account to Alice's Ripple account. +2. ACME refills its hot wallet using EUR.ACME from its warm wallet. +3. ACME refills its warm wallet by issuing new EUR.ACME from its cold wallet. +4. Alice [initiates a payment from Ripple to ACME](#sending-from-ripple-to-gateway). This is basically the reverse of the initial step. Alice redeems issuances of EUR.ACME by sending them to ACME's cold wallet. Outside of Ripple, ACME credits Alice for the amount it received. ## Fees and Revenue Sources ## diff --git a/img/e2g-funds_flow.png b/img/e2g-funds_flow.png new file mode 100644 index 0000000000000000000000000000000000000000..599fb9786b28b737bf532f31a21962ae381e7e0d GIT binary patch literal 43717 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 literal 0 HcmV?d00001 diff --git a/img/e2g-payment_flow.gif b/img/e2g-payment_flow.gif deleted file mode 100644 index c4878809336938c1eb4bb22ae000c49388bd08f3..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 92093 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

    eH&9lb};yvofvoGR+EG`IEUKdkCQ+ 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

    3YkzTZ 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 l?a|}N2-VbFjh{}(lq0($@e From 9917ce881f931d768af3b22c4b53010f13b02653 Mon Sep 17 00:00:00 2001 From: mDuo13 Date: Mon, 16 Mar 2015 19:42:35 -0700 Subject: [PATCH 11/27] [DOC] gateway guide - move warning to right place --- content/gateway_guide.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/gateway_guide.md b/content/gateway_guide.md index 7f589df941..cf12cc5af6 100644 --- a/content/gateway_guide.md +++ b/content/gateway_guide.md @@ -323,6 +323,8 @@ POST http://localhost:8088/ } ``` +_(**Reminder:** Don't send your secret to a server you do not control.)_ + Response: ``` @@ -350,8 +352,6 @@ Response: To confirm that an account has DefaultRipple enabled, look up the account using the [account_info command](rippled-apis.html#account-info), specifying a validated ledger version. Use [the xor operator](https://en.wikipedia.org/wiki/Exclusive_or) to compare the `Flags` field with 0x00800000 (the [ledger flag lsfDefaultRipple](https://wiki.ripple.com/Ledger_Format#AccountRoot)). If the result of the xor operation is nonzero, then the account has DefaultRipple enabled. -_(**Reminder:** Don't send your secret to a server you do not control.)_ - ## Generating Souce and Destination Tags ## From 80b4cbea5a1fb4d128334be9adc1a705c0edc842 Mon Sep 17 00:00:00 2001 From: mDuo13 Date: Tue, 17 Mar 2015 00:41:52 -0700 Subject: [PATCH 12/27] [DOC] gateway guide - wording improvements --- content/gateway_guide.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/gateway_guide.md b/content/gateway_guide.md index cf12cc5af6..feb5fdaed9 100644 --- a/content/gateway_guide.md +++ b/content/gateway_guide.md @@ -87,7 +87,7 @@ As with hot wallets, warm wallets must trust the cold wallet, and should not be ### Funds Lifecycle ### -Funds in Ripple tend to flow in a cycle, from the cold wallet to the warm wallets, then the warm wallets, to customers, and eventually from customers back to the cold wallet. When you put that together with the transactions outside of Ripple, the lifecycle looks something like this: +Funds in Ripple tend to flow in a cycle, from the cold wallet to the warm wallets, then the warm wallets, to customers, and eventually from customers back to the cold wallet. Issuances (any non-XRP balance in Ripple) are always tied to a trust line, so each payment "ripples" through ACME's issuing account on the trust lines connected to it. Ultimately, the lifecycle of issuances in Ripple looks something like this: ![Funds flow diagram](img/e2g-funds_flow.png) @@ -294,7 +294,7 @@ The examples in this document show Ripple-REST API methods that include an accou ## DefaultRipple ## -The DefaultRipple flag controls whether the balances held in an account's trust lines are [allowed to ripple](https://ripple.com/knowledge_center/understanding-the-noripple-flag/) by default. Rippling is what allows users to trade issuances, so a gateway must make sure rippling is allowed on all the trust lines connected to its issuing (cold wallet) account. +The DefaultRipple flag controls whether the balances held in an account's trust lines are [allowed to ripple](https://ripple.com/knowledge_center/understanding-the-noripple-flag/) by default. Rippling is what allows users to trade issuances, so a gateway must allow rippling on all the trust lines connected to its issuing (cold wallet) account. Before asking users to trust its issuing account, a gateway should enable the DefaultRipple flag on that account. Otherwise, the gateway must individually disable the NoRipple flag for each trust line that other accounts extend to it. From 32af4980d4bab9a082903b7da6b42da87606dcfb Mon Sep 17 00:00:00 2001 From: mDuo13 Date: Tue, 17 Mar 2015 13:18:08 -0700 Subject: [PATCH 13/27] [DOC] gateway guide typo fixes --- content/gateway_guide.md | 24 ++++++++++++------------ 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/content/gateway_guide.md b/content/gateway_guide.md index feb5fdaed9..d61adb8839 100644 --- a/content/gateway_guide.md +++ b/content/gateway_guide.md @@ -157,7 +157,7 @@ There are several prerequisites that ACME must meet in order for this to happen: - Optionally, a gateway can take additional steps to separate the assets backing the gateway's Ripple issuances. For example, the funds allocated to Ripple can be stored in a separate "Ripple Escrow" bank account. A cryptocurrency exchange can create a separate wallet to hold the funds allocated to Ripple, as publicly-verifiable proof to customers that the gateway is solvent. - ACME must have an account on the Ripple network. Our best practices recommend actually having at least two accounts: a "cold wallet" account to issue currency, and one or more "hot wallet" accounts that perform day-to-day transactions. See [Hot and Cold Wallets](#hot-and-cold-wallets) for more information. - ACME must enable the [DefaultRipple Flag](#defaultripple) on its issuing account in order for users to send and receive its issuances. -- Alice must create a trustline from her Ripple account to ACME's issuing (cold wallet) account. She can do this from any Ripple client (such as [Ripple Trade](https://www.rippletrade.com/) as long as she knows the address or Ripple Name of ACME's cold wallet. +- Alice must create a trustline from her Ripple account to ACME's issuing (cold wallet) account. She can do this from any Ripple client application as long as she knows the address or Ripple Name of ACME's cold wallet. - In order to do this, Alice needs to find the address of ACME's cold wallet. ACME can publicize its cold wallet address on its website, or have its gateway listed in a client such as Ripple Trade. See [Setting Trust Lines in Ripple Trade](#setting-trust-lines-in-ripple-trade). - ACME must create a user interface for Alice to send funds from ACME into Ripple. - In order to do this, ACME needs to know Alice's Ripple address. ACME can have Alice input her Ripple addresss as part of the interface, or ACME can require Alice to input and verify her Ripple address in advance. @@ -191,7 +191,7 @@ Processing payments to and from Ripple naturally comes with some risks, so a gat - Protect yourself against reversible deposits. Ripple payments are irreversible, but many electronic money systems like credit cards or PayPal are not. Scammers can abuse this to take their fiat money back by canceling a deposit after receiving Ripple issuances. - Before processing a payment out of Ripple, make sure you know the customer's identity. This makes it harder for anonymous attackers to scam you, and it is also an important element of most anti-money-laundering regulations. This is especially important because the users sending money from Ripple could be different than the ones that initially received the money in Ripple. - Follow the guidelines for [reliable transaction submission](#reliable-transaction-submission) when sending Ripple transactions. -- [Robustly monitor for incoming payments](#robustly-monitor-for-payments), and read the correct amount. Don't mistakenly credit someone the full amount if they only sent a [partial payment](transactions.html#partial-payments). +- [Robustly monitor for incoming payments](#robustly-monitoring-for-payments), and read the correct amount. Don't mistakenly credit someone the full amount if they only sent a [partial payment](transactions.html#partial-payments). - Track your obligations and balances within the Ripple network, and compare with your assets off the network. If they do not match up, stop processing withdrawals and deposits until you resolve the discrepancy. - Proactively avoid ambiguous situations. We recommend the following: - Enable the [`DisallowXRP` flag](#disallowxrp) for the cold wallet account and all hot wallet accounts, so users do not accidentally send you XRP. (Private exchanges should *not* set this flag, since they trade XRP normally.) @@ -240,7 +240,7 @@ For more information, see the [Gateway Bulletin on Freezes](https://ripple.com/f Ripple's Authorized Accounts feature enables a gateway to limit who can hold that gateway's issuances, so that unknown Ripple accounts cannot hold the currency your gateway issues. We feel this is *not necessary* in most cases, since gateways have full control over the process of redeeming Ripple balances for value in the outside world. (You can collect customer information and impose limits on withdrawals at that stage without worrying about what happens within the Ripple network.) -To use the Authorized Accounts feature, a gateway enables the `RequireAuth` flag for its cold wallet account, and then manually approves each user account's trust line before sending issuances in Ripple to that account. +To use the Authorized Accounts feature, a gateway enables the `RequireAuth` flag for its cold wallet account, and then individually approves each user account's trust line before sending issuances in Ripple to that account. You must authorize trust lines using the same cold wallet account that issues the currency, which unfortunately means an increased risk exposure for that account. The process for sending funds into Ripple with RequireAuth enabled looks like the following: @@ -457,7 +457,7 @@ The value `"require_destination_tag": true` indicates that the RequireDest flag The `RequireAuth` flag (`require_authorization` in Ripple-REST) prevents a Ripple account's issuances from being held by other users unless the issuer approves them. -We recommend enabling RequireAuth for all hot wallet (and warm wallet) accounts, as a precaution. Separately, the [Authorized Accounts](#authorized-accounts) feature involves setting the RequireAuth flag on your cold wallet. +We recommend enabling RequireAuth for all hot wallet (and warm wallet) accounts, as a precaution. Separately, the Authorized Accounts feature involves [setting the RequireAuth flag on your cold wallet](#with-cold-wallets). You can only enable RequireAuth if the account owns no trust lines and no offers in the Ripple ledger, so you must decide whether or not to use it before you start doing business in the Ripple network. @@ -499,11 +499,11 @@ Response: ### With Cold Wallets ### -You may also enable `RequireAuth` for your cold wallet in order to use the [Authorized Accounts](#authorized-accounts) feature. Enabling the RequireAuth flag for a cold wallet is the same as [with hot wallets](#with-hot-wallets). +You may also enable `RequireAuth` for your cold wallet in order to use the [Authorized Accounts](#authorized-accounts) feature. The procedure to enable the RequireAuth flag for a cold wallet is the same as [with hot wallets](#with-hot-wallets). If ACME decides to use Authorized Accounts, ACME creates an interface for users to get their Ripple trust lines authorized by ACME's cold account. After Alice has extended a trust line to ACME from her Ripple account, she goes through the interface on ACME's website to require ACME authorize her trust line. ACME confirms that it has validated Alice's identity information, and then sends a TrustSet transaction to authorize Alice's trust line. -The following is an example of using the [Ripple-REST Grant Trustline method](ripple-rest.html#grant-trustline) to authorize the (customer) account rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn to hold issuances from the (cold wallet) account rsA2LpzuawewSBQXkiju3YQTMzW13pAAdW: +The following is an example of using the [Ripple-REST Grant Trustline method](ripple-rest.html#grant-trustline) to authorize the (customer) account rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn to hold issuances of USD from the (cold wallet) account rsA2LpzuawewSBQXkiju3YQTMzW13pAAdW: Request: @@ -552,7 +552,7 @@ In order to robustly monitor incoming payments, gateways should do the following * Keep a record of the most-recently-processed transaction and ledger. That way, if you temporarily lose connectivity, you know how far to go back. * Check the result code of every incoming payment. Some payments go into the ledger to charge an anti-spam fee, even though they failed. Only transactions with the result code `tesSUCCESS` can change non-XRP balances. Only transactions from a validated ledger are final. -* Look out for Partial Payments. If an incoming transaction has a `destination_balance_changes` field (Ripple-REST) or a `meta.AmountDelivered` field (WebSocket/JSON-RPC), then use that to see how much money *actually* got delivered to the destination account. Payments with the partial-payment flag enabled are considered "successful" if any non-zero amount is delivered, even miniscule amounts. (The flag is called `"partial_payment": true` in REST, and `tfPartialPayment` in WebSocket/JSON-RPC) +* Look out for Partial Payments. If an incoming transaction has a `destination_balance_changes` field (Ripple-REST) or a `meta.delivered_amount` field (WebSocket/JSON-RPC), then use that to see how much money *actually* got delivered to the destination account. Payments with the partial-payment flag enabled are considered "successful" if any non-zero amount is delivered, even miniscule amounts. (The flag is called `"partial_payment": true` in REST, and `tfPartialPayment` in WebSocket/JSON-RPC) * Some transactions modify your balances without being payments directly to or from one of your accounts. For example, if ACME sets a nonzero [TransferRate](#transferrate), then ACME's cold wallet's outstanding obligations decrease each time Bob and Charlie exchange ACME issuances. See [TransferRate](#transferrate) for more information. To make things simpler for your users, we recommend monitoring for incoming payments to hot wallets and the cold wallet, and treating the two equivalently. @@ -560,16 +560,16 @@ To make things simpler for your users, we recommend monitoring for incoming paym As an added precaution, we recommend comparing the balances of your Ripple cold wallet account with the Ripple-backing funds in your internal accounting system each time there is a new Ripple ledger. The cold wallet shows all outstanding issuances as negative balances, which should match the positive assets you have allocated to Ripple outside the network. If the two do not match up, then you should suspend processing payments in and out of Ripple until you have resolved the discrepancy. * Use the [Get Account Balances method](ripple-rest.html#get-account-balances) (Ripple-REST) or the [`account_lines` command](rippled-apis.html#account-lines) (rippled) to check your balances. -* If you have a [TransferRate](#transferrate) set, transferring your issuances from one Ripple account to another decreases the obligation you owe within the Ripple network. +* If you have a [TransferRate](#transferrate) set, then your obligations within the Ripple network decrease slightly whenever other users transfer your issuances among themselves. ## TransferRate ## -The *TransferRate* setting (`transfer_rate` in Ripple-REST) defines a fee to charge for transferring issuances from one Ripple account to another. The transfer fee is set by the issuing (**cold wallet**) account. For any transaction *except paying back to the issuing account*, the sending account is debited issuances at a ratio of TransferRate:1 compared to the destination amount. The transfer fee has a maximum precision of 9 digits, and cannot be less than 0% (a `transfer_rate` of 1.0) or greater than 100% (a `transfer_rate` of 2.0). +The *TransferRate* setting (`transfer_rate` in Ripple-REST) defines a fee to charge for transferring issuances from one Ripple account to another. The transfer fee is set by the issuing (**cold wallet**) account. For any transaction *except paying back to the issuing account*, the sending account is debited issuances at a ratio of transfer\_rate:1 compared to the destination amount. The transfer fee has a maximum precision of 9 digits, and cannot be less than 0% (a `transfer_rate` of 1.0) or greater than 100% (a `transfer_rate` of 2.0). The fee represented by the TransferRate is debited from the Ripple ledger, becoming the property of the gateway. -For example, if ACME sets the trasfer_rate of its cold wallet to 1.005, that indicates a transfer fee of 0.5% for ACME issuances. In order for Bob to receive 2 EUR.ACME, Charlie must send 2.01 EUR.ACME. After the transaction, ACME's outstanding obligations in Ripple have decreased by €0.01, which means that it is no longer obliged to hold that amount in the account backing its Ripple issuances. +For example, if ACME sets the trasfer_rate of its cold wallet to 1.005, that indicates a transfer fee of 0.5% for ACME issuances. In order for Bob to receive 2 EUR.ACME, Charlie must send 2.01 EUR.ACME. After the transaction, ACME's outstanding obligations in Ripple have decreased by 0,01€, which means that it is no longer obliged to hold that amount in the account backing its Ripple issuances. The following diagram shows a Ripple payment of 2 EUR.ACME from Alice to Charlie with a transfer fee of 1%: @@ -617,7 +617,7 @@ The field `transfer_rate` in the `settings` object should have the value you set All Ripple Accounts, including the hot wallet, are subject to the TransferRate. If you set a nonzero TransferRate, then you must send extra (to pay the TransferRate) when making payments to users from your hot wallet. You can accomplish this by setting the `source_amount` plus `slippage` (Ripple-REST) or the `SendMax` (rippled) parameters higher than the destination amount. -**Note:** The TransferRate does not apply when sending issuances back to the account that created them. The account that created issuances must always accept them at face value on Ripple. This means that users don't have to pay the TransferRate if they send payments to the cold wallet directly, but they do when sending to the hot wallet. (For example, if ACME sets a TransferRate of 1%, a Ripple payment with `source_amount` and `destination_amount` of 5 EUR.ACME (and `slippage` of 0) would succeed if sent to ACME's cold wallet, but it would fail if sent to ACME's hot wallet. The hot wallet payment would only succeed if the `source_amount` plus `slippage` was at least 5.05 EUR.ACME.) If you accept payments to both accounts, you may want to adjust the amount you credit users in your external system accordingly. +**Note:** The TransferRate does not apply when sending issuances back to the account that created them. The account that created issuances must always accept them at face value on Ripple. This means that users don't have to pay the TransferRate if they send payments to the cold wallet directly, but they do when sending to the hot wallet. (For example, if ACME sets a TransferRate of 1%, a Ripple payment with `source_amount` and `destination_amount` of 5 EUR.ACME (and `slippage` of 0) would succeed if sent to ACME's cold wallet, but it would fail if sent to ACME's hot wallet. The hot wallet payment would only succeed if the `source_amount` plus `slippage` was at least 5.05 EUR.ACME.) If you accept payments to both accounts, you may want to adjust the amount you credit users in your external system to make up for fees they paid to redeem with the hot wallet. @@ -700,7 +700,7 @@ In order to achieve this, there are several steps you can take when submitting t * Use the `LastLedgerSequence` parameter. (Ripple-REST and ripple-lib do this by default.) * Resubmit a transaction if it has not appeared in a validated ledger whose sequence number is less than or equal to the transaction's `LastLedgerSequence` parameter. -For additional information, consult the guide to [Reliable Transaction Submission](reliable_tx.html) +For additional information, consult the [Reliable Transaction Submission](reliable_tx.html) guide. ## ripple.txt and host-meta ## From c30d1b707fe4fb77aa4cf4d451c9241e470eda76 Mon Sep 17 00:00:00 2001 From: mDuo13 Date: Tue, 17 Mar 2015 19:10:12 -0700 Subject: [PATCH 14/27] [DOC] added partialpayment gateway bulletin to gateway guide --- content/gateway_guide.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/gateway_guide.md b/content/gateway_guide.md index d61adb8839..8d1b67fc4e 100644 --- a/content/gateway_guide.md +++ b/content/gateway_guide.md @@ -552,7 +552,7 @@ In order to robustly monitor incoming payments, gateways should do the following * Keep a record of the most-recently-processed transaction and ledger. That way, if you temporarily lose connectivity, you know how far to go back. * Check the result code of every incoming payment. Some payments go into the ledger to charge an anti-spam fee, even though they failed. Only transactions with the result code `tesSUCCESS` can change non-XRP balances. Only transactions from a validated ledger are final. -* Look out for Partial Payments. If an incoming transaction has a `destination_balance_changes` field (Ripple-REST) or a `meta.delivered_amount` field (WebSocket/JSON-RPC), then use that to see how much money *actually* got delivered to the destination account. Payments with the partial-payment flag enabled are considered "successful" if any non-zero amount is delivered, even miniscule amounts. (The flag is called `"partial_payment": true` in REST, and `tfPartialPayment` in WebSocket/JSON-RPC) +* [Look out for Partial Payments](https://ripple.com/files/GB-2014-06.pdf "Partial Payment Flag Gateway Bulletin"). If an incoming transaction has a `destination_balance_changes` field (Ripple-REST) or a `meta.delivered_amount` field (WebSocket/JSON-RPC), then use that to see how much money *actually* got delivered to the destination account. Payments with the partial-payment flag enabled are considered "successful" if any non-zero amount is delivered, even miniscule amounts. (The flag is called `"partial_payment": true` in REST, and `tfPartialPayment` in WebSocket/JSON-RPC) * Some transactions modify your balances without being payments directly to or from one of your accounts. For example, if ACME sets a nonzero [TransferRate](#transferrate), then ACME's cold wallet's outstanding obligations decrease each time Bob and Charlie exchange ACME issuances. See [TransferRate](#transferrate) for more information. To make things simpler for your users, we recommend monitoring for incoming payments to hot wallets and the cold wallet, and treating the two equivalently. @@ -625,7 +625,7 @@ All Ripple Accounts, including the hot wallet, are subject to the TransferRate. When your hot or cold wallet receives a payment whose purpose is unclear, we recommend that you make an attempt to return the money to its sender. While this is more work than simply pocketing the money, it demonstrates good faith towards customers. You can have an operator bounce payments manually, or create a system to do so automatically. -The first requirement to bouncing payments is [robustly monitoring for incoming payments](#robustly-monitoring-for-payments). You do not want to accidentally refund a user for more than they sent you! (This is particularly important if your bounce process is automated.) +The first requirement to bouncing payments is [robustly monitoring for incoming payments](#robustly-monitoring-for-payments). You do not want to accidentally refund a user for more than they sent you! (This is particularly important if your bounce process is automated.) The [Partial Payment Flag Gateway Bulletin](https://ripple.com/files/GB-2014-06.pdf) explains how to avoid a common problem. Second, you should send bounced payments as Partial Payments. Since other Ripple users can manipulate the cost of pathways between your accounts, Partial Payments allow you to divest yourself of the full amount without being concerned about exchange rates within the Ripple network. You should publicize your bounced payments policy as part of your terms of use. From bd1ad65240587bee65d536587dd9f7d0da373546 Mon Sep 17 00:00:00 2001 From: mDuo13 Date: Tue, 17 Mar 2015 19:10:33 -0700 Subject: [PATCH 15/27] [DOC] tx_format - fee -> SetFee with example --- content/tx_format.md | 25 ++++++++++++++++++++++--- 1 file changed, 22 insertions(+), 3 deletions(-) diff --git a/content/tx_format.md b/content/tx_format.md index fe5b88855d..d5c0c07ecb 100644 --- a/content/tx_format.md +++ b/content/tx_format.md @@ -728,19 +728,38 @@ Some of the fields that are mandatory for normal transactions do not make sense | SigningPubKey | "" | | Signature | "" | -## Fee ## +## SetFee ## A change in transaction or account fees. This is typically in response to changes in the load on the network. -*Note:* There have been very few, if any, Fee psuedo-transactions, ever. It is possible, but very unlikely, that you may encounter one in a historical ledger. +*Note:* You cannot send a pseudo-transaction, but you may encounter one when processing ledgers. + +``` +{ + "Account": "rrrrrrrrrrrrrrrrrrrrrhoLvTp", + "BaseFee": "000000000000000A", + "Fee": "0", + "ReferenceFeeUnits": 10, + "ReserveBase": 20000000, + "ReserveIncrement": 5000000, + "Sequence": 0, + "SigningPubKey": "", + "TransactionType": "SetFee", + "date": 439578860, + "hash": "1C15FEA3E1D50F96B6598607FC773FF1F6E0125F30160144BE0C5CBC52F5151B", + "ledger_index": 3721729, + } +``` | Field | JSON Type | [Internal Type](https://wiki.ripple.com/Binary_Format) | Description | |-------|-----------|--------------------------------------------------------|-------------| -| BaseFee | String (Quoted Integer) | UInt64 | The charge, in drops, for the reference transaction. (See [Transaction Fee Terminology](https://ripple.com/wiki/Transaction_Fee#Fee_Terminology) | +| BaseFee | String | UInt64 | The charge, in drops, for the reference transaction, as hex. (See [Transaction Fee Terminology](https://ripple.com/wiki/Transaction_Fee#Fee_Terminology) | | ReferenceFeeUnits | Unsigned Integer | UInt32 | The cost, in fee units, of the reference transaction | | ReserveBase | Unsigned Integer | UInt32 | The base reserve, in drops | | ReserveIncrement | Unsigned Integer | UInt32 | The incremental reserve, in drops | + + # Transaction Results # ## Immediate Response ## From b802addee8caaf244fb843b2d6e9e9e74def68f5 Mon Sep 17 00:00:00 2001 From: mDuo13 Date: Tue, 17 Mar 2015 19:11:42 -0700 Subject: [PATCH 16/27] [DOC] fee->setfee in table of contents --- content/tx_format.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/tx_format.md b/content/tx_format.md index d5c0c07ecb..2d1c2d404a 100644 --- a/content/tx_format.md +++ b/content/tx_format.md @@ -15,7 +15,7 @@ There are several different types of transactions that perform different actions Additionally, there are *Psuedo-Transactions* that are not created and submitted in the usual way, but may appear in ledgers: -* [Fee - Adjust the minimum transaction fee or account reserve](#fee) +* [SetFee - Adjust the minimum transaction fee or account reserve](#setfee) Transactions are only valid if signed, submitted, and accepted into a validated ledger version. There are many ways a transaction can fail. From bb886ced673e28f818a5b8454ded1973bce3df88 Mon Sep 17 00:00:00 2001 From: mDuo13 Date: Wed, 18 Mar 2015 11:19:35 -0700 Subject: [PATCH 17/27] [DOC] gateway guide - fix wrong operator for reading account flags --- content/gateway_guide.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/gateway_guide.md b/content/gateway_guide.md index 8d1b67fc4e..ab970259fa 100644 --- a/content/gateway_guide.md +++ b/content/gateway_guide.md @@ -350,7 +350,7 @@ Response: } ``` -To confirm that an account has DefaultRipple enabled, look up the account using the [account_info command](rippled-apis.html#account-info), specifying a validated ledger version. Use [the xor operator](https://en.wikipedia.org/wiki/Exclusive_or) to compare the `Flags` field with 0x00800000 (the [ledger flag lsfDefaultRipple](https://wiki.ripple.com/Ledger_Format#AccountRoot)). If the result of the xor operation is nonzero, then the account has DefaultRipple enabled. +To confirm that an account has DefaultRipple enabled, look up the account using the [account_info command](rippled-apis.html#account-info), specifying a validated ledger version. Use [a bitwise-AND operator](https://en.wikipedia.org/wiki/Bitwise_operation#AND) to compare the `Flags` field with 0x00800000 (the [ledger flag lsfDefaultRipple](https://wiki.ripple.com/Ledger_Format#AccountRoot)). If the result of the bitwise-AND operation is nonzero, then the account has DefaultRipple enabled. ## Generating Souce and Destination Tags ## From b2ce860f3edbc6cd42f50e986aa8a6985d532d44 Mon Sep 17 00:00:00 2001 From: Torrie Fischer Date: Fri, 20 Mar 2015 10:08:10 -0700 Subject: [PATCH 18/27] typo-- --- content/rippled.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/rippled.md b/content/rippled.md index 3d0db569f9..49de0714f6 100644 --- a/content/rippled.md +++ b/content/rippled.md @@ -2,7 +2,7 @@ The core peer-to-peer server that operates the Ripple Network is called `rippled`. Each `rippled` server connects to the Ripple Network, relays cryptographically signed transactions, and maintains a local copy of the complete shared global ledger. The source code for `rippled` is written in C++, and is [available on GitHub under an open-source license](https://github.com/ripple/rippled). -* [Building and Installating](https://wiki.ripple.com/Rippled_build_instructions) +* [Building and Installing](https://wiki.ripple.com/Rippled_build_instructions) * [API Reference](#api-methods) * [Transaction Reference](transactions.html) * Client Library - [Javascript](https://github.com/ripple/ripple-lib) From f1fdceeed447d48c19cf9f0c14bee7897f1a2e09 Mon Sep 17 00:00:00 2001 From: Torrie Fischer Date: Fri, 20 Mar 2015 10:33:29 -0700 Subject: [PATCH 19/27] Automated link tests on push --- circle.yml | 11 +++++++++++ tool/check_links.py | 35 +++++++++++++++++++++++++++++++++++ 2 files changed, 46 insertions(+) create mode 100644 circle.yml create mode 100755 tool/check_links.py diff --git a/circle.yml b/circle.yml new file mode 100644 index 0000000000..2491e7cff1 --- /dev/null +++ b/circle.yml @@ -0,0 +1,11 @@ +general: + build_dir: tool/ +dependencies: + pre: + - pyenv global 3.4.0 + override: + - pip3 install jinja2 requests beautifulsoup4 +test: + override: + - ./parse_pages.py + - ./check_links.py diff --git a/tool/check_links.py b/tool/check_links.py new file mode 100755 index 0000000000..6b7e9327f1 --- /dev/null +++ b/tool/check_links.py @@ -0,0 +1,35 @@ +#!/usr/bin/env python3 +from bs4 import BeautifulSoup +import requests +import os + +externalCache = [] +atRoot = True + +for dirpath, dirnames, filenames in os.walk("../"): + if atRoot: + dirnames.remove('tool') + atRoot = False + for fname in filenames: + fullPath = os.path.join(dirpath, fname); + if fullPath.endswith(".html"): + f = open(fullPath, 'r') + soup = BeautifulSoup(f.read()) + links = soup.find_all('a') + for link in links: + endpoint = link['href'] + if "://" in endpoint: + if endpoint not in externalCache: + print("Testing remote URL %s"%(endpoint)) + code = requests.head(endpoint).status_code + if code < 200 or code >= 400: + print("Broken remote link in %s to %s"%(fullPath, endpoint)) + else: + externalCache.append(endpoint) + elif endpoint[0] == '#': + continue + elif endpoint[0] == '/': + continue + else: + if not os.path.exists(os.path.join(dirpath, endpoint)): + print("Broken local link in %s to %s"%(fullPath, endpoint)) From 70fa01fbdc00df215e480b00d93c0adafcab46eb Mon Sep 17 00:00:00 2001 From: mDuo13 Date: Fri, 20 Mar 2015 10:49:07 -0700 Subject: [PATCH 20/27] [FIX] remove dead consensus whitepaper link from index.html --- index.html | 1 - 1 file changed, 1 deletion(-) diff --git a/index.html b/index.html index 2a1c763090..658c37a32c 100644 --- a/index.html +++ b/index.html @@ -204,7 +204,6 @@

  • API Reference
  • Source
  • Bounties
    • -
  • Consensus Whitepaper
  • Transaction Format
    • From 1a8b3a32929eace1b215d6c6c3fe8aa139d04d63 Mon Sep 17 00:00:00 2001 From: mDuo13 Date: Fri, 20 Mar 2015 11:19:01 -0700 Subject: [PATCH 21/27] [FIX] remove broken consensus whitepaper link from index template --- tool/template-index.html | 1 - 1 file changed, 1 deletion(-) diff --git a/tool/template-index.html b/tool/template-index.html index 887dd8b867..6cc57bd804 100644 --- a/tool/template-index.html +++ b/tool/template-index.html @@ -126,7 +126,6 @@
  • API Reference
  • Source
  • Bounties
    • -
  • Consensus Whitepaper
  • Transaction Format
    • From 6dcfefa662d67829471c641b55341a2c82d636b1 Mon Sep 17 00:00:00 2001 From: mDuo13 Date: Fri, 20 Mar 2015 11:49:47 -0700 Subject: [PATCH 22/27] [FEATURE] historical api try it links --- content/historical_data.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/content/historical_data.md b/content/historical_data.md index 493ff4d13e..875b45e41a 100644 --- a/content/historical_data.md +++ b/content/historical_data.md @@ -83,6 +83,8 @@ GET /v1/accounts/{:address}/transactions
    +[Try it! >](historicaldb-api-tool.html#get-account-transaction-history) + The following URL parameters are required by this API endpoint: | Field | Value | Description | @@ -593,6 +595,8 @@ GET /v1/accounts/{:address}/transactions/{:sequence}
    +[Try it! >](historicaldb-api-tool.html#get-transaction-by-account-and-sequence) + The following URL parameters are required by this API endpoint: | Field | Value | Description | @@ -814,6 +818,8 @@ GET /v1/ledgers/{:ledger_identifier}
    +[Try it! >](historicaldb-api-tool.html#get-ledger) + The following URL parameters are required by this API endpoint: | Field | Value | Description | @@ -883,6 +889,8 @@ GET /v1/transactions/{:hash}
    +[Try it! >](historicaldb-api-tool.html#get-transaction) + The following URL parameters are required by this API endpoint: | Field | Value | Description | From cba17fe87d4e8f56ccf06daf94e60dbd6c905ad4 Mon Sep 17 00:00:00 2001 From: mDuo13 Date: Fri, 20 Mar 2015 18:14:08 -0700 Subject: [PATCH 23/27] [DOC] rest - new flags in account settings --- content/ripplerest_api.md | 47 +++++++++++++++++++++++---------------- 1 file changed, 28 insertions(+), 19 deletions(-) diff --git a/content/ripplerest_api.md b/content/ripplerest_api.md index 5bec9d5ad6..b2c3faaead 100644 --- a/content/ripplerest_api.md +++ b/content/ripplerest_api.md @@ -698,14 +698,17 @@ The following URL parameters are required by this API endpoint: "success": true, "settings": { "account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn", - "transfer_rate": "", + "transfer_rate": 1004999999, "password_spent": false, - "require_destination_tag": false, + "require_destination_tag": true, "require_authorization": false, - "disallow_xrp": false, + "disallow_xrp": true, "disable_master": false, - "transaction_sequence": "36", - "email_hash": "", + "no_freeze": false, + "global_freeze": false, + "default_ripple": true, + "transaction_sequence": "330", + "email_hash": "98B4375E1D753E5B91627516F6D70977", "wallet_locator": "", "wallet_size": "", "message_key": "0000000000000000000000070000000300", @@ -720,18 +723,22 @@ The response contains a `settings` object, with the following fields: | Field | Value | Description | |-------|-------|-------------| | account | String | The Ripple address of this account | -| transfer_rate | String (Quoted decimal number) | If set, imposes a fee for transferring balances issued by this account. Must be between 1 and 2, with up to 9 decimal places of precision. See [TransferRate](transactions.html#transferrate) for details. | -| password_spent | Boolean | If false, then this account can submit a special [SetRegularKey transaction](transactions.html#setregularkey) without a transaction fee. | +| transfer\_rate | String (Quoted decimal number) | If set, imposes a fee for transferring balances issued by this account. Must be between 1 and 2, with up to 9 decimal places of precision. See [TransferRate](transactions.html#transferrate) for details. | +| password\_spent | Boolean | If false, then this account can submit a special [SetRegularKey transaction](transactions.html#setregularkey) without a transaction fee. | | require\_destination\_tag | Boolean | If true, require a destination tag to send payments to this account. (This is intended to protect users from accidentally omitting the destination tag in a payment to a gateway's hosted wallet.) | -| require_authorization | Boolean | If true, require authorization for users to hold balances issued by this account. (This prevents users unknown to a gateway from holding funds issued by that gateway.) | -| disallow_xrp | Boolean | If true, XRP should not be sent to this account. (Enforced in clients but not in the server, because it could cause accounts to become unusable if all their XRP were spent.) | -| disable_master | Boolean | If true, the master secret key cannot be used to sign transactions for this account. Can only be set to true if a Regular Key is defined for the account. | -| transaction_sequence | String (Quoted integer) | The sequence number of the next valid transaction for this account. (Each account starts with Sequence = 1 and increases each time a transaction is made.) | +| require\_authorization | Boolean | If true, require authorization for users to hold balances issued by this account. (This prevents users unknown to a gateway from holding funds issued by that gateway.) | +| disallow\_xrp | Boolean | If true, XRP should not be sent to this account. (Enforced in clients but not in the server, because it could cause accounts to become unusable if all their XRP were spent.) | +| disable\_master | Boolean | If true, the master secret key cannot be used to sign transactions for this account. Can only be set to true if a Regular Key is defined for the account. | +| no_freeze | Boolean | If true, the account has permanently given up the ability to [freeze](https://ripple.com/files/GB-2014-02.pdf) its trust lines. | +| global_freeze | Boolean | If true, all trust lines connected to the account are [frozen](https://ripple.com/files/GB-2014-02.pdf). | +| default\_ripple | Boolean | If true, enables [rippling](https://ripple.com/knowledge_center/understanding-the-noripple-flag/) on this account's trustlines by default. _(New in [Ripple-REST v1.5.0](https://github.com/ripple/ripple-rest/releases/tag/1.5.0-rc1))_ | +| transaction\_sequence | String (Quoted integer) | The sequence number of the next valid transaction for this account. (Each account starts with Sequence = 1 and increases each time a transaction is made.) | | email_hash | String | Hash of an email address to be used for generating an avatar image. Conventionally, clients use [Gravatar](http://en.gravatar.com/site/implement/hash/) to display this image. | -| wallet_locator | String | (Not used) | -| wallet_size | String | (Not used) | -| message_key | String | A [secp256k1](https://en.bitcoin.it/wiki/Secp256k1) public key that should be used to encrypt secret messages to this account. | +| wallet\_locator | String | (Not used) | +| wallet\_size | String | (Not used) | +| message\_key | String | A [secp256k1](https://en.bitcoin.it/wiki/Secp256k1) public key that should be used to encrypt secret messages to this account. | | domain | String | The domain that holds this account. Clients can use this to verify the account in the [ripple.txt](https://wiki.ripple.com/Ripple.txt) or [host-meta](https://wiki.ripple.com/Gateway_Services) of the domain. | +| signers | (Undefined) | (To be used for [Multi-sign](https://wiki.ripple.com/M_of_N)) | @@ -755,7 +762,7 @@ POST /v1/accounts/{:address}/settings?validated=true "require_authorization": false, "disallow_xrp": false, "disable_master": false, - "transaction_sequence": 22 + "default_ripple": false } } ``` @@ -791,12 +798,14 @@ The `settings` object can contain any of the following fields (any omitted field |-------|-------|-------------| | transfer_rate | String (Quoted decimal number) | If set, imposes a fee for transferring balances issued by this account. Must be between 1 and 2, with up to 9 decimal places of precision. | | require\_destination\_tag | Boolean | If true, require a destination tag to send payments to this account. (This is intended to protect users from accidentally omitting the destination tag in a payment to a gateway's hosted wallet.) | -| require_authorization | Boolean | If true, require authorization for users to hold balances issued by this account. (This prevents users unknown to a gateway from holding funds issued by that gateway.) | -| disallow_xrp | Boolean | If true, XRP should not be sent to this account. (Enforced in clients but not in the server, because it could cause accounts to become unusable if all their XRP were spent.) | +| require\_authorization | Boolean | If true, require authorization for users to hold balances issued by this account. (This prevents users unknown to a gateway from holding funds issued by that gateway.) | +| disallow\_xrp | Boolean | If true, XRP should not be sent to this account. (Enforced in clients but not in the server, because it could cause accounts to become unusable if all their XRP were spent.) | | disable_master | Boolean | If true, the master secret key cannot be used to sign transactions for this account. Can only be set to true if a Regular Key is defined for the account. | -| transaction_sequence | String (Quoted integer) | The sequence number of the next valid transaction for this account. | +| no_freeze | Boolean | If true, the account has permanently given up the ability to [freeze](https://ripple.com/files/GB-2014-02.pdf) its trust lines. Cannot be set to false after being true. | +| global_freeze | Boolean | If true, [freeze](https://ripple.com/files/GB-2014-02.pdf) all trust lines connected to the account. | +| default\_ripple | Boolean | If true, enables [rippling](https://ripple.com/knowledge_center/understanding-the-noripple-flag/) on this account's trustlines by default. _(New in [Ripple-REST v1.5.0](https://github.com/ripple/ripple-rest/releases/tag/1.5.0-rc1))_ | | email_hash | String | Hash of an email address to be used for generating an avatar image. Conventionally, clients use [Gravatar](http://en.gravatar.com/site/implement/hash/) to display this image. | -| message_key | String | A [secp256k1](https://en.bitcoin.it/wiki/Secp256k1) public key that should be used to encrypt secret messages to this account, as hex. | +| message\_key | String | A [secp256k1](https://en.bitcoin.it/wiki/Secp256k1) public key that should be used to encrypt secret messages to this account, as hex. | | domain | String | The domain that holds this account, as lowercase ASCII. Clients can use this to verify the account in the [ripple.txt](https://wiki.ripple.com/Ripple.txt) or [host-meta](https://wiki.ripple.com/Gateway_Services) of the domain. | *Note:* Some of the account setting fields cannot be modified by this method. For example, the `password_spent` flag is only enabled when the account uses a free SetRegularKey transaction, and only disabled when the account receives a transmission of XRP. From a42461206852e424fd21aba0f6bafcffc4ada5df Mon Sep 17 00:00:00 2001 From: mDuo13 Date: Mon, 23 Mar 2015 15:18:01 -0700 Subject: [PATCH 24/27] [TOOL] templates for documenting API methods in markdown --- tool/ripple-rest-markdown-skeleton.md | 52 ++++++++++++++++++++ tool/rippled-markdown-skeleton.md | 71 +++++++++++++++++++++++++++ 2 files changed, 123 insertions(+) create mode 100644 tool/ripple-rest-markdown-skeleton.md create mode 100644 tool/rippled-markdown-skeleton.md diff --git a/tool/ripple-rest-markdown-skeleton.md b/tool/ripple-rest-markdown-skeleton.md new file mode 100644 index 0000000000..f231344ffa --- /dev/null +++ b/tool/ripple-rest-markdown-skeleton.md @@ -0,0 +1,52 @@ +## title ## +[[Source]
    ]( "Source") + +blurb + +#### Request Format #### + +
    + +*REST* + +``` + +``` + +
    + +[Try it! >](rest-api-tool.html#prepare-payment) + + +This method requires the following URL parameters: + +| Field | Value | Description | +|-------|-------|-------------| + + +Optionally, you can also include the following query parameters: + +| Field | Value | Description | +|-------|-------|-------------| + + +The request includes the following body parameters: + +| Field | Value | Description | +|-------|-------|-------------| + + +Further description + +#### Response Format #### + +An example of a successful response: + +```js +//actual example here +``` + +A successful result contains the following fields: + +| Field | Type | Description | +|-------|------|-------------| diff --git a/tool/rippled-markdown-skeleton.md b/tool/rippled-markdown-skeleton.md new file mode 100644 index 0000000000..97646f3fd6 --- /dev/null +++ b/tool/rippled-markdown-skeleton.md @@ -0,0 +1,71 @@ +## command ## +[[Source]
    ](githuburl "Source") + +blurb + +#### Request Format #### +An example of the request format: + +
    + +*WebSocket* + +``` +//actual example here +``` + +*Second tab* + +``` +//second example here +``` + +
    + +The request includes the following parameters: + +| Field | Type | Description | +|-------|------|-------------| + + + + + + + + +#### Response Format #### + +An example of a successful response: + +
    + +*WebSocket* + +``` +//actual example here +``` + +*Second tab* + +``` +//second example here +``` + +
    + +The response follows the [standard format](#response-formatting), with a successful result containing the following fields: + +| Field | Type | Description | +|-------|------|-------------| + + + + + +#### Possible Errors #### + +* Any of the [universal error types](#universal-errors). +* `invalidParams` - One or more fields are specified incorrectly, or one or more required fields are missing. +* `actNotFound` - The address specified in the `account` field of the request does not correspond to an account in the ledger. +* `lgrNotFound` - The ledger specified by the `ledger_hash` or `ledger_index` does not exist, or it does exist but the server does not have it. From 919c03a992635a9be09844f55eff4c10b5f72383 Mon Sep 17 00:00:00 2001 From: mDuo13 Date: Mon, 23 Mar 2015 15:22:22 -0700 Subject: [PATCH 25/27] [FIX] issue #122 - wrong host for historical-db api tool --- historicaldb-api-tool.html | 2 +- tool/pages.json | 2 ++ tool/template-rest-api-tool.html | 2 +- 3 files changed, 4 insertions(+), 2 deletions(-) diff --git a/historicaldb-api-tool.html b/historicaldb-api-tool.html index 09832ebe58..403bf23323 100644 --- a/historicaldb-api-tool.html +++ b/historicaldb-api-tool.html @@ -101,7 +101,7 @@

    Invalid JSON
    -

    https://api.ripple.com

    +

    https://history.ripple.com

    diff --git a/tool/pages.json b/tool/pages.json index 0fa932ec03..6f8d36144f 100644 --- a/tool/pages.json +++ b/tool/pages.json @@ -54,6 +54,7 @@ "template":"template-rest-api-tool.html", "methods_js": "js/apitool-methods-ripplerest.js", "is_apitool": true, + "rest_host": "https://api.ripple.com", "html": "rest-api-tool.html" }, { @@ -61,6 +62,7 @@ "template":"template-rest-api-tool.html", "methods_js": "js/apitool-methods-historical.js", "is_apitool": true, + "rest_host": "https://history.ripple.com", "html": "historicaldb-api-tool.html" }, { diff --git a/tool/template-rest-api-tool.html b/tool/template-rest-api-tool.html index 34c52added..c32fde19cf 100644 --- a/tool/template-rest-api-tool.html +++ b/tool/template-rest-api-tool.html @@ -19,7 +19,7 @@

    Invalid JSON
    -

    https://api.ripple.com

    +

    {{ currentpage.rest_host }}

    From a1d35fe68d30d195a51a89c8eb042728a04a586c Mon Sep 17 00:00:00 2001 From: mDuo13 Date: Wed, 4 Mar 2015 15:49:05 -0800 Subject: [PATCH 26/27] [TOOL] added old ws-to-rpc tool; made parse_pages executable --- tool/ws2rpc.py | 69 ++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 69 insertions(+) create mode 100644 tool/ws2rpc.py diff --git a/tool/ws2rpc.py b/tool/ws2rpc.py new file mode 100644 index 0000000000..12839b0935 --- /dev/null +++ b/tool/ws2rpc.py @@ -0,0 +1,69 @@ +#!/bin/env python + +""" +Tool to parse a markdown file for WebSocket examples, +reformat those examples as JSON-RPC, and test them against +a public WebSocket server. +""" + +from __future__ import print_function +import re, json +import sys +import warnings +if sys.version_info[:2] <= (2,7): + import httplib +else: + import http.client as httplib + +WS_REGEX = r"\*WebSocket\*\s*```\s*(?P\{[^`]*\})\s*```" + +def ws2rpc(s): + ws_j = json.loads(s) + + if "command" not in ws_j: + #apparently not a WebSocket request after all? + warnings.warn("Incorrect match? "+s) + return "" + + rpc_j = {"params":[{}]} + for key,val in ws_j.items(): + if key == "id": + continue + elif key == "command": + rpc_j["method"] = val + else: + rpc_j["params"][0][key] = val + + return json.dumps(rpc_j, sort_keys=True, indent=4, separators=(',', ': ')) + + +if __name__ == "__main__": + + if len(sys.argv) != 2: + exit("Usage: %s inputfile" % sys.argv[0]) + + f = open(sys.argv[1], 'r') + matches = re.findall(WS_REGEX, f.read()) + f.close() + + for s in matches: + js = ws2rpc(s) + if js: + print("Request:\n*JSON-RPC*\n```\n"+js+"\n```\n\n") + + conn = httplib.HTTPConnection("s1.ripple.com", 51234) + conn.request("POST", "/", js) + response = conn.getresponse() + + s = response.read() + + try: + #parse & pretty-print response JSON if valid + response_json = json.loads(s.decode("utf-8")) + s = json.dumps(response_json, sort_keys=True, indent=4, separators=(',', ': ')) + except ValueError: + #invalid JSON; leave response as-is + pass + + print("Response:\n*JSON-RPC*\n```\n%s %s\n%s```\n\n" % ( + response.status, response.reason, s) ) From d4709103ac102c402ce4bf134bc0e119583e84bb Mon Sep 17 00:00:00 2001 From: mDuo13 Date: Mon, 23 Mar 2015 16:59:34 -0700 Subject: [PATCH 27/27] [FEATURE] ws2rpc improvements -- proper argparsing, offline mode, specify rippled instance from commandline --- tool/ws2rpc.py | 58 +++++++++++++++++++++++++++++++++----------------- 1 file changed, 39 insertions(+), 19 deletions(-) mode change 100644 => 100755 tool/ws2rpc.py diff --git a/tool/ws2rpc.py b/tool/ws2rpc.py old mode 100644 new mode 100755 index 12839b0935..e6aac0545e --- a/tool/ws2rpc.py +++ b/tool/ws2rpc.py @@ -7,15 +7,18 @@ a public WebSocket server. """ from __future__ import print_function -import re, json -import sys -import warnings +import re, json, sys, warnings, argparse + if sys.version_info[:2] <= (2,7): import httplib + #gotta define this + class FileNotFoundError(IOError): + pass else: import http.client as httplib -WS_REGEX = r"\*WebSocket\*\s*```\s*(?P\{[^`]*\})\s*```" +RIPPLED_RPC_HOST = "s1.ripple.com" +RIPPLED_RPC_PORT = 51234 def ws2rpc(s): ws_j = json.loads(s) @@ -36,34 +39,51 @@ def ws2rpc(s): return json.dumps(rpc_j, sort_keys=True, indent=4, separators=(',', ': ')) +def do_JSONRPC(req, host, port): + conn = httplib.HTTPConnection(host, port) + conn.request("POST", "/", js) + response = conn.getresponse() + + s = response.read() + header = "%s %s" % (response.status, response.reason) + return (header, s) + if __name__ == "__main__": + parser = argparse.ArgumentParser(description="Convert WebSocket examples to JSON-RPC with responses from the live rippled network") + parser.add_argument("inputfile") + parser.add_argument("--offline", action="store_true", help="don't connect to the network to generate responses") + parser.add_argument("--rippled_host", help="hostname of a rippled server to use", type=str, default=RIPPLED_RPC_HOST) + parser.add_argument("--rippled_port", help="port number of a rippled server to use", type=int, default=RIPPLED_RPC_PORT) - if len(sys.argv) != 2: - exit("Usage: %s inputfile" % sys.argv[0]) + args = parser.parse_args() - f = open(sys.argv[1], 'r') - matches = re.findall(WS_REGEX, f.read()) - f.close() + WS_REGEX = r"\*WebSocket\*\s*```\s*(?P\{[^`]*\})\s*```" + + try: + f = open(args.inputfile, 'r') + matches = re.findall(WS_REGEX, f.read()) + f.close() + except (FileNotFoundError, IOError, OSError): + exit("Couldn't read file %s" % args.inputfile) for s in matches: js = ws2rpc(s) if js: - print("Request:\n*JSON-RPC*\n```\n"+js+"\n```\n\n") + print("Request:\n*JSON-RPC*\n\n```\n"+js+"\n```\n\n") - conn = httplib.HTTPConnection("s1.ripple.com", 51234) - conn.request("POST", "/", js) - response = conn.getresponse() - - s = response.read() + if args.offline: + continue + + header, response_body = do_JSONRPC(js, args.rippled_host, args.rippled_port) try: #parse & pretty-print response JSON if valid - response_json = json.loads(s.decode("utf-8")) - s = json.dumps(response_json, sort_keys=True, indent=4, separators=(',', ': ')) + response_json = json.loads(response_body.decode("utf-8")) + response_body = json.dumps(response_json, sort_keys=True, indent=4, separators=(',', ': ')) except ValueError: #invalid JSON; leave response as-is pass - print("Response:\n*JSON-RPC*\n```\n%s %s\n%s```\n\n" % ( - response.status, response.reason, s) ) + print("Response:\n*JSON-RPC*\n\n```\n%s\n%s\n```\n\n" % ( + header, response_body) )