Skip to content

SDP-1637 embedded wallets docs#2187

Open
marwen-abid wants to merge 3 commits intomainfrom
sdp/SDP-1637-embedded-wallets-docs
Open

SDP-1637 embedded wallets docs#2187
marwen-abid wants to merge 3 commits intomainfrom
sdp/SDP-1637-embedded-wallets-docs

Conversation

@marwen-abid
Copy link
Contributor

No description provided.

Copilot AI review requested due to automatic review settings January 20, 2026 04:55
@marwen-abid marwen-abid self-assigned this Jan 20, 2026
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This pull request adds comprehensive documentation for the Embedded Wallets feature in the Stellar Disbursement Platform (SDP). Embedded Wallets enable receivers to receive disbursements using passkey-secured smart contract wallets without needing to download a separate wallet application.

Changes:

  • Added new embedded-wallets.mdx documentation explaining the feature, its benefits, and step-by-step usage guide
  • Added Embedded Wallets configuration section to advanced-configuration.mdx with backend, TSS, and frontend setup instructions
  • Added screenshot image (SDP48.png) showing the verification prompt interface
  • Fixed list formatting in the Distribution Account configuration section

Reviewed changes

Copilot reviewed 2 out of 5 changed files in this pull request and generated 4 comments.

File Description
embedded-wallets.mdx New comprehensive guide covering embedded wallets introduction, passkey technology, workflow, prerequisites, and usage steps
advanced-configration.mdx Added embedded wallets configuration section with environment variables for backend, TSS, and frontend; fixed list formatting
SDP48.png New screenshot image showing the verification interface for embedded wallets

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@stellar-jenkins
Copy link

1 similar comment
@stellar-jenkins
Copy link

@github-actions
Copy link
Contributor

github-actions bot commented Feb 4, 2026

Warning

This change removes routes. The diff of routes is below. Please verify that these changes to the routes are intentional and that redirects are in place if needed. Redirects can be added to nginx/includes/redirects.conf.

diff --git a/routes.txt b/routes.txt
index 1dff5f36..5046d891 100644
--- a/routes.txt
+++ b/routes.txt
@@ -600,7 +600,7 @@
 /docs/platforms/anchor-platform/sep-guide/sep6/integration
 /docs/platforms/stellar-disbursement-platform
 /docs/platforms/stellar-disbursement-platform/admin-guide
-/docs/platforms/stellar-disbursement-platform/admin-guide/advanced-configration
+/docs/platforms/stellar-disbursement-platform/admin-guide/advanced-configuration
 /docs/platforms/stellar-disbursement-platform/admin-guide/cli-manual
 /docs/platforms/stellar-disbursement-platform/admin-guide/configuring-sdp
 /docs/platforms/stellar-disbursement-platform/admin-guide/deploy-the-sdp

@stellar-jenkins
Copy link

@marwen-abid marwen-abid force-pushed the sdp/SDP-1637-embedded-wallets-docs branch from d3c5c1a to 9bc07f3 Compare February 4, 2026 22:20
@github-actions
Copy link
Contributor

github-actions bot commented Feb 4, 2026

Warning

This change removes routes. The diff of routes is below. Please verify that these changes to the routes are intentional and that redirects are in place if needed. Redirects can be added to nginx/includes/redirects.conf.

diff --git a/routes.txt b/routes.txt
index 1dff5f36..5d178438 100644
--- a/routes.txt
+++ b/routes.txt
@@ -600,11 +600,12 @@
 /docs/platforms/anchor-platform/sep-guide/sep6/integration
 /docs/platforms/stellar-disbursement-platform
 /docs/platforms/stellar-disbursement-platform/admin-guide
-/docs/platforms/stellar-disbursement-platform/admin-guide/advanced-configration
+/docs/platforms/stellar-disbursement-platform/admin-guide/advanced-configuration
 /docs/platforms/stellar-disbursement-platform/admin-guide/cli-manual
 /docs/platforms/stellar-disbursement-platform/admin-guide/configuring-sdp
 /docs/platforms/stellar-disbursement-platform/admin-guide/deploy-the-sdp
 /docs/platforms/stellar-disbursement-platform/admin-guide/design-and-architecture
