@xgamesfun/solana 0.20.1 → 0.24.0

package/js/economy/schema.json

@@ -56,7 +56,6 @@
     },
     "tokens": {
       "type": "array",
-      "maxItems": 16,
       "items": {
         "$ref": "#/$defs/token"
       }
@@ -74,7 +73,6 @@
     },
     "items": {
       "type": "array",
-      "maxItems": 64,
       "items": {
         "$ref": "#/$defs/item"
       }
@@ -88,85 +86,80 @@
     },
     "stashes": {
       "type": "array",
-      "maxItems": 32,
       "items": {
         "$ref": "#/$defs/stash"
       },
       "description": "NFTs the game holds to give away as prizes: a box's outcome `{ \"gives\": \"stash\" }` gives one of a stash's at random. The owner's wallet hands each listed NFT to the game when the economy goes live, so it must hold them then."
     },
+    "tables": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/table"
+      },
+      "description": "Tables of weighted rows the project writes once and seals: a fresh item's trait draws a row of one per unit (its label, or its number), by weight among the rows still in stock. Written when the economy goes live, a batch of rows a transaction."
+    },
     "boxes": {
       "type": "array",
-      "maxItems": 32,
       "items": {
         "$ref": "#/$defs/box"
       }
     },
     "payments": {
       "type": "array",
-      "maxItems": 32,
       "items": {
         "$ref": "#/$defs/payment"
       }
     },
     "recipes": {
       "type": "array",
-      "maxItems": 64,
       "items": {
         "$ref": "#/$defs/recipe"
       }
     },
     "schedules": {
       "type": "array",
-      "maxItems": 32,
       "items": {
         "$ref": "#/$defs/schedule"
       }
     },
     "lotteries": {
       "type": "array",
-      "maxItems": 16,
       "items": {
         "$ref": "#/$defs/lottery"
       }
     },
     "farms": {
       "type": "array",
-      "maxItems": 32,
       "items": {
         "$ref": "#/$defs/farm"
       }
     },
     "contests": {
       "type": "array",
-      "maxItems": 16,
       "items": {
         "$ref": "#/$defs/contest"
       }
     },
     "auctions": {
       "type": "array",
-      "maxItems": 16,
       "items": {
         "$ref": "#/$defs/auction"
       }
     },
     "holds": {
       "type": "array",
-      "maxItems": 16,
       "items": {
         "$ref": "#/$defs/hold"
       }
     },
     "grants": {
       "type": "array",
-      "maxItems": 64,
       "items": {
         "$ref": "#/$defs/grant"
       }
     },
     "traits": {
       "type": "array",
-      "maxItems": 16,
       "description": "Traits the game vouches for from NFTs' off-chain metadata (a background, a class), so rules can read them: the root of a Merkle tree of each NFT's traits (`loot.traitsTree`), set when the economy goes live. Anyone then writes an NFT's traits into its Sheet with its proof (`app.proveTraits`), and boosts, gates and odds read them like any attribute.",
       "items": {
         "type": "object",
@@ -193,7 +186,6 @@
     },
     "decisions": {
       "type": "array",
-      "maxItems": 32,
       "items": {
         "$ref": "#/$defs/decision"
       }
@@ -213,12 +205,11 @@
     },
     "collections": {
       "type": "array",
-      "maxItems": 7,
       "uniqueItems": true,
       "items": {
         "$ref": "#/$defs/address"
       },
-      "description": "Core collections the owner already controls (their update authority) that the project takes too, besides the one it makes: up to eight in all. An NFT of any of them is the project's own: it reads and writes it as one, and an item may be minted into it (with the project as its update delegate)."
+      "description": "Core collections the owner already controls (their update authority) that the project takes too, besides the one it makes: as many as the project's setup transaction carries (about 25 in all). An NFT of any of them is the project's own: it reads and writes it as one, and an item may be minted into it (with the project as its update delegate)."
     },
     "compressedTree": {
       "type": "object",
@@ -247,8 +238,7 @@
     },
     "link": {
       "type": "string",
-      "pattern": "^https://",
-      "maxLength": 200
+      "pattern": "^https://"
     },
     "words": {
       "type": "string",
@@ -293,8 +283,8 @@
     },
     "destination": {
       "type": "string",
-      "description": "Where a share goes: \"burn\", \"treasury\" (the game's), \"pool:<key>\", \"wallet:<address>\" (a partner, a creator, a charity: the program pays their own account for the currency, and opens it when it is not there), \"account:<token account address>\" (an existing token account of that currency), \"holder:<collectible address>\" (whoever holds that collectible at the time), \"lottery:<key>\" (that lottery's pot), or, in a box's or a lottery's split, \"chosen\" (a wallet the buyer names when they buy: a referrer, a streamer) or \"chosen:<item key>\" (whoever holds the collectible of that item the buyer names: the plot they build on; the buyer must name one a player holds, or the purchase is refused); in a payment's split, \"chosen\" only (a wallet the payer names each time they pay, never their own). A share that can't be paid (its wallet has no account, nobody holds the collectible) goes to the treasury instead; a sale never fails over it.",
-      "pattern": "^(burn|treasury|chosen|chosen:[a-z][a-z0-9-]{0,31}|pool:[a-z][a-z0-9-]{0,31}|lottery:[a-z][a-z0-9-]{0,31}|wallet:[1-9A-HJ-NP-Za-km-z]{32,44}|account:[1-9A-HJ-NP-Za-km-z]{32,44}|holder:[1-9A-HJ-NP-Za-km-z]{32,44})$"
+      "description": "Where a share goes: \"burn\", \"treasury\" (the game's), \"pool:<key>\", \"wallet:<address>\" (a partner, a creator, a charity: the program pays their own account for the currency, and opens it when it is not there), \"account:<token account address>\" (an existing token account of that currency), \"holder:<collectible address>\" (whoever holds that collectible at the time), \"lottery:<key>\" (that lottery's pot), \"farm:<key>\" (that farm's rewards vault, shared by its stakers), or, in a box's or a lottery's split, \"chosen\" (a wallet the buyer names when they buy: a referrer, a streamer) or \"chosen:<item key>\" (whoever holds the collectible of that item the buyer names: the plot they build on; the buyer must name one a player holds, or the purchase is refused); in a payment's split, \"chosen\" only (a wallet the payer names each time they pay, never their own). A share that can't be paid (its wallet has no account, nobody holds the collectible) goes to the treasury instead; a sale never fails over it.",
+      "pattern": "^(burn|treasury|chosen|chosen:[a-z][a-z0-9-]{0,31}|pool:[a-z][a-z0-9-]{0,31}|lottery:[a-z][a-z0-9-]{0,31}|farm:[a-z][a-z0-9-]{0,31}|wallet:[1-9A-HJ-NP-Za-km-z]{32,44}|account:[1-9A-HJ-NP-Za-km-z]{32,44}|holder:[1-9A-HJ-NP-Za-km-z]{32,44})$"
     },
     "share": {
       "type": "object",
@@ -314,7 +304,6 @@
     },
     "split": {
       "type": "array",
-      "maxItems": 4,
       "items": {
         "$ref": "#/$defs/share"
       },
@@ -366,7 +355,7 @@
     "life": {
       "type": "object",
       "additionalProperties": false,
-      "description": "When a recipe may take a collectible of this item. 0 switches a rule off. Fixed once one is issued.",
+      "description": "When a recipe may take a collectible of this item. The kit writes it into each recipe that takes the item, as needs and raises on the collectible (a recipe line that burns, uses, renews or takes it staked): `readyAfter` (its `made` time at least that long ago) and `lasts` (made less than that long ago) on every such line; `uses` (its `used` count raised by one, up to it: the craft is refused past it, MaxedOut) and `cooldown` (its `next_use` time passed, then set that far from now) on a line that uses it or takes it staked; a renew line counts its uses from zero again. 0 switches a rule off. A recipe can be edited at any time, and so can the life it carries.",
       "properties": {
         "readyAfter": {
           "$ref": "#/$defs/duration"
@@ -542,8 +531,7 @@
           "description": "The program's number for it. Written when it goes live; never change it after."
         },
         "name": {
-          "type": "string",
-          "maxLength": 32
+          "type": "string"
         },
         "description": {
           "$ref": "#/$defs/words"
@@ -662,6 +650,34 @@
         "collection": {
           "$ref": "#/$defs/address",
           "description": "A collectible's collection: one of `collections`. Default: the one the setup makes."
+        },
+        "drawn": {
+          "type": "array",
+          "description": "A fresh collectible: at most 64 traits drawn for each unit, in order, written on it, each attribute's name at most 64 bytes. Each from a table (`\"table\": key`, a row by weight among those in stock, drawn atomically with the box's roll) or a range (`\"min\"`/`\"max\"`, every whole number as likely, drawn at the mint from the same answer). Its name and link may contain `{attribute}` for each, beside `{serial}`. A fresh item is given only by a box's roll.",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "attribute"
+            ],
+            "properties": {
+              "attribute": {
+                "type": "string",
+                "minLength": 1
+              },
+              "table": {
+                "$ref": "#/$defs/key"
+              },
+              "min": {
+                "type": "integer",
+                "minimum": 0
+              },
+              "max": {
+                "type": "integer",
+                "minimum": 0
+              }
+            }
+          }
         }
       }
     },
@@ -701,19 +717,17 @@
         "gives"
       ],
       "additionalProperties": false,
