Skip to content

docs: design and specify direct wallet transaction submission - #906

Open
czarcas7ic wants to merge 9 commits into
mainfrom
adam/wallet-transaction-submission
Open

docs: design and specify direct wallet transaction submission#906
czarcas7ic wants to merge 9 commits into
mainfrom
adam/wallet-transaction-submission

Conversation

@czarcas7ic

@czarcas7ic czarcas7ic commented Sep 5, 2026

Copy link
Copy Markdown
Contributor

Motivation

Wallet submission depends on a small set of lightwalletd providers, concentrating submission metadata and availability with those operators.

Solution

Add the design and specification for direct wallet submission through discovered Zakura P2P v2 nodes, using the existing mempool and gossip pipeline. The spec defines the wire contract, admission results, and initial wallet defaults while retaining lightwalletd fallback.

Regulation integration and node budgets remain pending the GetBlocks work. Tor continues through lightwalletd until the separate HTTP follow-on is available.

Testing

Markdown lint, codespell, document reference checks, wire size/vector checks, and staged whitespace checks passed. Cursor reports no errors or warnings. Runtime tests were not run because this PR changes documentation only.

Changelog

Not required for a documentation-only change.

@czarcas7ic czarcas7ic added the documentation Improvements or additions to documentation label Sep 5, 2026
@czarcas7ic

Copy link
Copy Markdown
Contributor Author

@codex review

@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Sep 5, 2026

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review Completed 2026-09-06T20:37:12.251471Z ad70bc5 New commits
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 4851a6450e

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread docs/design/wallet-transaction-submission.md
Comment thread docs/design/wallet-transaction-submission.md Outdated
Comment on lines +299 to +301
Each participating node can expose the same `GetInfo` and `Submit` operations
over HTTPS. The adapter calls the same source-aware admission operation and
shares the native service's limits and result codes.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Define an abuse-resistant source identity for Tor HTTP

The native admission path can use the authenticated Zakura peer ID for its per-peer accounting, but an HTTPS request through Tor has no equivalent client identity: a clearnet endpoint sees a shared exit address, while an onion-service adapter generally sees the local Tor service, and a client-supplied identifier is freely rotatable. Therefore the HTTP adapter cannot simply call the same source-aware operation and preserve the promised per-peer/source-group fairness; it will either throttle unrelated Tor users together or let attackers reset their limits. Specify the HTTP source model and which limits apply before requiring shared admission semantics.

Useful? React with 👍 / 👎.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Lets save this for later

@czarcas7ic
czarcas7ic marked this pull request as ready for review September 5, 2026 19:59
@czarcas7ic czarcas7ic changed the title docs: design direct wallet transaction submission docs: design and specify direct wallet transaction submission Sep 6, 2026
chatgpt-codex-connector[bot]

This comment was marked as resolved.

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

None yet

Development

Successfully merging this pull request may close these issues.

1 participant