Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

📝 Refresh six classic guides #723

Draft
wants to merge 99 commits into
base: main
Choose a base branch
from
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
99 commits
Select commit Hold shift + click to select a range
a125983
🔁 Channel accounts: explain resolutions
JFWooten4 Jun 20, 2024
01424db
🔁 Channel accounts: simplify narrative
JFWooten4 Jun 22, 2024
37e38c3
🔁 Channel accounts: specify cards
JFWooten4 Jun 23, 2024
9ed2a0a
🔁 Channel accounts: finalize visuals
JFWooten4 Jun 23, 2024
44309a2
🔁 Channel accounts: simplify narrative
JFWooten4 Jun 26, 2024
dd7d761
🔁 Channel accounts: expand details
JFWooten4 Jun 26, 2024
c4a46dc
Merge branch 'stellar:main' into refresh-classic-guides
JFWooten4 Jul 5, 2024
68f165d
🔁 Channel accounts: hyperlinks, context
JFWooten4 Jul 7, 2024
07e613a
🔁 Channel accounts: initial diagrams
JFWooten4 Jul 9, 2024
bf6e15f
🔁 Channel accounts: reference configuration
JFWooten4 Jul 9, 2024
15d1288
🔁 Channel accounts: KaTeX formatting
JFWooten4 Jul 10, 2024
b874bc7
🔁 Channel accounts: context, links
JFWooten4 Jul 10, 2024
e290fb3
🔁 Channel accounts: conceptual images
JFWooten4 Jul 12, 2024
1f8a904
🔁 Channel accounts: simplify image
JFWooten4 Jul 12, 2024
46f49c6
🔁 Channel accounts: prioritize readability
JFWooten4 Jul 14, 2024
3f2e731
🔁 Channel accounts: overload example
JFWooten4 Jul 14, 2024
8a3d963
🔁 Channel accounts: configuration example
JFWooten4 Jul 15, 2024
cd7f447
🫴🏽 Claimable balances: first example
JFWooten4 Jul 18, 2024
e2248db
🫴🏽 Claimable balances: second example
JFWooten4 Jul 29, 2024
1992240
🫴🏽 Claimable balances: third example
JFWooten4 Jul 29, 2024
ee6175a
🫴🏽 Claimable balances: expand precomputation
JFWooten4 Aug 2, 2024
95ffe3c
🔎 Refresh: asset design considerations
JFWooten4 Aug 5, 2024
d93ae63
🦞 Clawbacks: confer readable diction
JFWooten4 Aug 5, 2024
e1611fc
🦞 Clawbacks: minor example diction
JFWooten4 Aug 5, 2024
03ac66d
🦞 Clawbacks: format account names
JFWooten4 Aug 5, 2024
86f3ca8
🦞 Clawbacks: format more names
JFWooten4 Aug 5, 2024
d1a9252
🦞 Clawbacks: apply name diction
JFWooten4 Aug 5, 2024
eb0e9be
🦞 Clawbacks: translate preamble example
JFWooten4 Aug 6, 2024
f4ad468
🦞 Clawbacks: expand example one
JFWooten4 Aug 6, 2024
e72e4a8
🦞 Clawbacks: translate next instances
JFWooten4 Aug 6, 2024
09fa456
🦞 Clawbacks: continue example dev
JFWooten4 Aug 6, 2024
b3e3230
💱 Trading examples: add lumenaut
JFWooten4 Aug 8, 2024
ee66e13
⏬ Prep for GH sync
JFWooten4 Aug 12, 2024
364f656
Merge remote-tracking branch 'upstream/main' into refresh-classic-guides
JFWooten4 Aug 12, 2024
6e866b7
Merge remote-tracking branch 'upstream/main' into refresh-classic-guides
JFWooten4 Aug 21, 2024
080ec03
💱 Trading examples: clarify narrative
JFWooten4 Sep 13, 2024
b529869
💱 Trading examples: contextualize sources
JFWooten4 Sep 13, 2024
127142e
↕️ Merge branch with self
JFWooten4 Sep 13, 2024
fea178f
🙌 Missed a reference link
JFWooten4 Sep 13, 2024
1a12877
💱 Trading examples: sell offers
JFWooten4 Sep 16, 2024
550b941
💱 Trading examples: level two
JFWooten4 Sep 16, 2024
fff2713
💱 Trading examples: time & sales
JFWooten4 Sep 16, 2024
06d249d
Merge remote-tracking branch 'upstream/main' into refresh-classic-guides
JFWooten4 Sep 30, 2024
4658706
🔁 Sync, move work items
JFWooten4 Sep 30, 2024
760d423
🔁 Clarify channel context links
JFWooten4 Oct 1, 2024
3d30353
🔁 Further advance text flow
JFWooten4 Oct 4, 2024
f6691fa
🔁 Start last code examples
JFWooten4 Oct 7, 2024
b273d71
🔁 Remove random channel generation
JFWooten4 Oct 7, 2024
954210d
🔁 Rest of authorization example
JFWooten4 Oct 7, 2024
ce8d61e
🔁 Remove adding channel custody
JFWooten4 Oct 7, 2024
7cb4b01
🔁 Clear up last tasks
JFWooten4 Oct 7, 2024
56c608a
🔁 Start state rotation example
JFWooten4 Oct 7, 2024
f83f4ad
🔁 Temporary merge, nonfinal publication
JFWooten4 Oct 11, 2024
1a91082
🔗 Minimum compilation link requirements
JFWooten4 Oct 15, 2024
11555a0
🖌️ Prettier compilation demo fixes
JFWooten4 Oct 15, 2024
d521205
🔁 Clarify base fee, miscellaneous 🤝🏻
JFWooten4 Oct 16, 2024
33f342e
Merge branch 'stellar:main' into refresh-classic-guides
JFWooten4 Oct 17, 2024
09fffca
👽 Translate java to JS
JFWooten4 Oct 19, 2024
03d2199
🔁 Last example java & go
JFWooten4 Oct 22, 2024
1c8851d
Merge branch 'stellar:main' into refresh-classic-guides
JFWooten4 Oct 22, 2024
cb9687a
🔁 Closing example explanation, diagrams
JFWooten4 Oct 22, 2024
06183cc
🔁 Put back `set timeouts`
JFWooten4 Oct 22, 2024
cbe3aca
🔁 Cleanup remaining frame items
JFWooten4 Oct 23, 2024
b45f8b2
🔁 Comment active-tense transitive verbs
JFWooten4 Oct 23, 2024
a73d966
🔁 Finalize the story flow
JFWooten4 Oct 23, 2024
a3c5d64
🔁 Polish off minor syntax
JFWooten4 Oct 23, 2024
eac05da
🔗 Remove depricated community link
JFWooten4 Oct 27, 2024
91b40fd
🔎 Clarify note on trustlines
JFWooten4 Oct 27, 2024
7109cb5
🫴🏽 Finish most cleaning up
JFWooten4 Nov 4, 2024
320de48
Merge branch 'main' into refresh-classic-guides
JFWooten4 Nov 4, 2024
0948700
🔗 Update simplified syntax reference
JFWooten4 Nov 4, 2024
19fbf45
🦞 Clean up final examples
JFWooten4 Nov 4, 2024
75a3ea0
💱 Remove items explicitly moved
JFWooten4 Nov 5, 2024
9bc3c63
💱 Remove duplicate placeholder drafts
JFWooten4 Nov 5, 2024
2a2638c
💱 Sidebar section intro description
JFWooten4 Nov 5, 2024
9d01898
💱 First rewrite run through
JFWooten4 Nov 6, 2024
32455bb
💱 Clean up scaffolding leftovers
JFWooten4 Nov 19, 2024
da7e8a3
💱 Translate starting AMM preamble
JFWooten4 Nov 19, 2024
a5c1874
💱 Capital pool > liquidity pool
JFWooten4 Nov 19, 2024
f8a304f
💱 Translate two AMM steps
JFWooten4 Nov 20, 2024
535b09b
📍 Follow up on this
JFWooten4 Nov 24, 2024
be7abb0
💱 Translate removing AMM liquidity
JFWooten4 Nov 24, 2024
eb18115
💱 Translate Java wrap-up example
JFWooten4 Nov 24, 2024
f871bab
💱 Last legacy, 535b09babed7a2afef37d58250f13ff01c2544fa fix
JFWooten4 Nov 24, 2024
b7f4a07
💱 Clean up go conclusion
JFWooten4 Nov 24, 2024
5492eb3
📌 Simplify starting frame, independence
JFWooten4 Nov 24, 2024
80784d8
💱 Seperate preliminary config, example
JFWooten4 Nov 25, 2024
f1a50e2
🖌️ Update prettier config note
JFWooten4 Nov 26, 2024
a4bdaeb
💱 Optimize, clarify global declarations
JFWooten4 Nov 26, 2024
ddd80c6
Merge branch 'main' into refresh-classic-guides
JFWooten4 Dec 6, 2024
81efcf5
💱 DEX code examples setup
JFWooten4 Dec 8, 2024
c7865bb
💱 Initial sell offer examples
JFWooten4 Dec 8, 2024
1f31ba4
💱 Example resolving limit OB
JFWooten4 Dec 8, 2024
34fb3b0
💱 Pricing point local calculation
JFWooten4 Dec 9, 2024
8417495
💱 Start prepping final flow
JFWooten4 Dec 10, 2024
d6d2335
💱 Continue on the intro
JFWooten4 Dec 11, 2024
2dc7db6
💱 Start of execution chat
JFWooten4 Dec 12, 2024
7f9bdc6
💱 Migrate some ancillary points
JFWooten4 Dec 12, 2024
909911a
💱 Introduce the OB outreach
JFWooten4 Dec 12, 2024
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 1 addition & 3 deletions .prettierrc.js
Original file line number Diff line number Diff line change
@@ -1,12 +1,10 @@
module.exports = {
...require("@stellar/prettier-config"),
// This is mostly content, and prose wrap has a way of exploding markdown
// diffs. Override the default for a better experience.
overrides: [
{
files: "*.mdx",
options: {
proseWrap: "never",
proseWrap: "never", // Minimize `mdx` diffs with simpler content lines
},
},
],
Expand Down
2 changes: 1 addition & 1 deletion docs/build/guides/tokens/stellar-asset-contract.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -57,7 +57,7 @@ client.mint(...);

## Testing

Soroban Rust SDK provides an easy way to instantiate a Stellar Asset Contract tokens using `register_stellar_asset_contract_v2`. This function can be seen as the deployment of a generic token. It also allows you to manipulate flags on the issuer account like `AUTH_REVOCABLE` and `AUTH_REQUIRED`. In the following example, we are following the best practices outlined in the [Issuing and Distribution Accounts section](../../../tokens/control-asset-access.mdx#issuing-and-distribution-accounts):
Soroban Rust SDK provides an easy way to instantiate a Stellar Asset Contract tokens using `register_stellar_asset_contract_v2`. This function can be seen as the deployment of a generic token. It also allows you to manipulate flags on the issuer account like `AUTH_REVOCABLE` and `AUTH_REQUIRED`. In the following example, we are following the best practices outlined in the [Issuing and Distribution Accounts section](../../../tokens/control-asset-access.mdx#issuer-and-distributor-accounts):

```rust
#![cfg(test)]
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,8 @@ import { AttributeTable } from "@site/src/components/AttributeTable";

Creates, updates, or deletes a buy offer to trade assets. A buy offer specifies a certain amount of the buying asset that should be sold in exchange for the minimum quantity of the selling asset.

If an entire buy offer isn't fulfilled by existing liquidity, the remaining order volume gets converted to a sell offer representation internally.

See the [`Manage Buy Offer` errors](../../../errors/result-codes/operation-specific/manage-buy-offer.mdx).

<AttributeTable>
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
id: retrieve-an-order-book
title: "Retrieve an Order Book"
description: "The order book endpoint provides an order book's bids and asks and can be used in [streaming](https://developers.stellar.org/docs/data/horizon/api-reference/structure/streaming) mode."
description: "The order book endpoint provides an order book's bids and asks and can be used in streaming mode."
sidebar_label: "Retrieve an Order Book"
hide_title: true
hide_table_of_contents: true
Expand Down
12 changes: 11 additions & 1 deletion docs/data/horizon/api-reference/structure/pagination/README.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,8 @@ Each individual transaction, operation, ledger, etc. is returned as a record, an

To move between pages of a collection of records, use the links in the `next` and `prev` attributes nested under the top-level `_links` attribute.

---

<AttributeTable>

- ATTRIBUTE
Expand All @@ -39,7 +41,15 @@ To move between pages of a collection of records, use the links in the `next` an

</AttributeTable>

<CodeExample title="Example Request">
---

## Larger Queries

For fewer round trips, you can specify the `limit` parameter up to `200` to receive more items in each response. You can also lower it for calls with a smaller scope. Learn more in the [call arguments](./page-arguments.mdx).

## Example Request

<CodeExample>

```js
var StellarSdk = require("stellar-sdk");
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ import { CodeExample } from "@site/src/components/CodeExample";
- A designation of the order in which records should appear. Options include `asc`(ascending) or `desc` (descending). If this argument isn’t set, it defaults to `asc`.
- limit
- optional
- The maximum number of records returned. The limit can range from 1 to 200 - an upper limit that is hardcoded in Horizon for performance reasons. If this argument isn’t designated, it defaults to 10.
- The maximum number of records returned. The limit can range from 1 to 200&mdash;an upper limit that is hardcoded in Horizon for performance reasons. If this argument isn’t designated, it defaults to 10.

</AttributeTable>

Expand Down
2 changes: 1 addition & 1 deletion docs/data/rpc/api-reference/pagination.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ sidebar_position: 50
title: Pagination
---

Pagination in stellar-rpc is similar to pagination in Horizon.
Pagination in stellar-rpc is similar to [pagination in Horizon](../../horizon/api-reference/structure/pagination/README.mdx).

For methods which support it, the pagination arguments are passed as a final object argument with two values:

Expand Down
4 changes: 3 additions & 1 deletion docs/learn/encyclopedia/sdex/README.mdx
Original file line number Diff line number Diff line change
@@ -1,8 +1,10 @@
---
title: SDEX
title: Conversion Liquidity
sidebar_position: 90
---

import DocCardList from "@theme/DocCardList";

The Stellar network lets users trade in a free market using [priced orders](../../fundamentals/transactions/list-of-operations.mdx#manage-sell-offer), [path payments](../transactions-specialized/path-payments.mdx), and [automated market makers](./liquidity-on-stellar-sdex-liquidity-pools.mdx#liquidity-pools-amm). These features leverage both the SDEX orderbooks from Protocol 1 and liquidity pools from Protocol 18. To learn about how the native exchanges work together to enable seamless cross-asset transactions, see our [Path Payments Encyclopedia Entry](../transactions-specialized/path-payments.mdx).

<DocCardList />
Loading
Loading