-      "description": "One way a box can land: an item, tokens from a pool (`pay`, `share`) or minted (`tokens`), an NFT of a stash at random (`stash`) or a named one (`nft`), a roll of another box (`roll`), up to three of them together (`bundle`), a burn of the payment, or nothing. Give every outcome a `chance` (percents that add up to 100) or every one a `weight`. In a box that rolls on an NFT (`rollsOn`), an outcome can also move numbers on it (`shifts`) and say where it goes (`then`). A box of one outcome that needs no chance sells in one step (`buy`): no order, no settle.",
+      "description": "One way a box can land: an item, a fixed amount of tokens from a pool (`pay`) or minted (`tokens`), all of it or none, an NFT of a stash at random (`stash`) or a named one (`nft`), a roll of another box (`roll`), any number of them together (`bundle`), or nothing. Give every outcome a `chance` (percents that add up to 100) or every one a `weight`. In a box that rolls on an NFT (`rollsOn`), an outcome can also move numbers on it (`shifts`) and say where it goes (`then`). A box of one outcome that needs no chance sells in one step (`buy`): no order, no settle. A box burns its price with a \"burn\" share in its `split`, whatever the roll gives.",
       "properties": {
         "gives": {
           "enum": [
             "item",
             "pay",
-            "share",
             "stash",
             "tokens",
             "nft",
             "roll",
             "bundle",
-            "burn",
             "nothing"
           ]
         },
@@ -736,12 +750,8 @@
         "amount": {
           "$ref": "#/$defs/amount"
         },
-        "percent": {
-          "$ref": "#/$defs/percent"
-        },
         "shifts": {
           "type": "array",
-          "maxItems": 2,
           "description": "For a box that rolls on an NFT (`rollsOn`): numbers this outcome moves on it (+1 level, -2 affection), never below 0, and never above `upTo` when raising. Written on the NFT when the game has authority over it, in its Sheet otherwise. With `fromNow`, a time: a day in jail from now.",
           "items": {
             "type": "object",
@@ -753,8 +763,7 @@
             "properties": {
               "attribute": {
                 "type": "string",
-                "minLength": 1,
-                "maxLength": 32
+                "minLength": 1
               },
               "by": {
                 "anyOf": [
@@ -784,7 +793,7 @@
                     "$ref": "#/$defs/duration"
                   }
                 ],
-                "description": "The most it reaches when raising. With `fromNow`, how far past now."
+                "description": "The most it reaches when raising; left out, no cap. With `fromNow`, how far past now."
               },
               "fromNow": {
                 "type": "boolean",
@@ -854,8 +863,7 @@
         "prizes": {
           "type": "array",
           "minItems": 1,
-          "maxItems": 3,
-          "description": "For bundle: what it gives together, at most three: each { gives: item | pay | share | stash | tokens | nft | roll, … } as an outcome of one says.",
+          "description": "For bundle: what it gives together, any number: each { gives: item | pay | share | stash | tokens | nft | roll, … } as an outcome of one says.",
           "items": {
             "type": "object",
             "required": [
@@ -872,9 +880,6 @@
               "amount": {
                 "$ref": "#/$defs/amount"
               },
-              "percent": {
-                "$ref": "#/$defs/percent"
-              },
               "stash": {
                 "$ref": "#/$defs/key",
                 "description": "For stash: the stash one NFT of which this outcome gives, picked at random when the box is rolled (a box of one such outcome is still rolled by the oracle). For nft: the stash that lists `nft`."
@@ -900,20 +905,22 @@
                 "enum": [
                   "item",
                   "pay",
-                  "share",
                   "stash",
                   "tokens",
                   "nft",
                   "roll"
                 ]
+              },
+              "compressed": {
+                "type": "boolean",
+                "description": "For item: a compressed NFT of the collectible (Bubblegum v2), minted at the settle into the project's tree (`compressedTree`) instead of a Core asset. A plain one holds no collectible's rent; a fresh one's drawn traits are written in the project's Sheet for it, its rent held by the order until the settle."
               }
             }
           }
         },
-        "burns": {
+        "compressed": {
           "type": "boolean",
-          "default": false,
-          "description": "For bundle: the payment is burned, all of it, in place of the box's split."
+          "description": "For item: a compressed NFT of the collectible (Bubblegum v2), minted at the settle into the project's tree (`compressedTree`) instead of a Core asset. A plain one holds no collectible's rent; a fresh one's drawn traits are written in the project's Sheet for it, its rent held by the order until the settle."
         }
       }
     },
@@ -958,6 +965,14 @@
           "default": false,
           "description": "Each item's chance shrinks with what is left of its supply."
         },
+        "whenOut": {
+          "enum": [
+            "stopSales",
+            "drawLeft"
+          ],
+          "default": "stopSales",
+          "description": "What a box that rolls does once an outcome can't be given (an item sold out, a pool short of its prize, a stash empty). \"stopSales\" (the default): it isn't sold while any outcome couldn't cover this purchase's draws and those of purchases still waiting for their answer, so every roll is on the odds written, and the project restocks or edits the box to sell again. \"drawLeft\": it keeps selling, and a roll draws among the outcomes still there by their written weights, so the others' chances rise as one runs out: a player can empty a common outcome to make a rare one likelier. A box selling a rare prize keeps \"stopSales\"."
+        },
         "active": {
           "type": "boolean",
           "default": true,
@@ -969,7 +984,6 @@
         "outcomes": {
           "type": "array",
           "minItems": 1,
-          "maxItems": 8,
           "items": {
             "$ref": "#/$defs/outcome"
           }
@@ -980,7 +994,6 @@
         },
         "odds": {
           "type": "array",
-          "maxItems": 4,
           "items": {
             "$ref": "#/$defs/odds"
           }
@@ -1041,6 +1054,40 @@
               }
             }
           ]
+        },
+        "slots": {
+          "type": "array",
+          "description": "What one open draws: each slot `count` draws among the outcomes it names (`from`: their places in `outcomes`, from 0; all when left out), and with `distinct` no outcome twice in the open. Left out, an open is one draw among every outcome. A pack of five is `[{ \"count\": 5 }]`; a guaranteed rare `[{ \"count\": 4 }, { \"count\": 1, \"from\": [8, 9, 10] }]`. A player may open several packs in one purchase.",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "count"
+            ],
+            "properties": {
+              "count": {
+                "type": "integer",
+                "minimum": 1
+              },
+              "from": {
+                "type": "array",
+                "items": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 65535
+                }
+              },
+              "distinct": {
+                "type": "boolean"
+              },
+              "share": {
+                "type": "number",
+                "minimum": 0,
+                "maximum": 100,
+                "description": "What this slot's draws are worth, as a percent of an open's price. Needed on every slot of a box whose slots name outcomes (`from`), 100 together: a draw that can't be made (its slot sold out) gives this share back, so a guaranteed rare keeps its value when the commons run out. Leave it out when every slot draws among all the outcomes."
+              }
+            }
+          }
         }
       }
     },
