@agnic/wallet-skills 1.3.1 → 1.3.3

package/README.md

@@ -1,6 +1,6 @@
 # AgnicPay Agentic Wallet Skills
 
-Agent Skills for crypto wallet operations. These skills enable AI agents to authenticate, check balances, send USDC, trade tokens, make x402 payments, and verify on-chain identity using the `agnic` CLI.
+Agent Skills for crypto wallet operations. These skills enable AI agents to authenticate, check balances, make x402 payments, access 340+ AI models, generate images, and verify on-chain identity using the `agnic` CLI.
 
 ## Available Skills
 
@@ -8,14 +8,13 @@ Agent Skills for crypto wallet operations. These skills enable AI agents to auth
 |-------|-------------|
 | **authenticate-wallet** | Sign in to the wallet via browser OAuth |
 | **check-balance** | Check USDC balance across networks (Base, Solana) |
-| **send-usdc** | Send USDC to Ethereum wallet addresses |
-| **trade-tokens** | Swap/trade tokens on Base (USDC, ETH, WETH, cbETH, DAI, AERO) |
 | **search-for-service** | Search for paid API services via x402 |
 | **pay-for-service** | Make paid API requests via x402 |
 | **fund-wallet** | Get instructions for adding funds to the wallet |
 | **get-agent-identity** | Check on-chain ERC-8004 identity and trust score |
 | **agent-email** | Manage agent email — send, receive, check inbox |
-| **agnic** | Unified skill — all wallet, payment, email, and identity capabilities |
+| **ai-gateway** | Access 340+ AI models — chat, image generation (GPT, Claude, Gemini, Llama, Flux) |
+| **agnic** | Unified skill — all wallet, payment, email, identity, and AI gateway capabilities |
 
 ## Installation
 
@@ -33,11 +32,12 @@ Examples:
 
 - `Sign in to my wallet`
 - `Check my balance`
-- `Send 10 USDC to 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb7`
-- `Swap 5 USDC for ETH`
 - `Find a sentiment analysis API`
 - `Pay for https://api.example.com/data`
 - `What's my agent identity?`
