Skip to content

feat: add Mint Club V2 action provider#949

Open
h1-hunt wants to merge 2 commits intocoinbase:mainfrom
h1-hunt:feature/mintclub-action-provider
Open

feat: add Mint Club V2 action provider#949
h1-hunt wants to merge 2 commits intocoinbase:mainfrom
h1-hunt:feature/mintclub-action-provider

Conversation

@h1-hunt
Copy link

@h1-hunt h1-hunt commented Feb 13, 2026

Summary

This PR adds a comprehensive Mint Club V2 action provider to AgentKit, enabling AI agents to interact with bonding curve tokens on Base mainnet.

Features

Actions Implemented

  • get_token_info: Get detailed information about Mint Club tokens including bonding curve details
  • get_token_price: Get current token prices in reserve tokens and USD
  • buy_token: Buy tokens via bonding curve mechanism with slippage protection
  • sell_token: Sell tokens via bonding curve mechanism with slippage protection
  • create_token: Create new bonding curve tokens with custom parameters

Key Highlights

  • High-quality code: Follows AgentKit patterns and style guide exactly
  • Comprehensive testing: Full test coverage with mocked dependencies
  • Proper error handling: Descriptive error messages and validation
  • Network support: Base mainnet (matches AgentKit scope)
  • ABIs: Minimal ABIs with only required functions for efficiency
  • Documentation: Complete README and inline JSDoc comments

Technical Details

Architecture

  • Uses viem for blockchain interactions (like other providers)
  • Implements proper approval flows for ERC20 tokens
  • Includes USD pricing via 1inch Spot Price Aggregator
  • Follows the same patterns as the wow provider (bonding curve reference)

Contract Integration

  • MCV2 Bond: 0xc5a076cad94176c2996B32d8466Be1cE757FAa27
  • 1inch Spot Price Aggregator: 0x00000000000D6FFc74A8feb35aF5827bf57f6786
  • USDC: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Code Quality

  • ✅ Matches AgentKit TypeScript style guide
  • ✅ Uses @createaction decorator pattern
  • ✅ Proper Zod schemas with descriptions
  • ✅ Comprehensive error handling
  • ✅ Full test coverage with Jest mocks
  • ✅ Professional documentation

Testing

All tests pass and follow AgentKit testing patterns:

  • Input validation tests
  • Network support tests
  • Action execution tests
  • Error handling tests
  • Mock wallet provider integration

Files Added

  • typescript/agentkit/src/action-providers/mintclub/mintclubActionProvider.ts
  • typescript/agentkit/src/action-providers/mintclub/schemas.ts
  • typescript/agentkit/src/action-providers/mintclub/constants.ts
  • typescript/agentkit/src/action-providers/mintclub/utils.ts
  • typescript/agentkit/src/action-providers/mintclub/index.ts
  • typescript/agentkit/src/action-providers/mintclub/mintclubActionProvider.test.ts
  • typescript/agentkit/src/action-providers/mintclub/README.md

Files Modified

  • typescript/agentkit/src/action-providers/index.ts (added export)

This implementation enables AI agents to seamlessly interact with Mint Club V2's bonding curve ecosystem, providing essential DeFi functionality for token creation and trading on Base.

@h1-hunt h1-hunt requested a review from murrlincoln as a code owner February 13, 2026 15:50
@cb-heimdall
Copy link

cb-heimdall commented Feb 13, 2026

🟡 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

@github-actions github-actions bot added documentation Improvements or additions to documentation action provider New action provider typescript labels Feb 13, 2026
@h1-hunt h1-hunt force-pushed the feature/mintclub-action-provider branch from 932ae5a to efc1935 Compare February 13, 2026 15:54
Add action provider for Mint Club V2 bonding curve protocol on Base.

Actions:
- get_token_info: Token details and bonding curve information
- get_token_price: Current price in reserve tokens and USD
- buy_token: Mint tokens via bonding curve
- sell_token: Burn tokens via bonding curve
- create_token: Create new token with bonding curve

Uses viem for direct contract interaction with MCV2_Bond.
Includes auto ERC20 approval, slippage protection, and
USD pricing via 1inch Spot Price Aggregator.

Docs: https://docs.mint.club
Protocol: https://mint.club
@h1-hunt h1-hunt force-pushed the feature/mintclub-action-provider branch from efc1935 to cfcd318 Compare February 13, 2026 16:00
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

action provider New action provider documentation Improvements or additions to documentation typescript

Development

Successfully merging this pull request may close these issues.

2 participants