Skip to content

Transport strawman ladder - #35

Open
zealsham wants to merge 1 commit into
fungi-protocol:mainfrom
zealsham:transport-strawman
Open

zealsham wants to merge 1 commit into
fungi-protocol:mainfrom
zealsham:transport-strawman

Conversation

@zealsham

Copy link
Copy Markdown

This document describes the transport mechanism of fungi as a strawman ladder.

@zealsham zealsham changed the title Transport strawmand ladder Transport strawman ladder Sep 11, 2026
@arminsabouri

arminsabouri commented Sep 11, 2026

Copy link
Copy Markdown
Collaborator

@bc1cindy @0xZaddyy this document should describe largely your work so far. please review in that lense

Comment thread transport-strawman.md Outdated

### Target scales

The Desing follows two main rules.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Suggested change
The Desing follows two main rules.
The design follows two main rules.

Comment thread transport-strawman.md Outdated
| Mobile friendliness | poor (long-lived circuits, background connectivity) | good (stateless, tolerates intermittent connectivity) |
| Bandwidth overhead | circuit maintenance, cover traffic negligible | per-request relay headers |

Framing costs 4 bytes per message on stream transports. The channel contract deliberately exposes no ordering across channels and no deduplication to kep the sneakernet degradation requirement.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Suggested change
Framing costs 4 bytes per message on stream transports. The channel contract deliberately exposes no ordering across channels and no deduplication to kep the sneakernet degradation requirement.
Framing costs 4 bytes per message on stream transports. The channel contract deliberately exposes no ordering across channels and no deduplication to keep the sneakernet degradation requirement.

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.

Thanks for catching that, i'll fix it

@bc1cindy bc1cindy 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 might be partly at fault here for mixing the expositional purpose of the outline with the implementation i've been working on (which was pretty useful)

but the idea of this doc is to be an expositional outline and this reads more like a spec, even though the design hasn't stabilized yet

I believe a good path would be to rewrite the outline using only high-level bullets to guide the actual writing, like explaining the progression of communication patterns and their trade-offs

please take a look at this comment this should be for expositional purposes, no need to go into details

@zealsham

zealsham commented Sep 12, 2026

Copy link
Copy Markdown
Author

I might be partly at fault here for mixing the expositional purpose of the outline with the implementation i've been working on (which was pretty useful)

but the idea of this doc is to be an expositional outline and this reads more like a spec, even though the design hasn't stabilized yet

I believe a good path would be to rewrite the outline using only high-level bullets to guide the actual writing, like explaining the progression of communication patterns and their trade-offs

please take a look at this comment this should be for expositional purposes, no need to go into details

i agree that some technical details spilled into the doc , as i strictly followed the outline. However in some places a reader actually do need to understand the technical reason behind a solution being problematic. i'll keep the technicalities for such cases and remove it where its not needed.

This document describes the transport mechanism of fungi as a strawman ladder.
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.

3 participants