@@ -1083,7 +1130,7 @@
         "takes"
       ],
       "additionalProperties": false,
-      "description": "burn: `count` collectibles of `item`, burned. use: one collectible of `item`, kept (counts a use). renew: one kept, its uses counted from zero again. staked: one collectible of `item`, kept as `use` keeps it, that must be staked in `farm`: on its own seat in that farm of this spec, which escrows or freezes it (a watched one could be sold). A set bound into a badge takes its pieces this way and moves that farm's `lockAttribute` far ahead, so they stay staked while the badge exists; a recipe that raises anything on a staked piece must raise its farm's `lockAttribute` (to raise a stat and leave the lock alone, use `use`). show: one NFT of `collection` the player holds, kept (any Core NFT, or a Token Metadata NFT verified in it; the game's own collection when left out), read with what the game wrote in its Sheet. pay: `amount` of `currency`, sent `to` a destination. trade: one NFT of `collection` the player holds, any kind, traded in: burned, given on, or put in a stash (`then`).",
+      "description": "burn: `count` collectibles of `item`, burned. use: one collectible of `item`, kept (counts a use of its life). renew: one kept, its uses counted from zero again (its `used` count). staked: one collectible of `item`, kept as `use` keeps it, that must be staked in `farm`: on its own seat in that farm of this spec, which escrows or freezes it (a watched one could be sold). A set bound into a badge takes its pieces this way and moves that farm's `lockAttribute` far ahead, so they stay staked while the badge exists; a recipe that raises anything on a staked piece must raise its farm's `lockAttribute` (to raise a stat and leave the lock alone, use `use`). show: one NFT of `collection` the player holds, kept (any Core NFT, or a Token Metadata NFT verified in it; the game's own collection when left out), read with what the game wrote in its Sheet. pay: `amount` of `currency`, sent `to` a destination. trade: one NFT of `collection` the player holds, any kind, traded in: burned, given on, or put in a stash (`then`).",
       "properties": {
         "takes": {
           "enum": [
@@ -1106,7 +1153,7 @@
         "count": {
           "type": "integer",
           "minimum": 1,
-          "maximum": 8
+          "maximum": 255
         },
         "amount": {
           "$ref": "#/$defs/amount"
@@ -1133,13 +1180,12 @@
         "gives"
       ],
       "additionalProperties": false,
-      "description": "A prize (see `prize`), or a roll on a collectible the recipe keeps: { \"gives\": \"roll\", \"box\": key, \"on\": place } (a risky upgrade; anyone asks the oracle and settles it). A craft refuses a prize it can't give (a pool that holds less, an item sold out or switched off, an NFT gone).",
+      "description": "A prize (see `prize`), or a roll on a collectible the recipe keeps: { \"gives\": \"roll\", \"box\": key, \"on\": place } (a risky upgrade; the player or the project’s keys ask the oracle and settle it). A craft refuses a prize it can't give (a pool that holds less, an item sold out or switched off, an NFT gone).",
       "properties": {
         "gives": {
           "enum": [
             "item",
             "tokens",
-            "share",
             "nft",
             "roll"
           ]
@@ -1162,12 +1208,6 @@
           "type": "string",
           "pattern": "^(mint|pool:[a-z][a-z0-9-]{0,31})$"
         },
-        "pool": {
-          "$ref": "#/$defs/key"
-        },
-        "percent": {
-          "$ref": "#/$defs/percent"
-        },
         "box": {
           "$ref": "#/$defs/key",
           "description": "For `roll`: the box rolled, free, for the player."
@@ -1175,7 +1215,7 @@
         "on": {
           "type": "integer",
           "minimum": 0,
-          "maximum": 7,
+          "maximum": 254,
           "description": "For `roll`: the collectible handed in and kept (its place, the first is 0) the box rolls on (a risky upgrade); left out, it rolls on nothing (a merge whose result is left to chance). One a recipe."
         },
         "stash": {
@@ -1215,21 +1255,18 @@
         },
         "in": {
           "type": "array",
-          "maxItems": 8,
           "items": {
             "$ref": "#/$defs/input"
           }
         },
         "out": {
           "type": "array",
-          "maxItems": 8,
           "items": {
             "$ref": "#/$defs/output"
           }
         },
         "needs": {
           "type": "array",
-          "maxItems": 8,
           "items": {
             "type": "object",
             "required": [
@@ -1243,12 +1280,11 @@
               "place": {
                 "type": "integer",
                 "minimum": 0,
-                "maximum": 7
+                "maximum": 254
               },
               "key": {
                 "type": "string",
-                "minLength": 1,
-                "maxLength": 32
+                "minLength": 1
               },
               "atLeast": {
                 "type": "integer",
@@ -1260,7 +1296,6 @@
         },
         "keeps": {
           "type": "array",
-          "maxItems": 8,
           "items": {
             "type": "object",
             "required": [
@@ -1273,25 +1308,23 @@
             "properties": {
               "key": {
                 "type": "string",
-                "minLength": 1,
-                "maxLength": 32
+                "minLength": 1
               },
               "from": {
                 "type": "integer",
                 "minimum": 0,
-                "maximum": 7
+                "maximum": 254
               },
               "to": {
                 "type": "integer",
                 "minimum": 0,
-                "maximum": 7
+                "maximum": 254
               }
             }
           }
         },
         "raises": {
           "type": "array",
-          "maxItems": 8,
           "description": "Numbers the recipe moves on collectibles handed in and kept (use, renew, show): a level or a stat bought with the recipe's own payment, or one it costs (a negative `by`: a merge that costs a level, never below 0). Written on the NFT when the game has authority over it, in its Sheet otherwise. One already at `upTo` is refused (MaxedOut) when raising. With `fromNow`, it moves a time: fuel for a day more (\"by\": \"1d\", \"upTo\": \"3d\"), a day off a lock (\"by\": \"-1d\").",
           "items": {
             "type": "object",
@@ -1305,13 +1338,12 @@
               "place": {
                 "type": "integer",
                 "minimum": 0,
-                "maximum": 7,
+                "maximum": 254,
                 "description": "Which collectible handed in (the first is 0); one that is kept."
               },
               "key": {
                 "type": "string",
-                "minLength": 1,
-                "maxLength": 32
+                "minLength": 1
               },
               "by": {
                 "anyOf": [
@@ -1341,7 +1373,7 @@
                     "$ref": "#/$defs/duration"
                   }
                 ],
-                "description": "The most it reaches; needed when raising. With `fromNow`, how far past now: \"3d\". On a farm's `lockAttribute` or `upkeepAttribute` moved without `fromNow` (by a duration, from the time as written: a bound set's \"20000d\"), left out: no cap."
+                "description": "The most it reaches; left out, no cap. With `fromNow`, how far past now: \"3d\"."
               },
               "fromNow": {
                 "type": "boolean",
@@ -1418,7 +1450,7 @@
               "$ref": "#/$defs/destination"
             }
           ],
-          "description": "move: the pool it fills. pay: \"wallet:<address>\", \"account:<token account address>\" or \"holder:<asset address>\", or \"lottery:<key>\" (that lottery's pot: a sponsored or no-loss prize stream)."
+          "description": "move: the pool it fills. issue: \"farm:<key>\" to mint into that farm's rewards vault instead of a `pool` (an emission its stakers share). pay: \"wallet:<address>\", \"account:<token account address>\" or \"holder:<asset address>\", \"lottery:<key>\" (that lottery's pot: a sponsored or no-loss prize stream) or \"farm:<key>\" (that farm's rewards vault). A sealed one pays only \"wallet:<address>\", \"treasury\" or \"burn\"."
         },
         "amount": {
           "$ref": "#/$defs/amount"
@@ -1452,7 +1484,7 @@
         },
         "sealed": {
           "type": "boolean",
-          "description": "A sealed schedule (does \"pay\", in `currency`): it pays from a vault of its own that nothing else can touch, and once written nobody, the owner included, can change it, switch it off or take its tokens back. It needs `maxRuns`; its last run pays whatever is left. Vesting, an unlock, a sponsored prize stream with a real guarantee."
+          "description": "A sealed schedule (does \"pay\", in `currency`): it pays from a vault of its own that nothing else can touch, and once written nobody, the owner included, can change it, switch it off or take its tokens back. It needs `maxRuns`; its last run pays whatever is left. It pays a wallet, the treasury or a burn (a stream into a pool, a pot or a farm is only as safe as where it lands: leave it unsealed). Vesting, an unlock."
         },
         "fund": {
           "$ref": "#/$defs/amount",
@@ -1501,7 +1533,6 @@
         "places": {
           "type": "array",
           "minItems": 1,
-          "maxItems": 8,
           "items": {
             "anyOf": [
               {
@@ -1521,12 +1552,18 @@
                   "prize": {
                     "$ref": "#/$defs/prize",
                     "description": "What its winner gets besides its share of the pot: a raffled NFT, a collectible, tokens, a roll of a box."
+                  },
+                  "times": {
+                    "type": "integer",
+                    "minimum": 1,
+                    "maximum": 40960,
+                    "description": "How many places in a row are alike (a run): \"places 2 to 201 each take 1%\" is one { \"percent\": 1, \"times\": 200 }. Not for a named NFT or a roll, which one place gives. Default 1."
                   }
                 }
               }
             ]
           },
-          "description": "What each place wins, first place first: a percent of the pot, or { \"percent\", \"prize\" }: a share of the pot and a prize for its winner (either, or both). Default: one winner takes all."
+          "description": "What each place wins, first place first: a percent of the pot, or { \"percent\", \"prize\", \"times\" }: a share of the pot and a prize for its winner (either, or both), for `times` places in a row. Default: one winner takes all."
         },
         "every": {
           "$ref": "#/$defs/duration",
@@ -1546,6 +1583,27 @@
           "$ref": "#/$defs/amount",
           "description": "What the owner puts in the pot at go-live."
         },
+        "roundRent": {
+          "$ref": "#/$defs/amount",
+          "description": "SOL the owner puts in the lottery at go-live to pay each round's record, its token accounts and every purchase's entry (lent to the round, back to the lottery when it closes): buyers then pay no program rent for a ticket. On by default, sized from `expect` (its rounds open or paying out at once, and a round's purchases); give an amount to set it, 0 to turn it off. When it runs short, a round's first buyer fronts its record, back to them at the close, and each buyer pays their own entry's bytes."
+        },
+        "expect": {
+          "type": "object",
+          "additionalProperties": false,
+          "description": "What the default `roundRent` is sized for: `rounds`, the rounds open or still paying out at once (default 2 for a lottery that draws again, 1 for one that draws once), and `entries`, the purchases a round takes (default: the scenario's purchases a day over a round, else 100).",
+          "properties": {
+            "rounds": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 100
+            },
+            "entries": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 262000
+            }
+          }
+        },
         "split": {
           "$ref": "#/$defs/split",
           "description": "Where ticket money goes before the pot (the rest goes into the pot): a charity, a referrer the buyer names (\"chosen\"), the treasury."
@@ -1593,6 +1651,33 @@
             }
           ],
           "description": "A raffle: this NFT (one the owner holds, put in the lottery's own stash at go-live) is first place's prize, held so that nothing but the draw can give it, and the lottery draws once. The same as a first place { \"prize\": { \"gives\": \"nft\", \"nft\": <address>, \"held\": true } }. An NFT of another collection is { \"nft\", \"collection\" }."
+        },
+        "nfts": {
+          "type": "array",
+          "maxItems": 500,
+          "items": {
+            "anyOf": [
+              {
+                "$ref": "#/$defs/address"
+              },
+              {
+                "type": "object",
+                "additionalProperties": false,
+                "required": [
+                  "nft"
+                ],
+                "properties": {
+                  "nft": {
+                    "$ref": "#/$defs/address"
+                  },
+                  "collection": {
+                    "$ref": "#/$defs/address"
+                  }
+                }
+              }
+            ]
+          },
+          "description": "NFTs the lottery's own stash holds for its places that give { \"gives\": \"raffled\" } (each draws one at random with the round's answer): a raffle of many NFTs. Your wallet puts them in at go-live, a group a transaction, before the lottery is written; at least as many as such places. The lottery draws once."
         }
       },
       "description": "Tickets into a pot of the lottery's own, one random draw, the winners paid. Nothing but its winners' payouts takes from the pot: not the authority, a schedule, a farm or a recipe. Anything sold or paid can send it a share (\"lottery:<key>\" in a split); a schedule can't pay a lottery."
@@ -1620,11 +1705,11 @@
         "sides": {
           "type": "integer",
           "minimum": 1,
-          "maximum": 255
+          "maximum": 1024
         },
         "sideNames": {
           "type": "array",
-          "maxItems": 255,
+          "maxItems": 1024,
           "items": {
             "type": "string",
             "maxLength": 40
@@ -1654,7 +1739,6 @@
         },
         "deciders": {
           "type": "array",
-          "maxItems": 3,
           "items": {
             "$ref": "#/$defs/address"
           },
@@ -1675,6 +1759,11 @@
         "stakeNft": {
           "$ref": "#/$defs/rule",
           "description": "Each entry stakes one NFT that passes this rule, in place of tokens, and the NFTs are the pot: each winning entry takes its own back and one of the losers', in the order they are claimed; what the winners leave goes to whoever opened it. Called off, each takes its own back. No split and no stake."
+        },
+        "losersEach": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "In a contest of NFTs (`stakeNft`), the most losers' NFTs one winner takes; what the winners leave goes to whoever opened it. Default: no cap, the winners share every loser's NFT (the first to enter on the winning side take one more when they don't divide evenly), each picking which."
         }
       }
     },
@@ -1990,6 +2079,13 @@
           "$ref": "#/$defs/address",
           "description": "The project's tree of compressed NFTs, once the setup opened it."
         },
+        "tables": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/address"
+          },
+          "description": "The project's standing lookup tables, made at go-live (the owner their authority): a transaction too big for a legacy one goes as v0 with them, in one approval."
+        },
         "treasury": {
           "$ref": "#/$defs/address"
         },
