@xgamesfun/solana 0.20.1 → 0.24.0

package/README.md

@@ -12,7 +12,7 @@ package `@xgamesfun/solana`:
 
 An economy is a JSON spec, not a new smart contract. Every project shares the one program, and none writes its own.
 
-> **Status:** loot 0.20.1, program ID `9cwqM1TXytPnFZsLfmUyv2dg4uW6Ch9C6UJVPns7NFQ`, **devnet only**. The program is
+> **Status:** loot 0.24.0, program ID `9cwqM1TXytPnFZsLfmUyv2dg4uW6Ch9C6UJVPns7NFQ`, **devnet only**. The program is
 > not independently audited, and nothing runs on mainnet until it is. See [SECURITY.md](SECURITY.md).
 
 > **Disclaimer:** provided as is, with no warranty and no guarantee that the program or the tools are safe. Use them
@@ -27,7 +27,7 @@ An economy is a JSON spec, not a new smart contract. Every project shares the on
 - lotteries and raffles, including no-loss lotteries
 - prizes of any kind on every route, random or not: items, tokens, and NFTs the project holds in a stash
 - an NFT as the price on every route that takes money
-- staking farms with lock tiers, boosts, early exits and tolls
+- staking farms with lock tiers, boosts, early exits, fixed or shared rates and terms
 - crafting recipes
 - holds and contests, with prizes by rank or by stake
 - auctions: the highest bid wins, the outbid refunded at once
@@ -59,13 +59,13 @@ codex plugin add xsolana@xgamesfun
 ```
 
 **Any agent with MCP** (Cursor, opencode, Cline…): run the server with
-`npx -y --package=@xgamesfun/solana@0.20.1 xsolana mcp`. Or let `npx -y @xgamesfun/solana@0.20.1 connect` register it, with
+`npx -y --package=@xgamesfun/solana@0.24.0 xsolana mcp`. Or let `npx -y @xgamesfun/solana@0.24.0 connect` register it, with
 the skill, for Claude Code and Codex.
 
 Then ask for an economy, for example *"a fishing game where each cast costs 0.02 SOL, with a rare golden fish and a
 monthly draw"*.
 
-Going live is always yours: `npx -y @xgamesfun/solana@0.20.1 approve` opens a page on your computer where you connect a
+Going live is always yours: `npx -y @xgamesfun/solana@0.24.0 approve` opens a page on your computer where you connect a
 devnet wallet and approve each transaction. The agent never signs and never asks for a key.
 
 ## Use it from a terminal
@@ -73,12 +73,12 @@ devnet wallet and approve each transaction. The agent never signs and never asks
 Every tool runs from the CLI too, on a spec file (`xsolana.json` by default):
 
 ```bash
