feat: add PumpClaw action provider

[clawd800]

Summary

Adds a PumpClaw action provider for interacting with the PumpClaw token factory and swap router on Base mainnet (Uniswap V4).

Actions Implemented

Action	Description
create_token	Deploy a new ERC20 token via PumpClaw factory with configurable supply and initial FDV
get_token_info	Query token metadata from factory registry (name, symbol, creator, pool, etc.)
list_tokens	Paginated listing of all tokens in the factory
buy_token	Buy tokens with ETH via SwapRouter
sell_token	Sell tokens for ETH via SwapRouter (handles ERC20 approval)
set_image_url	Update token image URI (creator-only)

Contracts (Base Mainnet)

Contract	Address
Factory	0xe5bCa0eDe9208f7Ee7FCAFa0415Ca3DC03e16a90
SwapRouter	0x3A9c65f4510de85F1843145d637ae895a2Fe04BE

Both contracts are verified on Basescan.

Architecture

• Follows existing action provider patterns (similar structure to wow and moonwell providers)
• Minimal ABIs — only the functions required for each action
• Uses viem for ABI encoding and formatUnits for display
• Zod schemas with address validation via isAddress
• Automatic token approval flow in sell_token (checks allowance before approving)

Testing

Full Jest test coverage for all 6 actions:

• Network support validation (Base mainnet only)
• Success and failure paths for each action
• Edge cases: insufficient balance, non-creator access, empty token lists, invalid addresses

Files

typescript/agentkit/src/action-providers/pumpclaw/
├── pumpclawActionProvider.ts       # Provider implementation (6 actions)
├── pumpclawActionProvider.test.ts  # Test suite
├── constants.ts                    # Addresses, ABIs, network helpers
├── schemas.ts                      # Zod input schemas
├── index.ts                        # Exports
└── README.md                       # Documentation

Plus one-line addition to action-providers/index.ts for the export.

[cb-heimdall]

🟡 Heimdall Review Status

Requirement	Status	More Info
Reviews	🟡 0/1	Denominator calculation Show calculation 1 if user is bot 0 1 if user is external 0 2 if repo is sensitive 0 From .codeflow.yml 1 Additional review requirements Show calculation Max 0 0 From CODEOWNERS 0 Global minimum 0 Max 1 1 1 if commit is unverified 1 Sum 2