@wowok/agent-mcp 2.7.1 → 2.7.3

package/dist/knowledge/allocation-templates.js

@@ -1,970 +1 @@
-export const ALLOCATION_TEMPLATES = [
-    {
-        id: "T-A-01",
-        name: "Single Rate 100% to Treasury",
-        description: "Simplest allocation — single Allocator, single Rate=10000 sharing to one Treasury/personal address",
-        applicable_scenes: ["allocation_merchant_full_payment"],
-        industry_tags: ["universal", "retail", "service"],
-        params: [
-            {
-                name: "allocation_name",
-                type: "string",
-                description: "Local name for the new Allocation object",
-                required: true,
-            },
-            {
-                name: "coin_type",
-                type: "string",
-                description: "Coin<T> type string (e.g. '0x2::wow::WOW')",
-                required: true,
-            },
-            {
-                name: "recipient_address",
-                type: "address",
-                description: "Treasury or personal wallet address to receive 100%",
-                required: true,
-            },
-            {
-                name: "guard_address",
-                type: "address",
-                description: "Guard object address (verifies order completion)",
-                required: true,
-            },
-            {
-                name: "description",
-                type: "string",
-                description: "Allocation description",
-                required: false,
-                default: "Single Rate 100% allocation",
-            },
-        ],
-        body: (p) => ({
-            object: { name: p.allocation_name, type_parameter: p.coin_type },
-            allocators: {
-                description: p.description ?? "Single Rate 100% allocation",
-                threshold: "0",
-                allocators: [
-                    {
-                        guard: p.guard_address,
-                        sharing: [
-                            {
-                                who: { Entity: p.recipient_address },
-                                sharing: "10000",
-                                mode: "Rate",
-                            },
-                        ],
-                        max: null,
-                    },
-                ],
-            },
-            coin: { name: `${p.allocation_name}_coin` },
-            payment_info: {},
-        }),
-        notes: [
-            "Simplest configuration — no multi-party coordination",
-            "Guard only needs to verify order status, no complex conditions",
-            "Suitable for solo merchants or single-treasury services",
-        ],
-    },
-    {
-        id: "T-A-02",
-        name: "Standard 3-way Rate split",
-        description: "Three-way split: merchant / platform / logistics. Pure Rate mode, sum(rates) MUST equal 10000",
-        applicable_scenes: ["allocation_standard_three_way_split"],
-        industry_tags: ["retail", "ecommerce", "logistics"],
-        params: [
-            {
-                name: "allocation_name",
-                type: "string",
-                description: "Local name for the new Allocation object",
-                required: true,
-            },
-            {
-                name: "coin_type",
-                type: "string",
-                description: "Coin<T> type string",
-                required: true,
-            },
-            {
-                name: "merchant_treasury",
-                type: "address",
-                description: "Merchant Treasury address",
-                required: true,
-            },
-            {
-                name: "platform_treasury",
-                type: "address",
-                description: "Platform Treasury address",
-                required: true,
-            },
-            {
-                name: "logistics_treasury",
-                type: "address",
-                description: "Logistics Treasury address (set to platform_treasury if N/A)",
-                required: true,
-            },
-            {
-                name: "merchant_rate",
-                type: "number",
-                description: "Merchant rate in basis points (e.g. 8000 = 80%)",
-                required: true,
-                default: 8000,
-            },
-            {
-                name: "platform_rate",
-                type: "number",
-                description: "Platform rate in basis points (e.g. 1000 = 10%)",
-                required: true,
-                default: 1000,
-            },
-            {
-                name: "logistics_rate",
-                type: "number",
-                description: "Logistics rate in basis points (e.g. 1000 = 10%)",
-                required: true,
-                default: 1000,
-            },
-            {
-                name: "guard_address",
-                type: "address",
-                description: "Guard object address (verifies order completion + service binding)",
-                required: true,
-            },
-        ],
-        body: (p) => {
-            const merchantRate = Number(p.merchant_rate);
-            const platformRate = Number(p.platform_rate);
-            const logisticsRate = Number(p.logistics_rate);
-            const total = merchantRate + platformRate + logisticsRate;
-            if (total !== 10000) {
-                throw new Error(`T-A-02: sum(rates) MUST equal 10000 (RATE_TOTAL_FULL), got ${total} ` +
-                    `(merchant=${merchantRate} + platform=${platformRate} + logistics=${logisticsRate})`);
-            }
-            return {
-                object: { name: p.allocation_name, type_parameter: p.coin_type },
-                allocators: {
-                    description: `3-way split: merchant ${merchantRate}/10000, platform ${platformRate}/10000, logistics ${logisticsRate}/10000`,
-                    threshold: "0",
-                    allocators: [
-                        {
-                            guard: p.guard_address,
-                            sharing: [
-                                { who: { Entity: p.merchant_treasury }, sharing: String(merchantRate), mode: "Rate" },
-                                { who: { Entity: p.platform_treasury }, sharing: String(platformRate), mode: "Rate" },
-                                { who: { Entity: p.logistics_treasury }, sharing: String(logisticsRate), mode: "Rate" },
-                            ],
-                            max: null,
-                        },
-                    ],
-                },
-                coin: { name: `${p.allocation_name}_coin` },
-                payment_info: {},
-            };
-        },
-        notes: [
-            "F-A-05: sum(rates) MUST equal 10000 (pure Rate mode, no Surplus)",
-            "Treasury Permission should match Service Permission (R-A-3-02)",
-            "Guard should verify order.service binding (query 1563) to prevent cross-project bypass",
-        ],
-    },
-    {
-        id: "T-A-03",
-        name: "Refund-first + Surplus-to-merchant (Amount + Surplus hybrid)",
-        description: "Single Allocator with 2 sharing items: Amount=refund_value to customer, Surplus to merchant",
-        applicable_scenes: ["allocation_refund_first_surplus_to_merchant"],
-        industry_tags: ["retail", "refund", "customer_protection"],
-        params: [
-            {
-                name: "allocation_name",
-                type: "string",
-                description: "Local name for the new Allocation object",
-                required: true,
-            },
-            {
-                name: "coin_type",
-                type: "string",
-                description: "Coin<T> type string",
-                required: true,
-            },
-            {
-                name: "customer_address",
-                type: "address",
-                description: "Customer address to receive refund Amount",
-                required: true,
-            },
-            {
-                name: "merchant_treasury",
-                type: "address",
-                description: "Merchant Treasury address to receive Surplus",
-                required: true,
-            },
-            {
-                name: "refund_amount",
-                type: "number",
-                description: "Refund amount in smallest coin unit (e.g. MIST for WOW)",
-                required: true,
-            },
-            {
-                name: "guard_address",
-                type: "address",
-                description: "Guard object address (verifies refund approval)",
-                required: true,
-            },
-            {
-                name: "description",
-                type: "string",
-                description: "Allocation description",
-                required: false,
-                default: "Refund-first + Surplus-to-merchant",
-            },
-        ],
-        body: (p) => {
-            const refundAmount = Number(p.refund_amount);
-            if (refundAmount <= 0) {
-                throw new Error(`T-A-03: refund_amount MUST be > 0, got ${refundAmount}`);
-            }
-            return {
-                object: { name: p.allocation_name, type_parameter: p.coin_type },
-                allocators: {
-                    description: p.description ?? "Refund-first + Surplus-to-merchant",
-                    threshold: String(refundAmount),
-                    allocators: [
-                        {
-                            guard: p.guard_address,
-                            sharing: [
-                                {
-                                    who: { Entity: p.customer_address },
-                                    sharing: String(refundAmount),
-                                    mode: "Amount",
-                                },
-                                {
-                                    who: { Entity: p.merchant_treasury },
-                                    sharing: "0",
-                                    mode: "Surplus",
-                                },
-                            ],
-                            max: null,
-                        },
-                    ],
-                },
-                coin: { name: `${p.allocation_name}_coin` },
-                payment_info: {},
-            };
-        },
-        notes: [
-            "F-A-04: at most 1 Surplus per Allocator (✓ single Surplus here)",
-            "F-A-07: threshold = refundAmount (ensure balance covers Amount)",
-            "fix is cached as refundAmount at allocator_add time",
-            "Guard must verify customer refund eligibility (e.g. order status = Refunded)",
-        ],
-    },
-    {
-        id: "T-A-04",
-        name: "Treasury + Personal alternative (caller-specified guard, 2 Allocators)",
-        description: "2 Allocators as alternative strategies: caller selects Treasury or Personal wallet via alloc_by_guard (hard verification per call)",
-        applicable_scenes: ["allocation_treasury_personal_alternatives"],
-        industry_tags: ["universal", "alternative", "treasury"],
-        params: [
-            {
-                name: "allocation_name",
-                type: "string",
-                description: "Local name for the new Allocation object",
-                required: true,
-            },
-            {
-                name: "coin_type",
-                type: "string",
-                description: "Coin<T> type string",
-                required: true,
-            },
-            {
-                name: "treasury_address",
-                type: "address",
-                description: "Treasury address (primary recipient)",
-                required: true,
-            },
-            {
-                name: "personal_address",
-                type: "address",
-                description: "Personal wallet address (alternative recipient)",
-                required: true,
-            },
-            {
-                name: "treasury_guard",
-                type: "address",
-                description: "Guard for Treasury path (verifies treasury operational)",
-                required: true,
-            },
-            {
-                name: "personal_guard",
-                type: "address",
-                description: "Guard for Personal path (verifies personal wallet active) — MUST differ from treasury_guard",
-                required: true,
-            },
-        ],
-        body: (p) => {
-            if (p.treasury_guard === p.personal_guard) {
-                throw new Error(`T-A-04: treasury_guard and personal_guard MUST be different addresses (F-A-14: allocators[].guard must be unique)`);
-            }
-            return {
-                object: { name: p.allocation_name, type_parameter: p.coin_type },
-                allocators: {
-                    description: "Treasury / Personal alternative (caller-specified guard)",
-                    threshold: "0",
-                    allocators: [
-                        {
-                            guard: p.treasury_guard,
-                            sharing: [
-                                { who: { Entity: p.treasury_address }, sharing: "10000", mode: "Rate" },
-                            ],
-                            max: null,
-                        },
-                        {
-                            guard: p.personal_guard,
-                            sharing: [
-                                { who: { Entity: p.personal_address }, sharing: "10000", mode: "Rate" },
-                            ],
-                            max: null,
-                        },
-                    ],
-                },
-                coin: { name: `${p.allocation_name}_coin` },
-                payment_info: {},
-            };
-        },
-        notes: [
-            "F-A-14: treasury_guard != personal_guard (Allocator Guards must be unique)",
-            "caller-specified guard: alloc_by_guard explicitly selects an Allocator; passport::result_for_guard hard-verifies (failure aborts E_VERIFY_FAILED)",
-            "No auto-fallback: on verification failure the caller must switch guard and retry",
-            "R-A-4-02: if the caller's submitted Passport satisfies both Guards simultaneously, the caller may freely choose between the two paths (mutual exclusion is a design clarity recommendation, not a correctness requirement)",
-        ],
-    },
-    {
-        id: "T-A-05",
-        name: "Tiered by order amount (mutually exclusive Guard conditions)",
-        description: "2 Allocators triggered by mutually exclusive Guard conditions (small order vs large order)",
-        applicable_scenes: ["allocation_tiered_by_order_amount"],
-        industry_tags: ["retail", "tiered_pricing", "volume_discount"],
-        params: [
-            {
-                name: "allocation_name",
-                type: "string",
-                description: "Local name for the new Allocation object",
-                required: true,
-            },
-            {
-                name: "coin_type",
-                type: "string",
-                description: "Coin<T> type string",
-                required: true,
-            },
-            {
-                name: "merchant_treasury",
-                type: "address",
-                description: "Merchant Treasury address",
-                required: true,
-            },
-            {
-                name: "platform_treasury",
-                type: "address",
-                description: "Platform Treasury address",
-                required: true,
-            },
-            {
-                name: "small_order_guard",
-                type: "address",
-                description: "Guard verifying order.amount < threshold (small order path)",
-                required: true,
-            },
-            {
-                name: "large_order_guard",
-                type: "address",
-                description: "Guard verifying order.amount >= threshold (large order path) — MUST differ from small_order_guard",
-                required: true,
-            },
-            {
-                name: "small_order_merchant_rate",
-                type: "number",
-                description: "Merchant rate for small orders (e.g. 10000 = 100%)",
-                required: true,
-                default: 10000,
-            },
-            {
-                name: "large_order_merchant_rate",
-                type: "number",
-                description: "Merchant rate for large orders (e.g. 8000 = 80%)",
-                required: true,
-                default: 8000,
-            },
-            {
-                name: "large_order_platform_rate",
-                type: "number",
-                description: "Platform rate for large orders (e.g. 2000 = 20%)",
-                required: true,
-                default: 2000,
-            },
-        ],
-        body: (p) => {
-            if (p.small_order_guard === p.large_order_guard) {
-                throw new Error(`T-A-05: small_order_guard and large_order_guard MUST be different addresses (F-A-14)`);
-            }
-            const smallRate = Number(p.small_order_merchant_rate);
-            if (smallRate !== 10000) {
-                throw new Error(`T-A-05: small_order_merchant_rate MUST equal 10000 (pure Rate, no Surplus in this Allocator), got ${smallRate}`);
-            }
-            const largeMerchantRate = Number(p.large_order_merchant_rate);
-            const largePlatformRate = Number(p.large_order_platform_rate);
-            const largeTotal = largeMerchantRate + largePlatformRate;
-            if (largeTotal !== 10000) {
-                throw new Error(`T-A-05: large_order rates MUST sum to 10000, got ${largeTotal} (merchant=${largeMerchantRate} + platform=${largePlatformRate})`);
-            }
-            return {
-                object: { name: p.allocation_name, type_parameter: p.coin_type },
-                allocators: {
-                    description: "Tiered by order amount: small=100% merchant, large=80/20 merchant/platform",
-                    threshold: "0",
-                    allocators: [
-                        {
-                            guard: p.small_order_guard,
-                            sharing: [
-                                { who: { Entity: p.merchant_treasury }, sharing: "10000", mode: "Rate" },
-                            ],
-                            max: null,
-                        },
-                        {
-                            guard: p.large_order_guard,
-                            sharing: [
-                                { who: { Entity: p.merchant_treasury }, sharing: String(largeMerchantRate), mode: "Rate" },
-                                { who: { Entity: p.platform_treasury }, sharing: String(largePlatformRate), mode: "Rate" },
-                            ],
-                            max: null,
-                        },
-                    ],
-                },
-                coin: { name: `${p.allocation_name}_coin` },
-                payment_info: {},
-            };
-        },
-        notes: [
-            "Guard conditions MUST be mutually exclusive (R-A-4-02)",
-            "Sequence-sensitive: strict condition (small order) first, relaxed condition (large order) last",
-            "Guard queries order.amount (query 1561) to determine which Allocator fires",
-            "If neither Guard passes, funds are silently locked (R-A-4-02)",
-        ],
-    },
-    {
-        id: "T-A-06",
-        name: "Dynamic recipient via GuardIdentifier (referrer from Passport)",
-        description: "Single Allocator with 3 Rate sharing items, one recipient resolved from customer's Passport table[0]",
-        applicable_scenes: ["allocation_dynamic_recipient"],
-        industry_tags: ["referral", "affiliate", "marketing"],
-        params: [
-            {
-                name: "allocation_name",
-                type: "string",
-                description: "Local name for the new Allocation object",
-                required: true,
-            },
-            {
-                name: "coin_type",
-                type: "string",
-                description: "Coin<T> type string",
-                required: true,
-            },
-            {
-                name: "merchant_treasury",
-                type: "address",
-                description: "Merchant Treasury address",
-                required: true,
-            },
-            {
-                name: "platform_treasury",
-                type: "address",
-                description: "Platform Treasury address",
-                required: true,
-            },
-            {
-                name: "guard_address",
-                type: "address",
-                description: "Guard object address (must be configured with identifier=0 as address type)",
-                required: true,
-            },
-            {
-                name: "passport_identifier",
-                type: "number",
-                description: "Passport table identifier (u8, 0-255) — customer submits referrer address at this slot",
-                required: true,
-                default: 0,
-            },
-            {
-                name: "merchant_rate",
-                type: "number",
-                description: "Merchant rate in basis points (e.g. 8000 = 80%)",
-                required: true,
-                default: 8000,
-            },
-            {
-                name: "platform_rate",
-                type: "number",
-                description: "Platform rate in basis points (e.g. 1000 = 10%)",
-                required: true,
-                default: 1000,
-            },
-            {
-                name: "referrer_rate",
-                type: "number",
-                description: "Referrer rate in basis points (e.g. 1000 = 10%)",
-                required: true,
-                default: 1000,
-            },
-        ],
-        body: (p) => {
-            const merchantRate = Number(p.merchant_rate);
-            const platformRate = Number(p.platform_rate);
-            const referrerRate = Number(p.referrer_rate);
-            const total = merchantRate + platformRate + referrerRate;
-            if (total !== 10000) {
-                throw new Error(`T-A-06: sum(rates) MUST equal 10000, got ${total} (merchant=${merchantRate} + platform=${platformRate} + referrer=${referrerRate})`);
-            }
-            const identifier = Number(p.passport_identifier);
-            if (identifier < 0 || identifier > 255) {
-                throw new Error(`T-A-06: passport_identifier MUST be u8 (0-255), got ${identifier}`);
-            }
-            return {
-                object: { name: p.allocation_name, type_parameter: p.coin_type },
-                allocators: {
-                    description: `Dynamic recipient: merchant ${merchantRate}/10000, platform ${platformRate}/10000, referrer ${referrerRate}/10000 (from Passport identifier=${identifier})`,
-                    threshold: "0",
-                    allocators: [
-                        {
-                            guard: p.guard_address,
-                            sharing: [
-                                { who: { Entity: p.merchant_treasury }, sharing: String(merchantRate), mode: "Rate" },
-                                { who: { Entity: p.platform_treasury }, sharing: String(platformRate), mode: "Rate" },
-                                { who: { GuardIdentifier: identifier }, sharing: String(referrerRate), mode: "Rate" },
-                            ],
-                            max: null,
-                        },
-                    ],
-                },
-                coin: { name: `${p.allocation_name}_coin` },
-                payment_info: {},
-            };
-        },
-        notes: [
-            "F-A-13: Passport table[identifier] MUST be address type (else ERECIPIENT_IDENTIFIER_NOT_ADDRESS=1)",
-            "Guard.is_identifier_address(guard, identifier) MUST be true at allocator_add time (else allocator_add fails)",
-            "Customer must submit Passport with referrer address at the specified identifier slot",
-            "Guard should verify Passport completeness before alloc() executes",
-        ],
-    },
-    {
-        id: "T-A-07",
-        name: "Refund to Order (100% to Order object, not personal wallet)",
-        description: "Single Allocator, 1 Rate=10000 sharing to Order object address. Refund funds return to Order for downstream handling.",
-        applicable_scenes: ["allocation_refund_to_order"],
-        industry_tags: ["refund", "customer_protection", "order_lifecycle"],
-        params: [
-            {
-                name: "allocation_name",
-                type: "string",
-                description: "Local name for the new Allocation object",
-                required: true,
-            },
-            {
-                name: "coin_type",
-                type: "string",
-                description: "Coin<T> type string",
-                required: true,
-            },
-            {
-                name: "order_address",
-                type: "address",
-                description: "Order object address (NOT personal wallet) — funds flow back to Order",
-                required: true,
-            },
-            {
-                name: "guard_address",
-                type: "address",
-                description: "Guard object address (verifies customer refund request and eligibility)",
-                required: true,
-            },
-        ],
-        body: (p) => ({
-            object: { name: p.allocation_name, type_parameter: p.coin_type },
-            allocators: {
-                description: "Refund to Order (100% to Order object for downstream handling)",
-                threshold: "0",
-                allocators: [
-                    {
-                        guard: p.guard_address,
-                        sharing: [
-                            {
-                                who: { Entity: p.order_address },
-                                sharing: "10000",
-                                mode: "Rate",
-                            },
-                        ],
-                        max: null,
-                    },
-                ],
-            },
-            coin: { name: `${p.allocation_name}_coin` },
-            payment_info: {},
-        }),
-        notes: [
-            "⚠️ who=Entity MUST be Order object address (not personal address)",
-            "Customer due-diligence rewards this configuration (8-point weight in customer/risk-assessment.ts)",
-            "Refund funds return to Order for downstream handling (e.g. customer withdrawal)",
-            "Guard must verify customer refund eligibility (e.g. dispute resolved in customer's favor)",
-        ],
-    },
-    {
-        id: "T-A-08",
-        name: "Arbitration fees split (arbitrator 80% / platform 20%)",
-        description: "Single Allocator, 2 Rate sharing items. Triggered by Arbitration.fees_alloc (permission 365) or fees_alloc_with_passport.",
-        applicable_scenes: ["allocation_arbitration_fees"],
-        industry_tags: ["arbitration", "dispute", "fees"],
-        params: [
-            {
-                name: "allocation_name",
-                type: "string",
-                description: "Local name for the new Allocation object",
-                required: true,
-            },
-            {
-                name: "coin_type",
-                type: "string",
-                description: "Coin<T> type string (must match Arbitration fee Coin type)",
-                required: true,
-            },
-            {
-                name: "arbitrator_treasury",
-                type: "address",
-                description: "Arbitrator Treasury address",
-                required: true,
-            },
-            {
-                name: "platform_treasury",
-                type: "address",
-                description: "Platform Treasury address",
-                required: true,
-            },
-            {
-                name: "arbitrator_rate",
-                type: "number",
-                description: "Arbitrator rate in basis points (e.g. 8000 = 80%)",
-                required: true,
-                default: 8000,
-            },
-            {
-                name: "platform_rate",
-                type: "number",
-                description: "Platform rate in basis points (e.g. 2000 = 20%)",
-                required: true,
-                default: 2000,
-            },
-            {
-                name: "guard_address",
-                type: "address",
-                description: "Guard object address (verifies Arbitration ruling finalized)",
-                required: true,
-            },
-        ],
-        body: (p) => {
-            const arbRate = Number(p.arbitrator_rate);
-            const platRate = Number(p.platform_rate);
-            const total = arbRate + platRate;
-            if (total !== 10000) {
-                throw new Error(`T-A-08: sum(rates) MUST equal 10000, got ${total} (arbitrator=${arbRate} + platform=${platRate})`);
-            }
-            return {
-                object: { name: p.allocation_name, type_parameter: p.coin_type },
-                allocators: {
-                    description: `Arbitration fees split: arbitrator ${arbRate}/10000, platform ${platRate}/10000`,
-                    threshold: "0",
-                    allocators: [
-                        {
-                            guard: p.guard_address,
-                            sharing: [
-                                { who: { Entity: p.arbitrator_treasury }, sharing: String(arbRate), mode: "Rate" },
-                                { who: { Entity: p.platform_treasury }, sharing: String(platRate), mode: "Rate" },
-                            ],
-                            max: null,
-                        },
-                    ],
-                },
-                coin: { name: `${p.allocation_name}_coin` },
-                payment_info: {},
-            };
-        },
-        notes: [
-            "Triggered by Arbitration.fees_alloc (permission ARBITRATION_FEES_ALLOC=365) or fees_alloc_with_passport",
-            "Independent from Service-order Allocation (this Allocation is not bound to Order)",
-            "payment_info typically reuses Arbitration's payment_info",
-            "Caller MUST hold ARBITRATION_FEES_ALLOC=365 permission",
-        ],
-    },
-    {
-        id: "T-A-09",
-        name: "Standalone periodic split (investment dividends / shared income)",
-        description: "Standalone Allocation with single Allocator, N Rate sharing items to beneficiary wallets. No Service context. Guard provides time-based or signer-based access control.",
-        applicable_scenes: ["allocation_standalone_periodic_split"],
-        industry_tags: ["standalone", "investment", "dividends", "shared_income"],
-        params: [
-            {
-                name: "allocation_name",
-                type: "string",
-                description: "Local name for the new Allocation object",
-                required: true,
-            },
-            {
-                name: "coin_type",
-                type: "string",
-                description: "Coin<T> type string (e.g. '0x2::wow::WOW' or profit token type)",
-                required: true,
-            },
-            {
-                name: "beneficiaries",
-                type: "address[]",
-                description: "Array of beneficiary wallet addresses (NOT Treasury objects — standalone mode has no Service context)",
-                required: true,
-            },
-            {
-                name: "rates",
-                type: "string[]",
-                description: "Array of rates in basis points (e.g. ['5000','3000','2000'] = 50%/30%/20%). MUST sum to 10000.",
-                required: true,
-            },
-            {
-                name: "guard_address",
-                type: "address",
-                description: "Guard object address — MUST bind Signer or verify time-based trigger (R-A-3-04: standalone has no Service-layer access control)",
-                required: true,
-            },
-            {
-                name: "description",
-                type: "string",
-                description: "Allocation description",
-                required: false,
-                default: "Standalone periodic split",
-            },
-        ],
-        body: (p) => {
-            const beneficiaries = p.beneficiaries;
-            const rates = p.rates.map(r => Number(r));
-            if (beneficiaries.length !== rates.length) {
-                throw new Error(`T-A-09: beneficiaries (${beneficiaries.length}) and rates (${rates.length}) MUST have equal length`);
-            }
-            if (beneficiaries.length === 0) {
-                throw new Error(`T-A-09: at least 1 beneficiary required`);
-            }
-            if (beneficiaries.length > 100) {
-                throw new Error(`T-A-09: beneficiaries count ${beneficiaries.length} exceeds MAX_SHARING_COUNT (100)`);
-            }
-            const total = rates.reduce((sum, r) => sum + r, 0);
-            if (total !== 10000) {
-                throw new Error(`T-A-09: sum(rates) MUST equal 10000 (RATE_TOTAL_FULL), got ${total}`);
-            }
-            return {
-                object: { name: p.allocation_name, type_parameter: p.coin_type },
-                allocators: {
-                    description: p.description ?? "Standalone periodic split",
-                    threshold: "0",
-                    allocators: [
-                        {
-                            guard: p.guard_address,
-                            sharing: beneficiaries.map((addr, i) => ({
-                                who: { Entity: addr },
-                                sharing: String(rates[i]),
-                                mode: "Rate",
-                            })),
-                            max: null,
-                        },
-                    ],
-                },
-                coin: { name: `${p.allocation_name}_coin` },
-                payment_info: {},
-            };
-        },
-        notes: [
-            "Standalone mode (§0): no Service/Order/Arbitration context required",
-            "R-A-3-04: Guard MUST bind Signer or verify time-based trigger — no Service-layer access control exists",
-            "F-A-05: sum(rates) MUST equal 10000 (pure Rate mode, no Surplus)",
-            "Caller lifecycle: receive() to deposit funds → alloc() to trigger distribution",
-            "Guard should bind context(Signer)==authorized to prevent unauthorized alloc() calls",
-            "beneficiaries are personal wallets, NOT Treasury objects (no Service context)",
-        ],
-    },
-    {
-        id: "T-A-10",
-        name: "Standalone vesting release (time-locked multi-stage unlock)",
-        description: "Standalone Allocation with N Allocators (default 3 stages), each triggered by a time-locked Guard. Stages 1..N-1 use Amount mode; final stage uses Surplus to drain remaining balance. No Service context.",
-        applicable_scenes: ["allocation_standalone_vesting"],
-        industry_tags: ["standalone", "vesting", "time_lock", "team_tokens"],
-        params: [
-            {
-                name: "allocation_name",
-                type: "string",
-                description: "Local name for the new Allocation object",
-                required: true,
-            },
-            {
-                name: "coin_type",
-                type: "string",
-                description: "Coin<T> type string (vested asset, e.g. locked team tokens)",
-                required: true,
-            },
-            {
-                name: "beneficiary_address",
-                type: "address",
-                description: "Single beneficiary wallet address (vesting recipient)",
-                required: true,
-            },
-            {
-                name: "stage_1_guard",
-                type: "address",
-                description: "Guard for stage 1 (verifies context(Clock).timestamp >= stage_1_unlock)",
-                required: true,
-            },
-            {
-                name: "stage_1_amount",
-                type: "number",
-                description: "Amount to release at stage 1 (smallest coin unit, e.g. MIST)",
-                required: true,
-            },
-            {
-                name: "stage_2_guard",
-                type: "address",
-                description: "Guard for stage 2 (verifies context(Clock).timestamp >= stage_2_unlock) — MUST differ from stage_1_guard",
-                required: true,
-            },
-            {
-                name: "stage_2_amount",
-                type: "number",
-                description: "Amount to release at stage 2 (smallest coin unit)",
-                required: true,
-            },
-            {
-                name: "stage_3_guard",
-                type: "address",
-                description: "Guard for stage 3 (final stage, uses Surplus to drain remaining balance) — MUST differ from stage_1_guard and stage_2_guard",
-                required: true,
-            },
-            {
-                name: "max_cap",
-                type: "number",
-                description: "Maximum cumulative release cap (applied to stages 1 and 2 via max field). Stage 3 uses Surplus so no max needed.",
-                required: false,
-            },
-            {
-                name: "description",
-                type: "string",
-                description: "Allocation description",
-                required: false,
-                default: "Standalone vesting release (3-stage time-locked)",
-            },
-        ],
-        body: (p) => {
-            const guards = [p.stage_1_guard, p.stage_2_guard, p.stage_3_guard];
-            const unique = new Set(guards);
-            if (unique.size !== guards.length) {
-                const dupes = guards.filter((g, i) => guards.indexOf(g) !== i);
-                throw new Error(`T-A-10: stage guards MUST be unique (F-A-14), duplicates: ${dupes.join(", ")}`);
-            }
-            const stage1Amount = Number(p.stage_1_amount);
-            const stage2Amount = Number(p.stage_2_amount);
-            if (stage1Amount <= 0 || stage2Amount <= 0) {
-                throw new Error(`T-A-10: stage_1_amount and stage_2_amount MUST be > 0, got stage1=${stage1Amount}, stage2=${stage2Amount}`);
-            }
-            const totalFix = stage1Amount + stage2Amount;
-            const maxCap = p.max_cap != null ? Number(p.max_cap) : null;
-            if (maxCap !== null && totalFix > maxCap) {
-                throw new Error(`T-A-10: stage_1_amount + stage_2_amount (${totalFix}) MUST be <= max_cap (${maxCap}) — F-A-08 (EAMOUNT_EXCEEDS_MAX)`);
-            }
-            return {
-                object: { name: p.allocation_name, type_parameter: p.coin_type },
-                allocators: {
-                    description: p.description ?? "Standalone vesting release (3-stage time-locked)",
-                    threshold: "0",
-                    allocators: [
-                        {
-                            guard: p.stage_1_guard,
-                            sharing: [
-                                { who: { Entity: p.beneficiary_address }, sharing: String(stage1Amount), mode: "Amount" },
-                            ],
-                            max: maxCap != null ? String(maxCap) : null,
-                        },
-                        {
-                            guard: p.stage_2_guard,
-                            sharing: [
-                                { who: { Entity: p.beneficiary_address }, sharing: String(stage2Amount), mode: "Amount" },
-                            ],
-                            max: maxCap != null ? String(maxCap) : null,
-                        },
-                        {
-                            guard: p.stage_3_guard,
-                            sharing: [
-                                { who: { Entity: p.beneficiary_address }, sharing: "0", mode: "Surplus" },
-                            ],
-                            max: null,
-                        },
-                    ],
-                },
-                coin: { name: `${p.allocation_name}_coin` },
-                payment_info: {},
-            };
-        },
-        notes: [
-            "Standalone mode (§0): no Service/Order/Arbitration context required",
-            "R-A-3-04: Guard time-lock MUST be enforced — no Service-layer access control exists",
-            "F-A-14: stage_1_guard, stage_2_guard, stage_3_guard MUST be unique (duplicate guards are dead code)",
-            "F-A-04: at most 1 Surplus per Allocator (stage 3 uses Surplus to drain remainder)",
-            "F-A-08: stage_1_amount + stage_2_amount MUST be <= max_cap (if max_cap provided)",
-            "R-A-4-01: if caller calls alloc() before stage time-lock expires, alloc() silently returns — caller should check balance==0 after alloc()",
-            "R-A-4-02: Guard conditions SHOULD be mutually exclusive by timestamp (e.g. stage_1: ts<stage_2_unlock, stage_2: stage_2_unlock<=ts<stage_3_unlock, stage_3: ts>=stage_3_unlock)",
-            "Caller lifecycle: receive() to deposit locked tokens → alloc() at each vesting milestone",
-        ],
-    },
-];
-export const ALLOCATION_TEMPLATES_VERSION = "1.0.0";
-export function getAllTemplates() {
-    return [...ALLOCATION_TEMPLATES];
-}
-export function getTemplateById(id) {
-    return ALLOCATION_TEMPLATES.find(t => t.id === id);
-}
-export function getTemplatesByScene(sceneId) {
-    return ALLOCATION_TEMPLATES.filter(t => t.applicable_scenes.includes(sceneId));
-}
-export function getTemplatesByIndustry(industry) {
-    return ALLOCATION_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 ALLOCATION_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: e instanceof Error ? e.message : String(e) };
-    }
-}
+export const ALLOCATION_TEMPLATES=[{'id':'T-A-01','name':'Single\x20Rate\x20100%\x20to\x20Treasury','description':'Simplest\x20allocation\x20—\x20single\x20Allocator,\x20single\x20Rate=10000\x20sharing\x20to\x20one\x20Treasury/personal\x20address','applicable_scenes':['allocation_merchant_full_payment'],'industry_tags':['universal','retail','service'],'params':[{'name':'allocation_name','type':'string','description':'Local\x20name\x20for\x20the\x20new\x20Allocation\x20object','required':!![]},{'name':'coin_type','type':'string','description':'Coin<T>\x20type\x20string\x20(e.g.\x20\x270x2::wow::WOW\x27)','required':!![]},{'name':'recipient_address','type':'address','description':'Treasury\x20or\x20personal\x20wallet\x20address\x20to\x20receive\x20100%','required':!![]},{'name':'guard_address','type':'address','description':'Guard\x20object\x20address\x20(verifies\x20order\x20completion)','required':!![]},{'name':'description','type':'string','description':'Allocation\x20description','required':![],'default':'Single\x20Rate\x20100%\x20allocation'}],'body':a=>({'object':{'name':a['allocation_name'],'type_parameter':a['coin_type']},'allocators':{'description':a['description']??'Single\x20Rate\x20100%\x20allocation','threshold':'0','allocators':[{'guard':a['guard_address'],'sharing':[{'who':{'Entity':a['recipient_address']},'sharing':'10000','mode':'Rate'}],'max':null}]},'coin':{'name':a['allocation_name']+'_coin'},'payment_info':{}}),'notes':['Simplest\x20configuration\x20—\x20no\x20multi-party\x20coordination','Guard\x20only\x20needs\x20to\x20verify\x20order\x20status,\x20no\x20complex\x20conditions','Suitable\x20for\x20solo\x20merchants\x20or\x20single-treasury\x20services']},{'id':'T-A-02','name':'Standard\x203-way\x20Rate\x20split','description':'Three-way\x20split:\x20merchant\x20/\x20platform\x20/\x20logistics.\x20Pure\x20Rate\x20mode,\x20sum(rates)\x20MUST\x20equal\x2010000','applicable_scenes':['allocation_standard_three_way_split'],'industry_tags':['retail','ecommerce','logistics'],'params':[{'name':'allocation_name','type':'string','description':'Local\x20name\x20for\x20the\x20new\x20Allocation\x20object','required':!![]},{'name':'coin_type','type':'string','description':'Coin<T>\x20type\x20string','required':!![]},{'name':'merchant_treasury','type':'address','description':'Merchant\x20Treasury\x20address','required':!![]},{'name':'platform_treasury','type':'address','description':'Platform\x20Treasury\x20address','required':!![]},{'name':'logistics_treasury','type':'address','description':'Logistics\x20Treasury\x20address\x20(set\x20to\x20platform_treasury\x20if\x20N/A)','required':!![]},{'name':'merchant_rate','type':'number','description':'Merchant\x20rate\x20in\x20basis\x20points\x20(e.g.\x208000\x20=\x2080%)','required':!![],'default':0x1f40},{'name':'platform_rate','type':'number','description':'Platform\x20rate\x20in\x20basis\x20points\x20(e.g.\x201000\x20=\x2010%)','required':!![],'default':0x3e8},{'name':'logistics_rate','type':'number','description':'Logistics\x20rate\x20in\x20basis\x20points\x20(e.g.\x201000\x20=\x2010%)','required':!![],'default':0x3e8},{'name':'guard_address','type':'address','description':'Guard\x20object\x20address\x20(verifies\x20order\x20completion\x20+\x20service\x20binding)','required':!![]}],'body':a=>{const b=Number(a['merchant_rate']),c=Number(a['platform_rate']),d=Number(a['logistics_rate']),e=b+c+d;if(e!==0x2710)throw new Error('T-A-02:\x20sum(rates)\x20MUST\x20equal\x2010000\x20(RATE_TOTAL_FULL),\x20got\x20'+e+'\x20'+('(merchant='+b+'\x20+\x20platform='+c+'\x20+\x20logistics='+d+')'));return{'object':{'name':a['allocation_name'],'type_parameter':a['coin_type']},'allocators':{'description':'3-way\x20split:\x20merchant\x20'+b+'/10000,\x20platform\x20'+c+'/10000,\x20logistics\x20'+d+'/10000','threshold':'0','allocators':[{'guard':a['guard_address'],'sharing':[{'who':{'Entity':a['merchant_treasury']},'sharing':String(b),'mode':'Rate'},{'who':{'Entity':a['platform_treasury']},'sharing':String(c),'mode':'Rate'},{'who':{'Entity':a['logistics_treasury']},'sharing':String(d),'mode':'Rate'}],'max':null}]},'coin':{'name':a['allocation_name']+'_coin'},'payment_info':{}};},'notes':['F-A-05:\x20sum(rates)\x20MUST\x20equal\x2010000\x20(pure\x20Rate\x20mode,\x20no\x20Surplus)','Treasury\x20Permission\x20should\x20match\x20Service\x20Permission\x20(R-A-3-02)','Guard\x20should\x20verify\x20order.service\x20binding\x20(query\x201563)\x20to\x20prevent\x20cross-project\x20bypass']},{'id':'T-A-03','name':'Refund-first\x20+\x20Surplus-to-merchant\x20(Amount\x20+\x20Surplus\x20hybrid)','description':'Single\x20Allocator\x20with\x202\x20sharing\x20items:\x20Amount=refund_value\x20to\x20customer,\x20Surplus\x20to\x20merchant','applicable_scenes':['allocation_refund_first_surplus_to_merchant'],'industry_tags':['retail','refund','customer_protection'],'params':[{'name':'allocation_name','type':'string','description':'Local\x20name\x20for\x20the\x20new\x20Allocation\x20object','required':!![]},{'name':'coin_type','type':'string','description':'Coin<T>\x20type\x20string','required':!![]},{'name':'customer_address','type':'address','description':'Customer\x20address\x20to\x20receive\x20refund\x20Amount','required':!![]},{'name':'merchant_treasury','type':'address','description':'Merchant\x20Treasury\x20address\x20to\x20receive\x20Surplus','required':!![]},{'name':'refund_amount','type':'number','description':'Refund\x20amount\x20in\x20smallest\x20coin\x20unit\x20(e.g.\x20MIST\x20for\x20WOW)','required':!![]},{'name':'guard_address','type':'address','description':'Guard\x20object\x20address\x20(verifies\x20refund\x20approval)','required':!![]},{'name':'description','type':'string','description':'Allocation\x20description','required':![],'default':'Refund-first\x20+\x20Surplus-to-merchant'}],'body':a=>{const b=Number(a['refund_amount']);if(b<=0x0)throw new Error('T-A-03:\x20refund_amount\x20MUST\x20be\x20>\x200,\x20got\x20'+b);return{'object':{'name':a['allocation_name'],'type_parameter':a['coin_type']},'allocators':{'description':a['description']??'Refund-first\x20+\x20Surplus-to-merchant','threshold':String(b),'allocators':[{'guard':a['guard_address'],'sharing':[{'who':{'Entity':a['customer_address']},'sharing':String(b),'mode':'Amount'},{'who':{'Entity':a['merchant_treasury']},'sharing':'0','mode':'Surplus'}],'max':null}]},'coin':{'name':a['allocation_name']+'_coin'},'payment_info':{}};},'notes':['F-A-04:\x20at\x20most\x201\x20Surplus\x20per\x20Allocator\x20(✓\x20single\x20Surplus\x20here)','F-A-07:\x20threshold\x20=\x20refundAmount\x20(ensure\x20balance\x20covers\x20Amount)','fix\x20is\x20cached\x20as\x20refundAmount\x20at\x20allocator_add\x20time','Guard\x20must\x20verify\x20customer\x20refund\x20eligibility\x20(e.g.\x20order\x20status\x20=\x20Refunded)']},{'id':'T-A-04','name':'Treasury\x20+\x20Personal\x20alternative\x20(caller-specified\x20guard,\x202\x20Allocators)','description':'2\x20Allocators\x20as\x20alternative\x20strategies:\x20caller\x20selects\x20Treasury\x20or\x20Personal\x20wallet\x20via\x20alloc_by_guard\x20(hard\x20verification\x20per\x20call)','applicable_scenes':['allocation_treasury_personal_alternatives'],'industry_tags':['universal','alternative','treasury'],'params':[{'name':'allocation_name','type':'string','description':'Local\x20name\x20for\x20the\x20new\x20Allocation\x20object','required':!![]},{'name':'coin_type','type':'string','description':'Coin<T>\x20type\x20string','required':!![]},{'name':'treasury_address','type':'address','description':'Treasury\x20address\x20(primary\x20recipient)','required':!![]},{'name':'personal_address','type':'address','description':'Personal\x20wallet\x20address\x20(alternative\x20recipient)','required':!![]},{'name':'treasury_guard','type':'address','description':'Guard\x20for\x20Treasury\x20path\x20(verifies\x20treasury\x20operational)','required':!![]},{'name':'personal_guard','type':'address','description':'Guard\x20for\x20Personal\x20path\x20(verifies\x20personal\x20wallet\x20active)\x20—\x20MUST\x20differ\x20from\x20treasury_guard','required':!![]}],'body':a=>{if(a['treasury_guard']===a['personal_guard'])throw new Error('T-A-04:\x20treasury_guard\x20and\x20personal_guard\x20MUST\x20be\x20different\x20addresses\x20(F-A-14:\x20allocators[].guard\x20must\x20be\x20unique)');return{'object':{'name':a['allocation_name'],'type_parameter':a['coin_type']},'allocators':{'description':'Treasury\x20/\x20Personal\x20alternative\x20(caller-specified\x20guard)','threshold':'0','allocators':[{'guard':a['treasury_guard'],'sharing':[{'who':{'Entity':a['treasury_address']},'sharing':'10000','mode':'Rate'}],'max':null},{'guard':a['personal_guard'],'sharing':[{'who':{'Entity':a['personal_address']},'sharing':'10000','mode':'Rate'}],'max':null}]},'coin':{'name':a['allocation_name']+'_coin'},'payment_info':{}};},'notes':['F-A-14:\x20treasury_guard\x20!=\x20personal_guard\x20(Allocator\x20Guards\x20must\x20be\x20unique)','caller-specified\x20guard:\x20alloc_by_guard\x20explicitly\x20selects\x20an\x20Allocator;\x20passport::result_for_guard\x20hard-verifies\x20(failure\x20aborts\x20E_VERIFY_FAILED)','No\x20auto-fallback:\x20on\x20verification\x20failure\x20the\x20caller\x20must\x20switch\x20guard\x20and\x20retry','R-A-4-02:\x20if\x20the\x20caller\x27s\x20submitted\x20Passport\x20satisfies\x20both\x20Guards\x20simultaneously,\x20the\x20caller\x20may\x20freely\x20choose\x20between\x20the\x20two\x20paths\x20(mutual\x20exclusion\x20is\x20a\x20design\x20clarity\x20recommendation,\x20not\x20a\x20correctness\x20requirement)']},{'id':'T-A-05','name':'Tiered\x20by\x20order\x20amount\x20(mutually\x20exclusive\x20Guard\x20conditions)','description':'2\x20Allocators\x20triggered\x20by\x20mutually\x20exclusive\x20Guard\x20conditions\x20(small\x20order\x20vs\x20large\x20order)','applicable_scenes':['allocation_tiered_by_order_amount'],'industry_tags':['retail','tiered_pricing','volume_discount'],'params':[{'name':'allocation_name','type':'string','description':'Local\x20name\x20for\x20the\x20new\x20Allocation\x20object','required':!![]},{'name':'coin_type','type':'string','description':'Coin<T>\x20type\x20string','required':!![]},{'name':'merchant_treasury','type':'address','description':'Merchant\x20Treasury\x20address','required':!![]},{'name':'platform_treasury','type':'address','description':'Platform\x20Treasury\x20address','required':!![]},{'name':'small_order_guard','type':'address','description':'Guard\x20verifying\x20order.amount\x20<\x20threshold\x20(small\x20order\x20path)','required':!![]},{'name':'large_order_guard','type':'address','description':'Guard\x20verifying\x20order.amount\x20>=\x20threshold\x20(large\x20order\x20path)\x20—\x20MUST\x20differ\x20from\x20small_order_guard','required':!![]},{'name':'small_order_merchant_rate','type':'number','description':'Merchant\x20rate\x20for\x20small\x20orders\x20(e.g.\x2010000\x20=\x20100%)','required':!![],'default':0x2710},{'name':'large_order_merchant_rate','type':'number','description':'Merchant\x20rate\x20for\x20large\x20orders\x20(e.g.\x208000\x20=\x2080%)','required':!![],'default':0x1f40},{'name':'large_order_platform_rate','type':'number','description':'Platform\x20rate\x20for\x20large\x20orders\x20(e.g.\x202000\x20=\x2020%)','required':!![],'default':0x7d0}],'body':a=>{if(a['small_order_guard']===a['large_order_guard'])throw new Error('T-A-05:\x20small_order_guard\x20and\x20large_order_guard\x20MUST\x20be\x20different\x20addresses\x20(F-A-14)');const b=Number(a['small_order_merchant_rate']);if(b!==0x2710)throw new Error('T-A-05:\x20small_order_merchant_rate\x20MUST\x20equal\x2010000\x20(pure\x20Rate,\x20no\x20Surplus\x20in\x20this\x20Allocator),\x20got\x20'+b);const c=Number(a['large_order_merchant_rate']),d=Number(a['large_order_platform_rate']),e=c+d;if(e!==0x2710)throw new Error('T-A-05:\x20large_order\x20rates\x20MUST\x20sum\x20to\x2010000,\x20got\x20'+e+'\x20(merchant='+c+'\x20+\x20platform='+d+')');return{'object':{'name':a['allocation_name'],'type_parameter':a['coin_type']},'allocators':{'description':'Tiered\x20by\x20order\x20amount:\x20small=100%\x20merchant,\x20large=80/20\x20merchant/platform','threshold':'0','allocators':[{'guard':a['small_order_guard'],'sharing':[{'who':{'Entity':a['merchant_treasury']},'sharing':'10000','mode':'Rate'}],'max':null},{'guard':a['large_order_guard'],'sharing':[{'who':{'Entity':a['merchant_treasury']},'sharing':String(c),'mode':'Rate'},{'who':{'Entity':a['platform_treasury']},'sharing':String(d),'mode':'Rate'}],'max':null}]},'coin':{'name':a['allocation_name']+'_coin'},'payment_info':{}};},'notes':['Guard\x20conditions\x20MUST\x20be\x20mutually\x20exclusive\x20(R-A-4-02)','Sequence-sensitive:\x20strict\x20condition\x20(small\x20order)\x20first,\x20relaxed\x20condition\x20(large\x20order)\x20last','Guard\x20queries\x20order.amount\x20(query\x201561)\x20to\x20determine\x20which\x20Allocator\x20fires','If\x20neither\x20Guard\x20passes,\x20funds\x20are\x20silently\x20locked\x20(R-A-4-02)']},{'id':'T-A-06','name':'Dynamic\x20recipient\x20via\x20GuardIdentifier\x20(referrer\x20from\x20Passport)','description':'Single\x20Allocator\x20with\x203\x20Rate\x20sharing\x20items,\x20one\x20recipient\x20resolved\x20from\x20customer\x27s\x20Passport\x20table[0]','applicable_scenes':['allocation_dynamic_recipient'],'industry_tags':['referral','affiliate','marketing'],'params':[{'name':'allocation_name','type':'string','description':'Local\x20name\x20for\x20the\x20new\x20Allocation\x20object','required':!![]},{'name':'coin_type','type':'string','description':'Coin<T>\x20type\x20string','required':!![]},{'name':'merchant_treasury','type':'address','description':'Merchant\x20Treasury\x20address','required':!![]},{'name':'platform_treasury','type':'address','description':'Platform\x20Treasury\x20address','required':!![]},{'name':'guard_address','type':'address','description':'Guard\x20object\x20address\x20(must\x20be\x20configured\x20with\x20identifier=0\x20as\x20address\x20type)','required':!![]},{'name':'passport_identifier','type':'number','description':'Passport\x20table\x20identifier\x20(u8,\x200-255)\x20—\x20customer\x20submits\x20referrer\x20address\x20at\x20this\x20slot','required':!![],'default':0x0},{'name':'merchant_rate','type':'number','description':'Merchant\x20rate\x20in\x20basis\x20points\x20(e.g.\x208000\x20=\x2080%)','required':!![],'default':0x1f40},{'name':'platform_rate','type':'number','description':'Platform\x20rate\x20in\x20basis\x20points\x20(e.g.\x201000\x20=\x2010%)','required':!![],'default':0x3e8},{'name':'referrer_rate','type':'number','description':'Referrer\x20rate\x20in\x20basis\x20points\x20(e.g.\x201000\x20=\x2010%)','required':!![],'default':0x3e8}],'body':a=>{const b=Number(a['merchant_rate']),c=Number(a['platform_rate']),d=Number(a['referrer_rate']),e=b+c+d;if(e!==0x2710)throw new Error('T-A-06:\x20sum(rates)\x20MUST\x20equal\x2010000,\x20got\x20'+e+'\x20(merchant='+b+'\x20+\x20platform='+c+'\x20+\x20referrer='+d+')');const f=Number(a['passport_identifier']);if(f<0x0||f>0xff)throw new Error('T-A-06:\x20passport_identifier\x20MUST\x20be\x20u8\x20(0-255),\x20got\x20'+f);return{'object':{'name':a['allocation_name'],'type_parameter':a['coin_type']},'allocators':{'description':'Dynamic\x20recipient:\x20merchant\x20'+b+'/10000,\x20platform\x20'+c+'/10000,\x20referrer\x20'+d+'/10000\x20(from\x20Passport\x20identifier='+f+')','threshold':'0','allocators':[{'guard':a['guard_address'],'sharing':[{'who':{'Entity':a['merchant_treasury']},'sharing':String(b),'mode':'Rate'},{'who':{'Entity':a['platform_treasury']},'sharing':String(c),'mode':'Rate'},{'who':{'GuardIdentifier':f},'sharing':String(d),'mode':'Rate'}],'max':null}]},'coin':{'name':a['allocation_name']+'_coin'},'payment_info':{}};},'notes':['F-A-13:\x20Passport\x20table[identifier]\x20MUST\x20be\x20address\x20type\x20(else\x20ERECIPIENT_IDENTIFIER_NOT_ADDRESS=1)','Guard.is_identifier_address(guard,\x20identifier)\x20MUST\x20be\x20true\x20at\x20allocator_add\x20time\x20(else\x20allocator_add\x20fails)','Customer\x20must\x20submit\x20Passport\x20with\x20referrer\x20address\x20at\x20the\x20specified\x20identifier\x20slot','Guard\x20should\x20verify\x20Passport\x20completeness\x20before\x20alloc()\x20executes']},{'id':'T-A-07','name':'Refund\x20to\x20Order\x20(100%\x20to\x20Order\x20object,\x20not\x20personal\x20wallet)','description':'Single\x20Allocator,\x201\x20Rate=10000\x20sharing\x20to\x20Order\x20object\x20address.\x20Refund\x20funds\x20return\x20to\x20Order\x20for\x20downstream\x20handling.','applicable_scenes':['allocation_refund_to_order'],'industry_tags':['refund','customer_protection','order_lifecycle'],'params':[{'name':'allocation_name','type':'string','description':'Local\x20name\x20for\x20the\x20new\x20Allocation\x20object','required':!![]},{'name':'coin_type','type':'string','description':'Coin<T>\x20type\x20string','required':!![]},{'name':'order_address','type':'address','description':'Order\x20object\x20address\x20(NOT\x20personal\x20wallet)\x20—\x20funds\x20flow\x20back\x20to\x20Order','required':!![]},{'name':'guard_address','type':'address','description':'Guard\x20object\x20address\x20(verifies\x20customer\x20refund\x20request\x20and\x20eligibility)','required':!![]}],'body':a=>({'object':{'name':a['allocation_name'],'type_parameter':a['coin_type']},'allocators':{'description':'Refund\x20to\x20Order\x20(100%\x20to\x20Order\x20object\x20for\x20downstream\x20handling)','threshold':'0','allocators':[{'guard':a['guard_address'],'sharing':[{'who':{'Entity':a['order_address']},'sharing':'10000','mode':'Rate'}],'max':null}]},'coin':{'name':a['allocation_name']+'_coin'},'payment_info':{}}),'notes':['⚠️\x20who=Entity\x20MUST\x20be\x20Order\x20object\x20address\x20(not\x20personal\x20address)','Customer\x20due-diligence\x20rewards\x20this\x20configuration\x20(8-point\x20weight\x20in\x20customer/risk-assessment.ts)','Refund\x20funds\x20return\x20to\x20Order\x20for\x20downstream\x20handling\x20(e.g.\x20customer\x20withdrawal)','Guard\x20must\x20verify\x20customer\x20refund\x20eligibility\x20(e.g.\x20dispute\x20resolved\x20in\x20customer\x27s\x20favor)']},{'id':'T-A-08','name':'Arbitration\x20fees\x20split\x20(arbitrator\x2080%\x20/\x20platform\x2020%)','description':'Single\x20Allocator,\x202\x20Rate\x20sharing\x20items.\x20Triggered\x20by\x20Arbitration.fees_alloc\x20(permission\x20365)\x20or\x20fees_alloc_with_passport.','applicable_scenes':['allocation_arbitration_fees'],'industry_tags':['arbitration','dispute','fees'],'params':[{'name':'allocation_name','type':'string','description':'Local\x20name\x20for\x20the\x20new\x20Allocation\x20object','required':!![]},{'name':'coin_type','type':'string','description':'Coin<T>\x20type\x20string\x20(must\x20match\x20Arbitration\x20fee\x20Coin\x20type)','required':!![]},{'name':'arbitrator_treasury','type':'address','description':'Arbitrator\x20Treasury\x20address','required':!![]},{'name':'platform_treasury','type':'address','description':'Platform\x20Treasury\x20address','required':!![]},{'name':'arbitrator_rate','type':'number','description':'Arbitrator\x20rate\x20in\x20basis\x20points\x20(e.g.\x208000\x20=\x2080%)','required':!![],'default':0x1f40},{'name':'platform_rate','type':'number','description':'Platform\x20rate\x20in\x20basis\x20points\x20(e.g.\x202000\x20=\x2020%)','required':!![],'default':0x7d0},{'name':'guard_address','type':'address','description':'Guard\x20object\x20address\x20(verifies\x20Arbitration\x20ruling\x20finalized)','required':!![]}],'body':a=>{const b=Number(a['arbitrator_rate']),c=Number(a['platform_rate']),d=b+c;if(d!==0x2710)throw new Error('T-A-08:\x20sum(rates)\x20MUST\x20equal\x2010000,\x20got\x20'+d+'\x20(arbitrator='+b+'\x20+\x20platform='+c+')');return{'object':{'name':a['allocation_name'],'type_parameter':a['coin_type']},'allocators':{'description':'Arbitration\x20fees\x20split:\x20arbitrator\x20'+b+'/10000,\x20platform\x20'+c+'/10000','threshold':'0','allocators':[{'guard':a['guard_address'],'sharing':[{'who':{'Entity':a['arbitrator_treasury']},'sharing':String(b),'mode':'Rate'},{'who':{'Entity':a['platform_treasury']},'sharing':String(c),'mode':'Rate'}],'max':null}]},'coin':{'name':a['allocation_name']+'_coin'},'payment_info':{}};},'notes':['Triggered\x20by\x20Arbitration.fees_alloc\x20(permission\x20ARBITRATION_FEES_ALLOC=365)\x20or\x20fees_alloc_with_passport','Independent\x20from\x20Service-order\x20Allocation\x20(this\x20Allocation\x20is\x20not\x20bound\x20to\x20Order)','payment_info\x20typically\x20reuses\x20Arbitration\x27s\x20payment_info','Caller\x20MUST\x20hold\x20ARBITRATION_FEES_ALLOC=365\x20permission']},{'id':'T-A-09','name':'Standalone\x20periodic\x20split\x20(investment\x20dividends\x20/\x20shared\x20income)','description':'Standalone\x20Allocation\x20with\x20single\x20Allocator,\x20N\x20Rate\x20sharing\x20items\x20to\x20beneficiary\x20wallets.\x20No\x20Service\x20context.\x20Guard\x20provides\x20time-based\x20or\x20signer-based\x20access\x20control.','applicable_scenes':['allocation_standalone_periodic_split'],'industry_tags':['standalone','investment','dividends','shared_income'],'params':[{'name':'allocation_name','type':'string','description':'Local\x20name\x20for\x20the\x20new\x20Allocation\x20object','required':!![]},{'name':'coin_type','type':'string','description':'Coin<T>\x20type\x20string\x20(e.g.\x20\x270x2::wow::WOW\x27\x20or\x20profit\x20token\x20type)','required':!![]},{'name':'beneficiaries','type':'address[]','description':'Array\x20of\x20beneficiary\x20wallet\x20addresses\x20(NOT\x20Treasury\x20objects\x20—\x20standalone\x20mode\x20has\x20no\x20Service\x20context)','required':!![]},{'name':'rates','type':'string[]','description':'Array\x20of\x20rates\x20in\x20basis\x20points\x20(e.g.\x20[\x275000\x27,\x273000\x27,\x272000\x27]\x20=\x2050%/30%/20%).\x20MUST\x20sum\x20to\x2010000.','required':!![]},{'name':'guard_address','type':'address','description':'Guard\x20object\x20address\x20—\x20MUST\x20bind\x20Signer\x20or\x20verify\x20time-based\x20trigger\x20(R-A-3-04:\x20standalone\x20has\x20no\x20Service-layer\x20access\x20control)','required':!![]},{'name':'description','type':'string','description':'Allocation\x20description','required':![],'default':'Standalone\x20periodic\x20split'}],'body':a=>{const b=a['beneficiaries'],c=a['rates']['map'](e=>Number(e));if(b['length']!==c['length'])throw new Error('T-A-09:\x20beneficiaries\x20('+b['length']+')\x20and\x20rates\x20('+c['length']+')\x20MUST\x20have\x20equal\x20length');if(b['length']===0x0)throw new Error('T-A-09:\x20at\x20least\x201\x20beneficiary\x20required');if(b['length']>0x64)throw new Error('T-A-09:\x20beneficiaries\x20count\x20'+b['length']+'\x20exceeds\x20MAX_SHARING_COUNT\x20(100)');const d=c['reduce']((e,f)=>e+f,0x0);if(d!==0x2710)throw new Error('T-A-09:\x20sum(rates)\x20MUST\x20equal\x2010000\x20(RATE_TOTAL_FULL),\x20got\x20'+d);return{'object':{'name':a['allocation_name'],'type_parameter':a['coin_type']},'allocators':{'description':a['description']??'Standalone\x20periodic\x20split','threshold':'0','allocators':[{'guard':a['guard_address'],'sharing':b['map']((e,f)=>({'who':{'Entity':e},'sharing':String(c[f]),'mode':'Rate'})),'max':null}]},'coin':{'name':a['allocation_name']+'_coin'},'payment_info':{}};},'notes':['Standalone\x20mode\x20(§0):\x20no\x20Service/Order/Arbitration\x20context\x20required','R-A-3-04:\x20Guard\x20MUST\x20bind\x20Signer\x20or\x20verify\x20time-based\x20trigger\x20—\x20no\x20Service-layer\x20access\x20control\x20exists','F-A-05:\x20sum(rates)\x20MUST\x20equal\x2010000\x20(pure\x20Rate\x20mode,\x20no\x20Surplus)','Caller\x20lifecycle:\x20receive()\x20to\x20deposit\x20funds\x20→\x20alloc()\x20to\x20trigger\x20distribution','Guard\x20should\x20bind\x20context(Signer)==authorized\x20to\x20prevent\x20unauthorized\x20alloc()\x20calls','beneficiaries\x20are\x20personal\x20wallets,\x20NOT\x20Treasury\x20objects\x20(no\x20Service\x20context)']},{'id':'T-A-10','name':'Standalone\x20vesting\x20release\x20(time-locked\x20multi-stage\x20unlock)','description':'Standalone\x20Allocation\x20with\x20N\x20Allocators\x20(default\x203\x20stages),\x20each\x20triggered\x20by\x20a\x20time-locked\x20Guard.\x20Stages\x201..N-1\x20use\x20Amount\x20mode;\x20final\x20stage\x20uses\x20Surplus\x20to\x20drain\x20remaining\x20balance.\x20No\x20Service\x20context.','applicable_scenes':['allocation_standalone_vesting'],'industry_tags':['standalone','vesting','time_lock','team_tokens'],'params':[{'name':'allocation_name','type':'string','description':'Local\x20name\x20for\x20the\x20new\x20Allocation\x20object','required':!![]},{'name':'coin_type','type':'string','description':'Coin<T>\x20type\x20string\x20(vested\x20asset,\x20e.g.\x20locked\x20team\x20tokens)','required':!![]},{'name':'beneficiary_address','type':'address','description':'Single\x20beneficiary\x20wallet\x20address\x20(vesting\x20recipient)','required':!![]},{'name':'stage_1_guard','type':'address','description':'Guard\x20for\x20stage\x201\x20(verifies\x20context(Clock).timestamp\x20>=\x20stage_1_unlock)','required':!![]},{'name':'stage_1_amount','type':'number','description':'Amount\x20to\x20release\x20at\x20stage\x201\x20(smallest\x20coin\x20unit,\x20e.g.\x20MIST)','required':!![]},{'name':'stage_2_guard','type':'address','description':'Guard\x20for\x20stage\x202\x20(verifies\x20context(Clock).timestamp\x20>=\x20stage_2_unlock)\x20—\x20MUST\x20differ\x20from\x20stage_1_guard','required':!![]},{'name':'stage_2_amount','type':'number','description':'Amount\x20to\x20release\x20at\x20stage\x202\x20(smallest\x20coin\x20unit)','required':!![]},{'name':'stage_3_guard','type':'address','description':'Guard\x20for\x20stage\x203\x20(final\x20stage,\x20uses\x20Surplus\x20to\x20drain\x20remaining\x20balance)\x20—\x20MUST\x20differ\x20from\x20stage_1_guard\x20and\x20stage_2_guard','required':!![]},{'name':'max_cap','type':'number','description':'Maximum\x20cumulative\x20release\x20cap\x20(applied\x20to\x20stages\x201\x20and\x202\x20via\x20max\x20field).\x20Stage\x203\x20uses\x20Surplus\x20so\x20no\x20max\x20needed.','required':![]},{'name':'description','type':'string','description':'Allocation\x20description','required':![],'default':'Standalone\x20vesting\x20release\x20(3-stage\x20time-locked)'}],'body':a=>{const b=[a['stage_1_guard'],a['stage_2_guard'],a['stage_3_guard']],c=new Set(b);if(c['size']!==b['length']){const h=b['filter']((j,k)=>b['indexOf'](j)!==k);throw new Error('T-A-10:\x20stage\x20guards\x20MUST\x20be\x20unique\x20(F-A-14),\x20duplicates:\x20'+h['join'](',\x20'));}const d=Number(a['stage_1_amount']),e=Number(a['stage_2_amount']);if(d<=0x0||e<=0x0)throw new Error('T-A-10:\x20stage_1_amount\x20and\x20stage_2_amount\x20MUST\x20be\x20>\x200,\x20got\x20stage1='+d+',\x20stage2='+e);const f=d+e,g=a['max_cap']!=null?Number(a['max_cap']):null;if(g!==null&&f>g)throw new Error('T-A-10:\x20stage_1_amount\x20+\x20stage_2_amount\x20('+f+')\x20MUST\x20be\x20<=\x20max_cap\x20('+g+')\x20—\x20F-A-08\x20(EAMOUNT_EXCEEDS_MAX)');return{'object':{'name':a['allocation_name'],'type_parameter':a['coin_type']},'allocators':{'description':a['description']??'Standalone\x20vesting\x20release\x20(3-stage\x20time-locked)','threshold':'0','allocators':[{'guard':a['stage_1_guard'],'sharing':[{'who':{'Entity':a['beneficiary_address']},'sharing':String(d),'mode':'Amount'}],'max':g!=null?String(g):null},{'guard':a['stage_2_guard'],'sharing':[{'who':{'Entity':a['beneficiary_address']},'sharing':String(e),'mode':'Amount'}],'max':g!=null?String(g):null},{'guard':a['stage_3_guard'],'sharing':[{'who':{'Entity':a['beneficiary_address']},'sharing':'0','mode':'Surplus'}],'max':null}]},'coin':{'name':a['allocation_name']+'_coin'},'payment_info':{}};},'notes':['Standalone\x20mode\x20(§0):\x20no\x20Service/Order/Arbitration\x20context\x20required','R-A-3-04:\x20Guard\x20time-lock\x20MUST\x20be\x20enforced\x20—\x20no\x20Service-layer\x20access\x20control\x20exists','F-A-14:\x20stage_1_guard,\x20stage_2_guard,\x20stage_3_guard\x20MUST\x20be\x20unique\x20(duplicate\x20guards\x20are\x20dead\x20code)','F-A-04:\x20at\x20most\x201\x20Surplus\x20per\x20Allocator\x20(stage\x203\x20uses\x20Surplus\x20to\x20drain\x20remainder)','F-A-08:\x20stage_1_amount\x20+\x20stage_2_amount\x20MUST\x20be\x20<=\x20max_cap\x20(if\x20max_cap\x20provided)','R-A-4-01:\x20if\x20caller\x20calls\x20alloc()\x20before\x20stage\x20time-lock\x20expires,\x20alloc()\x20silently\x20returns\x20—\x20caller\x20should\x20check\x20balance==0\x20after\x20alloc()','R-A-4-02:\x20Guard\x20conditions\x20SHOULD\x20be\x20mutually\x20exclusive\x20by\x20timestamp\x20(e.g.\x20stage_1:\x20ts<stage_2_unlock,\x20stage_2:\x20stage_2_unlock<=ts<stage_3_unlock,\x20stage_3:\x20ts>=stage_3_unlock)','Caller\x20lifecycle:\x20receive()\x20to\x20deposit\x20locked\x20tokens\x20→\x20alloc()\x20at\x20each\x20vesting\x20milestone']}];export const ALLOCATION_TEMPLATES_VERSION='1.0.0';export function getAllTemplates(){return[...ALLOCATION_TEMPLATES];}export function getTemplateById(a){return ALLOCATION_TEMPLATES['find'](b=>b['id']===a);}export function getTemplatesByScene(a){return ALLOCATION_TEMPLATES['filter'](b=>b['applicable_scenes']['includes'](a));}export function getTemplatesByIndustry(a){return ALLOCATION_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 ALLOCATION_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':f instanceof Error?f['message']:String(f)};}}