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

Add the spec docs for the exchange module #1729

Merged
merged 24 commits into from
Nov 7, 2023

Conversation

SpicyLemon
Copy link
Contributor

@SpicyLemon SpicyLemon commented Nov 2, 2023

Description

closes: #1700

This PR includes the spec docs for the exchange module.

It also fixes a couple TOCs from other modules that got out of date.


Before we can merge this PR, please make sure that all the following items have been
checked off. If any of the checklist items are not applicable, please leave them but
write a little note why.

  • Targeted PR against correct branch (see CONTRIBUTING.md)
  • Linked to Github issue with discussion and accepted design OR link to spec that describes this work.
  • Wrote unit and integration tests
  • Updated relevant documentation (docs/) or specification (x/<module>/spec/)
  • Added relevant godoc comments.
  • Added a relevant changelog entry to the Unreleased section in CHANGELOG.md
  • Re-reviewed Files changed in the Github PR explorer
  • Review Codecov Report in the comment section below once CI passes

@SpicyLemon SpicyLemon requested a review from a team as a code owner November 2, 2023 00:15
@SpicyLemon SpicyLemon marked this pull request as draft November 2, 2023 00:15
@SpicyLemon SpicyLemon marked this pull request as ready for review November 2, 2023 19:58
@SpicyLemon SpicyLemon changed the title Dwedul/1700 exchange spec docs Add the spec docs for the exchange module. Nov 2, 2023
@SpicyLemon SpicyLemon changed the title Add the spec docs for the exchange module. Add the spec docs for the exchange module Nov 2, 2023
x/exchange/spec/03_messages.md Outdated Show resolved Hide resolved
@SpicyLemon SpicyLemon enabled auto-merge (squash) November 6, 2023 20:10
@SpicyLemon SpicyLemon merged commit 4aabad2 into main Nov 7, 2023
18 checks passed
@SpicyLemon SpicyLemon deleted the dwedul/1700-exchange-spec-docs branch November 7, 2023 20:13
SpicyLemon added a commit that referenced this pull request Nov 10, 2023
* [1700]: make update-tocs to fix some existing TOCs.

* [1700]: First crack at the exchange spec main README.

* [1700]: First crack at the concepts spec doc.

* [1700]: First crack at the state spec doc.

* [1700]: Add empty place-holder files for the rest of the exchange spec docs.

* [1700]: Initial write-up of messages spec doc.

* [1700]: Events spec doc.

* [1700]: Standardize the hr below the tocs.

* [1700]: in the messages spec doc, include more sub-message content and add link references to those sections.

* [1700]: Spec doc on the queries.

* [1700]: Params spec doc.

* [1700]: Turn lots of stuff into links and fix some inconsistent spacing.

* [1700]: Reorder some market state entries.

* [1700]: Add some missing blurbs under L1 headings. Remove the hrs above the L2 headings, and put a hr above each TOC. A L2 heading is underlined, so it looks weird when there's an hr above them too.

* [1700]: Some updates to concepts from proof-reading them. Should be pretty solid now.

* [1700]: Tweaks to state doc upon proof-reading.

* [1700]: Proof reading of messages spec.

* [1700]: Proof-read of the queries spec doc.

* [1700]: Small tweak to the params spec doc upon proofreading.

* Update x/exchange/spec/03_messages.md

Co-authored-by: Jason Talis <jason.talis@gmail.com>

---------

Co-authored-by: Jason Talis <jason.talis@gmail.com>
iramiller added a commit that referenced this pull request Nov 10, 2023
…1743)

* Add the spec docs for the exchange module (#1729)

* [1700]: make update-tocs to fix some existing TOCs.

* [1700]: First crack at the exchange spec main README.

* [1700]: First crack at the concepts spec doc.

* [1700]: First crack at the state spec doc.

* [1700]: Add empty place-holder files for the rest of the exchange spec docs.

* [1700]: Initial write-up of messages spec doc.

* [1700]: Events spec doc.

* [1700]: Standardize the hr below the tocs.

* [1700]: in the messages spec doc, include more sub-message content and add link references to those sections.

* [1700]: Spec doc on the queries.

* [1700]: Params spec doc.

* [1700]: Turn lots of stuff into links and fix some inconsistent spacing.

* [1700]: Reorder some market state entries.

* [1700]: Add some missing blurbs under L1 headings. Remove the hrs above the L2 headings, and put a hr above each TOC. A L2 heading is underlined, so it looks weird when there's an hr above them too.

* [1700]: Some updates to concepts from proof-reading them. Should be pretty solid now.

* [1700]: Tweaks to state doc upon proof-reading.

* [1700]: Proof reading of messages spec.

* [1700]: Proof-read of the queries spec doc.

* [1700]: Small tweak to the params spec doc upon proofreading.

* Update x/exchange/spec/03_messages.md

Co-authored-by: Jason Talis <jason.talis@gmail.com>

---------

Co-authored-by: Jason Talis <jason.talis@gmail.com>

* Fixed denom metadata source chain-id retrieval for new ibc markers (#1738)

* should be using packet dest port and channel to get the correct source chain id

* fix compile error

* add upgrade handler for rc3, add changelog

* add generated nav map

* Add upgrade handler to add marker navs for pio-mainnet-1 (#1712)

* add upgrade handler for net asset values

* add upgrade handler for nav

* add upgrade test

* add more test cases

* add changelog entry

* check iterate error

* add custom list processing, add a few examples for testnet

* fix default logic and change log

* fix test

* Add new navs for mainnet in list

* Update tests

* update method comment

* Rename update function, add detailed comments

---------

Co-authored-by: Ira Miller <72319+iramiller@users.noreply.github.com>

* Add additional trigger module logging (#1742)

* Add additional logging.

* Update logging to show success.

* Update changelog.

* Have exchange module update marker net-asset-value entries (#1741)

* [1736]: Properly wrap the errors in AddSetNetAssetValues.

* [1736]: Reorg SetNetAssetValue to emit the event last and create the key and store closer to where they're used.

* [1736]: Move the NAV event back up to earlier and add a comment on why its not at the end like most other events.

* [1736]: Add the marker keeper to the exchange keeper.

* [1736]: Generate and record the NAVs with the marker module after a settlement.

* [1736]: Unit tests on GetNAVs.

* [1736]: update GetNAVs to use asks if there aren't any bids.

* [1736]: Unit tests on the keeper changes and fix the ones that broke.

* [1736]: Update the msg server tests too.

* [1736]: Undo the marker keeper changes since it basically just boiled down to the addition of a comment.

* [1736]: Update the changelog to mark v1.17.0-rc2 and also include an entry for this PR.

---------

Co-authored-by: Ira Miller <72319+iramiller@users.noreply.github.com>

* Add additional trigger events (#1740)

* Create new events and generate protos.

* Add events to emit.

* Update tests for processing to test new dispatched event.

* Add tests for EventTriggerDetection.

* Update specs for events.

* Update changelog.

* Change EventTriggerExecuted to contain a success flag rather than an error string. It's possible for the error to be non-deterministic.

* Update assert.

---------

Co-authored-by: Ira Miller <72319+iramiller@users.noreply.github.com>

* Mark v1.17.0-rc3 in the changelog and release notes.

---------

Co-authored-by: Jason Talis <jason.talis@gmail.com>
Co-authored-by: Carlton Hanna <nullpointer0x00@gmail.com>
Co-authored-by: Ira Miller <72319+iramiller@users.noreply.github.com>
Co-authored-by: Matt Witkowski <mwitkowski@provenance.io>
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.

Exchange: Write spec docs
4 participants