@@ -2130,12 +2226,11 @@
         },
         "collection": {
           "$ref": "#/$defs/address",
-          "description": "Any NFT of this collection: a Metaplex Core collection, or the mint of a Token Metadata collection its NFTs are verified in. Leave it and `item` out for the game's own collection."
+          "description": "Any NFT of this collection: a Metaplex Core collection, or the mint of a Token Metadata collection its NFTs are verified in (a print of a master, which its holder makes without the collection's authority, counts as in no collection). Leave it and `item` out for the game's own collection."
         },
         "attribute": {
           "type": "string",
-          "minLength": 1,
-          "maxLength": 32
+          "minLength": 1
         },
         "atLeast": {
           "type": "integer",
@@ -2143,8 +2238,7 @@
           "maximum": 4294967295
         },
         "equals": {
-          "type": "string",
-          "maxLength": 32
+          "type": "string"
         },
         "time": {
           "enum": [
@@ -2192,7 +2286,7 @@
         "outcome": {
           "type": "integer",
           "minimum": 0,
-          "maximum": 7,
+          "maximum": 65535,
           "description": "Which outcome (0 is the first)."
         },
         "when": {
@@ -2227,11 +2321,15 @@
         },
         "roll": {
           "$ref": "#/$defs/key",
-          "description": "A mission's result: a box with `rollsOn` the collectible leaving after this tier's lock is rolled on (success, failure, a stat lost, the NFT lost; its odds read the NFT's stats). Growth stops at the lock's end. Anyone asks for the roll and settles it; it is never refunded while it waits. A chest it brings back is its `prize` instead. Only in a farm of collectibles, with a lock."
+          "description": "A mission's result: a box with `rollsOn` the collectible leaving after this tier's lock is rolled on (success, failure, a stat lost, the NFT lost; its odds read the NFT's stats). Growth stops at the lock's end. Its player or the project’s keys ask for the roll and settle it; it is never refunded while it waits. A chest it brings back is its `prize` instead. Only in a farm of collectibles, with a lock."
         },
         "exitFee": {
           "$ref": "#/$defs/percent",
           "description": "A farm of tokens: a stake may leave before this tier's lock has run by leaving this percent of what it takes out (to the farm's `exitFeeTo`). Absent: no early exit. A farm of collectibles leaves early by a recipe that lowers its `lockAttribute`."
+        },
+        "earnsFor": {
+          "$ref": "#/$defs/duration",
+          "description": "A term: a seat at this tier earns and grows only this long after its lock started (a stake, or a booster put on, starts it again), however late it is touched; its prize is still given once its lock has run. Absent: no end."
         }
       }
     },
