@wowok/agent-mcp 2.7.0 → 2.7.2

package/dist/knowledge/allocation-ledger.js

@@ -1,463 +1 @@
-import { MAX_SHARING_COUNT, MAX_ALLOCATOR_COUNT } from "@wowok/wowok";
-export { MAX_ALLOCATOR_COUNT };
-export const ALLOCATION_MAX_SHARING_COUNT = MAX_SHARING_COUNT;
-export const ALLOCATION_MODE_AMOUNT = 0;
-export const ALLOCATION_MODE_RATE = 1;
-export const ALLOCATION_MODE_SURPLUS = 2;
-export const RATE_TOTAL_FULL = 10000;
-export const ALLOCATION_ERROR_CODES = {
-    ERECIPIENT_IDENTIFIER_NOT_ADDRESS: 1,
-    EALLOCATOR_COUNT_EXCEEDED: 2,
-    ENO_ALLOCATOR: 3,
-    ERATE_NOT_10000: 4,
-    EMULTIPLE_SURPLUS: 5,
-    ERATE_EXCEEDS_10000: 6,
-    EINSUFFICIENT_BALANCE: 7,
-    EALLOCATORS_EMPTY: 8,
-    ENO_PAYMENT_INFO: 9,
-    ESHARING_COUNT_EXCEEDED: 10,
-    ESHARING_MODE_INVALID: 11,
-    EAMOUNT_BELOW_THRESHOLD: 12,
-    EAMOUNT_EXCEEDS_MAX: 13,
-};
-export const ORDER_ALLOCATION_ALREADY_SPECIFIED = "E_ALLOCATION_ALREADY_SPECIFIED";
-export const ALLOCATION_SCENES = [
-    {
-        id: "allocation_standard_three_way_split",
-        name: "Standard three-way split (merchant / platform / logistics)",
-        trigger_source: "service_order_allocators",
-        distribution_strategy: "pure_rate",
-        coin_type_note: "All three Treasury objects must use the same Coin<T> type as the Allocation",
-        typical_allocator_count: 1,
-        sharing_who_types: ["Entity"],
-        modes_used: ["Rate"],
-        guard_requirement: "required",
-        non_zero_threshold: false,
-        uses_max: false,
-        common_patterns: [
-            "Single Allocator, 3 Rate sharing items, sum(rates) === 10000",
-            "Each sharing.who=Entity points to a Treasury address",
-            "Guard verifies order.service binding (query 1563) to prevent cross-project bypass",
-            "Guard verifies progress.current_node === 'Complete'",
-        ],
-        dependencies: ["Service", "Treasury", "Guard", "Order", "Progress", "Machine", "Payment"],
-        key_constraints: [
-            "F-A-05: sum(rates) === 10000 (pure Rate mode)",
-            "Treasury Permission should match Service Permission (R-A-12)",
-            "order_allocators immutable after Service publish (R-A-10)",
-        ],
-        recommended_templates: ["T-A-02"],
-    },
-    {
-        id: "allocation_merchant_full_payment",
-        name: "Merchant full payment (single recipient, 100%)",
-        trigger_source: "service_order_allocators",
-        distribution_strategy: "pure_rate",
-        coin_type_note: "Simplest configuration — single Treasury or personal address",
-        typical_allocator_count: 1,
-        sharing_who_types: ["Entity"],
-        modes_used: ["Rate"],
-        guard_requirement: "single_relaxed",
-        non_zero_threshold: false,
-        uses_max: false,
-        common_patterns: [
-            "Single Allocator, 1 Rate sharing = 10000",
-            "Guard only verifies order status (no complex conditions)",
-            "who=Entity can be either Treasury or personal wallet",
-        ],
-        dependencies: ["Service", "Guard", "Order", "Payment"],
-        key_constraints: [
-            "Simplest allocation configuration",
-            "No multi-party coordination required",
-        ],
-        recommended_templates: ["T-A-01"],
-    },
-    {
-        id: "allocation_refund_first_surplus_to_merchant",
-        name: "Refund first + surplus to merchant (Amount + Surplus hybrid)",
-        trigger_source: "service_order_allocators",
-        distribution_strategy: "amount_plus_surplus",
-        coin_type_note: "Refund amount must match Coin<T> precision",
-        typical_allocator_count: 1,
-        sharing_who_types: ["Entity"],
-        modes_used: ["Amount", "Surplus"],
-        guard_requirement: "required",
-        non_zero_threshold: true,
-        uses_max: false,
-        common_patterns: [
-            "Single Allocator, 2 sharing items",
-            "sharing[0]: Amount=refund_value, who=Entity(customer_address)",
-            "sharing[1]: Surplus, who=Entity(merchant_treasury)",
-            "fix = refund_value (cached Amount sum)",
-            "threshold = refund_value (ensure sufficient balance for Amount)",
-        ],
-        dependencies: ["Service", "Treasury", "Guard", "Order", "Payment"],
-        key_constraints: [
-            "F-A-04: at most 1 Surplus per Allocator",
-            "F-A-07: fix >= threshold (Amount sum must cover threshold)",
-            "fix must precisely match the refund amount",
-        ],
-        recommended_templates: ["T-A-03"],
-    },
-    {
-        id: "allocation_treasury_personal_alternatives",
-        name: "Treasury + Personal alternative strategies (caller-specified guard)",
-        trigger_source: "service_order_allocators",
-        distribution_strategy: "first_match_alternatives",
-        coin_type_note: "Both target addresses must accept the same Coin<T>",
-        typical_allocator_count: 2,
-        sharing_who_types: ["Entity"],
-        modes_used: ["Rate"],
-        guard_requirement: "multiple_unique",
-        non_zero_threshold: false,
-        uses_max: false,
-        common_patterns: [
-            "2 Allocators, each with 1 Rate=10000 sharing",
-            "Allocator[0]: guard=guard_treasury, who=Entity(treasury_address)",
-            "Allocator[1]: guard=guard_personal, who=Entity(personal_address)",
-            "Two Guard objects must be different addresses (R-A-11)",
-            "caller-specified guard: caller selects Treasury or Personal path via alloc_by_guard; passport::result_for_guard hard-validates (failure aborts with E_VERIFY_FAILED; caller must switch guard and retry)",
-        ],
-        dependencies: ["Service", "Treasury", "Guard", "Order", "Payment"],
-        key_constraints: [
-            "F-A-14: allocators[].guard must be unique",
-            "Treasury Permission should match Service Permission (R-A-12)",
-            "Guard A and Guard B may share root/table but must differ in description",
-        ],
-        recommended_templates: ["T-A-04"],
-    },
-    {
-        id: "allocation_tiered_by_order_amount",
-        name: "Tiered split by order amount (multi-Allocator amount-threshold switch)",
-        trigger_source: "service_order_allocators",
-        distribution_strategy: "tiered_by_amount",
-        coin_type_note: "Amount threshold uses Coin<T> smallest unit (e.g. MIST for WOW)",
-        typical_allocator_count: 2,
-        sharing_who_types: ["Entity"],
-        modes_used: ["Rate"],
-        guard_requirement: "multiple_unique",
-        non_zero_threshold: false,
-        uses_max: false,
-        common_patterns: [
-            "2 Allocators triggered by mutually exclusive Guard conditions",
-            "Allocator[0]: guard verifies order.amount < threshold, Rate=10000 to merchant",
-            "Allocator[1]: guard verifies order.amount >= threshold, Rate=8000/2000 split",
-            "caller-specified guard: caller selects the matching Allocator based on order amount; allocator order is irrelevant",
-            "Guard queries order.amount (query 1561)",
-        ],
-        dependencies: ["Service", "Treasury", "Guard", "Order", "Payment"],
-        key_constraints: [
-            "Guard conditions must be mutually exclusive (R-A-4-02 design clarity)",
-            "Caller must select correct guard based on order.amount (no auto-fallback)",
-        ],
-        recommended_templates: ["T-A-05"],
-    },
-    {
-        id: "allocation_dynamic_recipient",
-        name: "Multi-role split with dynamic recipient (GuardIdentifier)",
-        trigger_source: "service_order_allocators",
-        distribution_strategy: "dynamic_recipient",
-        coin_type_note: "Passport table must contain address-typed entry at the referenced identifier",
-        typical_allocator_count: 1,
-        sharing_who_types: ["Entity", "GuardIdentifier"],
-        modes_used: ["Rate"],
-        guard_requirement: "required",
-        non_zero_threshold: false,
-        uses_max: false,
-        common_patterns: [
-            "Single Allocator, 3 Rate sharing items",
-            "sharing[0]: Rate=8000, who=Entity(merchant_treasury)",
-            "sharing[1]: Rate=1000, who=Entity(platform_treasury)",
-            "sharing[2]: Rate=1000, who=GuardIdentifier(0) — resolves from Passport table",
-            "Customer submits Passport with referrer address at identifier=0",
-        ],
-        dependencies: ["Service", "Treasury", "Guard", "Passport", "Order", "Payment"],
-        key_constraints: [
-            "F-A-13: Passport table[identifier] must be address type (else ERECIPIENT_IDENTIFIER_NOT_ADDRESS)",
-            "Guard must verify Passport completeness",
-            "Customer order must include Passport with referrer address",
-        ],
-        recommended_templates: ["T-A-06"],
-    },
-    {
-        id: "allocation_arbitration_fees",
-        name: "Arbitration fees split (arbitrator / platform)",
-        trigger_source: "arbitration_fees",
-        distribution_strategy: "pure_rate",
-        coin_type_note: "Coin<T> must match Arbitration's fee Coin type",
-        typical_allocator_count: 1,
-        sharing_who_types: ["Entity"],
-        modes_used: ["Rate"],
-        guard_requirement: "required",
-        non_zero_threshold: false,
-        uses_max: false,
-        common_patterns: [
-            "Triggered by Arbitration.fees_alloc (permission 365) or fees_alloc_with_passport",
-            "Single Allocator, 2 Rate sharing items: 8000 arbitrator / 2000 platform",
-            "payment_info reuses Arbitration's payment_info",
-            "Caller must hold ARBITRATION_FEES_ALLOC=365 permission",
-        ],
-        dependencies: ["Arbitration", "Treasury", "Guard", "Payment"],
-        key_constraints: [
-            "Independent from Service-order Allocation",
-            "Requires ARBITRATION_FEES_ALLOC=365 permission",
-        ],
-        recommended_templates: ["T-A-08"],
-    },
-    {
-        id: "allocation_refund_to_order",
-        name: "Refund Allocator (100% to Order object)",
-        trigger_source: "service_order_allocators",
-        distribution_strategy: "refund_to_order",
-        coin_type_note: "who=Entity must be the Order object address (NOT a personal wallet)",
-        typical_allocator_count: 1,
-        sharing_who_types: ["Entity"],
-        modes_used: ["Rate"],
-        guard_requirement: "required",
-        non_zero_threshold: false,
-        uses_max: false,
-        common_patterns: [
-            "Single Allocator, 1 Rate=10000 sharing",
-            "who=Entity(order_address) — funds flow back to Order, not personal wallet",
-            "Guard verifies customer refund request and eligibility",
-            "Customer-side risk assessment adds 8-point weight (customer/risk-assessment.ts)",
-        ],
-        dependencies: ["Service", "Guard", "Order", "Payment"],
-        key_constraints: [
-            "who=Entity MUST be Order object address (not personal address)",
-            "Customer due-diligence rewards this configuration (8-point weight)",
-            "Refund funds return to Order for downstream handling",
-        ],
-        recommended_templates: ["T-A-07"],
-    },
-    {
-        id: "allocation_max_capped_retain",
-        name: "Max-capped allocation (retain residual balance)",
-        trigger_source: "service_order_allocators",
-        distribution_strategy: "max_capped",
-        coin_type_note: "max field uses Coin<T> smallest unit",
-        typical_allocator_count: 1,
-        sharing_who_types: ["Entity"],
-        modes_used: ["Amount", "Rate"],
-        guard_requirement: "required",
-        non_zero_threshold: true,
-        uses_max: true,
-        common_patterns: [
-            "Single Allocator with max field set",
-            "max triple role: Amount cap + Rate base + Surplus cap",
-            "Amount sharing consumes fix; Rate sharing uses (max - fix) as base",
-            "Residual balance remains in Allocation for subsequent alloc() calls",
-        ],
-        dependencies: ["Service", "Treasury", "Guard", "Order", "Payment"],
-        key_constraints: [
-            "F-A-08: Amount sum <= max (EAMOUNT_EXCEEDS_MAX)",
-            "max - fix becomes Rate base (NOT balance - fix)",
-            "Residual balance may be claimed by re-triggering alloc()",
-        ],
-        recommended_templates: [],
-    },
-    {
-        id: "allocation_multi_node_trigger",
-        name: "Multi-Machine-node triggered allocation (Complete / Refund / Lost)",
-        trigger_source: "service_order_allocators",
-        distribution_strategy: "multi_node_trigger",
-        coin_type_note: "All Allocators share the same Allocation's Coin<T>",
-        typical_allocator_count: 3,
-        sharing_who_types: ["Entity"],
-        modes_used: ["Rate"],
-        guard_requirement: "multiple_unique",
-        non_zero_threshold: false,
-        uses_max: false,
-        common_patterns: [
-            "3 Allocators mapped to Machine terminal nodes (Complete/Refund/Lost)",
-            "Each Allocator's Guard verifies progress.current_node == <node_name>",
-            "Mutually exclusive Guard conditions (only one terminal node active at a time)",
-            "Machine.required_allocators[] describes each trigger_node mapping",
-        ],
-        dependencies: ["Service", "Treasury", "Guard", "Order", "Progress", "Machine", "Payment"],
-        key_constraints: [
-            "Guard conditions must be mutually exclusive",
-            "Sequence-sensitive: business-flow order",
-            "Machine.required_allocators[trigger_node] must map to Allocator indices",
-        ],
-        recommended_templates: [],
-    },
-    {
-        id: "allocation_standalone_periodic_split",
-        name: "Standalone periodic split (investment dividends / shared income)",
-        trigger_source: "standalone",
-        distribution_strategy: "periodic_split",
-        coin_type_note: "Coin<T> must match the asset being distributed (e.g. profit token)",
-        typical_allocator_count: 1,
-        sharing_who_types: ["Entity"],
-        modes_used: ["Rate"],
-        guard_requirement: "required",
-        non_zero_threshold: false,
-        uses_max: false,
-        common_patterns: [
-            "Single Allocator, N Rate sharing items, sum(rates) === 10000",
-            "Each sharing.who=Entity points to a beneficiary wallet (not Treasury)",
-            "Guard verifies time-based trigger (e.g. context(Clock).timestamp >= next_release) or signer authorization",
-            "User calls receive() to deposit funds, then alloc() to trigger distribution",
-            "No Service/Order/Progress/Machine context required",
-        ],
-        dependencies: ["Treasury", "Guard", "Payment"],
-        key_constraints: [
-            "F-A-05: sum(rates) === 10000 (pure Rate mode)",
-            "R-A-3-04: standalone mode has no Service-layer access control — Guard + Passport MUST be sufficient",
-            "Caller is fully responsible for receive → alloc lifecycle (no auto-trigger)",
-            "Guard should bind Signer to prevent unauthorized alloc() calls",
-        ],
-        recommended_templates: ["T-A-09"],
-    },
-    {
-        id: "allocation_standalone_vesting",
-        name: "Standalone vesting release (time-locked multi-stage unlock)",
-        trigger_source: "standalone",
-        distribution_strategy: "time_locked_vesting",
-        coin_type_note: "Coin<T> must match the vested asset (e.g. locked team tokens)",
-        typical_allocator_count: 3,
-        sharing_who_types: ["Entity"],
-        modes_used: ["Amount", "Rate", "Surplus"],
-        guard_requirement: "multiple_unique",
-        non_zero_threshold: true,
-        uses_max: true,
-        common_patterns: [
-            "N Allocators, each mapped to a vesting stage (e.g. 25% at month 12, 25% at month 24, 50% surplus at month 36)",
-            "Each Allocator's Guard verifies context(Clock).timestamp >= stage_unlock_time",
-            "Amount sharing per stage with max field capping the cumulative release",
-            "Final Allocator uses Surplus to drain remaining balance after last vesting stage",
-            "Mutually exclusive Guard conditions (only one stage active at a time, based on timestamp)",
-            "User calls receive() to deposit locked tokens, then alloc() at each vesting milestone",
-        ],
-        dependencies: ["Treasury", "Guard", "Passport", "Payment"],
-        key_constraints: [
-            "F-A-04: at most 1 Surplus per Allocator (final stage uses Surplus to drain remainder)",
-            "F-A-08: Amount sum <= max (EAMOUNT_EXCEEDS_MAX)",
-            "R-A-3-04: standalone mode has no Service-layer access control — Guard time-lock MUST be enforced",
-            "Guard conditions must be mutually exclusive by timestamp (R-A-4-02)",
-            "Caller must wait for time-lock expiry before alloc() succeeds; otherwise alloc() silently returns (R-A-4-01)",
-        ],
-        recommended_templates: ["T-A-10"],
-    },
-];
-export const ALLOCATION_LEDGER_VERSION = "1.0.0";
-export function getScenesByTriggerSource(source) {
-    return ALLOCATION_SCENES.filter(s => s.trigger_source === source);
-}
-export function getScenesByMode(mode) {
-    return ALLOCATION_SCENES.filter(s => s.modes_used.includes(mode));
-}
-export function getScenesByStrategy(strategy) {
-    return ALLOCATION_SCENES.filter(s => s.distribution_strategy === strategy);
-}
-export function findSceneById(id) {
-    return ALLOCATION_SCENES.find(s => s.id === id);
-}
-export function inferSceneFromIntent(intent) {
-    const lower = intent.toLowerCase();
-    if (lower.includes("arbitration") || lower.includes("fees_alloc")) {
-        return findSceneById("allocation_arbitration_fees");
-    }
-    if (lower.includes("standalone") || lower.includes("periodic split") ||
-        lower.includes("investment dividend") || lower.includes("shared income") || lower.includes("dividend")) {
-        return findSceneById("allocation_standalone_periodic_split");
-    }
-    if (lower.includes("vesting") || lower.includes("time-lock") || lower.includes("unlock period") ||
-        lower.includes("locked release") || lower.includes("token unlock")) {
-        return findSceneById("allocation_standalone_vesting");
-    }
-    if (lower.includes("refund")) {
-        if (lower.includes("order") || lower.includes("100%")) {
-            return findSceneById("allocation_refund_to_order");
-        }
-        if (lower.includes("surplus") || lower.includes("merchant")) {
-            return findSceneById("allocation_refund_first_surplus_to_merchant");
-        }
-    }
-    if (lower.includes("alternative") || lower.includes("priority") || (lower.includes("treasury") && lower.includes("personal"))) {
-        return findSceneById("allocation_treasury_personal_alternatives");
-    }
-    if (lower.includes("tiered") || lower.includes("threshold switch")) {
-        return findSceneById("allocation_tiered_by_order_amount");
-    }
-    if (lower.includes("dynamic recipient") || lower.includes("referrer") || lower.includes("guardidentifier")) {
-        return findSceneById("allocation_dynamic_recipient");
-    }
-    if (lower.includes("retain") || lower.includes("max")) {
-        return findSceneById("allocation_max_capped_retain");
-    }
-    if (lower.includes("multi-node") || lower.includes("multi machine") || lower.includes("multi_node")) {
-        return findSceneById("allocation_multi_node_trigger");
-    }
-    const roleCount = (intent.match(/%/g) || []).length;
-    if (roleCount <= 1) {
-        return findSceneById("allocation_merchant_full_payment");
-    }
-    if (roleCount >= 2) {
-        return findSceneById("allocation_standard_three_way_split");
-    }
-    return undefined;
-}
-export function getAllScenes() {
-    return [...ALLOCATION_SCENES];
-}
-export function getScenesCount() {
-    return ALLOCATION_SCENES.length;
-}
-export function allocationModeToNumber(mode) {
-    switch (mode) {
-        case "Amount": return ALLOCATION_MODE_AMOUNT;
-        case "Rate": return ALLOCATION_MODE_RATE;
-        case "Surplus": return ALLOCATION_MODE_SURPLUS;
-    }
-}
-export function allocationModeFromNumber(n) {
-    switch (n) {
-        case ALLOCATION_MODE_AMOUNT: return "Amount";
-        case ALLOCATION_MODE_RATE: return "Rate";
-        case ALLOCATION_MODE_SURPLUS: return "Surplus";
-        default: throw new Error(`Invalid AllocationMode number: ${n}`);
-    }
-}
-export function getRecipientType(who) {
-    if ("GuardIdentifier" in who)
-        return "GuardIdentifier";
-    if ("Entity" in who)
-        return "Entity";
-    return "Signer";
-}
-export function isSignerRecipient(who) {
-    return "Signer" in who;
-}
-export function isEntityRecipient(who) {
-    return "Entity" in who;
-}
-export function isGuardIdentifierRecipient(who) {
-    return "GuardIdentifier" in who;
-}
-export function getErrorName(code) {
-    for (const [name, c] of Object.entries(ALLOCATION_ERROR_CODES)) {
-        if (c === code)
-            return name;
-    }
-    return undefined;
-}
-export function getErrorDescription(code) {
-    const descriptions = {
-        1: "GuardIdentifier resolved value is not an address type",
-        2: "Allocator count exceeds MAX_ALLOCATOR_COUNT (100)",
-        3: "No Allocator in the allocators vector",
-        4: "Pure Rate mode sum != 10000 (no Surplus to absorb remainder)",
-        5: "Multiple Surplus sharing in a single Allocator",
-        6: "Rate + Surplus sum > 10000",
-        7: "balance < threshold (insufficient balance to trigger alloc)",
-        8: "allocators.allocators is empty",
-        9: "payment_info is None when alloc() is called",
-        10: "sharing count exceeds MAX_SHARING_COUNT (100)",
-        11: "sharing mode is not 0 (Amount) / 1 (Rate) / 2 (Surplus)",
-        12: "Amount sum (fix) < threshold",
-        13: "Amount sum (fix) > max",
-    };
-    return descriptions[code];
-}
+import{MAX_SHARING_COUNT,MAX_ALLOCATOR_COUNT}from'@wowok/wowok';export{MAX_ALLOCATOR_COUNT};export const ALLOCATION_MAX_SHARING_COUNT=MAX_SHARING_COUNT;export const ALLOCATION_MODE_AMOUNT=0x0;export const ALLOCATION_MODE_RATE=0x1;export const ALLOCATION_MODE_SURPLUS=0x2;export const RATE_TOTAL_FULL=0x2710;export const ALLOCATION_ERROR_CODES={'ERECIPIENT_IDENTIFIER_NOT_ADDRESS':0x1,'EALLOCATOR_COUNT_EXCEEDED':0x2,'ENO_ALLOCATOR':0x3,'ERATE_NOT_10000':0x4,'EMULTIPLE_SURPLUS':0x5,'ERATE_EXCEEDS_10000':0x6,'EINSUFFICIENT_BALANCE':0x7,'EALLOCATORS_EMPTY':0x8,'ENO_PAYMENT_INFO':0x9,'ESHARING_COUNT_EXCEEDED':0xa,'ESHARING_MODE_INVALID':0xb,'EAMOUNT_BELOW_THRESHOLD':0xc,'EAMOUNT_EXCEEDS_MAX':0xd};export const ORDER_ALLOCATION_ALREADY_SPECIFIED='E_ALLOCATION_ALREADY_SPECIFIED';export const ALLOCATION_SCENES=[{'id':'allocation_standard_three_way_split','name':'Standard\x20three-way\x20split\x20(merchant\x20/\x20platform\x20/\x20logistics)','trigger_source':'service_order_allocators','distribution_strategy':'pure_rate','coin_type_note':'All\x20three\x20Treasury\x20objects\x20must\x20use\x20the\x20same\x20Coin<T>\x20type\x20as\x20the\x20Allocation','typical_allocator_count':0x1,'sharing_who_types':['Entity'],'modes_used':['Rate'],'guard_requirement':'required','non_zero_threshold':![],'uses_max':![],'common_patterns':['Single\x20Allocator,\x203\x20Rate\x20sharing\x20items,\x20sum(rates)\x20===\x2010000','Each\x20sharing.who=Entity\x20points\x20to\x20a\x20Treasury\x20address','Guard\x20verifies\x20order.service\x20binding\x20(query\x201563)\x20to\x20prevent\x20cross-project\x20bypass','Guard\x20verifies\x20progress.current_node\x20===\x20\x27Complete\x27'],'dependencies':['Service','Treasury','Guard','Order','Progress','Machine','Payment'],'key_constraints':['F-A-05:\x20sum(rates)\x20===\x2010000\x20(pure\x20Rate\x20mode)','Treasury\x20Permission\x20should\x20match\x20Service\x20Permission\x20(R-A-12)','order_allocators\x20immutable\x20after\x20Service\x20publish\x20(R-A-10)'],'recommended_templates':['T-A-02']},{'id':'allocation_merchant_full_payment','name':'Merchant\x20full\x20payment\x20(single\x20recipient,\x20100%)','trigger_source':'service_order_allocators','distribution_strategy':'pure_rate','coin_type_note':'Simplest\x20configuration\x20—\x20single\x20Treasury\x20or\x20personal\x20address','typical_allocator_count':0x1,'sharing_who_types':['Entity'],'modes_used':['Rate'],'guard_requirement':'single_relaxed','non_zero_threshold':![],'uses_max':![],'common_patterns':['Single\x20Allocator,\x201\x20Rate\x20sharing\x20=\x2010000','Guard\x20only\x20verifies\x20order\x20status\x20(no\x20complex\x20conditions)','who=Entity\x20can\x20be\x20either\x20Treasury\x20or\x20personal\x20wallet'],'dependencies':['Service','Guard','Order','Payment'],'key_constraints':['Simplest\x20allocation\x20configuration','No\x20multi-party\x20coordination\x20required'],'recommended_templates':['T-A-01']},{'id':'allocation_refund_first_surplus_to_merchant','name':'Refund\x20first\x20+\x20surplus\x20to\x20merchant\x20(Amount\x20+\x20Surplus\x20hybrid)','trigger_source':'service_order_allocators','distribution_strategy':'amount_plus_surplus','coin_type_note':'Refund\x20amount\x20must\x20match\x20Coin<T>\x20precision','typical_allocator_count':0x1,'sharing_who_types':['Entity'],'modes_used':['Amount','Surplus'],'guard_requirement':'required','non_zero_threshold':!![],'uses_max':![],'common_patterns':['Single\x20Allocator,\x202\x20sharing\x20items','sharing[0]:\x20Amount=refund_value,\x20who=Entity(customer_address)','sharing[1]:\x20Surplus,\x20who=Entity(merchant_treasury)','fix\x20=\x20refund_value\x20(cached\x20Amount\x20sum)','threshold\x20=\x20refund_value\x20(ensure\x20sufficient\x20balance\x20for\x20Amount)'],'dependencies':['Service','Treasury','Guard','Order','Payment'],'key_constraints':['F-A-04:\x20at\x20most\x201\x20Surplus\x20per\x20Allocator','F-A-07:\x20fix\x20>=\x20threshold\x20(Amount\x20sum\x20must\x20cover\x20threshold)','fix\x20must\x20precisely\x20match\x20the\x20refund\x20amount'],'recommended_templates':['T-A-03']},{'id':'allocation_treasury_personal_alternatives','name':'Treasury\x20+\x20Personal\x20alternative\x20strategies\x20(caller-specified\x20guard)','trigger_source':'service_order_allocators','distribution_strategy':'first_match_alternatives','coin_type_note':'Both\x20target\x20addresses\x20must\x20accept\x20the\x20same\x20Coin<T>','typical_allocator_count':0x2,'sharing_who_types':['Entity'],'modes_used':['Rate'],'guard_requirement':'multiple_unique','non_zero_threshold':![],'uses_max':![],'common_patterns':['2\x20Allocators,\x20each\x20with\x201\x20Rate=10000\x20sharing','Allocator[0]:\x20guard=guard_treasury,\x20who=Entity(treasury_address)','Allocator[1]:\x20guard=guard_personal,\x20who=Entity(personal_address)','Two\x20Guard\x20objects\x20must\x20be\x20different\x20addresses\x20(R-A-11)','caller-specified\x20guard:\x20caller\x20selects\x20Treasury\x20or\x20Personal\x20path\x20via\x20alloc_by_guard;\x20passport::result_for_guard\x20hard-validates\x20(failure\x20aborts\x20with\x20E_VERIFY_FAILED;\x20caller\x20must\x20switch\x20guard\x20and\x20retry)'],'dependencies':['Service','Treasury','Guard','Order','Payment'],'key_constraints':['F-A-14:\x20allocators[].guard\x20must\x20be\x20unique','Treasury\x20Permission\x20should\x20match\x20Service\x20Permission\x20(R-A-12)','Guard\x20A\x20and\x20Guard\x20B\x20may\x20share\x20root/table\x20but\x20must\x20differ\x20in\x20description'],'recommended_templates':['T-A-04']},{'id':'allocation_tiered_by_order_amount','name':'Tiered\x20split\x20by\x20order\x20amount\x20(multi-Allocator\x20amount-threshold\x20switch)','trigger_source':'service_order_allocators','distribution_strategy':'tiered_by_amount','coin_type_note':'Amount\x20threshold\x20uses\x20Coin<T>\x20smallest\x20unit\x20(e.g.\x20MIST\x20for\x20WOW)','typical_allocator_count':0x2,'sharing_who_types':['Entity'],'modes_used':['Rate'],'guard_requirement':'multiple_unique','non_zero_threshold':![],'uses_max':![],'common_patterns':['2\x20Allocators\x20triggered\x20by\x20mutually\x20exclusive\x20Guard\x20conditions','Allocator[0]:\x20guard\x20verifies\x20order.amount\x20<\x20threshold,\x20Rate=10000\x20to\x20merchant','Allocator[1]:\x20guard\x20verifies\x20order.amount\x20>=\x20threshold,\x20Rate=8000/2000\x20split','caller-specified\x20guard:\x20caller\x20selects\x20the\x20matching\x20Allocator\x20based\x20on\x20order\x20amount;\x20allocator\x20order\x20is\x20irrelevant','Guard\x20queries\x20order.amount\x20(query\x201561)'],'dependencies':['Service','Treasury','Guard','Order','Payment'],'key_constraints':['Guard\x20conditions\x20must\x20be\x20mutually\x20exclusive\x20(R-A-4-02\x20design\x20clarity)','Caller\x20must\x20select\x20correct\x20guard\x20based\x20on\x20order.amount\x20(no\x20auto-fallback)'],'recommended_templates':['T-A-05']},{'id':'allocation_dynamic_recipient','name':'Multi-role\x20split\x20with\x20dynamic\x20recipient\x20(GuardIdentifier)','trigger_source':'service_order_allocators','distribution_strategy':'dynamic_recipient','coin_type_note':'Passport\x20table\x20must\x20contain\x20address-typed\x20entry\x20at\x20the\x20referenced\x20identifier','typical_allocator_count':0x1,'sharing_who_types':['Entity','GuardIdentifier'],'modes_used':['Rate'],'guard_requirement':'required','non_zero_threshold':![],'uses_max':![],'common_patterns':['Single\x20Allocator,\x203\x20Rate\x20sharing\x20items','sharing[0]:\x20Rate=8000,\x20who=Entity(merchant_treasury)','sharing[1]:\x20Rate=1000,\x20who=Entity(platform_treasury)','sharing[2]:\x20Rate=1000,\x20who=GuardIdentifier(0)\x20—\x20resolves\x20from\x20Passport\x20table','Customer\x20submits\x20Passport\x20with\x20referrer\x20address\x20at\x20identifier=0'],'dependencies':['Service','Treasury','Guard','Passport','Order','Payment'],'key_constraints':['F-A-13:\x20Passport\x20table[identifier]\x20must\x20be\x20address\x20type\x20(else\x20ERECIPIENT_IDENTIFIER_NOT_ADDRESS)','Guard\x20must\x20verify\x20Passport\x20completeness','Customer\x20order\x20must\x20include\x20Passport\x20with\x20referrer\x20address'],'recommended_templates':['T-A-06']},{'id':'allocation_arbitration_fees','name':'Arbitration\x20fees\x20split\x20(arbitrator\x20/\x20platform)','trigger_source':'arbitration_fees','distribution_strategy':'pure_rate','coin_type_note':'Coin<T>\x20must\x20match\x20Arbitration\x27s\x20fee\x20Coin\x20type','typical_allocator_count':0x1,'sharing_who_types':['Entity'],'modes_used':['Rate'],'guard_requirement':'required','non_zero_threshold':![],'uses_max':![],'common_patterns':['Triggered\x20by\x20Arbitration.fees_alloc\x20(permission\x20365)\x20or\x20fees_alloc_with_passport','Single\x20Allocator,\x202\x20Rate\x20sharing\x20items:\x208000\x20arbitrator\x20/\x202000\x20platform','payment_info\x20reuses\x20Arbitration\x27s\x20payment_info','Caller\x20must\x20hold\x20ARBITRATION_FEES_ALLOC=365\x20permission'],'dependencies':['Arbitration','Treasury','Guard','Payment'],'key_constraints':['Independent\x20from\x20Service-order\x20Allocation','Requires\x20ARBITRATION_FEES_ALLOC=365\x20permission'],'recommended_templates':['T-A-08']},{'id':'allocation_refund_to_order','name':'Refund\x20Allocator\x20(100%\x20to\x20Order\x20object)','trigger_source':'service_order_allocators','distribution_strategy':'refund_to_order','coin_type_note':'who=Entity\x20must\x20be\x20the\x20Order\x20object\x20address\x20(NOT\x20a\x20personal\x20wallet)','typical_allocator_count':0x1,'sharing_who_types':['Entity'],'modes_used':['Rate'],'guard_requirement':'required','non_zero_threshold':![],'uses_max':![],'common_patterns':['Single\x20Allocator,\x201\x20Rate=10000\x20sharing','who=Entity(order_address)\x20—\x20funds\x20flow\x20back\x20to\x20Order,\x20not\x20personal\x20wallet','Guard\x20verifies\x20customer\x20refund\x20request\x20and\x20eligibility','Customer-side\x20risk\x20assessment\x20adds\x208-point\x20weight\x20(customer/risk-assessment.ts)'],'dependencies':['Service','Guard','Order','Payment'],'key_constraints':['who=Entity\x20MUST\x20be\x20Order\x20object\x20address\x20(not\x20personal\x20address)','Customer\x20due-diligence\x20rewards\x20this\x20configuration\x20(8-point\x20weight)','Refund\x20funds\x20return\x20to\x20Order\x20for\x20downstream\x20handling'],'recommended_templates':['T-A-07']},{'id':'allocation_max_capped_retain','name':'Max-capped\x20allocation\x20(retain\x20residual\x20balance)','trigger_source':'service_order_allocators','distribution_strategy':'max_capped','coin_type_note':'max\x20field\x20uses\x20Coin<T>\x20smallest\x20unit','typical_allocator_count':0x1,'sharing_who_types':['Entity'],'modes_used':['Amount','Rate'],'guard_requirement':'required','non_zero_threshold':!![],'uses_max':!![],'common_patterns':['Single\x20Allocator\x20with\x20max\x20field\x20set','max\x20triple\x20role:\x20Amount\x20cap\x20+\x20Rate\x20base\x20+\x20Surplus\x20cap','Amount\x20sharing\x20consumes\x20fix;\x20Rate\x20sharing\x20uses\x20(max\x20-\x20fix)\x20as\x20base','Residual\x20balance\x20remains\x20in\x20Allocation\x20for\x20subsequent\x20alloc()\x20calls'],'dependencies':['Service','Treasury','Guard','Order','Payment'],'key_constraints':['F-A-08:\x20Amount\x20sum\x20<=\x20max\x20(EAMOUNT_EXCEEDS_MAX)','max\x20-\x20fix\x20becomes\x20Rate\x20base\x20(NOT\x20balance\x20-\x20fix)','Residual\x20balance\x20may\x20be\x20claimed\x20by\x20re-triggering\x20alloc()'],'recommended_templates':[]},{'id':'allocation_multi_node_trigger','name':'Multi-Machine-node\x20triggered\x20allocation\x20(Complete\x20/\x20Refund\x20/\x20Lost)','trigger_source':'service_order_allocators','distribution_strategy':'multi_node_trigger','coin_type_note':'All\x20Allocators\x20share\x20the\x20same\x20Allocation\x27s\x20Coin<T>','typical_allocator_count':0x3,'sharing_who_types':['Entity'],'modes_used':['Rate'],'guard_requirement':'multiple_unique','non_zero_threshold':![],'uses_max':![],'common_patterns':['3\x20Allocators\x20mapped\x20to\x20Machine\x20terminal\x20nodes\x20(Complete/Refund/Lost)','Each\x20Allocator\x27s\x20Guard\x20verifies\x20progress.current_node\x20==\x20<node_name>','Mutually\x20exclusive\x20Guard\x20conditions\x20(only\x20one\x20terminal\x20node\x20active\x20at\x20a\x20time)','Machine.required_allocators[]\x20describes\x20each\x20trigger_node\x20mapping'],'dependencies':['Service','Treasury','Guard','Order','Progress','Machine','Payment'],'key_constraints':['Guard\x20conditions\x20must\x20be\x20mutually\x20exclusive','Sequence-sensitive:\x20business-flow\x20order','Machine.required_allocators[trigger_node]\x20must\x20map\x20to\x20Allocator\x20indices'],'recommended_templates':[]},{'id':'allocation_standalone_periodic_split','name':'Standalone\x20periodic\x20split\x20(investment\x20dividends\x20/\x20shared\x20income)','trigger_source':'standalone','distribution_strategy':'periodic_split','coin_type_note':'Coin<T>\x20must\x20match\x20the\x20asset\x20being\x20distributed\x20(e.g.\x20profit\x20token)','typical_allocator_count':0x1,'sharing_who_types':['Entity'],'modes_used':['Rate'],'guard_requirement':'required','non_zero_threshold':![],'uses_max':![],'common_patterns':['Single\x20Allocator,\x20N\x20Rate\x20sharing\x20items,\x20sum(rates)\x20===\x2010000','Each\x20sharing.who=Entity\x20points\x20to\x20a\x20beneficiary\x20wallet\x20(not\x20Treasury)','Guard\x20verifies\x20time-based\x20trigger\x20(e.g.\x20context(Clock).timestamp\x20>=\x20next_release)\x20or\x20signer\x20authorization','User\x20calls\x20receive()\x20to\x20deposit\x20funds,\x20then\x20alloc()\x20to\x20trigger\x20distribution','No\x20Service/Order/Progress/Machine\x20context\x20required'],'dependencies':['Treasury','Guard','Payment'],'key_constraints':['F-A-05:\x20sum(rates)\x20===\x2010000\x20(pure\x20Rate\x20mode)','R-A-3-04:\x20standalone\x20mode\x20has\x20no\x20Service-layer\x20access\x20control\x20—\x20Guard\x20+\x20Passport\x20MUST\x20be\x20sufficient','Caller\x20is\x20fully\x20responsible\x20for\x20receive\x20→\x20alloc\x20lifecycle\x20(no\x20auto-trigger)','Guard\x20should\x20bind\x20Signer\x20to\x20prevent\x20unauthorized\x20alloc()\x20calls'],'recommended_templates':['T-A-09']},{'id':'allocation_standalone_vesting','name':'Standalone\x20vesting\x20release\x20(time-locked\x20multi-stage\x20unlock)','trigger_source':'standalone','distribution_strategy':'time_locked_vesting','coin_type_note':'Coin<T>\x20must\x20match\x20the\x20vested\x20asset\x20(e.g.\x20locked\x20team\x20tokens)','typical_allocator_count':0x3,'sharing_who_types':['Entity'],'modes_used':['Amount','Rate','Surplus'],'guard_requirement':'multiple_unique','non_zero_threshold':!![],'uses_max':!![],'common_patterns':['N\x20Allocators,\x20each\x20mapped\x20to\x20a\x20vesting\x20stage\x20(e.g.\x2025%\x20at\x20month\x2012,\x2025%\x20at\x20month\x2024,\x2050%\x20surplus\x20at\x20month\x2036)','Each\x20Allocator\x27s\x20Guard\x20verifies\x20context(Clock).timestamp\x20>=\x20stage_unlock_time','Amount\x20sharing\x20per\x20stage\x20with\x20max\x20field\x20capping\x20the\x20cumulative\x20release','Final\x20Allocator\x20uses\x20Surplus\x20to\x20drain\x20remaining\x20balance\x20after\x20last\x20vesting\x20stage','Mutually\x20exclusive\x20Guard\x20conditions\x20(only\x20one\x20stage\x20active\x20at\x20a\x20time,\x20based\x20on\x20timestamp)','User\x20calls\x20receive()\x20to\x20deposit\x20locked\x20tokens,\x20then\x20alloc()\x20at\x20each\x20vesting\x20milestone'],'dependencies':['Treasury','Guard','Passport','Payment'],'key_constraints':['F-A-04:\x20at\x20most\x201\x20Surplus\x20per\x20Allocator\x20(final\x20stage\x20uses\x20Surplus\x20to\x20drain\x20remainder)','F-A-08:\x20Amount\x20sum\x20<=\x20max\x20(EAMOUNT_EXCEEDS_MAX)','R-A-3-04:\x20standalone\x20mode\x20has\x20no\x20Service-layer\x20access\x20control\x20—\x20Guard\x20time-lock\x20MUST\x20be\x20enforced','Guard\x20conditions\x20must\x20be\x20mutually\x20exclusive\x20by\x20timestamp\x20(R-A-4-02)','Caller\x20must\x20wait\x20for\x20time-lock\x20expiry\x20before\x20alloc()\x20succeeds;\x20otherwise\x20alloc()\x20silently\x20returns\x20(R-A-4-01)'],'recommended_templates':['T-A-10']}];export const ALLOCATION_LEDGER_VERSION='1.0.0';export function getScenesByTriggerSource(a){return ALLOCATION_SCENES['filter'](b=>b['trigger_source']===a);}export function getScenesByMode(a){return ALLOCATION_SCENES['filter'](b=>b['modes_used']['includes'](a));}export function getScenesByStrategy(a){return ALLOCATION_SCENES['filter'](b=>b['distribution_strategy']===a);}export function findSceneById(a){return ALLOCATION_SCENES['find'](b=>b['id']===a);}export function inferSceneFromIntent(a){const b=a['toLowerCase']();if(b['includes']('arbitration')||b['includes']('fees_alloc'))return findSceneById('allocation_arbitration_fees');if(b['includes']('standalone')||b['includes']('periodic\x20split')||b['includes']('investment\x20dividend')||b['includes']('shared\x20income')||b['includes']('dividend'))return findSceneById('allocation_standalone_periodic_split');if(b['includes']('vesting')||b['includes']('time-lock')||b['includes']('unlock\x20period')||b['includes']('locked\x20release')||b['includes']('token\x20unlock'))return findSceneById('allocation_standalone_vesting');if(b['includes']('refund')){if(b['includes']('order')||b['includes']('100%'))return findSceneById('allocation_refund_to_order');if(b['includes']('surplus')||b['includes']('merchant'))return findSceneById('allocation_refund_first_surplus_to_merchant');}if(b['includes']('alternative')||b['includes']('priority')||b['includes']('treasury')&&b['includes']('personal'))return findSceneById('allocation_treasury_personal_alternatives');if(b['includes']('tiered')||b['includes']('threshold\x20switch'))return findSceneById('allocation_tiered_by_order_amount');if(b['includes']('dynamic\x20recipient')||b['includes']('referrer')||b['includes']('guardidentifier'))return findSceneById('allocation_dynamic_recipient');if(b['includes']('retain')||b['includes']('max'))return findSceneById('allocation_max_capped_retain');if(b['includes']('multi-node')||b['includes']('multi\x20machine')||b['includes']('multi_node'))return findSceneById('allocation_multi_node_trigger');const c=(a['match'](/%/g)||[])['length'];if(c<=0x1)return findSceneById('allocation_merchant_full_payment');if(c>=0x2)return findSceneById('allocation_standard_three_way_split');return undefined;}export function getAllScenes(){return[...ALLOCATION_SCENES];}export function getScenesCount(){return ALLOCATION_SCENES['length'];}export function allocationModeToNumber(a){switch(a){case'Amount':return ALLOCATION_MODE_AMOUNT;case'Rate':return ALLOCATION_MODE_RATE;case'Surplus':return ALLOCATION_MODE_SURPLUS;}}export function allocationModeFromNumber(a){switch(a){case ALLOCATION_MODE_AMOUNT:return'Amount';case ALLOCATION_MODE_RATE:return'Rate';case ALLOCATION_MODE_SURPLUS:return'Surplus';default:throw new Error('Invalid\x20AllocationMode\x20number:\x20'+a);}}export function getRecipientType(a){if('GuardIdentifier'in a)return'GuardIdentifier';if('Entity'in a)return'Entity';return'Signer';}export function isSignerRecipient(a){return'Signer'in a;}export function isEntityRecipient(a){return'Entity'in a;}export function isGuardIdentifierRecipient(a){return'GuardIdentifier'in a;}export function getErrorName(a){for(const [b,d]of Object['entries'](ALLOCATION_ERROR_CODES)){if(d===a)return b;}return undefined;}export function getErrorDescription(a){const b={0x1:'GuardIdentifier\x20resolved\x20value\x20is\x20not\x20an\x20address\x20type',0x2:'Allocator\x20count\x20exceeds\x20MAX_ALLOCATOR_COUNT\x20(100)',0x3:'No\x20Allocator\x20in\x20the\x20allocators\x20vector',0x4:'Pure\x20Rate\x20mode\x20sum\x20!=\x2010000\x20(no\x20Surplus\x20to\x20absorb\x20remainder)',0x5:'Multiple\x20Surplus\x20sharing\x20in\x20a\x20single\x20Allocator',0x6:'Rate\x20+\x20Surplus\x20sum\x20>\x2010000',0x7:'balance\x20<\x20threshold\x20(insufficient\x20balance\x20to\x20trigger\x20alloc)',0x8:'allocators.allocators\x20is\x20empty',0x9:'payment_info\x20is\x20None\x20when\x20alloc()\x20is\x20called',0xa:'sharing\x20count\x20exceeds\x20MAX_SHARING_COUNT\x20(100)',0xb:'sharing\x20mode\x20is\x20not\x200\x20(Amount)\x20/\x201\x20(Rate)\x20/\x202\x20(Surplus)',0xc:'Amount\x20sum\x20(fix)\x20<\x20threshold',0xd:'Amount\x20sum\x20(fix)\x20>\x20max'};return b[a];}