docs: split wallet-evm and wallet-solana usage.md into how-to guides by ihsraham · Pull Request #105 · tetherto/wdk-docs

ihsraham · 2026-03-09T12:26:53Z

Summary

Addresses WDKDOCS-188 (wallet-evm) and WDKDOCS-190 (wallet-solana).

Split the monolithic usage.md for wallet-evm and wallet-solana into 7 distinct how-to guides each, following the pattern established by the core module guides.
Converted both usage.md files into hub pages with card tables linking to the new guides.
Updated SUMMARY.md to add sidebar navigation entries for all 14 new guides.

New Guides (per module)

Guide	wallet-evm	wallet-solana
Getting Started	Install + create wallet with RPC/EIP-1193	Install + create wallet with Solana RPC
Manage Accounts	Index-based + custom derivation paths	Index-based + custom derivation paths
Check Balances	Native + ERC-20 (owned and read-only)	SOL + SPL (owned and read-only)
Send Transactions	EIP-1559, legacy gas, fee estimation	Send SOL, fee estimation
Transfer Tokens	ERC-20 transfers with validation	SPL transfers with validation
Sign and Verify Messages	Sign + verify with read-only account	Ed25519 sign + verify
Error Handling	Errors, fee management, memory cleanup	Errors, fee management, memory cleanup

Files Changed

14 new files: 7 guides in sdk/wallet-modules/wallet-evm/guides/ + 7 in sdk/wallet-modules/wallet-solana/guides/
3 modified files: SUMMARY.md, wallet-evm/usage.md, wallet-solana/usage.md

Test plan

Verify all guide links render correctly in GitBook preview
Confirm sidebar navigation shows guides nested under Usage for both modules
Check that card tables on hub pages link to correct guide pages
Verify no broken links from existing pages (README, configuration, api-reference) to usage.md

…(WDKDOCS-188, WDKDOCS-190) Split the monolithic usage.md for wallet-evm and wallet-solana into 7 distinct how-to guides each, following the pattern established by the core module guides.

lucas-tortora

Very nice PR :) It's quite an improvement. I left some comments about adding a bit more text and a lot of links to API refs on the EVM guides. Please apply the same style to Solana as well

lucas-tortora · 2026-03-12T17:12:40Z

+
+## Sign a Message
+
+Use `account.sign()` to produce a cryptographic signature for any string message.


link to api ref

Addressed in e63ef35

lucas-tortora · 2026-03-12T17:17:49Z

+
+## Verify a Signature
+
+Use a read-only account to verify that a signature was produced by the corresponding private key.


Suggested change

Use a read-only account to verify that a signature was produced by the corresponding private key.

