From c4ddcb991df5d1f060adbea4d0ec03219142ba3a Mon Sep 17 00:00:00 2001 From: Arthur Britto Date: Tue, 6 Nov 2012 06:22:17 -0800 Subject: [PATCH 1/3] Document [accounts] in ripple.txt. --- ripple.txt | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/ripple.txt b/ripple.txt index a573c3c01..bfe998aac 100644 --- a/ripple.txt +++ b/ripple.txt @@ -17,8 +17,17 @@ # Undefined sections are reserved. # No escapes are currently defined. # +# [accounts] +# Only valid in "ripple.txt". A list of accounts associated with this +# domain. A client wishing to indicate that an account is verified as +# belonging to a domain will be show the account with a green background. A +# client can verify that an account belongs to a domain by checking if the +# account's root entry mentions the domain containing this file and this +# file found at the domain mentions the account in this section. +# +# Example: rG1QQv2nh2gr7RCZ1P8YYcBUKCCN633jCn +# # [validation_public_key]: -# Mandatory in "ripple.txt". # Only valid in "ripple.txt". # # Example: n9MZTnHe5D5Q2cgE8oV2usFwRqhUvEA8MwP5Mu1XVD6TxmssPRev From e54238c5a85167781b4976693b139dde50d01ae6 Mon Sep 17 00:00:00 2001 From: Arthur Britto Date: Tue, 6 Nov 2012 06:28:49 -0800 Subject: [PATCH 2/3] Improve ripple.txt comments. --- ripple.txt | 16 +++++++++------- 1 file changed, 9 insertions(+), 7 deletions(-) diff --git a/ripple.txt b/ripple.txt index bfe998aac..d80fda560 100644 --- a/ripple.txt +++ b/ripple.txt @@ -18,17 +18,19 @@ # No escapes are currently defined. # # [accounts] -# Only valid in "ripple.txt". A list of accounts associated with this -# domain. A client wishing to indicate that an account is verified as -# belonging to a domain will be show the account with a green background. A -# client can verify that an account belongs to a domain by checking if the -# account's root entry mentions the domain containing this file and this -# file found at the domain mentions the account in this section. +# Only valid in "ripple.txt". A list of accounts that are declared to be +# controlled by this domain. A client wishing to indicate that an account is +# verified as belonging to a domain will be show the account with a green +# background. A client can verify that an account belongs to a domain by +# checking if the account's root entry mentions the domain containing this +# file and this file found at the domain mentions the account in this +# section. # # Example: rG1QQv2nh2gr7RCZ1P8YYcBUKCCN633jCn # # [validation_public_key]: -# Only valid in "ripple.txt". +# Only valid in "ripple.txt". A validation public key that is declared +# to be used by this domain for validating ledgers. # # Example: n9MZTnHe5D5Q2cgE8oV2usFwRqhUvEA8MwP5Mu1XVD6TxmssPRev # From e312c196316b8d30911f6ec3b2d5cbabafd9118c Mon Sep 17 00:00:00 2001 From: Arthur Britto Date: Tue, 6 Nov 2012 06:38:54 -0800 Subject: [PATCH 3/3] Add [expires] to ripple.txt --- ripple.txt | 21 ++++++++++++++++----- 1 file changed, 16 insertions(+), 5 deletions(-) diff --git a/ripple.txt b/ripple.txt index d80fda560..1e3904e45 100644 --- a/ripple.txt +++ b/ripple.txt @@ -1,10 +1,8 @@ # # Sample ripple.txt # -# Publishing this file allows a site to declare in a trustworthy manor that -# their node_public_key is the authorized signature for the domain. This does -# not imply that a node serving the Newcoin protocol is avilable at the web -# host providing the file. +# Publishing this file allows a site to declare in a trustworthy manor ripple +# associated information. # # This file is stored on the web server for a domain. This file is searched # for in the following order: @@ -17,6 +15,16 @@ # Undefined sections are reserved. # No escapes are currently defined. # +# [expires] +# Number of days after which this file should be considered expire. Clients +# are expected to check this file when they have cause to believe it has +# changed or expired. For example, if a client discovers an account declares +# that it is associated with the domain, it should check to see if this file +# has been updated. If an expiration date is not declared, the default +# expiration for this file is 30 days. +# +# Example: 30 +# # [accounts] # Only valid in "ripple.txt". A list of accounts that are declared to be # controlled by this domain. A client wishing to indicate that an account is @@ -30,7 +38,10 @@ # # [validation_public_key]: # Only valid in "ripple.txt". A validation public key that is declared -# to be used by this domain for validating ledgers. +# to be used by this domain for validating ledgers and that it is the +# authorized signature for the domain. This does not imply that a node +# serving the Ripple protocol is avilable at the web host providing the +# file. # # Example: n9MZTnHe5D5Q2cgE8oV2usFwRqhUvEA8MwP5Mu1XVD6TxmssPRev #