Skip to content

docs(cli): document getroots, getpeerinfo, and uptime RPCs#1028

Merged
Davidson-Souza merged 1 commit into
getfloresta:masterfrom
Husteem:docs/rpc-cleanup-part1
May 18, 2026
Merged

docs(cli): document getroots, getpeerinfo, and uptime RPCs#1028
Davidson-Souza merged 1 commit into
getfloresta:masterfrom
Husteem:docs/rpc-cleanup-part1

Conversation

@Husteem
Copy link
Copy Markdown
Contributor

@Husteem Husteem commented May 5, 2026

Description and Notes

Adds RPC documentation for getroots, getpeerinfo, and uptime endpoints following the established template and tone of getblockchaininfo.md.

Part of #799

How to verify the changes done?

The documentation was verified against a live florestad node running on regtest. Field names, return types, and enum values (peer connection states, transport protocols) were cross-referenced with the Rust source in floresta-rpc and floresta-wire crates to confirm accuracy.

You can verify by running:

floresta-cli getroots
floresta-cli getpeerinfo
floresta-cli uptime

And comparing the output against the documented fields.

Contributor Checklist

@moisesPompilio
Copy link
Copy Markdown
Collaborator

You also need to pass this documentation through to floresta-cli and floresta-rpc

@moisesPompilio moisesPompilio self-requested a review May 5, 2026 13:48
@moisesPompilio moisesPompilio added the documentation Improvements or additions to documentation label May 5, 2026
@github-project-automation github-project-automation Bot moved this to Backlog in Floresta May 5, 2026
@moisesPompilio moisesPompilio added this to the Q2/2026 milestone May 5, 2026
@moisesPompilio moisesPompilio moved this from Backlog to Needs review in Floresta May 5, 2026
@jaoleal jaoleal self-requested a review May 5, 2026 20:45
Copy link
Copy Markdown
Member

@jaoleal jaoleal left a comment

Choose a reason for hiding this comment

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

Hi, thanks for taking some time on this...

Also, could you separate documentation per-rpc ? that would be 3 commits

Comment thread doc/rpc/getpeerinfo.md Outdated
- `state` - (string) The current state of this peer. Can be "Ready" (fully handshaked and active), "Awaiting" (still establishing connection), or "Banned" (connection rejected/dropped).
- `transport_protocol` - (string) The transport protocol used to communicate with the peer (e.g., "V1" or "V2").

### Error Enum `CommandError`
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
### Error Enum `CommandError`
### Error Enum

Comment thread doc/rpc/uptime.md Outdated

Returns a numeric value representing the number of seconds that the node has been running.

### Error Enum `CommandError`
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
### Error Enum `CommandError`
### Error Enum

Comment thread doc/rpc/getroots.md Outdated

Returns a JSON array of strings representing the actual hex-encoded roots of the utreexo accumulator.

### Error Enum `CommandError`
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
### Error Enum `CommandError`
### Error Enum

@jaoleal
Copy link
Copy Markdown
Member

jaoleal commented May 8, 2026

Can you make this a single commit ?

@Husteem
Copy link
Copy Markdown
Contributor Author

Husteem commented May 8, 2026

seems I'm mistaking what you mean.

do you mean this and #1027 ?
If not, please clarify. thanks!
@jaoleal

@jaoleal
Copy link
Copy Markdown
Member

jaoleal commented May 8, 2026

Squash this pr in a single commit

@Husteem Husteem force-pushed the docs/rpc-cleanup-part1 branch from d5f1f13 to 84b0a99 Compare May 12, 2026 14:45
@Husteem
Copy link
Copy Markdown
Contributor Author

Husteem commented May 12, 2026

hi, dose it looks good now?

@jaoleal
Copy link
Copy Markdown
Member

jaoleal commented May 13, 2026

You forgot to add them to floresta-rpc too

@jaoleal jaoleal moved this from Needs review to In progress in Floresta May 15, 2026
@Husteem Husteem force-pushed the docs/rpc-cleanup-part1 branch from 84b0a99 to 40cca42 Compare May 15, 2026 10:22
Copy link
Copy Markdown
Member

@jaoleal jaoleal left a comment

Choose a reason for hiding this comment

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

ACK 40cca42

Copy link
Copy Markdown
Collaborator

@moisesPompilio moisesPompilio left a comment

Choose a reason for hiding this comment

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

ACK 40cca42

Copy link
Copy Markdown
Member

@Davidson-Souza Davidson-Souza left a comment

Choose a reason for hiding this comment

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

ACK 40cca42

@Davidson-Souza Davidson-Souza merged commit 2b7a3b2 into getfloresta:master May 18, 2026
15 of 17 checks passed
@github-project-automation github-project-automation Bot moved this from In progress to Done in Floresta May 18, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

4 participants