@@ -2243,7 +2341,7 @@
         "name",
         "stakes"
       ],
-      "description": "Players stake a token or collectibles. Rewards are whatever arrives in the rewards pool, shared by weight (what they stake, times their lock tier, plus boosts from what a collectible says), or a fixed `rate` for each seat. A farm can also write points and levels on what is staked (`growth`), and pay a mission's `prize` to a collectible that stays its tier's lock. It cannot be edited once open. A farm of collectibles can keep two times on the NFT itself: its lock (`lockAttribute`) and an upkeep (`upkeepAttribute`), which recipes and rolls move like any number.",
+      "description": "Players stake a token or collectibles. Rewards are whatever lands in the farm's own rewards vault (\"farm:<key>\" in a split or a schedule, its `seed`), shared by weight (what they stake, times their lock tier, plus boosts from what a collectible says), or a fixed `rate`. A farm can also write points and levels on what is staked (`growth`), and pay a mission's `prize` to a collectible that stays its tier's lock. It cannot be edited once open. A farm of collectibles can keep two times on the NFT itself: its lock (`lockAttribute`) and an upkeep (`upkeepAttribute`), which recipes and rolls move like any number.",
       "properties": {
         "key": {
           "$ref": "#/$defs/key"
@@ -2274,13 +2372,11 @@
         },
         "rewards": {
           "$ref": "#/$defs/key",
-          "description": "The pool rewards come from, and whose token they are in. Without a `rate`, the farm takes all of it, so it must be this farm's alone; with a `rate` that isn't minted, it pays from it while it lasts. Leave it out for a farm that pays nothing (staking only to qualify, for a stake gate): the setup opens an empty pool for it."
+          "description": "The token its rewards are in (a token key). They land in the farm's own rewards vault: send it a share (\"farm:<key>\" in a split), pay it with a schedule (\"to\": \"farm:<key>\"), or `seed` it; with a minted `rate` nothing waits there. Left out: the staked token, or for a farm of collectibles the project's currency."
         },
-        "rewardsIndex": {
-          "type": "integer",
-          "minimum": 0,
-          "maximum": 255,
-          "description": "For a farm that names no `rewards`: the program's number for the empty pool made for it. Written when it goes live; never change it after."
+        "seed": {
+          "$ref": "#/$defs/amount",
+          "description": "What the owner puts into its rewards vault at go-live, from their wallet (anyone may add more later, with a plain transfer)."
         },
         "rate": {
           "type": "object",
@@ -2288,16 +2384,25 @@
           "required": [
             "perDay"
           ],
-          "description": "A fixed rate instead of sharing what arrives: the same for each seat whoever else is in, times its tier and boosts (most Solana NFT staking paid this way).",
+          "description": "A fixed rate instead of sharing what lands: for each seat whoever else is in, times its tier and boosts (most Solana NFT staking paid this way), or with `shared` the whole farm's a day, shared by weight.",
           "properties": {
             "perDay": {
               "$ref": "#/$defs/amount",
-              "description": "Reward tokens a day for each collectible at x1; for a farm of tokens, for each whole token staked. 0 pays nothing: a farm that only grows what is staked, or gives mission prizes (its \"rewards\" pool is then never touched)."
+              "description": "Reward tokens a day for each collectible at x1; for a farm of tokens, for each whole token staked; with `shared`, for the whole farm. 0 pays nothing: a farm that only grows what is staked, or gives mission prizes."
             },
             "minted": {
               "type": "boolean",
               "default": false,
-              "description": "Minted (the rewards' token must be one the game mints), or paid from the rewards pool while it lasts (what it can't cover is not owed later)."
+              "description": "Minted when a seat is paid (the rewards' token must be one the game mints), or paid from what its rewards vault holds free while it lasts (what it can't cover is not owed later)."
+            },
+            "shared": {
+              "type": "boolean",
+              "default": false,
+              "description": "`perDay` is the whole farm's a day, shared by weight while anything is staked: an emission budget, each seat's share falling as more stake."
+            },
+            "halveEvery": {
+              "$ref": "#/$defs/duration",
+              "description": "The rate halves every this long from when the farm opens, again and again (a halving emission)."
             }
           }
         },
@@ -2313,7 +2418,7 @@
         "tiers": {
           "type": "array",
           "minItems": 1,
-          "maxItems": 4,
+          "maxItems": 256,
           "items": {
             "$ref": "#/$defs/tier"
           },
@@ -2321,7 +2426,6 @@
         },
         "boosts": {
           "type": "array",
-          "maxItems": 4,
           "items": {
             "type": "object",
             "additionalProperties": false,
@@ -2351,7 +2455,6 @@
             {
               "type": "array",
               "minItems": 1,
-              "maxItems": 4,
               "items": {
                 "$ref": "#/$defs/rule"
               }
@@ -2367,7 +2470,6 @@
             {
               "type": "array",
               "minItems": 1,
-              "maxItems": 4,
               "items": {
                 "$ref": "#/$defs/growth"
               }
@@ -2382,41 +2484,17 @@
         "lockAttribute": {
           "type": "string",
           "minLength": 1,
-          "maxLength": 32,
-          "description": "For a farm of collectibles: the attribute the farm writes each staked collectible's lock under, as the time it ends (Unix seconds), and reads when it leaves. Whatever moves a number moves it: a recipe `raises` it by \"-1d\" with `fromNow` for a price (a way out early; the price can be burned, or paid into this farm's rewards pool, shared by the seats there at the next move), a roll's `shifts` add a day (jail). A mission's prize still needs the tier's own lock to have run, and a tier that rolls rolls whenever the collectible leaves. A recipe reaches a collectible staked in escrow (the default) on its seat."
+          "description": "For a farm of collectibles: the attribute the farm writes each staked collectible's lock under, as the time it ends (Unix seconds), and reads when it leaves. Whatever moves a number moves it: a recipe `raises` it by \"-1d\" with `fromNow` for a price (a way out early; the price can be burned, or paid into this farm's rewards vault (\"farm:<key>\"), shared by the seats there), a roll's `shifts` add a day (jail). A mission's prize still needs the tier's own lock to have run, and a tier that rolls rolls whenever the collectible leaves. A recipe reaches a collectible staked in escrow (the default) on its seat."
         },
         "upkeepAttribute": {
           "type": "string",
           "minLength": 1,
-          "maxLength": 32,
-          "description": "For a farm of collectibles: an upkeep. The attribute that says until when (Unix seconds) a staked collectible earns and grows: fuel, food, a license. A recipe sells it (`raises` with `fromNow`: \"+1d\" for 10 FUEL, up to \"3d\" ahead), and it runs out by itself. Run dry, the seat earns and grows nothing more, and what it was credited after it ran out goes back to the farm (split by time), shared by the seats there. Fuel bought counts once the seat is refreshed (anyone sends `refresh`; the play page sends it with the recipe). A mission's prize needs the upkeep to last its tier's lock."
+          "description": "For a farm of collectibles: an upkeep. The attribute that says until when (Unix seconds) a staked collectible earns and grows: fuel, food, a license. A recipe sells it (`raises` with `fromNow`: \"+1d\" for 10 FUEL, up to \"3d\" ahead), and it runs out by itself. Run dry, the seat earns and grows nothing more from that time, however late it is next touched. Fuel bought counts once the seat is refreshed (anyone sends `refresh`; the play page sends it with the recipe). A mission's prize needs the upkeep to last its tier's lock."
         },
         "exitFeeTo": {
           "type": "string",
-          "pattern": "^(burn|pool:[a-z][a-z0-9-]{0,31})$",
-          "description": "Where early-exit fees go: \"burn\", or \"pool:<key>\" (the farm's own rewards pool shares them with the stakers who stay). Needed when a tier has `exitFee`."
-        },
-        "unbond": {
-          "$ref": "#/$defs/duration",
-          "description": "A farm of tokens: what a player takes out waits this long first, earning nothing (an unbonding wait), then any later unstake takes it out."
-        },
-        "toll": {
-          "type": "object",
-          "additionalProperties": false,
-          "required": [
-            "percent",
-            "to"
-          ],
-          "description": "A share of every payout of rewards (harvest, compound, unstake), burned or sent to a pool. Not on mission prizes.",
-          "properties": {
-            "percent": {
-              "$ref": "#/$defs/percent"
-            },
-            "to": {
-              "type": "string",
-              "pattern": "^(burn|pool:[a-z][a-z0-9-]{0,31})$"
-            }
-          }
+          "pattern": "^(burn|rewards|pool:[a-z][a-z0-9-]{0,31})$",
+          "description": "Where early-exit fees go: \"burn\", \"rewards\" (the farm's own rewards vault, shared by the stakers who stay: a farm whose rewards are its staked token), or \"pool:<key>\". Needed when a tier has `exitFee`."
         }
       }
     },
@@ -2568,6 +2646,16 @@
         "prize": {
           "$ref": "#/$defs/prize",
           "description": "What each claim gives (a prize). The grant's funds pay what it opens."
+        },
+        "wallets": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "About how many wallets will claim it over its life (with `rounds`, how many rounds each): it sizes how its records are kept (one list up to ~100,000, more lists above). Default: its list's length."
+        },
+        "rounds": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "About how many rounds each wallet will be paid over its life. Default 1."
         }
       }
     },
