This member’s definition is left as a generic string to maximize
flexibility; for example, if a new currency representation
From 18e69d20e5cea89f482b136f14dfd6b7f081f7d8 Mon Sep 17 00:00:00 2001
From: "Eric A. Meyer"
Date: Wed, 29 Apr 2026 14:36:21 -0400
Subject: [PATCH 4/4] Typo corrections, clarifications in Flows specification
---
specification/flows/section/algorithms.html | 10 +++++-----
specification/flows/section/authentication.html | 8 ++++----
specification/flows/section/dictionaries.html | 12 ++++++------
specification/flows/section/status.html | 4 ++--
specification/flows/section/storage.html | 2 +-
specification/flows/section/terms.html | 4 ++--
specification/flows/section/wallet-setup.html | 6 +++---
7 files changed, 23 insertions(+), 23 deletions(-)
diff --git a/specification/flows/section/algorithms.html b/specification/flows/section/algorithms.html
index 187022e0..a4e354c3 100644
--- a/specification/flows/section/algorithms.html
+++ b/specification/flows/section/algorithms.html
@@ -76,7 +76,7 @@ Wallet address request
Authorization server (AS)
Outgoing payment and quote grant request
- The send an outgoing payment and quote grant requests refers to the Open Payments grant request
+ The send an outgoing payment and quote grant requests refers to the Open Payments grant request .
When asked to
send an outgoing payment and quote grant request ,
given
|walletAddressDetails:WalletAddressDetails| , |budget:number|
@@ -374,7 +374,7 @@
Incoming payment grant request
Continue grant request
- The send a continue grant request, refers to the Open Payments grant request
+ The send a continue grant request, refers to the Open Payments grant request .
When asked to
send a continue grant request , given |continueUri:DOMString|, |accessToken:DOMString|, perform the following steps.
@@ -441,7 +441,7 @@ Continue grant request
Cancel grant request
The cancel grant request, refers to the Open Payments cancel grant request .
- When asked to
send a cancel grant request , given |continueUri|, |accessToken| perform the following steps.
+ When asked to
send a cancel grant request , given |continueUri|, |accessToken|, perform the following steps.
Let |uri| be the result of running [=URL parser=] with |continueUri|.
@@ -500,7 +500,7 @@ Cancel grant request
Rotate access token
The rotate access token request refers to the Open Payments rotate access token .
- When asked to
send a rotate access token request , given {{Grant}} |userWalletGrant:Grant| perform the following steps.
+ When asked to
send a rotate access token request , given {{Grant}} |userWalletGrant:Grant|, perform the following steps.
Let |manageUrl:URL| be the result of running [=URL parser=] with
@@ -807,7 +807,7 @@ Helper algorithms
Fetch request
- To perform a
fetch request given a [=request=] request and
+ To perform a
fetch request given a [=request=] |request| and
an algorithm |processResponseConsumeBody|, execute the following steps:
diff --git a/specification/flows/section/authentication.html b/specification/flows/section/authentication.html
index 8405c0f8..35266ab5 100644
--- a/specification/flows/section/authentication.html
+++ b/specification/flows/section/authentication.html
@@ -8,7 +8,7 @@ Authentication
(e.g. grant requests, quote creation, outgoing payment creation) MUST be signed.
The validity of signatures is established because the user, during setup or an authorization procedure,
- registers the [=encoded public key JWK=] with their wallet provider. The wallet provider then uses
+ registers the [=encoded public key JWK=] (JSON Web Key) with their wallet provider. The wallet provider then uses
that public key to verify subsequent signed requests (for example, grant creation, quote requests,
and outgoing payment creation).
@@ -119,8 +119,8 @@ Constructing the encoded public key JWK
Set |jwk|.kid to |keyId|.
-
Let |json:DOMString| be the UTF-8 JSON serialization of |jwk|.
-
Let |encodedPublicKeyJwk:DOMString| be |json| base64 encoded per [[RFC4648]].
+
Let |jsonJwk:DOMString| be the UTF-8 JSON serialization of |jwk|.
+
Let |encodedPublicKeyJwk:DOMString| be |jsonJwk| base64 encoded per [[RFC4648]].
Return |encodedPublicKeyJwk|.
@@ -324,7 +324,7 @@ HTTP message signatures
diff --git a/specification/flows/section/dictionaries.html b/specification/flows/section/dictionaries.html
index 726445e3..07dcb669 100644
--- a/specification/flows/section/dictionaries.html
+++ b/specification/flows/section/dictionaries.html
@@ -23,8 +23,8 @@
The `WalletAddressDetails` dictionary
`url`
- The original URL that the wallet address information was
- requested at. Keeping a reference to this URL
+ The original URL used to request the wallet address.
+ Keeping a reference to this URL
is useful as users may use proxied wallet addresses.
@@ -32,16 +32,16 @@ The `WalletAddressDetails` dictionary
The wallet address identifier.
`authServer`
- corresponds to the endpoint for the [=AS=] APIs.
+ Corresponds to the endpoint for the [=AS=] APIs.
`resourceServer`
- corresponds to the endpoint for the [=RS=] APIs.
+ Corresponds to the endpoint for the [=RS=] APIs.
`assetCode`
- corresponds to [=asset code=].
+ Corresponds to [=asset code=].
`assetScale`
- corresponds to [=asset scale=].
+ Corresponds to [=asset scale=].
`publicName`
The public name associated with the wallet address, if available.
diff --git a/specification/flows/section/status.html b/specification/flows/section/status.html
index 15cc5539..cbe78263 100644
--- a/specification/flows/section/status.html
+++ b/specification/flows/section/status.html
@@ -23,7 +23,7 @@ Monetization status
Document monetization restrictions
- Document monetization disabled
+ Document monetization disabled happens
given a |document:Document| if either of the following conditions apply:
@@ -44,7 +44,7 @@ Document monetization restrictions
Wallet address restrictions
- Wallet monetization restricted
+ Wallet monetization restricted happens
given a |document:Document| and a [=wallet address=] |walletAddress:DOMString|
if the `monetization-src` directive
in the [=content security policy=] of the |document| restricts the |walletAddress|'s [=origin=].
diff --git a/specification/flows/section/storage.html b/specification/flows/section/storage.html
index 10286f82..a278ed1a 100644
--- a/specification/flows/section/storage.html
+++ b/specification/flows/section/storage.html
@@ -83,7 +83,7 @@
Storage operations
To get storage :
Let |storage| be the {{Storage}} instance from secure browser storage.
- If no stored storage exists, return a new {{Storage}} with all properties set to null.
+ If no stored {{Storage}} exists, return a new {{Storage}} with all properties set to null.
Return |storage|.
diff --git a/specification/flows/section/terms.html b/specification/flows/section/terms.html
index 8dbe54f7..3d5cbcd0 100644
--- a/specification/flows/section/terms.html
+++ b/specification/flows/section/terms.html
@@ -17,7 +17,7 @@ Terms
Grants
- A delegation of authorization from a resource owner to a client, allowing the client to access protected resources or perform actions on the owner’s behalf. In Rafiki, this process is managed by the authorization server, which issues grants as access tokens. These grants permit clients to interact with Open Payments APIs to, for example, create payments and retrieve account information, based on the permissions granted by the resource owner.
+ As per GNAP, a delegation of authorization from a resource owner to a client, allowing the client to access protected resources or perform actions on the owner’s behalf. In Rafiki, this process is managed by the authorization server, which issues grants as access tokens. These grants permit clients to interact with Open Payments APIs to, for example, create payments and retrieve account information, based on the permissions granted by the resource owner.
Web monetized website
Describes a page/site that has implemented Web Monetization.
@@ -44,7 +44,7 @@ Terms
Wallet
- An account within the [=web monetization provider=] or [=web monetization receiver=].
+ An account within a [=web monetization provider=] or [=web monetization receiver=].
Wallet address
diff --git a/specification/flows/section/wallet-setup.html b/specification/flows/section/wallet-setup.html
index a1543eec..86ba02d3 100644
--- a/specification/flows/section/wallet-setup.html
+++ b/specification/flows/section/wallet-setup.html
@@ -8,7 +8,7 @@ Terms
Web Monetization page
Refers to the browser's UI for managing Web Monetization settings, accessible via a browser specific URI.
- In Chromium based browser the page can be located at `chrome://webmonetization`.
+ In Chromium based browsers, the page can be located at `chrome://webmonetization`.
Web Monetization setup page
@@ -44,7 +44,7 @@ Connecting a wallet
running the [=generate an Ed25519 key pair=] algorithm, replacing any previously stored key pair, and MUST display
the newly generated [=encoded public key JWK=] (representing the [=Ed25519 public key=]) so the user can copy or
upload it to their wallet provider. This key generation and public key
- exposure happen before invoking the algorithm below; if no key pair exists at invocation time the algorithm fails.
+ exposure happen before invoking the algorithm below; if no key pair exists at invocation time, the algorithm fails.
To process the wallet setup , given a string |walletAddress:DOMString|
(the [=wallet address=] provided by the user),
@@ -70,7 +70,7 @@
Connecting a wallet
Let |interval:DOMString| be an ISO 8601 repeating interval
if |renewMonthly| is `true`.
- The starting date for the repeating interval needs to be the users current date (ISO String).
+ The starting date for the repeating interval needs to be the user's current date (ISO String).