💱 Trading Terms in Glossary - #2745
Conversation
Co-authored-by: Codex <noreply@openai.com>
There was a problem hiding this comment.
Pull request overview
Adds trading terminology to the glossary.
Changes:
- Defines atomic swaps with related documentation.
- Introduces SPEEDEX with research and proposal references.
Recommendation: NEEDS-CHANGES — remove the extraneous “default” wording.
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
|
|
||
| A decentralized method of exchanging one asset for another without the need for a trusted third-party intermediary. Atomic swaps allow the interchange to either complete fully for both parties or not at all, hence the term "atomic," meaning indivisible. If one party fails to fulfill the required conditions, the trade is automatically canceled and both parties retain their assets. | ||
|
|
||
| Learn more in the default [Liquidity on Stellar section](./fundamentals/liquidity-on-stellar-sdex-liquidity-pools.mdx) or an [Atomic Swap example contract](../build/smart-contracts/example-contracts/atomic-swap.mdx). |
There was a problem hiding this comment.
This is a heavy judgment call. While it wasn't in my original draft, it surfaced through comparison with the protocol's default atomic transaction execution. In a sentence comparing it to the DEX with a Soroban example, I believe it fits.
Namely, every asset always uses the DEX. Anyone can create a transaction for protocol liquidity using native operations. Comparatively, every smart contract requires at least overhead for initialization and (in practice) substantial differentiating networking to function.
Atomic swaps are a foundational concept for blockchain exchange. There has been some recent chatter about routers using non-atomic transactions. New readers should receive a point of reference for atomicity separate from transaction execution.
Also, SPEEDEX is a substantial network-specific research project. It's too nascent for its own page at this point, but it should be mentioned somewhere in the docs. This is the lowest point of friction to start.