@wowok/agent-mcp 2.7.1 → 2.7.3

package/dist/knowledge/treasury-translation.js

@@ -1,498 +1 @@
-import { isBuiltinTreasuryPermission, getBuiltinPermissionByIndex, findSceneByPermissionIndex, } from "./treasury-ledger.js";
-export const SEMANTIC_TO_SCHEMA_RULES = [
-    {
-        id: "T-T-01",
-        pattern_name: "Create new Treasury",
-        semantic_intent: "Create a new Treasury with a Coin type T and associated Permission",
-        match_keywords: ["create", "new"],
-        schema_fields: ["object (TypeNamedObjectWithPermission)", "description"],
-        example_json: {
-            object: {
-                name: "myteam_treasury",
-                type_parameter: "0x2::wow::WOW",
-                permission: {
-                    name: "myteam_treasury_permission",
-                    description: "Permission for myteam treasury",
-                },
-            },
-            description: "Team treasury for project X funding",
-        },
-        reverse_explanation: "object must be in OBJECT format (not STRING) for creation; type_parameter is the Coin type T; permission can be new or existing",
-    },
-    {
-        id: "T-T-02",
-        pattern_name: "Internal deposit (Permission path)",
-        semantic_intent: "Deposit funds to Treasury via Permission authorization",
-        match_keywords: ["deposit"],
-        schema_fields: ["object (string)", "deposit.coin", "deposit.payment_info"],
-        example_json: {
-            object: "myteam_treasury",
-            deposit: {
-                coin: { balance: "1000000000" },
-                payment_info: { remark: "Q3 budget allocation", index: 0 },
-            },
-        },
-        reverse_explanation: "deposit.by_external_deposit_guard omitted → Permission path (TREASURY_DEPOSIT=252); coin can be {balance} or {coin_object}",
-    },
-    {
-        id: "T-T-03",
-        pattern_name: "Internal withdraw (Permission path, fixed amount)",
-        semantic_intent: "Withdraw fixed amount from Treasury via Permission authorization",
-        match_keywords: ["withdraw"],
-        schema_fields: ["object (string)", "withdraw.amount.fixed", "withdraw.recipient", "withdraw.payment_info"],
-        example_json: {
-            object: "myteam_treasury",
-            withdraw: {
-                amount: { fixed: "500000000" },
-                recipient: "0xRECIPIENT",
-                payment_info: { remark: "Vendor payment", index: 1 },
-            },
-        },
-        reverse_explanation: "withdraw.amount.fixed → Permission path (TREASURY_WITHDRAW=254); amount is fixed u64; irreversible",
-    },
-    {
-        id: "T-T-04",
-        pattern_name: "External deposit (Guard + Passport path)",
-        semantic_intent: "External user deposits via preset Guard verification (no Permission needed)",
-        match_keywords: ["external deposit", "guard deposit"],
-        schema_fields: ["object (string)", "deposit.coin", "deposit.by_external_deposit_guard", "deposit.payment_info", "submission (Passport)"],
-        example_json: {
-            object: "myteam_treasury",
-            deposit: {
-                coin: { balance: "200000000" },
-                by_external_deposit_guard: "deposit_guard_v1",
-                payment_info: { remark: "External deposit via guard", index: 2 },
-            },
-        },
-        reverse_explanation: "deposit.by_external_deposit_guard present → Guard path (NO Permission check); Passport required via submission field; amount may split if coin > guard-specified",
-    },
-    {
-        id: "T-T-05",
-        pattern_name: "External withdraw (Guard + Passport path, amount from Guard)",
-        semantic_intent: "External user withdraws via preset Guard verification; amount determined by Guard table identifier",
-        match_keywords: ["external withdraw", "guard withdraw"],
-        schema_fields: ["object (string)", "withdraw.amount.by_external_withdraw_guard", "withdraw.recipient", "withdraw.payment_info", "submission (Passport)"],
-        example_json: {
-            object: "myteam_treasury",
-            withdraw: {
-                amount: { by_external_withdraw_guard: "withdraw_guard_v1" },
-                recipient: "0xRECIPIENT",
-                payment_info: { remark: "External withdraw via guard", index: 3 },
-            },
-        },
-        reverse_explanation: "withdraw.amount.by_external_withdraw_guard → Guard path (NO Permission check); amount comes from Guard table identifier (u8, required); irreversible",
-    },
-    {
-        id: "T-T-06",
-        pattern_name: "Manage external deposit/withdraw Guard (add/set/remove/clear)",
-        semantic_intent: "Add, set, remove, or clear external_deposit_guard / external_withdraw_guard lists",
-        match_keywords: ["guard add", "guard set", "guard remove", "guard clear"],
-        schema_fields: ["object (string)", "external_deposit_guard | external_withdraw_guard"],
-        example_json: {
-            object: "myteam_treasury",
-            external_deposit_guard: {
-                op: "add",
-                guards: [
-                    { guard: "deposit_guard_v1", identifier: 2, store_from_id: null },
-                ],
-            },
-        },
-        reverse_explanation: "op='add' (upsert) / 'set' (clear+add) / 'remove' (by guard address) / 'clear' (empty list); Permission index 255 (deposit) / 256 (withdraw) required",
-    },
-    {
-        id: "T-T-07",
-        pattern_name: "Receive CoinWrapper / owner_receive forward",
-        semantic_intent: "Receive CoinWrapper into balance, or forward received objects to Permission owner",
-        match_keywords: ["receive", "owner_receive", "forward"],
-        schema_fields: ["object (string)", "receive | owner_receive"],
-        example_json: {
-            object: "myteam_treasury",
-            receive: "recently",
-        },
-        reverse_explanation: "receive → TREASURY_RECEIVE=253, converts CoinWrapper to balance, writes Record; owner_receive → TREASURY_OWNER_RECEIVE=257, forwards to Permission.owner, no Record",
-    },
-    {
-        id: "T-T-08",
-        pattern_name: "Set UM / modify description",
-        semantic_intent: "Delegate User Manager (Contact object) or modify Treasury description",
-        match_keywords: ["um", "um_set", "um_none", "description", "delegate"],
-        schema_fields: ["object (string)", "um | description"],
-        example_json: {
-            object: "myteam_treasury",
-            um: "team_contact",
-        },
-        reverse_explanation: "um=address → TREASURY_UM=258 (um_set); um=null → TREASURY_UM=258 (um_none); description=string → TREASURY_DESCRIPTION=251",
-    },
-];
-export const SCHEMA_TO_SEMANTIC_RULES = [
-    {
-        element_type: "field",
-        type_name: "object",
-        semantic_explanation: "Treasury object reference. STRING=operate existing; OBJECT={name, type_parameter, permission}=create new",
-        constraints: ["type_parameter required at creation, immutable thereafter", "permission can be new (TypeNamedObject) or existing (string address)"],
-    },
-    {
-        element_type: "field",
-        type_name: "description",
-        semantic_explanation: "Human-readable description of Treasury purpose. Max 4000 chars (MAX_DESCRIPTION_LENGTH).",
-        constraints: ["<= 4000 chars", "Modifiable via TREASURY_DESCRIPTION (251)"],
-    },
-    {
-        element_type: "field",
-        type_name: "deposit",
-        semantic_explanation: "Deposit operation. Two access paths: (1) Permission path (by_external_deposit_guard omitted, requires TREASURY_DEPOSIT=252); (2) Guard path (by_external_deposit_guard set, requires Passport, no Permission)",
-    },
-    {
-        element_type: "field",
-        type_name: "deposit.coin",
-        semantic_explanation: "Coin to deposit. {balance: string} for amount; {coin_object: string} for existing Coin object. Type T must match Treasury's type_parameter.",
-    },
-    {
-        element_type: "field",
-        type_name: "deposit.by_external_deposit_guard",
-        semantic_explanation: "Guard address or name for external deposit path. Triggers Guard + Passport verification; bypasses Permission check.",
-        constraints: ["Guard must be in external_deposit_guard list (else E_EXTERNAL_DEPOSIT_GUARD_NOT_FOUND)", "Passport required"],
-    },
-    {
-        element_type: "field",
-        type_name: "withdraw",
-        semantic_explanation: "Withdraw operation. Two access paths: (1) Permission path (amount.fixed, requires TREASURY_WITHDRAW=254); (2) Guard path (amount.by_external_withdraw_guard, requires Passport, no Permission)",
-    },
-    {
-        element_type: "field",
-        type_name: "withdraw.amount.fixed",
-        semantic_explanation: "Fixed u64 withdraw amount (Permission path). Irreversible. Recipient specified separately.",
-        constraints: ["Must be <= balance (else E_WITHDRAW_INSUFFICIENT_AMOUNT)", "u64 format"],
-    },
-    {
-        element_type: "field",
-        type_name: "withdraw.amount.by_external_withdraw_guard",
-        semantic_explanation: "Guard address/name for external withdraw path. Amount determined by Guard table identifier (not caller-specified).",
-        constraints: ["Guard must be in external_withdraw_guard list", "Passport required", "Amount from Guard is authoritative"],
-    },
-    {
-        element_type: "field",
-        type_name: "external_deposit_guard",
-        semantic_explanation: "Manage external_deposit_guard list. op: add (upsert) / set (clear+add) / remove (by address) / clear (empty). Requires TREASURY_EXTERNAL_DEPOSIT_GUARD=255.",
-        constraints: ["Max 100 guards (MAX_EXTERNAL_DEPOSIT_GUARD_COUNT)", "identifier is Option<u8> (None = no amount limit)", "store_from_id is Option<u8>"],
-    },
-    {
-        element_type: "field",
-        type_name: "external_withdraw_guard",
-        semantic_explanation: "Manage external_withdraw_guard list. op: add/set/remove/clear. Requires TREASURY_EXTERNAL_WITHDRAW_GUARD=256.",
-        constraints: ["Max 200 guards (MAX_EXTERNAL_WITHDRAW_GUARD_COUNT)", "identifier is u8 (REQUIRED, not Option)", "store_from_id is Option<u8>"],
-    },
-    {
-        element_type: "field",
-        type_name: "receive",
-        semantic_explanation: "Receive CoinWrapper objects into balance. Requires TREASURY_RECEIVE=253. Writes Record(op=RECEIVE) to history.",
-        constraints: ["CoinWrapper type T must match Treasury's T", "'recently' resolves to all un-received CoinWrapper"],
-    },
-    {
-        element_type: "field",
-        type_name: "owner_receive",
-        semantic_explanation: "Unwrap received objects (CoinWrapper + others) and forward to Permission.owner. Requires TREASURY_OWNER_RECEIVE=257. Does NOT write to history.",
-        constraints: ["Irreversible (funds leave Treasury)", "Recipient is Permission.owner (resolved at tx time)"],
-    },
-    {
-        element_type: "field",
-        type_name: "um",
-        semantic_explanation: "User Manager (Contact object address). um=address → um_set; um=null → um_none. Requires TREASURY_UM=258.",
-        constraints: ["Must be a Contact object (not user wallet)", "UM ≠ admin (no permission management)"],
-    },
-    {
-        element_type: "op",
-        type_name: "add",
-        semantic_explanation: "Upsert semantics: if guard exists, update identifier/store_from_id; else append (after count check)",
-    },
-    {
-        element_type: "op",
-        type_name: "set",
-        semantic_explanation: "Replace entire list: clear first, then add. Use when wholesale replacement is intended.",
-    },
-    {
-        element_type: "op",
-        type_name: "remove",
-        semantic_explanation: "Remove specific guards by address. Count check uses MAX as upper bound (not subtractive).",
-    },
-    {
-        element_type: "op",
-        type_name: "clear",
-        semantic_explanation: "Empty the entire guard list. No count check needed.",
-    },
-];
-export const TREASURY_CONSTRAINT_RULES = [
-    {
-        id: "MC-T-01",
-        category: "structural",
-        rule: "description length <= MAX_DESCRIPTION_LENGTH (4000)",
-        applies_to: ["description"],
-    },
-    {
-        id: "MC-T-02",
-        category: "structural",
-        rule: "external_deposit_guard count <= MAX_EXTERNAL_DEPOSIT_GUARD_COUNT (100)",
-        applies_to: ["external_deposit_guard.guards"],
-    },
-    {
-        id: "MC-T-03",
-        category: "structural",
-        rule: "external_withdraw_guard count <= MAX_EXTERNAL_WITHDRAW_GUARD_COUNT (200)",
-        applies_to: ["external_withdraw_guard.guards"],
-    },
-    {
-        id: "MC-T-04",
-        category: "structural",
-        rule: "external_withdraw_guard.identifier is u8 (REQUIRED, not Option<u8>)",
-        applies_to: ["external_withdraw_guard.guards[].identifier"],
-    },
-    {
-        id: "MC-T-05",
-        category: "structural",
-        rule: "external_deposit_guard.identifier is Option<u8> (None means no amount limit)",
-        applies_to: ["external_deposit_guard.guards[].identifier"],
-    },
-    {
-        id: "MC-T-06",
-        category: "semantic",
-        rule: "Coin type T must match Treasury's type_parameter for all deposit/withdraw/receive operations",
-        applies_to: ["deposit.coin", "withdraw.amount.fixed", "receive"],
-    },
-    {
-        id: "MC-T-07",
-        category: "authority",
-        rule: "deposit via Permission path requires TREASURY_DEPOSIT (252); deposit via Guard path requires no Permission (Guard+Passport only)",
-        applies_to: ["deposit.by_external_deposit_guard"],
-    },
-    {
-        id: "MC-T-08",
-        category: "authority",
-        rule: "withdraw.amount.fixed requires TREASURY_WITHDRAW (254); withdraw.amount.by_external_withdraw_guard requires no Permission",
-        applies_to: ["withdraw.amount"],
-    },
-    {
-        id: "MC-T-09",
-        category: "authority",
-        rule: "external_deposit_guard management requires TREASURY_EXTERNAL_DEPOSIT_GUARD (255); external_withdraw_guard management requires TREASURY_EXTERNAL_WITHDRAW_GUARD (256)",
-        applies_to: ["external_deposit_guard", "external_withdraw_guard"],
-    },
-    {
-        id: "MC-T-10",
-        category: "lifecycle",
-        rule: "withdraw (fixed) and external_withdraw are IRREVERSIBLE; verify recipient and amount before execution",
-        applies_to: ["withdraw.amount.fixed", "withdraw.amount.by_external_withdraw_guard"],
-    },
-    {
-        id: "MC-T-11",
-        category: "lifecycle",
-        rule: "owner_receive forwards assets to Permission.owner and does NOT write to history; verify owner address is current",
-        applies_to: ["owner_receive"],
-    },
-    {
-        id: "MC-T-12",
-        category: "lifecycle",
-        rule: "um_set requires Contact object address (not user wallet); um_set vs um_none both use TREASURY_UM (258)",
-        applies_to: ["um"],
-    },
-    {
-        id: "MC-T-13",
-        category: "cross_object",
-        rule: "If Treasury is referenced by Allocator/Arbitration, TREASURY_RECEIVE (253) must be granted to a trusted operator for regular intake",
-        applies_to: ["receive"],
-    },
-    {
-        id: "MC-T-14",
-        category: "semantic",
-        rule: "external_deposit may split coin if value > guard-specified amount; excess refunded to sender",
-        applies_to: ["deposit.by_external_deposit_guard"],
-    },
-    {
-        id: "MC-T-15",
-        category: "semantic",
-        rule: "inflow/outflow are monotonic counters (never decrease); used for audit reconciliation: theoretical balance = inflow - outflow",
-        applies_to: ["(read-only audit fields)"],
-    },
-];
-export const TREASURY_TRANSLATION_VERSION = "1.0.0";
-export function matchSemanticPattern(userIntent) {
-    const lower = userIntent.toLowerCase();
-    const matches = [];
-    if (lower.includes("create") || lower.includes("new")) {
-        matches.push(SEMANTIC_TO_SCHEMA_RULES[0]);
-    }
-    if (lower.includes("deposit")) {
-        if (lower.includes("external") || lower.includes("guard")) {
-            matches.push(SEMANTIC_TO_SCHEMA_RULES[3]);
-        }
-        else {
-            matches.push(SEMANTIC_TO_SCHEMA_RULES[1]);
-        }
-    }
-    if (lower.includes("withdraw")) {
-        if (lower.includes("external") || lower.includes("guard")) {
-            matches.push(SEMANTIC_TO_SCHEMA_RULES[4]);
-        }
-        else {
-            matches.push(SEMANTIC_TO_SCHEMA_RULES[2]);
-        }
-    }
-    if (lower.includes("guard add") || lower.includes("guard set") || lower.includes("guard remove") ||
-        lower.includes("guard clear")) {
-        matches.push(SEMANTIC_TO_SCHEMA_RULES[5]);
-    }
-    if (lower.includes("receive") ||
-        lower.includes("owner_receive") || lower.includes("forward")) {
-        matches.push(SEMANTIC_TO_SCHEMA_RULES[6]);
-    }
-    if (lower.includes("um") || lower.includes("delegate") || lower.includes("user manager") ||
-        lower.includes("description")) {
-        matches.push(SEMANTIC_TO_SCHEMA_RULES[7]);
-    }
-    if (matches.length === 0) {
-        return [...SEMANTIC_TO_SCHEMA_RULES];
-    }
-    return matches;
-}
-export function explainTreasuryCallData(data) {
-    const lines = [];
-    if (data.object === null || data.object === undefined) {
-        lines.push("Operation: INVALID (object field required)");
-    }
-    else if (typeof data.object === "string") {
-        lines.push(`Operation: OPERATE existing Treasury at ${data.object}`);
-    }
-    else if (typeof data.object === "object") {
-        const obj = data.object;
-        lines.push(`Operation: CREATE new Treasury`);
-        if (obj.name)
-            lines.push(`  name: ${obj.name}`);
-        if (obj.type_parameter)
-            lines.push(`  type_parameter (T): ${obj.type_parameter}`);
-        if (obj.permission) {
-            if (typeof obj.permission === "string") {
-                lines.push(`  permission: existing ${obj.permission}`);
-            }
-            else {
-                lines.push(`  permission: new (TypeNamedObject)`);
-            }
-        }
-    }
-    if (data.description) {
-        lines.push(`- Set description: "${data.description}"`);
-    }
-    if (data.deposit) {
-        const d = data.deposit;
-        if (d.by_external_deposit_guard) {
-            lines.push(`- External deposit via guard: ${d.by_external_deposit_guard}`);
-            if (d.coin?.balance)
-                lines.push(`  coin balance: ${d.coin.balance} (may split if > guard limit)`);
-            if (d.coin?.coin_object)
-                lines.push(`  coin object: ${d.coin.coin_object}`);
-            lines.push(`  ⚠️ No Permission check; Passport required`);
-        }
-        else {
-            lines.push(`- Internal deposit via Permission (TREASURY_DEPOSIT=252)`);
-            if (d.coin?.balance)
-                lines.push(`  coin balance: ${d.coin.balance}`);
-            if (d.coin?.coin_object)
-                lines.push(`  coin object: ${d.coin.coin_object}`);
-        }
-        if (d.payment_info?.remark)
-            lines.push(`  payment remark: "${d.payment_info.remark}"`);
-    }
-    if (data.withdraw) {
-        const w = data.withdraw;
-        if (w.amount?.fixed) {
-            lines.push(`- Internal withdraw via Permission (TREASURY_WITHDRAW=254)`);
-            lines.push(`  amount: ${w.amount.fixed} (fixed, IRREVERSIBLE)`);
-        }
-        else if (w.amount?.by_external_withdraw_guard) {
-            lines.push(`- External withdraw via guard: ${w.amount.by_external_withdraw_guard}`);
-            lines.push(`  ⚠️ Amount determined by Guard table identifier (not caller-specified)`);
-            lines.push(`  ⚠️ IRREVERSIBLE; No Permission check; Passport required`);
-        }
-        if (w.recipient)
-            lines.push(`  recipient: ${w.recipient}`);
-        if (w.payment_info?.remark)
-            lines.push(`  payment remark: "${w.payment_info.remark}"`);
-    }
-    if (data.receive) {
-        if (data.receive === "recently") {
-            lines.push(`- Receive all recently-received CoinWrapper (TREASURY_RECEIVE=253)`);
-        }
-        else if (Array.isArray(data.receive)) {
-            lines.push(`- Receive ${data.receive.length} CoinWrapper object(s) (TREASURY_RECEIVE=253)`);
-        }
-    }
-    if (data.external_deposit_guard) {
-        const g = data.external_deposit_guard;
-        if (g.op === "clear") {
-            lines.push(`- Clear external_deposit_guard list (TREASURY_EXTERNAL_DEPOSIT_GUARD=255)`);
-        }
-        else if (g.op === "remove") {
-            lines.push(`- Remove ${g.guards.length} guard(s) from external_deposit_guard (Permission 255)`);
-        }
-        else {
-            const count = g.guards.length;
-            lines.push(`- ${g.op === "set" ? "Set (clear+add)" : "Add (upsert)"} ${count} external_deposit_guard(s) (Permission 255)`);
-        }
-    }
-    if (data.external_withdraw_guard) {
-        const g = data.external_withdraw_guard;
-        if (g.op === "clear") {
-            lines.push(`- Clear external_withdraw_guard list (TREASURY_EXTERNAL_WITHDRAW_GUARD=256)`);
-        }
-        else if (g.op === "remove") {
-            lines.push(`- Remove ${g.guards.length} guard(s) from external_withdraw_guard (Permission 256)`);
-        }
-        else {
-            const count = g.guards.length;
-            lines.push(`- ${g.op === "set" ? "Set (clear+add)" : "Add (upsert)"} ${count} external_withdraw_guard(s) (Permission 256)`);
-            lines.push(`  ⚠️ withdraw guard identifier is REQUIRED (u8, not Option)`);
-        }
-    }
-    if (data.owner_receive) {
-        if (data.owner_receive === "recently") {
-            lines.push(`- owner_receive: forward all recently-received objects to Permission.owner (TREASURY_OWNER_RECEIVE=257)`);
-        }
-        else if (Array.isArray(data.owner_receive)) {
-            lines.push(`- owner_receive: forward ${data.owner_receive.length} object(s) to Permission.owner (Permission 257)`);
-        }
-        lines.push(`  ⚠️ IRREVERSIBLE; does NOT write to history`);
-    }
-    if (data.um !== undefined) {
-        if (data.um === null) {
-            lines.push(`- UM revoke (um_none, TREASURY_UM=258)`);
-        }
-        else {
-            lines.push(`- UM set to ${data.um} (TREASURY_UM=258)`);
-        }
-    }
-    return lines.join("\n");
-}
-export function explainField(fieldName) {
-    return SCHEMA_TO_SEMANTIC_RULES.find(r => r.element_type === "field" && r.type_name === fieldName);
-}
-export function explainOp(opName) {
-    return SCHEMA_TO_SEMANTIC_RULES.find(r => r.element_type === "op" && r.type_name === opName);
-}
-export function getConstraintsByCategory(category) {
-    return TREASURY_CONSTRAINT_RULES.filter(r => r.category === category);
-}
-export function explainTreasuryPermissionIndex(index) {
-    if (isBuiltinTreasuryPermission(index)) {
-        const entry = getBuiltinPermissionByIndex(index);
-        const scene = findSceneByPermissionIndex(index);
-        return `${entry?.name ?? "Unknown"} (${index}) — ${entry?.description ?? ""} [scene: ${scene?.id ?? "unknown"}]`;
-    }
-    if (index === -1) {
-        return `Reserved (no Permission index) — external operations use Guard + Passport instead`;
-    }
-    if (index >= 1000) {
-        return `Custom permission (${index}) — must be documented via Permission.remark; not used by Treasury builtin operations`;
-    }
-    if (index === 259 || index === 260) {
-        return `STALE index ${index} — was pre-fix SDK value; canonical post-fix indexes are 255-258. See R-T-01.`;
-    }
-    return `Index ${index} — not a Treasury builtin permission (range 250-258)`;
-}
+import{isBuiltinTreasuryPermission,getBuiltinPermissionByIndex,findSceneByPermissionIndex}from'./treasury-ledger.js';export const SEMANTIC_TO_SCHEMA_RULES=[{'id':'T-T-01','pattern_name':'Create\x20new\x20Treasury','semantic_intent':'Create\x20a\x20new\x20Treasury\x20with\x20a\x20Coin\x20type\x20T\x20and\x20associated\x20Permission','match_keywords':['create','new'],'schema_fields':['object\x20(TypeNamedObjectWithPermission)','description'],'example_json':{'object':{'name':'myteam_treasury','type_parameter':'0x2::wow::WOW','permission':{'name':'myteam_treasury_permission','description':'Permission\x20for\x20myteam\x20treasury'}},'description':'Team\x20treasury\x20for\x20project\x20X\x20funding'},'reverse_explanation':'object\x20must\x20be\x20in\x20OBJECT\x20format\x20(not\x20STRING)\x20for\x20creation;\x20type_parameter\x20is\x20the\x20Coin\x20type\x20T;\x20permission\x20can\x20be\x20new\x20or\x20existing'},{'id':'T-T-02','pattern_name':'Internal\x20deposit\x20(Permission\x20path)','semantic_intent':'Deposit\x20funds\x20to\x20Treasury\x20via\x20Permission\x20authorization','match_keywords':['deposit'],'schema_fields':['object\x20(string)','deposit.coin','deposit.payment_info'],'example_json':{'object':'myteam_treasury','deposit':{'coin':{'balance':'1000000000'},'payment_info':{'remark':'Q3\x20budget\x20allocation','index':0x0}}},'reverse_explanation':'deposit.by_external_deposit_guard\x20omitted\x20→\x20Permission\x20path\x20(TREASURY_DEPOSIT=252);\x20coin\x20can\x20be\x20{balance}\x20or\x20{coin_object}'},{'id':'T-T-03','pattern_name':'Internal\x20withdraw\x20(Permission\x20path,\x20fixed\x20amount)','semantic_intent':'Withdraw\x20fixed\x20amount\x20from\x20Treasury\x20via\x20Permission\x20authorization','match_keywords':['withdraw'],'schema_fields':['object\x20(string)','withdraw.amount.fixed','withdraw.recipient','withdraw.payment_info'],'example_json':{'object':'myteam_treasury','withdraw':{'amount':{'fixed':'500000000'},'recipient':'0xRECIPIENT','payment_info':{'remark':'Vendor\x20payment','index':0x1}}},'reverse_explanation':'withdraw.amount.fixed\x20→\x20Permission\x20path\x20(TREASURY_WITHDRAW=254);\x20amount\x20is\x20fixed\x20u64;\x20irreversible'},{'id':'T-T-04','pattern_name':'External\x20deposit\x20(Guard\x20+\x20Passport\x20path)','semantic_intent':'External\x20user\x20deposits\x20via\x20preset\x20Guard\x20verification\x20(no\x20Permission\x20needed)','match_keywords':['external\x20deposit','guard\x20deposit'],'schema_fields':['object\x20(string)','deposit.coin','deposit.by_external_deposit_guard','deposit.payment_info','submission\x20(Passport)'],'example_json':{'object':'myteam_treasury','deposit':{'coin':{'balance':'200000000'},'by_external_deposit_guard':'deposit_guard_v1','payment_info':{'remark':'External\x20deposit\x20via\x20guard','index':0x2}}},'reverse_explanation':'deposit.by_external_deposit_guard\x20present\x20→\x20Guard\x20path\x20(NO\x20Permission\x20check);\x20Passport\x20required\x20via\x20submission\x20field;\x20amount\x20may\x20split\x20if\x20coin\x20>\x20guard-specified'},{'id':'T-T-05','pattern_name':'External\x20withdraw\x20(Guard\x20+\x20Passport\x20path,\x20amount\x20from\x20Guard)','semantic_intent':'External\x20user\x20withdraws\x20via\x20preset\x20Guard\x20verification;\x20amount\x20determined\x20by\x20Guard\x20table\x20identifier','match_keywords':['external\x20withdraw','guard\x20withdraw'],'schema_fields':['object\x20(string)','withdraw.amount.by_external_withdraw_guard','withdraw.recipient','withdraw.payment_info','submission\x20(Passport)'],'example_json':{'object':'myteam_treasury','withdraw':{'amount':{'by_external_withdraw_guard':'withdraw_guard_v1'},'recipient':'0xRECIPIENT','payment_info':{'remark':'External\x20withdraw\x20via\x20guard','index':0x3}}},'reverse_explanation':'withdraw.amount.by_external_withdraw_guard\x20→\x20Guard\x20path\x20(NO\x20Permission\x20check);\x20amount\x20comes\x20from\x20Guard\x20table\x20identifier\x20(u8,\x20required);\x20irreversible'},{'id':'T-T-06','pattern_name':'Manage\x20external\x20deposit/withdraw\x20Guard\x20(add/set/remove/clear)','semantic_intent':'Add,\x20set,\x20remove,\x20or\x20clear\x20external_deposit_guard\x20/\x20external_withdraw_guard\x20lists','match_keywords':['guard\x20add','guard\x20set','guard\x20remove','guard\x20clear'],'schema_fields':['object\x20(string)','external_deposit_guard\x20|\x20external_withdraw_guard'],'example_json':{'object':'myteam_treasury','external_deposit_guard':{'op':'add','guards':[{'guard':'deposit_guard_v1','identifier':0x2,'store_from_id':null}]}},'reverse_explanation':'op=\x27add\x27\x20(upsert)\x20/\x20\x27set\x27\x20(clear+add)\x20/\x20\x27remove\x27\x20(by\x20guard\x20address)\x20/\x20\x27clear\x27\x20(empty\x20list);\x20Permission\x20index\x20255\x20(deposit)\x20/\x20256\x20(withdraw)\x20required'},{'id':'T-T-07','pattern_name':'Receive\x20CoinWrapper\x20/\x20owner_receive\x20forward','semantic_intent':'Receive\x20CoinWrapper\x20into\x20balance,\x20or\x20forward\x20received\x20objects\x20to\x20Permission\x20owner','match_keywords':['receive','owner_receive','forward'],'schema_fields':['object\x20(string)','receive\x20|\x20owner_receive'],'example_json':{'object':'myteam_treasury','receive':'recently'},'reverse_explanation':'receive\x20→\x20TREASURY_RECEIVE=253,\x20converts\x20CoinWrapper\x20to\x20balance,\x20writes\x20Record;\x20owner_receive\x20→\x20TREASURY_OWNER_RECEIVE=257,\x20forwards\x20to\x20Permission.owner,\x20no\x20Record'},{'id':'T-T-08','pattern_name':'Set\x20UM\x20/\x20modify\x20description','semantic_intent':'Delegate\x20User\x20Manager\x20(Contact\x20object)\x20or\x20modify\x20Treasury\x20description','match_keywords':['um','um_set','um_none','description','delegate'],'schema_fields':['object\x20(string)','um\x20|\x20description'],'example_json':{'object':'myteam_treasury','um':'team_contact'},'reverse_explanation':'um=address\x20→\x20TREASURY_UM=258\x20(um_set);\x20um=null\x20→\x20TREASURY_UM=258\x20(um_none);\x20description=string\x20→\x20TREASURY_DESCRIPTION=251'}];export const SCHEMA_TO_SEMANTIC_RULES=[{'element_type':'field','type_name':'object','semantic_explanation':'Treasury\x20object\x20reference.\x20STRING=operate\x20existing;\x20OBJECT={name,\x20type_parameter,\x20permission}=create\x20new','constraints':['type_parameter\x20required\x20at\x20creation,\x20immutable\x20thereafter','permission\x20can\x20be\x20new\x20(TypeNamedObject)\x20or\x20existing\x20(string\x20address)']},{'element_type':'field','type_name':'description','semantic_explanation':'Human-readable\x20description\x20of\x20Treasury\x20purpose.\x20Max\x204000\x20chars\x20(MAX_DESCRIPTION_LENGTH).','constraints':['<=\x204000\x20chars','Modifiable\x20via\x20TREASURY_DESCRIPTION\x20(251)']},{'element_type':'field','type_name':'deposit','semantic_explanation':'Deposit\x20operation.\x20Two\x20access\x20paths:\x20(1)\x20Permission\x20path\x20(by_external_deposit_guard\x20omitted,\x20requires\x20TREASURY_DEPOSIT=252);\x20(2)\x20Guard\x20path\x20(by_external_deposit_guard\x20set,\x20requires\x20Passport,\x20no\x20Permission)'},{'element_type':'field','type_name':'deposit.coin','semantic_explanation':'Coin\x20to\x20deposit.\x20{balance:\x20string}\x20for\x20amount;\x20{coin_object:\x20string}\x20for\x20existing\x20Coin\x20object.\x20Type\x20T\x20must\x20match\x20Treasury\x27s\x20type_parameter.'},{'element_type':'field','type_name':'deposit.by_external_deposit_guard','semantic_explanation':'Guard\x20address\x20or\x20name\x20for\x20external\x20deposit\x20path.\x20Triggers\x20Guard\x20+\x20Passport\x20verification;\x20bypasses\x20Permission\x20check.','constraints':['Guard\x20must\x20be\x20in\x20external_deposit_guard\x20list\x20(else\x20E_EXTERNAL_DEPOSIT_GUARD_NOT_FOUND)','Passport\x20required']},{'element_type':'field','type_name':'withdraw','semantic_explanation':'Withdraw\x20operation.\x20Two\x20access\x20paths:\x20(1)\x20Permission\x20path\x20(amount.fixed,\x20requires\x20TREASURY_WITHDRAW=254);\x20(2)\x20Guard\x20path\x20(amount.by_external_withdraw_guard,\x20requires\x20Passport,\x20no\x20Permission)'},{'element_type':'field','type_name':'withdraw.amount.fixed','semantic_explanation':'Fixed\x20u64\x20withdraw\x20amount\x20(Permission\x20path).\x20Irreversible.\x20Recipient\x20specified\x20separately.','constraints':['Must\x20be\x20<=\x20balance\x20(else\x20E_WITHDRAW_INSUFFICIENT_AMOUNT)','u64\x20format']},{'element_type':'field','type_name':'withdraw.amount.by_external_withdraw_guard','semantic_explanation':'Guard\x20address/name\x20for\x20external\x20withdraw\x20path.\x20Amount\x20determined\x20by\x20Guard\x20table\x20identifier\x20(not\x20caller-specified).','constraints':['Guard\x20must\x20be\x20in\x20external_withdraw_guard\x20list','Passport\x20required','Amount\x20from\x20Guard\x20is\x20authoritative']},{'element_type':'field','type_name':'external_deposit_guard','semantic_explanation':'Manage\x20external_deposit_guard\x20list.\x20op:\x20add\x20(upsert)\x20/\x20set\x20(clear+add)\x20/\x20remove\x20(by\x20address)\x20/\x20clear\x20(empty).\x20Requires\x20TREASURY_EXTERNAL_DEPOSIT_GUARD=255.','constraints':['Max\x20100\x20guards\x20(MAX_EXTERNAL_DEPOSIT_GUARD_COUNT)','identifier\x20is\x20Option<u8>\x20(None\x20=\x20no\x20amount\x20limit)','store_from_id\x20is\x20Option<u8>']},{'element_type':'field','type_name':'external_withdraw_guard','semantic_explanation':'Manage\x20external_withdraw_guard\x20list.\x20op:\x20add/set/remove/clear.\x20Requires\x20TREASURY_EXTERNAL_WITHDRAW_GUARD=256.','constraints':['Max\x20200\x20guards\x20(MAX_EXTERNAL_WITHDRAW_GUARD_COUNT)','identifier\x20is\x20u8\x20(REQUIRED,\x20not\x20Option)','store_from_id\x20is\x20Option<u8>']},{'element_type':'field','type_name':'receive','semantic_explanation':'Receive\x20CoinWrapper\x20objects\x20into\x20balance.\x20Requires\x20TREASURY_RECEIVE=253.\x20Writes\x20Record(op=RECEIVE)\x20to\x20history.','constraints':['CoinWrapper\x20type\x20T\x20must\x20match\x20Treasury\x27s\x20T','\x27recently\x27\x20resolves\x20to\x20all\x20un-received\x20CoinWrapper']},{'element_type':'field','type_name':'owner_receive','semantic_explanation':'Unwrap\x20received\x20objects\x20(CoinWrapper\x20+\x20others)\x20and\x20forward\x20to\x20Permission.owner.\x20Requires\x20TREASURY_OWNER_RECEIVE=257.\x20Does\x20NOT\x20write\x20to\x20history.','constraints':['Irreversible\x20(funds\x20leave\x20Treasury)','Recipient\x20is\x20Permission.owner\x20(resolved\x20at\x20tx\x20time)']},{'element_type':'field','type_name':'um','semantic_explanation':'User\x20Manager\x20(Contact\x20object\x20address).\x20um=address\x20→\x20um_set;\x20um=null\x20→\x20um_none.\x20Requires\x20TREASURY_UM=258.','constraints':['Must\x20be\x20a\x20Contact\x20object\x20(not\x20user\x20wallet)','UM\x20≠\x20admin\x20(no\x20permission\x20management)']},{'element_type':'op','type_name':'add','semantic_explanation':'Upsert\x20semantics:\x20if\x20guard\x20exists,\x20update\x20identifier/store_from_id;\x20else\x20append\x20(after\x20count\x20check)'},{'element_type':'op','type_name':'set','semantic_explanation':'Replace\x20entire\x20list:\x20clear\x20first,\x20then\x20add.\x20Use\x20when\x20wholesale\x20replacement\x20is\x20intended.'},{'element_type':'op','type_name':'remove','semantic_explanation':'Remove\x20specific\x20guards\x20by\x20address.\x20Count\x20check\x20uses\x20MAX\x20as\x20upper\x20bound\x20(not\x20subtractive).'},{'element_type':'op','type_name':'clear','semantic_explanation':'Empty\x20the\x20entire\x20guard\x20list.\x20No\x20count\x20check\x20needed.'}];export const TREASURY_CONSTRAINT_RULES=[{'id':'MC-T-01','category':'structural','rule':'description\x20length\x20<=\x20MAX_DESCRIPTION_LENGTH\x20(4000)','applies_to':['description']},{'id':'MC-T-02','category':'structural','rule':'external_deposit_guard\x20count\x20<=\x20MAX_EXTERNAL_DEPOSIT_GUARD_COUNT\x20(100)','applies_to':['external_deposit_guard.guards']},{'id':'MC-T-03','category':'structural','rule':'external_withdraw_guard\x20count\x20<=\x20MAX_EXTERNAL_WITHDRAW_GUARD_COUNT\x20(200)','applies_to':['external_withdraw_guard.guards']},{'id':'MC-T-04','category':'structural','rule':'external_withdraw_guard.identifier\x20is\x20u8\x20(REQUIRED,\x20not\x20Option<u8>)','applies_to':['external_withdraw_guard.guards[].identifier']},{'id':'MC-T-05','category':'structural','rule':'external_deposit_guard.identifier\x20is\x20Option<u8>\x20(None\x20means\x20no\x20amount\x20limit)','applies_to':['external_deposit_guard.guards[].identifier']},{'id':'MC-T-06','category':'semantic','rule':'Coin\x20type\x20T\x20must\x20match\x20Treasury\x27s\x20type_parameter\x20for\x20all\x20deposit/withdraw/receive\x20operations','applies_to':['deposit.coin','withdraw.amount.fixed','receive']},{'id':'MC-T-07','category':'authority','rule':'deposit\x20via\x20Permission\x20path\x20requires\x20TREASURY_DEPOSIT\x20(252);\x20deposit\x20via\x20Guard\x20path\x20requires\x20no\x20Permission\x20(Guard+Passport\x20only)','applies_to':['deposit.by_external_deposit_guard']},{'id':'MC-T-08','category':'authority','rule':'withdraw.amount.fixed\x20requires\x20TREASURY_WITHDRAW\x20(254);\x20withdraw.amount.by_external_withdraw_guard\x20requires\x20no\x20Permission','applies_to':['withdraw.amount']},{'id':'MC-T-09','category':'authority','rule':'external_deposit_guard\x20management\x20requires\x20TREASURY_EXTERNAL_DEPOSIT_GUARD\x20(255);\x20external_withdraw_guard\x20management\x20requires\x20TREASURY_EXTERNAL_WITHDRAW_GUARD\x20(256)','applies_to':['external_deposit_guard','external_withdraw_guard']},{'id':'MC-T-10','category':'lifecycle','rule':'withdraw\x20(fixed)\x20and\x20external_withdraw\x20are\x20IRREVERSIBLE;\x20verify\x20recipient\x20and\x20amount\x20before\x20execution','applies_to':['withdraw.amount.fixed','withdraw.amount.by_external_withdraw_guard']},{'id':'MC-T-11','category':'lifecycle','rule':'owner_receive\x20forwards\x20assets\x20to\x20Permission.owner\x20and\x20does\x20NOT\x20write\x20to\x20history;\x20verify\x20owner\x20address\x20is\x20current','applies_to':['owner_receive']},{'id':'MC-T-12','category':'lifecycle','rule':'um_set\x20requires\x20Contact\x20object\x20address\x20(not\x20user\x20wallet);\x20um_set\x20vs\x20um_none\x20both\x20use\x20TREASURY_UM\x20(258)','applies_to':['um']},{'id':'MC-T-13','category':'cross_object','rule':'If\x20Treasury\x20is\x20referenced\x20by\x20Allocator/Arbitration,\x20TREASURY_RECEIVE\x20(253)\x20must\x20be\x20granted\x20to\x20a\x20trusted\x20operator\x20for\x20regular\x20intake','applies_to':['receive']},{'id':'MC-T-14','category':'semantic','rule':'external_deposit\x20may\x20split\x20coin\x20if\x20value\x20>\x20guard-specified\x20amount;\x20excess\x20refunded\x20to\x20sender','applies_to':['deposit.by_external_deposit_guard']},{'id':'MC-T-15','category':'semantic','rule':'inflow/outflow\x20are\x20monotonic\x20counters\x20(never\x20decrease);\x20used\x20for\x20audit\x20reconciliation:\x20theoretical\x20balance\x20=\x20inflow\x20-\x20outflow','applies_to':['(read-only\x20audit\x20fields)']}];export const TREASURY_TRANSLATION_VERSION='1.0.0';export function matchSemanticPattern(a){const b=a['toLowerCase'](),c=[];(b['includes']('create')||b['includes']('new'))&&c['push'](SEMANTIC_TO_SCHEMA_RULES[0x0]);b['includes']('deposit')&&(b['includes']('external')||b['includes']('guard')?c['push'](SEMANTIC_TO_SCHEMA_RULES[0x3]):c['push'](SEMANTIC_TO_SCHEMA_RULES[0x1]));b['includes']('withdraw')&&(b['includes']('external')||b['includes']('guard')?c['push'](SEMANTIC_TO_SCHEMA_RULES[0x4]):c['push'](SEMANTIC_TO_SCHEMA_RULES[0x2]));(b['includes']('guard\x20add')||b['includes']('guard\x20set')||b['includes']('guard\x20remove')||b['includes']('guard\x20clear'))&&c['push'](SEMANTIC_TO_SCHEMA_RULES[0x5]);(b['includes']('receive')||b['includes']('owner_receive')||b['includes']('forward'))&&c['push'](SEMANTIC_TO_SCHEMA_RULES[0x6]);(b['includes']('um')||b['includes']('delegate')||b['includes']('user\x20manager')||b['includes']('description'))&&c['push'](SEMANTIC_TO_SCHEMA_RULES[0x7]);if(c['length']===0x0)return[...SEMANTIC_TO_SCHEMA_RULES];return c;}export function explainTreasuryCallData(a){const b=[];if(a['object']===null||a['object']===undefined)b['push']('Operation:\x20INVALID\x20(object\x20field\x20required)');else{if(typeof a['object']==='string')b['push']('Operation:\x20OPERATE\x20existing\x20Treasury\x20at\x20'+a['object']);else{if(typeof a['object']==='object'){const c=a['object'];b['push']('Operation:\x20CREATE\x20new\x20Treasury');if(c['name'])b['push']('\x20\x20name:\x20'+c['name']);if(c['type_parameter'])b['push']('\x20\x20type_parameter\x20(T):\x20'+c['type_parameter']);c['permission']&&(typeof c['permission']==='string'?b['push']('\x20\x20permission:\x20existing\x20'+c['permission']):b['push']('\x20\x20permission:\x20new\x20(TypeNamedObject)'));}}}a['description']&&b['push']('-\x20Set\x20description:\x20\x22'+a['description']+'\x22');if(a['deposit']){const e=a['deposit'];if(e['by_external_deposit_guard']){b['push']('-\x20External\x20deposit\x20via\x20guard:\x20'+e['by_external_deposit_guard']);if(e['coin']?.['balance'])b['push']('\x20\x20coin\x20balance:\x20'+e['coin']['balance']+'\x20(may\x20split\x20if\x20>\x20guard\x20limit)');if(e['coin']?.['coin_object'])b['push']('\x20\x20coin\x20object:\x20'+e['coin']['coin_object']);b['push']('\x20\x20⚠️\x20No\x20Permission\x20check;\x20Passport\x20required');}else{b['push']('-\x20Internal\x20deposit\x20via\x20Permission\x20(TREASURY_DEPOSIT=252)');if(e['coin']?.['balance'])b['push']('\x20\x20coin\x20balance:\x20'+e['coin']['balance']);if(e['coin']?.['coin_object'])b['push']('\x20\x20coin\x20object:\x20'+e['coin']['coin_object']);}if(e['payment_info']?.['remark'])b['push']('\x20\x20payment\x20remark:\x20\x22'+e['payment_info']['remark']+'\x22');}if(a['withdraw']){const f=a['withdraw'];if(f['amount']?.['fixed'])b['push']('-\x20Internal\x20withdraw\x20via\x20Permission\x20(TREASURY_WITHDRAW=254)'),b['push']('\x20\x20amount:\x20'+f['amount']['fixed']+'\x20(fixed,\x20IRREVERSIBLE)');else f['amount']?.['by_external_withdraw_guard']&&(b['push']('-\x20External\x20withdraw\x20via\x20guard:\x20'+f['amount']['by_external_withdraw_guard']),b['push']('\x20\x20⚠️\x20Amount\x20determined\x20by\x20Guard\x20table\x20identifier\x20(not\x20caller-specified)'),b['push']('\x20\x20⚠️\x20IRREVERSIBLE;\x20No\x20Permission\x20check;\x20Passport\x20required'));if(f['recipient'])b['push']('\x20\x20recipient:\x20'+f['recipient']);if(f['payment_info']?.['remark'])b['push']('\x20\x20payment\x20remark:\x20\x22'+f['payment_info']['remark']+'\x22');}if(a['receive']){if(a['receive']==='recently')b['push']('-\x20Receive\x20all\x20recently-received\x20CoinWrapper\x20(TREASURY_RECEIVE=253)');else Array['isArray'](a['receive'])&&b['push']('-\x20Receive\x20'+a['receive']['length']+'\x20CoinWrapper\x20object(s)\x20(TREASURY_RECEIVE=253)');}if(a['external_deposit_guard']){const h=a['external_deposit_guard'];if(h['op']==='clear')b['push']('-\x20Clear\x20external_deposit_guard\x20list\x20(TREASURY_EXTERNAL_DEPOSIT_GUARD=255)');else{if(h['op']==='remove')b['push']('-\x20Remove\x20'+h['guards']['length']+'\x20guard(s)\x20from\x20external_deposit_guard\x20(Permission\x20255)');else{const i=h['guards']['length'];b['push']('-\x20'+(h['op']==='set'?'Set\x20(clear+add)':'Add\x20(upsert)')+'\x20'+i+'\x20external_deposit_guard(s)\x20(Permission\x20255)');}}}if(a['external_withdraw_guard']){const j=a['external_withdraw_guard'];if(j['op']==='clear')b['push']('-\x20Clear\x20external_withdraw_guard\x20list\x20(TREASURY_EXTERNAL_WITHDRAW_GUARD=256)');else{if(j['op']==='remove')b['push']('-\x20Remove\x20'+j['guards']['length']+'\x20guard(s)\x20from\x20external_withdraw_guard\x20(Permission\x20256)');else{const k=j['guards']['length'];b['push']('-\x20'+(j['op']==='set'?'Set\x20(clear+add)':'Add\x20(upsert)')+'\x20'+k+'\x20external_withdraw_guard(s)\x20(Permission\x20256)'),b['push']('\x20\x20⚠️\x20withdraw\x20guard\x20identifier\x20is\x20REQUIRED\x20(u8,\x20not\x20Option)');}}}if(a['owner_receive']){if(a['owner_receive']==='recently')b['push']('-\x20owner_receive:\x20forward\x20all\x20recently-received\x20objects\x20to\x20Permission.owner\x20(TREASURY_OWNER_RECEIVE=257)');else Array['isArray'](a['owner_receive'])&&b['push']('-\x20owner_receive:\x20forward\x20'+a['owner_receive']['length']+'\x20object(s)\x20to\x20Permission.owner\x20(Permission\x20257)');b['push']('\x20\x20⚠️\x20IRREVERSIBLE;\x20does\x20NOT\x20write\x20to\x20history');}return a['um']!==undefined&&(a['um']===null?b['push']('-\x20UM\x20revoke\x20(um_none,\x20TREASURY_UM=258)'):b['push']('-\x20UM\x20set\x20to\x20'+a['um']+'\x20(TREASURY_UM=258)')),b['join']('\x0a');}export function explainField(a){return SCHEMA_TO_SEMANTIC_RULES['find'](b=>b['element_type']==='field'&&b['type_name']===a);}export function explainOp(a){return SCHEMA_TO_SEMANTIC_RULES['find'](b=>b['element_type']==='op'&&b['type_name']===a);}export function getConstraintsByCategory(a){return TREASURY_CONSTRAINT_RULES['filter'](b=>b['category']===a);}export function explainTreasuryPermissionIndex(a){if(isBuiltinTreasuryPermission(a)){const b=getBuiltinPermissionByIndex(a),c=findSceneByPermissionIndex(a);return(b?.['name']??'Unknown')+'\x20('+a+')\x20—\x20'+(b?.['description']??'')+'\x20[scene:\x20'+(c?.['id']??'unknown')+']';}if(a===-0x1)return'Reserved\x20(no\x20Permission\x20index)\x20—\x20external\x20operations\x20use\x20Guard\x20+\x20Passport\x20instead';if(a>=0x3e8)return'Custom\x20permission\x20('+a+')\x20—\x20must\x20be\x20documented\x20via\x20Permission.remark;\x20not\x20used\x20by\x20Treasury\x20builtin\x20operations';if(a===0x103||a===0x104)return'STALE\x20index\x20'+a+'\x20—\x20was\x20pre-fix\x20SDK\x20value;\x20canonical\x20post-fix\x20indexes\x20are\x20255-258.\x20See\x20R-T-01.';return'Index\x20'+a+'\x20—\x20not\x20a\x20Treasury\x20builtin\x20permission\x20(range\x20250-258)';}