Skip to content

book: Add an end-to-end first-transaction tutorial#631

Open
pacu wants to merge 1 commit into
mainfrom
docs/first-wallet-tutorial
Open

book: Add an end-to-end first-transaction tutorial#631
pacu wants to merge 1 commit into
mainfrom
docs/first-wallet-tutorial

Conversation

@pacu

@pacu pacu commented Jul 16, 2026

Copy link
Copy Markdown
Collaborator

Summary

Adds a "Sending your first transaction" tutorial continuing where the setup guide stops at zallet start: sync check → create account → derive address → receive (with the 10-confirmation untrusted-spendability reality check) → balance → send → track the operation id → inspect the result.

Every command's parameters follow the method signatures in zallet-core/src/components/json_rpc/methods.rs (including the multi-seed seedfp caveat on z_getnewaccount and z_sendmany's FullPrivacy default with its transparent-recipient failure mode), and JSON quoting follows the documented zallet rpc rules. Method semantics stay in the reference; the tutorial links to the Concepts pages (#629) and Troubleshooting (#628) instead of restating them — soft dependencies, nothing breaks if this merges first.

Closes #608. Part of #600.

Test plan

  • mdbook build succeeds with no warnings; page renders and is linked from SUMMARY
  • Each RPC invocation checked against the trait signature (parameter order, optionality, quoting)

AI disclosure

Written with AI assistance (Claude Fable 5, via Claude Code); Co-Authored-By metadata is on the commit. Reviewed by the PR author.

🤖 Generated with Claude Code

@pacu
pacu marked this pull request as ready for review July 16, 2026 21:23
@pacu
pacu requested review from Cosmos-Harry, nullcopy and nuttycom and removed request for nullcopy and nuttycom July 16, 2026 21:33
Extends the user guide past 'zallet start': sync check via
getwalletstatus, account creation (z_getnewaccount, with the
multi-seed seedfp caveat), address derivation
(z_getaddressforaccount), receiving (z_listunspent and the 10-conf
untrusted spendability default), balance (z_getbalanceforaccount),
sending (z_sendmany with the FullPrivacy default and the
privacy-policy failure mode), the async operation lifecycle
(z_getoperationstatus / z_getoperationresult), and inspection
(z_viewtransaction).

Every command's parameters follow the method signatures in
zallet-core/src/components/json_rpc/methods.rs, and JSON quoting
follows the documented zallet rpc rules. Method semantics stay in the
reference material; the tutorial links to the concepts pages and
troubleshooting instead of restating them.

Closes #608. Part of #600.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
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.

book: Extend the setup guide into an end-to-end first-wallet tutorial

2 participants