@xgamesfun/solana 0.25.2 → 0.25.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -106,8 +106,12 @@ codex plugin marketplace add XGamesFun/solana-kit
106
106
  codex plugin add xsolana@xgamesfun
107
107
  ```
108
108
 
109
+ **Chat apps** (claude.ai, ChatGPT, Claude Desktop): add `https://xgames.fun/mcp` as a custom connector (an MCP server
110
+ by URL). It is the hosted server (below, "Over HTTP"): nothing to install, and going live stays your own approval on your
111
+ computer. More at [xgames.fun/solana](https://xgames.fun/solana).
112
+
109
113
  **Any agent with MCP** (Cursor, opencode, Cline…): run the server with
110
- `npx -y --package=@xgamesfun/solana@0.25.2 xsolana mcp`. Or let `npx -y @xgamesfun/solana@0.25.2 connect` register it, with
114
+ `npx -y --package=@xgamesfun/solana@0.25.3 xsolana mcp`. Or let `npx -y @xgamesfun/solana@0.25.3 connect` register it, with
111
115
  the skill, for Claude Code and Codex.
112
116
 
113
117
  **The skill alone, in any agent that reads skills** (Claude Code, Codex, Copilot, Gemini CLI, Cursor, Windsurf, Cline,
@@ -115,7 +119,7 @@ opencode…): `npx skills add XGamesFun/solana-kit` finds it and installs it for
115
119
  server it runs the same tools through `npx`. Each GitHub release also carries `xsolana-economy.zip`, the skill as one
116
120
  file for apps that take a skill as an upload (the Claude and ChatGPT desktop apps).
117
121
 
118
- **Over HTTP**: `npx -y --package=@xgamesfun/solana@0.25.2 xsolana mcp --http` serves the tools that read nothing but
122
+ **Over HTTP**: `npx -y --package=@xgamesfun/solana@0.25.3 xsolana mcp --http` serves the tools that read nothing but
119
123
  their arguments (guide, examples, check, simulate, cost, explain, review, status, client) at
120
124
  `http://127.0.0.1:8787/mcp`, MCP's Streamable HTTP transport. `@xgamesfun/solana/mcp/http` exports the same handler
121
125
  (`mcpHttp(request) → response`) for a hosted endpoint: it reads no files, and the agent hands the person the spec and the
@@ -124,7 +128,7 @@ their arguments (guide, examples, check, simulate, cost, explain, review, status
124
128
  Then ask for an economy, for example _"a fishing game where each cast costs 0.02 SOL, with a rare golden fish and a
125
129
  monthly draw"_.
126
130
 
127
- Going live is always yours: `npx -y @xgamesfun/solana@0.25.2 approve` opens a page on your computer where you connect a
131
+ Going live is always yours: `npx -y @xgamesfun/solana@0.25.3 approve` opens a page on your computer where you connect a
128
132
  devnet wallet and approve each transaction. The agent never signs and never asks for a key.
129
133
 
130
134
  ## Use it from a terminal
@@ -132,13 +136,13 @@ devnet wallet and approve each transaction. The agent never signs and never asks
132
136
  Every tool runs from the CLI too, on a spec file (`xsolana.json` by default):
133
137
 
134
138
  ```bash
135
- npx -y @xgamesfun/solana@0.25.2 examples shop with loot boxes # the nearest worked examples
136
- npx -y @xgamesfun/solana@0.25.2 check xsolana.json # refusals and warnings
137
- npx -y @xgamesfun/solana@0.25.2 simulate xsolana.json # where the money goes, day by day
138
- npx -y @xgamesfun/solana@0.25.2 cost xsolana.json # what going live and each action cost
139
- npx -y @xgamesfun/solana@0.25.2 explain xsolana.json # the economy in plain words
140
- npx -y @xgamesfun/solana@0.25.2 review xsolana.json # what a cheater gets on each route (exits 1 on a high finding)
141
- npx -y @xgamesfun/solana@0.25.2 approve xsolana.json # go live, approved in your own wallet
139
+ npx -y @xgamesfun/solana@0.25.3 examples shop with loot boxes # the nearest worked examples
140
+ npx -y @xgamesfun/solana@0.25.3 check xsolana.json # refusals and warnings
141
+ npx -y @xgamesfun/solana@0.25.3 simulate xsolana.json # where the money goes, day by day
142
+ npx -y @xgamesfun/solana@0.25.3 cost xsolana.json # what going live and each action cost
143
+ npx -y @xgamesfun/solana@0.25.3 explain xsolana.json # the economy in plain words
144
+ npx -y @xgamesfun/solana@0.25.3 review xsolana.json # what a cheater gets on each route (exits 1 on a high finding)
145
+ npx -y @xgamesfun/solana@0.25.3 approve xsolana.json # go live, approved in your own wallet
142
146
  ```
143
147
 
144
148
  `xsolana help` lists every command. Every command names the exact version, so `npx` runs that release and never whatever
@@ -190,7 +194,7 @@ tiers, boosts and fixed or shared reward rates. The project needs no authority o
190
194
  ones), raffles with a Merkle allowlist, and auctions that refund the outbid at once are all routes in the same spec.
191
195
 
192
196
  **Is there an MCP server or Claude Code plugin for building on Solana?** Yes: the `xsolana` plugin for Claude Code and
193
- Codex, and `npx -y --package=@xgamesfun/solana@0.25.2 xsolana mcp` for any MCP client. It is listed in the MCP
197
+ Codex, the hosted server at `https://xgames.fun/mcp` for chat apps, and `npx -y --package=@xgamesfun/solana@0.25.3 xsolana mcp` for any MCP client. It is listed in the MCP
194
198
  Registry as `io.github.XGamesFun/solana-kit`.
195
199
 
196
200
  **How is this different from writing my own Anchor program?** Nothing is written, deployed or upgraded per project:
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@xgamesfun/solana",
3
- "version": "0.25.2",
3
+ "version": "0.25.3",
4
4
  "mcpName": "io.github.XGamesFun/solana-kit",
5
5
  "description": "Loot boxes, gacha, shops, lotteries, auctions, NFT staking, crafting and rewards on Solana without writing a smart contract: one shared program, its JS client, a CLI, and an MCP server and skill so Claude Code, Codex or any AI agent can design, check, simulate and launch an economy.",
6
6
  "license": "Apache-2.0",
@@ -9,7 +9,7 @@
9
9
  "type": "git",
10
10
  "url": "git+https://github.com/XGamesFun/solana-kit.git"
11
11
  },
