Add PumpClaw adapter (Base token launcher with Uniswap V4)

[clawd800]

Name (to be shown on DefiLlama):

PumpClaw

Twitter Link:

https://x.com/clawd800

List of audit links if any:

N/A (open source, all contracts verified on Basescan)

Website Link:

https://pumpclaw.com

Logo (High resolution, will be shown with rounded borders):

https://pumpclaw.com/logo-256.png

Current TVL:

~$89K (2 active trading pools on Uniswap V4, 37 tokens total)

Treasury Addresses (if the protocol has treasury)

N/A

Chain:

Base

Coingecko ID:

Coinmarketcap ID:

Short Description (to be shown on DefiLlama):

Free token launcher for AI agents on Base with Uniswap V4 liquidity. 80% of trading fees go to creators, LP locked forever.

Token address and ticker if any:

N/A (protocol has no governance token)

Category:

Launchpad

Oracle Provider(s):

N/A (uses Uniswap V4 AMM pricing)

Implementation Details:

Tokens are created via the PumpClawFactory contract which deploys ERC20 tokens and adds single-sided liquidity to Uniswap V4 pools. LP positions are permanently locked in the LPLocker contract.

Documentation/Proof:

• Factory: https://basescan.org/address/0xe5bCa0eDe9208f7Ee7FCAFa0415Ca3DC03e16a90
• LPLocker: https://basescan.org/address/0x6e4D241957074475741Ff42ec358b8b00217Bf5d

forkedFrom:

N/A (original implementation)

methodology:

Counts the value of tokens held in the Uniswap V4 PoolManager (0x498581fF718922c3f8e6A244956aF099B2652b2b) that were created by the PumpClaw factory. Each token is exclusively paired with native ETH in a V4 pool, and all LP positions are permanently locked. The adapter fetches TokenCreated events from the factory to identify all PumpClaw tokens, then sums their balances in the PoolManager.

Note: Token pricing may need assistance since these are new tokens not yet on CoinGecko. The tokens are tradeable via Uniswap V4 pools on Base.

Github org/user:

clawd800

Does this project have a referral program?

No

Summary by CodeRabbit

• New Features
  • Added a TVL adapter for PumpClaw using Uniswap V4 integration to track total value locked across PumpClaw pools.
  • Begins historical tracking from block 25,973,600 and discovers relevant tokens from on-chain events.
  • Exposes methodology, start information, and metadata for transparency about aggregation and counting assumptions.

[coderabbitai]

Caution

Review failed

The pull request is closed.

📝 Walkthrough

Walkthrough

Adds a new PumpClaw TVL adapter that uses a Uniswap V4 hook export (uniV4HookExport) pointed at a hook address to provide base.tvl, and exports metadata including methodology, start block, doublecounted, and timetravel flags.

Changes

Cohort / File(s)	Summary
PumpClaw TVL adapter projects/pumpclaw/index.js	New module exporting { methodology, start, doublecounted, timetravel, base: { tvl } }. Imports uniV4HookExport, defines PUMPCLAW_HOOK_V4_ADDRESS, and sets base.tvl = uniV4HookExport({ hook: ADDRESS }) to implement TVL via a Uniswap V4 hook.

Sequence Diagram

sequenceDiagram
    participant Adapter as PumpClaw Adapter
    participant HookLib as uniV4HookExport
    participant HookContract as UniswapV4 Hook (on-chain)
    participant DefiLlama as DefiLlama runtime

    DefiLlama->>Adapter: require/import adapter
    Adapter->>HookLib: initialize with { hook: PUMPCLAW_HOOK_V4_ADDRESS }
    HookLib->>HookContract: subscribe / call hook endpoints
    DefiLlama->>HookLib: invoke tvl() via adapter.base.tvl
    HookLib->>HookContract: query pool/token state
    HookContract-->>HookLib: return pool/token data
    HookLib-->>DefiLlama: aggregated TVL result

Loading

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~15 minutes

Possibly related PRs

• Add PumpClaw adapter (Base token launcher with Uniswap V4) #17989 — Earlier PR adding a PumpClaw TVL adapter; this change replaces log-based TokenCreated parsing with a Uniswap V4 hook implementation.

Suggested reviewers

• g1nt0ki

Poem

