@wowok/agent-mcp 2.7.1 → 2.7.3

package/dist/knowledge/treasury-templates.js

@@ -1,358 +1 @@
-export const TREASURY_TEMPLATES = [
-    {
-        id: "T-T-01",
-        name: "Basic Treasury (owner-only deposit/withdraw)",
-        description: "Single-owner Treasury with no external Guard. Owner has all permissions. Suitable for solo operators or simple team funds.",
-        applicable_scenes: ["treasury_fund_collection", "treasury_um_delegation"],
-        industry_tags: ["universal", "solo"],
-        params: [
-            { name: "treasury_name", type: "string", description: "Name for the new Treasury object", required: true },
-            { name: "owner_address", type: "address", description: "Owner address (becomes admin)", required: true },
-            { name: "coin_type", type: "coin_type", description: "Coin type T (e.g. 0x2::wow::WOW)", required: true },
-            { name: "description", type: "string", description: "Treasury description", required: true },
-            { name: "permission_name", type: "string", description: "Name for the new Permission object", required: true },
-        ],
-        body: (p) => ({
-            object: {
-                name: p.treasury_name,
-                type_parameter: p.coin_type,
-                permission: {
-                    name: p.permission_name,
-                    description: `Permission for ${p.treasury_name}`,
-                },
-            },
-            description: p.description,
-            _permission_config: {
-                TREASURY_NEW: [p.owner_address],
-                TREASURY_DESCRIPTION: [p.owner_address],
-                TREASURY_DEPOSIT: [p.owner_address],
-                TREASURY_RECEIVE: [p.owner_address],
-                TREASURY_WITHDRAW: [p.owner_address],
-                TREASURY_OWNER_RECEIVE: [p.owner_address],
-                TREASURY_UM: [p.owner_address],
-            },
-        }),
-        notes: [
-            "All permissions granted to owner only; suitable for solo treasury",
-            "No external Guard configured; all deposits/withdraws via Permission",
-            "To enable external operations later, use T-T-03 pattern",
-        ],
-    },
-    {
-        id: "T-T-02",
-        name: "Multi-role Treasury (separated depositor/withdrawer)",
-        description: "Treasury with separated depositor and withdrawer roles. Enforces separation of duties. Suitable for project budget management.",
-        applicable_scenes: ["treasury_fund_collection", "treasury_permission_sharing"],
-        industry_tags: ["universal", "team", "project"],
-        params: [
-            { name: "treasury_name", type: "string", description: "Name for the new Treasury object", required: true },
-            { name: "owner_address", type: "address", description: "Owner address (full control)", required: true },
-            { name: "depositor_addresses", type: "string[]", description: "Addresses allowed to deposit (TREASURY_DEPOSIT=252)", required: true },
-            { name: "withdrawer_addresses", type: "string[]", description: "Addresses allowed to withdraw (TREASURY_WITHDRAW=254)", required: true },
-            { name: "receiver_address", type: "address", description: "Address allowed to receive CoinWrapper (TREASURY_RECEIVE=253)", required: true },
-            { name: "coin_type", type: "coin_type", description: "Coin type T", required: true },
-            { name: "description", type: "string", description: "Treasury description", required: true },
-            { name: "permission_name", type: "string", description: "Name for the new Permission object", required: true },
-        ],
-        body: (p) => ({
-            object: {
-                name: p.treasury_name,
-                type_parameter: p.coin_type,
-                permission: {
-                    name: p.permission_name,
-                    description: `Permission for ${p.treasury_name} (multi-role)`,
-                },
-            },
-            description: p.description,
-            _permission_config: {
-                TREASURY_NEW: [p.owner_address],
-                TREASURY_DESCRIPTION: [p.owner_address],
-                TREASURY_DEPOSIT: p.depositor_addresses,
-                TREASURY_RECEIVE: [p.receiver_address],
-                TREASURY_WITHDRAW: p.withdrawer_addresses,
-                TREASURY_OWNER_RECEIVE: [p.owner_address],
-                TREASURY_UM: [p.owner_address],
-            },
-        }),
-        notes: [
-            "Separation of duties: deposit and withdraw roles assigned to different addresses",
-            "Use distinct addresses for depositor_addresses and withdrawer_addresses",
-            "Owner retains full control (um_set, owner_receive, description_set)",
-        ],
-    },
-    {
-        id: "T-T-03",
-        name: "External operations Treasury (with Guard protection)",
-        description: "Treasury with external_deposit_guard and/or external_withdraw_guard configured. Allows external users to deposit/withdraw via Guard + Passport without Permission.",
-        applicable_scenes: ["treasury_external_ops", "treasury_guard_protection"],
-        industry_tags: ["finance", "crowdfunding", "refund", "compensation"],
-        params: [
-            { name: "treasury_name", type: "string", description: "Name for the new Treasury object", required: true },
-            { name: "owner_address", type: "address", description: "Owner address", required: true },
-            { name: "coin_type", type: "coin_type", description: "Coin type T", required: true },
-            { name: "description", type: "string", description: "Treasury description", required: true },
-            { name: "permission_name", type: "string", description: "Name for the new Permission object", required: true },
-            { name: "external_deposit_guards", type: "string[]", description: "Guard addresses/names for external deposit (identifier=Optional)", required: false },
-            { name: "external_withdraw_guards", type: "string[]", description: "Guard addresses/names for external withdraw (identifier=Required)", required: false },
-            { name: "withdraw_identifier_index", type: "number", description: "Guard table identifier index for withdraw amount (u8, required for withdraw guards)", required: false, default: 0 },
-            { name: "store_from_id_index", type: "number", description: "Optional store_from_id index for audit trail", required: false },
-        ],
-        body: (p) => {
-            const result = {
-                object: {
-                    name: p.treasury_name,
-                    type_parameter: p.coin_type,
-                    permission: {
-                        name: p.permission_name,
-                        description: `Permission for ${p.treasury_name} (external ops)`,
-                    },
-                },
-                description: p.description,
-                _permission_config: {
-                    TREASURY_NEW: [p.owner_address],
-                    TREASURY_EXTERNAL_DEPOSIT_GUARD: [p.owner_address],
-                    TREASURY_EXTERNAL_WITHDRAW_GUARD: [p.owner_address],
-                    TREASURY_OWNER_RECEIVE: [p.owner_address],
-                    TREASURY_UM: [p.owner_address],
-                },
-            };
-            if (p.external_deposit_guards && Array.isArray(p.external_deposit_guards) && p.external_deposit_guards.length > 0) {
-                result.external_deposit_guard = {
-                    op: "add",
-                    guards: p.external_deposit_guards.map(g => ({
-                        guard: g,
-                        identifier: null,
-                        store_from_id: p.store_from_id_index !== undefined ? p.store_from_id_index : null,
-                    })),
-                };
-            }
-            if (p.external_withdraw_guards && Array.isArray(p.external_withdraw_guards) && p.external_withdraw_guards.length > 0) {
-                if (p.withdraw_identifier_index === undefined) {
-                    throw new Error("withdraw_identifier_index is REQUIRED when external_withdraw_guards is specified (u8, not Option)");
-                }
-                result.external_withdraw_guard = {
-                    op: "add",
-                    guards: p.external_withdraw_guards.map(g => ({
-                        guard: g,
-                        identifier: p.withdraw_identifier_index,
-                        store_from_id: p.store_from_id_index !== undefined ? p.store_from_id_index : null,
-                    })),
-                };
-            }
-            return result;
-        },
-        notes: [
-            "Asymmetric identifier: deposit=Option<u8> (null OK), withdraw=u8 (REQUIRED)",
-            "Pair with Guard objects that have appropriate table fields (number-type for identifier, address-compatible for store_from_id)",
-            "External operations bypass Permission; ensure Guard rules are correctly configured",
-            "Use T-T-04 style for Service-shared Permission if needed",
-        ],
-    },
-    {
-        id: "T-T-04",
-        name: "Service-shared Treasury (shared Permission with Service)",
-        description: "Treasury that shares its Permission object with a Service. Single admin team manages both Service and Treasury operations.",
-        applicable_scenes: ["treasury_permission_sharing"],
-        industry_tags: ["service", "retail", "ecommerce"],
-        params: [
-            { name: "treasury_name", type: "string", description: "Name for the new Treasury object", required: true },
-            { name: "owner_address", type: "address", description: "Owner address (Service and Treasury share owner)", required: true },
-            { name: "coin_type", type: "coin_type", description: "Coin type T", required: true },
-            { name: "description", type: "string", description: "Treasury description", required: true },
-            { name: "existing_permission_address", type: "address", description: "Existing Permission object address (already applied to Service)", required: true },
-            { name: "service_address", type: "address", description: "Service object address that shares this Permission", required: false },
-        ],
-        body: (p) => ({
-            object: {
-                name: p.treasury_name,
-                type_parameter: p.coin_type,
-                permission: p.existing_permission_address,
-            },
-            description: p.description,
-            _permission_config: {
-                _note: "Permission shared with Service; do NOT reconfigure indexes 300-320 (Service range)",
-                TREASURY_DEPOSIT: [p.owner_address],
-                TREASURY_RECEIVE: [p.owner_address],
-                TREASURY_WITHDRAW: [p.owner_address],
-                TREASURY_OWNER_RECEIVE: [p.owner_address],
-            },
-            _integration: {
-                service: p.service_address ?? "(specify service_address)",
-                flow: "Service collects payments → Allocator splits → Treasury.receive (253) → balance",
-            },
-        }),
-        notes: [
-            "Shares Permission with an existing Service; admin changes affect both objects",
-            "Verify Permission indexes 250-258 (Treasury) and 300-320 (Service) are assigned to intended entities",
-            "Use this when a single business unit operates both a Service storefront and a Treasury fund pool",
-        ],
-    },
-    {
-        id: "T-T-05",
-        name: "Allocation fund-pool Treasury (referenced by Allocator)",
-        description: "Treasury configured as Allocation's sharing.who=Entity target. Receives automated fund splits from Service revenue. Requires TREASURY_RECEIVE (253) for intake.",
-        applicable_scenes: ["treasury_fund_collection", "treasury_permission_sharing"],
-        industry_tags: ["service", "ecommerce", "marketplace"],
-        params: [
-            { name: "treasury_name", type: "string", description: "Name for the new Treasury object", required: true },
-            { name: "owner_address", type: "address", description: "Owner address (Service owner)", required: true },
-            { name: "receiver_address", type: "address", description: "Address allowed to call receive (253) for CoinWrapper intake", required: true },
-            { name: "coin_type", type: "coin_type", description: "Coin type T (must match Service coin type)", required: true },
-            { name: "description", type: "string", description: "Treasury description", required: true },
-            { name: "permission_name", type: "string", description: "Name for the new Permission object", required: true },
-            { name: "allocator_address", type: "address", description: "Allocator object address (references this Treasury as Entity target)", required: false },
-        ],
-        body: (p) => ({
-            object: {
-                name: p.treasury_name,
-                type_parameter: p.coin_type,
-                permission: {
-                    name: p.permission_name,
-                    description: `Permission for ${p.treasury_name} (Allocation target)`,
-                },
-            },
-            description: p.description,
-            _permission_config: {
-                TREASURY_RECEIVE: [p.receiver_address],
-                TREASURY_OWNER_RECEIVE: [p.owner_address],
-                TREASURY_WITHDRAW: [p.owner_address],
-            },
-            _integration: {
-                allocator: p.allocator_address ?? "(specify allocator_address)",
-                flow: "Service.payment → Allocator.alloc → CoinWrapper to Treasury → Treasury.receive (253) → balance",
-                _note: "Without TREASURY_RECEIVE (253) granted, CoinWrapper will accumulate without entering balance",
-            },
-        }),
-        notes: [
-            "CRITICAL: TREASURY_RECEIVE (253) must be granted to a trusted operator for regular intake",
-            "Configure a scheduled job to call receive periodically (e.g., daily) to convert CoinWrapper to balance",
-            "Allocator's sharing.who=Entity must point to this Treasury's address",
-            "Pair with guard template tpl_allocator_treasury_personal if needed",
-        ],
-    },
-    {
-        id: "T-T-06",
-        name: "Receivable Treasury (deposit + owner_receive only)",
-        description: "Minimal Treasury that only accepts deposits and forwards received assets to Permission owner via owner_receive. No withdraw role. Suitable for fee sinks or donation pools.",
-        applicable_scenes: ["treasury_fund_collection", "treasury_owner_receive"],
-        industry_tags: ["universal", "fee_sink", "donation"],
-        params: [
-            { name: "treasury_name", type: "string", description: "Name for the new Treasury object", required: true },
-            { name: "owner_address", type: "address", description: "Owner address (receives forwarded assets)", required: true },
-            { name: "depositor_addresses", type: "string[]", description: "Addresses allowed to deposit (TREASURY_DEPOSIT=252)", required: true },
-            { name: "coin_type", type: "coin_type", description: "Coin type T", required: true },
-            { name: "description", type: "string", description: "Treasury description", required: true },
-            { name: "permission_name", type: "string", description: "Name for the new Permission object", required: true },
-        ],
-        body: (p) => ({
-            object: {
-                name: p.treasury_name,
-                type_parameter: p.coin_type,
-                permission: {
-                    name: p.permission_name,
-                    description: `Permission for ${p.treasury_name} (receivable-only)`,
-                },
-            },
-            description: p.description,
-            _permission_config: {
-                TREASURY_DEPOSIT: p.depositor_addresses,
-                TREASURY_RECEIVE: [p.owner_address],
-                TREASURY_OWNER_RECEIVE: [p.owner_address],
-            },
-            _workflow: {
-                step_1: "Depositors call treasury.deposit (252) to add funds",
-                step_2: "Owner calls treasury.receive (253) to convert any CoinWrapper to balance",
-                step_3: "Owner calls treasury.owner_receive (257) to forward balance to owner address",
-                _note: "No withdraw path; owner_receive is the only fund exit",
-            },
-        }),
-        notes: [
-            "No TREASURY_WITHDRAW (254) granted; funds exit only via owner_receive (257)",
-            "owner_receive does NOT write to history; rely on Payment records for audit",
-            "Suitable for fee sinks, donation pools, or auto-forwarding revenue",
-        ],
-    },
-    {
-        id: "T-T-07",
-        name: "Exception Compensation Treasury (scene-bound Payment withdraw)",
-        description: "Treasury for exception branch compensation: withdraws create scene-bound Payments with for_object + for_guard + index binding. Enables auto-compensation for delays, defects, or service exceptions.",
-        applicable_scenes: ["treasury_fund_collection", "treasury_um_delegation"],
-        industry_tags: ["retail", "travel", "rental", "freelance", "ecommerce"],
-        params: [
-            { name: "treasury_name", type: "string", description: "Name for the new Treasury object", required: true },
-            { name: "owner_address", type: "address", description: "Owner address (service provider, becomes admin)", required: true },
-            { name: "coin_type", type: "coin_type", description: "Coin type T (e.g. 0x2::wow::WOW)", required: true },
-            { name: "description", type: "string", description: "Treasury description (e.g., 'Compensation fund for delivery delays')", required: true },
-            { name: "permission_name", type: "string", description: "Name for the new Permission object", required: true },
-            { name: "withdrawer_address", type: "address", description: "Address authorized to withdraw compensations (can be same as owner)", required: true },
-            { name: "external_withdraw_guard", type: "address", description: "Guard address for external_withdraw (verifies exception conditions + Payment binding)", required: true },
-        ],
-        body: (p) => ({
-            object: {
-                name: p.treasury_name,
-                type_parameter: p.coin_type,
-                permission: {
-                    name: p.permission_name,
-                    description: `Permission for ${p.treasury_name}`,
-                    indexes: [
-                        { index: 253, name: "TREASURY_DEPOSIT", mark: p.owner_address, description: "Owner deposits funds" },
-                        { index: 254, name: "TREASURY_WITHDRAW", mark: p.withdrawer_address, description: "Withdraw for exception compensation (creates scene-bound Payment)" },
-                        { index: 256, name: "TREASURY_EXTERNAL_WITHDRAW", mark: p.withdrawer_address, description: "External withdraw with guard (verifies exception + Payment binding)" },
-                        { index: 257, name: "TREASURY_OWNER_RECEIVE", mark: p.owner_address, description: "Owner receives remaining funds" },
-                    ],
-                },
-            },
-            description: p.description,
-        }),
-        notes: [
-            "VERIFIED: treasury.move#L249-264 (withdraw creates Payment via payment::new_singleton + from_object_set)",
-            "VERIFIED: treasury.move#L415-418 (withdraw<T> sends to recipient with PaymentInfo)",
-            "Payment created has PaymentInfo(for_object=order, for_guard=exception_guard, index=current_progress)",
-            "ANTI-REUSE: for_object + for_guard + index binds Payment to specific context (payment.move#L66-71)",
-            "VERIFIER-EVIDENCE: customer submits Payment via Passport, Guard verifies binding fields match",
-            "Use with tpl_payment_exception_compensation (guard-templates.ts) for the exception branch guard",
-            "Suitable for: delivery delay compensation, defect refund, service-level agreement penalties",
-        ],
-    },
-];
-export const TREASURY_TEMPLATES_VERSION = "1.0.0";
-export function getAllTreasuryTemplates() {
-    return [...TREASURY_TEMPLATES];
-}
-export function getTemplateById(id) {
-    return TREASURY_TEMPLATES.find(t => t.id === id);
-}
-export function getTemplatesByScene(sceneId) {
-    return TREASURY_TEMPLATES.filter(t => t.applicable_scenes.includes(sceneId));
-}
-export function getTemplatesByIndustry(industry) {
-    return TREASURY_TEMPLATES.filter(t => t.industry_tags.includes(industry) || t.industry_tags.includes("universal"));
-}
-export function suggestTemplateForScene(sceneId) {
-    const matches = getTemplatesByScene(sceneId);
-    return matches.length > 0 ? matches[0] : undefined;
-}
-export function listTemplates() {
-    return TREASURY_TEMPLATES.map(t => ({
-        id: t.id,
-        name: t.name,
-        description: t.description,
-        scenes: t.applicable_scenes,
-    }));
-}
-export function fillTemplate(templateId, params) {
-    const tpl = getTemplateById(templateId);
-    if (!tpl)
-        return { ok: false, error: `Template ${templateId} not found` };
-    for (const p of tpl.params) {
-        if (p.required && !(p.name in params)) {
-            return { ok: false, error: `Missing required param: ${p.name}` };
-        }
-    }
-    try {
-        return { ok: true, body: tpl.body(params) };
-    }
-    catch (e) {
-        return { ok: false, error: `Template body execution failed: ${e.message}` };
-    }
-}
+export const TREASURY_TEMPLATES=[{'id':'T-T-01','name':'Basic\x20Treasury\x20(owner-only\x20deposit/withdraw)','description':'Single-owner\x20Treasury\x20with\x20no\x20external\x20Guard.\x20Owner\x20has\x20all\x20permissions.\x20Suitable\x20for\x20solo\x20operators\x20or\x20simple\x20team\x20funds.','applicable_scenes':['treasury_fund_collection','treasury_um_delegation'],'industry_tags':['universal','solo'],'params':[{'name':'treasury_name','type':'string','description':'Name\x20for\x20the\x20new\x20Treasury\x20object','required':!![]},{'name':'owner_address','type':'address','description':'Owner\x20address\x20(becomes\x20admin)','required':!![]},{'name':'coin_type','type':'coin_type','description':'Coin\x20type\x20T\x20(e.g.\x200x2::wow::WOW)','required':!![]},{'name':'description','type':'string','description':'Treasury\x20description','required':!![]},{'name':'permission_name','type':'string','description':'Name\x20for\x20the\x20new\x20Permission\x20object','required':!![]}],'body':a=>({'object':{'name':a['treasury_name'],'type_parameter':a['coin_type'],'permission':{'name':a['permission_name'],'description':'Permission\x20for\x20'+a['treasury_name']}},'description':a['description'],'_permission_config':{'TREASURY_NEW':[a['owner_address']],'TREASURY_DESCRIPTION':[a['owner_address']],'TREASURY_DEPOSIT':[a['owner_address']],'TREASURY_RECEIVE':[a['owner_address']],'TREASURY_WITHDRAW':[a['owner_address']],'TREASURY_OWNER_RECEIVE':[a['owner_address']],'TREASURY_UM':[a['owner_address']]}}),'notes':['All\x20permissions\x20granted\x20to\x20owner\x20only;\x20suitable\x20for\x20solo\x20treasury','No\x20external\x20Guard\x20configured;\x20all\x20deposits/withdraws\x20via\x20Permission','To\x20enable\x20external\x20operations\x20later,\x20use\x20T-T-03\x20pattern']},{'id':'T-T-02','name':'Multi-role\x20Treasury\x20(separated\x20depositor/withdrawer)','description':'Treasury\x20with\x20separated\x20depositor\x20and\x20withdrawer\x20roles.\x20Enforces\x20separation\x20of\x20duties.\x20Suitable\x20for\x20project\x20budget\x20management.','applicable_scenes':['treasury_fund_collection','treasury_permission_sharing'],'industry_tags':['universal','team','project'],'params':[{'name':'treasury_name','type':'string','description':'Name\x20for\x20the\x20new\x20Treasury\x20object','required':!![]},{'name':'owner_address','type':'address','description':'Owner\x20address\x20(full\x20control)','required':!![]},{'name':'depositor_addresses','type':'string[]','description':'Addresses\x20allowed\x20to\x20deposit\x20(TREASURY_DEPOSIT=252)','required':!![]},{'name':'withdrawer_addresses','type':'string[]','description':'Addresses\x20allowed\x20to\x20withdraw\x20(TREASURY_WITHDRAW=254)','required':!![]},{'name':'receiver_address','type':'address','description':'Address\x20allowed\x20to\x20receive\x20CoinWrapper\x20(TREASURY_RECEIVE=253)','required':!![]},{'name':'coin_type','type':'coin_type','description':'Coin\x20type\x20T','required':!![]},{'name':'description','type':'string','description':'Treasury\x20description','required':!![]},{'name':'permission_name','type':'string','description':'Name\x20for\x20the\x20new\x20Permission\x20object','required':!![]}],'body':a=>({'object':{'name':a['treasury_name'],'type_parameter':a['coin_type'],'permission':{'name':a['permission_name'],'description':'Permission\x20for\x20'+a['treasury_name']+'\x20(multi-role)'}},'description':a['description'],'_permission_config':{'TREASURY_NEW':[a['owner_address']],'TREASURY_DESCRIPTION':[a['owner_address']],'TREASURY_DEPOSIT':a['depositor_addresses'],'TREASURY_RECEIVE':[a['receiver_address']],'TREASURY_WITHDRAW':a['withdrawer_addresses'],'TREASURY_OWNER_RECEIVE':[a['owner_address']],'TREASURY_UM':[a['owner_address']]}}),'notes':['Separation\x20of\x20duties:\x20deposit\x20and\x20withdraw\x20roles\x20assigned\x20to\x20different\x20addresses','Use\x20distinct\x20addresses\x20for\x20depositor_addresses\x20and\x20withdrawer_addresses','Owner\x20retains\x20full\x20control\x20(um_set,\x20owner_receive,\x20description_set)']},{'id':'T-T-03','name':'External\x20operations\x20Treasury\x20(with\x20Guard\x20protection)','description':'Treasury\x20with\x20external_deposit_guard\x20and/or\x20external_withdraw_guard\x20configured.\x20Allows\x20external\x20users\x20to\x20deposit/withdraw\x20via\x20Guard\x20+\x20Passport\x20without\x20Permission.','applicable_scenes':['treasury_external_ops','treasury_guard_protection'],'industry_tags':['finance','crowdfunding','refund','compensation'],'params':[{'name':'treasury_name','type':'string','description':'Name\x20for\x20the\x20new\x20Treasury\x20object','required':!![]},{'name':'owner_address','type':'address','description':'Owner\x20address','required':!![]},{'name':'coin_type','type':'coin_type','description':'Coin\x20type\x20T','required':!![]},{'name':'description','type':'string','description':'Treasury\x20description','required':!![]},{'name':'permission_name','type':'string','description':'Name\x20for\x20the\x20new\x20Permission\x20object','required':!![]},{'name':'external_deposit_guards','type':'string[]','description':'Guard\x20addresses/names\x20for\x20external\x20deposit\x20(identifier=Optional)','required':![]},{'name':'external_withdraw_guards','type':'string[]','description':'Guard\x20addresses/names\x20for\x20external\x20withdraw\x20(identifier=Required)','required':![]},{'name':'withdraw_identifier_index','type':'number','description':'Guard\x20table\x20identifier\x20index\x20for\x20withdraw\x20amount\x20(u8,\x20required\x20for\x20withdraw\x20guards)','required':![],'default':0x0},{'name':'store_from_id_index','type':'number','description':'Optional\x20store_from_id\x20index\x20for\x20audit\x20trail','required':![]}],'body':a=>{const b={'object':{'name':a['treasury_name'],'type_parameter':a['coin_type'],'permission':{'name':a['permission_name'],'description':'Permission\x20for\x20'+a['treasury_name']+'\x20(external\x20ops)'}},'description':a['description'],'_permission_config':{'TREASURY_NEW':[a['owner_address']],'TREASURY_EXTERNAL_DEPOSIT_GUARD':[a['owner_address']],'TREASURY_EXTERNAL_WITHDRAW_GUARD':[a['owner_address']],'TREASURY_OWNER_RECEIVE':[a['owner_address']],'TREASURY_UM':[a['owner_address']]}};a['external_deposit_guards']&&Array['isArray'](a['external_deposit_guards'])&&a['external_deposit_guards']['length']>0x0&&(b['external_deposit_guard']={'op':'add','guards':a['external_deposit_guards']['map'](c=>({'guard':c,'identifier':null,'store_from_id':a['store_from_id_index']!==undefined?a['store_from_id_index']:null}))});if(a['external_withdraw_guards']&&Array['isArray'](a['external_withdraw_guards'])&&a['external_withdraw_guards']['length']>0x0){if(a['withdraw_identifier_index']===undefined)throw new Error('withdraw_identifier_index\x20is\x20REQUIRED\x20when\x20external_withdraw_guards\x20is\x20specified\x20(u8,\x20not\x20Option)');b['external_withdraw_guard']={'op':'add','guards':a['external_withdraw_guards']['map'](c=>({'guard':c,'identifier':a['withdraw_identifier_index'],'store_from_id':a['store_from_id_index']!==undefined?a['store_from_id_index']:null}))};}return b;},'notes':['Asymmetric\x20identifier:\x20deposit=Option<u8>\x20(null\x20OK),\x20withdraw=u8\x20(REQUIRED)','Pair\x20with\x20Guard\x20objects\x20that\x20have\x20appropriate\x20table\x20fields\x20(number-type\x20for\x20identifier,\x20address-compatible\x20for\x20store_from_id)','External\x20operations\x20bypass\x20Permission;\x20ensure\x20Guard\x20rules\x20are\x20correctly\x20configured','Use\x20T-T-04\x20style\x20for\x20Service-shared\x20Permission\x20if\x20needed']},{'id':'T-T-04','name':'Service-shared\x20Treasury\x20(shared\x20Permission\x20with\x20Service)','description':'Treasury\x20that\x20shares\x20its\x20Permission\x20object\x20with\x20a\x20Service.\x20Single\x20admin\x20team\x20manages\x20both\x20Service\x20and\x20Treasury\x20operations.','applicable_scenes':['treasury_permission_sharing'],'industry_tags':['service','retail','ecommerce'],'params':[{'name':'treasury_name','type':'string','description':'Name\x20for\x20the\x20new\x20Treasury\x20object','required':!![]},{'name':'owner_address','type':'address','description':'Owner\x20address\x20(Service\x20and\x20Treasury\x20share\x20owner)','required':!![]},{'name':'coin_type','type':'coin_type','description':'Coin\x20type\x20T','required':!![]},{'name':'description','type':'string','description':'Treasury\x20description','required':!![]},{'name':'existing_permission_address','type':'address','description':'Existing\x20Permission\x20object\x20address\x20(already\x20applied\x20to\x20Service)','required':!![]},{'name':'service_address','type':'address','description':'Service\x20object\x20address\x20that\x20shares\x20this\x20Permission','required':![]}],'body':a=>({'object':{'name':a['treasury_name'],'type_parameter':a['coin_type'],'permission':a['existing_permission_address']},'description':a['description'],'_permission_config':{'_note':'Permission\x20shared\x20with\x20Service;\x20do\x20NOT\x20reconfigure\x20indexes\x20300-320\x20(Service\x20range)','TREASURY_DEPOSIT':[a['owner_address']],'TREASURY_RECEIVE':[a['owner_address']],'TREASURY_WITHDRAW':[a['owner_address']],'TREASURY_OWNER_RECEIVE':[a['owner_address']]},'_integration':{'service':a['service_address']??'(specify\x20service_address)','flow':'Service\x20collects\x20payments\x20→\x20Allocator\x20splits\x20→\x20Treasury.receive\x20(253)\x20→\x20balance'}}),'notes':['Shares\x20Permission\x20with\x20an\x20existing\x20Service;\x20admin\x20changes\x20affect\x20both\x20objects','Verify\x20Permission\x20indexes\x20250-258\x20(Treasury)\x20and\x20300-320\x20(Service)\x20are\x20assigned\x20to\x20intended\x20entities','Use\x20this\x20when\x20a\x20single\x20business\x20unit\x20operates\x20both\x20a\x20Service\x20storefront\x20and\x20a\x20Treasury\x20fund\x20pool']},{'id':'T-T-05','name':'Allocation\x20fund-pool\x20Treasury\x20(referenced\x20by\x20Allocator)','description':'Treasury\x20configured\x20as\x20Allocation\x27s\x20sharing.who=Entity\x20target.\x20Receives\x20automated\x20fund\x20splits\x20from\x20Service\x20revenue.\x20Requires\x20TREASURY_RECEIVE\x20(253)\x20for\x20intake.','applicable_scenes':['treasury_fund_collection','treasury_permission_sharing'],'industry_tags':['service','ecommerce','marketplace'],'params':[{'name':'treasury_name','type':'string','description':'Name\x20for\x20the\x20new\x20Treasury\x20object','required':!![]},{'name':'owner_address','type':'address','description':'Owner\x20address\x20(Service\x20owner)','required':!![]},{'name':'receiver_address','type':'address','description':'Address\x20allowed\x20to\x20call\x20receive\x20(253)\x20for\x20CoinWrapper\x20intake','required':!![]},{'name':'coin_type','type':'coin_type','description':'Coin\x20type\x20T\x20(must\x20match\x20Service\x20coin\x20type)','required':!![]},{'name':'description','type':'string','description':'Treasury\x20description','required':!![]},{'name':'permission_name','type':'string','description':'Name\x20for\x20the\x20new\x20Permission\x20object','required':!![]},{'name':'allocator_address','type':'address','description':'Allocator\x20object\x20address\x20(references\x20this\x20Treasury\x20as\x20Entity\x20target)','required':![]}],'body':a=>({'object':{'name':a['treasury_name'],'type_parameter':a['coin_type'],'permission':{'name':a['permission_name'],'description':'Permission\x20for\x20'+a['treasury_name']+'\x20(Allocation\x20target)'}},'description':a['description'],'_permission_config':{'TREASURY_RECEIVE':[a['receiver_address']],'TREASURY_OWNER_RECEIVE':[a['owner_address']],'TREASURY_WITHDRAW':[a['owner_address']]},'_integration':{'allocator':a['allocator_address']??'(specify\x20allocator_address)','flow':'Service.payment\x20→\x20Allocator.alloc\x20→\x20CoinWrapper\x20to\x20Treasury\x20→\x20Treasury.receive\x20(253)\x20→\x20balance','_note':'Without\x20TREASURY_RECEIVE\x20(253)\x20granted,\x20CoinWrapper\x20will\x20accumulate\x20without\x20entering\x20balance'}}),'notes':['CRITICAL:\x20TREASURY_RECEIVE\x20(253)\x20must\x20be\x20granted\x20to\x20a\x20trusted\x20operator\x20for\x20regular\x20intake','Configure\x20a\x20scheduled\x20job\x20to\x20call\x20receive\x20periodically\x20(e.g.,\x20daily)\x20to\x20convert\x20CoinWrapper\x20to\x20balance','Allocator\x27s\x20sharing.who=Entity\x20must\x20point\x20to\x20this\x20Treasury\x27s\x20address','Pair\x20with\x20guard\x20template\x20tpl_allocator_treasury_personal\x20if\x20needed']},{'id':'T-T-06','name':'Receivable\x20Treasury\x20(deposit\x20+\x20owner_receive\x20only)','description':'Minimal\x20Treasury\x20that\x20only\x20accepts\x20deposits\x20and\x20forwards\x20received\x20assets\x20to\x20Permission\x20owner\x20via\x20owner_receive.\x20No\x20withdraw\x20role.\x20Suitable\x20for\x20fee\x20sinks\x20or\x20donation\x20pools.','applicable_scenes':['treasury_fund_collection','treasury_owner_receive'],'industry_tags':['universal','fee_sink','donation'],'params':[{'name':'treasury_name','type':'string','description':'Name\x20for\x20the\x20new\x20Treasury\x20object','required':!![]},{'name':'owner_address','type':'address','description':'Owner\x20address\x20(receives\x20forwarded\x20assets)','required':!![]},{'name':'depositor_addresses','type':'string[]','description':'Addresses\x20allowed\x20to\x20deposit\x20(TREASURY_DEPOSIT=252)','required':!![]},{'name':'coin_type','type':'coin_type','description':'Coin\x20type\x20T','required':!![]},{'name':'description','type':'string','description':'Treasury\x20description','required':!![]},{'name':'permission_name','type':'string','description':'Name\x20for\x20the\x20new\x20Permission\x20object','required':!![]}],'body':a=>({'object':{'name':a['treasury_name'],'type_parameter':a['coin_type'],'permission':{'name':a['permission_name'],'description':'Permission\x20for\x20'+a['treasury_name']+'\x20(receivable-only)'}},'description':a['description'],'_permission_config':{'TREASURY_DEPOSIT':a['depositor_addresses'],'TREASURY_RECEIVE':[a['owner_address']],'TREASURY_OWNER_RECEIVE':[a['owner_address']]},'_workflow':{'step_1':'Depositors\x20call\x20treasury.deposit\x20(252)\x20to\x20add\x20funds','step_2':'Owner\x20calls\x20treasury.receive\x20(253)\x20to\x20convert\x20any\x20CoinWrapper\x20to\x20balance','step_3':'Owner\x20calls\x20treasury.owner_receive\x20(257)\x20to\x20forward\x20balance\x20to\x20owner\x20address','_note':'No\x20withdraw\x20path;\x20owner_receive\x20is\x20the\x20only\x20fund\x20exit'}}),'notes':['No\x20TREASURY_WITHDRAW\x20(254)\x20granted;\x20funds\x20exit\x20only\x20via\x20owner_receive\x20(257)','owner_receive\x20does\x20NOT\x20write\x20to\x20history;\x20rely\x20on\x20Payment\x20records\x20for\x20audit','Suitable\x20for\x20fee\x20sinks,\x20donation\x20pools,\x20or\x20auto-forwarding\x20revenue']},{'id':'T-T-07','name':'Exception\x20Compensation\x20Treasury\x20(scene-bound\x20Payment\x20withdraw)','description':'Treasury\x20for\x20exception\x20branch\x20compensation:\x20withdraws\x20create\x20scene-bound\x20Payments\x20with\x20for_object\x20+\x20for_guard\x20+\x20index\x20binding.\x20Enables\x20auto-compensation\x20for\x20delays,\x20defects,\x20or\x20service\x20exceptions.','applicable_scenes':['treasury_fund_collection','treasury_um_delegation'],'industry_tags':['retail','travel','rental','freelance','ecommerce'],'params':[{'name':'treasury_name','type':'string','description':'Name\x20for\x20the\x20new\x20Treasury\x20object','required':!![]},{'name':'owner_address','type':'address','description':'Owner\x20address\x20(service\x20provider,\x20becomes\x20admin)','required':!![]},{'name':'coin_type','type':'coin_type','description':'Coin\x20type\x20T\x20(e.g.\x200x2::wow::WOW)','required':!![]},{'name':'description','type':'string','description':'Treasury\x20description\x20(e.g.,\x20\x27Compensation\x20fund\x20for\x20delivery\x20delays\x27)','required':!![]},{'name':'permission_name','type':'string','description':'Name\x20for\x20the\x20new\x20Permission\x20object','required':!![]},{'name':'withdrawer_address','type':'address','description':'Address\x20authorized\x20to\x20withdraw\x20compensations\x20(can\x20be\x20same\x20as\x20owner)','required':!![]},{'name':'external_withdraw_guard','type':'address','description':'Guard\x20address\x20for\x20external_withdraw\x20(verifies\x20exception\x20conditions\x20+\x20Payment\x20binding)','required':!![]}],'body':a=>({'object':{'name':a['treasury_name'],'type_parameter':a['coin_type'],'permission':{'name':a['permission_name'],'description':'Permission\x20for\x20'+a['treasury_name'],'indexes':[{'index':0xfd,'name':'TREASURY_DEPOSIT','mark':a['owner_address'],'description':'Owner\x20deposits\x20funds'},{'index':0xfe,'name':'TREASURY_WITHDRAW','mark':a['withdrawer_address'],'description':'Withdraw\x20for\x20exception\x20compensation\x20(creates\x20scene-bound\x20Payment)'},{'index':0x100,'name':'TREASURY_EXTERNAL_WITHDRAW','mark':a['withdrawer_address'],'description':'External\x20withdraw\x20with\x20guard\x20(verifies\x20exception\x20+\x20Payment\x20binding)'},{'index':0x101,'name':'TREASURY_OWNER_RECEIVE','mark':a['owner_address'],'description':'Owner\x20receives\x20remaining\x20funds'}]}},'description':a['description']}),'notes':['VERIFIED:\x20treasury.move#L249-264\x20(withdraw\x20creates\x20Payment\x20via\x20payment::new_singleton\x20+\x20from_object_set)','VERIFIED:\x20treasury.move#L415-418\x20(withdraw<T>\x20sends\x20to\x20recipient\x20with\x20PaymentInfo)','Payment\x20created\x20has\x20PaymentInfo(for_object=order,\x20for_guard=exception_guard,\x20index=current_progress)','ANTI-REUSE:\x20for_object\x20+\x20for_guard\x20+\x20index\x20binds\x20Payment\x20to\x20specific\x20context\x20(payment.move#L66-71)','VERIFIER-EVIDENCE:\x20customer\x20submits\x20Payment\x20via\x20Passport,\x20Guard\x20verifies\x20binding\x20fields\x20match','Use\x20with\x20tpl_payment_exception_compensation\x20(guard-templates.ts)\x20for\x20the\x20exception\x20branch\x20guard','Suitable\x20for:\x20delivery\x20delay\x20compensation,\x20defect\x20refund,\x20service-level\x20agreement\x20penalties']}];export const TREASURY_TEMPLATES_VERSION='1.0.0';export function getAllTreasuryTemplates(){return[...TREASURY_TEMPLATES];}export function getTemplateById(a){return TREASURY_TEMPLATES['find'](b=>b['id']===a);}export function getTemplatesByScene(a){return TREASURY_TEMPLATES['filter'](b=>b['applicable_scenes']['includes'](a));}export function getTemplatesByIndustry(a){return TREASURY_TEMPLATES['filter'](b=>b['industry_tags']['includes'](a)||b['industry_tags']['includes']('universal'));}export function suggestTemplateForScene(a){const b=getTemplatesByScene(a);return b['length']>0x0?b[0x0]:undefined;}export function listTemplates(){return TREASURY_TEMPLATES['map'](a=>({'id':a['id'],'name':a['name'],'description':a['description'],'scenes':a['applicable_scenes']}));}export function fillTemplate(a,b){const c=getTemplateById(a);if(!c)return{'ok':![],'error':'Template\x20'+a+'\x20not\x20found'};for(const d of c['params']){if(d['required']&&!(d['name']in b))return{'ok':![],'error':'Missing\x20required\x20param:\x20'+d['name']};}try{return{'ok':!![],'body':c['body'](b)};}catch(f){return{'ok':![],'error':'Template\x20body\x20execution\x20failed:\x20'+f['message']};}}