plugin-store

1. Confirm installed: Run

   which plugin-store

   . If not found, install it:
   bash

   curl -sSL https://raw.githubusercontent.com/purong-huang-1121/skills-store/main/install.sh | sh

   If the install script fails, ask the user to install manually following the instructions at: https://github.com/okx/plugin-store
2. Check for updates: Read

   ~/.plugin-store/last_check

   and compare it with the current timestamp:
   bash

   cached_ts=$(cat ~/.plugin-store/last_check 2>/dev/null || true)
   now=$(date +%s)

   • If

     cached_ts

     is non-empty and

     (now - cached_ts) < 43200

     (12 hours), skip the update and proceed.
   • Otherwise (file missing or older than 12 hours), run the installer to check for updates:
     bash

     curl -sSL https://raw.githubusercontent.com/purong-huang-1121/skills-store/main/install.sh | sh

3. If any

   plugin-store

   command fails with an unexpected error during this session, try reinstalling before giving up.

• For token search / analytics → use

  okx-dex-token

• For DEX swap → use

  okx-dex-swap

• For token prices / charts → use

  okx-dex-market

• For wallet balances → use

  okx-wallet-portfolio

• For transaction broadcasting → use

  okx-onchain-gateway

• For prediction markets → use

  okx-dapp-polymarket

User: "What are the best lending rates on Aave right now?"

1. aave markets --chain ethereum                  → show all reserves with APYs
       ↓ user picks an asset
2. aave reserve USDC --chain ethereum              → show detailed reserve info
       ↓ user wants to supply
3. Check EVM_PRIVATE_KEY is set
       ↓ not set → prompt user to add to .env
       ↓ set → continue
4. aave supply --token USDC --amount 100 --chain ethereum
       ↓
5. "Supplied 100 USDC to Aave V3. You will receive aUSDC as a receipt token."

• symbol

  from markets data →

  <symbol>

  for reserve/supply/withdraw commands

• underlyingAsset

  address is resolved automatically from the symbol

• Browse markets/rates →

  markets

• Check specific asset details →

  reserve

• Check account status →

  account

• Deposit/lend assets →

  supply

• Withdraw assets →

  withdraw

• Borrow against collateral →

  borrow

• Repay debt →

  repay

• Missing chain → ask user which chain (ethereum, polygon, or arbitrum)
• Missing symbol for reserve → use

  markets

  first, then pick from the list
• Missing address for account → ask user for their wallet address
• Missing amount for supply/withdraw/borrow/repay → ask user how much
• Missing private key (for supply/withdraw/borrow/repay) → prompt to set

  EVM_PRIVATE_KEY

  in

  .env

• Data phase: show market info, rates, positions, let user make informed decision
• Confirmation phase: before any supply/withdraw, display token, amount, chain, estimated APY, and ask for confirmation
• Execution phase: submit transaction, show result with tx hash

• Supply APY: Annual percentage yield earned by supplying assets. Rates are variable and change based on utilization.
• Health Factor: Ratio indicating position safety. Above 1.0 is safe; below 1.0 means the position can be liquidated. Keep it well above 1.0 (recommended > 1.5).
• aTokens: Receipt tokens received when supplying (e.g. supply USDC, receive aUSDC). aTokens accrue interest automatically — their balance grows over time.
• RAY: Aave uses 27-decimal fixed-point numbers (1 RAY = 10^27) for rate calculations internally. The CLI converts these to human-readable percentages.
• LTV (Loan-to-Value): Maximum percentage of collateral value that can be borrowed. E.g. 80% LTV means you can borrow up to 80% of your collateral value.
• Liquidation Threshold: The LTV level at which a position becomes eligible for liquidation. Always higher than the max LTV.
• Utilization Rate: Ratio of total borrowed to total supplied. Higher utilization = higher rates for both suppliers and borrowers.

• Insufficient balance: If the user tries to supply more than their wallet balance, the transaction will fail. Check balance first via

  okx-wallet-portfolio

  .
• Health factor risk: When withdrawing collateral or borrowing, warn if the resulting health factor would drop below 1.5. Withdrawing/borrowing too much can trigger liquidation.
• Borrow capacity: User must have sufficient collateral before borrowing. Check available borrows via

  account

  command.
• Max repay: Use

  --amount max

  to repay the full outstanding debt including accrued interest.
• Max withdrawal: Use

  --amount max

  to withdraw the full supplied balance including accrued interest. This uses

  type(uint256).max

  internally.
• Token approval: First-time supply of a token requires an ERC-20 approval transaction. The CLI handles this automatically but it will use additional gas.
• Private key not set: For supply/withdraw commands, show clear error: "Set EVM_PRIVATE_KEY in your .env file"
• Unsupported chain: Only ethereum, polygon, and arbitrum are supported. Other chains will return an error.
• Asset not listed: If a token symbol is not recognized as an Aave V3 reserve, suggest using

  markets

  to see available assets.
• Rate limiting: OKX API has rate limits. Use retry with backoff.