🐰 I sniffed a hook beneath the clawed design,
I whispered to pools and counted every line,
From on-chain whispers to a tidy sum,
I hopped, I tallied—now PumpClaw's done! 🎵

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title accurately summarizes the main change: adding a TVL adapter for PumpClaw, a Base token launcher using Uniswap V4, matching the changeset content.
Description check	✅ Passed	The pull request description is comprehensive and mostly complete, covering all required sections from the template with detailed information about the protocol, implementation methodology, and relevant contract addresses.
Docstring Coverage	✅ Passed	Docstring coverage is 100.00% which is sufficient. The required threshold is 80.00%.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing touches

• 📝 Generate docstrings

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Actionable comments posted: 1

🤖 Fix all issues with AI agents

In `@projects/pumpclaw/index.js`:
- Around line 17-22: The adapter currently builds tokens = logs.map(log =>
log.token) and calls api.sumTokens({ owner: POOL_MANAGER, tokens }), which only
counts the PumpClaw side; update it to also count the paired ETH side for each
Uniswap V4 pool: either (A) for each TokenCreated/log use the positionId to
query the pool state (via the V4 pool contract) to obtain the paired token
address (token0/token1) and include that address alongside log.token in the
tokens array before calling api.sumTokens, or (B) if you prefer a simpler
change, assume the pair is WETH (0x4200000000000000000000000000000000000006 on
Base) and extend tokens to include WETH for every entry so api.sumTokens({
owner: POOL_MANAGER, tokens }) counts both sides; reference tokens, logs,
POOL_MANAGER, TokenCreated and positionId when implementing.

[coderabbitai]

Actionable comments posted: 1

🤖 Fix all issues with AI agents

In `@projects/pumpclaw/index.js`:
- Around line 6-7: Remove the unused constants WETH and LP_LOCKER from the
module (they're declared but never referenced) or, if you want to keep them for
documentation, convert them into a clearly marked comment explaining their
purpose; if keeping LP_LOCKER, confirm and update its value to the correct
address referenced in the PR description (replace
'0x9047c0944c843d91951a6C91dc9f3944D826ACA8' with
'0x6e4D241957074475741Ff42ec358b8b00217Bf5d' if that is the canonical one) and
ensure only the chosen form (constant removed or commented/updated) remains so
no unused identifiers (WETH, LP_LOCKER) exist in the codebase.

[clawd800]

Friendly ping — all CodeRabbit comments have been addressed and checks are passing. Would love a human review when someone has a moment. Happy to make any changes needed. Thanks!

[clawd800]

Hey @g1nt0ki @Define101 — this adapter has been ready for 12 days now with all checks passing. It's a simple Uniswap V4 factory adapter on Base (PumpClaw). Would really appreciate a quick review when you get a chance. Thanks!

[llamabutler]

The adapter at projects/pumpclaw exports TVL:

base                      0.00

total                    0.00 

[clawd800]

Hey @treeoflife2 — the refactor in d1b5a2a to uniV4HookExport broke TVL tracking. PumpClaw pools use hooks: address(0) (no hook), not the factory address as a hook. So querying the subgraph for hooks == factoryAddress returns zero pools → $0 TVL.

The original adapter used TokenCreated events from the factory to discover tokens, then summed their balances in the PoolManager — which correctly tracked TVL.

Fix PR: #18074

[treeoflife2]

Hey @treeoflife2 — the refactor in d1b5a2a to uniV4HookExport broke TVL tracking. PumpClaw pools use hooks: address(0) (no hook), not the factory address as a hook. So querying the subgraph for hooks == factoryAddress returns zero pools → $0 TVL.

The original adapter used TokenCreated events from the factory to discover tokens, then summed their balances in the PoolManager — which correctly tracked TVL.

Fix PR: #18074

that was still giving 0 tvl
#17989 (comment)

[clawd800]

You're right — the original event-based approach also returned $0 because these are brand new tokens with no CoinGecko listing, so sumTokens can't price them.

The hook mismatch is still a real issue (PumpClaw pools use hooks: address(0), not the factory), but the root problem is token pricing.

Question: What's the recommended pattern for launchpad protocols where paired tokens are new/unpriced? Some options I see:

1. Track only the ETH side of pools (each PumpClaw token is paired with native ETH on V4)
2. Use addGasToken to manually sum ETH locked per pool
3. Some other DefiLlama helper I'm not aware of

All 141 PumpClaw pools are ETH-paired with permanently locked LP on Uniswap V4. The ETH in those pools is the real TVL. Happy to implement whatever approach works with your infrastructure.

[treeoflife2]

@clawd800 i think for bonding curve type protocols, we only accept ETH in tvl, as other meme coins don't have any value so not a good indicator for the TVL