feat: wallet improvements and send command by blakecduncan · Pull Request #50 · alchemyplatform/alchemy-cli

blakecduncan · 2026-04-07T17:51:57Z

Summary

wallet create: New primary command (replaces wallet generate as recommended), swaps @alchemy/x402 imports for direct viem usage
wallet qr: Displays wallet address as a scannable terminal QR code
Gas mode config: Adds gas_mode (sponsored/wallet-paid) and gas_policy_id config keys, env vars (ALCHEMY_GAS_MODE, ALCHEMY_GAS_POLICY_ID), and --gas-mode/--gas-policy-id CLI flags
send command: Transfer native tokens or ERC-20s via Alchemy smart wallet client (@alchemy/wallet-apis) with ENS resolution, human-readable amounts, and sponsored/wallet-paid gas modes
Shared smart wallet infra: src/lib/smart-wallet.ts (client factory) and src/lib/chains.ts (network→viem chain mapping) for reuse by upcoming execution commands (swap, bridge, approve, wrap, unwrap)

Test plan

alchemy wallet create generates wallet and saves to config
alchemy wallet generate still works as alias
alchemy wallet qr displays scannable QR code
alchemy config set gas-sponsored true / alchemy config get gas-sponsored works
alchemy send <to> <amount> -n eth-sepolia sends native ETH (wallet-paid)
alchemy send <to> <amount> -n eth-sepolia --gas-sponsored --gas-policy-id <id> sends with sponsorship
alchemy send <to> <amount> --token <erc20> -n eth-sepolia sends ERC-20 tokens
All 273 tests pass

🤖 Generated with Claude Code

Non sponsored eth send

sponsored usdc send

Replace @alchemy/x402 wallet utilities with direct viem/accounts imports, add `wallet create` as the primary command, and keep `wallet generate` as a compatibility alias. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Add gas_mode (sponsored|wallet-paid) and gas_policy_id to config, resolve functions with flag > env > config precedence, and root-level --gas-mode / --gas-policy-id CLI options for state-changing commands. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Add the `send` command for transferring native tokens and ERC-20 tokens using Alchemy's smart wallet client (@alchemy/wallet-apis). Includes shared infrastructure for future execution commands: - src/lib/chains.ts: network slug → viem Chain mapping (40+ networks) - src/lib/smart-wallet.ts: shared smart wallet client factory with gas sponsorship via paymaster capabilities - src/commands/send.ts: send command with ENS resolution, human-readable amount parsing, ERC-20 token support, and sponsored/wallet-paid gas modes Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

- Add `wallet qr` to display wallet address as a scannable QR code - Show gas mode (Sponsored/Wallet-paid) in send output for both human and JSON modes Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Simplify gas config from string enum ("sponsored"|"wallet-paid") to a boolean, matching the existing x402/verbose pattern. Flag becomes --gas-sponsored, env becomes ALCHEMY_GAS_SPONSORED. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

lohnim · 2026-04-07T19:09:14Z

src/commands/send.ts

+import { exitWithError, errInvalidArgs } from "../lib/errors.js";
+import { withSpinner, printKeyValueBox, green } from "../lib/ui.js";
+
+const NATIVE_DECIMALS = 18;


Native decimal for solana is 9 right? Is this send only for eth?

Yeah I just realized I didn't cover any of the solana stuff in the doc. I'm actually thinking that we have a different code path for solana. And then we branch based on the network being passed in the command. Maybe I can add solana send next as a follow on pr if that makes sense?

lohnim · 2026-04-07T19:10:12Z

src/commands/send.ts

+  tokenAddress: string,
+): Promise<{ decimals: number; symbol: string }> {
+  const client = clientFromFlags(program);
+  const result = await client.call("alchemy_getTokenMetadata", [tokenAddress]) as {


Should we at least have some known assets <> decimal mapping so we don't query alchemy everytime? Maybe alchemy get token metadata should be a fallback instead of it being a call?

Yeah that is a fair point - I was against hardcoding this because tokens have a different addresses on every chain. So we would need to key the look up by chain id and contract address. Then there are some tokens (like usdt) that are 6 decimals on some chains and 18 on others.

Alternatively we could call the contract directly to get the decimal if we don't want to call the data apis.

lohnim · 2026-04-07T19:12:03Z

src/commands/wallet.ts

+        if (isJSONMode()) {
+          printJSON({ address });
+        } else {
+          const qr = await QRCode.toString(address, { type: "terminal", small: true });


dumb question - where does this get displayed?

just right in the terminal after calling the command

src/lib/chains.ts

+import * as viemChains from "viem/chains";
+import { errInvalidArgs } from "./errors.js";
+
+const SLUG_TO_CHAIN: Record<string, Chain> = {


blakecduncan · 2026-04-07T19:43:18Z

@codex review

Register gas-sponsored and gas-policy-id under `config set`, add them to `config list` and `config get` defaults. Also rename chains.ts internal map variable for clarity. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

blakecduncan and others added 4 commits April 7, 2026 10:52

feat: add wallet qr command and show gas mode in send output

31fb7a9

- Add `wallet qr` to display wallet address as a scannable QR code - Show gas mode (Sponsored/Wallet-paid) in send output for both human and JSON modes Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

blakecduncan requested a review from a team as a code owner April 7, 2026 17:51

blakecduncan and others added 3 commits April 7, 2026 13:54

chore: add @types/qrcode dev dependency

2cce94a

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

tweak: only show gas line in send output when sponsored

f1dc866

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

blakecduncan removed the request for review from a team April 7, 2026 18:10

lohnim approved these changes Apr 7, 2026

View reviewed changes

blakecduncan merged commit 26e88fb into release Apr 7, 2026
4 checks passed

blakecduncan deleted the blake/wallet-and-send branch April 7, 2026 20:34

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat: wallet improvements and send command#50

feat: wallet improvements and send command#50
blakecduncan merged 8 commits intoreleasefrom
blake/wallet-and-send

blakecduncan commented Apr 7, 2026 •

edited

Loading

Uh oh!

lohnim Apr 7, 2026

Uh oh!

blakecduncan Apr 7, 2026

Uh oh!

lohnim Apr 7, 2026

Uh oh!

blakecduncan Apr 7, 2026

Uh oh!

lohnim Apr 7, 2026

Uh oh!

blakecduncan Apr 7, 2026

Uh oh!

This comment was marked as resolved.

Uh oh!

This comment was marked as resolved.

Uh oh!

blakecduncan commented Apr 7, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

blakecduncan commented Apr 7, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Test plan

Uh oh!

lohnim Apr 7, 2026

Choose a reason for hiding this comment

Uh oh!

blakecduncan Apr 7, 2026

Choose a reason for hiding this comment

Uh oh!

lohnim Apr 7, 2026

Choose a reason for hiding this comment

Uh oh!

blakecduncan Apr 7, 2026

Choose a reason for hiding this comment

Uh oh!

lohnim Apr 7, 2026

Choose a reason for hiding this comment

Uh oh!

blakecduncan Apr 7, 2026

Choose a reason for hiding this comment

Uh oh!

This comment was marked as resolved.

Uh oh!

This comment was marked as resolved.

Uh oh!

blakecduncan commented Apr 7, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

blakecduncan commented Apr 7, 2026 •

edited

Loading