Skip to content

[mkdocs] docs: add listen tx flow tutorial#916

Open
zero4862 wants to merge 4 commits into
NemProject:new-docsfrom
zero4862:docs-listen-transaction-flow
Open

[mkdocs] docs: add listen tx flow tutorial#916
zero4862 wants to merge 4 commits into
NemProject:new-docsfrom
zero4862:docs-listen-transaction-flow

Conversation

@zero4862

@zero4862 zero4862 commented Jun 29, 2026

Copy link
Copy Markdown

Adapts Listen tx flow tutorial to NEM and documents missing websocket channels and requests.

Comment thread mkdocs/config/mkdocs.base.yml
Comment thread mkdocs/pages/en/devbook/reference/websockets/index.md Outdated
Comment thread mkdocs/pages/en/devbook/reference/websockets/index.md
Comment thread mkdocs/pages/en/devbook/reference/websockets/index.md
@zero4862 zero4862 force-pushed the docs-listen-transaction-flow branch from 209c9cd to 50f1500 Compare June 29, 2026 11:15
@zero4862 zero4862 force-pushed the docs-listen-transaction-flow branch from 50f1500 to b936694 Compare June 29, 2026 11:48
Comment thread mkdocs/pages/en/devbook/reference/websockets/index.md Outdated
@zero4862 zero4862 marked this pull request as ready for review June 29, 2026 12:45
@zero4862 zero4862 requested a review from segfaultxavi June 29, 2026 12:46

@segfaultxavi segfaultxavi 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.

I have only reviewed the WebSocket reference page.
Apologies for spending so much time reviewing such a obscure corner of the docs, but I don't like the shape it has on Symbol and decided to fix it in this review.

I'll continue now to review the rest of the PR, but wanted to submit this early.

Comment thread mkdocs/pages/en/devbook/reference/websockets/index.md Outdated
Comment thread mkdocs/pages/en/devbook/reference/websockets/index.md Outdated
Comment thread mkdocs/pages/en/devbook/reference/websockets/index.md Outdated
Comment thread mkdocs/pages/en/devbook/reference/websockets/index.md Outdated
Comment thread mkdocs/pages/en/devbook/reference/websockets/index.md Outdated
Comment thread mkdocs/pages/en/devbook/reference/websockets/index.md Outdated
Comment thread mkdocs/pages/en/devbook/reference/websockets/index.md Outdated
Comment thread mkdocs/pages/en/devbook/reference/websockets/index.md Outdated
Comment thread mkdocs/pages/en/devbook/reference/websockets/index.md Outdated
Comment thread mkdocs/pages/en/devbook/reference/websockets/index.md Outdated

@segfaultxavi segfaultxavi 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.

Comments for the tutorial proper now.


NODE_URL = os.getenv('NODE_URL', 'http://libertalia.nemtest.net:7778')
print(f'Using node {NODE_URL}')
NODE_HOST = os.getenv('NODE_HOST', 'libertalia.nemtest.net')

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 understand this change simplifies creating URLs for the WebSocket tutorials, but I think this forces us to change ALL other tutorials to follow the same pattern.
Otherwise, different tutorials use different environment variables and it's a bit messy.

Do you want to apply this pattern to the rest of tutorials, including Symbol? :)

Comment on lines +16 to +17
NODE_URL = f'http://{NODE_HOST}:7890'
WS_URL = f'http://{NODE_HOST}:7778'

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
NODE_URL = f'http://{NODE_HOST}:7890'
WS_URL = f'http://{NODE_HOST}:7778'
NODE_REST_URL = f'http://{NODE_HOST}:7890'
NODE_WS_URL = f'http://{NODE_HOST}:7778'

For consistency.

Comment thread mkdocs/snippets/devbook/websockets/listen_transaction_flow.py
Comment thread mkdocs/snippets/devbook/websockets/listen_transaction_flow.py
Comment thread mkdocs/pages/en/devbook/websockets/listen-transaction-flow.md
Comment thread mkdocs/snippets/devbook/websockets/listen_transaction_flow.py
Comment thread mkdocs/pages/en/devbook/websockets/listen-transaction-flow.md
Comment thread mkdocs/pages/en/devbook/websockets/listen-transaction-flow.md

{{ tutorial.code_snippet_tagged('step-5') }}

This tutorial builds a minimal [Transfer Transaction](../transactions/transfer-xem.md) to the monitored address, with a

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 would make this link point to the Textbook, and then, below, instead of "as usual", I would say "following the same procedure as in the Transfer Transaction Tutorial", and include the tutorial link there.

Comment thread mkdocs/pages/en/devbook/websockets/listen-transaction-flow.md
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.

2 participants