-npx -y @xgamesfun/solana@0.20.1 examples shop with loot boxes   # the nearest worked examples
-npx -y @xgamesfun/solana@0.20.1 check xsolana.json                 # refusals and warnings
-npx -y @xgamesfun/solana@0.20.1 simulate xsolana.json              # where the money goes, day by day
-npx -y @xgamesfun/solana@0.20.1 cost xsolana.json                  # what going live and each action cost
-npx -y @xgamesfun/solana@0.20.1 explain xsolana.json               # the economy in plain words
-npx -y @xgamesfun/solana@0.20.1 approve xsolana.json               # go live, approved in your own wallet
+npx -y @xgamesfun/solana@0.24.0 examples shop with loot boxes   # the nearest worked examples
+npx -y @xgamesfun/solana@0.24.0 check xsolana.json                 # refusals and warnings
+npx -y @xgamesfun/solana@0.24.0 simulate xsolana.json              # where the money goes, day by day
+npx -y @xgamesfun/solana@0.24.0 cost xsolana.json                  # what going live and each action cost
+npx -y @xgamesfun/solana@0.24.0 explain xsolana.json               # the economy in plain words
+npx -y @xgamesfun/solana@0.24.0 approve xsolana.json               # go live, approved in your own wallet
 ```
 
 `xsolana help` lists every command. Every command names the exact version, so `npx` runs that release and never whatever

package/examples/coin-flip-arena.json

@@ -26,11 +26,6 @@
       "currency": "sol",
       "seed": 5,
       "about": "Pays the winning flips. 88% of every flip comes back into it."
-    },
-    {
-      "key": "backers",
-      "currency": "sol",
-      "about": "The 2% edge, shared by everyone who stakes ARENA."
     }
   ],
   "boxes": [
@@ -48,7 +43,7 @@
           "percent": 10
         },
         {
-          "to": "pool:backers",
+          "to": "farm:backers",
           "percent": 2
         }
       ],
@@ -96,7 +91,7 @@
       "key": "backers",
       "name": "Back the house",
       "stakes": "arena",
-      "rewards": "backers",
+      "rewards": "sol",
       "tiers": [
         {
           "lock": "1d",

package/examples/elements-set.json

@@ -46,13 +46,6 @@
       "name": "Elemental Badge"
     }
   ],
-  "pools": [
-    {
-      "key": "spark-rewards",
-      "currency": "spark",
-      "about": "Names the reward token: both farms mint SPARK at their rates, so nothing waits here."
-    }
-  ],
   "recipes": [
     {
       "key": "bind",
@@ -232,7 +225,7 @@
       "key": "altar",
       "name": "The altar",
       "stakes": "collectibles",
-      "rewards": "spark-rewards",
+      "rewards": "spark",
       "rate": {
         "perDay": 10,
         "minted": true
@@ -249,7 +242,7 @@
       "name": "The sanctum",
       "stakes": "collectibles",
       "item": "badge",
-      "rewards": "spark-rewards",
+      "rewards": "spark",
       "rate": {
         "perDay": 100,
         "minted": true

package/examples/expedition-guild.json

@@ -38,13 +38,6 @@
       "name": "Rare Relic"
     }
   ],
-  "pools": [
-    {
-      "key": "dust-rewards",
-      "currency": "dust",
-      "about": "Names the guild's reward token: the guild mints DUST at its rate, so nothing waits here."
-    }
-  ],
   "boxes": [
     {
       "key": "chest",
@@ -110,7 +103,7 @@
       "name": "The guild",
       "stakes": "collectibles",
       "item": "hero",
-      "rewards": "dust-rewards",
+      "rewards": "dust",
       "rate": {
         "perDay": 10,
         "minted": true

package/examples/guild-missions.json

@@ -20,13 +20,6 @@
   "collection": {
     "name": "Guild Missions"
   },
-  "pools": [
-    {
-      "key": "gem-rewards",
-      "currency": "gem",
-      "about": "Names the guild's token: every farm here mints it, so nothing waits in this pool."
-    }
-  ],
   "traits": [
     {
       "collection": "Cvb5ZbtpUMk8yNG9GzC5nQ7FkB2xPVUZzZaxXqgNbvxR",
@@ -43,7 +36,7 @@
       "gate": {
         "collection": "Cvb5ZbtpUMk8yNG9GzC5nQ7FkB2xPVUZzZaxXqgNbvxR"
       },
-      "rewards": "gem-rewards",
+      "rewards": "gem",
       "rate": {
         "perDay": 5,
         "minted": true
@@ -77,7 +70,7 @@
         "attribute": "level",
         "atLeast": 3
       },
-      "rewards": "gem-rewards",
+      "rewards": "gem",
       "rate": {
         "perDay": 0,
         "minted": true
@@ -110,7 +103,7 @@
           "atLeast": 6
         }
       ],
-      "rewards": "gem-rewards",
+      "rewards": "gem",
       "rate": {
         "perDay": 0,
         "minted": true

package/examples/halving-seasons.json

@@ -2,7 +2,7 @@
   "version": 2,
   "network": "devnet",
   "name": "Halving Seasons",
-  "prompt": "Rewards mint into the play pool on a schedule that halves every 30 days; a soulbound season pass claims 10 PLAY a day from it; 10% of the play pool drips into the vault's interest every day, shared by everyone who stakes PLAY.",
+  "prompt": "Rewards mint into the play pool on a schedule that halves every 30 days; a soulbound season pass claims 10 PLAY a day from it; 10% of the play pool drips into the vault every day, shared by everyone who stakes PLAY.",
   "currency": "sol",
   "tokens": [
     {
@@ -36,11 +36,6 @@
       "key": "season",
       "currency": "play",
       "about": "What the season mints, before it is claimed."
-    },
-    {
-      "key": "interest",
-      "currency": "play",
-      "about": "The vault's interest."
     }
   ],
   "schedules": [
@@ -57,9 +52,9 @@
     {
       "key": "drip",
       "name": "Interest drip",
-      "does": "move",
+      "does": "pay",
       "from": "season",
-      "to": "interest",
+      "to": "farm:vault",
       "percent": 10,
       "every": "1d"
     }
@@ -100,7 +95,7 @@
       "key": "vault",
       "name": "The vault",
       "stakes": "play",
-      "rewards": "interest",
+      "rewards": "play",
       "tiers": [
         {
           "lock": "1d",

package/examples/hero-trials.json

@@ -13,9 +13,6 @@
     { "key": "hero", "name": "Hero", "price": 0.05 },
     { "key": "relic", "name": "Relic" }
   ],
-  "pools": [
-    { "key": "gem-rewards", "currency": "gem", "about": "Names the expedition's token: it pays nothing, its result is a roll." }
-  ],
   "boxes": [
     {
       "key": "enchant",
@@ -84,7 +81,7 @@
       "stakes": "collectibles",
       "item": "hero",
       "custody": "freeze",
-      "rewards": "gem-rewards",
+      "rewards": "gem",
       "rate": { "perDay": 0, "minted": true },
       "tiers": [{ "lock": "1d", "multiplier": 1, "roll": "expedition-result" }]
     }

package/examples/merge-2048.json

@@ -2,7 +2,7 @@
   "version": 2,
   "network": "devnet",
   "name": "2048 Collection",
-  "prompt": "Two of tier N merge into one of tier N+1. The single top piece also claims a huge pool prize, so the whole collection races to merge. Priced in a coin launched on pump.fun.",
+  "prompt": "Two of tier N merge into one of tier N+1. The single top piece also claims a fixed prize from a pool every sale fills, so the whole collection races to merge. Priced in a coin launched on pump.fun.",
   "currency": "tile",
   "tokens": [
     {
@@ -55,7 +55,7 @@
     {
       "key": "grand",
       "currency": "tile",
-      "about": "20% of every tile sold; half of it goes to whoever makes the top tile."
+      "about": "20% of every tile sold; whoever makes the top tile takes 8, half of what its eight tiles paid in."
     }
   ],
   "recipes": [
@@ -109,9 +109,9 @@
           "item": "tier-4"
         },
         {
-          "gives": "share",
-          "pool": "grand",
-          "percent": 50
+          "gives": "tokens",
+          "from": "pool:grand",
+          "amount": 8
         }
       ]
     }

package/examples/paper-hands-farm.json

@@ -2,7 +2,7 @@
   "version": 2,
   "network": "devnet",
   "name": "Paper Hands Farm",
-  "prompt": "Stake GEM for 30 days to earn more GEM. Leave early and 10% of what you take out goes to the stakers who stay. Unstaking takes 7 days, earning nothing meanwhile. 2% of every harvest is burned. Holders can compound their rewards without restarting the lock.",
+  "prompt": "Stake GEM for 30 days to earn more GEM, 1,000 minted into the farm a day. Leave early and 10% of what you take out goes to the stakers who stay. Holders can compound their rewards without restarting the lock.",
   "currency": "gem",
   "tokens": [
     {
@@ -14,20 +14,13 @@
     }
   ],
   "collection": false,
-  "pools": [
-    {
-      "key": "farm-rewards",
-      "currency": "gem",
-      "about": "What the farm shares: a daily emission, and early-exit fees."
-    }
-  ],
   "schedules": [
     {
       "key": "emission",
       "name": "Daily emission",
       "does": "issue",
       "currency": "gem",
-      "pool": "farm-rewards",
+      "to": "farm:farm",
       "amount": 1000,
       "every": "1d"
     }
@@ -37,7 +30,7 @@
       "key": "farm",
       "name": "The farm",
       "stakes": "gem",
-      "rewards": "farm-rewards",
+      "rewards": "gem",
       "tiers": [
         {
           "lock": "30d",
@@ -45,12 +38,7 @@
           "exitFee": 10
         }
       ],
-      "exitFeeTo": "pool:farm-rewards",
-      "unbond": "7d",
-      "toll": {
-        "percent": 2,
-        "to": "burn"
-      }
+      "exitFeeTo": "rewards"
     }
   ]
 }

package/examples/partner-vault.json

@@ -13,9 +13,6 @@
     { "key": "pass", "name": "Expedition Pass", "price": 0.01 },
     { "key": "trinket", "name": "Trinket", "value": 0.01 }
   ],
-  "pools": [
-    { "key": "shard-rewards", "currency": "shards", "about": "Names the expedition's token: it pays nothing, its result is a chest." }
-  ],
   "stashes": [
     {
       "key": "vault",
@@ -94,7 +91,7 @@
       "name": "Expedition",
       "stakes": "collectibles",
       "item": "pass",
-      "rewards": "shard-rewards",
+      "rewards": "shards",
       "rate": { "perDay": 0, "minted": true },
       "tiers": [{ "lock": "1d", "multiplier": 1, "prize": { "gives": "roll", "box": "daily-chest" } }]
     }

package/examples/stakers-draw.json

@@ -40,19 +40,12 @@
       }
     }
   ],
-  "pools": [
-    {
-      "key": "vault-rewards",
-      "currency": "gem",
-      "about": "Names the vault's token: its rate is minted, so nothing is paid from here."
-    }
-  ],
   "farms": [
     {
       "key": "vault",
       "name": "The vault",
       "stakes": "gem",
-      "rewards": "vault-rewards",
+      "rewards": "gem",
       "rate": {
         "perDay": 0.001,
         "minted": true

package/examples/star-fleet.json

@@ -34,13 +34,6 @@
       "price": 0.05
     }
   ],
-  "pools": [
-    {
-      "key": "ore-rewards",
-      "currency": "ore",
-      "about": "Names the fleet's reward token: the mine mints ORE at its rate, so nothing waits here."
-    }
-  ],
   "recipes": [
     {
       "key": "refuel",
@@ -118,7 +111,7 @@
       "name": "The mine",
       "stakes": "collectibles",
       "item": "ship",
-      "rewards": "ore-rewards",
+      "rewards": "ore",
       "rate": {
         "perDay": 100,
         "minted": true

package/examples/starforce.json

@@ -2,7 +2,7 @@
   "version": 2,
   "network": "devnet",
   "name": "Starforce",
-  "prompt": "Each try burns the sword and pays a fee; the roll goes up a level, stays (the same sword, minted again) or destroys it, with a tiny lucky chance at a tenth of the jackpot the fees fill.",
+  "prompt": "Each try burns the sword and pays a fee; the roll goes up a level, stays (the same sword, minted again) or destroys it, with a tiny lucky chance at a fixed prize from the pool the fees fill.",
   "currency": "sol",
   "tokens": [
     {
@@ -39,7 +39,7 @@
       "key": "jackpot",
       "currency": "sol",
       "seed": 2,
-      "about": "Every try's fee; the lucky roll takes a tenth."
+      "about": "Every try's fee; the lucky roll takes 0.2 SOL."
     }
   ],
   "recipes": [
@@ -93,14 +93,14 @@
           "chance": 45
         },
         {
-          "gives": "burn",
+          "gives": "nothing",
           "chance": 14.5
         },
         {
-          "gives": "share",
+          "gives": "pay",
           "pool": "jackpot",
-          "percent": 10,
-          "chance": 0.5
+          "chance": 0.5,
+          "amount": 0.2
         }
       ]
     }

package/js/approve/details.mjs

@@ -4,7 +4,7 @@
 // claim it. Addresses are written in full, so an owner sees a payee that an edit re-pointed before they sign.
 import { decodeBorsh } from '../chain/borsh.js';
 import { equalBytes, toHex } from '../chain/bytes.js';
-import { accountKind, decode, IDL, keyLeaf, merkleRoot } from '../client/index.js';
+import { accountKind, decode, IDL, instructionOf, keyLeaf, merkleRoot } from '../client/index.js';
 import { LOOT_PROGRAM, pda } from '../client/pda.js';
 import { fromUnits } from '../economy/model.mjs';
 import { grantArgs } from '../economy/plan.mjs';
@@ -18,7 +18,7 @@ const leafNames = (list) => list.flatMap((a) => (a.accounts ? leafNames(a.accoun
 /** A loot instruction read back: { name, args, accounts: { name: address } }, or null for another program's. */
 function readLootInstruction(ix) {
   if (ix.programId !== LOOT_PROGRAM) return null;
-  const def = IDL.instructions.find((i) => i.discriminator.length <= ix.data.length && i.discriminator.every((b, j) => ix.data[j] === b));
+  const def = instructionOf(ix.data);
   if (!def) return null;
   const args = {};
   let at = def.discriminator.length;
@@ -93,6 +93,7 @@ function readDetails(reads, names) {
     const owner = read.accounts.owner ?? read.accounts.seller;
     const project = read.accounts.project;
     const pots = new Map(names.m.lotteries.map((l) => [pda.pot(pda.lottery(project, l.id)), l.name ?? l.key]));
+    const vaults = new Map(names.m.farms.map((f) => [pda.rewards(pda.farm(project, f.id)), f.name ?? f.key]));
     // Before a wallet connects, the plan stands a made-up address in for it (one no spec may name): that one is not
     // shown. Once one is connected, only that wallet is called yours.
     const yours = (a) => (names.owner == null ? 'your wallet' : a === names.owner ? `your wallet (${a})` : `the project’s owner, ${a}`);
@@ -105,7 +106,7 @@ function readDetails(reads, names) {
       const v = to[kind];
       if (kind === 'Pool') return `the pool “${names.pools.get(v[0]) ?? v[0]}”`;
       if (kind === 'Wallet') return wallet(v[0]);
-      if (kind === 'Account') return pots.has(v[0]) ? `the pot of “${pots.get(v[0])}”` : `the token account ${v[0]}`;
+      if (kind === 'Account') return pots.has(v[0]) ? `the pot of “${pots.get(v[0])}”` : vaults.has(v[0]) ? `the rewards of the farm “${vaults.get(v[0])}”` : `the token account ${v[0]}`;
       if (kind === 'Holder') return `whoever holds the NFT ${v[0]}`;
       if (kind === 'Chosen') return 'a wallet the buyer chooses';
       return JSON.stringify(to);
@@ -173,7 +174,7 @@ function prizeWords(gives, m) {
   const item = (id) => `the item “${named(m.items, id)?.name ?? named(m.items, id)?.key ?? id}”`;
   if (kind === 'Tokens') {
     const from = v.from.Pool ? `from the pool “${m.pools.find((p) => p.index === v.from.Pool[0])?.key ?? v.from.Pool[0]}”` : v.from.Mint ? `minted from ${v.from.Mint[0]}` : `from the vault ${v.from.Vest[0]}`;
-    const amount = v.amount.Fixed ? tokens(v.amount.Fixed[0], prizeToken(gives, m)) : `${Number(v.amount.Bps[0]) / 100}% of what it holds`;
+    const amount = tokens(v.amount, prizeToken(gives, m));
     return `${amount} ${from}`;
   }
   if (kind === 'Item') return item(v[0]);
@@ -196,13 +197,13 @@ function grantTerms(args, names) {
     l.wallet?.per_window ? `each wallet ${times(l.wallet.per_window)} every ${l.wallet.window} seconds` : null,
     l.per_person ? `each person ${times(l.per_person)}` : null,
     l.per_key ? `each voucher key ${times(l.per_key)}` : null,
-    l.per_day ? `${times(l.per_day)} a day` : null,
-    l.total ? `${times(l.total)} in all` : null,
+    l.all?.per_window ? `${times(l.all.per_window)} ${Number(l.all.window) === 86_400 ? 'a day' : `every ${l.all.window} seconds`}` : null,
+    l.all?.total ? `${times(l.all.total)} in all` : null,
     BigInt(l.window?.opens_at ?? 0) ? `opens ${when(l.window.opens_at)}` : null,
     BigInt(l.window?.closes_at ?? 0) ? `closes ${when(l.window.closes_at)}` : null,
   ].filter(Boolean);
   // A voucher or a list entry may name an amount of its own, up to the grant's fixed amount (0 is the prize as it is).
-  const upTo = !args.open && args.gives?.Tokens?.amount?.Fixed ? 'up to ' : '';
+  const upTo = !args.open && args.gives?.Tokens ? 'up to ' : '';
   return [`Each claim gets: ${upTo}${prizeWords(args.gives, names.m)}`, `Limits: ${limits.length ? limits.join(', ') : 'none'}`];
 }
 

package/js/approve/server.mjs

@@ -13,10 +13,12 @@ import { spawn } from 'node:child_process';
 import { equalBytes, fromBase64, toBase64 } from '../chain/bytes.js';
 import { checkCluster, notMainnet, rpcClient } from '../chain/rpc.js';
 import { addressBytes, encodeBase58 } from '../chain/base58.js';
+import { slotHashes, tableAddress } from '../chain/lookup.js';
+import { SYSVAR_SLOT_HASHES } from '../chain/pda.js';
 import { MINT_BYTES } from '../chain/token.js';
 import { compileMessage, readTransaction, wireTransaction } from '../chain/tx.js';
 import { accountKind, decode } from '../client/accounts.js';
-import { LOOT_PROGRAM } from '../client/pda.js';
+import { LOOT_PROGRAM, pda } from '../client/pda.js';
 import { check, describe } from '../economy/check.mjs';
 import { cost } from '../economy/cost.mjs';
 import { LEGAL, legalFlags } from '../economy/legal.mjs';
@@ -170,7 +172,9 @@ export async function createApproval({ file, chain = devnetChain(), now = () =>
       return rents.get(bytes);
     };
     const addresses = Object.fromEntries([...keys].map(([n, k]) => [n, k.address]));
-    const p = prepare(spec, { owner, keys: addresses, live: live() ?? {}, now: at, rent, only });
+    // A recent slot, for the project's standing lookup table (made at go-live at a slot still in the slot hashes when it lands).
+    const hashes = slotHashes((await chain.account(SYSVAR_SLOT_HASHES).catch(() => null))?.data);
+    const p = prepare(spec, { owner, keys: addresses, live: live() ?? {}, now: at, rent, only, slot: hashes[0] ?? null });
     if (!p.ok) throw new ApproveError(400, describe({ refusals: p.refusals, warnings: [] }));
     return p;
   }
@@ -197,7 +201,15 @@ export async function createApproval({ file, chain = devnetChain(), now = () =>
         if (lines) was.set(step.id, lines);
       }
     }
-    wasLive = { steps: was, treasury: p.ctx.treasury };
+    // A grant published before and gone from the chain (closed) that the change makes again with a list: a list leaf
+    // names no grant or incarnation, so the same root would pay every listed round again.
+    const remade = [];
+    const published = new Set((spec.live.published.grants ?? []).map((g) => g.key));
+    for (const g of model(spec, { now: at }).grants) {
+      if (!g.list?.length || !published.has(g.key) || !p.ctx.project) continue;
+      if (!(await chain.account(pda.grant(p.ctx.project, g.id)).catch(() => 'unread'))) remade.push(`“${g.name ?? g.key}”`);
+    }
+    wasLive = { steps: was, treasury: p.ctx.treasury, remade };
   }
   const detailsOf = (t, i, n) => {
     const lines = stepDetails(t.built[i], n);
@@ -206,6 +218,7 @@ export async function createApproval({ file, chain = devnetChain(), now = () =>
   };
   /** The lines a change is held against for its outside-address warning: what was read from the chain, or nothing yet. */
   const wasLines = () => (spec.live?.published ? [...(wasLive ? [...wasLive.steps.values()].flat() : []), ...(wasLive?.treasury ? [`Treasury: ${wasLive.treasury}`] : [])] : null);
+  const remadeLists = () => (wasLive?.remade?.length ? `This change makes ${wasLive.remade.join(', ')} again after it was closed, with the same list: a list names no grant, so every wallet on it could claim every listed round again. Give the grant a fresh list (new rounds) before you approve.` : null);
   const unread = () => (spec.live?.published && !wasLive ? 'What is live has not been read from the chain yet: connect your wallet, and each line is marked against what is on chain.' : null);
 
   // The project's own settings a change names are never published: the page says so.
@@ -227,7 +240,7 @@ export async function createApproval({ file, chain = devnetChain(), now = () =>
       program: LOOT_PROGRAM,
       cluster: 'devnet',
       setupSol: cost(spec, { now: at, live: live(), only }).setup?.totalSol ?? null,
-      warnings: [...(extra.refused ? [extra.refused] : []), ...verdict.warnings.filter((w) => !Object.hasOwn(LEGAL, w.code)).map((w) => w.message), ...[settings, unread(), outsideAddresses(steps.flatMap((s) => s.details), { was: wasLines(), owner: n.owner })].filter(Boolean)],
+      warnings: [...(extra.refused ? [extra.refused] : []), ...verdict.warnings.filter((w) => !Object.hasOwn(LEGAL, w.code)).map((w) => w.message), ...[settings, unread(), remadeLists(), outsideAddresses(steps.flatMap((s) => s.details), { was: wasLines(), owner: n.owner })].filter(Boolean)],
       // The legal flags in plain words, shown in a block of their own whatever the agent said: Approve waits until the
       // owner ticks that they read them.
       legal,
@@ -399,6 +412,7 @@ export async function createApproval({ file, chain = devnetChain(), now = () =>
       ...(ids.has('project') ? { project: ctx.project, treasury: ctx.treasury, authority: ctx.authority } : {}),
       ...(ids.has('collection') && ctx.collection ? { collection: ctx.collection } : {}),
       ...(ids.has('tree') && ctx.tree ? { tree: ctx.tree } : {}),
+      ...(ids.has('table') && ctx.slot != null ? { tables: [tableAddress(ctx.owner, ctx.slot)[0]] } : {}),
       ...(Object.keys(mints).length ? { mints } : {}),
     };
   }
@@ -479,6 +493,7 @@ export async function createApproval({ file, chain = devnetChain(), now = () =>
       ...(made.has('project') ? { project: ctx.project, treasury: ctx.treasury, authority: ctx.authority } : {}),
       ...(made.has('collection') && ctx.collection ? { collection: ctx.collection } : {}),
       ...(made.has('tree') && ctx.tree ? { tree: ctx.tree } : {}),
+      ...(made.has('table') && ctx.slot != null ? { tables: [tableAddress(ctx.owner, ctx.slot)[0]] } : {}),
       mints,
       landed: [...new Set([...(was.landed ?? []), ...ids])],
       partial: true,
@@ -496,7 +511,7 @@ export async function createApproval({ file, chain = devnetChain(), now = () =>
     if (rest.ok && rest.transactions.length === 0) {
       const { live: _, ...bare } = spec;
       // Everything the setup made, whichever session or transaction made it.
-      const all = { ...ctx, ...Object.fromEntries(['project', 'treasury', 'authority', 'collection', 'tree'].map((k) => [k, progress[k] ?? ctx[k]])), mints: { ...(ctx.mints ?? {}), ...(progress.mints ?? {}) } };
+      const all = { ...ctx, ...Object.fromEntries(['project', 'treasury', 'authority', 'collection', 'tree', 'tables'].map((k) => [k, progress[k] ?? ctx[k]])), mints: { ...(ctx.mints ?? {}), ...(progress.mints ?? {}) } };
       const final = recordLanded(bare, { ctx: all, now: at, at: new Date(clock()).toISOString() });
       final.live = { ...final.live, transactions: progress.transactions };
       spec = final;

package/js/chain/borsh.js

@@ -35,6 +35,10 @@ function encodeScalar(type, value, out) {
   else if (type === 'string') {
     const bytes = utf8(String(value));
     out.push(uintLE(bytes.length, 4), bytes);
+  } else if (type === 'bytes') {
+    // A list of bytes (`Vec<u8>`): its length, then the bytes.
+    const bytes = Uint8Array.from(value);
+    out.push(uintLE(bytes.length, 4), bytes);
   } else throw new Error(`Unsupported IDL type ${type}`);
 }
 
@@ -146,6 +150,11 @@ function decodeScalar(type, data, at) {
     if (at + 4 + length > data.length) throw new RangeError('string runs past the end of the data');
     return [fromUtf8(data.subarray(at + 4, at + 4 + length)), at + 4 + length];
   }
+  if (type === 'bytes') {
+    const length = Number(readUintLE(data, at, 4));
+    if (at + 4 + length > data.length) throw new RangeError('bytes run past the end of the data');
+    return [data.slice(at + 4, at + 4 + length), at + 4 + length];
+  }
   throw new Error(`Unsupported IDL type ${type}`);
 }
 

package/js/chain/core.js

@@ -150,14 +150,26 @@ export function parseCoreAsset(data) {
   return asset;
 }
 
-/** Decode the start of a Core CollectionV1: { updateAuthority, name, uri, numMinted, currentSize }. */
+/** Decode the start of a Core CollectionV1: { updateAuthority, name, uri, numMinted, currentSize, bubblegum (whether it
+ * carries Bubblegum's plugin, BubblegumV2: compressed NFTs can be minted into it) }. */
 export function parseCoreCollection(data) {
   if (data[0] !== COLLECTION_V1) throw new Error('Not a Core collection');
   const r = reader(data, 1);
   const updateAuthority = r.address();
   const name = r.text();
   const uri = r.text();
-  return { updateAuthority, name, uri, numMinted: r.u32(), currentSize: r.u32() };
+  const out = { updateAuthority, name, uri, numMinted: r.u32(), currentSize: r.u32(), bubblegum: false };
+  if (r.at >= data.length || data[r.at] !== PLUGIN_HEADER) return out;
+  r.skip(1);
+  const registry = reader(data, Number(r.u64()) + 1);
+  const plugins = registry.u32();
+  for (let i = 0; i < plugins; i++) {
+    const type = registry.byte();
+    if (registry.byte() === 3) registry.skip(32);
+    registry.u64();
+    if (type === PLUGIN.BubblegumV2) out.bubblegum = true;
+  }
+  return out;
 }
 
 /** getProgramAccounts filters for Core assets owned by `owner` in `collection` (no indexer needed). */