+/docs/platforms/stellar-disbursement-platform/admin-guide/embedded-wallets
 /docs/platforms/stellar-disbursement-platform/admin-guide/getting-started
 /docs/platforms/stellar-disbursement-platform/admin-guide/making-your-wallet-sdp-ready
 /docs/platforms/stellar-disbursement-platform/admin-guide/monitoring

@stellar-jenkins
Copy link

@marwen-abid marwen-abid force-pushed the sdp/SDP-1637-embedded-wallets-docs branch from 9bc07f3 to f183a82 Compare February 4, 2026 22:32
@github-actions
Copy link
Contributor

github-actions bot commented Feb 4, 2026

Warning

This change removes routes. The diff of routes is below. Please verify that these changes to the routes are intentional and that redirects are in place if needed. Redirects can be added to nginx/includes/redirects.conf.

diff --git a/routes.txt b/routes.txt
index 1dff5f36..5d178438 100644
--- a/routes.txt
+++ b/routes.txt
@@ -600,11 +600,12 @@
 /docs/platforms/anchor-platform/sep-guide/sep6/integration
 /docs/platforms/stellar-disbursement-platform
 /docs/platforms/stellar-disbursement-platform/admin-guide
-/docs/platforms/stellar-disbursement-platform/admin-guide/advanced-configration
+/docs/platforms/stellar-disbursement-platform/admin-guide/advanced-configuration
 /docs/platforms/stellar-disbursement-platform/admin-guide/cli-manual
 /docs/platforms/stellar-disbursement-platform/admin-guide/configuring-sdp
 /docs/platforms/stellar-disbursement-platform/admin-guide/deploy-the-sdp
 /docs/platforms/stellar-disbursement-platform/admin-guide/design-and-architecture
+/docs/platforms/stellar-disbursement-platform/admin-guide/embedded-wallets
 /docs/platforms/stellar-disbursement-platform/admin-guide/getting-started
 /docs/platforms/stellar-disbursement-platform/admin-guide/making-your-wallet-sdp-ready
 /docs/platforms/stellar-disbursement-platform/admin-guide/monitoring

@stellar-jenkins
Copy link

@marwen-abid marwen-abid force-pushed the sdp/SDP-1637-embedded-wallets-docs branch from f183a82 to a79b3fb Compare February 5, 2026 11:48
@github-actions
Copy link
Contributor

github-actions bot commented Feb 5, 2026

Warning

This change removes routes. The diff of routes is below. Please verify that these changes to the routes are intentional and that redirects are in place if needed. Redirects can be added to nginx/includes/redirects.conf.

diff --git a/routes.txt b/routes.txt
index 36f2a094..a938acb2 100644
--- a/routes.txt
+++ b/routes.txt
@@ -600,11 +600,12 @@
 /docs/platforms/anchor-platform/sep-guide/sep6/integration
 /docs/platforms/stellar-disbursement-platform
 /docs/platforms/stellar-disbursement-platform/admin-guide
-/docs/platforms/stellar-disbursement-platform/admin-guide/advanced-configration
+/docs/platforms/stellar-disbursement-platform/admin-guide/advanced-configuration
 /docs/platforms/stellar-disbursement-platform/admin-guide/cli-manual
 /docs/platforms/stellar-disbursement-platform/admin-guide/configuring-sdp
 /docs/platforms/stellar-disbursement-platform/admin-guide/deploy-the-sdp
 /docs/platforms/stellar-disbursement-platform/admin-guide/design-and-architecture
+/docs/platforms/stellar-disbursement-platform/admin-guide/embedded-wallets
 /docs/platforms/stellar-disbursement-platform/admin-guide/getting-started
 /docs/platforms/stellar-disbursement-platform/admin-guide/making-your-wallet-sdp-ready
 /docs/platforms/stellar-disbursement-platform/admin-guide/monitoring

@stellar-jenkins
Copy link


:::note

There is also a "No Verification" option, but using it is only recommended for low-risk scenarios due to security concerns (e.g. disbursing small amounts).
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It's called None in the UI.


:::danger

Each link is unique per receiver. Treat it as sensitive: if a link is leaked and you have **no verification** enabled, an attacker could create the receiver’s wallet and claim the funds. Skipping verification should only be done in low-risk scenarios and with small disbursement amounts.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We should also recommend having verification because it forces the user through SEP-45, which verifies that the passkey works before sending funds to them. We've seen some cases at Meridian where the accounts were created, funds disbursed, but the users were unable to transfer out due to issues with their passkeys.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants