Skip to content

⚓ Reference Anchor Fundamentals page#2448

Open
JFWooten4 wants to merge 6 commits into
stellar:mainfrom
JFWooten4:723-pt-15
Open

⚓ Reference Anchor Fundamentals page#2448
JFWooten4 wants to merge 6 commits into
stellar:mainfrom
JFWooten4:723-pt-15

Conversation

@JFWooten4

Copy link
Copy Markdown
Contributor

This continues the work from #2446, inlining the protocol/SEP links, while adding a great vid introducing users to anchors and their role with assets such as those used in SEP6 and -2243 discussed later on in the page. It also rebuilds the routes to account for some structural changes modified in #2447. For some reason, the files around there were added previously but not pathfound, and the Actions check didn't catch it.

JFWooten4 and others added 4 commits May 12, 2026 21:43
Co-authored-by: Codex <noreply@openai.com>
Co-authored-by: Codex <noreply@openai.com>
Co-authored-by: Codex <noreply@openai.com>
Copilot AI review requested due to automatic review settings May 13, 2026 02:37

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

Updates the Anchors fundamentals page to improve onboarding (adds an embedded intro video and inlines key SEP links), and regenerates exported site routes to reflect Anchor Platform API reference route changes.

Changes:

  • Embedded a YouTube explainer video on the Anchors fundamentals page.
  • Replaced SEP reference-style links with explicit inline links and refreshed the SEP-6 vs SEP-24 section heading.
  • Updated routes.txt with newly generated API reference routes for Anchor Platform.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.

File Description
routes.txt Adds newly generated routes for Anchor Platform API reference “callbacks-server” and “platform-server” paths.
docs/learn/fundamentals/anchors.mdx Embeds a YouTube intro video and inlines key SEP links in a note block.

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

Comment thread docs/learn/fundamentals/anchors.mdx Outdated
JFWooten4 and others added 2 commits May 12, 2026 22:53
Co-authored-by: Codex <noreply@openai.com>
Co-authored-by: Codex <noreply@openai.com>
@JFWooten4

Copy link
Copy Markdown
Contributor Author

I dropped the routes.txt changes in 11e0727 for the generated *.info.mdx API pages. Those callbacks-server and platform-server routes are not published in the normal build because the repo’s API generation flow removes the .info.mdx files. The existing category routes are the intended pages, so leaving the generated routes out is fine.

@ElliotFriend ElliotFriend left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

pretty good improvements, overall. couple notes and questions. thanks!!

Read more about SEPs in the [SEPs section](../fundamentals/stellar-ecosystem-proposals.mdx).

For anchors, the most important SEPs are [SEP-6]: Programmatic Deposit and Withdrawal, [SEP-24]: Hosted Deposit and Withdrawal, and [SEP-31]: Cross Border Payments API. You’ll also work with [SEP-10]: Stellar Authentication, [SEP-12]: KYC API, and [SEP-38]: Anchor RFQ API.
:::note

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Suggested change
:::note
:::info

info box might fit more nicely with this particular callout

Comment on lines +40 to +42
- [SEP-10](https://github.com/stellar/stellar-protocol/blob/master/ecosystem/sep-0010.md): Stellar Authentication
- [SEP-12](https://github.com/stellar/stellar-protocol/blob/master/ecosystem/sep-0012.md): KYC API
- [SEP-38](https://github.com/stellar/stellar-protocol/blob/master/ecosystem/sep-0038.md): Anchor RFQ API

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

it looks like the anchor definitions you've removed weren't all used on the original page, but it's probably good to include SEPs 1 and 9 on this "also work with" list.

:::

### Using SEP-6: Programmatic Deposit and Withdrawal versus SEP-24: Hosted Deposit and Withdrawal
### Using SEP-6 vs. SEP-24

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

the original is pretty verbose, but in the sidebar on the page, bare "SEP-6 vs. SEP-24" might not give enough context for someone not-as-familiar with them. maybe we could find a middle ground like "Using Programmatic SEP-6 vs. Hosted SEP-24 Transfers"? that doesn't sound quite perfect, but gets a little closer maybe?

<YouTube ID="9iN9XT1rHHA" />

An anchor is a Stellar-specific term for the on and off-ramps that connect the Stellar network to traditional financial rails, such as financial institutions or fintech companies. Anchors accept deposits of fiat currencies (such as the US dollar, Argentine peso, or Nigerian naira) via existing rails (such as bank deposits or cash-in points), then sends the user the equivalent digital tokens on the Stellar network. The equivalent digital tokens can either represent that same fiat currency or another digital token altogether. Alternatively, anchors allow token holders to redeem their tokens for the real-world assets they represent.
An anchor connects the Stellar network to traditional financial rails, such as financial institutions or fintech companies. Anchors accept deposits of fiat currencies (such as the US dollar, Argentine peso, or Nigerian naira) via existing rails (such as bank deposits or cash-in points), then send the user the equivalent digital tokens on the Stellar network. The equivalent digital tokens can either represent that same fiat currency or another digital token altogether. Alternatively, anchors allow token holders to redeem their tokens for the real-world assets they represent.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

it probably is useful to keep the wording about "on and off-ramps" since that's the more common "industry standard" language that's used. grounding the discussion of anchors in a familiar headspace for readers at least at the beginning probably serves us well.

# Anchors

## Overview
<YouTube ID="9iN9XT1rHHA" />

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

i know we don't have many videos on the docs site currently (outside the dev meetings). i do like the idea of adding them, and this seems like as good a page as any to take that step on. just want to make sure (i don't remember at the moment), your <YouTube> component doesn't auto-play the video, does it?

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.

3 participants