@wowok/agent-mcp 2.7.2 → 2.7.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/config/runtime.js +1 -1
- package/dist/customer/account-events.d.ts +32 -0
- package/dist/customer/account-events.js +1 -0
- package/dist/customer/customer-advice.d.ts +1 -0
- package/dist/customer/customer-advice.js +1 -1
- package/dist/customer/info-puzzle.js +1 -1
- package/dist/customer/order-strategy.d.ts +1 -1
- package/dist/customer/reminder-system.d.ts +2 -0
- package/dist/customer/reminder-system.js +1 -1
- package/dist/customer/risk-assessment.d.ts +1 -0
- package/dist/customer/risk-assessment.js +1 -1
- package/dist/customer/types.d.ts +2 -0
- package/dist/evaluation/builtins/arbitration-score.d.ts +41 -0
- package/dist/evaluation/builtins/arbitration-score.js +1 -0
- package/dist/evaluation/builtins/index.d.ts +1 -0
- package/dist/evaluation/builtins/index.js +1 -1
- package/dist/evaluation/category-match-rules.d.ts +30 -0
- package/dist/evaluation/category-match-rules.js +1 -0
- package/dist/evaluation/engine.js +1 -1
- package/dist/evaluation/extract.js +1 -1
- package/dist/evaluation/index.d.ts +1 -0
- package/dist/evaluation/index.js +1 -1
- package/dist/evaluation/location-match.d.ts +42 -0
- package/dist/evaluation/location-match.js +1 -0
- package/dist/evaluation/path-reasoning.d.ts +35 -0
- package/dist/evaluation/path-reasoning.js +1 -0
- package/dist/evaluation/region.d.ts +6 -0
- package/dist/evaluation/region.js +1 -1
- package/dist/evaluation/types.d.ts +17 -0
- package/dist/experience/realtime-feedback.js +1 -1
- package/dist/experience/user-profile.d.ts +1 -1
- package/dist/extensions/index.d.ts +6 -0
- package/dist/extensions/index.js +1 -1
- package/dist/extensions/industry-layers.d.ts +75 -0
- package/dist/extensions/industry-layers.js +1 -0
- package/dist/extensions/industry-pack.d.ts +105 -0
- package/dist/extensions/industry-pack.js +1 -0
- package/dist/extensions/metric-registry.js +1 -1
- package/dist/extensions/mode-evaluator.d.ts +1 -1
- package/dist/extensions/registry.d.ts +1 -0
- package/dist/extensions/registry.js +1 -1
- package/dist/graph/base.d.ts +8 -0
- package/dist/graph/base.js +1 -0
- package/dist/harness/index.d.ts +1 -0
- package/dist/harness/index.js +1 -1
- package/dist/harness/plan.d.ts +2 -0
- package/dist/harness/plan.js +1 -1
- package/dist/harness/recover.d.ts +1 -1
- package/dist/harness/types.d.ts +2 -3
- package/dist/index.js +1 -1
- package/dist/knowledge/allocation-confirm.js +1 -1
- package/dist/knowledge/anti-cheat.d.ts +37 -0
- package/dist/knowledge/anti-cheat.js +1 -0
- package/dist/knowledge/arb-confirm.d.ts +28 -0
- package/dist/knowledge/arb-confirm.js +1 -0
- package/dist/knowledge/arb-translation.d.ts +48 -0
- package/dist/knowledge/arb-translation.js +1 -0
- package/dist/knowledge/arbitration-context.js +1 -1
- package/dist/knowledge/arbitration-ledger.js +1 -1
- package/dist/knowledge/bridge-confirm.d.ts +26 -0
- package/dist/knowledge/bridge-confirm.js +1 -0
- package/dist/knowledge/bridge-translation.d.ts +37 -0
- package/dist/knowledge/bridge-translation.js +1 -0
- package/dist/knowledge/contact-confirm.d.ts +27 -0
- package/dist/knowledge/contact-confirm.js +1 -0
- package/dist/knowledge/contact-translation.d.ts +39 -0
- package/dist/knowledge/contact-translation.js +1 -0
- package/dist/knowledge/demand-confirm.js +1 -1
- package/dist/knowledge/demand-context.d.ts +17 -0
- package/dist/knowledge/demand-context.js +1 -0
- package/dist/knowledge/demand-ledger.d.ts +26 -0
- package/dist/knowledge/demand-ledger.js +1 -0
- package/dist/knowledge/demand-puzzle.d.ts +29 -0
- package/dist/knowledge/demand-puzzle.js +1 -0
- package/dist/knowledge/demand-risk.js +1 -1
- package/dist/knowledge/demand-templates.d.ts +12 -0
- package/dist/knowledge/demand-templates.js +1 -0
- package/dist/knowledge/demand-translation.js +1 -1
- package/dist/knowledge/deployment-scanner.js +1 -1
- package/dist/knowledge/evidence-review.d.ts +12 -0
- package/dist/knowledge/evidence-review.js +1 -0
- package/dist/knowledge/examples-scanner-cli.js +1 -1
- package/dist/knowledge/examples-scanner.js +1 -1
- package/dist/knowledge/flywheel-loop.d.ts +0 -1
- package/dist/knowledge/flywheel-loop.js +1 -1
- package/dist/knowledge/guard-design-patterns.js +1 -1
- package/dist/knowledge/guard-migration.d.ts +1 -1
- package/dist/knowledge/index.d.ts +71 -3
- package/dist/knowledge/index.js +1 -1
- package/dist/knowledge/industry-registry.js +1 -1
- package/dist/knowledge/machine-render.js +1 -1
- package/dist/knowledge/market-metrics.d.ts +12 -0
- package/dist/knowledge/market-metrics.js +1 -0
- package/dist/knowledge/market-operations.d.ts +46 -0
- package/dist/knowledge/market-operations.js +1 -0
- package/dist/knowledge/mcp-schema-audit-cli.js +1 -1
- package/dist/knowledge/mcp-schema-audit.d.ts +22 -22
- package/dist/knowledge/mcp-schema-audit.js +1 -1
- package/dist/knowledge/onchain-constants.d.ts +2 -2
- package/dist/knowledge/onchain-constants.js +1 -1
- package/dist/knowledge/payment-confirm.d.ts +26 -0
- package/dist/knowledge/payment-confirm.js +1 -0
- package/dist/knowledge/payment-risk.js +1 -1
- package/dist/knowledge/payment-translation.d.ts +37 -0
- package/dist/knowledge/payment-translation.js +1 -0
- package/dist/knowledge/permission-context.d.ts +11 -0
- package/dist/knowledge/permission-context.js +1 -1
- package/dist/knowledge/permission-ledger.d.ts +11 -0
- package/dist/knowledge/permission-ledger.js +1 -1
- package/dist/knowledge/personal-confirm.d.ts +29 -0
- package/dist/knowledge/personal-confirm.js +1 -0
- package/dist/knowledge/personal-risk.js +1 -1
- package/dist/knowledge/personal-translation.d.ts +37 -0
- package/dist/knowledge/personal-translation.js +1 -0
- package/dist/knowledge/process-model.d.ts +1 -11
- package/dist/knowledge/process-model.js +1 -1
- package/dist/knowledge/progress-ledger.js +1 -1
- package/dist/knowledge/progress-risk.js +1 -1
- package/dist/knowledge/progress-templates.js +1 -1
- package/dist/knowledge/progress-translation.js +1 -1
- package/dist/knowledge/proof-context.d.ts +17 -0
- package/dist/knowledge/proof-context.js +1 -0
- package/dist/knowledge/proof-ledger.d.ts +34 -0
- package/dist/knowledge/proof-ledger.js +1 -0
- package/dist/knowledge/proof-puzzle.d.ts +35 -0
- package/dist/knowledge/proof-puzzle.js +1 -0
- package/dist/knowledge/proof-templates.d.ts +22 -0
- package/dist/knowledge/proof-templates.js +1 -0
- package/dist/knowledge/registrar-confirm.d.ts +26 -0
- package/dist/knowledge/registrar-confirm.js +1 -0
- package/dist/knowledge/registrar-risk.js +1 -1
- package/dist/knowledge/registrar-translation.d.ts +37 -0
- package/dist/knowledge/registrar-translation.js +1 -0
- package/dist/knowledge/repository-context.d.ts +12 -0
- package/dist/knowledge/repository-context.js +1 -0
- package/dist/knowledge/repository-ledger.d.ts +25 -0
- package/dist/knowledge/repository-ledger.js +1 -0
- package/dist/knowledge/repository-puzzle.d.ts +30 -0
- package/dist/knowledge/repository-puzzle.js +1 -0
- package/dist/knowledge/repository-templates.d.ts +14 -0
- package/dist/knowledge/repository-templates.js +1 -0
- package/dist/knowledge/resource-confirm.d.ts +25 -0
- package/dist/knowledge/resource-confirm.js +1 -0
- package/dist/knowledge/resource-translation.d.ts +37 -0
- package/dist/knowledge/resource-translation.js +1 -0
- package/dist/knowledge/reward-context.d.ts +2 -2
- package/dist/knowledge/reward-ledger.js +1 -1
- package/dist/knowledge/reward-translation.js +1 -1
- package/dist/knowledge/safety-rules.d.ts +1 -0
- package/dist/knowledge/safety-rules.js +1 -1
- package/dist/knowledge/service-risk.d.ts +1 -1
- package/dist/knowledge/service-risk.js +1 -1
- package/dist/knowledge/template-registry.js +1 -1
- package/dist/knowledge/tools-reference.js +1 -1
- package/dist/knowledge/treasury-context.d.ts +1 -1
- package/dist/knowledge/treasury-context.js +1 -1
- package/dist/knowledge/treasury-ledger.js +1 -1
- package/dist/knowledge/treasury-risk.js +1 -1
- package/dist/knowledge/universal-template.d.ts +22 -0
- package/dist/knowledge/universal-template.js +1 -0
- package/dist/knowledge/util-confirm.d.ts +24 -0
- package/dist/knowledge/util-confirm.js +1 -0
- package/dist/knowledge/util-risk.js +1 -1
- package/dist/knowledge/util-translation.d.ts +39 -0
- package/dist/knowledge/util-translation.js +1 -0
- package/dist/knowledge/workflow-guidance.d.ts +180 -0
- package/dist/knowledge/workflow-guidance.js +1 -0
- package/dist/participation/employee-kpi.d.ts +25 -0
- package/dist/participation/employee-kpi.js +1 -0
- package/dist/participation/employee-store.d.ts +16 -0
- package/dist/participation/employee-store.js +1 -0
- package/dist/participation/index.d.ts +2 -0
- package/dist/participation/index.js +1 -0
- package/dist/persona/defaults.js +1 -1
- package/dist/persona/index.d.ts +9 -2
- package/dist/persona/index.js +1 -1
- package/dist/persona/local-region.d.ts +20 -0
- package/dist/persona/local-region.js +1 -0
- package/dist/persona/model.js +1 -1
- package/dist/persona/overrides.d.ts +10 -0
- package/dist/persona/overrides.js +1 -0
- package/dist/persona/pack-personae.d.ts +11 -0
- package/dist/persona/pack-personae.js +1 -0
- package/dist/persona/strategy-intent.d.ts +20 -0
- package/dist/persona/strategy-intent.js +1 -0
- package/dist/persona/types.d.ts +3 -1
- package/dist/project/business-puzzle.d.ts +1 -1
- package/dist/project/business-puzzle.js +1 -1
- package/dist/project/deployment-doc.js +1 -1
- package/dist/project/edit-planner.js +1 -1
- package/dist/project/evaluation.d.ts +37 -1
- package/dist/project/evaluation.js +1 -1
- package/dist/project/graph-builder.d.ts +2 -2
- package/dist/project/graph-builder.js +1 -1
- package/dist/project/graph.d.ts +3 -6
- package/dist/project/handlers.d.ts +33 -2
- package/dist/project/handlers.js +1 -1
- package/dist/project/index.d.ts +1 -0
- package/dist/project/index.js +1 -1
- package/dist/project/merchant-guide.d.ts +19 -0
- package/dist/project/merchant-guide.js +1 -1
- package/dist/project/mode-actions.js +1 -1
- package/dist/project/rollback-policy.js +1 -1
- package/dist/project/semantic-assembler.d.ts +2 -2
- package/dist/project/semantic-assembler.js +1 -1
- package/dist/project/semantic-graph.d.ts +3 -5
- package/dist/project/workflow-design-assessment.d.ts +24 -0
- package/dist/project/workflow-design-assessment.js +1 -0
- package/dist/safety/confirm-gate.d.ts +1 -1
- package/dist/safety/confirm-gate.js +1 -1
- package/dist/schema/call/allocation.d.ts +186 -1385
- package/dist/schema/call/arbitration.d.ts +272 -1871
- package/dist/schema/call/base.d.ts +1831 -9076
- package/dist/schema/call/base.js +1 -1
- package/dist/schema/call/bridge.d.ts +911 -3171
- package/dist/schema/call/contact.d.ts +135 -931
- package/dist/schema/call/demand.d.ts +164 -1194
- package/dist/schema/call/guard.d.ts +298 -1140
- package/dist/schema/call/guard.js +1 -1
- package/dist/schema/call/machine.d.ts +459 -5403
- package/dist/schema/call/machine.js +1 -1
- package/dist/schema/call/order.d.ts +137 -844
- package/dist/schema/call/payment.d.ts +74 -561
- package/dist/schema/call/permission.d.ts +335 -2791
- package/dist/schema/call/personal.d.ts +227 -1814
- package/dist/schema/call/progress.d.ts +140 -843
- package/dist/schema/call/proof.d.ts +42 -258
- package/dist/schema/call/repository.d.ts +324 -2222
- package/dist/schema/call/reward.d.ts +153 -1183
- package/dist/schema/call/semantic.js +1 -1
- package/dist/schema/call/service.d.ts +376 -3431
- package/dist/schema/call/treasury.d.ts +252 -2158
- package/dist/schema/common/index.d.ts +222 -697
- package/dist/schema/common/index.js +1 -1
- package/dist/schema/config/index.d.ts +18 -161
- package/dist/schema/employee/index.d.ts +99 -0
- package/dist/schema/employee/index.js +1 -0
- package/dist/schema/evaluation/index.d.ts +1035 -3918
- package/dist/schema/evaluation/index.js +1 -1
- package/dist/schema/index.d.ts +5 -0
- package/dist/schema/index.js +1 -1
- package/dist/schema/industry-pack/index.d.ts +132 -0
- package/dist/schema/industry-pack/index.js +1 -0
- package/dist/schema/intent-radar/index.d.ts +92 -245
- package/dist/schema/intent-radar/index.js +1 -1
- package/dist/schema/local/index.d.ts +2045 -18080
- package/dist/schema/local/index.js +1 -1
- package/dist/schema/local/wip.d.ts +61 -651
- package/dist/schema/local/wip.js +1 -1
- package/dist/schema/messenger/index.d.ts +949 -5557
- package/dist/schema/messenger/index.js +1 -1
- package/dist/schema/operations.d.ts +3168 -26468
- package/dist/schema/operations.js +1 -1
- package/dist/schema/permission/index.d.ts +121 -0
- package/dist/schema/permission/index.js +1 -0
- package/dist/schema/persona/index.d.ts +469 -1820
- package/dist/schema/persona/index.js +1 -1
- package/dist/schema/project/index.d.ts +1023 -8450
- package/dist/schema/project/index.js +1 -1
- package/dist/schema/query/index.d.ts +12121 -75556
- package/dist/schema/query/index.js +1 -1
- package/dist/schema/schema-query/index.d.ts +35 -98
- package/dist/schema/schema-query/index.js +1 -1
- package/dist/schema/schema-version.js +1 -1
- package/dist/schema/task-status.d.ts +26 -132
- package/dist/schema/trust/index.d.ts +194 -1290
- package/dist/schema/utils/guard-parser.js +1 -1
- package/dist/schema/utils/node-parser.js +1 -1
- package/dist/schema/utils/skills-recommendation.d.ts +1 -0
- package/dist/schema/utils/skills-recommendation.js +1 -1
- package/dist/schema/workflow/index.d.ts +161 -0
- package/dist/schema/workflow/index.js +1 -0
- package/dist/schema/workspace/index.d.ts +69 -0
- package/dist/schema/workspace/index.js +1 -0
- package/dist/{schema-query → schema-query-impl}/index.js +1 -1
- package/dist/schemas/account_operation.output.json +3147 -1655
- package/dist/schemas/account_operation.schema.json +225 -218
- package/dist/schemas/bridge_operation.output.json +1168 -653
- package/dist/schemas/bridge_operation.schema.json +736 -504
- package/dist/schemas/config_operation.output.json +185 -179
- package/dist/schemas/config_operation.schema.json +21 -26
- package/dist/schemas/employee_operation.output.json +207 -0
- package/dist/schemas/employee_operation.schema.json +176 -0
- package/dist/schemas/evaluation_operation.output.json +2268 -601
- package/dist/schemas/evaluation_operation.schema.json +2919 -787
- package/dist/schemas/guard2file.output.json +58 -64
- package/dist/schemas/guard2file.schema.json +79 -81
- package/dist/schemas/index.json +41 -11
- package/dist/schemas/industry_pack_operation.output.json +594 -0
- package/dist/schemas/industry_pack_operation.schema.json +55 -0
- package/dist/schemas/intent_radar.output.json +275 -203
- package/dist/schemas/intent_radar.schema.json +124 -126
- package/dist/schemas/local_info_operation.output.json +1174 -660
- package/dist/schemas/local_info_operation.schema.json +119 -125
- package/dist/schemas/local_mark_operation.output.json +1239 -692
- package/dist/schemas/local_mark_operation.schema.json +91 -96
- package/dist/schemas/machineNode2file.output.json +63 -69
- package/dist/schemas/machineNode2file.schema.json +79 -81
- package/dist/schemas/messenger_operation.output.json +2722 -1531
- package/dist/schemas/messenger_operation.schema.json +1482 -1264
- package/dist/schemas/onchain_events.output.json +2590 -978
- package/dist/schemas/onchain_events.schema.json +117 -99
- package/dist/schemas/onchain_operations.output.json +3957 -2312
- package/dist/schemas/onchain_operations.schema.json +20799 -9285
- package/dist/schemas/onchain_operations_allocation.schema.json +171 -107
- package/dist/schemas/onchain_operations_arbitration.schema.json +233 -146
- package/dist/schemas/onchain_operations_contact.schema.json +129 -90
- package/dist/schemas/onchain_operations_demand.schema.json +170 -112
- package/dist/schemas/onchain_operations_gen_passport.schema.json +61 -646
- package/dist/schemas/onchain_operations_gen_proof.schema.json +40 -172
- package/dist/schemas/onchain_operations_guard.schema.json +3765 -294
- package/dist/schemas/onchain_operations_machine.schema.json +536 -163
- package/dist/schemas/onchain_operations_order.schema.json +126 -96
- package/dist/schemas/onchain_operations_payment.schema.json +82 -67
- package/dist/schemas/onchain_operations_permission.schema.json +331 -93
- package/dist/schemas/onchain_operations_personal.schema.json +636 -96
- package/dist/schemas/onchain_operations_progress.schema.json +125 -92
- package/dist/schemas/onchain_operations_proof.schema.json +76 -69
- package/dist/schemas/onchain_operations_repository.schema.json +636 -249
- package/dist/schemas/onchain_operations_reward.schema.json +218 -108
- package/dist/schemas/onchain_operations_service.schema.json +678 -220
- package/dist/schemas/onchain_operations_treasury.schema.json +401 -135
- package/dist/schemas/onchain_table_data.output.json +6833 -2432
- package/dist/schemas/onchain_table_data.schema.json +684 -417
- package/dist/schemas/permission_operation.output.json +173 -0
- package/dist/schemas/permission_operation.schema.json +39 -0
- package/dist/schemas/persona_operation.output.json +1568 -268
- package/dist/schemas/persona_operation.schema.json +346 -205
- package/dist/schemas/project_operation.output.json +6922 -5132
- package/dist/schemas/project_operation.schema.json +1050 -1020
- package/dist/schemas/query_task_status.output.json +195 -99
- package/dist/schemas/query_task_status.schema.json +12 -18
- package/dist/schemas/query_toolkit.output.json +18862 -14561
- package/dist/schemas/query_toolkit.schema.json +614 -522
- package/dist/schemas/schema_query.output.json +127 -129
- package/dist/schemas/schema_query.schema.json +64 -69
- package/dist/schemas/trust_score.output.json +678 -587
- package/dist/schemas/trust_score.schema.json +289 -277
- package/dist/schemas/wip_file.output.json +116 -124
- package/dist/schemas/wip_file.schema.json +142 -143
- package/dist/schemas/workflow_operation.output.json +164 -0
- package/dist/schemas/workflow_operation.schema.json +116 -0
- package/dist/schemas/workspace_operation.output.json +277 -0
- package/dist/schemas/workspace_operation.schema.json +45 -0
- package/dist/schemas/wowok_buildin_info.output.json +1682 -844
- package/dist/schemas/wowok_buildin_info.schema.json +576 -526
- package/dist/tools/handlers/bridge.d.ts +8 -1
- package/dist/tools/handlers/bridge.js +1 -1
- package/dist/tools/handlers/config.js +1 -1
- package/dist/tools/handlers/employee.d.ts +2 -0
- package/dist/tools/handlers/employee.js +1 -0
- package/dist/tools/handlers/evaluation.js +1 -1
- package/dist/tools/handlers/file-export.js +1 -1
- package/dist/tools/handlers/industry-pack.d.ts +2 -0
- package/dist/tools/handlers/industry-pack.js +1 -0
- package/dist/tools/handlers/onchain.js +1 -1
- package/dist/tools/handlers/permission.d.ts +2 -0
- package/dist/tools/handlers/permission.js +1 -0
- package/dist/tools/handlers/persona.js +1 -1
- package/dist/tools/handlers/project.js +1 -1
- package/dist/tools/handlers/query.js +1 -1
- package/dist/tools/handlers/schema-query.js +1 -1
- package/dist/tools/handlers/trust.js +1 -1
- package/dist/tools/handlers/wip.js +1 -1
- package/dist/tools/handlers/workflow.d.ts +2 -0
- package/dist/tools/handlers/workflow.js +1 -0
- package/dist/tools/handlers/workspace.d.ts +4 -0
- package/dist/tools/handlers/workspace.js +1 -0
- package/dist/tools/index.d.ts +2 -1
- package/dist/tools/index.js +1 -1
- package/dist/tools/rules-hook.d.ts +1 -1
- package/dist/tools/rules-hook.js +1 -1
- package/dist/tools/shared.d.ts +1 -1
- package/dist/tools/shared.js +1 -1
- package/dist/tools/types.d.ts +2 -1
- package/package.json +4 -5
- package/dist/knowledge/arbitration-trust.d.ts +0 -24
- package/dist/knowledge/arbitration-trust.js +0 -1
- package/dist/schema/call/bridge-handler.d.ts +0 -8
- package/dist/schema/call/bridge-handler.js +0 -1
- package/dist/schema/sync-layer4.d.ts +0 -21
- package/dist/schema/sync-layer4.js +0 -1
- /package/dist/{schema-query → schema-query-impl}/index.d.ts +0 -0
|
@@ -0,0 +1 @@
|
|
|
1
|
+
import{MAX_IM_COUNT}from'@wowok/wowok';export const CONTACT_TRANSLATION_VERSION='1.0.0';export const SEMANTIC_TO_CONTACT_SCHEMA_RULES=[{'id':'P-CONTACT-01','pattern_name':'Create\x20contact','semantic_intent':'Create\x20a\x20shared\x20Contact\x20object\x20owned\x20by\x20a\x20Permission\x20(index\x20450).','match_keywords':['create\x20contact','new\x20contact','customer\x20service'],'required_fields':['permission','description'],'optional_fields':[],'example':{'description':'Customer\x20service\x20contact'}},{'id':'P-CONTACT-02','pattern_name':'Add\x20IM\x20member','semantic_intent':'Add\x20an\x20IM\x20entry\x20to\x20the\x20contact\x20list\x20(permission\x20index\x20453).','match_keywords':['add\x20im','add\x20member','add\x20contact\x20im'],'required_fields':['im'],'optional_fields':['description'],'example':{'im':'0x...','description':'support\x20desk'}},{'id':'P-CONTACT-03','pattern_name':'Set\x20location','semantic_intent':'Set\x20the\x20contact\x27s\x20geographic\x20region\x20(permission\x20index\x20452,\x20LONG_NAME).','match_keywords':['set\x20location','update\x20location'],'required_fields':['location'],'optional_fields':[],'example':{'location':'cn-guangdong-shenzhen'}}];export const CONTACT_FIELD_TRANSLATIONS=[{'field_name':'description','value_type':'string','semantic':'Human-readable\x20description\x20of\x20the\x20Contact\x20(common::DESCRIPTION\x20validation).','format_example':'Customer\x20service\x20contact','validation_rules':['common::DESCRIPTION\x20max\x20length']},{'field_name':'location','value_type':'string','semantic':'Geographic\x20region\x20string;\x20defaults\x20to\x20empty\x20(unset).','format_example':'cn-guangdong-shenzhen','validation_rules':['common::LONG_NAME\x20validation','empty\x20means\x20unset']},{'field_name':'ims','value_type':'vector<Im>','semantic':'IM\x20entry\x20list\x20(≤\x20MAX_IM_COUNT\x20'+MAX_IM_COUNT+').\x20Each\x20Im\x20has\x20at/status/join_time/description.','format_example':'[{at,\x20status,\x20join_time,\x20description}]','validation_rules':['im_add\x20aborts\x20E_IM_COUNT_EXCEEDED\x20(1)\x20at\x20cap']},{'field_name':'permission','value_type':'address','semantic':'Owning\x20Permission\x20address\x20(set\x20at\x20creation).','format_example':'0x...permission...','validation_rules':['set\x20via\x20new(permission,\x20…)\x20index\x20450']}];export const CONTACT_CONSTRAINT_RULES=[{'id':'CONTACT_C_01','name':'IM\x20count\x20cap','description':'ims\x20length\x20<\x20MAX_IM_COUNT\x20('+MAX_IM_COUNT+').','related_field':'ims'},{'id':'CONTACT_C_02','name':'description\x20validation','description':'description\x20uses\x20common::DESCRIPTION.','related_field':'description'},{'id':'CONTACT_C_03','name':'location\x20validation','description':'location\x20uses\x20common::LONG_NAME.','related_field':'location'},{'id':'CONTACT_C_04','name':'im\x20description\x20validation','description':'im_add\x20description\x20uses\x20common::LONG_NAME\x20(not\x20DESCRIPTION).','related_field':'ims'},{'id':'CONTACT_C_05','name':'permission\x20gating','description':'create=450,\x20description_set=451,\x20location_set=452,\x20im_add/remove/clear=453,\x20owner_receive=454.','related_field':'permission'}];export function explainContact(a){const b=[],c=a['location']?'location=\x22'+a['location']+'\x22':'location\x20unset\x20(empty\x20string)',d=a['im_count']!==undefined?a['im_count']+'/'+MAX_IM_COUNT+'\x20IM\x20entries':'IM\x20count\x20unknown';return a['im_count']!==undefined&&a['im_count']>=MAX_IM_COUNT&&b['push']('IM\x20list\x20at\x20cap\x20('+MAX_IM_COUNT+');\x20im_add\x20will\x20abort\x20E_IM_COUNT_EXCEEDED'),a['bound_to_permission_um']&&b['push']('Contact\x20is\x20bound\x20as\x20Permission.um;\x20unbind\x20before\x20deletion'),{'summary':'Contact\x20('+(a['description']??'no\x20description')+').\x20'+c+'.\x20'+d+'.','location_status':c,'im_status':d,'warnings':b};}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
import{MAX_REWARD_COUNT,MAX_GUARD_COUNT_DEMAND,MAX_DESCRIPTION_LENGTH,MAX_LONG_NAME_LENGTH}from'@wowok/wowok';const MAX_FEEDBACK_COUNT=0x14;function checkDescription(a){const b=a['description']?.['length']??0x0,c=b>0x0&&b<=MAX_DESCRIPTION_LENGTH;return{'id':'C-DEM-01','severity':c?'info':b===0x0?'warn':'block','title':'description\x20non-empty\x20and\x20within\x20MAX_DESCRIPTION_LENGTH\x20('+MAX_DESCRIPTION_LENGTH+'\x20chars)','description':'description\x20is\x20a\x20REQUIRED\x20field.\x20Move\x20contract\x20validates\x20via\x20common::DESCRIPTION\x20(demand.move:157,177).\x20'+'Empty\x20string\x20is\x20technically\x20rejected\x20by\x20common::DESCRIPTION\x20only\x20if\x20NAME_ALLOW_EMPTY\x20is\x20not\x20used;\x20the\x20new_imp\x20'+'path\x20uses\x20common::DESCRIPTION\x20which\x20allows\x20empty\x20but\x20enforces\x20the\x204000-char\x20limit.\x20Non-empty\x20descriptions\x20are\x20'+'strongly\x20recommended\x20for\x20Demand\x20discoverability.','passed':c,'evidence':a['description']===undefined?'undefined':'length='+b+',\x20limit='+MAX_DESCRIPTION_LENGTH,'fix_hint':c?undefined:'Provide\x20a\x20description\x20of\x201..'+MAX_DESCRIPTION_LENGTH+'\x20characters.'};}function checkLocation(a){const b=a['location']?.['length']??0x0,c=b<=MAX_LONG_NAME_LENGTH;return{'id':'C-DEM-02','severity':c?'info':'block','title':'location\x20within\x20MAX_LONG_NAME_LENGTH\x20('+MAX_LONG_NAME_LENGTH+'\x20chars)','description':'location\x20is\x20set\x20via\x20location_set_imp\x20(demand.move:179-182)\x20which\x20validates\x20via\x20common::LONG_NAME.\x20'+'Move\x20aborts\x20with\x20E_LONG_NAME_LENGTH_EXCEEDED\x20(11)\x20on\x20overflow.\x20Empty\x20location\x20(\x22\x22)\x20is\x20valid\x20—\x20new_imp\x20'+'initializes\x20location\x20to\x20empty\x20string.\x20Use\x20location_set\x20to\x20update\x20after\x20creation.','passed':c,'evidence':a['location']===undefined?'undefined':'length='+b+',\x20limit='+MAX_LONG_NAME_LENGTH,'fix_hint':c?undefined:'Trim\x20location\x20to\x20≤\x20'+MAX_LONG_NAME_LENGTH+'\x20characters.'};}function checkRewards(a){const b=a['rewards']?.['length']??0x0,c=b<=MAX_REWARD_COUNT;return{'id':'C-DEM-03','severity':c?'info':'block','title':'rewards\x20count\x20within\x20MAX_REWARD_COUNT\x20('+MAX_REWARD_COUNT+')','description':'Each\x20reward_add_imp\x20(demand.move:184-191)\x20checks\x20`vector::length(&self.rewards)\x20<\x20MAX_REWARD_COUNT`\x20'+'before\x20pushing\x20(after\x20de-duplication).\x20Move\x20aborts\x20with\x20E_MAX_REWARD_COUNT_EXCEEDED\x20(1)\x20on\x20overflow.\x20'+'Rewards\x20are\x20affiliated\x20via\x20the\x20Registrar\x20—\x20adding/removing\x20triggers\x20affiliation/disaffiliation.','passed':c,'evidence':'count='+b+',\x20limit='+MAX_REWARD_COUNT,'fix_hint':c?undefined:'Remove\x20rewards\x20before\x20adding\x20new\x20ones.\x20Limit='+MAX_REWARD_COUNT+'.'};}function checkGuards(a){const b=a['guards']?.['length']??0x0,c=b<=MAX_GUARD_COUNT_DEMAND;return{'id':'C-DEM-04','severity':c?'info':'block','title':'guards\x20count\x20within\x20MAX_GUARD_COUNT_DEMAND\x20('+MAX_GUARD_COUNT_DEMAND+')','description':'Each\x20guard_add_imp\x20(demand.move:213-242)\x20checks\x20`vector::length(&self.guards)\x20<\x20MAX_GUARD_COUNT`\x20'+'before\x20pushing\x20(after\x20duplicate\x20check\x20—\x20duplicates\x20update\x20service_identifier\x20in\x20place).\x20'+'Move\x20aborts\x20with\x20E_MAX_GUARD_COUNT_EXCEEDED\x20(2)\x20on\x20overflow.\x20Guards\x20are\x20affiliated\x20via\x20the\x20Registrar.','passed':c,'evidence':'count='+b+',\x20limit='+MAX_GUARD_COUNT_DEMAND,'fix_hint':c?undefined:'Remove\x20guards\x20before\x20adding\x20new\x20ones.\x20Limit='+MAX_GUARD_COUNT_DEMAND+'.'};}function checkFeedback(a){const b=a['feedback']?.['length']??0x0,c=b<=MAX_FEEDBACK_COUNT;return{'id':'C-DEM-05','severity':c?'info':'block','title':'feedback\x20batch\x20count\x20within\x20MAX_FEEDBACK_COUNT\x20('+MAX_FEEDBACK_COUNT+')','description':'Move\x20feedback\x20(demand.move:352)\x20updates\x20ONE\x20presenter\x20per\x20call\x20—\x20feedback_imp\x20writes\x20to\x20a\x20single\x20'+'ServiceInfo\x20record.\x20The\x20SDK\x20batches\x20multiple\x20feedback\x20calls\x20and\x20caps\x20the\x20batch\x20at\x20MAX_FEEDBACK_COUNT='+(MAX_FEEDBACK_COUNT+'\x20(SDK-only\x20limit,\x20NOT\x20in\x20onchain-constants.ts).\x20Exceeding\x20the\x20SDK\x20batch\x20limit\x20is\x20')+'rejected\x20before\x20transaction\x20building.\x20Each\x20feedback\x20string\x20is\x20validated\x20by\x20common::DESCRIPTION\x20(4000\x20chars).','passed':c,'evidence':'count='+b+',\x20limit='+MAX_FEEDBACK_COUNT,'fix_hint':c?undefined:'Split\x20feedback\x20into\x20batches\x20of\x20≤\x20'+MAX_FEEDBACK_COUNT+'\x20entries.'};}function checkServiceIdentifier(a){const b=a['service_identifier'];if(b===null||b===undefined)return{'id':'C-DEM-06','severity':'info','title':'service_identifier\x20is\x20null/undefined\x20→\x20Option::none\x20(use\x20supplied\x20service\x20address)','description':'When\x20service_identifier\x20is\x20None,\x20guard_add_imp\x20stores\x20Option::none\x20in\x20ServiceGuard.\x20At\x20present_with_passport\x20'+'time,\x20present_with_passport_imp\x20uses\x20the\x20service\x20parameter\x20(or\x20Option::none\x20for\x20plain\x20present_with_passport).\x20'+'Use\x20None\x20when\x20the\x20Demand\x20does\x20not\x20need\x20to\x20route\x20presentations\x20through\x20a\x20specific\x20Service\x20submission.','passed':!![],'evidence':'null/undefined\x20→\x20Option::none'};const c=typeof b==='number'&&Number['isInteger'](b)&&b>=0x0&&b<=0xff;return{'id':'C-DEM-06','severity':c?'info':'block','title':'service_identifier\x20is\x20a\x20valid\x20u8\x20(0-255)\x20when\x20provided','description':'When\x20provided,\x20service_identifier\x20must\x20be\x20a\x20u8\x20index\x20into\x20the\x20Guard\x27s\x20submission\x20registry.\x20'+'guard_add_imp\x20(demand.move:218-222)\x20calls\x20guard::get_submission_object_type(guard,\x20*i)\x20and\x20'+'common::assert_service_object_type(t)\x20—\x20the\x20submission\x20at\x20that\x20index\x20MUST\x20exist\x20and\x20have\x20type\x20'+'ObjectType::Service.\x20At\x20present_with_passport\x20time,\x20the\x20submission\x20address\x20is\x20extracted\x20from\x20the\x20Passport\x20'+'via\x20passport::submission_get(passport,\x20&g,\x20*service_identifier).','passed':c,'evidence':'service_identifier='+b,'fix_hint':c?undefined:'Provide\x20an\x20integer\x20in\x20[0,\x20255]\x20that\x20indexes\x20a\x20Service-typed\x20submission\x20in\x20the\x20Guard.'};}function checkByGuard(a){const b=a['by_guard'];if(b===null||b===undefined)return{'id':'C-DEM-07','severity':'info','title':'by_guard\x20is\x20null\x20→\x20use\x20plain\x20present\x20(requires\x20empty\x20guards\x20vector)','description':'When\x20by_guard\x20is\x20None,\x20the\x20caller\x20uses\x20plain\x20present\x20(demand.move:100)\x20which\x20asserts\x20'+'`vector::is_empty(&self.guards)`\x20—\x20aborts\x20with\x20E_NEED_PASSPORT\x20(3)\x20if\x20guards\x20exist.\x20Use\x20this\x20path\x20'+'for\x20open\x20Demands\x20(no\x20guards).','passed':!![],'evidence':'null/undefined\x20→\x20plain\x20present\x20path'};if(a['guards']===undefined)return{'id':'C-DEM-07','severity':'info','title':'by_guard\x20provided\x20(cannot\x20verify\x20membership\x20—\x20guards\x20list\x20not\x20supplied)','description':'present_with_passport_imp\x20(demand.move:110-129)\x20iterates\x20the\x20guards\x20vector\x20looking\x20for\x20a\x20matching\x20'+'guard\x20address.\x20If\x20not\x20found,\x20it\x20aborts\x20with\x20E_GUARD_NOT_FOUND\x20(4).\x20The\x20caller\x20must\x20ensure\x20by_guard\x20'+'is\x20in\x20Demand.guards\x20—\x20this\x20check\x20could\x20not\x20verify\x20because\x20the\x20guards\x20list\x20was\x20not\x20supplied.','passed':!![],'evidence':'by_guard='+b['substring'](0x0,0xa)+'...\x20(guards\x20list\x20not\x20supplied)','fix_hint':'Pass\x20input.guards\x20to\x20enable\x20membership\x20verification.'};const c=a['guards']['includes'](b);return{'id':'C-DEM-07','severity':c?'info':'block','title':'by_guard\x20exists\x20in\x20Demand.guards\x20(when\x20specified)','description':'When\x20by_guard\x20is\x20specified,\x20present_with_passport_imp\x20(demand.move:110-129)\x20iterates\x20the\x20guards\x20vector\x20'+'looking\x20for\x20a\x20matching\x20guard\x20address.\x20If\x20not\x20found,\x20it\x20aborts\x20with\x20E_GUARD_NOT_FOUND\x20(4).\x20The\x20caller\x20'+'MUST\x20ensure\x20by_guard\x20was\x20previously\x20added\x20via\x20guard_add.','passed':c,'evidence':'by_guard='+b['substring'](0x0,0xa)+'...,\x20in\x20guards='+c,'fix_hint':c?undefined:'Call\x20guard_add(permission,\x20guard,\x20service_identifier)\x20first.'};}function checkPermissionSetAvailable(a){const b=a['permission_set_available']!==![];return{'id':'C-DEM-08','severity':b?'info':'warn','title':'permission_set\x20available\x20via\x20CallPermission.apply\x20(DE-D-2=A)','description':'The\x20Move\x20permission_set\x20function\x20(demand.move:286)\x20is\x20exposed\x20in\x20the\x20SDK\x20via\x20the\x20CallPermission.apply\x20'+'mechanism\x20(DE-D-2=A).\x20It\x20calls\x20permission::assert_owner(old)\x20and\x20registrar::affiliation_change\x20to\x20migrate\x20'+'the\x20affiliation.\x20Permission\x20indices\x20for\x20Demand\x20(demand.move:20):\x20400=DEMAND_NEW,\x20401=DEMAND_DESCRIPTION,\x20'+'402=DEMAND_LOCATION,\x20404=DEMAND_GUARD,\x20405=DEMAND_REWARD,\x20406=DEMAND_FEEDBACK,\x20407=DEMAND_OWNER_RECEIVE,\x20'+'408=DEMAND_UM.\x20This\x20is\x20an\x20info\x20check\x20—\x20it\x20confirms\x20the\x20capability\x20is\x20available,\x20not\x20a\x20creation\x20prerequisite.','passed':b,'evidence':b?'exposed\x20via\x20CallPermission.apply':'not\x20available\x20(regression)','fix_hint':b?undefined:'Restore\x20the\x20CallPermission.apply\x20path\x20for\x20permission_set.'};}export function preCheckDemandCreation(a){return[checkDescription(a),checkLocation(a),checkRewards(a),checkGuards(a),checkFeedback(a),checkServiceIdentifier(a),checkByGuard(a),checkPermissionSetAvailable(a)];}export function canCreateDemand(a){const b=preCheckDemandCreation(a);return{'canCreate':b['every'](c=>c['severity']!=='block'||c['passed']),'blockers':b['filter'](c=>c['severity']==='block'&&!c['passed']),'warnings':b['filter'](c=>c['severity']==='warn'&&!c['passed']),'info':b['filter'](c=>c['severity']==='info')};}export function formatDemandCreationSummary(a){const {canCreate:b,blockers:c,warnings:d,info:e}=canCreateDemand(a),f=[];return f['push'](b?'✓\x20Demand\x20pre-check\x20PASSED':'✗\x20Demand\x20pre-check\x20FAILED'),f['push'](''),c['length']>0x0&&(f['push']('BLOCKERS\x20(must\x20fix\x20before\x20operation):'),c['forEach'](g=>f['push']('\x20\x20['+g['id']+']\x20'+g['title']+'\x20—\x20'+(g['evidence']??''))),f['push']('')),d['length']>0x0&&(f['push']('WARNINGS\x20(review\x20recommended):'),d['forEach'](g=>f['push']('\x20\x20['+g['id']+']\x20'+g['title']+'\x20—\x20'+(g['evidence']??''))),f['push']('')),e['length']>0x0&&(f['push']('INFO:'),e['forEach'](g=>f['push']('\x20\x20['+g['id']+']\x20'+g['title']))),f['join']('\x0a');}
|
|
1
|
+
import{MAX_REWARD_COUNT,MAX_GUARD_COUNT_DEMAND,MAX_DESCRIPTION_LENGTH,MAX_LONG_NAME_LENGTH}from'@wowok/wowok';const MAX_FEEDBACK_COUNT=0x14;function checkDescription(a){const b=a['description']?.['length']??0x0,c=b>0x0&&b<=MAX_DESCRIPTION_LENGTH;return{'id':'C-DEM-01','severity':c?'info':b===0x0?'warn':'block','title':'description\x20non-empty\x20and\x20within\x20MAX_DESCRIPTION_LENGTH\x20('+MAX_DESCRIPTION_LENGTH+'\x20chars)','description':'description\x20is\x20a\x20REQUIRED\x20field.\x20Move\x20contract\x20validates\x20via\x20common::DESCRIPTION\x20(demand.move:157,177).\x20'+'Empty\x20string\x20is\x20technically\x20rejected\x20by\x20common::DESCRIPTION\x20only\x20if\x20NAME_ALLOW_EMPTY\x20is\x20not\x20used;\x20the\x20new_imp\x20'+'path\x20uses\x20common::DESCRIPTION\x20which\x20allows\x20empty\x20but\x20enforces\x20the\x204000-char\x20limit.\x20Non-empty\x20descriptions\x20are\x20'+'strongly\x20recommended\x20for\x20Demand\x20discoverability.','passed':c,'evidence':a['description']===undefined?'undefined':'length='+b+',\x20limit='+MAX_DESCRIPTION_LENGTH,'fix_hint':c?undefined:'Provide\x20a\x20description\x20of\x201..'+MAX_DESCRIPTION_LENGTH+'\x20characters.'};}function checkLocation(a){const b=a['location']?.['length']??0x0,c=b<=MAX_LONG_NAME_LENGTH;return{'id':'C-DEM-02','severity':c?'info':'block','title':'location\x20within\x20MAX_LONG_NAME_LENGTH\x20('+MAX_LONG_NAME_LENGTH+'\x20chars)','description':'location\x20is\x20set\x20via\x20location_set_imp\x20(demand.move:179-182)\x20which\x20validates\x20via\x20common::LONG_NAME.\x20'+'Move\x20aborts\x20with\x20E_LONG_NAME_LENGTH_EXCEEDED\x20(11)\x20on\x20overflow.\x20Empty\x20location\x20(\x22\x22)\x20is\x20valid\x20—\x20new_imp\x20'+'initializes\x20location\x20to\x20empty\x20string.\x20Use\x20location_set\x20to\x20update\x20after\x20creation.','passed':c,'evidence':a['location']===undefined?'undefined':'length='+b+',\x20limit='+MAX_LONG_NAME_LENGTH,'fix_hint':c?undefined:'Trim\x20location\x20to\x20≤\x20'+MAX_LONG_NAME_LENGTH+'\x20characters.'};}function checkRewards(a){const b=a['rewards']?.['length']??0x0,c=b<=MAX_REWARD_COUNT;return{'id':'C-DEM-03','severity':c?'info':'block','title':'rewards\x20count\x20within\x20MAX_REWARD_COUNT\x20('+MAX_REWARD_COUNT+')','description':'Each\x20reward_add_imp\x20(demand.move:184-191)\x20checks\x20`vector::length(&self.rewards)\x20<\x20MAX_REWARD_COUNT`\x20'+'before\x20pushing\x20(after\x20de-duplication).\x20Move\x20aborts\x20with\x20E_MAX_REWARD_COUNT_EXCEEDED\x20(1)\x20on\x20overflow.\x20'+'Rewards\x20are\x20bound\x20via\x20object_linker::affiliation_core\x20—\x20adding/removing\x20triggers\x20binding/unbinding.','passed':c,'evidence':'count='+b+',\x20limit='+MAX_REWARD_COUNT,'fix_hint':c?undefined:'Remove\x20rewards\x20before\x20adding\x20new\x20ones.\x20Limit='+MAX_REWARD_COUNT+'.'};}function checkGuards(a){const b=a['guards']?.['length']??0x0,c=b<=MAX_GUARD_COUNT_DEMAND;return{'id':'C-DEM-04','severity':c?'info':'block','title':'guards\x20count\x20within\x20MAX_GUARD_COUNT_DEMAND\x20('+MAX_GUARD_COUNT_DEMAND+')','description':'Each\x20guard_add_imp\x20(demand.move:213-242)\x20checks\x20`vector::length(&self.guards)\x20<\x20MAX_GUARD_COUNT`\x20'+'before\x20pushing\x20(after\x20duplicate\x20check\x20—\x20duplicates\x20update\x20service_identifier\x20in\x20place).\x20'+'Move\x20aborts\x20with\x20E_MAX_GUARD_COUNT_EXCEEDED\x20(2)\x20on\x20overflow.\x20Guards\x20are\x20bound\x20via\x20object_linker::affiliation_core.','passed':c,'evidence':'count='+b+',\x20limit='+MAX_GUARD_COUNT_DEMAND,'fix_hint':c?undefined:'Remove\x20guards\x20before\x20adding\x20new\x20ones.\x20Limit='+MAX_GUARD_COUNT_DEMAND+'.'};}function checkFeedback(a){const b=a['feedback']?.['length']??0x0,c=b<=MAX_FEEDBACK_COUNT;return{'id':'C-DEM-05','severity':c?'info':'block','title':'feedback\x20batch\x20count\x20within\x20MAX_FEEDBACK_COUNT\x20('+MAX_FEEDBACK_COUNT+')','description':'Move\x20feedback\x20(demand.move:352)\x20updates\x20ONE\x20presenter\x20per\x20call\x20—\x20feedback_imp\x20writes\x20to\x20a\x20single\x20'+'ServiceInfo\x20record.\x20The\x20SDK\x20batches\x20multiple\x20feedback\x20calls\x20and\x20caps\x20the\x20batch\x20at\x20MAX_FEEDBACK_COUNT='+(MAX_FEEDBACK_COUNT+'\x20(SDK-only\x20limit,\x20NOT\x20in\x20onchain-constants.ts).\x20Exceeding\x20the\x20SDK\x20batch\x20limit\x20is\x20')+'rejected\x20before\x20transaction\x20building.\x20Each\x20feedback\x20string\x20is\x20validated\x20by\x20common::DESCRIPTION\x20(4000\x20chars).','passed':c,'evidence':'count='+b+',\x20limit='+MAX_FEEDBACK_COUNT,'fix_hint':c?undefined:'Split\x20feedback\x20into\x20batches\x20of\x20≤\x20'+MAX_FEEDBACK_COUNT+'\x20entries.'};}function checkServiceIdentifier(a){const b=a['service_identifier'];if(b===null||b===undefined)return{'id':'C-DEM-06','severity':'info','title':'service_identifier\x20is\x20null/undefined\x20→\x20Option::none\x20(use\x20supplied\x20service\x20address)','description':'When\x20service_identifier\x20is\x20None,\x20guard_add_imp\x20stores\x20Option::none\x20in\x20ServiceGuard.\x20At\x20present_with_passport\x20'+'time,\x20present_with_passport_imp\x20uses\x20the\x20service\x20parameter\x20(or\x20Option::none\x20for\x20plain\x20present_with_passport).\x20'+'Use\x20None\x20when\x20the\x20Demand\x20does\x20not\x20need\x20to\x20route\x20presentations\x20through\x20a\x20specific\x20Service\x20submission.','passed':!![],'evidence':'null/undefined\x20→\x20Option::none'};const c=typeof b==='number'&&Number['isInteger'](b)&&b>=0x0&&b<=0xff;return{'id':'C-DEM-06','severity':c?'info':'block','title':'service_identifier\x20is\x20a\x20valid\x20u8\x20(0-255)\x20when\x20provided','description':'When\x20provided,\x20service_identifier\x20must\x20be\x20a\x20u8\x20index\x20into\x20the\x20Guard\x27s\x20submission\x20registry.\x20'+'guard_add_imp\x20(demand.move:218-222)\x20calls\x20guard::get_submission_object_type(guard,\x20*i)\x20and\x20'+'common::assert_service_object_type(t)\x20—\x20the\x20submission\x20at\x20that\x20index\x20MUST\x20exist\x20and\x20have\x20type\x20'+'ObjectType::Service.\x20At\x20present_with_passport\x20time,\x20the\x20submission\x20address\x20is\x20extracted\x20from\x20the\x20Passport\x20'+'via\x20passport::submission_get(passport,\x20&g,\x20*service_identifier).','passed':c,'evidence':'service_identifier='+b,'fix_hint':c?undefined:'Provide\x20an\x20integer\x20in\x20[0,\x20255]\x20that\x20indexes\x20a\x20Service-typed\x20submission\x20in\x20the\x20Guard.'};}function checkByGuard(a){const b=a['by_guard'];if(b===null||b===undefined)return{'id':'C-DEM-07','severity':'info','title':'by_guard\x20is\x20null\x20→\x20use\x20plain\x20present\x20(requires\x20empty\x20guards\x20vector)','description':'When\x20by_guard\x20is\x20None,\x20the\x20caller\x20uses\x20plain\x20present\x20(demand.move:100)\x20which\x20asserts\x20'+'`vector::is_empty(&self.guards)`\x20—\x20aborts\x20with\x20E_NEED_PASSPORT\x20(3)\x20if\x20guards\x20exist.\x20Use\x20this\x20path\x20'+'for\x20open\x20Demands\x20(no\x20guards).','passed':!![],'evidence':'null/undefined\x20→\x20plain\x20present\x20path'};if(a['guards']===undefined)return{'id':'C-DEM-07','severity':'info','title':'by_guard\x20provided\x20(cannot\x20verify\x20membership\x20—\x20guards\x20list\x20not\x20supplied)','description':'present_with_passport_imp\x20(demand.move:110-129)\x20iterates\x20the\x20guards\x20vector\x20looking\x20for\x20a\x20matching\x20'+'guard\x20address.\x20If\x20not\x20found,\x20it\x20aborts\x20with\x20E_GUARD_NOT_FOUND\x20(4).\x20The\x20caller\x20must\x20ensure\x20by_guard\x20'+'is\x20in\x20Demand.guards\x20—\x20this\x20check\x20could\x20not\x20verify\x20because\x20the\x20guards\x20list\x20was\x20not\x20supplied.','passed':!![],'evidence':'by_guard='+b['substring'](0x0,0xa)+'...\x20(guards\x20list\x20not\x20supplied)','fix_hint':'Pass\x20input.guards\x20to\x20enable\x20membership\x20verification.'};const c=a['guards']['includes'](b);return{'id':'C-DEM-07','severity':c?'info':'block','title':'by_guard\x20exists\x20in\x20Demand.guards\x20(when\x20specified)','description':'When\x20by_guard\x20is\x20specified,\x20present_with_passport_imp\x20(demand.move:110-129)\x20iterates\x20the\x20guards\x20vector\x20'+'looking\x20for\x20a\x20matching\x20guard\x20address.\x20If\x20not\x20found,\x20it\x20aborts\x20with\x20E_GUARD_NOT_FOUND\x20(4).\x20The\x20caller\x20'+'MUST\x20ensure\x20by_guard\x20was\x20previously\x20added\x20via\x20guard_add.','passed':c,'evidence':'by_guard='+b['substring'](0x0,0xa)+'...,\x20in\x20guards='+c,'fix_hint':c?undefined:'Call\x20guard_add(permission,\x20guard,\x20service_identifier)\x20first.'};}function checkPermissionSetAvailable(a){const b=a['permission_set_available']!==![];return{'id':'C-DEM-08','severity':b?'info':'warn','title':'permission_set\x20available\x20via\x20CallPermission.apply\x20(DE-D-2=A)','description':'The\x20Move\x20permission_set\x20function\x20(demand.move:286)\x20is\x20exposed\x20in\x20the\x20SDK\x20via\x20the\x20CallPermission.apply\x20'+'mechanism\x20(DE-D-2=A).\x20It\x20calls\x20permission::assert_owner(old)\x20and\x20object_linker::affiliation_change_core\x20to\x20migrate\x20'+'the\x20binding.\x20Permission\x20indices\x20for\x20Demand\x20(demand.move:20):\x20400=DEMAND_NEW,\x20401=DEMAND_DESCRIPTION,\x20'+'402=DEMAND_LOCATION,\x20404=DEMAND_GUARD,\x20405=DEMAND_REWARD,\x20406=DEMAND_FEEDBACK,\x20407=DEMAND_OWNER_RECEIVE,\x20'+'408=DEMAND_UM.\x20This\x20is\x20an\x20info\x20check\x20—\x20it\x20confirms\x20the\x20capability\x20is\x20available,\x20not\x20a\x20creation\x20prerequisite.','passed':b,'evidence':b?'exposed\x20via\x20CallPermission.apply':'not\x20available\x20(regression)','fix_hint':b?undefined:'Restore\x20the\x20CallPermission.apply\x20path\x20for\x20permission_set.'};}export function preCheckDemandCreation(a){return[checkDescription(a),checkLocation(a),checkRewards(a),checkGuards(a),checkFeedback(a),checkServiceIdentifier(a),checkByGuard(a),checkPermissionSetAvailable(a)];}export function canCreateDemand(a){const b=preCheckDemandCreation(a);return{'canCreate':b['every'](c=>c['severity']!=='block'||c['passed']),'blockers':b['filter'](c=>c['severity']==='block'&&!c['passed']),'warnings':b['filter'](c=>c['severity']==='warn'&&!c['passed']),'info':b['filter'](c=>c['severity']==='info')};}export function formatDemandCreationSummary(a){const {canCreate:b,blockers:c,warnings:d,info:e}=canCreateDemand(a),f=[];return f['push'](b?'✓\x20Demand\x20pre-check\x20PASSED':'✗\x20Demand\x20pre-check\x20FAILED'),f['push'](''),c['length']>0x0&&(f['push']('BLOCKERS\x20(must\x20fix\x20before\x20operation):'),c['forEach'](g=>f['push']('\x20\x20['+g['id']+']\x20'+g['title']+'\x20—\x20'+(g['evidence']??''))),f['push']('')),d['length']>0x0&&(f['push']('WARNINGS\x20(review\x20recommended):'),d['forEach'](g=>f['push']('\x20\x20['+g['id']+']\x20'+g['title']+'\x20—\x20'+(g['evidence']??''))),f['push']('')),e['length']>0x0&&(f['push']('INFO:'),e['forEach'](g=>f['push']('\x20\x20['+g['id']+']\x20'+g['title']))),f['join']('\x0a');}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
import { type DemandScene } from "./demand-ledger.js";
|
|
2
|
+
export declare const DEMAND_CONTEXT_VERSION = "1.0.0";
|
|
3
|
+
export interface DemandContextBundle {
|
|
4
|
+
scene?: DemandScene;
|
|
5
|
+
rewarded: boolean;
|
|
6
|
+
guarded: boolean;
|
|
7
|
+
summary: string;
|
|
8
|
+
}
|
|
9
|
+
export interface BuildDemandContextInput {
|
|
10
|
+
description?: string;
|
|
11
|
+
reward_count?: number;
|
|
12
|
+
guard_count?: number;
|
|
13
|
+
}
|
|
14
|
+
export declare function buildDemandContext(input: BuildDemandContextInput): DemandContextBundle;
|
|
15
|
+
export declare function getDemandContextSummary(ctx: DemandContextBundle): string;
|
|
16
|
+
export declare function isRewardedDemand(ctx: DemandContextBundle): boolean;
|
|
17
|
+
export declare function getDemandSceneByIdSafe(id: string): DemandScene | undefined;
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
import{getDemandSceneById}from'./demand-ledger.js';export const DEMAND_CONTEXT_VERSION='1.0.0';export function buildDemandContext(a){const b=(a['reward_count']??0x0)>0x0,c=(a['guard_count']??0x0)>0x0,d=[];return a['description']&&d['push']('demand\x20\x22'+a['description']+'\x22'),d['push'](b?'rewarded':'not\x20rewarded'),d['push'](c?'guarded\x20present':'open\x20present'),{'scene':undefined,'rewarded':b,'guarded':c,'summary':d['join']('\x20·\x20')};}export function getDemandContextSummary(a){return a['summary'];}export function isRewardedDemand(a){return a['rewarded'];}export function getDemandSceneByIdSafe(a){return getDemandSceneById(a);}
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
export declare const DEMAND_LEDGER_VERSION = "1.0.0";
|
|
2
|
+
export type DemandSceneClassification = "publish" | "present" | "feedback";
|
|
3
|
+
export interface DemandScene {
|
|
4
|
+
id: string;
|
|
5
|
+
classification: DemandSceneClassification;
|
|
6
|
+
semantic: string;
|
|
7
|
+
}
|
|
8
|
+
export declare const DEMAND_SCENES: DemandScene[];
|
|
9
|
+
export interface DemandFieldEntry {
|
|
10
|
+
field: string;
|
|
11
|
+
value_type: string;
|
|
12
|
+
semantic: string;
|
|
13
|
+
required: boolean;
|
|
14
|
+
}
|
|
15
|
+
export declare const DEMAND_FIELDS: DemandFieldEntry[];
|
|
16
|
+
export interface DemandErrorEntry {
|
|
17
|
+
code: string;
|
|
18
|
+
value: number;
|
|
19
|
+
description: string;
|
|
20
|
+
}
|
|
21
|
+
export declare const DEMAND_ERROR_CODES: DemandErrorEntry[];
|
|
22
|
+
export declare function getDemandField(field: string): DemandFieldEntry | undefined;
|
|
23
|
+
export declare function getDemandErrorByCode(code: string): DemandErrorEntry | undefined;
|
|
24
|
+
export declare function getDemandErrorByValue(value: number): DemandErrorEntry | undefined;
|
|
25
|
+
export declare function getDemandSceneById(id: string): DemandScene | undefined;
|
|
26
|
+
export declare function inferDemandSceneFromIntent(intent: string): DemandScene | undefined;
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export const DEMAND_LEDGER_VERSION='1.0.0';export const DEMAND_SCENES=[{'id':'demand_publish','classification':'publish','semantic':'Create\x20+\x20share\x20the\x20Demand\x20(description\x20+\x20location\x20+\x20rewards\x20+\x20guards).'},{'id':'demand_present','classification':'present','semantic':'A\x20presenter\x20(service/merchant)\x20submits\x20a\x20recommendation\x20to\x20the\x20Demand.'},{'id':'demand_feedback','classification':'feedback','semantic':'Demand\x20owner\x20rates\x20a\x20presenter\x27s\x20submission\x20(acceptance_score\x20+\x20feedback).'}];export const DEMAND_FIELDS=[{'field':'description','value_type':'string','semantic':'Demand\x20description\x20(common::DESCRIPTION\x20validation).','required':!![]},{'field':'location','value_type':'string','semantic':'Geographic\x20region\x20string\x20(structured\x20via\x20region.ts).','required':!![]},{'field':'rewards','value_type':'vector<address>','semantic':'Reward\x20objects\x20offered\x20(≤\x20MAX_REWARD_COUNT\x2020).','required':![]},{'field':'guards','value_type':'vector<ServiceGuard>','semantic':'Guards\x20a\x20presenter\x20must\x20pass\x20to\x20present\x20(≤\x20MAX_GUARD_COUNT\x2020).','required':![]},{'field':'presenters','value_type':'ParentTable<address,\x20ServiceInfo>','semantic':'Presenter\x20submissions\x20(who\x20→\x20recommend/service/acceptance).','required':![]},{'field':'um','value_type':'Option<address>','semantic':'User\x20manager\x20(optional).','required':![]},{'field':'permission','value_type':'address','semantic':'Owning\x20Permission\x20organization.','required':!![]}];export const DEMAND_ERROR_CODES=[{'code':'E_MAX_REWARD_COUNT_EXCEEDED','value':0x1,'description':'rewards\x20>\x20MAX_REWARD_COUNT\x20(20).'},{'code':'E_MAX_GUARD_COUNT_EXCEEDED','value':0x2,'description':'guards\x20>\x20MAX_GUARD_COUNT\x20(20).'},{'code':'E_NEED_PASSPORT','value':0x3,'description':'present\x20requires\x20empty\x20guards\x20(no\x20guard\x20→\x20no\x20passport).'},{'code':'E_GUARD_NOT_FOUND','value':0x4,'description':'Referenced\x20guard\x20not\x20found.'}];export function getDemandField(a){return DEMAND_FIELDS['find'](b=>b['field']===a);}export function getDemandErrorByCode(a){return DEMAND_ERROR_CODES['find'](b=>b['code']===a);}export function getDemandErrorByValue(a){return DEMAND_ERROR_CODES['find'](b=>b['value']===a);}export function getDemandSceneById(a){return DEMAND_SCENES['find'](b=>b['id']===a);}export function inferDemandSceneFromIntent(a){const b=a['toLowerCase']();if(/(publish|post|announce|create|发需求|发布)/['test'](b))return DEMAND_SCENES['find'](c=>c['classification']==='publish');if(/(present|apply|submit|bid|报价|应征)/['test'](b))return DEMAND_SCENES['find'](c=>c['classification']==='present');if(/(feedback|accept|score|rate|评价|采纳)/['test'](b))return DEMAND_SCENES['find'](c=>c['classification']==='feedback');return undefined;}
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
import { type DemandScene } from "./demand-ledger.js";
|
|
2
|
+
export declare const DEMAND_PUZZLE_VERSION = "1.0.0";
|
|
3
|
+
export interface DemandIntentPuzzle {
|
|
4
|
+
scene?: DemandScene;
|
|
5
|
+
}
|
|
6
|
+
export interface DemandFieldState {
|
|
7
|
+
field: string;
|
|
8
|
+
present: boolean;
|
|
9
|
+
required: boolean;
|
|
10
|
+
}
|
|
11
|
+
export interface DemandPuzzle {
|
|
12
|
+
intent: DemandIntentPuzzle;
|
|
13
|
+
fields: DemandFieldState[];
|
|
14
|
+
}
|
|
15
|
+
export interface DemandPuzzleCompleteness {
|
|
16
|
+
complete: boolean;
|
|
17
|
+
missing_required: string[];
|
|
18
|
+
reason: string;
|
|
19
|
+
}
|
|
20
|
+
export interface InitDemandPuzzleInput {
|
|
21
|
+
intent: string;
|
|
22
|
+
description?: string;
|
|
23
|
+
location?: string;
|
|
24
|
+
permission?: string;
|
|
25
|
+
reward_count?: number;
|
|
26
|
+
guard_count?: number;
|
|
27
|
+
}
|
|
28
|
+
export declare function initDemandPuzzleFromIntent(input: InitDemandPuzzleInput): DemandPuzzle;
|
|
29
|
+
export declare function checkDemandPuzzleCompleteness(puzzle: DemandPuzzle): DemandPuzzleCompleteness;
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
import{DEMAND_FIELDS,inferDemandSceneFromIntent}from'./demand-ledger.js';export const DEMAND_PUZZLE_VERSION='1.0.0';export function initDemandPuzzleFromIntent(a){const b=inferDemandSceneFromIntent(a['intent']),c={'description':!!a['description'],'location':!!a['location'],'permission':!!a['permission'],'rewards':(a['reward_count']??0x0)>0x0,'guards':(a['guard_count']??0x0)>0x0},d=DEMAND_FIELDS['map'](e=>({'field':e['field'],'present':e['field']in c?!!c[e['field']]:![],'required':e['required']}));return{'intent':{'scene':b},'fields':d};}export function checkDemandPuzzleCompleteness(a){const b=a['fields']['filter'](d=>d['required']&&!d['present'])['map'](d=>d['field']),c=b['length']===0x0;return{'complete':c,'missing_required':b,'reason':c?'All\x20required\x20demand\x20fields\x20present.':'Missing\x20required:\x20'+b['join'](',\x20')+'.'};}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
import{MAX_REWARD_COUNT,MAX_GUARD_COUNT_DEMAND}from'@wowok/wowok';const MAX_FEEDBACK_COUNT=0x14,R_DEM_1_01={'rule':{'id':'R-DEM-01','level':'HIGH','category':'structural','title':'rewards\x20count\x20exceeds\x20MAX_REWARD_COUNT\x20('+MAX_REWARD_COUNT+')','description':'The\x20\x27rewards\x27\x20vector\x20is\x20bounded\x20by\x20MAX_REWARD_COUNT='+MAX_REWARD_COUNT+'\x20(Move\x20source:\x20demand.move:21).\x20'+'Exceeding\x20this\x20limit\x20aborts\x20with\x20E_MAX_REWARD_COUNT_EXCEEDED\x20(1).\x20Each\x20reward\x20is\x20affiliated\x20via\x20the\x20Registrar,\x20'+'so\x20adding\x20a\x20reward\x20also\x20triggers\x20registrar::affiliation.\x20Use\x20reward_remove/reward_clear\x20to\x20free\x20slots\x20before\x20'+'adding\x20new\x20ones\x20if\x20the\x20limit\x20is\x20reached.','affected_stakeholders':['creator'],'scenario':'Caller\x20calls\x20reward_add\x20when\x2020\x20rewards\x20are\x20already\x20affiliated','mitigation':'Track\x20the\x20current\x20reward\x20count.\x20Before\x20adding\x20a\x20new\x20reward,\x20call\x20reward_remove\x20or\x20reward_clear\x20to\x20'+'free\x20a\x20slot.\x20Consider\x20consolidating\x20rewards\x20into\x20a\x20single\x20Reward\x20object\x20with\x20multiple\x20tiers\x20if\x20the\x20'+'\x20Demand\x20needs\x20to\x20offer\x20more\x20than\x2020\x20distinct\x20reward\x20paths.','related_move_error':'E_MAX_REWARD_COUNT_EXCEEDED\x20(1)','auto_fixable':![]},'check':a=>{if(a['reward_count']===undefined)return null;if(a['reward_count']<=MAX_REWARD_COUNT)return null;return{...R_DEM_1_01['rule'],'evidence':'reward_count='+a['reward_count']+',\x20limit='+MAX_REWARD_COUNT};}},R_DEM_1_02={'rule':{'id':'R-DEM-02','level':'HIGH','category':'structural','title':'guards\x20count\x20exceeds\x20MAX_GUARD_COUNT_DEMAND\x20('+MAX_GUARD_COUNT_DEMAND+')','description':'The\x20\x27guards\x27\x20vector\x20is\x20bounded\x20by\x20MAX_GUARD_COUNT_DEMAND='+MAX_GUARD_COUNT_DEMAND+'\x20(Move\x20source:\x20demand.move:22).\x20'+'Exceeding\x20this\x20limit\x20aborts\x20with\x20E_MAX_GUARD_COUNT_EXCEEDED\x20(2).\x20Each\x20guard\x20carries\x20an\x20optional\x20'+'service_identifier\x20(u8)\x20that\x20routes\x20present_with_passport\x20submissions\x20to\x20a\x20specific\x20Service\x20submission\x20'+'extracted\x20from\x20the\x20Passport.\x20Adding\x20a\x20duplicate\x20guard\x20updates\x20the\x20service_identifier\x20instead\x20of\x20pushing.','affected_stakeholders':['creator','presenter'],'scenario':'Caller\x20calls\x20guard_add\x20when\x2020\x20guards\x20are\x20already\x20affiliated\x20and\x20the\x20address\x20is\x20new','mitigation':'Track\x20the\x20current\x20guard\x20count.\x20Before\x20adding\x20a\x20new\x20guard,\x20call\x20guard_remove\x20or\x20guard_clear.\x20'+'If\x20updating\x20an\x20existing\x20guard\x27s\x20service_identifier,\x20call\x20guard_add\x20with\x20the\x20same\x20address\x20(it\x20updates\x20'+'in\x20place\x20rather\x20than\x20pushing).','related_move_error':'E_MAX_GUARD_COUNT_EXCEEDED\x20(2)','auto_fixable':![]},'check':a=>{if(a['guard_count']===undefined)return null;if(a['guard_count']<=MAX_GUARD_COUNT_DEMAND)return null;return{...R_DEM_1_02['rule'],'evidence':'guard_count='+a['guard_count']+',\x20limit='+MAX_GUARD_COUNT_DEMAND};}},R_DEM_1_03={'rule':{'id':'R-DEM-03','level':'MEDIUM','category':'structural','title':'feedback\x20batch\x20exceeds\x20MAX_FEEDBACK_COUNT\x20('+MAX_FEEDBACK_COUNT+')','description':'The\x20\x27feedback\x27\x20Move\x20function\x20(demand.move:352)\x20updates\x20ONE\x20presenter\x20per\x20call\x20(feedback_imp\x20iterates\x20'+('no\x20vector).\x20The\x20SDK\x20batches\x20multiple\x20feedback\x20calls\x20and\x20caps\x20the\x20batch\x20at\x20MAX_FEEDBACK_COUNT='+MAX_FEEDBACK_COUNT+'\x20')+'(SDK-only\x20limit,\x20NOT\x20in\x20onchain-constants.ts\x20—\x20Move\x20has\x20no\x20aggregate\x20feedback-count\x20check).\x20Exceeding\x20the\x20'+'SDK\x20batch\x20limit\x20causes\x20the\x20SDK\x20to\x20refuse\x20the\x20call\x20before\x20transaction\x20building.\x20Each\x20feedback\x20entry\x20writes\x20'+'a\x20String\x20(bounded\x20by\x20common::DESCRIPTION,\x204000\x20chars)\x20and\x20an\x20optional\x20u8\x20acceptance_score\x20to\x20a\x20presenter\x27s\x20'+'ServiceInfo\x20record.','affected_stakeholders':['creator'],'scenario':'Caller\x20attempts\x20to\x20submit\x2021\x20feedback\x20entries\x20in\x20a\x20single\x20SDK\x20call','mitigation':'Split\x20the\x20feedback\x20batch\x20into\x20chunks\x20of\x20≤\x2020\x20entries.\x20If\x20the\x20Demand\x20has\x20more\x20than\x2020\x20presenters\x20to\x20'+'give\x20feedback\x20on,\x20submit\x20multiple\x20transactions.\x20Consider\x20whether\x20bulk\x20feedback\x20is\x20appropriate\x20—\x20'+'individualized\x20feedback\x20per\x20presenter\x20is\x20often\x20more\x20meaningful.','auto_fixable':![]},'check':a=>{if(a['feedback_count']===undefined)return null;if(a['feedback_count']<=MAX_FEEDBACK_COUNT)return null;return{...R_DEM_1_03['rule'],'evidence':'feedback_count='+a['feedback_count']+',\x20limit='+MAX_FEEDBACK_COUNT};}},R_DEM_2_01={'rule':{'id':'R-DEM-04','level':'HIGH','category':'semantic','title':'present\x20called\x20without\x20passport\x20when\x20guards\x20vector\x20is\x20non-empty','description':'The\x20Move\x20present\x20function\x20(demand.move:100)\x20asserts\x20`vector::is_empty(&self.guards)`\x20and\x20aborts\x20with\x20'+'E_NEED_PASSPORT\x20(3)\x20if\x20the\x20guards\x20vector\x20is\x20non-empty.\x20When\x20guards\x20exist,\x20every\x20presenter\x20MUST\x20go\x20through\x20'+'present_with_passport\x20(or\x20present_service_with_passport),\x20which\x20routes\x20through\x20present_with_passport_imp.\x20'+'That\x20function\x20looks\x20up\x20the\x20specified\x20Guard\x20in\x20the\x20guards\x20vector,\x20calls\x20passport::result_for_guard\x20to\x20'+'verify\x20the\x20Passport,\x20and\x20(if\x20service_identifier\x20is\x20set)\x20extracts\x20the\x20submission\x20address\x20from\x20the\x20Passport.\x20'+'Calling\x20plain\x20`present`\x20on\x20a\x20guarded\x20Demand\x20always\x20aborts\x20—\x20there\x20is\x20no\x20fallback\x20path.','affected_stakeholders':['presenter','creator'],'scenario':'Demand\x20has\x202\x20guards;\x20a\x20presenter\x20calls\x20present()\x20instead\x20of\x20present_with_passport()','mitigation':'Before\x20presenting,\x20query\x20the\x20Demand\x27s\x20guards\x20vector.\x20If\x20non-empty,\x20use\x20present_with_passport\x20and\x20'+'supply\x20a\x20Guard\x20+\x20Passport.\x20The\x20Guard\x20address\x20must\x20already\x20be\x20in\x20the\x20guards\x20vector\x20(otherwise\x20'+'E_GUARD_NOT_FOUND\x20(4)\x20aborts).\x20If\x20service_identifier\x20is\x20set\x20on\x20the\x20matching\x20guard,\x20the\x20submission\x20'+'address\x20is\x20extracted\x20from\x20the\x20Passport\x20—\x20do\x20not\x20pass\x20a\x20separate\x20service\x20parameter.','related_move_error':'E_NEED_PASSPORT\x20(3)','auto_fixable':![]},'check':a=>{if(!a['using_present_without_passport'])return null;if(!a['guards_non_empty'])return null;return{...R_DEM_2_01['rule'],'evidence':'guards_non_empty=true,\x20using\x20present\x20(no\x20passport)'};}},R_DEM_3_01={'rule':{'id':'R-DEM-05','level':'INFO','category':'lifecycle','title':'um_set_imp\x20Registrar\x20dependency\x20leak\x20—\x20RESOLVED\x20(P-DEM-P1-1)','description':'PREVIOUS\x20RISK:\x20um_set_imp\x20(demand.move:139-147)\x20previously\x20set\x20self.um\x20to\x20the\x20new\x20Contact\x20address\x20'+'BEFORE\x20disaffiliating\x20the\x20old\x20um,\x20causing\x20the\x20old\x20Contact\x20to\x20retain\x20a\x20stale\x20affiliation\x20record\x20in\x20the\x20'+'Registrar.\x20Affiliation_change\x20was\x20not\x20called\x20for\x20the\x20old\x20um,\x20leading\x20to\x20a\x20Registrar\x20dependency\x20leak.\x0a\x0a'+'FIX\x20(P-DEM-P1-1):\x20um_set_imp\x20now\x20disaffiliates\x20the\x20old\x20um\x20via\x20registrar::disaffiliation\x20BEFORE\x20setting\x20'+'the\x20new\x20one.\x20The\x20new\x20um\x20is\x20then\x20affiliated\x20via\x20registrar::affiliation.\x20This\x20matches\x20the\x20pattern\x20used\x20'+'by\x20permission_set\x20(which\x20uses\x20affiliation_change).\x20um_none_imp\x20also\x20disaffiliates\x20before\x20clearing.\x0a\x0a'+'This\x20rule\x20is\x20retained\x20for\x20historical\x20audit\x20and\x20to\x20detect\x20regressions.','affected_stakeholders':['creator','system'],'scenario':'Future\x20regression:\x20someone\x20reorders\x20um_set_imp\x20to\x20set\x20new\x20before\x20disaffiliating\x20old','mitigation':'Keep\x20the\x20disaffiliate-then-set\x20ordering.\x20The\x20Move\x20invariant:\x20any\x20path\x20that\x20mutates\x20self.um\x20MUST\x20call\x20'+'registrar::disaffiliation\x20on\x20the\x20old\x20value\x20before\x20assigning\x20a\x20new\x20one.','auto_fixable':![]},'check':a=>{if(a['constants_synced'])return null;return{...R_DEM_3_01['rule'],'evidence':'constants_synced=false\x20(regression\x20check)'};}},R_DEM_2_02={'rule':{'id':'R-DEM-06','level':'INFO','category':'semantic','title':'guard_add_imp\x20service_identifier\x20type\x20check\x20skipped\x20on\x20early\x20return\x20—\x20RESOLVED\x20(P-DEM-P1-2)','description':'PREVIOUS\x20RISK:\x20guard_add_imp\x20(demand.move:213-242)\x20previously\x20had\x20the\x20service_identifier\x20type\x20check\x20'+'AFTER\x20the\x20early-return\x20path\x20that\x20updates\x20an\x20existing\x20guard\x27s\x20service_identifier.\x20When\x20a\x20guard\x20with\x20'+'the\x20same\x20address\x20already\x20existed,\x20the\x20function\x20returned\x20before\x20validating\x20the\x20new\x20service_identifier\x20'+'against\x20guard::get_submission_object_type.\x20This\x20allowed\x20setting\x20an\x20invalid\x20service_identifier\x20that\x20'+'would\x20later\x20fail\x20at\x20present_with_passport\x20time\x20with\x20E_INVALID_SERVICE_OBJECT_TYPE\x20(common.move:13).\x0a\x0a'+'FIX\x20(P-DEM-P1-2):\x20The\x20service_identifier\x20type\x20check\x20now\x20runs\x20FIRST\x20(demand.move:218-222),\x20BEFORE\x20the\x20'+'duplicate-detection\x20loop.\x20common::assert_service_object_type\x20is\x20called\x20for\x20any\x20non-None\x20service_identifier,\x20'+'ensuring\x20both\x20the\x20insert\x20and\x20update\x20paths\x20validate\x20the\x20type.\x0a\x0a'+'This\x20rule\x20is\x20retained\x20for\x20historical\x20audit\x20and\x20to\x20detect\x20regressions.','affected_stakeholders':['creator','presenter'],'scenario':'Future\x20regression:\x20someone\x20moves\x20the\x20type\x20check\x20back\x20to\x20after\x20the\x20duplicate-detection\x20loop','mitigation':'Keep\x20the\x20type\x20check\x20at\x20the\x20top\x20of\x20guard_add_imp.\x20The\x20Move\x20invariant:\x20any\x20service_identifier\x20provided\x20'+'to\x20guard_add\x20MUST\x20be\x20validated\x20via\x20guard::get_submission_object_type\x20+\x20common::assert_service_object_type\x20'+'BEFORE\x20any\x20mutation\x20of\x20the\x20guards\x20vector.','auto_fixable':![]},'check':a=>{if(a['constants_synced'])return null;return{...R_DEM_2_02['rule'],'evidence':'constants_synced=false\x20(regression\x20check)'};}},R_DEM_4_01={'rule':{'id':'R-DEM-07','level':'INFO','category':'knowledge','title':'extractDemandInfo\x20expects\x20non-existent\x20Move\x20fields\x20—\x20RESOLVED\x20(P-DEM-P1-3)','description':'PREVIOUS\x20RISK:\x20extractDemandInfo\x20in\x20demand-matching.ts\x20previously\x20read\x20fields\x20(tags,\x20maxPrice,\x20'+'scenario,\x20minTrustScore,\x20keywords)\x20that\x20do\x20NOT\x20exist\x20on\x20the\x20Move\x20Demand\x20struct.\x20The\x20Move\x20struct\x20only\x20'+'has:\x20description,\x20location,\x20rewards,\x20guards,\x20presenters,\x20um,\x20permission.\x20This\x20caused\x20the\x20matching\x20'+'engine\x20to\x20silently\x20produce\x20undefined\x20values\x20when\x20fed\x20raw\x20on-chain\x20query\x20results.\x0a\x0a'+'FIX\x20(P-DEM-P1-3):\x20extractDemandInfo\x20now\x20documents\x20the\x20caller-enrichment\x20contract.\x20Only\x20`location`\x20maps\x20'+'directly\x20to\x20the\x20Move\x20Demand\x20struct;\x20all\x20other\x20fields\x20(tags,\x20maxPrice,\x20scenario,\x20minTrustScore,\x20keywords)\x20'+'MUST\x20be\x20injected\x20by\x20the\x20caller\x20before\x20calling\x20matchDemand.\x20The\x20caller\x20is\x20responsible\x20for\x20sourcing\x20'+'this\x20data\x20from\x20Service\x20tags,\x20Reward\x20objects,\x20user\x20input,\x20or\x20NLP\x20on\x20the\x20description.\x0a\x0a'+'This\x20rule\x20is\x20retained\x20for\x20historical\x20audit\x20and\x20to\x20detect\x20regressions.','affected_stakeholders':['system'],'scenario':'Future\x20regression:\x20someone\x20removes\x20the\x20caller-enrichment\x20contract\x20docs\x20from\x20extractDemandInfo','mitigation':'Keep\x20the\x20[caller-enriched]\x20/\x20[on-chain]\x20annotations\x20on\x20DemandInfo\x20fields.\x20The\x20matching\x20engine\x20must\x20'+'never\x20query\x20on-chain\x20data\x20directly\x20—\x20it\x20is\x20a\x20pure\x20scoring\x20function\x20over\x20caller-injected\x20data.','auto_fixable':![]},'check':a=>{if(a['constants_synced'])return null;return{...R_DEM_4_01['rule'],'evidence':'constants_synced=false\x20(regression\x20check)'};}},R_DEM_4_02={'rule':{'id':'R-DEM-08','level':'INFO','category':'knowledge','title':'permission_set\x20not\x20exposed\x20in\x20SDK\x20—\x20RESOLVED\x20(DE-D-2=A)','description':'PREVIOUS\x20GAP:\x20The\x20Move\x20permission_set\x20function\x20(demand.move:286)\x20was\x20not\x20exposed\x20as\x20a\x20standalone\x20'+'function\x20in\x20the\x20SDK\x27s\x20call/demand.ts.\x20Callers\x20could\x20not\x20change\x20the\x20Permission\x20object\x20bound\x20to\x20a\x20Demand\x20'+'after\x20creation.\x0a\x0a'+'RESOLUTION\x20(DE-D-2=A):\x20permission_set\x20is\x20now\x20exposed\x20via\x20the\x20CallPermission.apply\x20mechanism.\x20The\x20SDK\x20'+'wraps\x20permission_set\x20by\x20routing\x20it\x20through\x20CallPermission,\x20which\x20performs\x20the\x20assert_owner\x20check\x20on\x20the\x20'+'old\x20Permission\x20and\x20updates\x20the\x20Demand\x27s\x20bound\x20permission.\x20The\x20Registrar\x27s\x20affiliation_change\x20is\x20called\x20'+'to\x20migrate\x20the\x20affiliation\x20from\x20the\x20old\x20Permission\x20to\x20the\x20new\x20one.\x0a\x0a'+'Permission\x20indices\x20for\x20Demand\x20(demand.move:20):\x20400=DEMAND_NEW,\x20401=DEMAND_DESCRIPTION,\x20402=DEMAND_LOCATION,\x20'+'404=DEMAND_GUARD,\x20405=DEMAND_REWARD,\x20406=DEMAND_FEEDBACK,\x20407=DEMAND_OWNER_RECEIVE,\x20408=DEMAND_UM.\x0a\x0a'+'This\x20rule\x20is\x20retained\x20for\x20historical\x20audit\x20and\x20to\x20detect\x20regressions.','affected_stakeholders':['creator','system'],'scenario':'Future\x20regression:\x20someone\x20removes\x20the\x20CallPermission.apply\x20path\x20for\x20permission_set','mitigation':'Keep\x20permission_set\x20exposed\x20via\x20CallPermission.apply.\x20The\x20Move\x20invariant:\x20permission_set\x20requires\x20'+'permission::assert_owner(old)\x20and\x20MUST\x20call\x20registrar::affiliation_change\x20to\x20migrate\x20the\x20affiliation.','auto_fixable':![]},'check':a=>{if(a['constants_synced'])return null;return{...R_DEM_4_02['rule'],'evidence':'constants_synced=false\x20(regression\x20check)'};}};export const DEMAND_RISK_RULES=[R_DEM_1_01,R_DEM_1_02,R_DEM_1_03,R_DEM_2_01,R_DEM_3_01,R_DEM_2_02,R_DEM_4_01,R_DEM_4_02];export function checkDemandRisks(a){const b=[];for(const c of DEMAND_RISK_RULES){const d=c['check'](a);if(d)b['push'](d);}return b;}export function getDemandRiskById(a){return DEMAND_RISK_RULES['find'](b=>b['rule']['id']===a)?.['rule'];}
|
|
1
|
+
import{MAX_REWARD_COUNT,MAX_GUARD_COUNT_DEMAND}from'@wowok/wowok';const MAX_FEEDBACK_COUNT=0x14,R_DEM_1_01={'rule':{'id':'R-DEM-01','level':'HIGH','category':'structural','title':'rewards\x20count\x20exceeds\x20MAX_REWARD_COUNT\x20('+MAX_REWARD_COUNT+')','description':'The\x20\x27rewards\x27\x20vector\x20is\x20bounded\x20by\x20MAX_REWARD_COUNT='+MAX_REWARD_COUNT+'\x20(Move\x20source:\x20demand.move:21).\x20'+'Exceeding\x20this\x20limit\x20aborts\x20with\x20E_MAX_REWARD_COUNT_EXCEEDED\x20(1).\x20Each\x20reward\x20is\x20bound\x20via\x20object_linker::affiliation_core,\x20'+'so\x20adding\x20a\x20reward\x20also\x20triggers\x20object_linker::affiliation_core.\x20Use\x20reward_remove/reward_clear\x20to\x20free\x20slots\x20before\x20'+'adding\x20new\x20ones\x20if\x20the\x20limit\x20is\x20reached.','affected_stakeholders':['creator'],'scenario':'Caller\x20calls\x20reward_add\x20when\x2020\x20rewards\x20are\x20already\x20affiliated','mitigation':'Track\x20the\x20current\x20reward\x20count.\x20Before\x20adding\x20a\x20new\x20reward,\x20call\x20reward_remove\x20or\x20reward_clear\x20to\x20'+'free\x20a\x20slot.\x20Consider\x20consolidating\x20rewards\x20into\x20a\x20single\x20Reward\x20object\x20with\x20multiple\x20tiers\x20if\x20the\x20'+'\x20Demand\x20needs\x20to\x20offer\x20more\x20than\x2020\x20distinct\x20reward\x20paths.','related_move_error':'E_MAX_REWARD_COUNT_EXCEEDED\x20(1)','auto_fixable':![]},'check':a=>{if(a['reward_count']===undefined)return null;if(a['reward_count']<=MAX_REWARD_COUNT)return null;return{...R_DEM_1_01['rule'],'evidence':'reward_count='+a['reward_count']+',\x20limit='+MAX_REWARD_COUNT};}},R_DEM_1_02={'rule':{'id':'R-DEM-02','level':'HIGH','category':'structural','title':'guards\x20count\x20exceeds\x20MAX_GUARD_COUNT_DEMAND\x20('+MAX_GUARD_COUNT_DEMAND+')','description':'The\x20\x27guards\x27\x20vector\x20is\x20bounded\x20by\x20MAX_GUARD_COUNT_DEMAND='+MAX_GUARD_COUNT_DEMAND+'\x20(Move\x20source:\x20demand.move:22).\x20'+'Exceeding\x20this\x20limit\x20aborts\x20with\x20E_MAX_GUARD_COUNT_EXCEEDED\x20(2).\x20Each\x20guard\x20carries\x20an\x20optional\x20'+'service_identifier\x20(u8)\x20that\x20routes\x20present_with_passport\x20submissions\x20to\x20a\x20specific\x20Service\x20submission\x20'+'extracted\x20from\x20the\x20Passport.\x20Adding\x20a\x20duplicate\x20guard\x20updates\x20the\x20service_identifier\x20instead\x20of\x20pushing.','affected_stakeholders':['creator','presenter'],'scenario':'Caller\x20calls\x20guard_add\x20when\x2020\x20guards\x20are\x20already\x20affiliated\x20and\x20the\x20address\x20is\x20new','mitigation':'Track\x20the\x20current\x20guard\x20count.\x20Before\x20adding\x20a\x20new\x20guard,\x20call\x20guard_remove\x20or\x20guard_clear.\x20'+'If\x20updating\x20an\x20existing\x20guard\x27s\x20service_identifier,\x20call\x20guard_add\x20with\x20the\x20same\x20address\x20(it\x20updates\x20'+'in\x20place\x20rather\x20than\x20pushing).','related_move_error':'E_MAX_GUARD_COUNT_EXCEEDED\x20(2)','auto_fixable':![]},'check':a=>{if(a['guard_count']===undefined)return null;if(a['guard_count']<=MAX_GUARD_COUNT_DEMAND)return null;return{...R_DEM_1_02['rule'],'evidence':'guard_count='+a['guard_count']+',\x20limit='+MAX_GUARD_COUNT_DEMAND};}},R_DEM_1_03={'rule':{'id':'R-DEM-03','level':'MEDIUM','category':'structural','title':'feedback\x20batch\x20exceeds\x20MAX_FEEDBACK_COUNT\x20('+MAX_FEEDBACK_COUNT+')','description':'The\x20\x27feedback\x27\x20Move\x20function\x20(demand.move:352)\x20updates\x20ONE\x20presenter\x20per\x20call\x20(feedback_imp\x20iterates\x20'+('no\x20vector).\x20The\x20SDK\x20batches\x20multiple\x20feedback\x20calls\x20and\x20caps\x20the\x20batch\x20at\x20MAX_FEEDBACK_COUNT='+MAX_FEEDBACK_COUNT+'\x20')+'(SDK-only\x20limit,\x20NOT\x20in\x20onchain-constants.ts\x20—\x20Move\x20has\x20no\x20aggregate\x20feedback-count\x20check).\x20Exceeding\x20the\x20'+'SDK\x20batch\x20limit\x20causes\x20the\x20SDK\x20to\x20refuse\x20the\x20call\x20before\x20transaction\x20building.\x20Each\x20feedback\x20entry\x20writes\x20'+'a\x20String\x20(bounded\x20by\x20common::DESCRIPTION,\x204000\x20chars)\x20and\x20an\x20optional\x20u8\x20acceptance_score\x20to\x20a\x20presenter\x27s\x20'+'ServiceInfo\x20record.','affected_stakeholders':['creator'],'scenario':'Caller\x20attempts\x20to\x20submit\x2021\x20feedback\x20entries\x20in\x20a\x20single\x20SDK\x20call','mitigation':'Split\x20the\x20feedback\x20batch\x20into\x20chunks\x20of\x20≤\x2020\x20entries.\x20If\x20the\x20Demand\x20has\x20more\x20than\x2020\x20presenters\x20to\x20'+'give\x20feedback\x20on,\x20submit\x20multiple\x20transactions.\x20Consider\x20whether\x20bulk\x20feedback\x20is\x20appropriate\x20—\x20'+'individualized\x20feedback\x20per\x20presenter\x20is\x20often\x20more\x20meaningful.','auto_fixable':![]},'check':a=>{if(a['feedback_count']===undefined)return null;if(a['feedback_count']<=MAX_FEEDBACK_COUNT)return null;return{...R_DEM_1_03['rule'],'evidence':'feedback_count='+a['feedback_count']+',\x20limit='+MAX_FEEDBACK_COUNT};}},R_DEM_2_01={'rule':{'id':'R-DEM-04','level':'HIGH','category':'semantic','title':'present\x20called\x20without\x20passport\x20when\x20guards\x20vector\x20is\x20non-empty','description':'The\x20Move\x20present\x20function\x20(demand.move:100)\x20asserts\x20`vector::is_empty(&self.guards)`\x20and\x20aborts\x20with\x20'+'E_NEED_PASSPORT\x20(3)\x20if\x20the\x20guards\x20vector\x20is\x20non-empty.\x20When\x20guards\x20exist,\x20every\x20presenter\x20MUST\x20go\x20through\x20'+'present_with_passport\x20(or\x20present_service_with_passport),\x20which\x20routes\x20through\x20present_with_passport_imp.\x20'+'That\x20function\x20looks\x20up\x20the\x20specified\x20Guard\x20in\x20the\x20guards\x20vector,\x20calls\x20passport::result_for_guard\x20to\x20'+'verify\x20the\x20Passport,\x20and\x20(if\x20service_identifier\x20is\x20set)\x20extracts\x20the\x20submission\x20address\x20from\x20the\x20Passport.\x20'+'Calling\x20plain\x20`present`\x20on\x20a\x20guarded\x20Demand\x20always\x20aborts\x20—\x20there\x20is\x20no\x20fallback\x20path.','affected_stakeholders':['presenter','creator'],'scenario':'Demand\x20has\x202\x20guards;\x20a\x20presenter\x20calls\x20present()\x20instead\x20of\x20present_with_passport()','mitigation':'Before\x20presenting,\x20query\x20the\x20Demand\x27s\x20guards\x20vector.\x20If\x20non-empty,\x20use\x20present_with_passport\x20and\x20'+'supply\x20a\x20Guard\x20+\x20Passport.\x20The\x20Guard\x20address\x20must\x20already\x20be\x20in\x20the\x20guards\x20vector\x20(otherwise\x20'+'E_GUARD_NOT_FOUND\x20(4)\x20aborts).\x20If\x20service_identifier\x20is\x20set\x20on\x20the\x20matching\x20guard,\x20the\x20submission\x20'+'address\x20is\x20extracted\x20from\x20the\x20Passport\x20—\x20do\x20not\x20pass\x20a\x20separate\x20service\x20parameter.','related_move_error':'E_NEED_PASSPORT\x20(3)','auto_fixable':![]},'check':a=>{if(!a['using_present_without_passport'])return null;if(!a['guards_non_empty'])return null;return{...R_DEM_2_01['rule'],'evidence':'guards_non_empty=true,\x20using\x20present\x20(no\x20passport)'};}},R_DEM_3_01={'rule':{'id':'R-DEM-05','level':'INFO','category':'lifecycle','title':'um_set_imp\x20object-linker\x20dependency\x20leak\x20—\x20RESOLVED\x20(P-DEM-P1-1)','description':'PREVIOUS\x20RISK:\x20um_set_imp\x20(demand.move:139-147)\x20previously\x20set\x20self.um\x20to\x20the\x20new\x20Contact\x20address\x20'+'BEFORE\x20disaffiliating\x20the\x20old\x20um,\x20causing\x20the\x20old\x20Contact\x20to\x20retain\x20a\x20stale\x20object-linker\x20binding\x20record\x20in\x20the\x20'+'object_linker.\x20affiliation_change_core\x20was\x20not\x20called\x20for\x20the\x20old\x20um,\x20leading\x20to\x20an\x20object-linker\x20dependency\x20leak.\x0a\x0a'+'FIX\x20(P-DEM-P1-1):\x20um_set_imp\x20now\x20disaffiliates\x20the\x20old\x20um\x20via\x20object_linker::disaffiliation_core\x20BEFORE\x20setting\x20'+'the\x20new\x20one.\x20The\x20new\x20um\x20is\x20then\x20affiliated\x20via\x20object_linker::affiliation_core.\x20This\x20matches\x20the\x20pattern\x20used\x20'+'by\x20permission_set\x20(which\x20uses\x20affiliation_change_core).\x20um_none_imp\x20also\x20disaffiliates\x20before\x20clearing.\x0a\x0a'+'This\x20rule\x20is\x20retained\x20for\x20historical\x20audit\x20and\x20to\x20detect\x20regressions.','affected_stakeholders':['creator','system'],'scenario':'Future\x20regression:\x20someone\x20reorders\x20um_set_imp\x20to\x20set\x20new\x20before\x20disaffiliating\x20old','mitigation':'Keep\x20the\x20disaffiliate-then-set\x20ordering.\x20The\x20Move\x20invariant:\x20any\x20path\x20that\x20mutates\x20self.um\x20MUST\x20call\x20'+'object_linker::disaffiliation_core\x20on\x20the\x20old\x20value\x20before\x20assigning\x20a\x20new\x20one.','auto_fixable':![]},'check':a=>{if(a['constants_synced'])return null;return{...R_DEM_3_01['rule'],'evidence':'constants_synced=false\x20(regression\x20check)'};}},R_DEM_2_02={'rule':{'id':'R-DEM-06','level':'INFO','category':'semantic','title':'guard_add_imp\x20service_identifier\x20type\x20check\x20skipped\x20on\x20early\x20return\x20—\x20RESOLVED\x20(P-DEM-P1-2)','description':'PREVIOUS\x20RISK:\x20guard_add_imp\x20(demand.move:213-242)\x20previously\x20had\x20the\x20service_identifier\x20type\x20check\x20'+'AFTER\x20the\x20early-return\x20path\x20that\x20updates\x20an\x20existing\x20guard\x27s\x20service_identifier.\x20When\x20a\x20guard\x20with\x20'+'the\x20same\x20address\x20already\x20existed,\x20the\x20function\x20returned\x20before\x20validating\x20the\x20new\x20service_identifier\x20'+'against\x20guard::get_submission_object_type.\x20This\x20allowed\x20setting\x20an\x20invalid\x20service_identifier\x20that\x20'+'would\x20later\x20fail\x20at\x20present_with_passport\x20time\x20with\x20E_INVALID_SERVICE_OBJECT_TYPE\x20(common.move:13).\x0a\x0a'+'FIX\x20(P-DEM-P1-2):\x20The\x20service_identifier\x20type\x20check\x20now\x20runs\x20FIRST\x20(demand.move:218-222),\x20BEFORE\x20the\x20'+'duplicate-detection\x20loop.\x20common::assert_service_object_type\x20is\x20called\x20for\x20any\x20non-None\x20service_identifier,\x20'+'ensuring\x20both\x20the\x20insert\x20and\x20update\x20paths\x20validate\x20the\x20type.\x0a\x0a'+'This\x20rule\x20is\x20retained\x20for\x20historical\x20audit\x20and\x20to\x20detect\x20regressions.','affected_stakeholders':['creator','presenter'],'scenario':'Future\x20regression:\x20someone\x20moves\x20the\x20type\x20check\x20back\x20to\x20after\x20the\x20duplicate-detection\x20loop','mitigation':'Keep\x20the\x20type\x20check\x20at\x20the\x20top\x20of\x20guard_add_imp.\x20The\x20Move\x20invariant:\x20any\x20service_identifier\x20provided\x20'+'to\x20guard_add\x20MUST\x20be\x20validated\x20via\x20guard::get_submission_object_type\x20+\x20common::assert_service_object_type\x20'+'BEFORE\x20any\x20mutation\x20of\x20the\x20guards\x20vector.','auto_fixable':![]},'check':a=>{if(a['constants_synced'])return null;return{...R_DEM_2_02['rule'],'evidence':'constants_synced=false\x20(regression\x20check)'};}},R_DEM_4_01={'rule':{'id':'R-DEM-07','level':'INFO','category':'knowledge','title':'extractDemandInfo\x20expects\x20non-existent\x20Move\x20fields\x20—\x20RESOLVED\x20(P-DEM-P1-3)','description':'PREVIOUS\x20RISK:\x20extractDemandInfo\x20in\x20demand-matching.ts\x20previously\x20read\x20fields\x20(tags,\x20maxPrice,\x20'+'scenario,\x20minTrustScore,\x20keywords)\x20that\x20do\x20NOT\x20exist\x20on\x20the\x20Move\x20Demand\x20struct.\x20The\x20Move\x20struct\x20only\x20'+'has:\x20description,\x20location,\x20rewards,\x20guards,\x20presenters,\x20um,\x20permission.\x20This\x20caused\x20the\x20matching\x20'+'engine\x20to\x20silently\x20produce\x20undefined\x20values\x20when\x20fed\x20raw\x20on-chain\x20query\x20results.\x0a\x0a'+'FIX\x20(P-DEM-P1-3):\x20extractDemandInfo\x20now\x20documents\x20the\x20caller-enrichment\x20contract.\x20Only\x20`location`\x20maps\x20'+'directly\x20to\x20the\x20Move\x20Demand\x20struct;\x20all\x20other\x20fields\x20(tags,\x20maxPrice,\x20scenario,\x20minTrustScore,\x20keywords)\x20'+'MUST\x20be\x20injected\x20by\x20the\x20caller\x20before\x20calling\x20matchDemand.\x20The\x20caller\x20is\x20responsible\x20for\x20sourcing\x20'+'this\x20data\x20from\x20Service\x20tags,\x20Reward\x20objects,\x20user\x20input,\x20or\x20NLP\x20on\x20the\x20description.\x0a\x0a'+'This\x20rule\x20is\x20retained\x20for\x20historical\x20audit\x20and\x20to\x20detect\x20regressions.','affected_stakeholders':['system'],'scenario':'Future\x20regression:\x20someone\x20removes\x20the\x20caller-enrichment\x20contract\x20docs\x20from\x20extractDemandInfo','mitigation':'Keep\x20the\x20[caller-enriched]\x20/\x20[on-chain]\x20annotations\x20on\x20DemandInfo\x20fields.\x20The\x20matching\x20engine\x20must\x20'+'never\x20query\x20on-chain\x20data\x20directly\x20—\x20it\x20is\x20a\x20pure\x20scoring\x20function\x20over\x20caller-injected\x20data.','auto_fixable':![]},'check':a=>{if(a['constants_synced'])return null;return{...R_DEM_4_01['rule'],'evidence':'constants_synced=false\x20(regression\x20check)'};}},R_DEM_4_02={'rule':{'id':'R-DEM-08','level':'INFO','category':'knowledge','title':'permission_set\x20not\x20exposed\x20in\x20SDK\x20—\x20RESOLVED\x20(DE-D-2=A)','description':'PREVIOUS\x20GAP:\x20The\x20Move\x20permission_set\x20function\x20(demand.move:286)\x20was\x20not\x20exposed\x20as\x20a\x20standalone\x20'+'function\x20in\x20the\x20SDK\x27s\x20call/demand.ts.\x20Callers\x20could\x20not\x20change\x20the\x20Permission\x20object\x20bound\x20to\x20a\x20Demand\x20'+'after\x20creation.\x0a\x0a'+'RESOLUTION\x20(DE-D-2=A):\x20permission_set\x20is\x20now\x20exposed\x20via\x20the\x20CallPermission.apply\x20mechanism.\x20The\x20SDK\x20'+'wraps\x20permission_set\x20by\x20routing\x20it\x20through\x20CallPermission,\x20which\x20performs\x20the\x20assert_owner\x20check\x20on\x20the\x20'+'old\x20Permission\x20and\x20updates\x20the\x20Demand\x27s\x20bound\x20permission.\x20object_linker\x27s\x20affiliation_change_core\x20is\x20called\x20'+'to\x20migrate\x20the\x20binding\x20from\x20the\x20old\x20Permission\x20to\x20the\x20new\x20one.\x0a\x0a'+'Permission\x20indices\x20for\x20Demand\x20(demand.move:20):\x20400=DEMAND_NEW,\x20401=DEMAND_DESCRIPTION,\x20402=DEMAND_LOCATION,\x20'+'404=DEMAND_GUARD,\x20405=DEMAND_REWARD,\x20406=DEMAND_FEEDBACK,\x20407=DEMAND_OWNER_RECEIVE,\x20408=DEMAND_UM.\x0a\x0a'+'This\x20rule\x20is\x20retained\x20for\x20historical\x20audit\x20and\x20to\x20detect\x20regressions.','affected_stakeholders':['creator','system'],'scenario':'Future\x20regression:\x20someone\x20removes\x20the\x20CallPermission.apply\x20path\x20for\x20permission_set','mitigation':'Keep\x20permission_set\x20exposed\x20via\x20CallPermission.apply.\x20The\x20Move\x20invariant:\x20permission_set\x20requires\x20'+'permission::assert_owner(old)\x20and\x20MUST\x20call\x20object_linker::affiliation_change_core\x20to\x20migrate\x20the\x20binding.','auto_fixable':![]},'check':a=>{if(a['constants_synced'])return null;return{...R_DEM_4_02['rule'],'evidence':'constants_synced=false\x20(regression\x20check)'};}};export const DEMAND_RISK_RULES=[R_DEM_1_01,R_DEM_1_02,R_DEM_1_03,R_DEM_2_01,R_DEM_3_01,R_DEM_2_02,R_DEM_4_01,R_DEM_4_02];export function checkDemandRisks(a){const b=[];for(const c of DEMAND_RISK_RULES){const d=c['check'](a);if(d)b['push'](d);}return b;}export function getDemandRiskById(a){return DEMAND_RISK_RULES['find'](b=>b['rule']['id']===a)?.['rule'];}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
export declare const DEMAND_TEMPLATES_VERSION = "1.0.0";
|
|
2
|
+
export interface DemandTemplate {
|
|
3
|
+
id: string;
|
|
4
|
+
name: string;
|
|
5
|
+
description: string;
|
|
6
|
+
rewards_required: boolean;
|
|
7
|
+
guards_required: boolean;
|
|
8
|
+
}
|
|
9
|
+
export declare const DEMAND_TEMPLATES: DemandTemplate[];
|
|
10
|
+
export declare function getDemandTemplateById(id: string): DemandTemplate | undefined;
|
|
11
|
+
export declare function listDemandTemplates(): DemandTemplate[];
|
|
12
|
+
export declare function suggestDemandTemplate(rewards: number, guards: number): DemandTemplate | undefined;
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export const DEMAND_TEMPLATES_VERSION='1.0.0';export const DEMAND_TEMPLATES=[{'id':'demand_open','name':'Open\x20demand','description':'A\x20public\x20announcement\x20any\x20service\x20can\x20present\x20to\x20(no\x20guards).','rewards_required':![],'guards_required':![]},{'id':'demand_guarded','name':'Guarded\x20demand','description':'Only\x20services\x20passing\x20the\x20present\x20guards\x20may\x20submit.','rewards_required':![],'guards_required':!![]},{'id':'demand_rewarded','name':'Rewarded\x20demand','description':'A\x20demand\x20with\x20monetary\x20rewards\x20to\x20incentivize\x20presentations.','rewards_required':!![],'guards_required':![]}];export function getDemandTemplateById(a){return DEMAND_TEMPLATES['find'](b=>b['id']===a);}export function listDemandTemplates(){return DEMAND_TEMPLATES;}export function suggestDemandTemplate(a,b){if(a>0x0&&b>0x0)return DEMAND_TEMPLATES['find'](c=>c['id']==='demand_rewarded');if(b>0x0)return DEMAND_TEMPLATES['find'](c=>c['id']==='demand_guarded');if(a>0x0)return DEMAND_TEMPLATES['find'](c=>c['id']==='demand_rewarded');return DEMAND_TEMPLATES['find'](c=>c['id']==='demand_open');}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
import{MAX_REWARD_COUNT,MAX_GUARD_COUNT_DEMAND,MAX_DESCRIPTION_LENGTH,MAX_LONG_NAME_LENGTH}from'@wowok/wowok';const MAX_FEEDBACK_COUNT=0x14;export const SEMANTIC_TO_DEMAND_SCHEMA_RULES=[{'id':'P-DEM-01','pattern_name':'Open\x20Demand\x20(no\x20guards)\x20—\x20free\x20presentation','configuration_classification':'open','semantic_intent':'An\x20open\x20Demand\x20accepts\x20presentations\x20from\x20any\x20sender\x20via\x20the\x20plain\x20`present`\x20function\x20(demand.move:100).\x20'+'No\x20Passport\x20is\x20required.\x20Use\x20this\x20for\x20broad-cast\x20demands\x20where\x20the\x20creator\x20wants\x20to\x20collect\x20as\x20many\x20'+'presentations\x20as\x20possible\x20(e.g.\x20open\x20calls\x20for\x20service\x20providers,\x20public\x20RFPs).\x20The\x20guards\x20vector\x20is\x20empty.','match_keywords':['open','no\x20guard','free\x20presentation','public','rfp','open\x20call'],'schema_elements':{'required_fields':['description','permission'],'optional_fields':['location','rewards','um','namedNew'],'presentation_path':'plain_present','um_recommendation':'Optional.\x20Set\x20um\x20to\x20a\x20Contact\x20object\x20if\x20the\x20Demand\x20should\x20be\x20managed\x20by\x20an\x20intermediary.\x20'+'Leave\x20as\x20Option::none\x20for\x20direct\x20creator\x20management.'},'constraints':['guards\x20vector\x20must\x20be\x20empty\x20(initial\x20state\x20—\x20do\x20not\x20call\x20guard_add)','Callers\x20MUST\x20use\x20plain\x20`present`\x20or\x20`present_service`\x20—\x20present_with_passport\x20will\x20abort\x20with\x20E_GUARD_NOT_FOUND\x20(4)','description\x20non-empty\x20and\x20within\x20MAX_DESCRIPTION_LENGTH\x20(4000\x20chars)','If\x20location\x20is\x20set,\x20within\x20MAX_LONG_NAME_LENGTH\x20(256\x20chars)'],'example':{'description':'Open\x20call\x20for\x20freelance\x20designers\x20—\x20submit\x20portfolio\x20link\x20as\x20recommend','location':'Shanghai','rewards':['0xabc...reward_addr_1'],'permission':'0xperm...permission_addr','um':null,'namedNew':{'name':'open_design_call_2026'}}},{'id':'P-DEM-02','pattern_name':'Guarded\x20Demand\x20(with\x20guards)\x20—\x20passport\x20required\x20for\x20present','configuration_classification':'guarded','semantic_intent':'A\x20guarded\x20Demand\x20requires\x20every\x20presenter\x20to\x20supply\x20a\x20Passport\x20that\x20passes\x20one\x20of\x20the\x20affiliated\x20Guards.\x20'+'Use\x20this\x20when\x20the\x20creator\x20wants\x20to\x20filter\x20presentations\x20by\x20Guard-defined\x20criteria\x20(KYC,\x20membership,\x20'+'stake,\x20etc.).\x20The\x20guards\x20vector\x20is\x20non-empty.\x20Each\x20guard\x20carries\x20an\x20optional\x20service_identifier\x20that,\x20'+'when\x20set,\x20routes\x20present_with_passport\x20to\x20extract\x20the\x20submission\x20address\x20from\x20the\x20Passport\x20(overriding\x20'+'the\x20supplied\x20service\x20parameter).','match_keywords':['guarded','passport','kyc','membership','filtered','gated','service_identifier'],'schema_elements':{'required_fields':['description','permission','guards'],'optional_fields':['location','rewards','um','namedNew'],'presentation_path':'present_with_passport','um_recommendation':'Optional.\x20Same\x20as\x20P-DEM-01.\x20If\x20the\x20Demand\x20is\x20mediated\x20by\x20an\x20intermediary\x20Contact,\x20set\x20um\x20to\x20that\x20'+'Contact\x20address\x20and\x20the\x20intermediary\x20can\x20manage\x20the\x20Demand\x20via\x20the\x20Contact\x27s\x20permission.'},'constraints':['guards\x20vector\x20non-empty\x20(call\x20guard_add\x20at\x20least\x20once)','Each\x20guard\x20address\x20must\x20be\x20unique\x20(duplicate\x20guard_add\x20updates\x20service_identifier\x20instead\x20of\x20pushing)','guard_count\x20≤\x20MAX_GUARD_COUNT_DEMAND\x20(20)\x20—\x20E_MAX_GUARD_COUNT_EXCEEDED\x20(2)\x20on\x20overflow','When\x20service_identifier\x20is\x20provided,\x20it\x20MUST\x20be\x20a\x20valid\x20u8\x20indexing\x20a\x20Service-typed\x20submission\x20in\x20the\x20Guard','Presenters\x20MUST\x20use\x20present_with_passport\x20/\x20present_service_with_passport\x20—\x20plain\x20present\x20aborts\x20with\x20E_NEED_PASSPORT\x20(3)','by_guard\x20(Guard\x20address)\x20passed\x20to\x20present_with_passport\x20MUST\x20already\x20be\x20in\x20the\x20guards\x20vector\x20—\x20E_GUARD_NOT_FOUND\x20(4)\x20otherwise'],'example':{'description':'KYC-gated\x20call\x20for\x20certified\x20auditors\x20only','location':'Remote','rewards':['0xabc...reward_addr_1','0xdef...reward_addr_2'],'guards':[{'guard':'0xguard1...','service_identifier':0x0},{'guard':'0xguard2...','service_identifier':null}],'permission':'0xperm...permission_addr','um':null,'namedNew':{'name':'kyc_auditor_call_2026'}}},{'id':'P-DEM-03','pattern_name':'Demand\x20with\x20UM\x20(um_set)\x20—\x20Contact\x20object\x20manages\x20demand','configuration_classification':'um_managed','semantic_intent':'A\x20Demand\x20with\x20um\x20set\x20has\x20an\x20affiliated\x20Contact\x20object\x20that\x20manages\x20the\x20Demand\x20on\x20behalf\x20of\x20the\x20creator.\x20'+'The\x20Contact\x27s\x20address\x20is\x20stored\x20in\x20Demand.um\x20(Option<address>).\x20The\x20Contact\x20can\x20perform\x20operations\x20'+'through\x20its\x20own\x20permission\x20scope.\x20Use\x20this\x20when\x20a\x20Demand\x20is\x20operated\x20by\x20an\x20intermediary\x20(agent,\x20'+'marketplace,\x20escrow\x20service)\x20rather\x20than\x20the\x20original\x20creator.\x20um_set_imp\x20(demand.move:139-147)\x20'+'disaffiliates\x20the\x20old\x20um\x20before\x20affiliating\x20the\x20new\x20one\x20(P-DEM-P1-1\x20fix).','match_keywords':['um','contact','managed','intermediary','agent','marketplace','escrow'],'schema_elements':{'required_fields':['description','permission','um'],'optional_fields':['location','rewards','guards','namedNew'],'presentation_path':'either','um_recommendation':'Required\x20for\x20this\x20pattern.\x20Set\x20um\x20to\x20a\x20Contact\x20object\x20address\x20via\x20um_set.\x20The\x20Contact\x27s\x20'+'permission\x20scope\x20applies\x20to\x20subsequent\x20operations.\x20To\x20remove\x20the\x20Contact,\x20call\x20um_none\x20—\x20'+'um_none_imp\x20disaffiliates\x20the\x20Contact\x20before\x20clearing\x20self.um.'},'constraints':['um\x20must\x20be\x20a\x20valid\x20Contact\x20object\x20address\x20(set\x20via\x20um_set,\x20permission\x20index\x20408)','um_set_imp\x20disaffiliates\x20old\x20um\x20before\x20affiliating\x20new\x20(P-DEM-P1-1\x20fix\x20—\x20prevents\x20Registrar\x20dependency\x20leak)','um_none_imp\x20disaffiliates\x20um\x20before\x20clearing\x20(symmetric\x20with\x20um_set_imp)','If\x20guards\x20is\x20also\x20non-empty,\x20the\x20present_with_passport\x20path\x20applies\x20(P-DEM-02\x20constraints\x20also\x20hold)','permission_set\x20(DE-D-2=A)\x20can\x20migrate\x20the\x20Demand\x20to\x20a\x20new\x20Permission\x20—\x20affiliation_change\x20is\x20called\x20on\x20the\x20Registrar'],'example':{'description':'Marketplace-managed\x20Demand\x20for\x20freelance\x20design\x20services','location':'Shanghai','rewards':['0xabc...reward_addr_1'],'guards':[{'guard':'0xguard1...','service_identifier':null}],'permission':'0xperm...permission_addr','um':'0xcontact...marketplace_contact_addr','namedNew':{'name':'marketplace_managed_design_2026'}}}];export const DEMAND_FIELD_TRANSLATIONS=[{'field_name':'description','value_type':'string','semantic':'Human-readable\x20description\x20of\x20this\x20Demand.\x20Required\x20field.\x20The\x20Move\x20contract\x20validates\x20via\x20'+'common::DESCRIPTION\x20(demand.move:157,177),\x20which\x20enforces\x20the\x204000-char\x20limit.\x20Should\x20be\x20a\x20one-line\x20'+'summary\x20of\x20what\x20the\x20Demand\x20is\x20asking\x20for\x20(e.g.\x20\x22freelance\x20designer\x20for\x20brand\x20identity\x20work\x22).','format_example':'Freelance\x20designer\x20for\x20brand\x20identity\x20work\x20(logo\x20+\x20style\x20guide)','validation_rules':['Required\x20field','Length\x20≤\x20MAX_DESCRIPTION_LENGTH\x20('+MAX_DESCRIPTION_LENGTH+'\x20chars)','Move\x20validates\x20via\x20common::DESCRIPTION\x20—\x20E_DESCRIPTION_LENGTH_EXCEEDED\x20(4)\x20on\x20overflow']},{'field_name':'location','value_type':'string','semantic':'Geographic\x20location\x20associated\x20with\x20the\x20Demand.\x20Validated\x20via\x20common::LONG_NAME\x20(demand.move:180).\x20'+'Empty\x20string\x20(\x22\x22)\x20is\x20valid\x20—\x20new_imp\x20initializes\x20location\x20to\x20empty.\x20Use\x20location_set\x20to\x20update\x20after\x20'+'creation.\x20This\x20is\x20the\x20ONLY\x20Move\x20Demand\x20struct\x20field\x20that\x20the\x20matching\x20engine\x20reads\x20directly\x20(other\x20'+'matching\x20fields\x20like\x20tags,\x20maxPrice,\x20scenario\x20are\x20caller-enriched\x20—\x20see\x20P-DEM-P1-3\x20/\x20R-DEM-07).','format_example':'Shanghai\x20or\x20Remote','validation_rules':['Optional\x20(empty\x20string\x20\x22\x22\x20is\x20the\x20default\x20initial\x20value)','Length\x20≤\x20MAX_LONG_NAME_LENGTH\x20('+MAX_LONG_NAME_LENGTH+'\x20chars)','Move\x20validates\x20via\x20common::LONG_NAME\x20—\x20E_LONG_NAME_LENGTH_EXCEEDED\x20(11)\x20on\x20overflow']},{'field_name':'rewards','value_type':'vector<address>\x20(string[]\x20in\x20SDK)','semantic':'Reward\x20object\x20addresses\x20affiliated\x20with\x20this\x20Demand.\x20Each\x20reward\x20is\x20added\x20via\x20reward_add,\x20which\x20'+'triggers\x20registrar::affiliation.\x20The\x20matching\x20engine\x20reads\x20maxPrice\x20from\x20the\x20Reward\x20objects\x20'+'(caller-enriched\x20—\x20the\x20Demand\x20struct\x20only\x20stores\x20addresses,\x20not\x20Reward\x20metadata).','format_example':'[\x220xabc...reward_addr_1\x22,\x20\x220xdef...reward_addr_2\x22]','validation_rules':['Count\x20≤\x20MAX_REWARD_COUNT\x20('+MAX_REWARD_COUNT+')\x20—\x20E_MAX_REWARD_COUNT_EXCEEDED\x20(1)\x20on\x20overflow','Each\x20address\x20must\x20be\x20a\x20valid\x20Reward\x20object\x20address','Duplicate\x20addresses\x20are\x20silently\x20ignored\x20(reward_add_imp\x20checks\x20contains\x20before\x20push)','reward_remove\x20/\x20reward_clear\x20disaffiliate\x20via\x20the\x20Registrar\x20before\x20removing']},{'field_name':'guards','value_type':'vector<ServiceGuard>\x20({\x20guard:\x20address,\x20service_identifier:\x20Option<u8>\x20}[]\x20in\x20SDK)','semantic':'Guard\x20addresses\x20with\x20optional\x20service_identifier.\x20When\x20non-empty,\x20presenters\x20MUST\x20use\x20'+'present_with_passport\x20(or\x20present_service_with_passport).\x20The\x20service_identifier,\x20when\x20set,\x20routes\x20'+'present_with_passport\x20to\x20extract\x20the\x20submission\x20address\x20from\x20the\x20Passport\x20(overriding\x20the\x20supplied\x20'+'service\x20parameter).\x20guard_add\x20validates\x20the\x20service_identifier\x20type\x20BEFORE\x20any\x20mutation\x20(P-DEM-P1-2\x20fix).','format_example':'[{\x20guard:\x20\x220xguard1...\x22,\x20service_identifier:\x200\x20},\x20{\x20guard:\x20\x220xguard2...\x22,\x20service_identifier:\x20null\x20}]','validation_rules':['Count\x20≤\x20MAX_GUARD_COUNT_DEMAND\x20('+MAX_GUARD_COUNT_DEMAND+')\x20—\x20E_MAX_GUARD_COUNT_EXCEEDED\x20(2)\x20on\x20overflow','Each\x20guard\x20address\x20must\x20be\x20a\x20valid\x20Guard\x20object\x20address','Duplicate\x20addresses\x20update\x20service_identifier\x20in\x20place\x20(no\x20new\x20push)','When\x20service_identifier\x20is\x20provided,\x20it\x20MUST\x20index\x20a\x20Service-typed\x20submission\x20in\x20the\x20Guard','guard_remove\x20/\x20guard_clear\x20disaffiliate\x20via\x20the\x20Registrar\x20before\x20removing']},{'field_name':'um','value_type':'Option<address>\x20(string\x20|\x20null\x20in\x20SDK)','semantic':'Optional\x20Contact\x20object\x20address\x20that\x20manages\x20this\x20Demand.\x20When\x20set,\x20the\x20Contact\x20can\x20perform\x20'+'operations\x20through\x20its\x20own\x20permission\x20scope.\x20um_set_imp\x20(demand.move:139-147)\x20disaffiliates\x20the\x20old\x20'+'um\x20before\x20affiliating\x20the\x20new\x20one\x20(P-DEM-P1-1\x20fix\x20—\x20prevents\x20Registrar\x20dependency\x20leak).\x20To\x20clear,\x20'+'call\x20um_none\x20—\x20um_none_imp\x20disaffiliates\x20before\x20clearing\x20self.um.','format_example':'0xcontact...marketplace_contact_addr\x20or\x20null','validation_rules':['Optional\x20(null/undefined\x20→\x20Option::none)\x20—\x20initial\x20state','When\x20set,\x20must\x20be\x20a\x20valid\x20Contact\x20object\x20address','um_set_imp\x20disaffiliates\x20old\x20um\x20before\x20setting\x20new\x20(P-DEM-P1-1\x20fix)','um_none_imp\x20disaffiliates\x20um\x20before\x20clearing\x20(symmetric)','Permission\x20index\x20408\x20required\x20for\x20um_set\x20/\x20um_none']},{'field_name':'presenters','value_type':'ParentTable<address,\x20ServiceInfo>\x20(not\x20directly\x20settable\x20—\x20populated\x20by\x20present)','semantic':'Service\x20presentation\x20records,\x20keyed\x20by\x20presenter\x20address.\x20Each\x20entry\x20contains:\x20recommend\x20(String),\x20'+'service\x20(Option<address>),\x20update_time\x20(u64),\x20acceptance_score\x20(Option<u8>),\x20feedback\x20(String),\x20'+'feedback_time\x20(u64).\x20Populated\x20by\x20present_imp\x20—\x20presenters\x20call\x20present\x20/\x20present_with_passport\x20to\x20'+'add\x20or\x20update\x20their\x20entry.\x20feedback_imp\x20updates\x20an\x20existing\x20entry\x27s\x20feedback\x20fields.','format_example':'(not\x20directly\x20settable\x20—\x20populated\x20by\x20present\x20operations)','validation_rules':['Not\x20directly\x20settable\x20by\x20the\x20creator\x20—\x20populated\x20by\x20presenter\x20operations','Each\x20presenter\x20address\x20maps\x20to\x20at\x20most\x20one\x20ServiceInfo\x20entry','present\x20updates\x20update_time\x20and\x20overwrites\x20recommend/service\x20on\x20each\x20call','feedback\x20updates\x20acceptance_score,\x20feedback,\x20feedback_time\x20(only\x20if\x20presenter\x20exists)']},{'field_name':'permission','value_type':'address','semantic':'Permission\x20object\x20address\x20bound\x20to\x20this\x20Demand.\x20All\x20mutations\x20require\x20permission::assert_permission_with_sender\x20'+'with\x20the\x20appropriate\x20index\x20(400-408).\x20permission_set\x20(demand.move:286)\x20is\x20exposed\x20via\x20CallPermission.apply\x20'+'(DE-D-2=A)\x20and\x20migrates\x20the\x20affiliation\x20via\x20registrar::affiliation_change.','format_example':'0xperm...permission_addr','validation_rules':['Required\x20field\x20(set\x20at\x20creation\x20via\x20new_imp)','permission::assert_with_sender(permission,\x20400,\x20ctx)\x20required\x20for\x20new\x20(DEMAND_NEW)','permission::assert_permission_with_sender(permission,\x20<index>,\x20&self.permission,\x20ctx)\x20required\x20for\x20all\x20mutations','Permission\x20indices:\x20400=NEW,\x20401=DESCRIPTION,\x20402=LOCATION,\x20404=GUARD,\x20405=REWARD,\x20406=FEEDBACK,\x20407=OWNER_RECEIVE,\x20408=UM','permission_set\x20migrates\x20affiliation\x20via\x20registrar::affiliation_change\x20(DE-D-2=A)']}];export const DEMAND_CONSTRAINT_RULES=[{'id':'DEMAND_C_01','name':'description\x20non-empty\x20and\x20within\x20size\x20limit','description':'The\x20\x27description\x27\x20field\x20must\x20be\x20non-empty\x20and\x20≤\x20MAX_DESCRIPTION_LENGTH\x20('+MAX_DESCRIPTION_LENGTH+'\x20chars).','validation_logic':'description.length\x20>\x200\x20&&\x20description.length\x20<=\x20MAX_DESCRIPTION_LENGTH','failure_message':'description\x20must\x20be\x201..'+MAX_DESCRIPTION_LENGTH+'\x20chars\x20—\x20E_DESCRIPTION_LENGTH_EXCEEDED\x20(4)\x20on\x20overflow','related_field':'description'},{'id':'DEMAND_C_02','name':'location\x20within\x20size\x20limit','description':'The\x20\x27location\x27\x20field\x20must\x20be\x20≤\x20MAX_LONG_NAME_LENGTH\x20('+MAX_LONG_NAME_LENGTH+'\x20chars).\x20Empty\x20string\x20is\x20valid.','validation_logic':'location.length\x20<=\x20MAX_LONG_NAME_LENGTH','failure_message':'location\x20exceeds\x20MAX_LONG_NAME_LENGTH\x20('+MAX_LONG_NAME_LENGTH+'\x20chars)\x20—\x20E_LONG_NAME_LENGTH_EXCEEDED\x20(11)','related_field':'location'},{'id':'DEMAND_C_03','name':'rewards\x20count\x20within\x20limit','description':'The\x20\x27rewards\x27\x20vector\x20count\x20must\x20be\x20≤\x20MAX_REWARD_COUNT\x20('+MAX_REWARD_COUNT+').','validation_logic':'rewards.length\x20<=\x20MAX_REWARD_COUNT','failure_message':'rewards\x20count\x20exceeds\x20MAX_REWARD_COUNT\x20('+MAX_REWARD_COUNT+')\x20—\x20E_MAX_REWARD_COUNT_EXCEEDED\x20(1)','related_field':'rewards'},{'id':'DEMAND_C_04','name':'guards\x20count\x20within\x20limit','description':'The\x20\x27guards\x27\x20vector\x20count\x20must\x20be\x20≤\x20MAX_GUARD_COUNT_DEMAND\x20('+MAX_GUARD_COUNT_DEMAND+').','validation_logic':'guards.length\x20<=\x20MAX_GUARD_COUNT_DEMAND','failure_message':'guards\x20count\x20exceeds\x20MAX_GUARD_COUNT_DEMAND\x20('+MAX_GUARD_COUNT_DEMAND+')\x20—\x20E_MAX_GUARD_COUNT_EXCEEDED\x20(2)','related_field':'guards'},{'id':'DEMAND_C_05','name':'service_identifier\x20valid\x20u8\x20when\x20provided','description':'When\x20service_identifier\x20is\x20provided\x20to\x20guard_add,\x20it\x20must\x20be\x20a\x20valid\x20u8\x20(0-255)\x20indexing\x20a\x20'+'Service-typed\x20submission\x20in\x20the\x20Guard.\x20guard_add_imp\x20validates\x20via\x20guard::get_submission_object_type\x20'+'and\x20common::assert_service_object_type\x20BEFORE\x20any\x20mutation\x20(P-DEM-P1-2\x20fix).','validation_logic':'service_identifier\x20==\x20null\x20||\x20(Number.isInteger(service_identifier)\x20&&\x200\x20<=\x20service_identifier\x20&&\x20service_identifier\x20<=\x20255)','failure_message':'service_identifier\x20must\x20be\x20a\x20u8\x20(0-255)\x20indexing\x20a\x20Service-typed\x20submission\x20—\x20E_INVALID_SERVICE_OBJECT_TYPE\x20(13)','related_field':'guards.service_identifier'},{'id':'DEMAND_C_06','name':'present\x20requires\x20passport\x20when\x20guards\x20non-empty','description':'When\x20the\x20guards\x20vector\x20is\x20non-empty,\x20callers\x20MUST\x20use\x20present_with_passport\x20/\x20present_service_with_passport.\x20'+'The\x20plain\x20present\x20function\x20asserts\x20`vector::is_empty(&self.guards)`\x20and\x20aborts\x20with\x20E_NEED_PASSPORT\x20(3).\x20'+'The\x20by_guard\x20parameter\x20to\x20present_with_passport\x20MUST\x20already\x20be\x20in\x20the\x20guards\x20vector\x20'+'(otherwise\x20E_GUARD_NOT_FOUND\x20(4)).','validation_logic':'!guards_non_empty\x20||\x20using_present_with_passport;\x20by_guard\x20in\x20guards','failure_message':'present\x20without\x20passport\x20when\x20guards\x20non-empty\x20—\x20E_NEED_PASSPORT\x20(3);\x20by_guard\x20not\x20in\x20guards\x20—\x20E_GUARD_NOT_FOUND\x20(4)','related_field':'guards\x20+\x20presentation_path'}];export function explainDemand(a){const b=[],c=[],d=!!a['guards']&&a['guards']['length']>0x0,e=!!a['um'];let f='open',g='plain_present';if(d&&e)f='guarded\x20+\x20um_managed\x20(P-DEM-02\x20+\x20P-DEM-03\x20combined)',g='present_with_passport\x20(um\x20does\x20not\x20change\x20presentation\x20path)';else{if(d)f='guarded\x20(P-DEM-02)\x20—\x20passport\x20required\x20for\x20present',g='present_with_passport\x20/\x20present_service_with_passport';else e?(f='um_managed\x20(P-DEM-03)\x20—\x20Contact\x20manages\x20the\x20Demand',g='plain\x20present\x20(no\x20guards)\x20OR\x20present_with_passport\x20(if\x20guards\x20added\x20later)'):(f='open\x20(P-DEM-01)\x20—\x20free\x20presentation,\x20no\x20passport\x20required',g='present\x20/\x20present_service\x20(plain\x20path)');}const h=[];a['permission']&&h['push']('permission='+a['permission']['substring'](0x0,0xa)+'...\x20(bound\x20at\x20creation)');e&&h['push']('um='+a['um']['substring'](0x0,0xa)+'...\x20(Contact\x20manages\x20Demand)');a['rewards']&&a['rewards']['length']>0x0&&h['push']('rewards='+a['rewards']['length']+'\x20affiliated\x20via\x20Registrar');d&&h['push']('guards='+a['guards']['length']+'\x20affiliated\x20via\x20Registrar');const i=h['length']>0x0?'Bindings:\x20'+h['join'](';\x20'):'No\x20Registrar\x20affiliations\x20(bare\x20Demand)',j=[];a['description']!==undefined&&j['push']('description='+a['description']['length']+'\x20chars\x20(limit\x20'+MAX_DESCRIPTION_LENGTH+')');a['location']!==undefined&&j['push']('location='+a['location']['length']+'\x20chars\x20(limit\x20'+MAX_LONG_NAME_LENGTH+')');a['rewards']&&j['push']('rewards='+a['rewards']['length']+'/'+MAX_REWARD_COUNT);a['guards']&&j['push']('guards='+a['guards']['length']+'/'+MAX_GUARD_COUNT_DEMAND);if(d){const l=a['guards']['filter'](m=>m['service_identifier']!==null&&m['service_identifier']!==undefined&&!(typeof m['service_identifier']==='number'&&Number['isInteger'](m['service_identifier'])&&m['service_identifier']>=0x0&&m['service_identifier']<=0xff));l['length']>0x0&&b['push'](l['length']+'\x20guard(s)\x20have\x20invalid\x20service_identifier\x20(must\x20be\x20u8\x200-255)');}(!a['description']||a['description']['length']===0x0)&&b['push']('description\x20is\x20empty\x20—\x20Demand\x20will\x20be\x20hard\x20to\x20identify\x20in\x20queries');(!a['description']||a['description']['length']===0x0)&&c['push']('Provide\x20a\x20non-empty\x20description\x20for\x20discoverability');(a['location']===undefined||a['location']==='')&&c['push']('Consider\x20setting\x20location\x20if\x20the\x20Demand\x20is\x20geographic\x20(only\x20on-chain\x20field\x20used\x20by\x20matching)');!d&&c['push']('Consider\x20adding\x20guards\x20if\x20presentations\x20should\x20be\x20filtered\x20(KYC,\x20membership,\x20etc.)');!e&&f==='open'&&c['push']('Consider\x20setting\x20um\x20to\x20a\x20Contact\x20if\x20the\x20Demand\x20should\x20be\x20managed\x20by\x20an\x20intermediary');const k='Demand\x20is\x20'+f+'.\x20'+g+'.\x20'+i+'.\x20'+(j['length']>0x0?'Sizes:\x20'+j['join'](',\x20')+'.':'');return{'summary':k,'configuration_classification':f,'presentation_path':g,'binding_status':i,'size_status':j['join'](',\x20'),'warnings':b,'recommendations':c};}
|
|
1
|
+
import{MAX_REWARD_COUNT,MAX_GUARD_COUNT_DEMAND,MAX_DESCRIPTION_LENGTH,MAX_LONG_NAME_LENGTH}from'@wowok/wowok';export const SEMANTIC_TO_DEMAND_SCHEMA_RULES=[{'id':'P-DEM-01','pattern_name':'Open\x20Demand\x20(no\x20guards)\x20—\x20free\x20presentation','configuration_classification':'open','semantic_intent':'An\x20open\x20Demand\x20accepts\x20presentations\x20from\x20any\x20sender\x20via\x20the\x20plain\x20`present`\x20function\x20(demand.move:100).\x20'+'No\x20Passport\x20is\x20required.\x20Use\x20this\x20for\x20broad-cast\x20demands\x20where\x20the\x20creator\x20wants\x20to\x20collect\x20as\x20many\x20'+'presentations\x20as\x20possible\x20(e.g.\x20open\x20calls\x20for\x20service\x20providers,\x20public\x20RFPs).\x20The\x20guards\x20vector\x20is\x20empty.','match_keywords':['open','no\x20guard','free\x20presentation','public','rfp','open\x20call'],'schema_elements':{'required_fields':['description','permission'],'optional_fields':['location','rewards','um','namedNew'],'presentation_path':'plain_present','um_recommendation':'Optional.\x20Set\x20um\x20to\x20a\x20Contact\x20object\x20if\x20the\x20Demand\x20should\x20be\x20managed\x20by\x20an\x20intermediary.\x20'+'Leave\x20as\x20Option::none\x20for\x20direct\x20creator\x20management.'},'constraints':['guards\x20vector\x20must\x20be\x20empty\x20(initial\x20state\x20—\x20do\x20not\x20call\x20guard_add)','Callers\x20MUST\x20use\x20plain\x20`present`\x20or\x20`present_service`\x20—\x20present_with_passport\x20will\x20abort\x20with\x20E_GUARD_NOT_FOUND\x20(4)','description\x20non-empty\x20and\x20within\x20MAX_DESCRIPTION_LENGTH\x20(4000\x20chars)','If\x20location\x20is\x20set,\x20within\x20MAX_LONG_NAME_LENGTH\x20(256\x20chars)'],'example':{'description':'Open\x20call\x20for\x20freelance\x20designers\x20—\x20submit\x20portfolio\x20link\x20as\x20recommend','location':'Shanghai','rewards':['0xabc...reward_addr_1'],'permission':'0xperm...permission_addr','um':null,'namedNew':{'name':'open_design_call_2026'}}},{'id':'P-DEM-02','pattern_name':'Guarded\x20Demand\x20(with\x20guards)\x20—\x20passport\x20required\x20for\x20present','configuration_classification':'guarded','semantic_intent':'A\x20guarded\x20Demand\x20requires\x20every\x20presenter\x20to\x20supply\x20a\x20Passport\x20that\x20passes\x20one\x20of\x20the\x20affiliated\x20Guards.\x20'+'Use\x20this\x20when\x20the\x20creator\x20wants\x20to\x20filter\x20presentations\x20by\x20Guard-defined\x20criteria\x20(KYC,\x20membership,\x20'+'stake,\x20etc.).\x20The\x20guards\x20vector\x20is\x20non-empty.\x20Each\x20guard\x20carries\x20an\x20optional\x20service_identifier\x20that,\x20'+'when\x20set,\x20routes\x20present_with_passport\x20to\x20extract\x20the\x20submission\x20address\x20from\x20the\x20Passport\x20(overriding\x20'+'the\x20supplied\x20service\x20parameter).','match_keywords':['guarded','passport','kyc','membership','filtered','gated','service_identifier'],'schema_elements':{'required_fields':['description','permission','guards'],'optional_fields':['location','rewards','um','namedNew'],'presentation_path':'present_with_passport','um_recommendation':'Optional.\x20Same\x20as\x20P-DEM-01.\x20If\x20the\x20Demand\x20is\x20mediated\x20by\x20an\x20intermediary\x20Contact,\x20set\x20um\x20to\x20that\x20'+'Contact\x20address\x20and\x20the\x20intermediary\x20can\x20manage\x20the\x20Demand\x20via\x20the\x20Contact\x27s\x20permission.'},'constraints':['guards\x20vector\x20non-empty\x20(call\x20guard_add\x20at\x20least\x20once)','Each\x20guard\x20address\x20must\x20be\x20unique\x20(duplicate\x20guard_add\x20updates\x20service_identifier\x20instead\x20of\x20pushing)','guard_count\x20≤\x20MAX_GUARD_COUNT_DEMAND\x20(20)\x20—\x20E_MAX_GUARD_COUNT_EXCEEDED\x20(2)\x20on\x20overflow','When\x20service_identifier\x20is\x20provided,\x20it\x20MUST\x20be\x20a\x20valid\x20u8\x20indexing\x20a\x20Service-typed\x20submission\x20in\x20the\x20Guard','Presenters\x20MUST\x20use\x20present_with_passport\x20/\x20present_service_with_passport\x20—\x20plain\x20present\x20aborts\x20with\x20E_NEED_PASSPORT\x20(3)','by_guard\x20(Guard\x20address)\x20passed\x20to\x20present_with_passport\x20MUST\x20already\x20be\x20in\x20the\x20guards\x20vector\x20—\x20E_GUARD_NOT_FOUND\x20(4)\x20otherwise'],'example':{'description':'KYC-gated\x20call\x20for\x20certified\x20auditors\x20only','location':'Remote','rewards':['0xabc...reward_addr_1','0xdef...reward_addr_2'],'guards':[{'guard':'0xguard1...','service_identifier':0x0},{'guard':'0xguard2...','service_identifier':null}],'permission':'0xperm...permission_addr','um':null,'namedNew':{'name':'kyc_auditor_call_2026'}}},{'id':'P-DEM-03','pattern_name':'Demand\x20with\x20UM\x20(um_set)\x20—\x20Contact\x20object\x20manages\x20demand','configuration_classification':'um_managed','semantic_intent':'A\x20Demand\x20with\x20um\x20set\x20has\x20an\x20affiliated\x20Contact\x20object\x20that\x20manages\x20the\x20Demand\x20on\x20behalf\x20of\x20the\x20creator.\x20'+'The\x20Contact\x27s\x20address\x20is\x20stored\x20in\x20Demand.um\x20(Option<address>).\x20The\x20Contact\x20can\x20perform\x20operations\x20'+'through\x20its\x20own\x20permission\x20scope.\x20Use\x20this\x20when\x20a\x20Demand\x20is\x20operated\x20by\x20an\x20intermediary\x20(agent,\x20'+'marketplace,\x20escrow\x20service)\x20rather\x20than\x20the\x20original\x20creator.\x20um_set_imp\x20(demand.move:139-147)\x20'+'disaffiliates\x20the\x20old\x20um\x20before\x20affiliating\x20the\x20new\x20one\x20(P-DEM-P1-1\x20fix).','match_keywords':['um','contact','managed','intermediary','agent','marketplace','escrow'],'schema_elements':{'required_fields':['description','permission','um'],'optional_fields':['location','rewards','guards','namedNew'],'presentation_path':'either','um_recommendation':'Required\x20for\x20this\x20pattern.\x20Set\x20um\x20to\x20a\x20Contact\x20object\x20address\x20via\x20um_set.\x20The\x20Contact\x27s\x20'+'permission\x20scope\x20applies\x20to\x20subsequent\x20operations.\x20To\x20remove\x20the\x20Contact,\x20call\x20um_none\x20—\x20'+'um_none_imp\x20disaffiliates\x20the\x20Contact\x20before\x20clearing\x20self.um.'},'constraints':['um\x20must\x20be\x20a\x20valid\x20Contact\x20object\x20address\x20(set\x20via\x20um_set,\x20permission\x20index\x20408)','um_set_imp\x20disaffiliates\x20old\x20um\x20before\x20affiliating\x20new\x20(P-DEM-P1-1\x20fix\x20—\x20prevents\x20object-linker\x20dependency\x20leak)','um_none_imp\x20disaffiliates\x20um\x20before\x20clearing\x20(symmetric\x20with\x20um_set_imp)','If\x20guards\x20is\x20also\x20non-empty,\x20the\x20present_with_passport\x20path\x20applies\x20(P-DEM-02\x20constraints\x20also\x20hold)','permission_set\x20(DE-D-2=A)\x20can\x20migrate\x20the\x20Demand\x20to\x20a\x20new\x20Permission\x20—\x20affiliation_change_core\x20is\x20called\x20on\x20the\x20object\x20linker'],'example':{'description':'Marketplace-managed\x20Demand\x20for\x20freelance\x20design\x20services','location':'Shanghai','rewards':['0xabc...reward_addr_1'],'guards':[{'guard':'0xguard1...','service_identifier':null}],'permission':'0xperm...permission_addr','um':'0xcontact...marketplace_contact_addr','namedNew':{'name':'marketplace_managed_design_2026'}}}];export const DEMAND_FIELD_TRANSLATIONS=[{'field_name':'description','value_type':'string','semantic':'Human-readable\x20description\x20of\x20this\x20Demand.\x20Required\x20field.\x20The\x20Move\x20contract\x20validates\x20via\x20'+'common::DESCRIPTION\x20(demand.move:157,177),\x20which\x20enforces\x20the\x204000-char\x20limit.\x20Should\x20be\x20a\x20one-line\x20'+'summary\x20of\x20what\x20the\x20Demand\x20is\x20asking\x20for\x20(e.g.\x20\x22freelance\x20designer\x20for\x20brand\x20identity\x20work\x22).','format_example':'Freelance\x20designer\x20for\x20brand\x20identity\x20work\x20(logo\x20+\x20style\x20guide)','validation_rules':['Required\x20field','Length\x20≤\x20MAX_DESCRIPTION_LENGTH\x20('+MAX_DESCRIPTION_LENGTH+'\x20chars)','Move\x20validates\x20via\x20common::DESCRIPTION\x20—\x20E_DESCRIPTION_LENGTH_EXCEEDED\x20(4)\x20on\x20overflow']},{'field_name':'location','value_type':'string','semantic':'Geographic\x20location\x20associated\x20with\x20the\x20Demand.\x20Validated\x20via\x20common::LONG_NAME\x20(demand.move:180).\x20'+'Empty\x20string\x20(\x22\x22)\x20is\x20valid\x20—\x20new_imp\x20initializes\x20location\x20to\x20empty.\x20Use\x20location_set\x20to\x20update\x20after\x20'+'creation.\x20This\x20is\x20the\x20ONLY\x20Move\x20Demand\x20struct\x20field\x20that\x20the\x20matching\x20engine\x20reads\x20directly\x20(other\x20'+'matching\x20fields\x20like\x20tags,\x20maxPrice,\x20scenario\x20are\x20caller-enriched\x20—\x20see\x20P-DEM-P1-3\x20/\x20R-DEM-07).','format_example':'Shanghai\x20or\x20Remote','validation_rules':['Optional\x20(empty\x20string\x20\x22\x22\x20is\x20the\x20default\x20initial\x20value)','Length\x20≤\x20MAX_LONG_NAME_LENGTH\x20('+MAX_LONG_NAME_LENGTH+'\x20chars)','Move\x20validates\x20via\x20common::LONG_NAME\x20—\x20E_LONG_NAME_LENGTH_EXCEEDED\x20(11)\x20on\x20overflow']},{'field_name':'rewards','value_type':'vector<address>\x20(string[]\x20in\x20SDK)','semantic':'Reward\x20object\x20addresses\x20affiliated\x20with\x20this\x20Demand.\x20Each\x20reward\x20is\x20added\x20via\x20reward_add,\x20which\x20'+'triggers\x20object_linker::affiliation_core.\x20The\x20matching\x20engine\x20reads\x20maxPrice\x20from\x20the\x20Reward\x20objects\x20'+'(caller-enriched\x20—\x20the\x20Demand\x20struct\x20only\x20stores\x20addresses,\x20not\x20Reward\x20metadata).','format_example':'[\x220xabc...reward_addr_1\x22,\x20\x220xdef...reward_addr_2\x22]','validation_rules':['Count\x20≤\x20MAX_REWARD_COUNT\x20('+MAX_REWARD_COUNT+')\x20—\x20E_MAX_REWARD_COUNT_EXCEEDED\x20(1)\x20on\x20overflow','Each\x20address\x20must\x20be\x20a\x20valid\x20Reward\x20object\x20address','Duplicate\x20addresses\x20are\x20silently\x20ignored\x20(reward_add_imp\x20checks\x20contains\x20before\x20push)','reward_remove\x20/\x20reward_clear\x20disaffiliate\x20via\x20object_linker::disaffiliation_core\x20before\x20removing']},{'field_name':'guards','value_type':'vector<ServiceGuard>\x20({\x20guard:\x20address,\x20service_identifier:\x20Option<u8>\x20}[]\x20in\x20SDK)','semantic':'Guard\x20addresses\x20with\x20optional\x20service_identifier.\x20When\x20non-empty,\x20presenters\x20MUST\x20use\x20'+'present_with_passport\x20(or\x20present_service_with_passport).\x20The\x20service_identifier,\x20when\x20set,\x20routes\x20'+'present_with_passport\x20to\x20extract\x20the\x20submission\x20address\x20from\x20the\x20Passport\x20(overriding\x20the\x20supplied\x20'+'service\x20parameter).\x20guard_add\x20validates\x20the\x20service_identifier\x20type\x20BEFORE\x20any\x20mutation\x20(P-DEM-P1-2\x20fix).','format_example':'[{\x20guard:\x20\x220xguard1...\x22,\x20service_identifier:\x200\x20},\x20{\x20guard:\x20\x220xguard2...\x22,\x20service_identifier:\x20null\x20}]','validation_rules':['Count\x20≤\x20MAX_GUARD_COUNT_DEMAND\x20('+MAX_GUARD_COUNT_DEMAND+')\x20—\x20E_MAX_GUARD_COUNT_EXCEEDED\x20(2)\x20on\x20overflow','Each\x20guard\x20address\x20must\x20be\x20a\x20valid\x20Guard\x20object\x20address','Duplicate\x20addresses\x20update\x20service_identifier\x20in\x20place\x20(no\x20new\x20push)','When\x20service_identifier\x20is\x20provided,\x20it\x20MUST\x20index\x20a\x20Service-typed\x20submission\x20in\x20the\x20Guard','guard_remove\x20/\x20guard_clear\x20disaffiliate\x20via\x20object_linker::disaffiliation_core\x20before\x20removing']},{'field_name':'um','value_type':'Option<address>\x20(string\x20|\x20null\x20in\x20SDK)','semantic':'Optional\x20Contact\x20object\x20address\x20that\x20manages\x20this\x20Demand.\x20When\x20set,\x20the\x20Contact\x20can\x20perform\x20'+'operations\x20through\x20its\x20own\x20permission\x20scope.\x20um_set_imp\x20(demand.move:139-147)\x20disaffiliates\x20the\x20old\x20'+'um\x20before\x20affiliating\x20the\x20new\x20one\x20(P-DEM-P1-1\x20fix\x20—\x20prevents\x20object-linker\x20dependency\x20leak).\x20To\x20clear,\x20'+'call\x20um_none\x20—\x20um_none_imp\x20disaffiliates\x20before\x20clearing\x20self.um.','format_example':'0xcontact...marketplace_contact_addr\x20or\x20null','validation_rules':['Optional\x20(null/undefined\x20→\x20Option::none)\x20—\x20initial\x20state','When\x20set,\x20must\x20be\x20a\x20valid\x20Contact\x20object\x20address','um_set_imp\x20disaffiliates\x20old\x20um\x20before\x20setting\x20new\x20(P-DEM-P1-1\x20fix)','um_none_imp\x20disaffiliates\x20um\x20before\x20clearing\x20(symmetric)','Permission\x20index\x20408\x20required\x20for\x20um_set\x20/\x20um_none']},{'field_name':'presenters','value_type':'ParentTable<address,\x20ServiceInfo>\x20(not\x20directly\x20settable\x20—\x20populated\x20by\x20present)','semantic':'Service\x20presentation\x20records,\x20keyed\x20by\x20presenter\x20address.\x20Each\x20entry\x20contains:\x20recommend\x20(String),\x20'+'service\x20(Option<address>),\x20update_time\x20(u64),\x20acceptance_score\x20(Option<u8>),\x20feedback\x20(String),\x20'+'feedback_time\x20(u64).\x20Populated\x20by\x20present_imp\x20—\x20presenters\x20call\x20present\x20/\x20present_with_passport\x20to\x20'+'add\x20or\x20update\x20their\x20entry.\x20feedback_imp\x20updates\x20an\x20existing\x20entry\x27s\x20feedback\x20fields.','format_example':'(not\x20directly\x20settable\x20—\x20populated\x20by\x20present\x20operations)','validation_rules':['Not\x20directly\x20settable\x20by\x20the\x20creator\x20—\x20populated\x20by\x20presenter\x20operations','Each\x20presenter\x20address\x20maps\x20to\x20at\x20most\x20one\x20ServiceInfo\x20entry','present\x20updates\x20update_time\x20and\x20overwrites\x20recommend/service\x20on\x20each\x20call','feedback\x20updates\x20acceptance_score,\x20feedback,\x20feedback_time\x20(only\x20if\x20presenter\x20exists)']},{'field_name':'permission','value_type':'address','semantic':'Permission\x20object\x20address\x20bound\x20to\x20this\x20Demand.\x20All\x20mutations\x20require\x20permission::assert_permission_with_sender\x20'+'with\x20the\x20appropriate\x20index\x20(400-408).\x20permission_set\x20(demand.move:286)\x20is\x20exposed\x20via\x20CallPermission.apply\x20'+'(DE-D-2=A)\x20and\x20migrates\x20the\x20binding\x20via\x20object_linker::affiliation_change_core.','format_example':'0xperm...permission_addr','validation_rules':['Required\x20field\x20(set\x20at\x20creation\x20via\x20new_imp)','permission::assert_with_sender(permission,\x20400,\x20ctx)\x20required\x20for\x20new\x20(DEMAND_NEW)','permission::assert_permission_with_sender(permission,\x20<index>,\x20&self.permission,\x20ctx)\x20required\x20for\x20all\x20mutations','Permission\x20indices:\x20400=NEW,\x20401=DESCRIPTION,\x20402=LOCATION,\x20404=GUARD,\x20405=REWARD,\x20406=FEEDBACK,\x20407=OWNER_RECEIVE,\x20408=UM','permission_set\x20migrates\x20binding\x20via\x20object_linker::affiliation_change_core\x20(DE-D-2=A)']}];export const DEMAND_CONSTRAINT_RULES=[{'id':'DEMAND_C_01','name':'description\x20non-empty\x20and\x20within\x20size\x20limit','description':'The\x20\x27description\x27\x20field\x20must\x20be\x20non-empty\x20and\x20≤\x20MAX_DESCRIPTION_LENGTH\x20('+MAX_DESCRIPTION_LENGTH+'\x20chars).','validation_logic':'description.length\x20>\x200\x20&&\x20description.length\x20<=\x20MAX_DESCRIPTION_LENGTH','failure_message':'description\x20must\x20be\x201..'+MAX_DESCRIPTION_LENGTH+'\x20chars\x20—\x20E_DESCRIPTION_LENGTH_EXCEEDED\x20(4)\x20on\x20overflow','related_field':'description'},{'id':'DEMAND_C_02','name':'location\x20within\x20size\x20limit','description':'The\x20\x27location\x27\x20field\x20must\x20be\x20≤\x20MAX_LONG_NAME_LENGTH\x20('+MAX_LONG_NAME_LENGTH+'\x20chars).\x20Empty\x20string\x20is\x20valid.','validation_logic':'location.length\x20<=\x20MAX_LONG_NAME_LENGTH','failure_message':'location\x20exceeds\x20MAX_LONG_NAME_LENGTH\x20('+MAX_LONG_NAME_LENGTH+'\x20chars)\x20—\x20E_LONG_NAME_LENGTH_EXCEEDED\x20(11)','related_field':'location'},{'id':'DEMAND_C_03','name':'rewards\x20count\x20within\x20limit','description':'The\x20\x27rewards\x27\x20vector\x20count\x20must\x20be\x20≤\x20MAX_REWARD_COUNT\x20('+MAX_REWARD_COUNT+').','validation_logic':'rewards.length\x20<=\x20MAX_REWARD_COUNT','failure_message':'rewards\x20count\x20exceeds\x20MAX_REWARD_COUNT\x20('+MAX_REWARD_COUNT+')\x20—\x20E_MAX_REWARD_COUNT_EXCEEDED\x20(1)','related_field':'rewards'},{'id':'DEMAND_C_04','name':'guards\x20count\x20within\x20limit','description':'The\x20\x27guards\x27\x20vector\x20count\x20must\x20be\x20≤\x20MAX_GUARD_COUNT_DEMAND\x20('+MAX_GUARD_COUNT_DEMAND+').','validation_logic':'guards.length\x20<=\x20MAX_GUARD_COUNT_DEMAND','failure_message':'guards\x20count\x20exceeds\x20MAX_GUARD_COUNT_DEMAND\x20('+MAX_GUARD_COUNT_DEMAND+')\x20—\x20E_MAX_GUARD_COUNT_EXCEEDED\x20(2)','related_field':'guards'},{'id':'DEMAND_C_05','name':'service_identifier\x20valid\x20u8\x20when\x20provided','description':'When\x20service_identifier\x20is\x20provided\x20to\x20guard_add,\x20it\x20must\x20be\x20a\x20valid\x20u8\x20(0-255)\x20indexing\x20a\x20'+'Service-typed\x20submission\x20in\x20the\x20Guard.\x20guard_add_imp\x20validates\x20via\x20guard::get_submission_object_type\x20'+'and\x20common::assert_service_object_type\x20BEFORE\x20any\x20mutation\x20(P-DEM-P1-2\x20fix).','validation_logic':'service_identifier\x20==\x20null\x20||\x20(Number.isInteger(service_identifier)\x20&&\x200\x20<=\x20service_identifier\x20&&\x20service_identifier\x20<=\x20255)','failure_message':'service_identifier\x20must\x20be\x20a\x20u8\x20(0-255)\x20indexing\x20a\x20Service-typed\x20submission\x20—\x20E_INVALID_SERVICE_OBJECT_TYPE\x20(13)','related_field':'guards.service_identifier'},{'id':'DEMAND_C_06','name':'present\x20requires\x20passport\x20when\x20guards\x20non-empty','description':'When\x20the\x20guards\x20vector\x20is\x20non-empty,\x20callers\x20MUST\x20use\x20present_with_passport\x20/\x20present_service_with_passport.\x20'+'The\x20plain\x20present\x20function\x20asserts\x20`vector::is_empty(&self.guards)`\x20and\x20aborts\x20with\x20E_NEED_PASSPORT\x20(3).\x20'+'The\x20by_guard\x20parameter\x20to\x20present_with_passport\x20MUST\x20already\x20be\x20in\x20the\x20guards\x20vector\x20'+'(otherwise\x20E_GUARD_NOT_FOUND\x20(4)).','validation_logic':'!guards_non_empty\x20||\x20using_present_with_passport;\x20by_guard\x20in\x20guards','failure_message':'present\x20without\x20passport\x20when\x20guards\x20non-empty\x20—\x20E_NEED_PASSPORT\x20(3);\x20by_guard\x20not\x20in\x20guards\x20—\x20E_GUARD_NOT_FOUND\x20(4)','related_field':'guards\x20+\x20presentation_path'}];export function explainDemand(a){const b=[],c=[],d=!!a['guards']&&a['guards']['length']>0x0,e=!!a['um'];let f='open',g='plain_present';if(d&&e)f='guarded\x20+\x20um_managed\x20(P-DEM-02\x20+\x20P-DEM-03\x20combined)',g='present_with_passport\x20(um\x20does\x20not\x20change\x20presentation\x20path)';else{if(d)f='guarded\x20(P-DEM-02)\x20—\x20passport\x20required\x20for\x20present',g='present_with_passport\x20/\x20present_service_with_passport';else e?(f='um_managed\x20(P-DEM-03)\x20—\x20Contact\x20manages\x20the\x20Demand',g='plain\x20present\x20(no\x20guards)\x20OR\x20present_with_passport\x20(if\x20guards\x20added\x20later)'):(f='open\x20(P-DEM-01)\x20—\x20free\x20presentation,\x20no\x20passport\x20required',g='present\x20/\x20present_service\x20(plain\x20path)');}const h=[];a['permission']&&h['push']('permission='+a['permission']['substring'](0x0,0xa)+'...\x20(bound\x20at\x20creation)');e&&h['push']('um='+a['um']['substring'](0x0,0xa)+'...\x20(Contact\x20manages\x20Demand)');a['rewards']&&a['rewards']['length']>0x0&&h['push']('rewards='+a['rewards']['length']+'\x20bound\x20via\x20object_linker::affiliation_core');d&&h['push']('guards='+a['guards']['length']+'\x20bound\x20via\x20object_linker::affiliation_core');const i=h['length']>0x0?'Bindings:\x20'+h['join'](';\x20'):'No\x20object-linker\x20bindings\x20(bare\x20Demand)',j=[];a['description']!==undefined&&j['push']('description='+a['description']['length']+'\x20chars\x20(limit\x20'+MAX_DESCRIPTION_LENGTH+')');a['location']!==undefined&&j['push']('location='+a['location']['length']+'\x20chars\x20(limit\x20'+MAX_LONG_NAME_LENGTH+')');a['rewards']&&j['push']('rewards='+a['rewards']['length']+'/'+MAX_REWARD_COUNT);a['guards']&&j['push']('guards='+a['guards']['length']+'/'+MAX_GUARD_COUNT_DEMAND);if(d){const l=a['guards']['filter'](m=>m['service_identifier']!==null&&m['service_identifier']!==undefined&&!(typeof m['service_identifier']==='number'&&Number['isInteger'](m['service_identifier'])&&m['service_identifier']>=0x0&&m['service_identifier']<=0xff));l['length']>0x0&&b['push'](l['length']+'\x20guard(s)\x20have\x20invalid\x20service_identifier\x20(must\x20be\x20u8\x200-255)');}(!a['description']||a['description']['length']===0x0)&&b['push']('description\x20is\x20empty\x20—\x20Demand\x20will\x20be\x20hard\x20to\x20identify\x20in\x20queries');(!a['description']||a['description']['length']===0x0)&&c['push']('Provide\x20a\x20non-empty\x20description\x20for\x20discoverability');(a['location']===undefined||a['location']==='')&&c['push']('Consider\x20setting\x20location\x20if\x20the\x20Demand\x20is\x20geographic\x20(only\x20on-chain\x20field\x20used\x20by\x20matching)');!d&&c['push']('Consider\x20adding\x20guards\x20if\x20presentations\x20should\x20be\x20filtered\x20(KYC,\x20membership,\x20etc.)');!e&&f==='open'&&c['push']('Consider\x20setting\x20um\x20to\x20a\x20Contact\x20if\x20the\x20Demand\x20should\x20be\x20managed\x20by\x20an\x20intermediary');const k='Demand\x20is\x20'+f+'.\x20'+g+'.\x20'+i+'.\x20'+(j['length']>0x0?'Sizes:\x20'+j['join'](',\x20')+'.':'');return{'summary':k,'configuration_classification':f,'presentation_path':g,'binding_status':i,'size_status':j['join'](',\x20'),'warnings':b,'recommendations':c};}
|