# Lbamm Standard Hook

> Configure AMM Standard Hook via Creator Hook Settings Registry

- Skill: `api-evangelist/lbamm-standard-hook` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add api-evangelist/lbamm-standard-hook`
- Raw SKILL.md: https://api.skillmd.com/api/skills/api-evangelist/lbamm-standard-hook/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: api-evangelist (https://skillmd.com/u/api-evangelist)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/api-evangelist/lbamm-standard-hook

---


# LBAMM Standard Hook Configurator

Generate configuration scripts/contracts for the first-party AMM Standard Hook + Creator Hook Settings Registry.

## Project Setup

Before generating code, check the user's project is configured:
1. **Foundry**: `foundry.toml` must exist. If not: `forge init`
2. **LBAMM Core**: `lib/lbamm-core/` must exist. If not: `forge install limitbreakinc/lbamm-core`
3. **LBAMM Hooks and Handlers**: `lib/lbamm-hooks-and-handlers/` must exist. If not: `forge install limitbreakinc/lbamm-hooks-and-handlers`
4. **Remappings**: `remappings.txt` needs both `@limitbreak/lbamm-core/=lib/lbamm-core/` and `@limitbreak/lbamm-hooks-and-handlers/=lib/lbamm-hooks-and-handlers/`. Append if missing -- do not overwrite existing entries.
4. **Local testing**: LBAMM is in audit and not yet on public networks. For local testing, use `lbamm-examples` -- see `lbamm-protocol/references/local-dev.md`. Generated scripts should read addresses from environment variables (`vm.envAddress`) so they work with the local Anvil deployment.

## Instructions

1. **Parse desired configuration** from `$ARGUMENTS` -- identify what the token issuer wants to configure (trading fees, whitelists, price bounds, trading pause, pool disabling, etc.)

2. **Resolve ambiguities before generating** -- if $ARGUMENTS mentions a token without its address, references whitelists without specifying which addresses to include, or leaves fee amounts unspecified, ask in a single message. If clear, proceed.

3. **Map requirements to `HookTokenSettings` fields:**
   - `tradingIsPaused` -- Pause all trading
   - `blockDirectSwaps` -- Block direct (P2P) swaps
   - `checkDisabledPools` -- Enable pool disable/enable by token issuer
   - `tokenFeeBuyBPS` / `tokenFeeSellBPS` -- Fees on token buys/sells (in token)
   - `pairedFeeBuyBPS` / `pairedFeeSellBPS` -- Fees on buys/sells (in paired token)
   - `minFeeAmount` / `maxFeeAmount` -- Fee amount bounds
   - `poolTypeWhitelistId` -- Restrict which pool types can be used
   - `pairedTokenWhitelistId` -- Restrict which tokens can be paired
   - `lpWhitelistId` -- Restrict who can provide liquidity

4. **Generate a Foundry script** that:
   - Creates whitelists via the Registry (LP, pair token, pool type) if needed
   - Calls `registry.setTokenSettings()` with the correct `HookTokenSettings`
   - Calls LBAMM core `setTokenSettings()` with correct packed flags
   - Syncs hooks if needed

5. **Include LBAMM core `setTokenSettings` call** with correct packed flags:
   - The AMM Standard Hook supports flags: beforeSwap (0), afterSwap (1), addLiquidity (2), poolCreation (5), flashloans (7), flashloansValidateFee (8), handlerOrderValidate (9)
   - Flags removeLiquidity (3), collectFees (4), and hookManagesFees (6) are NOT supported and will cause reverts if set

6. **Explain each setting** and distinguish:
   - Pool disabling (`checkDisabledPools` + `setPoolDisabled`) vs trading pause (`tradingIsPaused`)
   - Token fees vs paired token fees
   - Whitelist IDs (0 = no restriction)

## Reference Files

- `references/standard-hook-api.md` -- Registry interface, IAMMStandardHook, who can administer
- `references/standard-hook-configs.md` -- Common configuration examples
- Protocol knowledge: `lbamm-protocol`

## When to Use This vs Other Hook Skills

- **This skill (lbamm-standard-hook)**: Configure the pre-deployed first-party AMM Standard Hook via the Creator Hook Settings Registry. No custom Solidity needed -- just configuration scripts. Use when built-in settings (trading fees, whitelists, pause, pool disabling) are sufficient.
- **lbamm-token-hook**: Generate a custom `ILimitBreakAMMTokenHook` implementation. Use when you need behavior beyond what the standard hook provides.
- **lbamm-pool-hook**: Generate a custom `ILimitBreakAMMPoolHook` implementation. Use for per-pool behavior like dynamic fees or oracle pricing.