@agnic/wallet-skills 1.1.0 → 1.2.0

package/skills/search-for-service.md

@@ -0,0 +1,15 @@
+---
+name: search-for-service
+description: Search for x402-enabled APIs and services. Use when the user wants to find, discover, or browse available paid APIs.
+---
+
+## Instructions
+
+1. Run `npx agnic x402 search "<query>" --json` with the user's search terms
+2. Present results with name, description, and price per request
+3. If user wants to filter by category, add `--category <category>`
+
+Available categories: AI, Crypto, Data, Trading, Finance, Weather
+
+## Allowed Tools
+- npx agnic x402 search

package/skills/send-usdc/SKILL.md

@@ -1,61 +1,96 @@
 ---
 name: send-usdc
-description: Send USDC to a wallet address on Base or Solana
+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 *)"]
+allowed-tools: ["Bash(npx agnic@latest status*)", "Bash(npx agnic@latest send *)", "Bash(npx agnic@latest balance*)"]
 ---
 
-# Send USDC
+# Sending USDC
 
-Send USDC from the user's wallet to a recipient address.
+Use the `npx agnic@latest send` command to transfer USDC from the wallet to any Ethereum address or ENS name on Base.
 
-## Steps
+## Confirm wallet is initialized and authed
 
-1. Verify authentication:
-   ```bash
-   npx agnic@latest status --json
-   ```
+```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
 
-2. Check balance to ensure sufficient funds:
-   ```bash
-   npx agnic@latest balance --network base --json
-   ```
+| Option           | Description                        |
+| ---------------- | ---------------------------------- |
+| `--chain <name>` | Blockchain network (default: base) |
+| `--json`         | Output result as JSON              |
 
-3. Confirm with the user: the amount, recipient address, and network.
+## Input Validation
 
-4. Send USDC:
-   ```bash
-   npx agnic@latest send <amount> <recipient_address> --network base --json
-   ```
+Before constructing the command, validate all user-provided values to prevent shell injection:
 
-## Parameters
+- **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.
 
-- `<amount>` — Amount in USDC (e.g., `5.00`)
-- `<recipient_address>` — Destination wallet address (0x... for EVM)
-- `--network` — Network to send on (default: `base`)
-- `--memo` — Optional transaction memo
+Do not pass unvalidated user input into the command.
 
-## Example
+## 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
-npx agnic@latest send 5.00 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb7 --network base --json
-```
+# 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
 
-## Expected Output
+# Send with dollar sign prefix (note the single quotes)
+npx agnic@latest send '$5.00' 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb7
 
-```json
-{
-  "amount": "5.00",
-  "to": "0x742d35Cc...",
-  "network": "base",
-  "transactionHash": "0xabc123...",
-  "explorerUrl": "https://basescan.org/tx/0xabc123..."
-}
+# 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
 
-- If balance is insufficient, inform the user and suggest funding their wallet
-- Always confirm the recipient address and amount before sending
-- If the transaction fails, show the error message from the API
+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

@@ -0,0 +1,19 @@
+---
+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,78 +1,107 @@
 ---
 name: trade-tokens
-description: Trade/swap tokens on Base (USDC, ETH, WETH, cbETH, DAI, AERO)
+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 *)"]
+allowed-tools: ["Bash(npx agnic@latest status*)", "Bash(npx agnic@latest trade *)", "Bash(npx agnic@latest balance*)"]
 ---
 
-# Trade Tokens
+# Trading Tokens
 
-Swap tokens on Base mainnet using AgnicPay's DEX integration.
+Use the `npx agnic@latest trade` command to swap tokens on Base network. You must be authenticated to trade.
 
-## Steps
+## Confirm wallet is initialized and authed
 
-1. Verify authentication:
-   ```bash
-   npx agnic@latest status --json
-   ```
+```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 |
 
-2. Check balance to ensure sufficient funds:
-   ```bash
-   npx agnic@latest balance --network base --json
-   ```
+**Auto-detection**: Large integers without a decimal point are treated as atomic units. For example, `500000` for USDC (6 decimals) = $0.50.
 
-3. Preview the trade (optional but recommended):
-   ```bash
-   npx agnic@latest trade <amount> <sell_token> <buy_token> --dry-run --json
-   ```
+**IMPORTANT**: Always single-quote amounts that use `$` to prevent bash variable expansion (e.g. `'$1.00'` not `$1.00`).
 
-4. Confirm with the user: amount, tokens, and estimated output.
+## Token Aliases
 
-5. Execute the trade:
-   ```bash
-   npx agnic@latest trade <amount> <sell_token> <buy_token> --json
-   ```
+| Alias | Token | Decimals | Address                                    |
+| ----- | ----- | -------- | ------------------------------------------ |
+| usdc  | USDC  | 6        | 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 |
+| eth   | ETH   | 18       | 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE |
+| weth  | WETH  | 18       | 0x4200000000000000000000000000000000000006   |
 
