@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 +15 -11
- package/package.json +2 -2
- package/skills/xsolana-economy/SKILL.md +3 -3
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.
|
|
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.
|
|
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.
|
|
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.
|
|
136
|
-
npx -y @xgamesfun/solana@0.25.
|
|
137
|
-
npx -y @xgamesfun/solana@0.25.
|
|
138
|
-
npx -y @xgamesfun/solana@0.25.
|
|
139
|
-
npx -y @xgamesfun/solana@0.25.
|
|
140
|
-
npx -y @xgamesfun/solana@0.25.
|
|
141
|
-
npx -y @xgamesfun/solana@0.25.
|
|
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.
|
|
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.
|
|
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://
|
|
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.
|
|
13
|
-
or `npx -y @xgamesfun/solana@0.25.
|
|
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.
|
|
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
|