[docs-agent] Aggregated skills sync 2026-08-24 (drains #34..#43 stack)

[alchemy-bot]

Aggregated one-shot weekly skills update that consolidates the six stacked open weekly PRs (#34, #36, #40, #41, #42, #43) into a single PR from main, and layers on high-priority post-#43 material that had accumulated in cron-heartbeat notes over the past eight consecutive skipped weeklies. Intent: land this PR and close #34..#43 as superseded.

Stacked follow-up: Apps Management + Usage APIs skill coverage for DX-3680 lives in a separate stacked PR that branches off this one. Once this PR merges, GitHub auto-rebases the follow-up onto main.

Files changed

50 files, +2,032 / -424. 25 unique canonical files under skills/alchemy-api/references/ + skills/alchemy-cli/SKILL.md + skills/alchemy-mcp/SKILL.md + skills/alchemy-api/SKILL.md, mirrored byte-identically to plugins/alchemy/skills/....

Two NEW reference files:

• skills/alchemy-api/references/solana-websocket-subscriptions.md (from #34)
• skills/alchemy-api/references/data-stellar-api.md (from #43)

Coverage from #34..#43

#34 (2026-05-06 weekly)

• NEW solana-websocket-subscriptions.md — full reference for Solana PubSub (accountSubscribe, programSubscribe, logsSubscribe, signatureSubscribe, slotSubscribe, rootSubscribe) with request/notification format, @solana/web3.js mapping, bandwidth billing.
• node-websocket-subscriptions.md renamed to WebSocket Subscriptions (EVM), cross-linked to Solana file.
• wallets-supported-chains.md rewritten with the four capability axes (Bundler / Gas Sponsorship / ERC-20 Gas Payments / BSOs) + routing logic table + Solana-sponsorship-only note.
• wallet_requestAccount account-type table already present in main; retained.

#36 (2026-05-13 weekly)

• alchemy-cli/SKILL.md full command-tree refresh (evm, solana, xchain, wallet, app, webhook groups). Replaces old alchemy balance / alchemy tx / alchemy webhooks / alchemy apps with alchemy evm data balance / alchemy evm tx / alchemy webhook / alchemy app.
• operational-supported-networks.md — added bitcoincash-mainnet, bitcoincash-testnet, litecoin-mainnet, litecoin-testnet, dogecoin-mainnet, bitcoin-testnet4 and a UTXO REST API description.
• solana-das-api.md — full searchAssets rewrite (ownerAddress required, tokenType with case-sensitivity note, snake_case sortBy enum, mutual exclusion of interface/tokenType and ownerType/tokenType, pagination strategy rules, phantom-field list). NEW getTokenAccounts section (also DAS, distinct from standard Solana RPC getTokenAccountsByOwner). Preserved main's post-[docs-agent] Weekly skills update 2026-05-27 #39 displayOptions correction (showInscription singular, drop showNativeBalance and showInscriptions).
• solana-rpc.md — new getTransactionsForAddress method section (single-call alternative to getSignaturesForAddress + N getTransaction).
• operational-rate-limits-and-compute-units.md — Base Flashblocks event-based subscription pricing (newFlashblockTransactions 40 CU/event, newFlashblocks 60 CU/event).

#40 (2026-06-03 weekly)

• wallets-solana-notes.md and wallets-wallet-apis.md — corrected field name from instructions to calls (the item shape is what differs between EVM and Solana). Added Solana signer adapters (fromKitSigner, fromWalletAdapter, fromKeypair, fromWalletStandard from @alchemy/wallet-apis/solana). Documented Solana sponsorship as GA with client-level and per-request paymaster. Added Non-7702 mode section (HyperEVM requestAccount → account passthrough).
• solana-wallets.md refreshed to point at v5 Wallet APIs as the recommended path.

#41 (2026-06-10 weekly)

• alchemy-cli/SKILL.md — agent-prompt --scope wallet invocation. New Agent Wallet Session auth method row + Local Wallet row. Detailed session capability enumeration (evm.signMessage, evm.signTypedData, evm.signAuthorization, evm.prepareCalls, evm.sendCalls, solana.signTransaction) with dashboard approval link. wallet status --verify execution rule. Note that session signer does NOT support raw EVM tx signing.
• alchemy-mcp/SKILL.md — new Alchemy Claude Plugin install path (/plugin marketplace add alchemyplatform/alchemy-claude-plugin + /plugin install alchemy@alchemy), fallback to manual claude mcp add.

#42 (2026-06-17 weekly)

• node-json-rpc.md — eth_getLogs per-chain block-range tier paragraph (uses #43's corrected numbers, not #42's original).
• node-trace-api.md — new Arbitrum section listing 8 supported arbtrace_* methods with their trace_* mirrors + explicit callout that arbtrace_rawTransaction is NOT available.
• wallets-account-kit.md — ⚠️ Alchemy Signer sunset callout (June 16, 2026), v4 vs v5 routing table updated to reflect Privy as recommended signer, primary use cases scoped to existing-user migration only.

#43 (2026-06-24 weekly)

• NEW data-stellar-api.md — full reference for the 3 Stellar Data API endpoints (transfers, balances, nfts), unified api.g.alchemy.com base URL, Authorization: Bearer auth.
• node-debug-api.md — stateOverrides schema fix for debug_traceCall / debug_traceCallMany: balance, nonce, code, state, stateDiff, movePrecompileToAddress as top-level siblings (previously mis-nested).
• operational-supported-networks.md — Polygon zkEVM Mainnet + Cardona removed and added to Recently Deprecated with July 1, 2026 cutoff.
• rollups-details.md — Supported framework section noting Arbitrum Orbit is the only supported deployment path.
• data-overview.md, skill-map.md — indexed the new Stellar Data API file.

Post-#43 material (folded in here)

Highest-priority items from the 2026-07-01 through 2026-08-19 cron heartbeats that had been queued for the "next drained-queue weekly". Excludes DX-3680 — that lives in the stacked follow-up PR.

API parameter corrections (highest impact — agents key on these fields)

• wallets-bundler.md — added Bundler RPC error data fields table with Rundler's camelCase wire format (innerReason, revertData, validUntil, validAfter, currentMaxPriorityFee, currentMaxFee). Added -32508 PaymasterBalanceTooLow. Noted -32501 and -32505 have no data payload. Noted the single-key Entity shape for -32504 ({ <entityType>: <address> }, NOT { entity, address }). This is the exact class of correction that DOCS-73 / DAS phantom-param fixes belonged to — agents branching on stale snake_case field names silently fail.

Auth / flow changes

• alchemy-cli/SKILL.md — alchemy auth login --device-code for headless (SSH, Codespaces, CI). Plain alchemy auth auto-detects non-interactive sessions and switches to device-code mode.
• alchemy-cli/SKILL.md — NEW alchemy x402 request / alchemy x402 balance section for third-party API payments (distinct axis from --x402 / alchemy config set x402 true which is Alchemy API auth). Includes exit-code and flag guidance.
• wallets-wallet-apis.md — added wallet_requestAccount.createAdditional behavior (returns oldest existing account by default even when a different accountType is passed via creationHint; force new via createAdditional: true).
• wallets-wallet-apis.md — added Retries and automatic gas bumping section (server auto-bumps maxFeePerGas / maxPriorityFeePerGas on retry by 10% or network minimum, whichever is higher; do NOT override fees on retry unless forcing a specific level). This is Wallet-APIs-specific — direct bundler-API path still requires manual bump.

Deprecations (asymmetry rule: removals ARE material)

• operational-supported-networks.md — added to Recently Deprecated / Removed and removed from active networks list: Botanix Mainnet (full-chain shutdown), Polygon zkEVM Mainnet + Cardona (already from #43; retained), Scroll Sepolia (July 30, 2026), Syndicate Manchego, Sonic Blaze (already from #42; retained).
• wallets-account-kit.md — ⚠️ Account Kit v4 is nav-deprecated (2026-08) callout. Nav collapsed to only Export Private Key. 26 v4 MDX pages deleted (login methods, UI components, whitelabel, connectors, MFA, Solana wallets, server wallets, Programmatic Wallet Creation recipe). Do not scaffold new v4 projects.

BSO + Gas Sponsorship (moved / GA / dashboard redesign)

• wallets-bundler.md — BSO is now the recommended default for new gas sponsorship integrations (out of beta in 2026-07, moved into the Sponsor gas dropdown). Wallet APIs (paymaster: { policyId }) is the recommended path; low-level bundler path (triple-zero + x-alchemy-policy-id) documented as alternative.
• wallets-gas-manager.md — Dashboard URL updated to https://dashboard.alchemy.com/apps/latest/gas-sponsorship (legacy /gas-policies/new, /services/gas-manager/configuration, /gas-manager, /gas-manager/policy/create all redirect). Policy Types table added: sponsorship, solana, erc20, bundler_sponsorship. Note that dashboard is now app-scoped (not global).

Solana surfaces

• solana-rpc.md — new Account Archive section covering historical getAccountInfo / getBalance / getTokenAccountBalance with slot, lastUpdateBeforeSlot, firstUpdateAfterSlot (the last two are getAccountInfo-only per PR #1492/#1532). Documented mutual exclusion with minContextSlot. Error codes -32020 (out of coverage) and -32602 (unsupported archive param).
• solana-rpc.md — new Jito bundles section covering sendBundle, getBundleStatuses, getTipAccounts, getInflightBundleStatuses on the standard endpoint (Alchemy proxies to Jito). Note that these live on the dedicated Jito Bundles overview page, not the main Solana overview.
• solana-rpc.md — noted simulateTransaction / sendTransaction / getHealth restoration after the 2026-04 Daikon cleanup incident.

NFT API updates

• data-nft-api.md — added v2 → v3 migration table (getNFTs → getNFTsForOwner, getOwnersForToken → getOwnersForNFT, getOwnersForCollection → getOwnersForContract, isAirdrop → isAirdropNFT). Noted v2 endpoints removed 2026-08. Added getFloorPrice Arbitrum + Base mainnet support (OpenSea data). Noted getCollectionsForOwner soft-deprecation.

Non-material this window (skipped, confirmed)

Per WEEKLY_SKILLS.md triage rules: Daikon-generated OpenRPC/servers PRs (many), weekly node-upgrades changelog, lychee link-check fixes, CI workflow updates, x-compute-units metadata annotations, style audit terminology-only fixes, hidden / private-preview pages (HyperCore, RBAC), chain-list-only expansions without a new capability axis (Alpen, Katana, Kaia, Boba, Cronos), pricing table tweaks.

Notes for reviewers

• Base is fresh main (post-[docs-agent] Weekly skills update 2026-05-27 #39). Every file is either checked out from the freshest PR that touches it (#34..#43), or manually reconciled to keep main's post-[docs-agent] Weekly skills update 2026-05-27 #39 v5 content alive where earlier PRs would have regressed it.
• All 25 canonical files are byte-identical to their plugins/alchemy/skills/... mirror (regenerated via plugins/alchemy/scripts/sync_from_catalog.py).
• Commit is signed with the alchemy-bot GPG key.
• The DX-3680 items (Admin API + Usage APIs skill coverage) live in a stacked follow-up PR so they can be reviewed separately from the queue-drain work.
• Once this lands, #34, #36, #40, #41, #42, #43 can be closed as superseded. Their branches are still around if any reviewer wants to spot-check individual commits.

Requested by

@SahilAujla (via Slack thread)