diff --git a/docs/ai-agents/llms-full.txt b/docs/ai-agents/llms-full.txt index adecb9476..6e6a89e08 100644 --- a/docs/ai-agents/llms-full.txt +++ b/docs/ai-agents/llms-full.txt @@ -35,16 +35,23 @@ - [Trade Execution](https://docs.base.org/ai-agents/trading/trade-execution.md) — Execute swaps with wallet-native tools; Flashblocks patterns, fee calibration, and onchain signals ### Skills -- [Skills Overview](https://docs.base.org/ai-agents/skills/index.md) — Install with `npx skills add base/base-skills`; agent picks the right skill automatically -- [Building with Base Account](https://docs.base.org/ai-agents/skills/base-account/building-with-base-account.md) — Auth, payments, subscriptions, sub-accounts, and gas sponsorship via Base Account SDK -- [Adding Builder Codes](https://docs.base.org/ai-agents/skills/base-chain/adding-builder-codes.md) — Append ERC-8021 attribution data across Privy, Wagmi, Viem, and standard RPC -- [Connecting to Base Network](https://docs.base.org/ai-agents/skills/base-chain/connecting-to-base-network.md) — Chain IDs, RPC endpoints, and explorer URLs for Base Mainnet and Sepolia -- [Deploying Contracts](https://docs.base.org/ai-agents/skills/base-chain/deploying-contracts.md) — Deploy and verify contracts on Base using Foundry, with troubleshooting guidance -- [Running a Base Node](https://docs.base.org/ai-agents/skills/base-chain/running-a-base-node.md) — Production node setup, hardware requirements, networking ports, and syncing guidance -- [Convert Farcaster Mini App to App](https://docs.base.org/ai-agents/skills/migrations/convert-farcaster-miniapp-to-app.md) — Automated migration from Farcaster mini app to standard web app -- [Converting MiniKit to Farcaster](https://docs.base.org/ai-agents/skills/migrations/converting-minikit-to-farcaster.md) — MiniKit to Farcaster migration -- [Migrating an OnchainKit App](https://docs.base.org/ai-agents/skills/migrations/migrating-an-onchainkit-app.md) — OnchainKit app migration +- [Skills Overview](https://docs.base.org/ai-agents/skills/index.md) — Installable capabilities: wallets, payments, market data, and swap execution; agent picks the right skill automatically +#### Wallets +- [Bankr](https://docs.base.org/ai-agents/skills/wallets/bankr.md) — Self-custodied wallet across Base, ETH, Solana, Polygon, Unichain; gas sponsored; built-in swap and token launch tools; install via `install the bankr skill from https://github.com/BankrBot/skills` +- [CDP Agentic Wallet](https://docs.base.org/ai-agents/skills/wallets/cdp-agentic-wallet.md) — Email OTP auth, no private keys in agent context; 7-skill bundle covering auth, fund, send, trade, and x402 search/pay/monetize; install via `npx skills add coinbase/agentic-wallet-skills` +- [Sponge Wallet](https://docs.base.org/ai-agents/skills/wallets/sponge-wallet.md) — Multi-chain wallet (Base, ETH, Solana) with native x402 proxy, swaps, cross-chain bridges via deBridge, Polymarket/Hyperliquid trading, and banking via Bridge.xyz; register via REST API + +#### Payments +- [CDP Payment Skills](https://docs.base.org/ai-agents/skills/payments/cdp-payment-skills.md) — Full x402 loop: `search-for-service` (find APIs), `pay-for-service` (auto-pay 402), `monetize-service` (gate own endpoints); included in CDP Agentic Wallet bundle +- [Sponge x402](https://docs.base.org/ai-agents/skills/payments/sponge-x402.md) — Sponge's built-in proxy: discover services, sign payment, retry transparently; also creates reusable payment links for your own services; included with Sponge Wallet + +#### Trading +- [CoinGecko](https://docs.base.org/ai-agents/skills/trading/coingecko.md) — Live price feeds, market cap, volume, and OHLCV via x402; pay per call in USDC through any wallet skill; no API key or subscription +- [Alchemy Agentic Gateway](https://docs.base.org/ai-agents/skills/trading/alchemy-agentic-gateway.md) — Token balances, NFT metadata, portfolio data, token prices, decoded tx history at `https://x402.alchemy.com`; authenticated via SIWE, paid per call via x402; install via `npx @alchemy/x402 wallet generate` +- [Swap Execution](https://docs.base.org/ai-agents/skills/trading/swap-execution.md) — Token swaps via wallet-native tools; Bankr and CDP sponsor gas; Sponge bridges cross-chain via deBridge; all three support preconf simulation before execution + +#### Base Chain & Migrations ## Key Concepts (excerpts) @@ -55,7 +62,7 @@ Base gives your AI agent the tools to operate as an independent economic actor: - **Payments**: Pay for API access automatically with stablecoins using the x402 pay-per-request protocol - **Identity**: Register in the ERC-8004 public directory so other agents and services can discover and verify your agent - **Trading**: Use Flashblocks for 200ms preconfirmed state and exposed L1/L2 fees for cost-vs-speed tradeoffs -- **Skills**: Install structured knowledge packs to give your AI coding assistant deep context on Base APIs +- **Skills**: Install wallet, payment, data, and swap skills to give your agent ready-to-use onchain capabilities Source: `https://docs.base.org/ai-agents/setup/wallet-setup.md` @@ -111,10 +118,11 @@ Key patterns: Source: `https://docs.base.org/ai-agents/skills/index.md` -Install all Base Skills: - -```bash -npx skills add base/base-skills -``` +Skills are installable capabilities that give your AI agent specific onchain functionality — a wallet, payment handling, market data access, or trade execution. Install a skill and your agent knows what to do without any custom integration code. -Skills plug into Claude Code, Cursor, Windsurf, and other AI coding assistants. The agent picks the right skill automatically based on what you're building — no prompting required. +Available skill categories: +- **Wallets** — Bankr, CDP Agentic Wallet, Sponge Wallet +- **Payments** — CDP Payment Skills (`search-for-service`, `pay-for-service`, `monetize-service`), Sponge x402 proxy +- **Trading** — CoinGecko price feeds, Alchemy Agentic Gateway, Swap Execution (Bankr/CDP/Sponge) +- **Base Chain** — Builder codes, network config, contract deployment, node ops +- **Migrations** — Farcaster mini app → web app, MiniKit → Farcaster, OnchainKit migration diff --git a/docs/ai-agents/llms.txt b/docs/ai-agents/llms.txt index 7ff30cf46..557918f53 100644 --- a/docs/ai-agents/llms.txt +++ b/docs/ai-agents/llms.txt @@ -25,12 +25,18 @@ - [Trade Execution](https://docs.base.org/ai-agents/trading/trade-execution.md) — Execute token swaps using Flashblocks and Base-specific onchain signals ## Skills -- [Skills Overview](https://docs.base.org/ai-agents/skills/index.md) — Installable knowledge packs that give AI coding assistants deep context on Base APIs -- [Building with Base Account](https://docs.base.org/ai-agents/skills/base-account/building-with-base-account.md) — Auth, payments, subscriptions, sub-accounts, and gas sponsorship -- [Adding Builder Codes](https://docs.base.org/ai-agents/skills/base-chain/adding-builder-codes.md) — Append ERC-8021 attribution data to transactions -- [Connecting to Base Network](https://docs.base.org/ai-agents/skills/base-chain/connecting-to-base-network.md) — Chain IDs, RPC endpoints, and explorer URLs -- [Deploying Contracts](https://docs.base.org/ai-agents/skills/base-chain/deploying-contracts.md) — Deploy and verify contracts on Base using Foundry -- [Running a Base Node](https://docs.base.org/ai-agents/skills/base-chain/running-a-base-node.md) — Production node setup, hardware requirements, and syncing guidance -- [Convert Farcaster Mini App to App](https://docs.base.org/ai-agents/skills/migrations/convert-farcaster-miniapp-to-app.md) — Migrate Farcaster mini apps to standard web apps -- [Converting MiniKit to Farcaster](https://docs.base.org/ai-agents/skills/migrations/converting-minikit-to-farcaster.md) — MiniKit to Farcaster migration skill -- [Migrating an OnchainKit App](https://docs.base.org/ai-agents/skills/migrations/migrating-an-onchainkit-app.md) — OnchainKit migration guidance +- [Skills Overview](https://docs.base.org/ai-agents/skills/index.md) — Installable capabilities that give your AI agent a wallet, payments, market data access, or trade execution + +### Wallets +- [Bankr](https://docs.base.org/ai-agents/skills/wallets/bankr.md) — Cross-chain wallet with built-in swaps, gas sponsorship, and token launching (Base, ETH, Solana, Polygon, Unichain) +- [CDP Agentic Wallet](https://docs.base.org/ai-agents/skills/wallets/cdp-agentic-wallet.md) — Email OTP–authenticated wallet on Base with x402 payments built in +- [Sponge Wallet](https://docs.base.org/ai-agents/skills/wallets/sponge-wallet.md) — Multi-chain wallet with native x402 proxy, swaps, bridges, and banking + +### Payments +- [CDP Payment Skills](https://docs.base.org/ai-agents/skills/payments/cdp-payment-skills.md) — Discover, pay for, and monetize x402 API services via the CDP Agentic Wallet +- [Sponge x402](https://docs.base.org/ai-agents/skills/payments/sponge-x402.md) — Sponge's built-in x402 proxy — discover and pay for services automatically + +### Trading +- [CoinGecko](https://docs.base.org/ai-agents/skills/trading/coingecko.md) — Price feeds, market cap, and OHLCV data via x402 — no API key required +- [Alchemy Agentic Gateway](https://docs.base.org/ai-agents/skills/trading/alchemy-agentic-gateway.md) — Token balances, NFT metadata, portfolio data, and prices via x402 SIWE auth +- [Swap Execution](https://docs.base.org/ai-agents/skills/trading/swap-execution.md) — Execute token swaps using wallet-native skills across Bankr, CDP, and Sponge diff --git a/docs/ai-agents/skills/base-account/building-with-base-account.mdx b/docs/ai-agents/skills/base-account/building-with-base-account.mdx deleted file mode 100644 index dae238a05..000000000 --- a/docs/ai-agents/skills/base-account/building-with-base-account.mdx +++ /dev/null @@ -1,40 +0,0 @@ ---- -title: "Building with Base Account" -description: "Skill that teaches your AI coding assistant how to build with the Base Account SDK — auth, payments, subscriptions, sub accounts, and gas sponsorship" -keywords: ["Base Account skill", "SIWB", "Base Pay", "Paymaster", "sub accounts", "spend permissions", "Base Account SDK"] ---- - -The **Building with Base Account** skill teaches your AI coding assistant how to implement Base Account features in your app. Install it once and your agent knows the correct implementation path for authentication, one-tap payments, recurring charges, embedded sub accounts, and gas sponsorship. - -## Install - -```bash Terminal -npx skills add base/base-skills -``` - -Once installed, ask your agent to implement any Base Account feature and it will follow the correct steps automatically. - -## What the skill covers - -| Feature | Description | -|---------|-------------| -| **Sign in with Base (SIWB)** | Build your authentication flow with Base Account | -| **Base Pay** | Accept One-tap USDC payments with a single SDK call | -| **Subscriptions** | Recurring charges via spend permissions | -| **Sub accounts** | Embedded wallets scoped to your app | -| **Paymasters** | Gas sponsorship so users pay no ETH fees | -| **Batch transactions** | Bundle multiple calls into a single user operation | -| **Prolinks** | Shareable payment links for off-app flows | - -## Example prompts - -- "Add Sign in with Base to my Next.js app" -- "Let users pay with USDC using Base Pay" -- "Set up spend permissions for monthly subscriptions" -- "Create a sub account for each user on sign-up" -- "Sponsor gas for all transactions in my app" - -## Reference - -- [Base Account documentation](/base-account/overview/what-is-base-account) -- [Skill source on GitHub](https://github.com/base/skills/tree/master/skills/building-with-base-account) diff --git a/docs/ai-agents/skills/base-chain/adding-builder-codes.mdx b/docs/ai-agents/skills/base-chain/adding-builder-codes.mdx deleted file mode 100644 index 9a4098c07..000000000 --- a/docs/ai-agents/skills/base-chain/adding-builder-codes.mdx +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: "Adding Builder Codes" -description: "Skill that teaches your AI agent how to append ERC-8021 attribution data to transactions so your app earns referral fees on Base" -keywords: ["builder codes", "ERC-8021", "Base attribution", "referral fees", "builder code skill", "Privy Wagmi Viem attribution"] ---- - -The **Adding Builder Codes** skill gives your AI coding assistant everything it needs to add ERC-8021 attribution to your app's transactions. This lets Base attribute onchain activity to your app and enables referral fee earnings. - -## Install - -```bash Terminal -npx skills add base/base-skills -``` - -## What the skill covers - -The skill detects your stack and applies the correct integration path: - -| Stack | Approach | -|-------|---------| -| **Privy** | `dataSuffix` plugin in `PrivyProvider` | -| **Wagmi** | `dataSuffix` option in `useWriteContract` / `useSendTransaction` | -| **Viem** | Append suffix when calling `writeContract` or `sendTransaction` | -| **Standard RPC** | Manually append hex suffix to transaction calldata | - -The skill prioritises detection in this order: **Privy → Wagmi → Viem → Standard RPC**. - -## How it works - -Builder Codes are ERC-721 NFTs on Base. Appending your code as an ERC-8021 suffix to transaction calldata attributes that transaction to your app. The gas overhead is minimal — 16 gas per non-zero byte. - -## Example prompts - -- "Add my builder code to all outgoing transactions" -- "Set up builder code attribution for my Wagmi app" -- "How do I earn referral fees on Base?" - -## Reference - -- [Base Builder Codes](https://base.dev) -- [Skill source on GitHub](https://github.com/base/skills/tree/master/skills/adding-builder-codes) diff --git a/docs/ai-agents/skills/base-chain/connecting-to-base-network.mdx b/docs/ai-agents/skills/base-chain/connecting-to-base-network.mdx deleted file mode 100644 index 18cc6ade3..000000000 --- a/docs/ai-agents/skills/base-chain/connecting-to-base-network.mdx +++ /dev/null @@ -1,34 +0,0 @@ ---- -title: "Connecting to Base Network" -description: "Skill that gives your AI agent Base Mainnet and Sepolia network config — chain IDs, RPC endpoints, and explorer URLs" -keywords: ["Base network", "Base chain ID", "Base RPC", "Base Sepolia", "connect to Base", "Base network config"] ---- - -The **Connecting to Base Network** skill gives your AI coding assistant accurate, up-to-date configuration for Base Mainnet and Base Sepolia so it never has to guess chain IDs or RPC URLs. - -## Install - -```bash Terminal -npx skills add base/base-skills -``` - -## What the skill covers - -| | Base Mainnet | Base Sepolia | -|-|-------------|-------------| -| **Chain ID** | 8453 | 84532 | -| **Network type** | Production | Testnet | - -The skill includes RPC endpoints, WebSocket endpoints, block explorer URLs, and bridge addresses for both networks. - -## Example prompts - -- "Configure my app to connect to Base mainnet" -- "Set up Base Sepolia for testing" -- "What's the chain ID for Base?" -- "Add Base network to my wagmi config" - -## Reference - -- [Base network information](/base-chain/network-information/base-contracts) -- [Skill source on GitHub](https://github.com/base/skills/tree/master/skills/connecting-to-base-network) diff --git a/docs/ai-agents/skills/base-chain/deploying-contracts.mdx b/docs/ai-agents/skills/base-chain/deploying-contracts.mdx deleted file mode 100644 index dad885e5c..000000000 --- a/docs/ai-agents/skills/base-chain/deploying-contracts.mdx +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: "Deploying Contracts on Base" -description: "Skill that guides your AI agent through deploying and verifying smart contracts on Base using Foundry" -keywords: ["deploy contracts Base", "Foundry Base", "verify contract Base", "smart contract deployment", "Base Sepolia deploy"] ---- - -The **Deploying Contracts on Base** skill gives your AI coding assistant a complete guide for deploying and verifying smart contracts on Base with Foundry, including common failure modes and fixes. - -## Install - -```bash Terminal -npx skills add base/base-skills -``` - -## What the skill covers - -- Setting up Foundry for Base Mainnet and Base Sepolia -- Running `forge deploy` with the correct RPC and chain ID -- Verifying contracts on Basescan via `forge verify-contract` -- Common deployment failures and how to fix them (gas estimation errors, nonce mismatches, RPC timeouts) - -## Example prompts - -- "Deploy my ERC-20 contract to Base Sepolia" -- "Verify my deployed contract on Basescan" -- "My Foundry deploy is failing with a gas estimation error" -- "Set up my `foundry.toml` for Base" - -## Reference - -- [Base network information](/base-chain/network-information/base-contracts) -- [Skill source on GitHub](https://github.com/base/skills/tree/master/skills/deploying-contracts-on-base) diff --git a/docs/ai-agents/skills/base-chain/running-a-base-node.mdx b/docs/ai-agents/skills/base-chain/running-a-base-node.mdx deleted file mode 100644 index 870a9ff1c..000000000 --- a/docs/ai-agents/skills/base-chain/running-a-base-node.mdx +++ /dev/null @@ -1,33 +0,0 @@ ---- -title: "Running a Base Node" -description: "Skill that covers production Base node setup — hardware requirements, networking ports, and syncing guidance" -keywords: ["Base node", "run Base node", "Base full node", "op-geth", "Base node setup", "Base RPC node"] ---- - -The **Running a Base Node** skill gives your AI coding assistant a complete reference for setting up and operating a Base node in production, including hardware specs, port configuration, and sync strategies. - -## Install - -```bash Terminal -npx skills add base/base-skills -``` - -## What the skill covers - -- Minimum and recommended hardware requirements (CPU, RAM, disk) -- Docker Compose and bare-metal setup for `op-geth` and `op-node` -- Required networking ports and firewall rules -- Snap sync vs full sync tradeoffs -- Health check endpoints and monitoring - -## Example prompts - -- "Set up a Base full node with Docker" -- "What hardware do I need to run a Base node?" -- "Configure networking ports for my Base node" -- "My node is stuck syncing — how do I fix it?" - -## Reference - -- [Node providers](/base-chain/node-operators/node-providers) -- [Skill source on GitHub](https://github.com/base/skills/tree/master/skills/running-a-base-node) diff --git a/docs/ai-agents/skills/index.mdx b/docs/ai-agents/skills/index.mdx index c0e358f22..6ffde202c 100644 --- a/docs/ai-agents/skills/index.mdx +++ b/docs/ai-agents/skills/index.mdx @@ -1,51 +1,41 @@ --- title: "Overview" -description: "Installable skill packs that give AI agents deep knowledge of Base APIs, tools, and migration paths" -keywords: ["Base skills", "AI agent skills", "skills CLI", "Base SDK", "onchain agent tools"] +description: "Installable agent capabilities for wallets, payments, and trading on Base" +keywords: ["agent skills", "Bankr", "CDP agentic wallet", "Sponge wallet", "x402 skills", "trading agent", "Base agent"] --- -Base Skills are structured knowledge packs that plug into AI coding assistants — Claude Code, Cursor, Windsurf, and others. Install a skill and your agent gains step-by-step guidance, security rules, and implementation patterns for that topic without any prompting. +Skills are installable knowledge packs that give your AI agent specific onchain capabilities — a wallet, payment handling, market data access, or trade execution. Install a skill and your agent knows what to do without any custom integration code. -## Install - -```bash Terminal -npx skills add base/base-skills -``` - -Skills are available to the agent immediately after installation. The agent picks the right skill automatically based on what you're building. - -## Available skills - - - - Auth, payments, subscriptions, sub accounts, and gas sponsorship via the Base Account SDK. + + + Cross-chain wallet with built-in swaps, gas sponsorship, and token launching. - - Append ERC-8021 attribution data to transactions across Privy, Wagmi, Viem, and standard RPC. + + Email-authenticated wallet on Base with x402 payment skills bundled in. - - Chain IDs, RPC endpoints, and explorer URLs for Base Mainnet and Sepolia. + + Multi-chain wallet with native x402 proxy, swaps, bridges, and banking. - - Deploy and verify contracts on Base using Foundry, with common troubleshooting guidance. + + Discover, pay for, and monetize x402 API services via CDP Agentic Wallet. - - Production node setup, hardware requirements, networking ports, and syncing guidance. + + Sponge's built-in x402 proxy — discover and pay for services automatically. - - Convert a Farcaster Mini App SDK project into a standalone Base web app. + + Price feeds, market cap, and OHLCV data via x402 — no API key required. - - Migrate Mini Apps from MiniKit (OnchainKit) to the native Farcaster SDK. + + Token balances, NFT metadata, portfolio data, and prices via x402 SIWE auth. - - Replace `@coinbase/onchainkit` with standalone wagmi/viem components. + + Execute token swaps using wallet-native skills across Bankr, CDP, and Sponge. diff --git a/docs/ai-agents/skills/migrations/convert-farcaster-miniapp-to-app.mdx b/docs/ai-agents/skills/migrations/convert-farcaster-miniapp-to-app.mdx deleted file mode 100644 index ceee38d95..000000000 --- a/docs/ai-agents/skills/migrations/convert-farcaster-miniapp-to-app.mdx +++ /dev/null @@ -1,30 +0,0 @@ ---- -title: "Convert Farcaster Miniapp to App" -description: "Skill that guides your AI agent through converting a Farcaster Mini App SDK project into a standalone Base web app" -keywords: ["Farcaster miniapp to app", "Farcaster SDK migration", "Mini App conversion", "Base web app", "Farcaster skill"] ---- - -The **Convert Farcaster Miniapp to App** skill gives your AI coding assistant a step-by-step plan for converting a Farcaster Mini App SDK project into a regular Base web app. You can optionally keep a small Farcaster-specific surface for users who access from Warpcast. - -## Install - -```bash Terminal -npx skills add base/base-skills -``` - -## What the skill covers - -- Identifying Farcaster-specific SDK calls and UI surfaces -- Replacing Mini App SDK dependencies with standard web equivalents -- Preserving or removing the Farcaster embed manifest -- Optionally keeping a Farcaster-compatible entry point alongside the main app - -## Example prompts - -- "Convert my Farcaster Mini App to a regular web app" -- "Remove the Farcaster SDK from my project and make it a standalone app" -- "Keep my app working in Warpcast but also launch it as a standalone site" - -## Reference - -- [Skill source on GitHub](https://github.com/base/skills/tree/master/skills/convert-farcaster-miniapp-to-app) diff --git a/docs/ai-agents/skills/migrations/converting-minikit-to-farcaster.mdx b/docs/ai-agents/skills/migrations/converting-minikit-to-farcaster.mdx deleted file mode 100644 index a2babc3f3..000000000 --- a/docs/ai-agents/skills/migrations/converting-minikit-to-farcaster.mdx +++ /dev/null @@ -1,31 +0,0 @@ ---- -title: "Converting MiniKit to Farcaster" -description: "Skill that migrates Mini Apps from MiniKit (OnchainKit) to the native Farcaster SDK with component mappings and common pitfalls" -keywords: ["MiniKit to Farcaster", "OnchainKit MiniKit migration", "Farcaster SDK", "Mini App migration", "MiniKit skill"] ---- - -The **Converting MiniKit to Farcaster** skill gives your AI coding assistant a precise component-by-component migration guide for moving Mini Apps from MiniKit (OnchainKit) to the native Farcaster SDK. - -## Install - -```bash Terminal -npx skills add base/base-skills -``` - -## What the skill covers - -- MiniKit → Farcaster SDK component and hook mappings -- Provider replacement (`MiniKitProvider` → `FarcasterProvider`) -- Context and user data API changes -- Common pitfalls and breaking differences between the two SDKs - -## Example prompts - -- "Migrate my MiniKit app to use the native Farcaster SDK" -- "Replace MiniKitProvider with the Farcaster equivalent" -- "What changed between MiniKit and the Farcaster SDK?" - -## Reference - -- [Mini Apps overview](/mini-apps/introduction/overview) -- [Skill source on GitHub](https://github.com/base/skills/tree/master/skills/converting-minikit-to-farcaster) diff --git a/docs/ai-agents/skills/migrations/migrating-an-onchainkit-app.mdx b/docs/ai-agents/skills/migrations/migrating-an-onchainkit-app.mdx deleted file mode 100644 index 2cfc993c6..000000000 --- a/docs/ai-agents/skills/migrations/migrating-an-onchainkit-app.mdx +++ /dev/null @@ -1,36 +0,0 @@ ---- -title: "Migrating an OnchainKit App" -description: "Skill that replaces @coinbase/onchainkit with standalone wagmi/viem components — provider, wallet, and transaction migration" -keywords: ["OnchainKit migration", "wagmi viem migration", "OnchainKit to wagmi", "remove OnchainKit", "OnchainKit skill"] ---- - -The **Migrating an OnchainKit App** skill gives your AI coding assistant a five-step migration plan for replacing `@coinbase/onchainkit` with standalone `wagmi` and `viem` components. - -## Install - -```bash Terminal -npx skills add base/base-skills -``` - -## What the skill covers - -The migration follows five sequential steps, each with a validation gate before proceeding: - -| Step | What changes | -|------|-------------| -| **Detection** | Scan for OnchainKit imports and identify components in use | -| **Provider** | Replace `OnchainKitProvider` with `WagmiProvider` + `QueryClientProvider` | -| **Wallet** | Build a `WalletConnect` component using wagmi hooks | -| **Transactions** | Replace `Transaction` components with `useWriteContract` and receipt hooks | -| **Cleanup** | Remove remaining OnchainKit imports and optionally uninstall the package | - - -## Example prompts - -- "Migrate my app off OnchainKit" -- "Replace OnchainKitProvider with wagmi" -- "Convert my OnchainKit Transaction component to use wagmi hooks" - -## Reference - -- [Skill source on GitHub](https://github.com/base/skills/tree/master/skills/migrating-an-onchainkit-app) diff --git a/docs/ai-agents/skills/payments/cdp-payment-skills.mdx b/docs/ai-agents/skills/payments/cdp-payment-skills.mdx new file mode 100644 index 000000000..e49427ac7 --- /dev/null +++ b/docs/ai-agents/skills/payments/cdp-payment-skills.mdx @@ -0,0 +1,47 @@ +--- +title: "CDP Payment Skills" +description: "Skills for discovering, paying for, and monetizing x402 API services via the CDP Agentic Wallet" +keywords: ["CDP payment skills", "search-for-service skill", "pay-for-service skill", "monetize-service skill", "x402 bazaar skill"] +--- + +Three skills from the CDP Agentic Wallet bundle cover the full x402 commerce loop: finding paid APIs, calling them with automatic payment, and gating your own endpoints to charge other agents. + +## Install + +```bash Terminal +npx skills add coinbase/agentic-wallet-skills +``` + +Included in the same package as the [CDP Agentic Wallet](/ai-agents/skills/wallets/cdp-agentic-wallet). No separate install needed. + +## What the skill covers + +| Skill | What it does | +|-------|-------------| +| `search-for-service` | Search the x402 Bazaar for paid APIs by keyword or browse by network | +| `pay-for-service` | Make a paid x402 request — handles 402, payment, and retry automatically | +| `monetize-service` | Deploy a paid endpoint that other agents can discover and pay per request | + +## Example prompts + +```text +Find APIs for sentiment analysis +``` + +```text +Get the current ETH price from a paid data source +``` + +```text +Call that weather API and get the forecast for New York +``` + +```text +Set up a paid endpoint for my market data at $0.01 per request +``` + +## Reference + +- [search-for-service →](https://docs.cdp.coinbase.com/agentic-wallet/skills/search-for-service) +- [pay-for-service →](https://docs.cdp.coinbase.com/agentic-wallet/skills/pay-for-service) +- [CDP Agentic Wallet skills →](https://docs.cdp.coinbase.com/agentic-wallet/skills) diff --git a/docs/ai-agents/skills/payments/sponge-x402.mdx b/docs/ai-agents/skills/payments/sponge-x402.mdx new file mode 100644 index 000000000..0708d7116 --- /dev/null +++ b/docs/ai-agents/skills/payments/sponge-x402.mdx @@ -0,0 +1,37 @@ +--- +title: "Sponge x402" +description: "Skill for discovering and paying for x402 services automatically using Sponge Wallet's built-in proxy" +keywords: ["Sponge x402 skill", "x402 proxy skill", "automatic x402 payment skill", "discover x402 service skill", "paysponge x402 skill"] +--- + +Sponge's built-in x402 proxy handles service discovery, payment signing, and retries automatically. The skill lets your agent find and pay for any x402-gated API in a single step — no manual 402 handling, no retry logic. + +## Install + +Included with [Sponge Wallet](/ai-agents/skills/wallets/sponge-wallet). No separate install needed. + +## What the skill covers + +| Capability | Description | +|------------|-------------| +| **Service discovery** | Search the x402 catalog by keyword | +| **Automatic payment** | Detect a 402, pay in USDC, and retry transparently | +| **Payment links** | Create reusable payment links to gate your own services | + +## Example prompts + +```text +Find a weather API and pay for it using Sponge +``` + +```text +Search for sentiment analysis APIs in the x402 catalog +``` + +```text +Create a payment link for my market data service at $0.01 per request +``` + +## Reference + +- [Sponge Wallet skill doc →](https://wallet.paysponge.com/skill.md) diff --git a/docs/ai-agents/skills/trading/alchemy-agentic-gateway.mdx b/docs/ai-agents/skills/trading/alchemy-agentic-gateway.mdx new file mode 100644 index 000000000..5825974c3 --- /dev/null +++ b/docs/ai-agents/skills/trading/alchemy-agentic-gateway.mdx @@ -0,0 +1,47 @@ +--- +title: "Alchemy Agentic Gateway" +description: "Skill for accessing Alchemy's blockchain APIs — token balances, NFTs, portfolio data, and prices — via x402 SIWE auth" +keywords: ["Alchemy agentic gateway skill", "Alchemy x402 skill", "onchain data agent skill", "SIWE x402 skill", "alchemy skill agent"] +--- + +The Alchemy Agentic Gateway skill gives your agent access to Alchemy's enhanced blockchain APIs at `https://x402.alchemy.com` — token balances, NFT metadata, portfolio data, token prices, and decoded transaction history — authenticated via Sign-In With Ethereum (SIWE) and paid per call via x402. + +## Install + +```bash Terminal +npx @alchemy/x402 wallet generate +``` + +Then follow the skill setup to sign a SIWE auth token. The full setup guide is in the skill reference below. + +## What the skill covers + +| Data | Description | +|------|-------------| +| **Token balances** | ERC-20 balances for any address on Base | +| **NFT metadata** | Token attributes, images, and ownership | +| **Portfolio data** | Multi-chain token holdings with metadata | +| **Token prices** | Current prices by symbol | +| **Transaction history** | Decoded asset transfers | + +## Example prompts + +```text +Check the token balances at 0xYourAddress on Base +``` + +```text +Get the portfolio for 0xYourAddress across all chains +``` + +```text +What's the current price of ETH and USDC? +``` + +```text +Show me the NFTs owned by 0xYourAddress +``` + +## Reference + +- [Alchemy Agentic Gateway skill →](https://github.com/alchemyplatform/skills/tree/main/skills/agentic-gateway) diff --git a/docs/ai-agents/skills/trading/coingecko.mdx b/docs/ai-agents/skills/trading/coingecko.mdx new file mode 100644 index 000000000..bdbf7bd4f --- /dev/null +++ b/docs/ai-agents/skills/trading/coingecko.mdx @@ -0,0 +1,46 @@ +--- +title: "CoinGecko" +description: "Skill for fetching live crypto price feeds, market cap, and OHLCV data via x402 — no API key required" +keywords: ["CoinGecko skill", "price feed skill", "crypto market data x402 skill", "agent data source skill", "CoinGecko x402 agent"] +--- + +CoinGecko provides cryptocurrency price feeds, market cap data, and historical OHLCV via x402-enabled endpoints. Your agent pays per call in USDC — no API key, no subscription, no rate-limit tier. + +## Install + +Access CoinGecko data through your existing wallet skill: + +- **CDP Agentic Wallet** — use the `pay-for-service` skill (`npx skills add coinbase/agentic-wallet-skills`) +- **Sponge Wallet** — use the built-in x402 proxy (no extra install) +- **Bankr** — prompt directly, Bankr handles discovery and payment + +## What the skill covers + +| Data | Description | +|------|-------------| +| **Price feeds** | Current price for any asset in USD or other currencies | +| **Market data** | Market cap, volume, and circulating supply | +| **Historical OHLCV** | Open/high/low/close/volume over any time range | + +## Example prompts + +```text +Get the current ETH price from CoinGecko +``` + +```text +Get current prices for ETH, BTC, and SOL +``` + +```text +Fetch the 7-day OHLCV for Bitcoin from CoinGecko +``` + +```text +What's the market cap of Ethereum? +``` + +## Reference + +- [pay-for-service skill →](https://docs.cdp.coinbase.com/agentic-wallet/skills/pay-for-service) +- [CoinGecko API docs →](https://docs.coingecko.com) diff --git a/docs/ai-agents/skills/trading/swap-execution.mdx b/docs/ai-agents/skills/trading/swap-execution.mdx new file mode 100644 index 000000000..8a6d005ea --- /dev/null +++ b/docs/ai-agents/skills/trading/swap-execution.mdx @@ -0,0 +1,50 @@ +--- +title: "Swap Execution" +description: "Skills for executing token swaps on Base using wallet-native tools across Bankr, CDP Agentic Wallet, and Sponge" +keywords: ["swap execution skill", "token swap agent skill", "Bankr swap skill", "CDP trade skill", "Sponge swap skill"] +--- + +Bankr, CDP Agentic Wallet, and Sponge Wallet all include built-in swap skills — no external DEX integration required. Install any of the three wallet skills and your agent can trade tokens on Base with a simple prompt. + +## Install + +Choose the wallet skill that fits your agent: + +| Wallet | Install | +|--------|---------| +| **Bankr** | `install the bankr skill from https://github.com/BankrBot/skills` | +| **CDP Agentic Wallet** | `npx skills add coinbase/agentic-wallet-skills` | +| **Sponge Wallet** | Register via `https://api.wallet.paysponge.com/api/agents/register` | + +## What the skill covers + +| Capability | Bankr | CDP | Sponge | +|------------|-------|-----|--------| +| Token swaps on Base | ✓ | ✓ | ✓ | +| Cross-chain swaps | ✓ | — | ✓ (via deBridge) | +| Gas sponsorship | ✓ | ✓ | — | +| Preconf simulation | ✓ | ✓ | ✓ | + +## Example prompts + +```text +Buy $50 of ETH on Base +``` + +```text +Swap 100 USDC for ETH at market price +``` + +```text +Simulate buying $50 of ETH then execute if the price impact is below 1% +``` + +```text +Trade 0.01 ETH for USDC +``` + +## Reference + +- [Bankr docs →](https://docs.bankr.bot) +- [CDP trade skill →](https://docs.cdp.coinbase.com/agentic-wallet/skills) +- [Sponge skill doc →](https://wallet.paysponge.com/skill.md) diff --git a/docs/ai-agents/skills/wallets/bankr.mdx b/docs/ai-agents/skills/wallets/bankr.mdx new file mode 100644 index 000000000..051841362 --- /dev/null +++ b/docs/ai-agents/skills/wallets/bankr.mdx @@ -0,0 +1,50 @@ +--- +title: "Bankr" +description: "Skill that gives your AI agent a cross-chain wallet with built-in swaps, gas sponsorship, and token launching" +keywords: ["Bankr skill", "agent wallet skill", "cross-chain wallet agent", "Bankr AI agent", "bankr.bot skill"] +--- + +The Bankr skill gives your AI agent a self-custodied wallet across Base, Ethereum, Solana, Polygon, and Unichain. Gas is sponsored on supported chains, swap tools handle trades natively, and agents can launch tokens and earn trading fees to fund their own compute. + +## Install + +From your agent chat: + +```text +install the bankr skill from https://github.com/BankrBot/skills +``` + +Then create a dedicated account at [bankr.bot](https://bankr.bot) and generate an API key at [bankr.bot/api](https://bankr.bot/api). + +## What the skill covers + +| Capability | Description | +|------------|-------------| +| **Cross-chain wallet** | Hold and transfer funds on Base, ETH, Solana, Polygon, and Unichain | +| **Gas sponsorship** | Transactions on supported chains don't require ETH for gas | +| **Token swaps** | Buy and sell tokens with wallet-native tools — no DEX integration needed | +| **Token launching** | Deploy tokens on Base and redirect trading fees to the agent | +| **Trading signals** | Base network signals via the `bankr-signals` skill | + +## Example prompts + +```text +Buy $50 of ETH on Base +``` + +```text +Swap 100 USDC for ETH at market price +``` + +```text +Check my wallet balance across all chains +``` + +```text +Send 10 USDC to 0xRecipientAddress +``` + +## Reference + +- [Bankr docs →](https://docs.bankr.bot) +- [Bankr skills on GitHub →](https://github.com/BankrBot/skills) diff --git a/docs/ai-agents/skills/wallets/cdp-agentic-wallet.mdx b/docs/ai-agents/skills/wallets/cdp-agentic-wallet.mdx new file mode 100644 index 000000000..27f44d1a9 --- /dev/null +++ b/docs/ai-agents/skills/wallets/cdp-agentic-wallet.mdx @@ -0,0 +1,52 @@ +--- +title: "CDP Agentic Wallet" +description: "Skill that gives your AI agent an email-authenticated wallet on Base with x402 payments built in" +keywords: ["CDP agentic wallet skill", "coinbase agent wallet skill", "awal skill", "x402 agent skill", "npx skills add coinbase"] +--- + +The CDP Agentic Wallet skill gives your AI agent a managed wallet on Base authenticated via email OTP — no private keys in the agent's context. The skill bundle includes seven capabilities covering authentication, funding, sending, trading, and x402 payments. + +## Install + +```bash Terminal +npx skills add coinbase/agentic-wallet-skills +``` + +## What the skill covers + +| Skill | What it does | +|-------|-------------| +| `authenticate-wallet` | Sign in via email OTP — no private key required | +| `fund` | Add USDC via Coinbase Onramp | +| `send-usdc` | Send USDC to an Ethereum address or ENS name | +| `trade` | Swap tokens on Base | +| `search-for-service` | Find x402-compatible APIs in the Bazaar marketplace | +| `pay-for-service` | Make a paid x402 request automatically | +| `monetize-service` | Deploy a paid endpoint that charges other agents | + +## Example prompts + +```text +Sign in to my wallet with your@email.com +``` + +```text +Send 10 USDC to 0xRecipientAddress +``` + +```text +Trade 0.01 ETH for USDC +``` + +```text +Find a weather API and get the forecast for New York +``` + +```text +Set up a paid endpoint for my market data at $0.01 per request +``` + +## Reference + +- [CDP Agentic Wallet docs →](https://docs.cdp.coinbase.com/agentic-wallet/welcome) +- [Skill reference →](https://docs.cdp.coinbase.com/agentic-wallet/skills) diff --git a/docs/ai-agents/skills/wallets/sponge-wallet.mdx b/docs/ai-agents/skills/wallets/sponge-wallet.mdx new file mode 100644 index 000000000..f90cc9b79 --- /dev/null +++ b/docs/ai-agents/skills/wallets/sponge-wallet.mdx @@ -0,0 +1,54 @@ +--- +title: "Sponge Wallet" +description: "Skill that gives your AI agent a multi-chain wallet with native x402 payments, swaps, bridges, and banking" +keywords: ["Sponge wallet skill", "paysponge skill", "x402 proxy skill", "multi-chain agent wallet skill", "sponge skill.md"] +--- + +The Sponge Wallet skill gives your AI agent a multi-chain wallet covering Base, Ethereum, and Solana. It includes a native x402 payment proxy, token swaps, cross-chain bridges, prediction market trading, and banking integrations. + +## Install + +Register your agent to receive a wallet and API key: + +```text +Register my agent with Sponge Wallet using the API at https://api.wallet.paysponge.com/api/agents/register +``` + +Or read the full skill reference your agent can follow: + +```text +Read the Sponge skill doc at https://wallet.paysponge.com/skill.md +``` + +## What the skill covers + +| Capability | Description | +|------------|-------------| +| **Multi-chain wallet** | Hold and transfer funds on Base, Ethereum, and Solana | +| **Native x402 proxy** | Discover services, pay, and get responses in one step | +| **Token swaps** | Swap tokens on Base and Solana DEXs | +| **Cross-chain bridges** | Bridge assets across chains via deBridge | +| **Prediction markets** | Trade on Polymarket and Hyperliquid | +| **Banking** | Virtual bank accounts and ACH payouts via Bridge.xyz | + +## Example prompts + +```text +Check my Sponge wallet balance +``` + +```text +Swap 100 USDC for ETH on Base using Sponge +``` + +```text +Find a weather API and pay for it using my Sponge wallet +``` + +```text +Bridge 50 USDC from Base to Solana +``` + +## Reference + +- [Sponge Wallet skill doc →](https://wallet.paysponge.com/skill.md) diff --git a/docs/docs.json b/docs/docs.json index 0286b3a04..4d5eb4b48 100644 --- a/docs/docs.json +++ b/docs/docs.json @@ -540,26 +540,26 @@ "pages": [ "ai-agents/skills/index", { - "group": "Base Account", + "group": "Wallets", "pages": [ - "ai-agents/skills/base-account/building-with-base-account" + "ai-agents/skills/wallets/bankr", + "ai-agents/skills/wallets/cdp-agentic-wallet", + "ai-agents/skills/wallets/sponge-wallet" ] }, { - "group": "Base Chain", + "group": "Payments", "pages": [ - "ai-agents/skills/base-chain/adding-builder-codes", - "ai-agents/skills/base-chain/connecting-to-base-network", - "ai-agents/skills/base-chain/deploying-contracts", - "ai-agents/skills/base-chain/running-a-base-node" + "ai-agents/skills/payments/cdp-payment-skills", + "ai-agents/skills/payments/sponge-x402" ] }, { - "group": "Migrations", + "group": "Trading", "pages": [ - "ai-agents/skills/migrations/convert-farcaster-miniapp-to-app", - "ai-agents/skills/migrations/converting-minikit-to-farcaster", - "ai-agents/skills/migrations/migrating-an-onchainkit-app" + "ai-agents/skills/trading/coingecko", + "ai-agents/skills/trading/alchemy-agentic-gateway", + "ai-agents/skills/trading/swap-execution" ] } ] diff --git a/docs/llms.txt b/docs/llms.txt index 62a9175e9..0c06b7a14 100644 --- a/docs/llms.txt +++ b/docs/llms.txt @@ -7,7 +7,7 @@ - [Get Started](./get-started/llms.txt) — Orientation, products, use cases, and quickstarts - [Base Chain](./base-chain/llms.txt) — Deploy/connect, network info, tools, node ops, security - [Base Account](./base-account/llms.txt) — Passkey smart wallet, payments, social verification, spend permissions, sponsored gas, sub‑accounts -- [AI Agents](./ai-agents/llms.txt) — Build onchain AI agents: wallets, payments, identity, frameworks +- [AI Agents](./ai-agents/llms.txt) — Build onchain AI agents: wallets, payments, identity, trading, and installable skills - [Mini Apps](./mini-apps/llms.txt) — Migrate to standard web apps on Base, register on Base.dev, earn rewards ## Tools available for AI assistants @@ -56,6 +56,9 @@ Base is an Ethereum L2 by Coinbase. Docs for: Base Chain, Smart Wallet, OnchainK |ai-agents/payments:pay-for-services-with-x402,accepting-payments |ai-agents/trading:data-fetching,trade-execution |ai-agents/skills:index +|ai-agents/skills/wallets:bankr,cdp-agentic-wallet,sponge-wallet +|ai-agents/skills/payments:cdp-payment-skills,sponge-x402 +|ai-agents/skills/trading:coingecko,alchemy-agentic-gateway,swap-execution |ai-agents/skills/base-account:building-with-base-account |ai-agents/skills/base-chain:adding-builder-codes,connecting-to-base-network,deploying-contracts,running-a-base-node |ai-agents/skills/migrations:convert-farcaster-miniapp-to-app,converting-minikit-to-farcaster,migrating-an-onchainkit-app