@@ -2587,7 +2675,6 @@
             "wallets": {
               "type": "array",
               "minItems": 0,
-              "maxItems": 16,
               "items": {
                 "$ref": "#/$defs/address"
               }
@@ -2672,7 +2759,6 @@
         "attribute": {
           "type": "string",
           "minLength": 1,
-          "maxLength": 32,
           "default": "xp",
           "description": "The attribute the points are written under."
         },
@@ -2685,13 +2771,11 @@
         "level": {
           "type": "string",
           "minLength": 1,
-          "maxLength": 32,
           "default": "level",
           "description": "The attribute the level is written under, when there are `levels`."
         },
         "levels": {
           "type": "array",
-          "maxItems": 16,
           "items": {
             "type": "integer",
             "minimum": 1,
@@ -2735,7 +2819,6 @@
         },
         "nfts": {
           "type": "array",
-          "maxItems": 256,
           "items": {
             "anyOf": [
               {
@@ -2754,6 +2837,12 @@
                   "collection": {
                     "$ref": "#/$defs/address",
                     "description": "Its Core collection, when it is not the stash's."
+                  },
+                  "weight": {
+                    "type": "integer",
+                    "minimum": 1,
+                    "maximum": 4294967295,
+                    "description": "Its weight in the stash's draws (1 when left out): an NFT that weighs 10 is drawn ten times as often as one that weighs 1."
                   }
                 }
               },
@@ -2775,6 +2864,12 @@
                   "ruleSet": {
                     "$ref": "#/$defs/address",
                     "description": "A pNFT's rule set, when it has one."
+                  },
+                  "weight": {
+                    "type": "integer",
+                    "minimum": 1,
+                    "maximum": 4294967295,
+                    "description": "Its weight in the stash's draws (1 when left out): an NFT that weighs 10 is drawn ten times as often as one that weighs 1."
                   }
                 }
               },
@@ -2788,6 +2883,12 @@
                   "compressed": {
                     "$ref": "#/$defs/address",
                     "description": "A compressed NFT's asset id."
+                  },
+                  "weight": {
+                    "type": "integer",
+                    "minimum": 1,
+                    "maximum": 4294967295,
+                    "description": "Its weight in the stash's draws (1 when left out): an NFT that weighs 10 is drawn ten times as often as one that weighs 1."
                   }
                 }
               }
