Skip to content

docs: address review comments#918

Open
zero4862 wants to merge 1 commit into
NemProject:new-docsfrom
zero4862:docs-review-comments
Open

docs: address review comments#918
zero4862 wants to merge 1 commit into
NemProject:new-docsfrom
zero4862:docs-review-comments

Conversation

@zero4862

Copy link
Copy Markdown

Address review comments from @Jaguar0625 on June 18.

The <get:/namespace/mosaic/definition/page> endpoint returns one definition for each mosaic whose namespace matches
the queried name exactly.
Mosaics defined under deeper subnamespaces (such as `foo.bar:baz` when querying `foo`) are not included.
To list those as well, repeat this query for each subnamespace found in the previous step.

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

not sure if you should show them as part of the tutorial?

@Jaguar0625 I decided not to add it to keep the tutorial simple. They can always repeat the query with the subnamespaces they get on the previous step. I added some guidance, though.

@@ -80,134 +80,84 @@ The cycle repeats at the next block height.

## Harvesting Methods

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

This is the biggest edit now I understand the difference between remote harvesting and delegated harvesting.

Edited the section to make it more similar to Symbol, but decided to use a single term for "proxy account" and "remote account" for consistency -> "remote account". We might want to apply this edit to Symbol too.

A single Java process that implements all node functionality.

NIS has four parts: an [engine](#engine), exposed by a [REST API](#rest-api) and a [WebSocket](#websocket) service, with an embedded [database](#database) for storage.
NIS has four parts: an [engine](#engine), a [REST API](#rest-api), a [WebSocket](#websocket) service, and an embedded

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

i'd also tend to call engine something else, like pipeline.

@Jaguar0625 I decided to keep it as "engine" represents the hard work (consensus, harvesting, etc.), whereas "pipeline" suggests more of a pass-through layer.

I know there's no actual "engine" module in NIS, but I had to come up with this concept for explanation purposes to help illustrate how things connect.

Let me know if "engine" is OK, or if you would prefer me to look for another term.

{%- set ns.group_count = ns.group_count + 1 -%}
{%- endmacro %}

{# Renders a language-specific literal (e.g. Python True -> JavaScript true) as a language-switching dylink. #}

@zero4862 zero4862 Jun 30, 2026

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

Added to map format vars like True -> true when changing the language selector.
I'll review if it's necessary in Symbol and port it too.

Comment on lines +62 to +68
: <Key pair:|Key pair> associated with every <account:>.
Its private key identifies the account owner and grants full control over the account, including the ability to
transfer funds and announce transactions.

Remote Key
: Key pair associated with an account that has delegated harvesting to a remote node (see <harvesting:>).
The remote key signs blocks on behalf of the main account without exposing the main private key.
: <Key pair:|Key pair> associated with every <remote harvesting:> account.
It allows a node to harvest on behalf of another account without exposing the account's <main key:>.

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

Edited to match latest Symbol version.

@zero4862 zero4862 requested a review from segfaultxavi June 30, 2026 13:25
be converted into a multisig.
Multisig hierarchies are therefore **one layer deep**.

## Importance

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

Moved from "harvesting" as is.

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.

1 participant