From 7991f2e2fd998336304dcdd144f58e26d23f8570 Mon Sep 17 00:00:00 2001
From: CryptoGing <92603694+CryptoGing@users.noreply.github.com>
Date: Fri, 20 Jan 2023 14:08:12 -0500
Subject: [PATCH 1/2] Add wallet_address to scopes

Added wallet_address to the available scopes, and made a number of formatting changes to make it more clear what scopes are needed for what methods.
---
 SDK_reference.md | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/SDK_reference.md b/SDK_reference.md
index d9541eb..3dfe508 100644
--- a/SDK_reference.md
+++ b/SDK_reference.md
@@ -58,7 +58,7 @@ type AuthResult = {
 
 ### `scopes`
 
-Available scopes: `username`, `payments`.
+Available scopes: `username`, `payments`, `wallet_address`.
 
 > **Not yet implemented**
 >
@@ -67,6 +67,7 @@ Available scopes: `username`, `payments`.
 > However, you should implement your app by only adding the scopes you need when calling `authenticate`.
 > Scopes support will be added before the general release of the Pi platform.
 
+<br />
 Here is a breakdown of various keys available on the `AuthResult['user']` object, and the scopes required for those keys
 to be present:
 
@@ -75,6 +76,16 @@ to be present:
 | `uid`      | An app-local identifier for the user. This is specific to this user, and this app. It will change if the user revokes the permissions they granted to your app. | (none) |
 | `username`   | The user's Pi username.      |   `username` |
 
+<br />
+
+Here is a breakdown of scopes with no return and methods requiring them:
+
+| Scope         | Description    | Methods Requiring Scope  |
+| -------------: | ------------- | :-------------: |
+| `payments`      | Gives permission to the app to create payments on the users behalf | `createPayment` |
+| `wallet_address` | Gives the app access to the users public wallet address | `createPayment` - App to User Payments|
+
+<br />
 ### `onIncompletePaymentFound`
 
 Signature: `(payment: PaymentDTO) => void`

From c456f6062ef42260a80165c33f4245947331b442 Mon Sep 17 00:00:00 2001
From: Jeremiah Joel Drains
 <243420544+jdrains110-beep@users.noreply.github.com>
Date: Mon, 20 Apr 2026 20:12:31 -0400
Subject: [PATCH 2/2] Potential fix for pull request finding

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
---
 SDK_reference.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/SDK_reference.md b/SDK_reference.md
index 3dfe508..f0c1db0 100644
--- a/SDK_reference.md
+++ b/SDK_reference.md
@@ -78,12 +78,12 @@ to be present:
 
 <br />
 
-Here is a breakdown of scopes with no return and methods requiring them:
+Here is a breakdown of scopes that do not add fields to `AuthResult['user']`, and the methods/flows that require them:
 
 | Scope         | Description    | Methods Requiring Scope  |
 | -------------: | ------------- | :-------------: |
-| `payments`      | Gives permission to the app to create payments on the users behalf | `createPayment` |
-| `wallet_address` | Gives the app access to the users public wallet address | `createPayment` - App to User Payments|
+| `payments`      | Gives permission to the app to create payments on the users behalf. This scope does not add any fields to `AuthResult['user']`. | `createPayment` |
+| `wallet_address` | Allows app-to-user payment flows that require the user's public wallet address. This value is not returned on `AuthResult['user']` by `authenticate`. | `createPayment` - App to User Payments |
 
 <br />
 ### `onIncompletePaymentFound`