Skip to content

Conversation

@xiaoxiaff
Copy link

Description

This PR adds the CARV Action Provider to AgentKit, enabling social identity to blockchain address resolution through the CARV Protocol API.

Key Features

  • Social ID to Address Resolution: Convert Discord IDs and Twitter usernames to blockchain addresses
  • Balance Queries: Get token balances by social IDs
  • Multi-chain Support: Works with Ethereum, BSC, Base, Polygon, and more
  • Network-agnostic Design: Compatible with any blockchain network in AgentKit

This enables powerful use cases like:

  • Social tipping on Discord/Twitter without needing wallet addresses
  • Token distribution through social mentions
  • DAO voting via social platforms
  • Governance actions triggered by social interactions

Tests

Network: Base Mainnet
Setup: Twitter bot with CARV API key configured, monitoring mentions
Prompt: User tweets "@Yourbot send me 50 CARV"
[User Context: Twitter ID: 123456789, Username: @Gatsbyter, Tweet ID: 1234567890]
Getting address for Twitter user: gatsbyter
Successfully retrieved user address by Twitter ID:

{
  "user_address": "0xacf85e57cfff872a076ec1e5350fd959d08763db",
  "balance": "21.585240",
  "chain_name": "base",
  "token_ticker": "carv"
}

Transferring 50 CARV to 0xacf85e57cfff872a076ec1e5350fd959d08763db...
Transaction hash: 0xabc123def456...
Bot replies:

✅ Transfer complete via Base AgentKit!
From: 0x1234...5678
To: 0xacf8...3db
Amount: 50 CARV
Tx: 0xabc123...def456
View: basescan.org/tx/0xabc123...def456

Examples: https://x.com/CARVAgent/status/1978063378116383163

Checklist

A couple of things to include in your PR for completeness:

  • Added documentation to all relevant README.md files
  • Added a changelog entry

@cb-heimdall
Copy link

🟡 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 Oct 14, 2025
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