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.
    1. 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.
      1. 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:
        1. 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

        2. Set |jwk|.kid to |keyId|.
        2. -
      2. Let |json:DOMString| be the UTF-8 JSON serialization of |jwk|.
        3. -
      3. Let |encodedPublicKeyJwk:DOMString| be |json| base64 encoded per [[RFC4648]].
        4. +
      4. Let |jsonJwk:DOMString| be the UTF-8 JSON serialization of |jwk|.
        5. +
      5. Let |encodedPublicKeyJwk:DOMString| be |jsonJwk| base64 encoded per [[RFC4648]].
      6. 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:

    1. Let |storage| be the {{Storage}} instance from secure browser storage.
      2. -
    2. If no stored storage exists, return a new {{Storage}} with all properties set to null.
      3. +
    3. If no stored {{Storage}} exists, return a new {{Storage}} with all properties set to null.
    4. 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).