@xgamesfun/solana 0.26.3 → 0.27.0

package/js/economy/schema.json

@@ -363,7 +363,7 @@
       "type": "object",
       "required": ["key", "source"],
       "additionalProperties": false,
-      "description": "A currency. `sol`: SOL (players pay in wrapped SOL). `existing`: any mint by address, launched anywhere, classic or Token-2022, pump.fun included (xgames.fun takes no share of its fees). `project` (`game` is its older spelling): a token made when the economy goes live: the project mints it as its rules say (points, tickets, shards), or, with `supply`, a fixed supply minted once to the owner (a community token you keep). A token made this way is named on chain as it is made (its `name`, `symbol` and `uri`), which is what wallets show. Only the owner's wallet can change that later, and a change to them in a spec that is already live changes nothing on chain yet.",
+      "description": "A currency. `sol`: SOL (players pay in wrapped SOL). `existing`: any mint by address, launched anywhere, classic or Token-2022, pump.fun included (xgames.fun takes no share of its fees). `project` (`game` is its older spelling): a token made when the economy goes live: the project mints it as its rules say (points, tickets, shards), or, with `supply`, a fixed supply minted once to the owner (a community token you keep). A token made this way is named on chain as it is made (its `name`, `symbol` and `uri`), which is what wallets show. Only the owner's wallet can change that later: a change to them in a spec that is live is written to the token's name record at the next approve, when it has one its owner can still change (a token that went live before setups named tokens has none).",
       "properties": {
         "key": {
           "$ref": "#/$defs/key"
@@ -2037,6 +2037,12 @@
                   "tree": {
                     "$ref": "#/$defs/address"
                   },
+                  "tables": {
+                    "type": "array",
+                    "items": {
+                      "$ref": "#/$defs/address"
+                    }
+                  },
                   "mints": {
                     "type": "object",
                     "additionalProperties": {

package/js/mcp/tools.mjs

@@ -16,7 +16,7 @@ import { LOOT_PROGRAM, pda } from '../client/pda.js';
 import { check, describe } from '../economy/check.mjs';
 import { legalFlags } from '../economy/legal.mjs';
 import { cost, explainCost } from '../economy/cost.mjs';
-import { changedParts } from '../economy/live.mjs';
+import { changedParts, renamesNote } from '../economy/live.mjs';
 import { example, examples, ideas, search, partsUsed } from '../economy/examples.mjs';
 import { explainEconomy } from '../economy/explain.mjs';
 import { describeReview, review } from '../economy/review.mjs';
@@ -247,10 +247,11 @@ function flagsToTell(economy, now) {
  * what can't change or was taken out.
  */
 function liveChange(economy) {
-  if (!economy.live?.project || !economy.live?.published) return { scope: {}, notes: '', settings: [] };
-  const { only, fixed, removed, settings } = changedParts(economy);
+  if (!economy.live?.project || !economy.live?.published) return { scope: {}, notes: '', settings: [], changes: 0 };
+  const { only, fixed, removed, settings, renames } = changedParts(economy);
   const notes = [
     settings.length ? `\n${settingsNote(settings, economy.live)}` : '',
+    renames.length ? `\n${renamesNote(renames)}` : '',
     fixed.length
       ? `\nThese can't change once live, and stay as they were: ${fixed.join(', ')} (a farm, an auction or a pool's token).`
       : '',
@@ -258,7 +259,8 @@ function liveChange(economy) {
       ? `\nTaken out of the spec but still on chain: ${removed.join(', ')}. To stop one, keep it and set "active": false.`
       : '',
   ].join('');
-  return { scope: { only, live: economy.live }, notes, settings };
+  // (`changes`: whether anything is to be published at all: a part, or a token's name)
+  return { scope: { only, live: economy.live, renames }, notes, settings, changes: only.size + renames.length };
 }
 
 /** In words: the spec changes the project's own settings, which publishing never writes. */
@@ -428,11 +430,20 @@ export const tools = [
       const c = cost(economy, { now: nowOf(ctx), ...change.scope });
       if (!c.ok) return refused(c, from);
       const head = change.scope.live
-        ? change.scope.only.size
-          ? `This economy is live: this prices only the change (${[...change.scope.only].join(', ')}).\n`
+        ? change.changes
+          ? `This economy is live: this prices only the change (${[...change.scope.only, ...change.scope.renames.map(key => `the name of ${key}`)].join(', ')}).\n`
           : 'This economy is live and nothing has changed since it went live: publishing costs nothing.\n'
         : '';
-      return { ok: true, from, setup: c.setup, actions: c.actions, fees: c.fees, text: head + explainCost(c) + footer };
+      // (a name's price is a transaction's, if it is sent at all: only approving reads the token's record)
+      const names = change.scope.renames?.length ? `\n${renamesNote(change.scope.renames)}` : '';
+      return {
+        ok: true,
+        from,
+        setup: c.setup,
+        actions: c.actions,
+        fees: c.fees,
+        text: head + explainCost(c) + names + footer,
+      };
     },
   },
   {
@@ -559,7 +570,7 @@ export const tools = [
     async handler(input, ctx) {
       const { economy, from, file } = await load(input, ctx);
       const change = liveChange(economy);
-      if (change.scope.live && !change.scope.only.size && change.settings.length)
+      if (change.scope.live && !change.changes && change.settings.length)
         return {
           ok: false,
           transactions: 0,
@@ -567,7 +578,7 @@ export const tools = [
           steps: [],
           text: `${from} is live, and its parts are as they are on chain. ${settingsNote(change.settings, economy.live)}${footer}`,
         };
-      if (change.scope.live && !change.scope.only.size)
+      if (change.scope.live && !change.changes)
         return {
           ok: true,
           transactions: 0,
@@ -578,7 +589,15 @@ export const tools = [
       const p = plan(economy, { now: nowOf(ctx), ...change.scope });
       if (!p.ok) return refused(p, from);
       const c = cost(economy, { now: nowOf(ctx), ...change.scope });
-      const steps = p.transactions.flatMap(t => t.steps.map(s => s.says));
+      // A token's new name is listed as the file has it: whether it is sent is the chain's to say, as approving reads it.
+      const steps = p.transactions.flatMap(t =>
+        t.steps.map(s =>
+          s.id.startsWith('name:')
+            ? `${s.says} (sent only if the token has a name record its owner can still change, read when approving)`
+            : s.says,
+        ),
+      );
+      const renaming = Boolean(change.scope.renames?.length);
       // the file as the approve command names it, relative to the project folder (projectFile's), and plain (plainName)
       const target = file ? path.relative(realPath(path.resolve(cwdOf(ctx))), file) || DEFAULT_FILE : DEFAULT_FILE;
       if (plainName(target) === null)
@@ -592,7 +611,7 @@ export const tools = [
       const command = approveCommand(target);
       const text = [
         ...flagsToTell(economy, nowOf(ctx)),
-        `${change.scope.live ? 'Publishing this change to the live economy' : 'Going live'}: ${plural(p.transactions.length, 'transaction')}, ${plural(p.approvals, 'wallet approval')}, about ${c.setup.totalSol} SOL on devnet:`,
+        `${change.scope.live ? 'Publishing this change to the live economy' : 'Going live'}: ${renaming ? 'at most ' : ''}${plural(p.transactions.length, 'transaction')}, ${plural(p.approvals, 'wallet approval')}, about ${c.setup.totalSol} SOL on devnet:`,
         ...steps.map((s, i) => `${i + 1}. ${s}`),
         '',
         `To put it live, the person runs this in a terminal in the project folder (not you): ${command}`,
@@ -862,6 +881,7 @@ export const tools = [
         '  app.listForSale(asset, { price }), app.listForRent(asset, { price, lasts, maxPeriods }), app.listing(asset), app.listings(),',
         '  app.buyListing(asset, { listing }), app.rentListing(asset, { periods, listing }) (`listing`: what listing() or listings()',
         '  showed the player), app.unlist(asset), app.rentedTo(asset) (one account read)   listings, sale and rent',
+        '  app.closeGone(asset)   anyone closes the holds and the listing of an NFT the project no longer holds (its collection took it back or burned it): nothing is sent or paid; claims() lists such a hold or loan flagged `gone`, and listing() flags such a listing',
         '  app.raffle(id, nft, { price, drawsAt, minSold }), app.unraffle(id, nft)   a raffle from the lottery’s own stash',
         '  app.compound(key), app.runSchedule(key)   compound, send a schedule that is due (a run missed is missed: only a sealed fixed amount pays every run due)',
         '  app.farmWalk(key), app.walkFarm(key)   a farm idle past many end times: how many it must walk, and walking them in parts (anyone, free; moves ask for the compute to walk a few themselves)',