Skip to content

Commit 053576f

Browse files
authored
fix: Refining README.md for XRPL
Update README.md
2 parents 0373cb3 + 9421325 commit 053576f

File tree

1 file changed

+14
-14
lines changed

1 file changed

+14
-14
lines changed

lib/xrp/README.md

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,28 +1,28 @@
1-
# Sample AWS Blockchain Node Runner app for XRP Nodes
1+
# Sample AWS Blockchain Node Runner app for XRP Ledger Nodes
22

33
| Contributed by |
44
|:--------------------------------:|
55
| [Pedro Aceves](https://github.com/acevesp)|
66

7-
XRP node deployment on AWS. All nodes are configure as ["Stock Servers"](https://xrpl.org/docs/infrastructure/configuration/server-modes/run-rippled-as-a-stock-server)
7+
XRP Ledger node deployment on AWS. All nodes are configure as ["Stock Servers"](https://xrpl.org/docs/infrastructure/configuration/server-modes/run-rippled-as-a-stock-server)
88

99
## Overview of Deployment Architectures for Single and HA setups
1010

1111
### Single node setup
1212

1313
![Single Node Deployment](./doc/assets/Architecture-Single%20node.drawio.png)
1414

15-
1. A XRP node deployed in the [Default VPC](https://docs.aws.amazon.com/vpc/latest/userguide/default-vpc.html) continuously synchronizes with the rest of nodes on the configured xrp network through [Internet Gateway](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Internet_Gateway.html).
16-
2. The XRP node is used by dApps or development tools internally from within the Default VPC. RPC API is not exposed to the Internet directly to protect nodes from unauthorized access.
17-
3. The XRP node sends various monitoring metrics for both EC2 and current XRP ledger sequence to Amazon CloudWatch. It also updates the dashboard with correct storage device names to display respective metrics properly.
15+
1. A XRP Ledger node deployed in the [Default VPC](https://docs.aws.amazon.com/vpc/latest/userguide/default-vpc.html) continuously synchronizes with the rest of nodes on the configured XRPL network through [Internet Gateway](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Internet_Gateway.html).
16+
2. The XRP Ledger node is used by dApps or development tools internally from within the Default VPC. RPC API is not exposed to the Internet directly to protect nodes from unauthorized access.
17+
3. The XRP Ledger node sends various monitoring metrics for both EC2 and current XRP Ledger sequence to Amazon CloudWatch. It also updates the dashboard with correct storage device names to display respective metrics properly.
1818

1919
### HA setup
2020

2121
![Highly Available Nodes Deployment](./doc/assets/Architecture-HA%20Nodes.drawio.png)
2222

23-
1. A set of XRP nodes are deployed within an [Auto Scaling Group](https://docs.aws.amazon.com/autoscaling/ec2/userguide/auto-scaling-groups.html) in the [Default VPC](https://docs.aws.amazon.com/vpc/latest/userguide/default-vpc.html) continuously synchronizing with the rest of nodes on the configured xrp network through [Internet Gateway](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Internet_Gateway.html).
24-
2. The XRP nodes are accessed by dApps or development tools internally through [Application Load Balancer](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/introduction.html). RPC API is not exposed to the Internet to protect nodes from unauthorized access.
25-
3. The XRP nodes send various monitoring metrics for EC2 to Amazon CloudWatch.
23+
1. A set of XRP Ledger nodes are deployed within an [Auto Scaling Group](https://docs.aws.amazon.com/autoscaling/ec2/userguide/auto-scaling-groups.html) in the [Default VPC](https://docs.aws.amazon.com/vpc/latest/userguide/default-vpc.html) continuously synchronizing with the rest of nodes on the configured XRPL network through [Internet Gateway](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Internet_Gateway.html).
24+
2. The XRP Ledger nodes are accessed by dApps or development tools internally through [Application Load Balancer](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/introduction.html). RPC API is not exposed to the Internet to protect nodes from unauthorized access.
25+
3. The XRP Ledger nodes send various monitoring metrics for EC2 to Amazon CloudWatch.
2626

2727
## Well-Architected
2828

@@ -31,11 +31,11 @@ XRP node deployment on AWS. All nodes are configure as ["Stock Servers"](https:/
3131

3232
### Well-Architected Checklist
3333

34-
This is the Well-Architected checklist for XRP nodes implementation of the AWS Blockchain Node Runner app. This checklist takes into account questions from the [AWS Well-Architected Framework](https://aws.amazon.com/architecture/well-architected/) which are relevant to this workload. Please feel free to add more checks from the framework if required for your workload.
34+
This is the Well-Architected checklist for XRP Ledger nodes implementation of the AWS Blockchain Node Runner app. This checklist takes into account questions from the [AWS Well-Architected Framework](https://aws.amazon.com/architecture/well-architected/) which are relevant to this workload. Please feel free to add more checks from the framework if required for your workload.
3535

3636
| Pillar | Control | Question/Check | Remarks |
3737
|:------------------------|:----------------------------------|:---------------------------------------------------------------------------------|:-----------------|
38-
| Security | Network protection | Are there unnecessary open ports in security groups? | Please note that XRP sync ports remain open for outbound connections; Port 2459 and 51235 (TCP/UDP). |
38+
| Security | Network protection | Are there unnecessary open ports in security groups? | Please note that rippled sync ports remain open for outbound connections; Port 2459 and 51235 (TCP/UDP). |
3939
| | | Traffic inspection | AWS WAF could be implemented for traffic inspection. Additional charges will apply. |
4040
| | Compute protection | Reduce attack surface | This solution uses Amazon Linux 2 AMI. You may choose to run hardening scripts on it. |
4141
| | | Enable people to perform actions at a distance | This solution uses AWS Systems Manager for terminal session, not ssh ports. |
@@ -111,7 +111,7 @@ npx cdk deploy XRP-common
111111
npx cdk deploy XRP-single-node --json --outputs-file single-node-deploy.json
112112
```
113113

114-
2. After starting the node you need to wait for the initial synchronization process to finish. You can use Amazon CloudWatch to track the progress. There is a script that publishes CloudWatch metrics every 5 minutes, where you can watch `XRP Sequence` metrics. When the node is fully synced the sequence should match that of the configured xrp network (testnet, mainnet, etc). To see them:
114+
2. After starting the node you need to wait for the initial synchronization process to finish. You can use Amazon CloudWatch to track the progress. There is a script that publishes CloudWatch metrics every 5 minutes, where you can watch `XRP Sequence` metrics. When the node is fully synced the sequence should match that of the configured XRPL network (testnet, mainnet, etc). To see them:
115115

116116
- Navigate to [CloudWatch service](https://console.aws.amazon.com/cloudwatch/) (make sure you are in the region you have specified for `AWS_REGION`)
117117
- Open `Dashboards` and select dashboard that starts with `XRP-single-node` from the list of dashboards.
@@ -217,10 +217,10 @@ aws ssm start-session --target $INSTANCE_ID --region $AWS_REGION
217217
sudo cat /var/log/cloud-init-output.log
218218
sudo cat /var/log/user-data.log
219219
```
220-
2. How can I change rippled (XRP) configuration?
221-
There are two places of configuration for the xrp nodes:
220+
2. How can I change rippled (XRPL) configuration?
221+
There are two places of configuration for the XRP Ledger nodes:
222222

223-
a. `.env` file. Here is where you specify the xrp network you want. This is the key for the config in part b
223+
a. `.env` file. Here is where you specify the XRPL network you want. This is the key for the config in part b
224224

225225
```bash
226226
HUB_NETWORK_ID="testnet"

0 commit comments

Comments
 (0)