+- `List available AI models`
+- `Ask GPT-4o to explain quantum computing`
+- `Generate an image of a sunset over mountains`
 
 ## Contributing
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@agnic/wallet-skills",
-  "version": "1.3.1",
-  "description": "Vercel AI SDK skills for AgnicPay wallet — balance, payments, trading, x402, and agent identity",
+  "version": "1.3.3",
+  "description": "Vercel AI SDK skills for AgnicPay wallet — balance, x402, agent identity, and AI gateway",
   "keywords": [
     "agnic",
     "agnicpay",

package/skills/agnic/SKILL.md

@@ -1,9 +1,9 @@
 ---
 name: agnic
 description: >
-  Complete AI agent wallet with payments, trading, email, and on-chain identity.
-  Use when the user wants to manage their agent's wallet, make payments, trade tokens,
-  send/receive email, or check their agent identity.
+  Complete AI agent wallet with payments, email, AI gateway, and on-chain identity.
+  Use when the user wants to manage their agent's wallet, make payments,
+  send/receive email, access AI models, or check their agent identity.
 user-invocable: true
 disable-model-invocation: false
 allowed-tools: ["Bash(npx agnic@latest *)"]
@@ -11,7 +11,7 @@ allowed-tools: ["Bash(npx agnic@latest *)"]
 
 ## Agnic — Unified Agent Wallet Skill
 
-This skill gives your AI agent a full identity stack: wallet, email, payments, trading, and on-chain identity.
+This skill gives your AI agent a full identity stack: wallet, email, payments, AI gateway, and on-chain identity.
 
 ### Authentication
 
@@ -43,24 +43,6 @@ npx agnic@latest x402 preview <url>
 npx agnic@latest x402 pay <url> --method GET --json
 ```
 
-### Token Trading
-
-```bash
-# Get a quote
-npx agnic@latest trade quote 10 USDC ETH --json
-
-# Execute a trade (Base mainnet only)
-npx agnic@latest trade 10 USDC ETH --json
-```
-
-Supported tokens: USDC, ETH, WETH, cbETH, DAI, AERO
-
-### Send USDC
-
-```bash
-npx agnic@latest send <amount> <address> --network base --json
-```
-
 ### Agent Identity
 
 ```bash

package/skills/ai-gateway/SKILL.md

@@ -148,7 +148,7 @@ npx agnic@latest ai image --prompt 'Logo design for a tech startup' --json
 Common errors:
 
 - "Not authenticated" — Run `npx agnic@latest auth login` first
-- "Insufficient balance" — Fund wallet at https://pay.agnic.ai
+- "Insufficient balance" — Fund wallet at https://app.agnic.ai
 - "Model not found" — Check available models with `npx agnic@latest ai models`
 - "No image returned" — Try a different model or rephrase the prompt
 - "Rate limit exceeded" — Wait a moment and retry

package/skills/fund-wallet/SKILL.md

@@ -30,10 +30,10 @@ This displays the user's wallet address on each supported network.
 
 ### Option 1: AgnicPay Dashboard (Recommended)
 
-1. Go to [pay.agnic.ai](https://pay.agnic.ai)
+1. Go to [app.agnic.ai](https://app.agnic.ai)
 2. Sign in with the same account used in the CLI
 3. Navigate to the dashboard
-4. Use the **"Add Funds"** button to deposit USDC via card, bank transfer, or crypto
+4. Use the **"Add Funds"** button to add USDC via card or on-chain funding
 
 ### Option 2: Direct USDC Transfer
 

package/skills/fund-wallet.md

@@ -8,7 +8,7 @@ description: Get instructions for funding your AgnicPay wallet. Use when the use
 1. Check current balance: `npx agnic balance --json`
 2. Show the wallet address: `npx agnic address`
 3. Provide funding instructions:
-   - Visit https://pay.agnic.ai to fund via the dashboard
+   - Visit https://app.agnic.ai to fund via the dashboard
    - Or send USDC directly to the displayed wallet address on Base or Solana
 4. After funding, verify with `npx agnic balance --json`
 

package/skills/get-agent-identity/SKILL.md

@@ -75,5 +75,5 @@ ERC-8004 ("Trustless Agents") is an Ethereum standard that gives AI agents:
 Common errors:
 
 - "Not authenticated" — Run `npx agnic@latest auth login` first
-- "No agent identity found" — The user may not have an agent registered yet; create one via the AgnicPay dashboard at [pay.agnic.ai](https://pay.agnic.ai)
+- "No agent identity found" — The user may not have an agent registered yet; create one via the AgnicPay dashboard at [app.agnic.ai](https://app.agnic.ai)
 - "Agent suspended" — The agent's delegation may have been revoked; contact support

package/skills/get-agent-identity.md

@@ -12,7 +12,7 @@ description: Check agent's on-chain identity, trust score, and KYA credentials.
    - Trust score and reputation
    - KYA (Know Your Agent) credentials for identity verification
    - Delegation credentials for authorized actions
-4. Direct user to https://pay.agnic.ai for full identity management
+4. Direct user to https://app.agnic.ai for full identity management
 
 ## Allowed Tools
 - npx agnic status

package/skills/send-usdc/SKILL.md

@@ -1,96 +0,0 @@
----
-name: send-usdc
-description: Send USDC to an Ethereum address or ENS name. Use when you or the user want to send money, pay someone, transfer USDC, tip, donate, or send funds to a wallet address or .eth name. Covers phrases like "send $5 to", "pay 0x...", "transfer to vitalik.eth", "tip someone", "send USDC".
-user-invocable: true
-disable-model-invocation: false
-allowed-tools: ["Bash(npx agnic@latest status*)", "Bash(npx agnic@latest send *)", "Bash(npx agnic@latest balance*)"]
----
-
-# Sending USDC
-
-Use the `npx agnic@latest send` command to transfer USDC from the wallet to any Ethereum address or ENS name on Base.
-
-## Confirm wallet is initialized and authed
-
-```bash
-npx agnic@latest status
-```
-
-If the wallet is not authenticated, refer to the `authenticate-wallet` skill.
-
-## Command Syntax
-
-```bash
-npx agnic@latest send <amount> <recipient> [--chain <chain>] [--json]
-```
-
-## Arguments
-
-| Argument    | Description                                                                                                                                                                                                                          |
-| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `amount`    | Amount to send: `'$1.00'`, `1.00`, or atomic units (1000000 = $1). Always single-quote amounts that use `$` to prevent bash variable expansion. If the number looks like atomic units (no decimal or > 100), treat as atomic units. |
-| `recipient` | Ethereum address (0x...) or ENS name (vitalik.eth)                                                                                                                                                                                   |
-
-## Options
-
-| Option           | Description                        |
-| ---------------- | ---------------------------------- |
-| `--chain <name>` | Blockchain network (default: base) |
-| `--json`         | Output result as JSON              |
-
-## Input Validation
-
-Before constructing the command, validate all user-provided values to prevent shell injection:
-
-- **amount**: Must match `^\$?[\d.]+$` (digits, optional decimal point, optional `$` prefix). Reject if it contains spaces, semicolons, pipes, backticks, or other shell metacharacters.
-- **recipient**: Must be a valid `0x` hex address (`^0x[0-9a-fA-F]{40}$`) or an ENS name (`^[a-zA-Z0-9.-]+\.eth$`). Reject any value containing spaces or shell metacharacters.
-
-Do not pass unvalidated user input into the command.
-
-## USDC Amounts
-
-| Format        | Example                | Description                            |
-| ------------- | ---------------------- | -------------------------------------- |
-| Dollar prefix | `'$1.00'`, `'$0.50'`  | USD notation (single-quote the `$`)    |
-| Decimal       | `1.0`, `0.50`          | Human-readable with decimal point      |
-| Whole number  | `5`, `100`             | Interpreted as whole USDC tokens       |
-| Atomic units  | `500000`               | Large integers treated as atomic units |
-
-**IMPORTANT**: Always single-quote amounts that use `$` to prevent bash variable expansion (e.g. `'$1.00'` not `$1.00`).
-
-## ENS Resolution
-
-ENS names are automatically resolved to addresses via Ethereum mainnet. The command will:
-1. Detect ENS names (any string containing `.eth`)
-2. Resolve the name to an address
-3. Display both the ENS name and resolved address in the output
-
-## Examples
-
-```bash
-# Send $1.00 USDC to an address
-npx agnic@latest send 1 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb7
-
-# Send $0.50 USDC to an ENS name
-npx agnic@latest send 0.50 vitalik.eth
-
-# Send with dollar sign prefix (note the single quotes)
-npx agnic@latest send '$5.00' 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb7
-
-# Get JSON output
-npx agnic@latest send 1 vitalik.eth --json
-```
-
-## Prerequisites
-
-- Must be authenticated (`npx agnic@latest status` to check)
-- Wallet must have sufficient USDC balance (`npx agnic@latest balance` to check)
-
-## Error Handling
-
-Common errors:
-
-- "Not authenticated" — Run `npx agnic@latest auth login` first
-- "Insufficient balance" — Check balance with `npx agnic@latest balance`
-- "Could not resolve ENS name" — Verify the ENS name exists
-- "Invalid recipient" — Must be valid 0x address or ENS name

package/skills/send-usdc.md

@@ -1,19 +0,0 @@
----
-name: send-usdc
-description: Send USDC to a wallet address. Use when the user wants to send, transfer, or pay someone USDC.
----
-
-## Instructions
-
-1. Confirm the recipient address and amount with the user
-2. Check balance first: `npx agnic balance --network base --json`
-3. If sufficient funds, execute: `npx agnic send <amount> <address> --json`
-4. Report the transaction hash and explorer link
-
-Optional flags:
-- `--network <network>` — default is "base"
-- `--memo <text>` — attach a memo to the transaction
-
-## Allowed Tools
-- npx agnic balance
-- npx agnic send

package/skills/trade-tokens/SKILL.md

@@ -1,107 +0,0 @@
----
-name: trade-tokens
-description: Swap or trade tokens on Base network. Use when you or the user want to trade, swap, exchange, buy, sell, or convert between tokens like USDC, ETH, and WETH. Covers phrases like "buy ETH", "sell ETH for USDC", "convert USDC to ETH", "get some ETH", "swap tokens", "trade USDC for WETH".
-user-invocable: true
-disable-model-invocation: false
-allowed-tools: ["Bash(npx agnic@latest status*)", "Bash(npx agnic@latest trade *)", "Bash(npx agnic@latest balance*)"]
----
-
-# Trading Tokens
-
-Use the `npx agnic@latest trade` command to swap tokens on Base network. You must be authenticated to trade.
-
-## Confirm wallet is initialized and authed
-
-```bash
-npx agnic@latest status
-```
-
-If the wallet is not authenticated, refer to the `authenticate-wallet` skill.
-
-## Command Syntax
-
-```bash
-npx agnic@latest trade <amount> <from> <to> [options]
-```
-
-## Arguments
-
-| Argument | Description                                                            |
-| -------- | ---------------------------------------------------------------------- |
-| `amount` | Amount to swap (see Amount Formats below)                              |
-| `from`   | Source token: alias (usdc, eth, weth) or contract address (0x...)      |
-| `to`     | Destination token: alias (usdc, eth, weth) or contract address (0x...) |
-
-## Amount Formats
-
-| Format        | Example                | Description                            |
-| ------------- | ---------------------- | -------------------------------------- |
-| Dollar prefix | `'$1.00'`, `'$0.50'`  | USD notation (decimals based on token) |
-| Decimal       | `1.0`, `0.50`, `0.001` | Human-readable with decimal point      |
-| Whole number  | `5`, `100`             | Interpreted as whole tokens            |
-| Atomic units  | `500000`               | Large integers treated as atomic units |
-
-**Auto-detection**: Large integers without a decimal point are treated as atomic units. For example, `500000` for USDC (6 decimals) = $0.50.
-
-**IMPORTANT**: Always single-quote amounts that use `$` to prevent bash variable expansion (e.g. `'$1.00'` not `$1.00`).
-
-## Token Aliases
-
-| Alias | Token | Decimals | Address                                    |
-| ----- | ----- | -------- | ------------------------------------------ |
-| usdc  | USDC  | 6        | 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 |
-| eth   | ETH   | 18       | 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE |
-| weth  | WETH  | 18       | 0x4200000000000000000000000000000000000006   |
-
-## Options
-
-| Option               | Description                                   |
-| -------------------- | --------------------------------------------- |
-| `-s, --slippage <n>` | Slippage tolerance in basis points (100 = 1%) |
-| `--json`             | Output result as JSON                         |
-
-## Input Validation
-
-Before constructing the command, validate all user-provided values to prevent shell injection:
-
-- **amount**: Must match `^\$?[\d.]+$` (digits, optional decimal point, optional `$` prefix). Reject if it contains spaces, semicolons, pipes, backticks, or other shell metacharacters.
-- **from / to**: Must be a known alias (`usdc`, `eth`, `weth`) or a valid `0x` hex address (`^0x[0-9a-fA-F]{40}$`). Reject any other value.
-- **slippage**: Must be a positive integer (`^\d+$`).
-
-Do not pass unvalidated user input into the command.
-
-## Examples
-
-```bash
-# Swap $1 USDC for ETH (dollar prefix — note the single quotes)
-npx agnic@latest trade '$1' usdc eth
-
-# Swap 0.50 USDC for ETH (decimal format)
-npx agnic@latest trade 0.50 usdc eth
-
-# Swap 0.01 ETH for USDC
-npx agnic@latest trade 0.01 eth usdc
-
-# Swap with custom slippage (2%)
-npx agnic@latest trade '$5' usdc eth --slippage 200
-
-# Get JSON output
-npx agnic@latest trade '$1' usdc eth --json
-```
-
-## Prerequisites
-
-- Must be authenticated (`npx agnic@latest status` to check)
-- Wallet must have sufficient balance of the source token
-- Trading is only available on Base mainnet
-
-## Error Handling
-
-Common errors:
-
-- "Not authenticated" — Run `npx agnic@latest auth login` first
-- "Invalid token" — Use a valid alias (usdc, eth, weth) or 0x address
-- "Cannot swap a token to itself" — From and to must be different
-- "Swap failed: TRANSFER_FROM_FAILED" — Insufficient balance or approval issue
-- "No liquidity" — Try a smaller amount or different token pair
-- "Amount has X decimals but token only supports Y" — Too many decimal places

package/skills/trade-tokens.md

@@ -1,22 +0,0 @@
----
-name: trade-tokens
-description: Trade/swap tokens on Base. Use when the user wants to buy, sell, swap, trade, or exchange tokens like ETH, USDC, DAI, AERO, cbETH.
----
-
-## Instructions
-
-1. Confirm which tokens to trade and the amount
-2. Check balance: `npx agnic balance --network base --json`
-3. Optionally preview: `npx agnic trade <amount> <sellToken> <buyToken> --dry-run --json`
-4. Execute trade: `npx agnic trade <amount> <sellToken> <buyToken> --json`
-5. Report results: tokens received, price, transaction hash
-
-Supported tokens: USDC, ETH, WETH, cbETH, DAI, AERO
-
-Optional flags:
-- `--slippage <percent>` — max slippage percentage (default: 1.0)
-- `--dry-run` — show quote without executing
-
-## Allowed Tools
-- npx agnic balance
-- npx agnic trade