Merkl — Reward Discovery & Claiming

Merkl — Reward Discovery & Claiming

Merkl is a DeFi incentive platform that distributes rewards across 50+ chains. Unlike Aave or SparkLend, Merkl is not a lending protocol — it's a reward distribution layer that incentivizes positions on other protocols.

What You Can Do

1. Browse incentivized opportunities — find DeFi positions earning Merkl rewards
2. Check unclaimed rewards — see pending/claimable rewards for a wallet
3. Claim rewards — encode and submit claim transactions

Transaction Tools

• execute_tx — submit a single claim transaction (no approve needed)

CLI Scripts

Browse Opportunities

node ${CLAUDE_PLUGIN_DATA}/dist/skills/merkl-agentic-wallet/merkl.js opportunities [--chain-id <id>] [--protocol <name>] [--token <symbol|addr>]

Examples:

# All live opportunities
node ${CLAUDE_PLUGIN_DATA}/dist/skills/merkl-agentic-wallet/merkl.js opportunities

# Aave opportunities on Ethereum
node ${CLAUDE_PLUGIN_DATA}/dist/skills/merkl-agentic-wallet/merkl.js opportunities --chain-id 1 --protocol aave

# USDC opportunities
node ${CLAUDE_PLUGIN_DATA}/dist/skills/merkl-agentic-wallet/merkl.js opportunities --token USDC

Check Rewards

node ${CLAUDE_PLUGIN_DATA}/dist/skills/merkl-agentic-wallet/merkl.js check-rewards --wallet <addr> [--chain-id <id>]

Examples:

# All chains
node ${CLAUDE_PLUGIN_DATA}/dist/skills/merkl-agentic-wallet/merkl.js check-rewards --wallet 0x1234...

# Specific chain
node ${CLAUDE_PLUGIN_DATA}/dist/skills/merkl-agentic-wallet/merkl.js check-rewards --wallet 0x1234... --chain-id 1

Claim Rewards

node ${CLAUDE_PLUGIN_DATA}/dist/skills/merkl-agentic-wallet/merkl.js claim-rewards --wallet <addr> --chain-id <id> [--token <symbol|addr>]

Examples:

# Claim all rewards on Ethereum
node ${CLAUDE_PLUGIN_DATA}/dist/skills/merkl-agentic-wallet/merkl.js claim-rewards --wallet 0x1234... --chain-id 1

# Claim specific token
node ${CLAUDE_PLUGIN_DATA}/dist/skills/merkl-agentic-wallet/merkl.js claim-rewards --wallet 0x1234... --chain-id 1 --token USDC

Distributor Contract

Address: 0x3Ef3D8bA38EBe18DB133cEc108f4D14CE00Dd9Ae (same proxy on most chains)

Claim ABI

claim(address[] users, address[] tokens, uint256[] amounts, bytes32[][] proofs)

• users — recipient addresses (from API response)
• tokens — reward token addresses
• amounts — cumulative amounts (raw bigint, not human-readable)
• proofs — merkle proofs per token (from API response)

Cross-Protocol Guidance

Merkl incentivizes positions on many protocols. When an opportunity shows:

• Protocol: aave → Use the /aave skill to supply/lend. Merkl rewards accrue automatically.
• Protocol: spark → Use the /spark skill. Same behavior.
• Other protocols → Report the opportunity to the user with the deposit URL.

Workflow

1. Check wallet via list_wallets to get sessionId and address
2. Check rewards: merkl check-rewards --wallet <addr>
3. If rewards exist, claim: merkl claim-rewards --wallet <addr> --chain-id <id>
4. Submit claim via execute_tx with the returned {to, data, value: "0"}
5. Verify: merkl check-rewards --wallet <addr> --chain-id <id> again

Common Mistakes

Mistake	Fix
Merkle proofs expired	Proofs are valid ~4 hours. Always encode + submit promptly.
Missing --chain-id on claim	Chain ID is required for claiming — the Distributor is per-chain.
Trying to approve before claim	No approve needed — the Distributor sends tokens directly.
Using execute_batch_tx for claim	Use execute_tx — claim is a single transaction.
Claiming with no unclaimed rewards	Always check-rewards first to verify there are claimable amounts.