You can get a [read-only account](/sdk/wallet-modules/wallet-evm/api-reference#walletaccountreadonlyevm) from any `Account` object by calling `account.toReadOnlyAccount()`[link to api ref].

Use a read-only account to [`verify()`](sdk/wallet-modules/wallet-evm/api-reference#verify-message-signature-1) that a signature was produced by the corresponding private key.

Addressed in e63ef35

lucas-tortora · 2026-03-12T17:17:59Z

+{% endcode %}
+
+{% hint style="info" %}
+You can also create a `WalletAccountReadOnlyEvm` from any public address to verify signatures without access to the private key.


link to api ref

Addressed in e63ef35

lucas-tortora · 2026-03-12T17:20:11Z

+
+## Manage Fee Limits
+
+Set `transferMaxFee` when creating the wallet to prevent transactions from exceeding a maximum gas cost. Retrieve current network rates with `getFeeRates()` to make informed decisions.


/sdk/wallet-modules/wallet-evm/api-reference#getfeerates

Addressed in e63ef35

lucas-tortora · 2026-03-12T17:20:27Z

+{% endcode %}
+
+{% hint style="warning" %}
+Always call `dispose()` in a `finally` block or cleanup handler to ensure sensitive data is cleared even if an error occurs.


https://docs.wdk.tether.io/sdk/wallet-modules/wallet-evm/api-reference#dispose-1

Addressed in e63ef35

sdk/wallet-modules/wallet-evm/guides/account-management.md to sdk/wallet-modules/wallet-evm/guides/manage-accounts.md to match the title and make it action oriented.

…agement rename The file was renamed to manage-accounts.md (PR 108) but SUMMARY.md still pointed to the old name.

…n EVM guides - getting-started: link WalletManagerEvm to API ref - check-balances: reword getBalance/getTokenBalance/getTokenBalances with API ref links, link WalletManagerEvm and WalletAccountReadOnlyEvm, split read-only section into separate subsections - send-transactions: add API ref links for sendTransaction, quoteSendTransaction, getFeeRates - transfer-tokens: add API ref links for transfer and quoteTransfer, reword validation section, split validation into stepped subsections - sign-verify-messages: add API ref links for sign, verify, toReadOnlyAccount, WalletAccountReadOnlyEvm - error-handling: add API ref links for getFeeRates and dispose Addresses review comments from lucas-tortora on PR tetherto#105.

…n Solana guides Apply the same style as the EVM guides per lucas-tortora's review: - getting-started: link WalletManagerSolana to API ref - account-management: link getAccount and getAccountByPath to API ref - check-balances: reword getBalance/getTokenBalance with API ref links, link WalletManagerSolana and WalletAccountReadOnlySolana, split read-only section into separate subsections - send-transactions: add API ref links for sendTransaction, quoteSendTransaction, getFeeRates - transfer-tokens: add API ref links for transfer and quoteTransfer, split validation into stepped subsections - sign-verify-messages: add API ref links for sign, verify, toReadOnlyAccount, WalletAccountReadOnlySolana - error-handling: add API ref links for getFeeRates and dispose Addresses lucas-tortora's overall review note on PR tetherto#105: "Please apply the same style to Solana as well."

docs: split wallet-evm and wallet-solana usage.md into how-to guides …

96197fc

…(WDKDOCS-188, WDKDOCS-190) Split the monolithic usage.md for wallet-evm and wallet-solana into 7 distinct how-to guides each, following the pattern established by the core module guides.

ihsraham changed the base branch from main to develop March 9, 2026 14:04

ihsraham marked this pull request as ready for review March 12, 2026 13:33

lucas-tortora requested changes Mar 12, 2026

View reviewed changes

Yuri-SVB and others added 4 commits March 12, 2026 22:32

Renamed

df82ee3

sdk/wallet-modules/wallet-evm/guides/account-management.md to sdk/wallet-modules/wallet-evm/guides/manage-accounts.md to match the title and make it action oriented.

fix: update SUMMARY.md and getting-started.md links after account-man…

1a608fa

…agement rename The file was renamed to manage-accounts.md (PR 108) but SUMMARY.md still pointed to the old name.

ihsraham mentioned this pull request Mar 16, 2026

Revision of Pr/105 #108

Closed

lucas-tortora approved these changes Mar 17, 2026

View reviewed changes

gatteo approved these changes Mar 24, 2026

View reviewed changes

gatteo merged commit 821408b into tetherto:develop Mar 24, 2026

ihsraham mentioned this pull request Apr 2, 2026

docs: convert remaining monolithic usage.md files into how-to guides #116

Merged


		## Sign a Message

		Use `account.sign()` to produce a cryptographic signature for any string message.


		## Verify a Signature

		Use a read-only account to verify that a signature was produced by the corresponding private key.

-Use a read-only account to verify that a signature was produced by the corresponding private key.
+You can get a [read-only account](/sdk/wallet-modules/wallet-evm/api-reference#walletaccountreadonlyevm) from any `Account` object by calling `account.toReadOnlyAccount()`[link to api ref].
+Use a read-only account to [`verify()`](sdk/wallet-modules/wallet-evm/api-reference#verify-message-signature-1) that a signature was produced by the corresponding private key.


		## Manage Fee Limits

		Set `transferMaxFee` when creating the wallet to prevent transactions from exceeding a maximum gas cost. Retrieve current network rates with `getFeeRates()` to make informed decisions.

Conversation

ihsraham commented Mar 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

New Guides (per module)

Files Changed

Test plan

Uh oh!

lucas-tortora left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

ihsraham commented Mar 9, 2026 •

edited

Loading