@@ -2807,15 +2908,15 @@
         "gives"
       ],
       "additionalProperties": false,
-      "description": "A prize, given the same way on every route that gives one (a grant, a lottery's place, a contest's winners, a mission's tier, a recipe's line), in the transaction that wins it; only a roll is settled after, by the oracle. item: one of `item` (a collectible minted to the winner, or with `compressed` a compressed NFT of it; a normal item is the game's backend's to deliver). tokens: `amount`, minted (`from`: \"mint\", in `currency`, a token the game mints) or paid from a pool (\"pool:<key>\", in what it holds). share: `percent` of what `pool` holds then (a jackpot). nft: the NFT `nft`, which the stash `stash` lists (given once: the first winner takes it). roll: a roll of `box` for the winner: chance (a box can give a stash's NFT at random).",
+      "description": "A prize, given the same way on every route that gives one (a grant, a lottery's place, a contest's winners, a mission's tier, a recipe's line), in the transaction that wins it; only a roll is settled after, by the oracle. item: one of `item` (a collectible minted to the winner, or with `compressed` a compressed NFT of it; a normal item is the game's backend's to deliver). tokens: `amount`, minted (`from`: \"mint\", in `currency`, a token the game mints) or paid from a pool (\"pool:<key>\", in what it holds). share: `percent` of what `pool` holds then (a jackpot). nft: the NFT `nft`, which the stash `stash` lists (given once: the first winner takes it). roll: a roll of `box` for the winner: chance (a box can give a stash's NFT at random). raffled (a lottery's place only, of a lottery that draws once): one NFT drawn at random from the lottery's own stash (its `nfts`).",
       "properties": {
         "gives": {
           "enum": [
             "item",
             "tokens",
-            "share",
             "nft",
-            "roll"
+            "roll",
+            "raffled"
           ]
         },
         "item": {
@@ -2836,12 +2937,6 @@
           "type": "string",
           "pattern": "^(mint|pool:[a-z][a-z0-9-]{0,31})$"
         },
-        "pool": {
-          "$ref": "#/$defs/key"
-        },
-        "percent": {
-          "$ref": "#/$defs/percent"
-        },
         "stash": {
           "$ref": "#/$defs/key",
           "description": "For nft: the stash that lists it."
@@ -2918,6 +3013,59 @@
           "$ref": "#/$defs/spend"
         }
       }
+    },
+    "table": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "key",
+        "rows"
+      ],
+      "description": "A table (`table.rs`): rows, each a weight and an optional stock, and a label (`\"labels\"`, up to 32 bytes each) or nothing (`\"numbers\"`: a row gives its own number, from 0). Sealed once written: its weights never change and its stock only goes down. A row with a stock leaves the draws once it is used up.",
+      "properties": {
+        "key": {
+          "$ref": "#/$defs/key"
+        },
+        "id": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 4294967295
+        },
+        "kind": {
+          "enum": [
+            "labels",
+            "numbers"
+          ],
+          "default": "labels"
+        },
+        "rows": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "weight"
+            ],
+            "properties": {
+              "label": {
+                "type": "string"
+              },
+              "weight": {
+                "type": "integer",
+                "minimum": 1,
+                "maximum": 4294967295
+              },
+              "stock": {
+                "type": "integer",
+                "minimum": 1,
+                "maximum": 4294967294,
+                "description": "How many units may draw it: left out, never runs out."
+              }
+            }
+          }
+        }
+      }
     }
   }
 }