12
- "homepage": "https://github.com/XGamesFun/solana-kit#readme",
12
+ "homepage": "https://xgames.fun/solana",
13
13
  "bugs": {
14
14
  "url": "https://github.com/XGamesFun/solana-kit/issues"
15
15
  },
@@ -9,8 +9,8 @@ An economy is one JSON spec (`xsolana.json` in the project) on **loot**, a Solan
9
9
  writes or deploys a contract: the spec is checked, simulated and priced by the `xsolana_*` tools, and the project's
10
10
  owner puts it live by approving in their own wallet. It runs on **devnet** until the program is audited.
11
11
 
12
- The tools are the `xsolana_*` MCP tools. Without MCP, the same from a terminal: `npx -y @xgamesfun/solana@0.25.2 <guide|examples|check|simulate|cost|explain|review|publish|status> [xsolana.json]`,
13
- or `npx -y @xgamesfun/solana@0.25.2 tool <name> '<json>'` for any tool (always with the exact version).
12
+ The tools are the `xsolana_*` MCP tools. Without MCP, the same from a terminal: `npx -y @xgamesfun/solana@0.25.3 <guide|examples|check|simulate|cost|explain|review|publish|status> [xsolana.json]`,
13
+ or `npx -y @xgamesfun/solana@0.25.3 tool <name> '<json>'` for any tool (always with the exact version).
14
14
 
15
15
  ## Rules (always)
16
16
 
@@ -113,7 +113,7 @@ or `npx -y @xgamesfun/solana@0.25.2 tool <name> '<json>'` for any tool (always w
113
113
  level would cost. Run it again after every change that touches a route that pays.
114
114
  9. **When they say "put it live"**: `xsolana_publish` lists every step and its cost and gives the command. Tell them to
115
115
  run it themselves in the project folder, exactly as `xsolana_publish` gives it (it names the exact version:
116
- `npx -y @xgamesfun/solana@0.25.2 approve xsolana.json`; never drop the version). It opens a page on their computer where
116
+ `npx -y @xgamesfun/solana@0.25.3 approve xsolana.json`; never drop the version). It opens a page on their computer where
117
117
  they connect a devnet wallet and approve; what lands is written back into `xsolana.json`. You publish nothing.
118
118
  10. **After it is live**: `xsolana_status` shows each part on chain; read it before acting on what the person says
119
119
  happened. A later change is the same loop: save, publish, and the approval sends only what changed. What only the