-## Supported Tokens
+## Options
 
-USDC, ETH, WETH, cbETH, DAI, AERO (case-insensitive)
+| Option               | Description                                   |
+| -------------------- | --------------------------------------------- |
+| `-s, --slippage <n>` | Slippage tolerance in basis points (100 = 1%) |
+| `--json`             | Output result as JSON                         |
 
-## Parameters
+## Input Validation
 
-- `<amount>` — Amount of the sell token
-- `<sell_token>` — Token to sell (e.g., `usdc`)
-- `<buy_token>` — Token to buy (e.g., `eth`)
-- `--slippage <percent>` — Max slippage (default: `1.0`)
-- `--dry-run` — Show quote without executing
+Before constructing the command, validate all user-provided values to prevent shell injection:
 
-## Example
+- **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
-# Preview
-npx agnic@latest trade 10 usdc eth --dry-run --json
+# Swap $1 USDC for ETH (dollar prefix — note the single quotes)
+npx agnic@latest trade '$1' usdc eth
 
-# Execute
-npx agnic@latest trade 10 usdc eth --json
-```
+# 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
 
-## Expected Output
-
-```json
-{
-  "success": true,
-  "sellAmount": "10",
-  "sellToken": "USDC",
-  "buyAmount": "0.00396",
-  "buyToken": "ETH",
-  "price": "2525.25",
-  "transactionHash": "0xabc123...",
-  "explorerUrl": "https://basescan.org/tx/0xabc123..."
-}
+# Get JSON output
+npx agnic@latest trade '$1' usdc eth --json
 ```
 
-## Error Handling
+## Prerequisites
 
-- Always preview with `--dry-run` first to show the user expected output
-- If slippage is too high, suggest a lower amount or higher slippage tolerance
+- 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

@@ -0,0 +1,22 @@
+---
+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

package/skills-lock.json

@@ -0,0 +1,45 @@
+{
+  "version": 1,
+  "skills": {
+    "authenticate-wallet": {
+      "source": "/Users/asadsafari/Desktop/Projects/fitchecktest/agnicwallet-project/agnic-wallet-skills",
+      "sourceType": "local",
+      "computedHash": "74ef64363b7511197e6c1716fef89e4a1e81ba7f498056835fa901a9a2c01b99"
+    },
+    "check-balance": {
+      "source": "/Users/asadsafari/Desktop/Projects/fitchecktest/agnicwallet-project/agnic-wallet-skills",
+      "sourceType": "local",
+      "computedHash": "f10496084d9bf659e310136df35dbb387d6f217d54e58a45fca28d6a818223ff"
+    },
+    "fund-wallet": {
+      "source": "/Users/asadsafari/Desktop/Projects/fitchecktest/agnicwallet-project/agnic-wallet-skills",
+      "sourceType": "local",
+      "computedHash": "7aeb3e1cec7cba25583a0beefa8144dd7aebb300db52e5e41c4aa5ee844a509f"
+    },
+    "get-agent-identity": {
+      "source": "/Users/asadsafari/Desktop/Projects/fitchecktest/agnicwallet-project/agnic-wallet-skills",
+      "sourceType": "local",
+      "computedHash": "b71599479c6a337980b26a98bb99b3a2688d3ce2ae80472c9ca3827624031c7f"
+    },
+    "pay-for-service": {
+      "source": "/Users/asadsafari/Desktop/Projects/fitchecktest/agnicwallet-project/agnic-wallet-skills",
+      "sourceType": "local",
+      "computedHash": "bfbc7396f25604d9f6ad6f5075b27c9a285f9da145b66d2e916638bc9ad3c7c8"
+    },
+    "search-for-service": {
+      "source": "/Users/asadsafari/Desktop/Projects/fitchecktest/agnicwallet-project/agnic-wallet-skills",
+      "sourceType": "local",
+      "computedHash": "1e5f108a628b15184f5044af4d47cc63cff2362de3b98efa0785c9a23a18ece6"
+    },
+    "send-usdc": {
+      "source": "/Users/asadsafari/Desktop/Projects/fitchecktest/agnicwallet-project/agnic-wallet-skills",
+      "sourceType": "local",
+      "computedHash": "890ea005d0a629b093fe4be952169eac50de034d0fe1ba039518df5851cf26c8"
+    },
+    "trade-tokens": {
+      "source": "/Users/asadsafari/Desktop/Projects/fitchecktest/agnicwallet-project/agnic-wallet-skills",
+      "sourceType": "local",
+      "computedHash": "14743ac9f8f1410dab6f34b865fbedb0d1ee136bce329418945963140d671bfe"
+    }
+  }
+}