onchainkit
Build onchain applications with React components and TypeScript utilities from Coinbase's OnchainKit
Install / Use
npx skills add BankrBot/skills --skill onchainkitInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
AutomationSupported Platforms
Our assessment of onchainkit
onchainkit scores 89/100 on our quality scale, 1389th of 2,790 Automation skills we index (top 50%).
Its SKILL.md is 9.3 KB long, well organised into 44 sections with 14 code examples: a thorough specification that gives an agent plenty to work with.
With 1,201 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so onchainkit is actively maintained.
- Our last check on 2026-10-31 found the source still online.
- No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
- Its trust signals score 88/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-06. Automated pattern scan on 2026-10-05. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
onchainkit compared with similar skills
All 4 of these similar skills score higher than onchainkit; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| onchainkit (this skill)by BankrBot | 89 | 1.2k | 54d ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 81.9k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.md |
| Claude-Code-Game-Studiosby Donchitos | 100 | 39.7k | 7d ago | CLAUDE.md |
Frequently asked questions
- How do I install onchainkit?
- Run
npx skills add BankrBot/skills --skill onchainkit. The install tabs above show the steps for each supported agent. - Which AI agents does onchainkit work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is onchainkit safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It declares no license and scores 88/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is onchainkit still maintained?
- The repository was last updated about 2 months ago, so onchainkit is actively maintained.
Skill content
View source on GitHubname: onchainkit description: Build onchain applications with React components and TypeScript utilities from Coinbase's OnchainKit. Use when users want to create crypto wallets, swap tokens, mint NFTs, build payments, display blockchain identities, or develop any onchain app functionality. Supports wallet connection, transaction building, token operations, identity management, and complete onchain app development workflows.
OnchainKit
Build production-ready onchain applications using Coinbase's comprehensive React component library and TypeScript utilities.
Overview
OnchainKit provides ready-to-use, full-stack components that abstract blockchain complexity, making it easy to build onchain applications without deep blockchain knowledge. It offers AI-friendly components that work automatically on Base, requires no backend infrastructure, and provides cost-effective transactions (< $0.01 fees).
Quick Start
New Project Setup
# Create a new onchain app with all batteries included
scripts/create-onchain-app.py <project-name>
# Verify setup
scripts/validate-setup.py
Add to Existing Project
npm install @coinbase/onchainkit
# Setup configuration and providers
scripts/setup-environment.py
Core Capabilities
1. Wallet Connection & Management
Connect users to their crypto wallets with minimal code:
import { Wallet, ConnectWallet } from '@coinbase/onchainkit/wallet';
function WalletConnection() {
return (
<Wallet>
<ConnectWallet />
</Wallet>
);
}
Use cases:
- Wallet connection flows
- Display wallet status
- Manage connection state
- Handle multiple wallets
Reference: references/wallet-integration.md
2. Identity Display
Show blockchain identities with ENS names, avatars, and verification badges:
import { Identity, Avatar, Name, Badge } from '@coinbase/onchainkit/identity';
function UserProfile({ address }) {
return (
<Identity address={address}>
<Avatar />
<Name />
<Badge />
</Identity>
);
}
Reference: references/identity-components.md
3. Token Operations
Handle token swaps, purchases, and transfers:
import { Swap, SwapAmountInput, SwapButton } from '@coinbase/onchainkit/swap';
function TokenSwap() {
return (
<Swap>
<SwapAmountInput />
<SwapButton />
</Swap>
);
}
Supported operations:
- Token swaps (any ERC-20)
- Token purchases with fiat
- Balance displays
- Price feeds
Reference: references/token-operations.md
4. Transaction Building
Create and execute blockchain transactions:
import { Transaction, TransactionButton } from '@coinbase/onchainkit/transaction';
function SendTransaction({ calls }) {
return (
<Transaction calls={calls}>
<TransactionButton />
</Transaction>
);
}
Reference: references/transactions.md
5. Payment Processing
Build checkout flows and payment processing:
import { Checkout, CheckoutButton } from '@coinbase/onchainkit/checkout';
function PaymentFlow() {
return (
<Checkout>
<CheckoutButton />
</Checkout>
);
}
Reference: references/payments.md
6. NFT Integration
Display, mint, and manage NFTs:
import { NFTCard } from '@coinbase/onchainkit/nft';
function NFTDisplay({ contract, tokenId }) {
return <NFTCard contract={contract} tokenId={tokenId} />;
}
Reference: references/nft-integration.md
Common Workflows
Setting Up a Complete App
- Initialize project with
create-onchain-app.py - Configure providers using setup templates
- Add wallet connection with Wallet components
- Implement core features (swap, buy, identity)
- Test and deploy with validation scripts
Building a Token Swap App
- Start with swap app template from
assets/templates/swap-app/ - Configure token lists and supported chains
- Add wallet connection flow
- Implement swap interface
- Add transaction confirmations
Creating an NFT Marketplace
- Use NFT template from
assets/templates/nft-mint/ - Set up NFT contract integration
- Build minting interface
- Add payment processing
- Implement collection browsing
Configuration & Setup
Environment Variables
# Required for API access
NEXT_PUBLIC_CDP_API_KEY="your-api-key"
NEXT_PUBLIC_WC_PROJECT_ID="your-walletconnect-id"
# Optional configurations
NEXT_PUBLIC_CHAIN_ID="8453" # Base mainnet
Reference: references/configuration.md
Provider Setup
OnchainKit requires proper React provider configuration:
import { OnchainKitProvider } from '@coinbase/onchainkit';
import { WagmiProvider } from 'wagmi';
function App() {
return (
<WagmiProvider config={wagmiConfig}>
<OnchainKitProvider
apiKey={process.env.NEXT_PUBLIC_CDP_API_KEY}
chain={base}
>
{/* Your app components */}
</OnchainKitProvider>
</WagmiProvider>
);
}
Component Patterns
Progressive Enhancement
Start simple, add features as needed:
// Basic wallet connection
<ConnectWallet />
// Enhanced with custom styling
<ConnectWallet className="custom-wallet-button" />
// Full wallet interface with status
<Wallet>
<ConnectWallet />
<WalletDropdown>
<Identity />
<WalletDropdownDisconnect />
</WalletDropdown>
</Wallet>
Composable Architecture
Mix and match components for custom workflows:
function CustomApp() {
return (
<div>
{/* User identity */}
<Identity address={address}>
<Avatar />
<Name />
</Identity>
{/* Token operations */}
<Swap>
<SwapAmountInput />
<SwapButton />
</Swap>
{/* Payment processing */}
<Checkout>
<CheckoutButton />
</Checkout>
</div>
);
}
Best Practices
Performance
- Use component-level imports:
import { Wallet } from '@coinbase/onchainkit/wallet' - Implement proper loading states
- Cache API responses appropriately
- Optimize for mobile experiences
Security
- Never expose private keys in client code
- Validate all transaction parameters
- Use official OnchainKit providers
- Implement proper error boundaries
User Experience
- Provide clear transaction confirmations
- Show loading states during blockchain operations
- Handle wallet connection failures gracefully
- Support multiple wallet types
Reference: references/best-practices.md
Troubleshooting
Common Issues
- Wallet connection fails: Check WalletConnect configuration
- API errors: Verify API key and network settings
- Transaction reverts: Validate contract calls and gas limits
- Styling issues: Import OnchainKit CSS properly
Debug Steps
- Check browser console for errors
- Verify environment variables
- Test with different wallets
- Use validation script to check setup
Reference: references/troubleshooting.md
Templates & Examples
Quick Start Templates
- Basic App:
assets/templates/basic-app/- Minimal onchain app - Token Swap:
assets/templates/swap-app/- Complete swap interface - NFT Minting:
assets/templates/nft-mint/- NFT marketplace - Commerce:
assets/templates/commerce/- Onchain store
Real-World Examples
- Wallet connection with identity display
- Multi-token swap interface
- NFT collection with minting
- Payment processing with receipts
Reference: references/examples.md
Advanced Features
Custom Chains
Support additional EVM chains beyond Base:
const customChain = {
id: 123456,
name: 'Custom Chain',
// ... chain configuration
};
<OnchainKitProvider chain={customChain}>
MiniKit Integration
Build Farcaster Frame applications:
import { useMiniKit } from '@coinbase/onchainkit/minikit';
function FrameApp() {
const { isReady } = useMiniKit();
return isReady ? <YourFrameContent /> : <Loading />;
}
Reference: references/advanced-features.md
API Reference
OnchainKit provides both React components and utility functions:
- Components: Pre-built UI components for common onchain operations
- Hooks: React hooks for blockchain state management
- Utilities: TypeScript utilities for data formatting and validation
- Types: Complete TypeScript definitions
Reference: references/api-reference.md
Resources
Documentation
- Official docs: onchainkit.xyz
- GitHub: github.com/coinbase/onchainkit
- Examples: OnchainKit playground
Support
- Discord: Coinbase Developer Platform
- Twitter: @OnchainKit
💡 Pro Tip: Start with npm create onchain to bootstrap a working app, then customize components as needed. The quickstart template includes all necessary configuration and examples.
🚀 Quick Win: Use the validation script after setup to ensure everything is working correctly before building custom features.
Related Skills
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ruflo
81.9k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
79.8kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Claude-Code-Game-Studios
39.7kTurn Claude Code into a full game dev studio — 49 AI agents, 72 workflow skills, and a complete coordination system mirroring real studio hierarchy.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
