@dimcool/mcp 0.1.28 → 0.1.30

package/README.md

@@ -55,21 +55,25 @@ DIM_WALLET_PRIVATE_KEY=<base58-key> npx @dimcool/mcp
 
 | Variable                 | Required | Description                                                         |
 | ------------------------ | -------- | ------------------------------------------------------------------- |
-| `DIM_WALLET_PRIVATE_KEY` | No\*     | Base58-encoded Solana private key                                   |
+| `DIM_WALLET_PRIVATE_KEY` | No       | Base58-encoded Solana private key                                   |
 | `DIM_WALLET_STORE_PATH`  | No       | Local path to wallet store file (default: `~/.dim/mcp-wallet.json`) |
 | `DIM_WALLET_AUTO_CREATE` | No       | If `true`, auto-creates/stores a wallet when key/store is missing   |
 | `DIM_API_URL`            | No       | API base URL (default: `https://api.dim.cool`)                      |
 | `DIM_REFERRAL_CODE`      | No       | Referral code to use on first signup                                |
 
-\*Required if you do not use wallet store or auto-create.
+No wallet env vars are required if you use an external wallet MCP (see below).
 
 ### Wallet Auth Configuration
 
-- `@dimcool/mcp` supports three wallet startup modes:
-  1. direct key (`DIM_WALLET_PRIVATE_KEY`)
-  2. local wallet store (`DIM_WALLET_STORE_PATH`)
-  3. auto-create (`DIM_WALLET_AUTO_CREATE=true`)
-- Call `dim_login` before any wallet, games, chat, social, referrals, support, or market tools.
+`@dimcool/mcp` supports four wallet startup modes:
+
+1. **Local wallet store** (`DIM_WALLET_STORE_PATH`) — recommended, key stays on your machine
+2. **Direct key** (`DIM_WALLET_PRIVATE_KEY`) — for programmatic setups
+3. **Auto-create** (`DIM_WALLET_AUTO_CREATE=true`) — generates and stores a new wallet automatically
+4. **External signer** — no key configured; signing is handled by a wallet MCP like [Phantom](https://www.npmjs.com/package/@phantom/mcp-server). See [Using an External Wallet](https://docs.dim.cool/mcp/external-wallet).
+
+In modes 1-3 call `dim_login` to authenticate. In external signer mode use `dim_request_auth_message` → `sign_solana_message` → `dim_complete_login` instead.
+
 - Call `dim_get_balance` after login and before paid actions.
 - To generate/export a Base58 key programmatically, use [@dimcool/wallet](https://docs.dim.cool/guides/wallet-package).
 
@@ -89,7 +93,9 @@ DIM_WALLET_PRIVATE_KEY=<base58-key> npx @dimcool/mcp
 
 ### Authentication
 
-- `dim_login` — Authenticate with DIM using the configured wallet
+- `dim_login` — Authenticate using the configured wallet (keypair/store modes)
+- `dim_request_auth_message` — **External signer:** get the message to sign for login
+- `dim_complete_login` — **External signer:** submit the signature to complete login
 - `dim_get_profile` — Get the authenticated user's profile
 - `dim_set_username` — Set or update your username
 
@@ -111,10 +117,13 @@ DIM_WALLET_PRIVATE_KEY=<base58-key> npx @dimcool/mcp
 ### Wallet / USDC
 
 - `dim_get_balance` — Get SOL and USDC wallet balance
-- `dim_send_usdc` — Send USDC to a user (username without `@`, `.sol`, or Solana address, 1¢ fee; one-call flow)
-- `dim_tip_user` — Tip a user and broadcast to global chat (one-call flow)
+- `dim_send_usdc` — Send USDC to a user (one-call in keypair mode; returns unsigned tx in external signer mode)
+- `dim_confirm_send_usdc` — **External signer:** confirm a USDC transfer after broadcasting
+- `dim_tip_user` — Tip a user and broadcast to global chat (one-call in keypair mode)
+- `dim_confirm_tip_user` — **External signer:** confirm a tip after broadcasting
 - `dim_get_wallet_activity` — Get recent transaction history
-- `dim_donate_to_pot` — Donate USDC to a game pot (one-call flow)
+- `dim_donate_to_pot` — Donate USDC to a game pot (one-call in keypair mode)
+- `dim_confirm_donate_to_pot` — **External signer:** confirm a game donation after broadcasting
 
 ### Prediction Markets
 
@@ -130,7 +139,8 @@ DIM_WALLET_PRIVATE_KEY=<base58-key> npx @dimcool/mcp
 - `dim_list_games` — List available game types
 - `dim_get_game_metrics` — Real-time player counts and money in play
 - `dim_create_lobby` — Create a game lobby
-- `dim_deposit_for_lobby` — One-call deposit for a paid lobby (required before join_queue when lobby has a bet)
+- `dim_deposit_for_lobby` — Deposit for a paid lobby (one-call in keypair mode; returns unsigned tx in external signer mode)
+- `dim_confirm_lobby_deposit` — **External signer:** confirm a lobby deposit after broadcasting
 - `dim_leave_lobby` — Leave a lobby
 - `dim_join_queue` — Join matchmaking queue
 - `dim_get_lobby` — Check lobby status