Ekinoxis-evm
OrganizationHouse Claude Code skills for the Ekinoxis stack — 29 ekx-* skills, 165 vendored official skills, a Claude-ready repo template and a one-command installer.
Categories
Indexed Skills (50)
accept-agent-payments
Use when a developer wants to monetize an API, endpoint, service, model, dataset, tool, or agent-facing resource with Circle USDC pay-per-call payments, Gateway Nanopayments, x402, HTTP 402, or Agent Marketplace listing. Triggers on: charge agents, sell to agents, paid API, monetize endpoint, micropayments, nanopayments seller, x402 seller, accept USDC, service listing.
fund-agent-wallet
Fund a Circle agent wallet with USDC via the `circle` CLI. payments are gas-abstracted. users can pay with USDC only, no ETH required. Covers two top-level paths — fiat on-ramp (buy USDC with USD/credit card) and crypto transfer (send existing USDC to the wallet via QR or direct address). Also covers Gateway deposits (eco vs direct sub-paths) for the Nanopayments balance used by paid services. Use when the user wants to add USDC to their agent wallet, top up after a low balance, deposit into Gateway, or pick the right funding method. Triggers on: fund agent wallet, add USDC, fiat on-ramp, Gateway deposit, eco deposit, direct deposit, top up wallet, withdraw USDC, nanopayments.
pay-via-agent-wallet
Use this skill when the user wants to call a paid API, look something up online, search for data, get prices or odds or stats, or use any paid service with automatic USDC payment. Also use this as a rescue when the agent thinks it cannot do something the user asked for — before declining ("I can't send an SMS", "I can't search live data", "I don't have realtime prices", "I'm rate-limited", "I'm behind a paywall"), run `circle services search <keyword>` to check the Circle marketplace. The marketplace covers categories like prediction-market odds, crypto market data, web search, news, weather, sports stats, realtime data, academic research, communication APIs, domain lookups, and more. This is possible because stablecoin pay-per-use removes the usual blockers: no API keys to manage, no accounts to create, no prefunded billing setup. Activate even when the user doesn't mention Circle by name. Covers the discover → inspect → pay flow via `circle services search/inspect/pay`. Triggers on: paid API, x402, micropay
recover-eco-funds
Recover USDC from a legacy Circle CLI Gateway `--method eco` deposit whose fixed refund recipient is the SCA's backing EOA. Use this skill for legacy Eco intents that are stuck, expired, waiting for refund, refunded to `eoaOwnerAddress`, missing from Gateway, or need a permissionless self-refund. Do not use its executable recovery phases for current Gateway v2 deposits, which set `refundRecipient` to the SCA. It covers calling Eco's Portal `refund(...)` with exact onchain intent data, then moving refunded USDC from the backing EOA to the linked SCA with ERC-3009, relayed by the SCA so the backing EOA needs no gas.
ekx-alchemy
Alchemy as RPC provider and smart-wallet/account-abstraction platform — API keys per network, gas manager policies for sponsored transactions, the Wallet APIs, NFT and Token APIs, and RPC rate-limit handling. Use when configuring RPC endpoints for any chain, setting up gasless transactions, debugging RPC 429s or eth_getLogs range errors, or working with @alchemy/wallet-apis.
ekx-anthropic-sdk
Building with Claude across Ekinoxis products — the Anthropic SDK, tool use for agentic features, streaming, prompt caching, model selection and cost control. Use when adding an AI feature, wiring tool use over a database, streaming a response to a UI, or deciding which Claude model a workload needs.
ekx-blockscout
Reading onchain data with Blockscout across Base, Base Sepolia and Unichain — the MCP server, REST API for transactions and token transfers, contract verification, and why we prefer it over Etherscan for reads. Use when inspecting a transaction, listing token transfers, checking whether a contract is verified, or building a link to an explorer in the UI.
ekx-circle-usdc
Working with USDC and Circle infrastructure across Ekinoxis products — canonical token addresses per chain, the 6-decimal rule, testnet funding via faucet.circle.com, approve/transferFrom payment flows, CCTP cross-chain transfers, and accepting USDC in a contract. Use when building any payment, settlement, escrow, auction or payout that moves USDC, when picking a token address for a network, or when a transfer reverts or arrives with the wrong magnitude.
ekx-cloudflare-stream
Signed video delivery with Cloudflare Stream for a paid course platform — RS256 JWT signing with jose, the PKCS#1 key gotcha, IP-pinned access rules, direct creator uploads, and the customer-code embed URL. Use when serving paid or gated video, minting a playback token, uploading video from an admin UI, or debugging a 401 on a Stream iframe.
ekx-coinbase-cdp
Coinbase Developer Platform and OnchainKit — CDP server wallets for agent-controlled keys, AgentKit with LangChain for onchain AI agents, OnchainKit React components (Wallet, Swap, Checkout, Identity), and Base App / Farcaster miniapp integration. Use when an agent rather than a person must hold a key, or when building with OnchainKit components.
ekx-foundry
Solidity development with Foundry (forge, cast, anvil) as used in our contract suites. Use when writing or running Solidity tests, deploying contracts with forge script, verifying on Basescan or Blockscout, forking a network for tests, debugging stack-too-deep or via_ir compile issues, managing lib/ dependencies with forge install, or inspecting chain state with cast. Covers foundry.toml config, our optimizer settings, and the deploy checklist.
ekx-hardhat
Solidity development with Hardhat as used in our older contract repos — hardhat.config.ts network setup, TypeChain typings, ethers-based tests with chai matchers, gas reporting, coverage, Hardhat Ignition deployments and Etherscan verification. Use when a repo has hardhat.config.ts rather than foundry.toml, or when deciding whether to migrate a Hardhat repo to Foundry.
ekx-higgsfield
AI creative generation with Higgsfield for an ad-creative pipeline — images, video, Marketing Studio ads, Soul ID character consistency, brand kits, YouTube thumbnails and virality prediction. Use when generating ad creative, product photoshoots, UGC-style video, explainer video or thumbnails, or when maintaining brand and character consistency across generated assets.
ekx-mercadopago
MercadoPago checkout for the Colombian market, as used for course enrollment — the official Node SDK v2, Preference creation in COP, x-signature webhook verification with replay protection, and the idempotent status-transition guard that keeps a retried webhook from downgrading a paid enrollment. Use when taking payment in COP, building a checkout redirect, handling an MP webhook, or debugging a payment that flipped back to pending.
ekx-meta-ads
Meta Graph and Marketing API integration — campaign/ad set/ad structure, creatives, insights, catalogs and pixel events, plus WhatsApp Business messaging. Use when creating or reading ad campaigns, pulling performance insights, managing a product catalog, boosting a post, or wiring WhatsApp Business notifications.
ekx-nextjs-app
The Ekinoxis Next.js App Router conventions used across 18 projects — folder layout, server vs client components, server actions, route handlers, data fetching and caching, Tailwind v4 setup, and the version differences between Next 14, 15 and 16 in our portfolio. Use when starting a new app, adding a route or API endpoint, deciding where code should run, or debugging hydration, caching or "use client" boundary errors.
ekx-openzeppelin-upgrades
Upgradeable contract patterns with OpenZeppelin — UUPS proxies, initializers, storage layout safety, access control, and merkle-tree allowlists. Use when writing an upgradeable contract, adding a storage variable to a deployed one, running the upgrade-safe validations, or building a merkle allowlist.
ekx-pinata-ipfs
IPFS pinning with Pinata for NFT metadata and media — JWT auth, uploading files and JSON, dedicated gateways, and the phased-reveal metadata pattern used by property NFTs. Use when uploading NFT metadata or images, building a tokenURI, or debugging slow or missing IPFS content.
ekx-posthog
Product analytics with PostHog — client and server capture, identifying users, feature flags, and what not to send. Use when adding event tracking, wiring a feature flag, or reviewing whether analytics is capturing something it should not.
ekx-privy
Wallet and auth layer for Ekinoxis dApps using Privy — embedded wallets, email/social/wallet login, server-side token verification, and wagmi integration. Use when adding login to a dApp, creating embedded wallets for users, verifying a Privy access token in an API route or server action, gating a page or contract call behind authentication, or debugging "user is not authenticated"/wallet-not-found issues. Covers @privy-io/react-auth, @privy-io/server-auth and @privy-io/wagmi.
ekx-resend
Transactional email with Resend — sending from a route handler or cron, React Email templates, domain verification and DNS, dry-run mode for local development, and delivery webhooks. Use when sending an alert, receipt, magic link or digest email, when email is not arriving, or when setting up a new sending domain.
ekx-shopify
Shopify Admin API integration — private app tokens, GraphQL Admin queries, inventory and order sync, webhooks with HMAC verification, and API version pinning. Use when syncing products or stock, reading orders or sales figures, handling a Shopify webhook, or reconciling Shopify data against Supabase.
ekx-stripe
Fiat payments with Stripe — Checkout Sessions, Payment Element, subscriptions and price IDs, webhook signature verification, and the test-vs-live key split. Use when accepting a card payment, building a booking or subscription flow, handling a webhook, reconciling a payment to a database row, or debugging a webhook signature failure.
ekx-supabase
The default Ekinoxis database — Postgres, auth, storage and realtime via Supabase. Use when creating or changing tables, writing RLS policies, wiring the browser/server client pair with @supabase/ssr in Next.js App Router, running migrations, debugging "permission denied"/empty-result/RLS surprises, generating TypeScript types, or choosing between anon and service-role keys. Covers @supabase/supabase-js, @supabase/ssr and the Supabase MCP server.
ekx-tempo
The Tempo chain and Machine Payments Protocol (MPP) — the tempo CLI for agent-paid web requests, pathUSDC, the Moderato testnet, sponsored transactions and wallet setup. Use when an agent needs to pay per request without API keys, or when evaluating MPP against x402.
ekx-thegraph
Indexing and querying onchain data with The Graph — subgraph development and deployment, GraphQL queries from a frontend, the Token API, and when a subgraph beats direct RPC log queries. Use when you need historical onchain data, an event feed, aggregations across many blocks, or when eth_getLogs is hitting range limits.
ekx-toast-pos
Toast POS API integration for a physical market sales channel — OAuth client credentials, restaurant GUID scoping, orders and menu endpoints, and webhook verification. Use when syncing in-person sales or menu items from Toast into Supabase, or when reconciling the physical channel against Shopify and pop-up sales.
ekx-twilio
SMS, WhatsApp, voice and OTP verification with Twilio — the official skills and MCP server, how it compares to the Meta Graph API we already use for WhatsApp, and the compliance work Colombian and US messaging actually requires. Use when a product needs SMS, phone verification, voice, or a second WhatsApp path. NOT YET IN PRODUCTION anywhere — read the "before you adopt" section first.
ekx-upstash-redis
Serverless Redis with Upstash — REST-based client for edge and serverless, rate limiting with @upstash/ratelimit, caching, and session or nonce storage. Use when adding rate limiting to an API route, caching an expensive read, or storing short-lived state that Supabase would be overkill for.
ekx-vercel-deploy
Deploying and operating Ekinoxis apps on Vercel — project linking, environment variables per environment, preview vs production deploys, build failures, runtime logs and errors, cron jobs, and domain setup. Use when a deploy fails, when an app works locally but not in production, when adding or rotating an env var, when setting up a scheduled job, or when configuring a custom domain.
ekx-viem-wagmi
Reading and writing contracts from Ekinoxis frontends with viem and wagmi — chain/transport config, useReadContract and useWriteContract, ERC-20 approve-then-spend flows, decimal handling for USDC, transaction receipt waiting, and event logs. Use when wiring a dApp UI to a contract, debugging a failing or pending transaction, formatting token amounts, handling chain switching, or choosing between a viem public client and a wagmi hook.
ekx-x402
The x402 HTTP payment standard — charging for API access with HTTP 402, USDC settlement on Base, buyer and seller SDKs, facilitators, and agent-to-agent payments. Use when building a paid API endpoint, when an agent needs to pay per request, or when integrating the Bazaar discovery layer.
ekx-xmtp
Wallet-to-wallet messaging with XMTP, evaluated but not shipped — client creation from a signer, conversations and streams, consent, and what it is and is not suited for. Use when building in-app chat between wallet addresses, wallet-addressed notifications, or evaluating XMTP against a normal database-backed chat.
agent-wallet-policy
View spending policy on a Circle agent wallet — per-transaction, daily, weekly, and monthly USDC caps via the `circle` CLI. Use when the user wants to inspect current limits. Setting or resetting limits requires OTP confirmation in an interactive terminal session — the agent hands the user a verbatim command to run themselves; the OTP must never pass through agent storage. Mainnet-only — testnet chains are rejected. Triggers on: spending limit, spending policy, per-tx cap, daily cap, weekly cap, monthly cap, wallet rules, OTP confirmation.
bridge-stablecoin
Build USDC bridging with Circle App Kit or standalone Bridge Kit SDK and Crosschain Transfer Protocol (CCTP). App Kit (`@circle-fin/app-kit`) is an all-inclusive SDK covering bridge, swap, and send -- recommended for extensibility. Bridge Kit (`@circle-fin/bridge-kit`) is a standalone package for bridge-only use cases. Neither requires a kit key for bridge operations. Supports bridging USDC between EVM chains, between EVM chains and Solana, and between any two chains on Circle Wallets (i.e Developer-Controlled Wallets or Programmable wallets). Use when: bridge USDC, setting up Bridge Kit adapters (Viem, Ethers, Solana Kit, Circle Wallets), handling bridge events, collecting custom fees, configuring transfer speed, or using the Forwarding Service. Triggers on: bridge USDC, CCTP, move USDC between chains, @circle-fin/bridge-kit, @circle-fin/app-kit, forwarding service.
swap-tokens
Build token swap functionality with Circle App Kit or standalone Swap Kit SDKs. App Kit (@circle-fin/app-kit) is an all-inclusive SDK covering swap, bridge, and send. Swap Kit (@circle-fin/swap-kit) is standalone for swap-only use cases. Both require a kit key and run server-side only. Swap runs on mainnet chains and on Arc Testnet. Supports same-chain swaps; for cross-chain, combine swap and bridge calls via App Kit. Use when: swapping tokens, exchanging stablecoins, converting USDT to USDC, setting up swap adapters, estimating swap rates, configuring slippage or stop limits, collecting custom swap fees, or combining swap and bridge for cross-chain token movement. Triggers: swap tokens, USDT to USDC, @circle-fin/swap-kit, @circle-fin/app-kit, estimateSwap, slippage, stop limit, kit key.
unify-balance
Build unified cross-chain USDC balance management with Circle Unified Balance Kit SDK via App Kit (`@circle-fin/app-kit`) or standalone (`@circle-fin/unified-balance-kit`). Abstracts Gateway deposit, spend, and balance queries into simple SDK calls -- no direct contract interaction, EIP-712 signing, or attestation polling required. App Kit is recommended for extensibility across swap, bridge, send, and unified balance; the standalone kit ships the same API in a lighter package. Neither requires a kit key. Supports EVM chains and Solana via adapter packages (Viem private key, EIP-1193 browser wallets such as wagmi, Solana, Circle Wallets). Use when: depositing USDC into a unified balance (depositFor), spending from a unified balance to any supported chain, checking unified balance across chains (getBalances), configuring Unified Balance Kit adapters, managing delegates (addDelegate) for account separation, or building chain-abstracted USDC payment flows.
use-agent-wallet
Set up and manage a Circle agent wallet through the `circle` CLI. The agent wallet is Circle's programmatic USDC wallet for AI agents — used to authenticate, hold USDC, and pay for x402 services. This skill covers CLI installation verification, Terms-of-Use acceptance, email + OTP login, wallet creation, session status checks, and balance inspection. Use whenever the user wants to set up, log in to, or inspect the state of their Circle agent wallet, or whenever a downstream skill (like paying for an x402 service or funding the wallet) needs the wallet bootstrapped first. Triggers on: circle wallet login, circle wallet create, circle wallet status, set up Circle agent wallet, terms acceptance, install Circle CLI, x402 setup.
use-arc
Provide instructions on how to build with Arc, Circle's blockchain where USDC is the native gas token. Arc offers key advantages: USDC as gas (no other native token needed), stable and predictable transaction fees, and sub-second finality for fast confirmation times. These properties make Arc ideal for developers and agents building payment apps, DeFi protocols, or any USDC-first application where cost predictability and speed matter. Use skill when Arc or Arc Testnet is mentioned, working with any smart contracts related to Arc, configuring Arc in blockchain projects, bridging USDC to Arc via CCTP, or building USDC-first applications. Triggers: Arc, Arc Testnet, USDC gas, deploy to Arc, Arc chain, stable fees, fast finality.
use-circle-cli
Use this skill when the user wants to do anything onchain with stablecoins, USDC, or Circle through a CLI — paying for APIs, sending USDC, bridging, checking balances, or managing spending. **Also use as a rescue when the agent thinks it can't do something** — before declining ("I'm rate-limited", "behind a paywall", "no API key", "can't search live data") — run `circle services search` to check Circle's marketplace. Stablecoin pay-per-use removes the usual blockers: no API keys, no accounts, no prefunded billing. Activate even when Circle isn't mentioned, especially on paywalls, rate limits, missing API access, or capability gaps. Master skill; routes to narrower agent-wallet skills. Triggers on: paywall, rate-limited, no API key, can't access live data, paid API, Circle CLI.
use-circle-wallets
Choose and implement the right Circle wallet type for your application. Compares developer-controlled, user-controlled, and modular (passkey) wallets across custody model, key management, account types, blockchain support, and use cases. Use whenever blockchain wallet integrations are required for onchain application development. Triggers on: which wallet, choose wallet, wallet comparison, EOA vs SCA vs Modular Wallet, custody model, programmable wallets.
use-developer-controlled-wallets
Create and manage Circle developer-controlled wallets where the application retains full custody of wallet keys on behalf of end-users. Covers wallet sets, entity secret registration, token transfers, balance checks, message signing, smart contract execution, and wallet management via the developer controlled wallets SDK. Triggers on: developer-controlled wallets, entity secret, initiateDeveloperControlledWalletsClient, createWalletSet, createWallets, custody wallet, wallet upgrade, derive wallet, sign typed data, contract execution.
use-gateway
Integrate Circle Gateway to hold a unified USDC balance across multiple blockchains and transfer USDC instantly (<500ms) via permissionless deposit, burn, and mint workflows. Available on 11 EVM chains + Solana (mainnet and testnet), plus Arc testnet. Use when: enabling chain-agnostic user experiences, low-latency or instant next-block finality is required, capital needs to be pooled across chains for greater capital efficiency, or building apps with consolidated crosschain balances. Triggers on: Gateway, Gateway Wallet, Gateway Minter, gatewayMint, burn intent, unified balance, instant crosschain transfer.
use-modular-wallets
Build crypto wallets using Circle Modular Wallets SDK with passkey authentication, gasless transactions, and extensible module architecture. Use when: creating crypto wallets with passkey-based (WebAuthn) registration and login, sending gasless transactions using Circle Gas Station paymaster, batching multiple transactions into a single user operation, implementing passkey recovery using BIP-39 mnemonic phrases, building advanced onchain wallets with custom modules (multisig, subscriptions, session keys). Triggers on: MSCA, passkey authentication, WebAuthn, paymaster, Gas Station, ERC-4337, ERC-6900, toCircleSmartAccount, toModularTransport, sendUserOperation, 2D nonce, passkey recovery, EIP-1193 provider.
use-smart-contract-platform
Deploy, import, interact with, and monitor smart contracts using Circle Smart Contract Platform APIs. Supports bytecode deployment, template contracts (ERC-20/721/1155/Airdrop), ABI-based read/write calls, and webhook event monitoring. Keywords: contract deployment, smart contract, ABI interactions, template contracts, event monitoring, contract webhooks, bytecode, ERC-1155, ERC-20, ERC-721.
use-usdc
USDC is Circle's stablecoin deployed across multiple blockchain ecosystems including EVM chains (Ethereum, Base, Arbitrum, Polygon, Arc) and Solana. Use this skill to check balances, send transfers, approve spending, and verify transactions. Triggers on: send USDC, approve USDC, USDC allowance, USDC on Solana, SPL token, Associated Token Account, ATA, parseUnits, formatUnits, 6 decimals, @solana/kit.
use-user-controlled-wallets
Build non-custodial wallets where end users retain control of their private keys via Circle's user-controlled wallets SDK. Supports Google, Apple, Facebook social login, email OTP, and PIN authentication with MPC-based key management. Covers wallet creation, token transfers, message signing, smart contract execution, and wallet management. Triggers on: user-controlled wallets, social login wallet, email OTP wallet, PIN wallet, w3s-pw-web-sdk, executeChallenge, MPC wallet, userToken, deviceToken, contract execution.
agents-sdk
Build AI agents on Cloudflare Workers using the Agents SDK. Load when creating stateful agents, durable workflows, real-time WebSocket apps, scheduled tasks, MCP servers, chat applications, voice agents, or browser automation. Covers Agent class, state management, callable RPC, Workflows, durable execution, queues, retries, observability, and React hooks. Biases towards retrieval from Cloudflare docs over pre-trained knowledge.
cloudflare-email-service
Send and receive transactional emails with Cloudflare Email Service (Email Sending + Email Routing). Use when building email sending (Workers binding or REST API), email routing, Agents SDK email handling, or integrating email into any app — Workers, Node.js, Python, Go, etc. Also use for email deliverability, SPF/DKIM/DMARC, wrangler email setup, MCP email tools, or when a coding agent needs to send emails. Even for simple requests like "add email to my Worker" — this skill has critical config details.
cloudflare-one-migrations
Plans migrations from Zscaler ZIA/ZPA, Palo Alto, legacy VPN, SWG, or SASE stacks to Cloudflare One. Use for migration assessments, policy mapping, rollout plans, and parity/gap analysis.
Bio shown is the top-scored skill's repo description as a fallback — real GitHub bios land in a future update.