Skip to content

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

Open
ihsraham wants to merge 1 commit intotetherto:developfrom
ihsraham:feature/wdkdocs-188-190-usage-to-how-to-guides
Open

docs: split wallet-evm and wallet-solana usage.md into how-to guides#105
ihsraham wants to merge 1 commit intotetherto:developfrom
ihsraham:feature/wdkdocs-188-190-usage-to-how-to-guides

Conversation

@ihsraham
Copy link
Contributor

@ihsraham ihsraham commented Mar 9, 2026

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.
@ihsraham ihsraham changed the base branch from main to develop March 9, 2026 14:04
@ihsraham ihsraham marked this pull request as ready for review March 12, 2026 13:33
Copy link
Contributor

@lucas-tortora lucas-tortora left a comment

Choose a reason for hiding this comment

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

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


## Sign a Message

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

Choose a reason for hiding this comment

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

link to api ref


## Verify a Signature

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

Choose a reason for hiding this comment

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

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.

{% endcode %}

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

Choose a reason for hiding this comment

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

link to api ref


## 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.
Copy link
Contributor

Choose a reason for hiding this comment

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

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

{% 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.
Copy link
Contributor

Choose a reason for hiding this comment

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

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