Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 4 additions & 1 deletion skills/alchemy-api/references/node-overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ name: node-apis
description: Core JSON-RPC and WebSocket APIs for EVM chains via Alchemy node endpoints, plus Debug/Trace and utility methods. Use when building EVM integrations that need standard RPC calls, real-time subscriptions, enhanced Alchemy methods, or execution-level tracing.
tags: []
related: []
updated: 2026-02-14
updated: 2026-04-08
metadata:
author: alchemyplatform
version: "1.0"
Expand All @@ -22,6 +22,9 @@ Core JSON-RPC and WebSocket APIs for EVM chains via Alchemy node endpoints, plus
5. [node-debug-api.md](node-debug-api.md) - Debug tracing for transaction simulation and execution insight.
6. [node-trace-api.md](node-trace-api.md) - Trace-level details for internal calls and state diffs.

## Recently Added Chains
- **Injective** — Cosmos SDK-based L1 with full EVM compatibility. Supports standard `eth_*` JSON-RPC methods. Use endpoint pattern `injective-mainnet`. See [Injective API Overview](https://www.alchemy.com/docs/chains/injective/injective-api-overview).

## How to Use This Skill
- Start with `node-json-rpc.md` for base connectivity and request patterns.
- Use `node-enhanced-apis.md` for wallet/asset analytics on EVM without scanning logs.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ tags:
related:
- node-json-rpc.md
- solana-rpc.md
updated: 2026-04-01
updated: 2026-04-08
---
# Supported Networks

Expand Down Expand Up @@ -162,6 +162,7 @@ hyperliquid-mainnet
hyperliquid-testnet
ink-mainnet
ink-sepolia
injective-mainnet
lens-mainnet
lens-sepolia
linea-mainnet
Expand Down
23 changes: 17 additions & 6 deletions skills/alchemy-api/references/wallets-bundler.md
Original file line number Diff line number Diff line change
@@ -1,31 +1,42 @@
---
id: references/wallets-bundler.md
name: 'Bundler'
description: 'A bundler aggregates and submits account abstraction user operations. Use this when integrating smart wallets.'
description: 'A bundler aggregates and submits account abstraction user operations. Use this when integrating smart wallets. Supports EntryPoint v0.6, v0.7, and v0.8.'
tags:
- alchemy
- wallets
related:
- wallets-smart-wallets.md
- wallets-gas-manager.md
updated: 2026-02-05
updated: 2026-04-08
---
# Bundler

## Summary
A bundler aggregates and submits account abstraction user operations. Use this when integrating smart wallets.
A bundler aggregates and submits account abstraction user operations. Use this when integrating smart wallets. Powered by Rundler, Alchemy's production-grade ERC-4337 bundler.

## Supported EntryPoint Versions
- **v0.6** — original ERC-4337 EntryPoint
- **v0.7** — updated gas model and validation logic
- **v0.8** — latest version with additional optimizations

When configuring the bundler, ensure you target the correct EntryPoint version for your smart account implementation.

## Primary Use Cases
- AA transaction submission.
- UserOperation lifecycle handling.
- AA transaction submission via standard ERC-4337 JSON-RPC endpoints.
- UserOperation lifecycle handling (submit, track, drop-and-replace).

## Integration Notes
- Ensure correct chain configuration and entry point.
- Ensure correct chain configuration and EntryPoint version.
- Monitor bundler latency and failures.
- Use `eth_getUserOperationByHash` to poll UserOp status; if still null after timeout, drop and replace with higher fees.
- For `Replacement Underpriced` errors, increase both `maxFeePerGas` and `maxPriorityFeePerGas` by at least 10%.
- Bundler APIs are available in `@account-kit/infra`. For higher-level abstractions, use Wallet APIs or aa-sdk.

## Related Files
- `wallets-smart-wallets.md`
- `wallets-gas-manager.md`

## Official Docs
- [Bundler Overview](https://www.alchemy.com/docs/wallets/transactions/low-level-infra/bundler/overview)
- [Bundler FAQs](https://www.alchemy.com/docs/wallets/reference/bundler-faqs)
14 changes: 12 additions & 2 deletions skills/alchemy-api/references/wallets-gas-manager.md
Original file line number Diff line number Diff line change
@@ -1,14 +1,14 @@
---
id: references/wallets-gas-manager.md
name: 'Gas Manager'
description: 'Gas Manager (paymaster) enables gas sponsorship and cost control for smart wallet flows.'
description: 'Gas Manager (paymaster) enables gas sponsorship and cost control for smart wallet flows, including ERC-20 token gas payments and BSO (Bundler Sponsorship) policies.'
tags:
- alchemy
- wallets
related:
- wallets-smart-wallets.md
- wallets-bundler.md
updated: 2026-02-05
updated: 2026-04-08
---
# Gas Manager

Expand All @@ -18,14 +18,24 @@ Gas Manager (paymaster) enables gas sponsorship and cost control for smart walle
## Primary Use Cases
- Gasless user onboarding.
- Sponsoring specific methods or contracts.
- ERC-20 token gas payments (pay gas with any supported token).
- BSO (Bundler Sponsorship) policies for EIP-7702 undelegation.

## Integration Notes
- Define strict sponsorship policies.
- Monitor for abuse and enforce caps.

## ERC-20 Token Gas Payment — Revert Risk
When using **post-operation** mode for ERC-20 gas payments:
- If a token approval is batched with your calls and any call reverts, the approval is also reverted. The paymaster cannot collect the token payment, and **you (the policy owner) pay the gas cost** without receiving token compensation.
- If a sufficient allowance already exists (e.g., from threshold mode), the paymaster collects payment even if the batch reverts.
- **Use post-operation** when operations are unlikely to revert (works with all ERC-20 tokens).
- **Use pre-operation** when operations may revert — the token transfer happens before execution so the paymaster is always compensated.

## Related Files
- `wallets-smart-wallets.md`
- `wallets-bundler.md`

## Official Docs
- [Gas Manager Admin API](https://www.alchemy.com/docs/wallets/low-level-infra/gas-manager/policy-management/api-endpoints)
- [Pay Gas With Any Token](https://www.alchemy.com/docs/wallets/transactions/pay-gas-with-any-token)
12 changes: 10 additions & 2 deletions skills/alchemy-api/references/wallets-wallet-apis.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,16 +8,24 @@ tags:
related:
- wallets-account-kit.md
- operational-auth-and-keys.md
updated: 2026-04-01
updated: 2026-04-08
---
# Wallet APIs

## Summary
High-level wallet APIs enable programmatic wallet operations such as signing, transaction preparation, or account management. This guide stays minimal and focuses on integration awareness.
High-level wallet APIs enable programmatic wallet operations such as signing, transaction preparation, account management, and EIP-7702 delegation/undelegation. This guide stays minimal and focuses on integration awareness.

## Primary Use Cases
- Server-side transaction preparation.
- Delegated signing or session-based flows.
- EIP-7702 account delegation and undelegation.

## EIP-7702 Undelegation
Undelegation removes smart contract delegation from an EIP-7702 account by delegating to the zero address (`0x0000...0000`), restoring it to a plain EOA. Key details:
- Gas is sponsored through a **BSO (Bundler Sponsorship) policy** — the account does not need native tokens.
- Requires **enterprise plan** — sponsored undelegation is gated to enterprise customers.
- Available via both the client SDK (`@alchemy/wallet-apis`) and REST API.
- For advanced control, use `wallet_prepareCalls` + `wallet_sendPreparedCalls` to inspect and sign the authorization separately.

## Integration Notes
- Prefer client-side signing for user security.
Expand Down
Loading